Merge remote-tracking branch 'upstream/master' into fix/translation-brief-uncommitted-pair

scripts/gen-cordis-catalog.ts

@@ -36,8 +36,7 @@ export const LINK_MAP: Record<string, string> = {
   ContinuationStop: 'core.md',
   GenerateOptions: 'core.md',
   InboxPlacement: 'core.md',
-  AgentMessage: 'core.md',
-  AgentMessageId: 'core.md',
+  MessageId: 'core.md',
   HookContext: 'core.md',
   SettleReason: 'core.md',
   LlmCallConfig: 'core.md',
@@ -50,6 +49,7 @@ export const LINK_MAP: Record<string, string> = {
   ResolvedRetryPolicy: 'llm-streaming.md',
   Message: 'core.md',
   MessageSource: 'core.md',
+  UserMessage: 'session.md',
   PromptDecision: 'core.md',
   RequestErrorAction: 'core.md',
   RequestError: 'core.md',
@@ -209,6 +209,7 @@ const FOUNDATION_TYPE_NAMES = new Set([
   'AsyncIterable',
   'Context',
   'Error',
+  'Partial',
   'Pick',
   'Promise',
   'Readonly',
@@ -237,6 +238,7 @@ const TYPE_LINK_EXEMPTIONS: Readonly<Record<string, string>> = {
   SessionProjectionMap: 'merge-extensible projection key map is owned by packages/session-projection/session-projection/src/types.ts',
   ProjectionChangeListener: 'change-feed listener contract is owned by packages/session-projection/session-projection/src/index.ts',
   ProjectionSnapshot: 'watermark snapshot shape is owned by packages/session-projection/session-projection/src/index.ts',
+  ProjectionCheckpoint: 'persisted checkpoint row map is owned by packages/session-projection/session-projection/src/index.ts',
   CommandExecution: 'executor return contract is owned by packages/ui/commands/src/index.ts',
   InvariantInstaller: 'service-local contribution contract is owned by packages/support/invariants/README.md',
   LocaleDict: 'service-local dictionary shape is owned by packages/client/i18n/src/index.ts',

scripts/gen-doc-graphs.ts

@@ -244,6 +244,14 @@ const SERVICE_ROLES: ServiceRole[] = [
     consumers: ['tool-todo', 'session-title', 'host-apiproxy'],
     note: 'Domains register state-driven fold units; the eager drive keeps per-session watermark states and api-proxy serves baselines and pushes changed values.',
   },
+  {
+    key: 'sessionProjectionCache',
+    pkg: 'session-projection-cache',
+    title: 'Persisted projection cache',
+    mode: 'core',
+    consumers: ['host-apiproxy'],
+    note: 'Durably checkpoints projection unit states per session (throttled + turn/end/detach mandatory points) and serves the cold-read ladder: cache row + persistence tail replay, so listings never load full logs.',
+  },
   {
     key: 'tui',
     pkg: 'tui',

scripts/type-equiv.manifest.json

@@ -14,17 +14,17 @@
     {
       "doc": "docs/core-data-structures/core.md",
       "symbol": "AssistantProvenance",
-      "source": "packages/llm/llm/src/types.ts"
+      "source": "packages/llm/llm/src/message.ts"
     },
     {
       "doc": "docs/core-data-structures/core.md",
       "symbol": "Message",
-      "source": "packages/llm/llm/src/types.ts"
+      "source": "packages/llm/llm/src/message.ts"
     },
     {
       "doc": "docs/core-data-structures/core.md",
       "symbol": "MessageSourceMap",
-      "source": "packages/llm/llm/src/types.ts"
+      "source": "packages/llm/llm/src/message.ts"
     },
     {
       "doc": "docs/core-data-structures/core.md",
@@ -101,16 +101,6 @@
       "symbol": "SendOptions",
       "source": "packages/core/agent/src/types.ts"
     },
-    {
-      "doc": "docs/core-data-structures/core.md",
-      "symbol": "AgentMessageId",
-      "source": "packages/core/agent/src/types.ts"
-    },
-    {
-      "doc": "docs/core-data-structures/core.md",
-      "symbol": "AgentMessage",
-      "source": "packages/core/agent/src/types.ts"
-    },
     {
       "doc": "docs/core-data-structures/core.md",
       "symbol": "CancelOptions",
@@ -320,8 +310,8 @@
     },
     {
       "doc": "docs/core-data-structures/session.md",
-      "symbol": "UserMessageData",
-      "source": "packages/core/session/src/types.ts"
+      "symbol": "UserMessage",
+      "source": "packages/llm/llm/src/message.ts"
     },
     {
       "doc": "docs/core-data-structures/session.md",

scripts/verify-package-readme-model-experience.ts

@@ -89,6 +89,7 @@ const SENTENCE_MODEL_EXPERIENCE: Readonly<Record<string, SentenceContract>> = {
   'packages/sdk/sdk-protocol': { kind: 'none', reason: 'Client-facing wire library; the runtime plugins behind the serving entry own the model surface.' },
   'packages/sdk/telemetry': { kind: 'none', reason: 'The launcher-side reporter sends developer-cycle telemetry and registers no live agent or model surface.' },
   'packages/session-projection/session-projection': { kind: 'none', reason: 'The projection registry serves client-facing read models of already-logged session state and registers no model surface.' },
+  'packages/session-projection/session-projection-cache': { kind: 'none', reason: 'The persisted cache accelerates host-side cold reads of projection state and registers no model surface.' },
   'packages/session-query/session-query': { kind: 'none', reason: 'The trusted query service exposes cloned records only to callers and registers no model surface.' },
   'packages/session-query/session-query-sqlite': { kind: 'none', reason: 'The search backend returns hits only to callers and registers no model surface.' },
   'packages/telemetry/session-telemetry': { kind: 'none', reason: 'The seam observes the session stream and hands redacted copies outward; it registers no model surface.' },