@deepseek-ai/dsh-llm 0.1.6-alpha.2 → 0.1.7-alpha.2

package/lib/typert.host.js

@@ -74,7 +74,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:result',
         create: _deepseek_ai_dsh_llm_llm_discoverModels_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":632,"column":9},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":633,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders',
@@ -89,7 +89,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":544,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":545,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-llm#llm/listProviders',
@@ -104,7 +104,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listProviders_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":472,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":473,"column":3},
     },
   ],
   model: {
@@ -232,6 +232,10 @@ export const TYPERT = {
             "name": "AgentMessageSource",
             "declaration": "export interface AgentMessageSource {\n    readonly kind: 'agent-message';\n    readonly form: 'relay';\n    readonly senderSessionId: SessionId;\n}"
           },
+          {
+            "name": "AssistantMessage",
+            "declaration": "export interface AssistantMessage extends MessageBase {\n    readonly role: 'assistant';\n    readonly source: ModelMessageSource;\n}"
+          },
           {
             "name": "AssistantProviderMetadata",
             "declaration": "export interface AssistantProviderMetadata {\n    provider: string;\n    model: string;\n    replayState?: unknown;\n}"
@@ -248,13 +252,25 @@ export const TYPERT = {
             "name": "BrandedNumber",
             "declaration": "export type BrandedNumber<B extends string> = number & { readonly [BRAND]: B; };"
           },
+          {
+            "name": "CommandId",
+            "declaration": "export type CommandId = Branded<'CommandId'>;"
+          },
+          {
+            "name": "CompactionCheckpointSource",
+            "declaration": "export type CompactionCheckpointSource = typeof COMPACT_CHECKPOINT_MARKER & { readonly compactionId: CompactionId; readonly sourceCommandId?: CommandId; };"
+          },
+          {
+            "name": "CompactionId",
+            "declaration": "export type CompactionId = Branded<'CompactionId'>;"
+          },
           {
             "name": "ContentBlock",
             "declaration": "export type ContentBlock = ContentBlockMap[ContentBlockType];"
           },
           {
             "name": "ContentBlockMap",
-            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    file: FileBlock;\n    'tool-call': ToolCallBlock;\n    'tool-result': ToolResultBlock;\n}"
+            "declaration": "export interface ContentBlockMap {\n    text: TextBlock;\n    reasoning: ReasoningBlock;\n    image: ImageBlock;\n    file: FileBlock;\n    'tool-call': ToolCallBlock;\n    'tool-addition': ToolAdditionBlock;\n    'tool-removal': ToolRemovalBlock;\n}"
           },
           {
             "name": "ContentBlockType",
@@ -268,6 +284,10 @@ export const TYPERT = {
             "name": "ContextSnapshotSection",
             "declaration": "export interface ContextSnapshotSection {\n    readonly name: string;\n    readonly text: string;\n}"
           },
+          {
+            "name": "DeveloperMessage",
+            "declaration": "export interface DeveloperMessage extends MessageBase {\n    readonly role: 'developer';\n}"
+          },
           {
             "name": "DirectoryRegistrationHandle",
             "declaration": "export interface DirectoryRegistrationHandle {\n    (): void;\n    replace(entries: readonly LlmConfigurableProvider[]): void;\n}"
@@ -290,7 +310,7 @@ export const TYPERT = {
           },
           {
             "name": "GenerateOptions",
-            "declaration": "export interface GenerateOptions {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    messages: Message[];\n    system?: string;\n    tools?: ToolSchema[];\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n    signal?: AbortSignal;\n    sessionId?: Branded<'SessionId'>;\n    purpose?: 'compaction' | 'session-title';\n}"
+            "declaration": "export interface GenerateOptions {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    messages: RequestMessage[];\n    system?: string;\n    tools?: ToolSchema[];\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n    signal?: AbortSignal;\n    sessionId?: Branded<'SessionId'>;\n    purpose?: 'compaction' | 'session-title';\n}"
           },
           {
             "name": "GoalId",
@@ -374,19 +394,27 @@ export const TYPERT = {
           },
           {
             "name": "Message",
-            "declaration": "export interface Message {\n    readonly id: MessageId;\n    readonly role: 'system' | 'user' | 'assistant';\n    readonly content: ContentBlock[];\n    readonly source: MessageSource;\n}"
+            "declaration": "export type Message = MessageRoleMap[keyof MessageRoleMap];"
+          },
+          {
+            "name": "MessageBase",
+            "declaration": "export interface MessageBase {\n    readonly id: MessageId;\n    readonly content: readonly ContentBlock[];\n    readonly source: MessageSource;\n}"
           },
           {
             "name": "MessageId",
             "declaration": "export type MessageId = Branded<'MessageId'>;"
           },
+          {
+            "name": "MessageRoleMap",
+            "declaration": "export interface MessageRoleMap {\n    system: SystemMessage;\n    developer: DeveloperMessage;\n    user: UserMessage;\n    assistant: AssistantMessage;\n    tool: ToolResultMessage;\n}"
+          },
           {
             "name": "MessageSource",
             "declaration": "export type MessageSource = MessageSourceMap[keyof MessageSourceMap];"
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    plugin: { kind: 'plugin'; plugin: string; } & ContextFormed;\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'session-reference': SessionReferenceSource;\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'cordis-host-runner': { kind: 'cordis-host-runner'; };\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -428,6 +456,14 @@ export const TYPERT = {
             "name": "ReplayEnvelope",
             "declaration": "export interface ReplayEnvelope {\n    response: unknown;\n    blocks?: readonly unknown[];\n}"
           },
+          {
+            "name": "RequestMessage",
+            "declaration": "export type RequestMessage = Message | RequestUserInput;"
+          },
+          {
+            "name": "RequestUserInput",
+            "declaration": "export interface RequestUserInput {\n    readonly role: 'user';\n    readonly content: UserMessage['content'];\n    readonly id?: never;\n    readonly source?: never;\n}"
+          },
           {
             "name": "ResolvedAlwaysRetryPolicy",
             "declaration": "export interface ResolvedAlwaysRetryPolicy extends ResolvedRetryBackoff {\n    readonly mode: 'always';\n}"
@@ -472,6 +508,14 @@ export const TYPERT = {
             "name": "SubagentSettledMessageSource",
             "declaration": "export interface SubagentSettledMessageSource {\n    readonly kind: 'subagent-settled';\n    readonly form: 'notice';\n    readonly summary: string;\n    readonly senderSessionId: SessionId;\n}"
           },
+          {
+            "name": "SystemMessage",
+            "declaration": "export interface SystemMessage extends MessageBase {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['system-prompt'];\n}"
+          },
+          {
+            "name": "SystemPromptMessageSource",
+            "declaration": "export interface SystemPromptMessageSource {\n    kind: 'system-prompt';\n}"
+          },
           {
             "name": "SystemPromptUpdate",
             "declaration": "export type SystemPromptUpdate = 'in-history';"
@@ -496,6 +540,10 @@ export const TYPERT = {
             "name": "TokenUsage",
             "declaration": "export interface TokenUsage {\n    inputTokens: number;\n    outputTokens: number;\n    totalTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    reasoningTokens?: number;\n}"
           },
+          {
+            "name": "ToolAdditionBlock",
+            "declaration": "export interface ToolAdditionBlock {\n    type: 'tool-addition';\n    toolName: string;\n    tool?: never;\n}"
+          },
           {
             "name": "ToolCallBlock",
             "declaration": "export interface ToolCallBlock {\n    type: 'tool-call';\n    id: ToolCallId;\n    name: string;\n    arguments: string;\n}"
@@ -509,12 +557,20 @@ export const TYPERT = {
             "declaration": "export interface ToolMessageSource {\n    kind: 'tool';\n    callId: ToolCallId;\n}"
           },
           {
-            "name": "ToolResultBlock",
-            "declaration": "export interface ToolResultBlock {\n    type: 'tool-result';\n    toolCallId: ToolCallId;\n    content: ContentBlock[];\n    isError?: boolean;\n}"
+            "name": "ToolRemovalBlock",
+            "declaration": "export interface ToolRemovalBlock {\n    type: 'tool-removal';\n    toolName: string;\n}"
+          },
+          {
+            "name": "ToolResultMessage",
+            "declaration": "export interface ToolResultMessage extends MessageBase {\n    readonly role: 'tool';\n    readonly source: ToolMessageSource;\n    readonly toolCallId: ToolCallId;\n    readonly isError?: boolean;\n}"
           },
           {
             "name": "ToolSchema",
-            "declaration": "export interface ToolSchema {\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}"
+            "declaration": "export interface ToolSchema {\n    deferLoading?: true;\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}"
+          },
+          {
+            "name": "UserMessage",
+            "declaration": "export interface UserMessage extends MessageBase {\n    readonly role: 'user';\n}"
           }
         ]
       }
@@ -542,8 +598,8 @@ export const TYPERT = {
           {
             "name": "param",
             "argument": "options",
-            "comment": "- the full request. A LOOP-built request carries the process-local {@link markAgentLoopRequest} identity and arrives deep-frozen (mutation throws): its content is a pure function of the session log (the reconstructability Agent Note), so listeners read it, never rewrite it. Hand-built calls do not carry that marker; their messages already obey the immutable creation contract.",
-            "text": "@param options - the full request. A LOOP-built request carries the\n     *   process-local {@link markAgentLoopRequest} identity and arrives deep-frozen\n     *   (mutation throws): its content is a pure function of the session log (the\n     *   reconstructability Agent Note), so listeners read it, never rewrite it.\n     *   Hand-built calls do not carry that marker; their messages already obey\n     *   the immutable creation contract.\n     *"
+            "comment": "- the full request. A LOOP-built request carries the process-local {@link markAgentLoopRequest} identity and arrives deep-frozen (mutation throws): its content is a pure function of the session log (the reconstructability Agent Note), so listeners read it, never rewrite it. Hand-built calls do not carry that marker; callers own their request inputs and must keep them unchanged until the stream settles.",
+            "text": "@param options - the full request. A LOOP-built request carries the\n     *   process-local {@link markAgentLoopRequest} identity and arrives deep-frozen\n     *   (mutation throws): its content is a pure function of the session log (the\n     *   reconstructability Agent Note), so listeners read it, never rewrite it.\n     *   Hand-built calls do not carry that marker; callers own their request\n     *   inputs and must keep them unchanged until the stream settles.\n     *"
           },
           {
             "name": "mode",
@@ -551,7 +607,7 @@ export const TYPERT = {
             "text": "@mode waterfall"
           }
         ],
-        "jsDoc": "/**\n * Waterfall around every streaming model call (retry, replay, routing).\n * Bound to the {@link LlmRuntime}; call `next()` to reach the resolved\n * adapter's stream, or yield your own chunks to short-circuit.\n * @param options - the full request. A LOOP-built request carries the\n *   process-local {@link markAgentLoopRequest} identity and arrives deep-frozen\n *   (mutation throws): its content is a pure function of the session log (the\n *   reconstructability Agent Note), so listeners read it, never rewrite it.\n *   Hand-built calls do not carry that marker; their messages already obey\n *   the immutable creation contract.\n * @mode waterfall\n */",
+        "jsDoc": "/**\n * Waterfall around every streaming model call (retry, replay, routing).\n * Bound to the {@link LlmRuntime}; call `next()` to reach the resolved\n * adapter's stream, or yield your own chunks to short-circuit.\n * @param options - the full request. A LOOP-built request carries the\n *   process-local {@link markAgentLoopRequest} identity and arrives deep-frozen\n *   (mutation throws): its content is a pure function of the session log (the\n *   reconstructability Agent Note), so listeners read it, never rewrite it.\n *   Hand-built calls do not carry that marker; callers own their request\n *   inputs and must keep them unchanged until the stream settles.\n * @mode waterfall\n */",
         "name": "llm/stream",
         "mode": "waterfall",
         "signature": "'llm/stream'(this: LlmRuntime, options: GenerateOptions, next: () => AsyncIterable<StreamChunk>): AsyncIterable<StreamChunk>"

package/lib/typert.remote-client.js

@@ -71,7 +71,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-llm#llm/discoverModels:result',
         create: _deepseek_ai_dsh_llm_llm_discoverModels_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":632,"column":9},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":633,"column":9},
     },
     {
       id: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders',
@@ -86,7 +86,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listConfigurableProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listConfigurableProviders_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":544,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":545,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-llm#llm/listProviders',
@@ -101,7 +101,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-llm#llm/listProviders:result',
         create: _deepseek_ai_dsh_llm_llm_listProviders_result$schema,
       },
-      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":472,"column":3},
+      sourceLocation: {"file":"packages/llm/llm/src/index.ts","line":473,"column":3},
     },
   ],
 }

package/lib/types/assembler.d.ts

@@ -5,7 +5,7 @@
  *
  * @module @deepseek-ai/dsh-llm/assembler
  */
-import type { Message, MessageSource } from './message.ts';
+import type { AssistantMessage, ModelMessageSource } from './message.ts';
 import type { ContentBlock, FinishReason, ReplayEnvelope, StreamChunk, TokenUsage } from './types.ts';
 /**
  * Incrementally assembles raw {@link StreamChunk}s into complete
@@ -67,9 +67,9 @@ export declare class BlockAssembler {
     get replayState(): ReplayEnvelope | undefined;
     /**
      * The assembled assistant message.
-     * @param source - producer attribution for the assembled message.
+     * @param source - provider/model attribution (without the `kind` tag) for the assembled message.
      * @returns a frozen assistant-role message over `blocks()` (same open-block assembly rules).
      */
-    message(source?: MessageSource): Message;
+    message(source: Omit<ModelMessageSource, 'kind'>): AssistantMessage;
 }
 //# sourceMappingURL=assembler.d.ts.map

package/lib/types/assembler.js

@@ -7,7 +7,7 @@
  */
 import { brandString } from '@deepseek-ai/dsh-brand';
 import { assertNever } from '@deepseek-ai/dsh-util-values';
-import { createMessage } from "./message.js";
+import { createAssistantMessage } from "./message.js";
 /**
  * Incrementally assembles raw {@link StreamChunk}s into complete
  * {@link ContentBlock}s and a final assistant {@link Message}.
@@ -181,11 +181,11 @@ export class BlockAssembler {
     }
     /**
      * The assembled assistant message.
-     * @param source - producer attribution for the assembled message.
+     * @param source - provider/model attribution (without the `kind` tag) for the assembled message.
      * @returns a frozen assistant-role message over `blocks()` (same open-block assembly rules).
      */
-    message(source = { kind: 'plugin', plugin: 'dsh-llm/assembler' }) {
-        return createMessage({ role: 'assistant', content: this.blocks(), source });
+    message(source) {
+        return createAssistantMessage({ content: this.blocks(), source });
     }
 }
 //# sourceMappingURL=assembler.js.map

package/lib/types/content.d.ts

@@ -1,5 +1,6 @@
 /** Content-block structure helpers. @module @deepseek-ai/dsh-llm/content */
 import type { ContentBlock, ImageBlock, LlmImageRequestBudget } from './types.ts';
+import type { RequestMessage } from './types.ts';
 import type { Message } from './message.ts';
 import type { AttachmentStore, FileAttachmentRef, ImageAttachmentRef, RequestImageAttachment } from '@deepseek-ai/dsh-attachment';
 /** Execution-world path that model tools can use to read one normalized attachment. */
@@ -49,20 +50,18 @@ export declare function requestImageHandleText(ref: ImageAttachmentRef, version:
  */
 export declare function offloadedImageText(ref: ImageAttachmentRef, access?: ImageAttachmentAccess): string;
 /**
- * True when typed model content contains an image block, walking nested
- * tool-result content. This is the one recursive image walk shared by every
- * image policy (capability gating, text-only serialization, compaction
- * survey), so a consumer cannot silently diverge on nesting depth.
+ * True when typed model content contains an image block. This is the one image
+ * walk shared by every image policy (capability gating, text-only
+ * serialization, compaction survey), so a consumer cannot silently diverge.
  * @param content - typed model content blocks.
- * @returns whether any nested block is an image.
+ * @returns whether any block is an image.
  */
 export declare function contentHasImage(content: readonly ContentBlock[]): boolean;
 /**
- * True when typed model content contains a file block, walking nested
- * tool-result content on the same recursion every file policy shares.
+ * True when typed model content contains a file block.
  * Reads current content on every call without retaining scan results.
  * @param content - typed model content blocks.
- * @returns whether any nested block is a file.
+ * @returns whether any block is a file.
  */
 export declare function contentHasFile(content: readonly ContentBlock[]): boolean;
 /**
@@ -75,7 +74,7 @@ export declare function contentHasFile(content: readonly ContentBlock[]): boolea
  */
 export declare function fileHandleText(ref: FileAttachmentRef, readonlyPath: string | undefined): string;
 /**
- * Project durable file history into deterministic handle text for every model
+ * Project request file content into deterministic handle text for every model
  * route. Unlike images, no provider receives file blocks natively, so this
  * projection is unconditional in request assembly.
  * @param messages - complete request history.
@@ -83,6 +82,13 @@ export declare function fileHandleText(ref: FileAttachmentRef, readonlyPath: str
  * @returns the original list without files, otherwise shallow message copies with handle text.
  */
 export declare function projectFilesToText(messages: readonly Message[], resolvePath: (ref: FileAttachmentRef) => string | undefined): readonly Message[];
+/**
+ * Project file content in mixed durable and request-only inputs.
+ * @param messages - complete request inputs.
+ * @param resolvePath - resolve a reference's execution-world read path.
+ * @returns original inputs without files, otherwise copies with handle text.
+ */
+export declare function projectFilesToText(messages: readonly RequestMessage[], resolvePath: (ref: FileAttachmentRef) => string | undefined): readonly RequestMessage[];
 /**
  * Project the surface's offloaded occurrences into deterministic text for one
  * request. The offloaded set is a durable surface fact, so every route sends
@@ -92,6 +98,13 @@ export declare function projectFilesToText(messages: readonly Message[], resolve
  * @returns the original list when nothing is offloaded, otherwise shallow message copies with placeholders.
  */
 export declare function projectOffloadedImages(messages: readonly Message[], placeholder: (ref: ImageAttachmentRef) => string): readonly Message[];
+/**
+ * Project offloaded images in mixed durable and request-only inputs.
+ * @param messages - complete request inputs.
+ * @param placeholder - replacement text for an offloaded attachment.
+ * @returns original messages or shallow copies with placeholders.
+ */
+export declare function projectOffloadedImages(messages: readonly RequestMessage[], placeholder: (ref: ImageAttachmentRef) => string): readonly RequestMessage[];
 /**
  * Number of oldest retained occurrences a route must still offload before a
  * derived request fits its budget at the exact byte length the route sends;
@@ -102,11 +115,17 @@ export declare function projectOffloadedImages(messages: readonly Message[], pla
  * @param versionBytes - exact request-version byte length of one retained occurrence.
  * @returns how many more leading retained occurrences to offload.
  */
-export declare function requiredImageOffload(messages: readonly Message[], budget: Pick<LlmImageRequestBudget, 'representation' | 'maxBytes' | 'maxImages' | 'byteQuantum' | 'countQuantum'>, versionBytes: (block: ImageBlock) => number): number;
+export declare function requiredImageOffload(messages: readonly RequestMessage[], budget: Pick<LlmImageRequestBudget, 'representation' | 'maxBytes' | 'maxImages' | 'byteQuantum' | 'countQuantum'>, versionBytes: (block: ImageBlock) => number): number;
 /**
- * Project durable image history into deterministic text for an exact text-only model.
+ * Project request image content into deterministic text for an exact text-only model.
  * @param messages - complete request history.
  * @returns the original list without images, otherwise shallow message copies with stable placeholders.
  */
 export declare function projectImagesForTextModel(messages: readonly Message[]): readonly Message[];
+/**
+ * Project image content in mixed durable and request-only inputs for a text-only model.
+ * @param messages - complete request inputs.
+ * @returns original inputs without images, otherwise copies with stable placeholders.
+ */
+export declare function projectImagesForTextModel(messages: readonly RequestMessage[]): readonly RequestMessage[];
 //# sourceMappingURL=content.d.ts.map

package/lib/types/content.js

@@ -78,28 +78,24 @@ export function offloadedImageText(ref, access) {
     return `[${identity}${normalizedAccessText(ref, access)}]`;
 }
 /**
- * True when typed model content contains an image block, walking nested
- * tool-result content. This is the one recursive image walk shared by every
- * image policy (capability gating, text-only serialization, compaction
- * survey), so a consumer cannot silently diverge on nesting depth.
+ * True when typed model content contains an image block. This is the one image
+ * walk shared by every image policy (capability gating, text-only
+ * serialization, compaction survey), so a consumer cannot silently diverge.
  * @param content - typed model content blocks.
- * @returns whether any nested block is an image.
+ * @returns whether any block is an image.
  */
 export function contentHasImage(content) {
-    return content.some(block => block.type === 'image'
-        || (block.type === 'tool-result' && contentHasImage(block.content)));
+    return content.some(block => block.type === 'image');
 }
 /**
- * True when typed model content contains a file block, walking nested
- * tool-result content on the same recursion every file policy shares.
+ * True when typed model content contains a file block.
  * Reads current content on every call without retaining scan results.
  * @param content - typed model content blocks.
- * @returns whether any nested block is a file.
+ * @returns whether any block is a file.
  */
 export function contentHasFile(content) {
     for (const block of content) {
-        if (block.type === 'file'
-            || (block.type === 'tool-result' && contentHasFile(block.content)))
+        if (block.type === 'file')
             return true;
     }
     return false;
@@ -120,7 +116,7 @@ export function fileHandleText(ref, readonlyPath) {
     }
     return `[${identity}: verbatim read-only copy saved at ${quoted(readonlyPath)}. Read that path with your file tools when its contents are needed; copy it to a writable location before modifying it. When delegating file work, include this saved path in the delegation prompt; only subagents sharing this execution environment can read it.]`;
 }
-/** Replace every file occurrence, including nested tool results, with handle text. */
+/** Replace every file occurrence with handle text. */
 function replaceFilesWithHandles(blocks, resolvePath) {
     let next;
     for (const [index, block] of blocks.entries()) {
@@ -129,26 +125,10 @@ function replaceFilesWithHandles(blocks, resolvePath) {
             next.push({ type: 'text', text: fileHandleText(block.attachment, resolvePath(block.attachment)) });
             continue;
         }
-        if (block.type === 'tool-result') {
-            const content = replaceFilesWithHandles(block.content, resolvePath);
-            if (content !== block.content) {
-                next ??= blocks.slice(0, index);
-                next.push({ ...block, content });
-                continue;
-            }
-        }
         next?.push(block);
     }
     return next ?? blocks;
 }
-/**
- * Project durable file history into deterministic handle text for every model
- * route. Unlike images, no provider receives file blocks natively, so this
- * projection is unconditional in request assembly.
- * @param messages - complete request history.
- * @param resolvePath - resolve one reference's current execution-world read path.
- * @returns the original list without files, otherwise shallow message copies with handle text.
- */
 export function projectFilesToText(messages, resolvePath) {
     if (!messages.some(message => contentHasFile(message.content)))
         return messages;
@@ -162,8 +142,7 @@ function base64Length(bytes) {
     return Math.ceil(bytes / 3) * 4;
 }
 /**
- * Visit every image occurrence of typed content in message order, including
- * nested tool-result content.
+ * Visit every image occurrence of typed content in message order.
  * @param content - typed model content blocks.
  * @param visit - called once per occurrence.
  */
@@ -171,11 +150,9 @@ function visitImageBlocks(content, visit) {
     for (const block of content) {
         if (block.type === 'image')
             visit(block);
-        else if (block.type === 'tool-result')
-            visitImageBlocks(block.content, visit);
     }
 }
-/** Replace every offloaded occurrence, including nested tool results, with its placeholder. */
+/** Replace every offloaded occurrence with its placeholder. */
 function replaceOffloadedImages(blocks, placeholder) {
     let next;
     for (const [index, block] of blocks.entries()) {
@@ -184,26 +161,10 @@ function replaceOffloadedImages(blocks, placeholder) {
             next.push({ type: 'text', text: placeholder(block.attachment) });
             continue;
         }
-        if (block.type === 'tool-result') {
-            const content = replaceOffloadedImages(block.content, placeholder);
-            if (content !== block.content) {
-                next ??= blocks.slice(0, index);
-                next.push({ ...block, content });
-                continue;
-            }
-        }
         next?.push(block);
     }
     return next ?? blocks;
 }
-/**
- * Project the surface's offloaded occurrences into deterministic text for one
- * request. The offloaded set is a durable surface fact, so every route sends
- * the same set; only the placeholder text is route-owned.
- * @param messages - derived request history.
- * @param placeholder - build the model-visible replacement for one offloaded attachment.
- * @returns the original list when nothing is offloaded, otherwise shallow message copies with placeholders.
- */
 export function projectOffloadedImages(messages, placeholder) {
     return messages.map((message) => {
         const content = replaceOffloadedImages(message.content, placeholder);
@@ -263,7 +224,7 @@ export function requiredImageOffload(messages, budget, versionBytes) {
     }
     return offloadedImagePrefixCount(lengths, budget);
 }
-/** Replace every image occurrence, including nested tool results, for a text-only model. */
+/** Replace every image occurrence for a text-only model. */
 function replaceImagesForTextModel(blocks) {
     let next;
     for (const [index, block] of blocks.entries()) {
@@ -272,23 +233,10 @@ function replaceImagesForTextModel(blocks) {
             next.push({ type: 'text', text: textOnlyImageText(block.attachment) });
             continue;
         }
-        if (block.type === 'tool-result') {
-            const content = replaceImagesForTextModel(block.content);
-            if (content !== block.content) {
-                next ??= blocks.slice(0, index);
-                next.push({ ...block, content });
-                continue;
-            }
-        }
         next?.push(block);
     }
     return next ?? blocks;
 }
-/**
- * Project durable image history into deterministic text for an exact text-only model.
- * @param messages - complete request history.
- * @returns the original list without images, otherwise shallow message copies with stable placeholders.
- */
 export function projectImagesForTextModel(messages) {
     if (!messages.some(message => contentHasImage(message.content)))
         return messages;

package/lib/types/index.d.ts

@@ -38,8 +38,8 @@ declare module '@deepseek-ai/cordis' {
          *   process-local {@link markAgentLoopRequest} identity and arrives deep-frozen
          *   (mutation throws): its content is a pure function of the session log (the
          *   reconstructability Agent Note), so listeners read it, never rewrite it.
-         *   Hand-built calls do not carry that marker; their messages already obey
-         *   the immutable creation contract.
+         *   Hand-built calls do not carry that marker; callers own their request
+         *   inputs and must keep them unchanged until the stream settles.
          * @mode waterfall
          */
         'llm/stream'(this: LlmRuntime, options: GenerateOptions, next: () => AsyncIterable<StreamChunk>): AsyncIterable<StreamChunk>;

package/lib/types/index.js

@@ -773,8 +773,10 @@ let LlmRuntime = (() => {
         /** Remove replay state whose historical route is owned by another adapter. */
         forAdapter(options, adapter) {
             const messages = options.messages.map((message) => {
+                if (message.role !== 'assistant')
+                    return message;
                 const source = message.source;
-                if (message.role !== 'assistant' || source.kind !== 'model' || source.replayState === undefined)
+                if (source.replayState === undefined)
                     return message;
                 if (this.adapters.get(source.provider)?.adapter === adapter)
                     return message;