@namzu/sdk 2.0.0 → 3.0.0

package/dist/types/hitl/index.d.ts

@@ -1,3 +1,5 @@
+import type { WorkingStateSnapshot } from '../../compaction/wire.js';
+import type { SerializedSpanContext } from '../../telemetry/attributes.js';
 import type { CostInfo, TokenUsage } from '../common/index.js';
 import type { CheckpointId, PlanId, RunId } from '../ids/index.js';
 import type { Message } from '../message/index.js';
@@ -13,6 +15,24 @@ export type HITLResumeDecision = {
     feedback: string;
 } | {
     action: 'approve_tools';
+    /**
+     * Grant keys to remember, so calls covered by them are not asked
+     * about again for the rest of the run.
+     *
+     * Nothing is remembered unless this says so, and only an explicit
+     * approval can say it — a denial or a non-response leaves nothing
+     * behind. Non-reuse was deliberate ("consent is not
+     * transferable"); what changes is that the SCOPE becomes the
+     * approver's to choose rather than being fixed at "this one call"
+     * or, in the only escape available, "everything for the session".
+     *
+     * Keys come from {@link ToolGrantKeys}, so a grant can be as
+     * narrow as one exact invocation or as wide as a whole tool.
+     * `bash` is unconditionally non-read-only and in no allowlist, so
+     * `bash: git status` re-prompted on every batch forever and the
+     * only way out was a blanket grant that also covered `rm -rf`.
+     */
+    remember?: readonly string[];
 } | {
     action: 'modify_tools';
     modifications: ToolModification[];
@@ -114,18 +134,54 @@ export interface CheckpointSummary {
     costInfo: CostInfo;
     lastAssistantMessage?: string;
 }
-export interface ActiveNodeInfo {
-    agentId: string;
-    agentType: 'reactive' | 'pipeline' | 'router' | 'supervisor';
-    nodeRef?: string;
-    parentAgentId?: string;
-    depth: number;
-}
-export interface BranchStackEntry {
-    agentId: string;
-    decision: string;
-    confidence: number;
-    timestamp: number;
+/**
+ * A decision the run is parked on, recorded durably.
+ *
+ * Without this the park exists only as a suspended `await` inside one
+ * process: a checkpoint written at a tool-review gate looks identical to a
+ * checkpoint written mid-run, so nothing on disk says "a human owes this
+ * run an answer". Kill the process and the request is gone — the approval
+ * queue a host would build from durable state has nothing to read, and a
+ * resumed run silently re-asks the model instead of honoring the approval
+ * that was already granted.
+ *
+ * `request` is stored verbatim so a fresh process can render exactly what
+ * the human was shown, and apply the answer to exactly those tool calls.
+ */
+export interface PendingDecision {
+    /** The request the run parked on, as the `resumeHandler` received it. */
+    readonly request: HITLDecisionRequest;
+    /** Epoch ms at which the run parked. */
+    readonly parkedAt: number;
+    /**
+     * Epoch ms after which this park is no longer worth serving.
+     *
+     * Absolute, not a duration, so it survives the process that set it —
+     * every timer in the SDK is an in-process `setTimeout` and the
+     * park-record delay is deliberately `unref`'d, so nothing in-memory can
+     * outlive a redeploy. Without it a run parks for approval, the worker is
+     * replaced, nobody answers, and the checkpoint stays outstanding
+     * forever: every approval-queue reader keeps serving it and its
+     * workspace is never reclaimed.
+     *
+     * The run timeout cannot cover this. `checkLimitsDetailed` is only
+     * reached between iterations and a park suspends mid-iteration, so a
+     * long-lived process hard-stops the run immediately AFTER the human
+     * finally approves, while across a restart the restored elapsed time
+     * excludes parked time entirely — the same configuration giving two
+     * opposite outcomes.
+     *
+     * Absent means no deadline, which is today's behaviour.
+     */
+    readonly deadlineAt?: number;
+    /**
+     * Set once the decision arrives, so a resolved checkpoint stays
+     * distinguishable from one that was never parked. A checkpoint is
+     * outstanding when `pending` is set and `resolvedAt` is not.
+     */
+    readonly resolvedAt?: number;
+    /** The answer, when one arrived. Kept as evidence of who decided what. */
+    readonly decision?: HITLResumeDecision;
 }
 export interface IterationCheckpoint {
     id: CheckpointId;
@@ -135,14 +191,41 @@ export interface IterationCheckpoint {
     tokenUsage: TokenUsage;
     costInfo: CostInfo;
     planStatus?: PlanStatus;
+    /**
+     * Present when the run parked at this checkpoint awaiting a human.
+     * See {@link PendingDecision}.
+     */
+    pending?: PendingDecision;
     guardState: {
         iterationCount: number;
         elapsedMs: number;
     };
     createdAt: number;
     toolResultHashes?: Record<string, string>;
-    branchStack?: BranchStackEntry[];
-    activeNode?: ActiveNodeInfo;
+    /**
+     * Compaction's accumulated working state at the moment of the
+     * checkpoint.
+     *
+     * Absent on checkpoints written before this existed, and absent when
+     * compaction is disabled — in both cases the resumed run starts with an
+     * empty manager, which is exactly today's behaviour.
+     */
+    workingState?: WorkingStateSnapshot;
+    /**
+     * The trace this checkpoint was taken inside.
+     *
+     * A resumed run used to mint a fresh root span with a new trace id and
+     * no link to the one that crashed, so the failure and its recovery could
+     * not be reconstructed as one timeline. Every span carries the run id,
+     * which is enough to find both traces by query and not enough to see one
+     * waterfall — and even that goes away for a replay fork, which mints a
+     * new run id.
+     *
+     * Absent on checkpoints written before this existed, and on runs with no
+     * telemetry registered; in both cases the resumed run starts its own
+     * trace, which is exactly today's behaviour.
+     */
+    traceContext?: SerializedSpanContext;
 }
 export declare function autoApproveHandler(request: HITLDecisionRequest): Promise<HITLResumeDecision>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/hitl/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"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"}

package/dist/types/hitl/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"AA8IA,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC9D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,eAAe;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;QACnD,KAAK,aAAa;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;QACpD,KAAK,sBAAsB;YAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QAC/C,KAAK,eAAe;YACnB,2DAA2D;YAC3D,yDAAyD;YACzD,6DAA6D;YAC7D,uCAAuC;YACvC,OAAO,OAAO,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,iBAAiB;gBACzB,iBAAiB,EAAE,EAAE;gBACrB,QAAQ,EAAE,mEAAmE;gBAC7E,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;aACvC,CAAC,CAAA;QACH,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,OAAO,CAAA;YAClC,MAAM,IAAI,KAAK,CAAC,gCAAiC,WAAmC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7F,CAAC;IACF,CAAC;AACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"AAgOA,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC9D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,eAAe;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;QACnD,KAAK,aAAa;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;QACpD,KAAK,sBAAsB;YAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QAC/C,KAAK,eAAe;YACnB,2DAA2D;YAC3D,yDAAyD;YACzD,6DAA6D;YAC7D,uCAAuC;YACvC,OAAO,OAAO,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,iBAAiB;gBACzB,iBAAiB,EAAE,EAAE;gBACrB,QAAQ,EAAE,mEAAmE;gBAC7E,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;aACvC,CAAC,CAAA;QACH,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,OAAO,CAAA;YAClC,MAAM,IAAI,KAAK,CAAC,gCAAiC,WAAmC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7F,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/types/ids/index.d.ts

@@ -4,11 +4,11 @@ export type SessionId = `ses_${string}`;
 export type ToolCallId = `call_${string}`;
 /**
  * Provider-issued tool-use identifier surfaced on the streaming event bus.
- * Providers emit different prefixes (Anthropic: `toolu_*`, OpenAI: `call_*`,
+ * Providers emit different prefixes (`toolu_*`, `call_*`,
  * others vary), so this type intentionally stays unbranded — we accept the
  * provider's verbatim string and use it solely as a correlation key across
  * `tool_input_*`, `tool_executing`, and `tool_completed` events. Distinct
- * from {@link ToolCallId} which is the OpenAI-format identifier carried in
+ * from {@link ToolCallId} which is the wire-format identifier carried in
  * persisted assistant messages and replay records.
  */
 export type ToolUseId = string;

package/dist/types/message/content.d.ts

@@ -0,0 +1,22 @@
+import type { ToolResultBlock, ToolResultContent } from './index.js';
+/**
+ * Normalize tool-result content to blocks.
+ *
+ * A plain string is the common case and stays first-class; this is the
+ * adapter for drivers that want to walk blocks uniformly.
+ */
+export declare function toToolResultBlocks(content: ToolResultContent): readonly ToolResultBlock[];
+/**
+ * Flatten tool-result content to text.
+ *
+ * For drivers that cannot express non-text tool results, and for every
+ * host-facing surface (transcript, compaction, UI) that reasons over
+ * strings. Non-text blocks become a short, honest placeholder rather than
+ * their base64 payload: dumping the bytes is what made `computer-use`
+ * send megabytes of undecodable characters as text, and silently dropping
+ * them would let the model believe it saw something it did not.
+ */
+export declare function toolResultToText(content: ToolResultContent): string;
+/** True when the content needs a driver that can carry non-text blocks. */
+export declare function hasNonTextBlocks(content: ToolResultContent): boolean;
+//# sourceMappingURL=content.d.ts.map

package/dist/types/message/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/types/message/content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEpE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,eAAe,EAAE,CAEzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAcnE;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAEpE"}

package/dist/types/message/content.js

@@ -0,0 +1,49 @@
+/**
+ * Normalize tool-result content to blocks.
+ *
+ * A plain string is the common case and stays first-class; this is the
+ * adapter for drivers that want to walk blocks uniformly.
+ */
+export function toToolResultBlocks(content) {
+    return typeof content === 'string' ? [{ type: 'text', text: content }] : content;
+}
+/**
+ * Flatten tool-result content to text.
+ *
+ * For drivers that cannot express non-text tool results, and for every
+ * host-facing surface (transcript, compaction, UI) that reasons over
+ * strings. Non-text blocks become a short, honest placeholder rather than
+ * their base64 payload: dumping the bytes is what made `computer-use`
+ * send megabytes of undecodable characters as text, and silently dropping
+ * them would let the model believe it saw something it did not.
+ */
+export function toolResultToText(content) {
+    if (typeof content === 'string')
+        return content;
+    return content
+        .map((block) => {
+        switch (block.type) {
+            case 'text':
+                return block.text;
+            case 'image':
+                return `[image: ${block.mediaType}, ${describeSize(block.data)} — not renderable by this provider]`;
+            case 'document':
+                return `[document${block.name ? ` "${block.name}"` : ''}: ${block.mediaType}, ${describeSize(block.data)} — not renderable by this provider]`;
+        }
+    })
+        .join('\n');
+}
+/** True when the content needs a driver that can carry non-text blocks. */
+export function hasNonTextBlocks(content) {
+    return typeof content !== 'string' && content.some((b) => b.type !== 'text');
+}
+/** Approximate decoded byte count of a base64 payload, for a human-readable note. */
+function describeSize(base64) {
+    const bytes = Math.floor((base64.length * 3) / 4);
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=content.js.map

package/dist/types/message/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/types/message/content.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC5D,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AACjF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IAC1D,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAA;IAC/C,OAAO,OAAO;SACZ,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACd,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,MAAM;gBACV,OAAO,KAAK,CAAC,IAAI,CAAA;YAClB,KAAK,OAAO;gBACX,OAAO,WAAW,KAAK,CAAC,SAAS,KAAK,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAA;YACpG,KAAK,UAAU;gBACd,OAAO,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,SAAS,KAAK,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAA;QAC/I,CAAC;IACF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAA;AACb,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IAC1D,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;AAC7E,CAAC;AAED,qFAAqF;AACrF,SAAS,YAAY,CAAC,MAAc;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAA;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAChE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;AAClD,CAAC"}

package/dist/types/message/index.d.ts

@@ -2,15 +2,90 @@ export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
 export type CacheHint = 'cache' | 'ephemeral' | 'none';
 /**
  * An image attached to a user message (vision input). Additive: providers
- * that support vision (e.g. Anthropic) emit it as an image content block
+ * that support vision emit it as an image content block
  * alongside the text; providers that don't simply ignore it.
  */
 export interface ImageAttachment {
+    /**
+     * Optional, and optional forever: an attachment without a discriminant
+     * is an image, which is what every attachment was before documents
+     * existed. Requiring it would have broken every caller to describe a
+     * default they were already relying on.
+     */
+    readonly type?: 'image';
     /** Base64-encoded image bytes (no `data:` URI prefix). */
     readonly data: string;
     /** IANA media type, e.g. `image/png`, `image/jpeg`, `image/webp`. */
     readonly mediaType: string;
 }
+/**
+ * A document attached to a user message.
+ *
+ * Documents existed in the type system only in the TOOL-RESULT direction,
+ * so "here is the contract, answer questions about it" was reachable only
+ * by having a tool read the file and stringify it. That loses the
+ * provider's native document handling — page structure, built-in OCR,
+ * citations — and pays the text cost instead.
+ */
+export interface DocumentAttachment {
+    readonly type: 'document';
+    /**
+     * Ask the model to cite this document when it uses it.
+     *
+     * Opt-in, because it is not free: the provider splits the document
+     * into citable units and the answer carries the passages it leaned
+     * on, which costs tokens on a turn that may not need them.
+     *
+     * Citations come back on the assistant message, not in its text —
+     * see {@link Citation}.
+     */
+    readonly citations?: boolean;
+    /** Base64-encoded bytes (no `data:` URI prefix). */
+    readonly data: string;
+    /** IANA media type, e.g. `application/pdf`. */
+    readonly mediaType: string;
+    /** Shown to the model, so it can refer to the file by name. */
+    readonly name?: string;
+}
+/**
+ * Where a passage the model cited came from.
+ *
+ * Sending a document buys the provider's native handling of it — page
+ * structure, built-in OCR, and the ability to say WHICH passage an
+ * answer rests on. namzu could send the document and could not receive
+ * the third: an answer about a contract arrived as prose, and checking
+ * it meant reading the contract again by hand. A citation is the
+ * difference between an answer you trust and one you verify.
+ *
+ * The location is a union rather than a page number because providers
+ * segment differently and the segmentation is theirs: pages for a
+ * paginated document, character offsets for plain text, block indices
+ * for something already structured. Flattening them all to "page" would
+ * invent a number for the two that have none.
+ */
+export interface Citation {
+    /** The passage itself, verbatim from the source. */
+    readonly citedText: string;
+    /** Which attachment, by position in the message that carried it. */
+    readonly documentIndex: number;
+    readonly documentTitle?: string;
+    readonly location: {
+        readonly kind: 'page';
+        readonly start: number;
+        readonly end: number;
+    } | {
+        readonly kind: 'char';
+        readonly start: number;
+        readonly end: number;
+    } | {
+        readonly kind: 'block';
+        readonly start: number;
+        readonly end: number;
+    };
+}
+/** What a user message may carry alongside its text. */
+export type MessageAttachment = ImageAttachment | DocumentAttachment;
+export declare const isDocumentAttachment: (attachment: MessageAttachment) => attachment is DocumentAttachment;
 export interface ToolCall {
     id: string;
     type: 'function';
@@ -25,13 +100,48 @@ export interface ToolCall {
      */
     metadata?: {
         inputTruncated?: boolean;
+        /**
+         * The partial argument buffer as it arrived, when the stream cut off
+         * mid-JSON. `function.arguments` is normalized to `"{}"` in that
+         * case so tool args stay clean, which leaves this as the only record
+         * of what the model was actually saying — and a `repairToolCall`
+         * hook has nothing to repair without it.
+         */
+        partialArguments?: string;
     };
 }
 export interface BaseMessage {
+    /**
+     * Widened from `string | null` so `ToolMessage` can carry content
+     * blocks. Each variant below narrows it back to exactly what that role
+     * may hold, so no caller loses type safety — only the shared base is
+     * permissive.
+     */
     role: MessageRole;
-    content: string | null;
+    content: string | null | readonly ToolResultBlock[];
     timestamp?: number;
     cacheHint?: CacheHint;
+    /**
+     * Exempt this message from compaction and from tool-result clearing.
+     *
+     * Everything the run protected before was protected by POSITION — the
+     * leading system run, the working-memory slot, the last N turns, the
+     * most recent tool results. A standing constraint stated in the middle
+     * of a conversation ("the account id is X; never bill a different
+     * one") therefore aged out at the same rate as chatter, and no
+     * positional rule could express it.
+     *
+     * Protection is transitive across a tool pair: pinning a
+     * `tool_result` also pins the assistant turn that called it, and
+     * pinning that turn pins every result answering it. Half a pair is not
+     * a smaller history, it is one the provider rejects.
+     *
+     * Pinned turns are exempt from the reclaim that keeps a long run
+     * alive, so this is a budget the setter spends. Nothing caps it: a cap
+     * would have to guess which pin mattered, and dropping the wrong one
+     * quietly is worse than a run that overflows in the open.
+     */
+    retain?: boolean;
 }
 export interface SystemMessage extends BaseMessage {
     role: 'system';
@@ -40,22 +150,97 @@ export interface SystemMessage extends BaseMessage {
 export interface UserMessage extends BaseMessage {
     role: 'user';
     content: string;
-    /** Optional image attachments (vision input). */
-    attachments?: readonly ImageAttachment[];
+    /** Optional image or document attachments. */
+    attachments?: readonly MessageAttachment[];
+}
+/**
+ * An opaque reasoning block produced by the model.
+ *
+ * Deliberately opaque: the SDK stores and replays it, never interprets it.
+ * A provider whose reasoning blocks are signed requires the preceding
+ * assistant turn to be echoed back **verbatim** — thinking blocks and
+ * their cryptographic `signature` included — whenever a `tool_result`
+ * follows. namzu's drivers *rebuilt* each assistant turn as
+ * `[text?, ...tool_use]`, which is exactly the pattern such a contract
+ * prohibits, and `AssistantMessage` had nowhere to keep a signature
+ * even if a driver had parsed one.
+ *
+ * The requirement is not one vendor's quirk: dropping reasoning items
+ * costs measurable multi-step accuracy wherever they are signed.
+ */
+export interface ReasoningBlock {
+    readonly type: 'thinking' | 'redacted_thinking';
+    readonly text?: string;
+    /** Cryptographic signature; replaying it unchanged is mandatory. */
+    readonly signature?: string;
+    /** Opaque payload for the ZDR / stateless path. */
+    readonly encrypted?: string;
 }
 export interface AssistantMessage extends BaseMessage {
     role: 'assistant';
     content: string | null;
     toolCalls?: ToolCall[];
+    /**
+     * Reasoning the model emitted before this turn's content, in order.
+     * Replayed verbatim and ahead of the text/tool blocks — see
+     * {@link ReasoningBlock}.
+     */
+    reasoning?: readonly ReasoningBlock[];
+    /**
+     * Passages this turn rests on, when the request asked for them.
+     *
+     * On the message rather than inside its text: the text is what a
+     * human reads and the citations are what a checker follows, and
+     * splicing markers into the prose would make the answer worse to read
+     * in exchange for making it machine-checkable. Empty and absent mean
+     * the same thing — the model cited nothing.
+     */
+    citations?: readonly Citation[];
 }
+/**
+ * A block of tool-result content the model can actually perceive.
+ *
+ * `ToolMessage.content` was `string`, so anything non-textual had to be
+ * stringified to reach the model. `@namzu/computer-use`'s `screenshot`
+ * returned ~400 KB–2.7 MB of base64 as TEXT — roughly 100k–670k tokens of
+ * characters no model can decode — and every MCP `image`/`resource` block
+ * was silently dropped by the adapter. Computer use was, in practice,
+ * non-functional.
+ */
+export type ToolResultBlock = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'image';
+    readonly data: string;
+    readonly mediaType: string;
+} | DocumentAttachment;
+/**
+ * String stays a first-class shape, not a deprecated one: it is the
+ * overwhelmingly common case, and keeping it means every existing tool and
+ * driver compiles unchanged while the block array is added beside it.
+ */
+export type ToolResultContent = string | readonly ToolResultBlock[];
 export interface ToolMessage extends BaseMessage {
     role: 'tool';
-    content: string;
+    content: ToolResultContent;
     toolCallId: string;
+    /**
+     * Marks the result as a failure on the wire — each provider spells it
+     * differently (`is_error`, `status: 'error'`), and every driver has
+     * somewhere to put it.
+     *
+     * The executor already computed this and routed it to the SSE bridge,
+     * the A2A bridge and the TUI — then dropped it at the provider
+     * boundary, so the model's trained tool-failure recovery path never
+     * fired and namzu relied on prose formatting to convey failure.
+     */
+    isError?: boolean;
 }
 export type Message = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
 export declare function createSystemMessage(content: string, cacheHint?: CacheHint): SystemMessage;
-export declare function createUserMessage(content: string, attachments?: readonly ImageAttachment[]): UserMessage;
-export declare function createAssistantMessage(content: string | null, toolCalls?: ToolCall[]): AssistantMessage;
-export declare function createToolMessage(content: string, toolCallId: string): ToolMessage;
+export declare function createUserMessage(content: string, attachments?: readonly MessageAttachment[]): UserMessage;
+export declare function createAssistantMessage(content: string | null, toolCalls?: ToolCall[], reasoning?: readonly ReasoningBlock[], citations?: readonly Citation[]): AssistantMessage;
+export declare function createToolMessage(content: ToolResultContent, toolCallId: string, isError?: boolean): ToolMessage;
+export { hasNonTextBlocks, toToolResultBlocks, toolResultToText } from './content.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/message/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/message/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;AAElE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAA;AAEtD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;KACjB,CAAA;IACD;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,OAAO,CAAA;KACxB,CAAA;CACD;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,WAAW,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,WAAW,CAAA;AAElF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,CAOzF;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,SAAS,eAAe,EAAE,GACtC,WAAW,CAOb;AAED,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,CAAC,EAAE,QAAQ,EAAE,GACpB,gBAAgB,CAElB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAElF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/message/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;AAElE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAA;AAEtD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,QAAQ;IACxB,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EACd;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GACvE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GACvE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3E;AAED,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,kBAAkB,CAAA;AAEpE,eAAO,MAAM,oBAAoB,GAChC,YAAY,iBAAiB,KAC3B,UAAU,IAAI,kBAAoD,CAAA;AAErE,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;KACjB,CAAA;IACD;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB;;;;;;WAMG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;CACD;AAED,MAAM,WAAW,WAAW;IAC3B;;;;;OAKG;IACH,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,eAAe,EAAE,CAAA;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAAA;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACrC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;CAC/B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7E,kBAAkB,CAAA;AAErB;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,eAAe,EAAE,CAAA;AAEnE,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,iBAAiB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,WAAW,CAAA;AAElF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,CAOzF;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,GACxC,WAAW,CAOb;AAED,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,CAAC,EAAE,QAAQ,EAAE,EACtB,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,EACrC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,GAC7B,gBAAgB,CASlB;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,GACf,WAAW,CAQb;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA"}

package/dist/types/message/index.js

@@ -1,3 +1,4 @@
+export const isDocumentAttachment = (attachment) => attachment.type === 'document';
 export function createSystemMessage(content, cacheHint) {
     return {
         role: 'system',
@@ -14,10 +15,24 @@ export function createUserMessage(content, attachments) {
         ...(attachments && attachments.length > 0 ? { attachments } : {}),
     };
 }
-export function createAssistantMessage(content, toolCalls) {
-    return { role: 'assistant', content, toolCalls, timestamp: Date.now() };
+export function createAssistantMessage(content, toolCalls, reasoning, citations) {
+    return {
+        role: 'assistant',
+        content,
+        toolCalls,
+        ...(reasoning && reasoning.length > 0 ? { reasoning } : {}),
+        ...(citations && citations.length > 0 ? { citations } : {}),
+        timestamp: Date.now(),
+    };
 }
-export function createToolMessage(content, toolCallId) {
-    return { role: 'tool', content, toolCallId, timestamp: Date.now() };
+export function createToolMessage(content, toolCallId, isError) {
+    return {
+        role: 'tool',
+        content,
+        toolCallId,
+        ...(isError !== undefined ? { isError } : {}),
+        timestamp: Date.now(),
+    };
 }
+export { hasNonTextBlocks, toToolResultBlocks, toolResultToText } from './content.js';
 //# sourceMappingURL=index.js.map

package/dist/types/message/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/message/index.ts"],"names":[],"mappings":"AAkEA,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,SAAqB;IACzE,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;KAC7C,CAAA;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,OAAe,EACf,WAAwC;IAExC,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAA;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,OAAsB,EACtB,SAAsB;IAEtB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,UAAkB;IACpE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;AACpE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/message/index.ts"],"names":[],"mappings":"AAoFA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,UAA6B,EACM,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,CAAA;AAgKrE,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,SAAqB;IACzE,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;KAC7C,CAAA;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,OAAe,EACf,WAA0C;IAE1C,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAA;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,OAAsB,EACtB,SAAsB,EACtB,SAAqC,EACrC,SAA+B;IAE/B,OAAO;QACN,IAAI,EAAE,WAAW;QACjB,OAAO;QACP,SAAS;QACT,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACrB,CAAA;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,OAA0B,EAC1B,UAAkB,EAClB,OAAiB;IAEjB,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,OAAO;QACP,UAAU;QACV,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACrB,CAAA;AACF,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA"}