Merge remote-tracking branch 'origin/master' into worktree/session-reference

# Conflicts:
#	docs/capability-seams.md
#	docs/config-catalog.md
#	docs/cordis-catalog/services.md
#	docs/module-graph.md
#	examples/acp-agent/tests/snapshots/cordis-inspect-jsdoc/session.jsonl
#	packages/cordis/tool-cordis/src/api-catalog.ts
#	packages/ui/acp/README.md
#	packages/ui/acp/package.json
#	packages/ui/acp/tsconfig.json
#	packages/ui/tui/package.json
#	packages/ui/tui/src/index.ts
#	packages/ui/tui/tests/tui.spec.ts
#	packages/ui/tui/tsconfig.json
#	pnpm-lock.yaml
#	python/sdk-runtime/package.json
#	scripts/gen-doc-graphs.ts
#	scripts/type-equiv.manifest.json

packages/context/session-reference/src/index.ts

@@ -100,12 +100,12 @@ export class SessionReferenceService extends Service {
   }
 
   /**
-   * List metadata-only reference candidates, ranked by working-directory affinity.
+   * List reference candidates, ranked by working-directory affinity.
    * @param agent - target agent; self is excluded and its cwd drives ranking.
    * @param query - optional case-insensitive session-id/cwd substring.
    * @param limit - optional positive result cap.
    * @param signal - optional cancellation boundary for host autocomplete teardown.
-   * @returns candidate records in stable source creation order within each rank.
+   * @returns candidates labeled by latest title or, when absent, session id.
    */
   async listCandidates(
     agent: Agent,
@@ -130,9 +130,13 @@ export class SessionReferenceService extends Service {
       .sort((a, b) => candidateRank(a.record.header.cwd, targetCwd) - candidateRank(b.record.header.cwd, targetCwd)
         || a.index - b.index)
       .slice(0, limit)
-    return records.map(({ record }) => ({
+    const titles = await settleWithCancellation(
+      Promise.all(records.map(({ record }) => this.ctx.sessionQuery.readTitle(record.header.id))),
+      signal,
+    )
+    return records.map(({ record }, index) => ({
       sessionId: record.header.id,
-      label: record.header.id,
+      label: titles[index]?.title ?? record.header.id,
       ...record.header.cwd === undefined ? {} : { cwd: record.header.cwd },
       createdAt: record.header.createdAt,
     }))

packages/context/session-reference/src/types.ts

@@ -16,7 +16,7 @@ export interface SessionReferenceInput {
 export interface SessionReferenceCandidate {
   /** Opaque source session identity. */
   sessionId: SessionId
-  /** Default display label. */
+  /** Latest log-backed title, falling back to the opaque session id. */
   label: string
   /** Source session working directory, when recorded. */
   cwd?: string