Plugin session.update with an empty title clears the title instead of generating a new one #58547

Activity

1. opencode-agent commented on Oct 23, 2026

   

   opencode-agentBot

   on Oct 23, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the detailed report, @jeremysamuel13. I reproduced this on 2.1.2, and it still happens on the latest dev (df6fb9a).

   What I did, with a local plugin in .opencode/plugins/ and opencode serve:

   1. Created two sessions with titles over the API.
   2. PATCH /api/session/<A> with {"title":""} returned 204 and did not clear the title. It took the title-generation path; without model credentials the old title stayed.
   3. In the plugin, await context.session.update({ sessionID: B, title: "" }) set the title to "", and GET /api/session/<B> returns "title":"" too.

   The cause is what you described. The HTTP handler in packages/server/src/handlers/session.ts sends an empty title to the title generator, but the plugin host's update in packages/core/src/plugin/host.ts passes it straight to rename. The script below reproduces it and creates the plugin itself.

   Related, but not the same problem: #51468 (plugin session.update dropping metadata) and #58176 / #58504 (automatic title generation).

   Reproduction script (repro.sh)

   #!/usr/bin/env bash
   # Reproduces #58547: a plugin's context.session.update({ sessionID, title: "" })
   # saves "" as the title, while PATCH /api/session/:id { "title": "" } treats it
   # as "generate a title" and never stores an empty title.
   # Usage: ./repro.sh                          (uses `opencode` on PATH)
   #        OC_DEV=/path/to/opencode/checkout ./repro.sh   (runs from source)
   set -u
   ROOT="$(cd "$(dirname "$0")" && pwd)"
   DIR="$ROOT/proj"; PORT=${PORT:-4599}; T=/tmp/opencode
   mkdir -p "$DIR/.opencode/plugins" "$T"; rm -f $T/trigger $T/result $T/loaded
   # Local plugin: when $T/trigger holds a session ID, call session.update({ title: "" }).
   cat > "$DIR/.opencode/plugins/clear-title.ts" <<'PLUGIN'
   import * as fs from "node:fs"
   export default {
     id: "clear-title-repro",
     setup: async (ctx: any) => {
       fs.writeFileSync("/tmp/opencode/loaded", "1")
       const timer = setInterval(async () => {
         if (!fs.existsSync("/tmp/opencode/trigger")) return
         const sessionID = fs.readFileSync("/tmp/opencode/trigger", "utf8").trim()
         fs.rmSync("/tmp/opencode/trigger")
         try {
           const before = await ctx.session.get({ sessionID })
           await ctx.session.update({ sessionID, title: "" })
           const after = await ctx.session.get({ sessionID })
           fs.writeFileSync("/tmp/opencode/result", JSON.stringify({ before: before.title, after: after.title }))
         } catch (e) { fs.writeFileSync("/tmp/opencode/result", "ERROR " + String(e)) }
       }, 300)
       return () => clearInterval(timer)
     },
   }
   PLUGIN
   cd "$DIR"
   if [ -n "${OC_DEV:-}" ]; then
     OC=(bun --conditions=browser --preload="$OC_DEV/packages/tui/node_modules/@opentui/solid/scripts/preload.js" "$OC_DEV/packages/cli/src/index.ts")
   else OC=(opencode); fi
   echo "version: $("${OC[@]}" --version)"
   export OPENCODE_PASSWORD=repro
   OPENCODE_PASSWORD=repro "${OC[@]}" serve --port $PORT > $T/serve.log 2>&1 &
   PID=$!; trap 'kill $PID 2>/dev/null' EXIT
   c() { curl -s -u opencode:repro -H 'content-type: application/json' "$@"; }
   API="http://127.0.0.1:$PORT/api/session"
   for i in $(seq 1 90); do c -f "$API" >/dev/null && break; sleep 1; done
   mk() { c -X POST "$API" -d "{\"title\":\"$1\",\"location\":{\"directory\":\"$DIR\"}}" | sed -E 's/.*"id":"([^"]+)".*/\1/'; }
   title() { c "$API/$1" | grep -o '"title":"[^"]*"'; }
   
   A=$(mk "Title A"); B=$(mk "Title B")
   echo "== HTTP: PATCH /api/session/$A {\"title\":\"\"}"
   echo "before: $(title $A)"
   c -o /dev/null -w "status %{http_code}\n" -X PATCH "$API/$A" -d '{"title":""}'
   sleep 2; echo "after:  $(title $A)"
   
   for i in $(seq 1 120); do [ -f $T/loaded ] && break; sleep 0.5; done
   echo "== plugin: context.session.update({ sessionID: \"$B\", title: \"\" })  (plugin loaded: $([ -f $T/loaded ] && echo yes || echo no))"
   echo "before: $(title $B)"
   echo "$B" > $T/trigger
   for i in $(seq 1 60); do [ -f $T/result ] && break; sleep 0.5; done
   echo "plugin saw: $(cat $T/result 2>/dev/null)"
   echo "after:  $(title $B)"

   Run it: bash repro.sh
2. opencode-agent

   added

   reproduced

   on Oct 23, 2026