@teaflask/assistant 0.0.0 → 0.3.0

package/dist/core/tool-call-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-presentation.js","sourceRoot":"","sources":["../../src/core/tool-call-presentation.ts"],"names":[],"mappings":"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"}

package/dist/core/tool-cancel-anchors.d.ts

@@ -0,0 +1,6 @@
+export declare const EMPTY_TOOL_CANCEL_ANCHORS: ReadonlySet<string>;
+export declare const toolCallCancelledOf: (event: unknown) => boolean;
+export declare const withToolCancelAnchored: (previous: ReadonlySet<string>, toolCallId: string) => ReadonlySet<string>;
+export declare const wellFormedToolCancelAnchorsOf: (stored: ReadonlySet<string>) => ReadonlySet<string>;
+export declare const toolCancelRecorder: (onAnchored: (toolCallId: string) => void) => import("@ag-ui/client").AgentSubscriber;
+//# sourceMappingURL=tool-cancel-anchors.d.ts.map

package/dist/core/tool-cancel-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cancel-anchors.d.ts","sourceRoot":"","sources":["../../src/core/tool-cancel-anchors.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,yBAAyB,qBAAgB,CAAC;AACvD,eAAO,MAAM,mBAAmB,6BAAiB,CAAC;AAClD,eAAO,MAAM,sBAAsB,4EAAuB,CAAC;AAC3D,eAAO,MAAM,6BAA6B,sDAAuB,CAAC;AAClE,eAAO,MAAM,kBAAkB,uFAAqB,CAAC"}

package/dist/core/tool-cancel-anchors.js

@@ -0,0 +1,13 @@
+// The tool-cancel anchor set: a cancelled TOOL_CALL_RESULT's content is
+// the model-facing cancellation text, so the transcript reads this set to
+// light the call's cancelled state and keep that text off the Result
+// pane. One binding of the shared boolean-flag family — see
+// tool-flag-anchors.ts for the model and the strip-and-lift rationale.
+import { toolFlagAnchorsOf } from "./tool-flag-anchors.js";
+const anchors = toolFlagAnchorsOf("cancelled");
+export const EMPTY_TOOL_CANCEL_ANCHORS = anchors.empty;
+export const toolCallCancelledOf = anchors.flagOf;
+export const withToolCancelAnchored = anchors.withAnchored;
+export const wellFormedToolCancelAnchorsOf = anchors.wellFormedOf;
+export const toolCancelRecorder = anchors.recorderOf;
+//# sourceMappingURL=tool-cancel-anchors.js.map

package/dist/core/tool-cancel-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cancel-anchors.js","sourceRoot":"","sources":["../../src/core/tool-cancel-anchors.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,qEAAqE;AACrE,4DAA4D;AAC5D,uEAAuE;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC,KAAK,CAAC;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;AAClD,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC,YAAY,CAAC;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC"}

package/dist/core/tool-decision-anchors.d.ts

@@ -0,0 +1,26 @@
+import type { AgentSubscriber } from "@ag-ui/client";
+export declare const EMPTY_TOOL_DECISION_ANCHORS: ReadonlySet<string>;
+/**
+ * Narrow a CUSTOM event to the tool call id it marks as decision-bearing,
+ * or null: an approval_requested with a tool_call_id, or a
+ * tool_execution_requested whose request.kind is member-answerable. Anything malformed is ignored — the contract's
+ * "clients MUST ignore events and fields they do not recognize". An
+ * unanchored ask (tool_call_id null — a wire that named no call) marks
+ * nothing: there is no row to hold open.
+ */
+export declare function toolDecisionAnchorOf(name: string, value: unknown): string | null;
+/**
+ * Idempotent anchor merge: every connection replays the stream from its
+ * boundary (and StrictMode aborts and reruns the first connection), so
+ * the same marker can arrive more than once per mount. A repeat returns
+ * the set unchanged — identity is the publish gate.
+ */
+export declare function withToolDecisionAnchored(previous: ReadonlySet<string>, toolCallId: string): ReadonlySet<string>;
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * non-string members are dropped rather than rendered (or crashed on) —
+ * a dropped anchor reappears on the next full replay.
+ */
+export declare function wellFormedToolDecisionAnchorsOf(stored: ReadonlySet<string>): ReadonlySet<string>;
+export declare function toolDecisionRecorder(onDecisionAnchored: (toolCallId: string) => void): AgentSubscriber;
+//# sourceMappingURL=tool-decision-anchors.d.ts.map

package/dist/core/tool-decision-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-decision-anchors.d.ts","sourceRoot":"","sources":["../../src/core/tool-decision-anchors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAYrD,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAa,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,CA6Bf;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,WAAW,CAAC,MAAM,CAAC,CAOrB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAC1B,WAAW,CAAC,MAAM,CAAC,CAQrB;AAED,wBAAgB,oBAAoB,CAClC,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAC/C,eAAe,CASjB"}

package/dist/core/tool-decision-anchors.js

@@ -0,0 +1,87 @@
+// The tool-decision anchor set: the durable record that a call
+// carried a member decision, keyed by tool_call_id. The placement hold
+// reads THIS, never the pruned live card stores — the hold window is the
+// TURN. A pure fold over replayed CUSTOM markers: docs/decision-anchors.md.
+import { APPROVAL_REQUESTED_EVENT_NAME, TOOL_EXECUTION_REQUESTED_EVENT_NAME, } from "../contract/events.js";
+// The kinds leaf, never execution-handlers: this module is a value
+// export of the ./transcript projection entry, and the handlers module
+// drags the transport/reader/affordance layers that entry's law bans
+// (tests/bundle-closure.test.ts pins it).
+import { MEMBER_ANSWERABLE_KINDS } from "./execution-kinds.js";
+export const EMPTY_TOOL_DECISION_ANCHORS = new Set();
+/**
+ * Narrow a CUSTOM event to the tool call id it marks as decision-bearing,
+ * or null: an approval_requested with a tool_call_id, or a
+ * tool_execution_requested whose request.kind is member-answerable. Anything malformed is ignored — the contract's
+ * "clients MUST ignore events and fields they do not recognize". An
+ * unanchored ask (tool_call_id null — a wire that named no call) marks
+ * nothing: there is no row to hold open.
+ */
+export function toolDecisionAnchorOf(name, value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const record = value;
+    const toolCallId = typeof record.tool_call_id === "string" && record.tool_call_id !== ""
+        ? record.tool_call_id
+        : null;
+    if (toolCallId === null) {
+        return null;
+    }
+    if (name === APPROVAL_REQUESTED_EVENT_NAME) {
+        return toolCallId;
+    }
+    if (name === TOOL_EXECUTION_REQUESTED_EVENT_NAME) {
+        const request = record.request;
+        if (typeof request !== "object" || request === null) {
+            return null;
+        }
+        const kind = request.kind;
+        // MEMBER_ANSWERABLE_KINDS, not the single ask kind: the anchor marks
+        // "a member decision rode this call", and a future member-answerable
+        // kind must hold its row without a second edit here.
+        return typeof kind === "string" && MEMBER_ANSWERABLE_KINDS.has(kind)
+            ? toolCallId
+            : null;
+    }
+    return null;
+}
+/**
+ * Idempotent anchor merge: every connection replays the stream from its
+ * boundary (and StrictMode aborts and reruns the first connection), so
+ * the same marker can arrive more than once per mount. A repeat returns
+ * the set unchanged — identity is the publish gate.
+ */
+export function withToolDecisionAnchored(previous, toolCallId) {
+    if (previous.has(toolCallId)) {
+        return previous;
+    }
+    const next = new Set(previous);
+    next.add(toolCallId);
+    return next;
+}
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * non-string members are dropped rather than rendered (or crashed on) —
+ * a dropped anchor reappears on the next full replay.
+ */
+export function wellFormedToolDecisionAnchorsOf(stored) {
+    const seeded = new Set();
+    for (const toolCallId of stored) {
+        if (typeof toolCallId === "string") {
+            seeded.add(toolCallId);
+        }
+    }
+    return seeded;
+}
+export function toolDecisionRecorder(onDecisionAnchored) {
+    return {
+        onCustomEvent({ event }) {
+            const toolCallId = toolDecisionAnchorOf(event.name, event.value);
+            if (toolCallId !== null) {
+                onDecisionAnchored(toolCallId);
+            }
+        },
+    };
+}
+//# sourceMappingURL=tool-decision-anchors.js.map

package/dist/core/tool-decision-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-decision-anchors.js","sourceRoot":"","sources":["../../src/core/tool-decision-anchors.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uEAAuE;AACvE,yEAAyE;AACzE,4EAA4E;AAI5E,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,GACpC,MAAM,uBAAuB,CAAC;AAC/B,mEAAmE;AACnE,uEAAuE;AACvE,qEAAqE;AACrE,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,MAAM,2BAA2B,GAAwB,IAAI,GAAG,EAAE,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,UAAU,GACd,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,YAAY,KAAK,EAAE;QACnE,CAAC,CAAC,MAAM,CAAC,YAAY;QACrB,CAAC,CAAC,IAAI,CAAC;IACX,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,KAAK,6BAA6B,EAAE,CAAC;QAC3C,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,KAAK,mCAAmC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAI,OAAmC,CAAC,IAAI,CAAC;QACvD,qEAAqE;QACrE,qEAAqE;QACrE,qDAAqD;QACrD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC;YAClE,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA6B,EAC7B,UAAkB;IAElB,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAA2B;IAE3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,UAAU,IAAI,MAA8B,EAAE,CAAC;QACxD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,kBAAgD;IAEhD,OAAO;QACL,aAAa,CAAC,EAAE,KAAK,EAAE;YACrB,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACjE,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,kBAAkB,CAAC,UAAU,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/tool-denial-anchors.d.ts

@@ -0,0 +1,58 @@
+import type { AgentSubscriber } from "@ag-ui/client";
+/**
+ * The ledger's two halves: the ask map (interrupt id → the tool call an
+ * approval_requested named) and the denied set (tool call ids whose ask
+ * was answered approved:false). Only `denied` is presentation — the
+ * snapshot exposes it alone as `toolDenialAnchors`; `asks` exists so the
+ * fold can join a later resolution.
+ */
+export interface ToolDenialLedger {
+    asks: ReadonlyMap<string, string>;
+    denied: ReadonlySet<string>;
+}
+export declare const EMPTY_TOOL_DENIAL_LEDGER: ToolDenialLedger;
+/** The presentation half's empty value — what the projection reads when
+ *  a snapshot carries no ledger at all. */
+export declare const EMPTY_TOOL_DENIAL_ANCHORS: ReadonlySet<string>;
+/** A narrowed marker the ledger folds: an ask, or a denial. */
+export type ToolDenialMarker = {
+    kind: "ask";
+    interruptId: string;
+    toolCallId: string;
+} | {
+    kind: "denied";
+    interruptId: string;
+};
+/**
+ * Narrow a CUSTOM event to the marker the ledger folds, or null: an
+ * approval_requested carrying both a non-empty interrupt_id and a
+ * non-empty tool_call_id (an unanchored ask — a wire that named no call
+ * — marks nothing: there is no row to reclassify), or an
+ * approval_resolved whose `approved` is false. An approval is not a
+ * marker here (the call then runs, and its own result tells its story).
+ * Anything malformed is ignored — the contract's "clients MUST ignore
+ * events and fields they do not recognize".
+ */
+export declare function toolDenialMarkerOf(name: string, value: unknown): ToolDenialMarker | null;
+/**
+ * The idempotent fold: every connection replays the stream from its
+ * boundary (and StrictMode aborts and reruns the first connection), so
+ * the same marker can arrive more than once per mount. A repeat — an
+ * ask already held, a denial already recorded — returns the ledger
+ * unchanged, and so does a denial whose interrupt no held ask names
+ * (premise 2). Otherwise the changed half is rebuilt and the untouched
+ * half keeps its identity: `denied`'s identity is the publish gate, so
+ * an ask alone never repaints the transcript.
+ */
+export declare function withToolDenialMarkerFolded(ledger: ToolDenialLedger, marker: ToolDenialMarker): ToolDenialLedger;
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * non-string members are dropped rather than rendered (or crashed on) —
+ * a dropped anchor reappears on the next full replay.
+ */
+export declare function wellFormedToolDenialAnchorsOf(stored: ReadonlySet<string>): ReadonlySet<string>;
+/** Records the two approval markers, narrowed — CUSTOM events only; this
+ *  recorder never reads a tool result (the cancelled stamp it
+ *  reclassifies rides tool-cancel-anchors.ts, one rung below). */
+export declare function toolDenialRecorder(onMarker: (marker: ToolDenialMarker) => void): AgentSubscriber;
+//# sourceMappingURL=tool-denial-anchors.d.ts.map

package/dist/core/tool-denial-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-denial-anchors.d.ts","sourceRoot":"","sources":["../../src/core/tool-denial-anchors.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQrD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,eAAO,MAAM,wBAAwB,EAAE,gBAGtC,CAAC;AAEF;2CAC2C;AAC3C,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CACzB,CAAC;AAElC,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,IAAI,CA0BzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,gBAAgB,CAgBlB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAC1B,WAAW,CAAC,MAAM,CAAC,CAQrB;AAED;;kEAEkE;AAClE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC3C,eAAe,CASjB"}

package/dist/core/tool-denial-anchors.js

@@ -0,0 +1,104 @@
+// The tool-denial ledger: the durable record that a member
+// DECLINED the approval a call was paused for, keyed by tool_call_id. The
+// wire stamps a denial `cancelled`, so the state is a client-side JOIN of
+// the approval_requested and approval_resolved markers that reclassifies
+// that stamp. The ordering premises: docs/decision-anchors.md.
+import { APPROVAL_REQUESTED_EVENT_NAME, APPROVAL_RESOLVED_EVENT_NAME, } from "../contract/events.js";
+import { approvalResolvedPayloadOf } from "./approval-resolved.js";
+export const EMPTY_TOOL_DENIAL_LEDGER = {
+    asks: new Map(),
+    denied: new Set(),
+};
+/** The presentation half's empty value — what the projection reads when
+ *  a snapshot carries no ledger at all. */
+export const EMPTY_TOOL_DENIAL_ANCHORS = EMPTY_TOOL_DENIAL_LEDGER.denied;
+/**
+ * Narrow a CUSTOM event to the marker the ledger folds, or null: an
+ * approval_requested carrying both a non-empty interrupt_id and a
+ * non-empty tool_call_id (an unanchored ask — a wire that named no call
+ * — marks nothing: there is no row to reclassify), or an
+ * approval_resolved whose `approved` is false. An approval is not a
+ * marker here (the call then runs, and its own result tells its story).
+ * Anything malformed is ignored — the contract's "clients MUST ignore
+ * events and fields they do not recognize".
+ */
+export function toolDenialMarkerOf(name, value) {
+    if (name === APPROVAL_REQUESTED_EVENT_NAME) {
+        if (typeof value !== "object" || value === null) {
+            return null;
+        }
+        const record = value;
+        const interruptId = record.interrupt_id;
+        const toolCallId = record.tool_call_id;
+        if (typeof interruptId !== "string" ||
+            interruptId === "" ||
+            typeof toolCallId !== "string" ||
+            toolCallId === "") {
+            return null;
+        }
+        return { kind: "ask", interruptId, toolCallId };
+    }
+    if (name === APPROVAL_RESOLVED_EVENT_NAME) {
+        const resolved = approvalResolvedPayloadOf(value);
+        if (resolved === null || resolved.approved) {
+            return null;
+        }
+        return { kind: "denied", interruptId: resolved.interruptId };
+    }
+    return null;
+}
+/**
+ * The idempotent fold: every connection replays the stream from its
+ * boundary (and StrictMode aborts and reruns the first connection), so
+ * the same marker can arrive more than once per mount. A repeat — an
+ * ask already held, a denial already recorded — returns the ledger
+ * unchanged, and so does a denial whose interrupt no held ask names
+ * (premise 2). Otherwise the changed half is rebuilt and the untouched
+ * half keeps its identity: `denied`'s identity is the publish gate, so
+ * an ask alone never repaints the transcript.
+ */
+export function withToolDenialMarkerFolded(ledger, marker) {
+    if (marker.kind === "ask") {
+        if (ledger.asks.has(marker.interruptId)) {
+            return ledger;
+        }
+        const asks = new Map(ledger.asks);
+        asks.set(marker.interruptId, marker.toolCallId);
+        return { asks, denied: ledger.denied };
+    }
+    const toolCallId = ledger.asks.get(marker.interruptId);
+    if (toolCallId === undefined || ledger.denied.has(toolCallId)) {
+        return ledger;
+    }
+    const denied = new Set(ledger.denied);
+    denied.add(toolCallId);
+    return { asks: ledger.asks, denied };
+}
+/**
+ * A defensive copy for seeding transcript state from the resume store:
+ * non-string members are dropped rather than rendered (or crashed on) —
+ * a dropped anchor reappears on the next full replay.
+ */
+export function wellFormedToolDenialAnchorsOf(stored) {
+    const seeded = new Set();
+    for (const toolCallId of stored) {
+        if (typeof toolCallId === "string") {
+            seeded.add(toolCallId);
+        }
+    }
+    return seeded;
+}
+/** Records the two approval markers, narrowed — CUSTOM events only; this
+ *  recorder never reads a tool result (the cancelled stamp it
+ *  reclassifies rides tool-cancel-anchors.ts, one rung below). */
+export function toolDenialRecorder(onMarker) {
+    return {
+        onCustomEvent({ event }) {
+            const marker = toolDenialMarkerOf(event.name, event.value);
+            if (marker !== null) {
+                onMarker(marker);
+            }
+        },
+    };
+}
+//# sourceMappingURL=tool-denial-anchors.js.map

package/dist/core/tool-denial-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-denial-anchors.js","sourceRoot":"","sources":["../../src/core/tool-denial-anchors.ts"],"names":[],"mappings":"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"}

package/dist/core/tool-error-anchors.d.ts

@@ -0,0 +1,6 @@
+export declare const EMPTY_TOOL_ERROR_ANCHORS: ReadonlyMap<string, string>;
+export declare const toolCallErrorOf: (event: unknown) => string | null;
+export declare const withToolErrorAnchored: (previous: ReadonlyMap<string, string>, toolCallId: string, sentence: string) => ReadonlyMap<string, string>;
+export declare const wellFormedToolErrorAnchorsOf: (stored: ReadonlyMap<string, string>) => ReadonlyMap<string, string>;
+export declare const toolErrorRecorder: (onAnchored: (toolCallId: string, sentence: string) => void) => import("@ag-ui/client").AgentSubscriber;
+//# sourceMappingURL=tool-error-anchors.d.ts.map

package/dist/core/tool-error-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error-anchors.d.ts","sourceRoot":"","sources":["../../src/core/tool-error-anchors.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,wBAAwB,6BAAgB,CAAC;AACtD,eAAO,MAAM,eAAe,mCAAqB,CAAC;AAClD,eAAO,MAAM,qBAAqB,8GAAuB,CAAC;AAC1D,eAAO,MAAM,4BAA4B,sEAAuB,CAAC;AACjE,eAAO,MAAM,iBAAiB,yGAAqB,CAAC"}

package/dist/core/tool-error-anchors.js

@@ -0,0 +1,15 @@
+// The tool-error anchor map: an errored TOOL_CALL_RESULT's `error` extra
+// is the envelope's error.message or the tool's own error text, so the
+// transcript reads this map to light the call's output-error state and
+// pane. One binding of the shared sentence family — see
+// tool-sentence-anchors.ts for the model and the strip-and-lift
+// rationale. The empty string still counts here: presence is the failure
+// signal, and the pane text falls back to the result.
+import { toolSentenceAnchorsOf } from "./tool-sentence-anchors.js";
+const anchors = toolSentenceAnchorsOf("error", { acceptEmpty: true });
+export const EMPTY_TOOL_ERROR_ANCHORS = anchors.empty;
+export const toolCallErrorOf = anchors.sentenceOf;
+export const withToolErrorAnchored = anchors.withAnchored;
+export const wellFormedToolErrorAnchorsOf = anchors.wellFormedOf;
+export const toolErrorRecorder = anchors.recorderOf;
+//# sourceMappingURL=tool-error-anchors.js.map

package/dist/core/tool-error-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error-anchors.js","sourceRoot":"","sources":["../../src/core/tool-error-anchors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,uEAAuE;AACvE,uEAAuE;AACvE,wDAAwD;AACxD,gEAAgE;AAChE,yEAAyE;AACzE,sDAAsD;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC,KAAK,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;AAC1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC,YAAY,CAAC;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC"}

package/dist/core/tool-flag-anchors.d.ts

@@ -0,0 +1,21 @@
+import type { AgentSubscriber } from "@ag-ui/client";
+export interface ToolFlagAnchors {
+    empty: ReadonlySet<string>;
+    /** Narrow the event's lifted flag field (untyped by contract). Anything
+     *  but the literal true is ignored — the contract's "clients MUST ignore
+     *  events and fields they do not recognize". */
+    flagOf: (event: unknown) => boolean;
+    /** Idempotent anchor merge: replays (and StrictMode's rerun) can deliver
+     *  the same flagged result more than once per mount; a repeat returns the
+     *  set unchanged — identity is the publish gate. */
+    withAnchored: (previous: ReadonlySet<string>, toolCallId: string) => ReadonlySet<string>;
+    /** A defensive copy for seeding transcript state from the resume
+     *  store: entries that are not strings are dropped rather than
+     *  rendered (or crashed on) — a dropped anchor reappears on the next
+     *  full replay. */
+    wellFormedOf: (stored: ReadonlySet<string>) => ReadonlySet<string>;
+    /** Records each flagged tool result's toolCallId. */
+    recorderOf: (onAnchored: (toolCallId: string) => void) => AgentSubscriber;
+}
+export declare function toolFlagAnchorsOf(field: "cancelled" | "offloaded" | "truncated"): ToolFlagAnchors;
+//# sourceMappingURL=tool-flag-anchors.d.ts.map

package/dist/core/tool-flag-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-flag-anchors.d.ts","sourceRoot":"","sources":["../../src/core/tool-flag-anchors.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B;;oDAEgD;IAChD,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACpC;;wDAEoD;IACpD,YAAY,EAAE,CACZ,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,UAAU,EAAE,MAAM,KACf,WAAW,CAAC,MAAM,CAAC,CAAC;IACzB;;;uBAGmB;IACnB,YAAY,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC,CAAC;IACnE,qDAAqD;IACrD,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,KAAK,eAAe,CAAC;CAC3E;AAED,wBAAgB,iBAAiB,CAK/B,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,GAC7C,eAAe,CAqCjB"}

package/dist/core/tool-flag-anchors.js

@@ -0,0 +1,52 @@
+// The boolean tool-flag anchor family, pure of React: one factory behind
+// tool-cancel-anchors and tool-offload-anchors (any later boolean extra
+// too). Each instance maps a TOOL_CALL_RESULT extra that is `true`-or-absent
+// to the toolCallIds carrying it. @ag-ui/client 1.0 strips unknown top-level
+// fields before any subscriber, so the transport lifts the extras into
+// metadata (core/tool-outcome.ts) and the set is the flag's only home on
+// the client.
+import { toolOutcomeOf } from "./tool-outcome.js";
+export function toolFlagAnchorsOf(
+// The closed set of boolean TOOL_CALL_RESULT extras (the contract's
+// fourth, `error`, carries a sentence, not a flag): a typo here would
+// compile into an anchor set that silently never matches — the flag's
+// rendering just stops — so the type refuses anything off the wire.
+field) {
+    function flagOf(event) {
+        return toolOutcomeOf(event)[field] === true;
+    }
+    return {
+        empty: new Set(),
+        flagOf,
+        withAnchored: (previous, toolCallId) => {
+            if (previous.has(toolCallId)) {
+                return previous;
+            }
+            const next = new Set(previous);
+            next.add(toolCallId);
+            return next;
+        },
+        wellFormedOf: (stored) => {
+            const seeded = new Set();
+            // The narrowing deliberately distrusts the set's own types: this
+            // seam turns a stale shape into a missing anchor, never a crash.
+            const entries = stored;
+            for (const toolCallId of entries) {
+                if (typeof toolCallId === "string") {
+                    seeded.add(toolCallId);
+                }
+            }
+            return seeded;
+        },
+        recorderOf: (onAnchored) => {
+            return {
+                onToolCallResultEvent({ event }) {
+                    if (flagOf(event)) {
+                        onAnchored(event.toolCallId);
+                    }
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=tool-flag-anchors.js.map

package/dist/core/tool-flag-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-flag-anchors.js","sourceRoot":"","sources":["../../src/core/tool-flag-anchors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,6EAA6E;AAC7E,6EAA6E;AAC7E,uEAAuE;AACvE,yEAAyE;AACzE,cAAc;AAId,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAwBlD,MAAM,UAAU,iBAAiB;AAC/B,oEAAoE;AACpE,sEAAsE;AACtE,sEAAsE;AACtE,oEAAoE;AACpE,KAA8C;IAE9C,SAAS,MAAM,CAAC,KAAc;QAC5B,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC9C,CAAC;IACD,OAAO;QACL,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,MAAM;QACN,YAAY,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE;YACrC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;YACjC,iEAAiE;YACjE,iEAAiE;YACjE,MAAM,OAAO,GAAG,MAA8B,CAAC;YAC/C,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;gBACjC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE;YACzB,OAAO;gBACL,qBAAqB,CAAC,EAAE,KAAK,EAAE;oBAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;wBAClB,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/tool-offload-anchors.d.ts

@@ -0,0 +1,6 @@
+export declare const EMPTY_TOOL_OFFLOAD_ANCHORS: ReadonlySet<string>;
+export declare const toolCallOffloadedOf: (event: unknown) => boolean;
+export declare const withToolOffloadAnchored: (previous: ReadonlySet<string>, toolCallId: string) => ReadonlySet<string>;
+export declare const wellFormedToolOffloadAnchorsOf: (stored: ReadonlySet<string>) => ReadonlySet<string>;
+export declare const toolOffloadRecorder: (onAnchored: (toolCallId: string) => void) => import("@ag-ui/client").AgentSubscriber;
+//# sourceMappingURL=tool-offload-anchors.d.ts.map

package/dist/core/tool-offload-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-offload-anchors.d.ts","sourceRoot":"","sources":["../../src/core/tool-offload-anchors.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,0BAA0B,qBAAgB,CAAC;AACxD,eAAO,MAAM,mBAAmB,6BAAiB,CAAC;AAClD,eAAO,MAAM,uBAAuB,4EAAuB,CAAC;AAC5D,eAAO,MAAM,8BAA8B,sDAAuB,CAAC;AACnE,eAAO,MAAM,mBAAmB,uFAAqB,CAAC"}

package/dist/core/tool-offload-anchors.js

@@ -0,0 +1,14 @@
+// The tool-offload anchor set: an offloaded TOOL_CALL_RESULT's content is
+// the context offloader's model-facing replacement (retrieval guidance,
+// stored-reference lines), not the tool's output, so the transcript reads
+// this set to render the quiet shortened-result line instead. One binding
+// of the shared boolean-flag family — see tool-flag-anchors.ts for the
+// model and the strip-and-lift rationale.
+import { toolFlagAnchorsOf } from "./tool-flag-anchors.js";
+const anchors = toolFlagAnchorsOf("offloaded");
+export const EMPTY_TOOL_OFFLOAD_ANCHORS = anchors.empty;
+export const toolCallOffloadedOf = anchors.flagOf;
+export const withToolOffloadAnchored = anchors.withAnchored;
+export const wellFormedToolOffloadAnchorsOf = anchors.wellFormedOf;
+export const toolOffloadRecorder = anchors.recorderOf;
+//# sourceMappingURL=tool-offload-anchors.js.map

package/dist/core/tool-offload-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-offload-anchors.js","sourceRoot":"","sources":["../../src/core/tool-offload-anchors.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,0CAA0C;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC,KAAK,CAAC;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;AAClD,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;AAC5D,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC,YAAY,CAAC;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC"}

package/dist/core/tool-outcome.d.ts

@@ -0,0 +1,24 @@
+import type { BaseEvent } from "@ag-ui/core";
+import { type Observable } from "rxjs";
+declare const TOOL_OUTCOME_FIELDS: readonly ["error", "refused", "cancelled", "truncated", "offloaded"];
+type ToolOutcomeField = (typeof TOOL_OUTCOME_FIELDS)[number];
+/** The lifted extras, values as the wire sent them: each reader keeps its
+ *  own literal check (the sentence families want a string, the flag
+ *  families want the literal true). */
+export type ToolOutcome = Partial<Record<ToolOutcomeField, unknown>>;
+/** A TOOL_CALL_RESULT with its extras moved under
+ *  `metadata.teaflask.toolOutcome`; any other event, a result carrying
+ *  none, or one whose metadata is present and not an object comes back as
+ *  the same reference. */
+export declare function withToolOutcomeLifted(event: BaseEvent): BaseEvent;
+/** The lifted extras of an event — empty for anything that carries none,
+ *  a non-object, or extras left on the top level (enforcement would have
+ *  dropped those; reading them here would report a state the pipeline
+ *  never delivers). */
+export declare function toolOutcomeOf(event: unknown): ToolOutcome;
+/** The transport seam: pipe a run's events through the lift before the
+ *  client enforces its schema. A plain function over the Observable so a
+ *  host agent needs no rxjs import of its own. */
+export declare function liftToolOutcome(events$: Observable<BaseEvent>): Observable<BaseEvent>;
+export {};
+//# sourceMappingURL=tool-outcome.d.ts.map

package/dist/core/tool-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-outcome.d.ts","sourceRoot":"","sources":["../../src/core/tool-outcome.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAE5C,QAAA,MAAM,mBAAmB,sEAMf,CAAC;AAEX,KAAK,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;uCAEuC;AACvC,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;AAWrE;;;0BAG0B;AAC1B,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CA0CjE;AAED;;;uBAGuB;AACvB,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAiBzD;AAED;;kDAEkD;AAClD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,GAC7B,UAAU,CAAC,SAAS,CAAC,CAEvB"}

package/dist/core/tool-outcome.js

@@ -0,0 +1,98 @@
+// The tool-outcome lift: @ag-ui/client 1.0 enforces its event schema
+// between the transport and every subscriber, stripping any top-level field
+// the schema does not know — which is where the serving wire carries a
+// TOOL_CALL_RESULT's five optional extras. Event metadata is open by key
+// and survives enforcement, so the transport moves the extras under
+// teaflask's namespace before the client sees them, and every reader asks
+// the namespace, never the top level. The wire itself is unchanged.
+import { EventType } from "@ag-ui/core";
+import { map } from "rxjs";
+const TOOL_OUTCOME_FIELDS = [
+    "error",
+    "refused",
+    "cancelled",
+    "truncated",
+    "offloaded",
+];
+const NAMESPACE = "teaflask";
+const OUTCOME_KEY = "toolOutcome";
+function _record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+/** A TOOL_CALL_RESULT with its extras moved under
+ *  `metadata.teaflask.toolOutcome`; any other event, a result carrying
+ *  none, or one whose metadata is present and not an object comes back as
+ *  the same reference. */
+export function withToolOutcomeLifted(event) {
+    if (event.type !== EventType.TOOL_CALL_RESULT) {
+        return event;
+    }
+    const source = event;
+    const lifted = {};
+    for (const field of TOOL_OUTCOME_FIELDS) {
+        if (Object.prototype.hasOwnProperty.call(source, field)) {
+            lifted[field] = source[field];
+        }
+    }
+    if (Object.keys(lifted).length === 0) {
+        return event;
+    }
+    const rest = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (!TOOL_OUTCOME_FIELDS.includes(key)) {
+            rest[key] = value;
+        }
+    }
+    // Metadata the protocol would reject — present and not an object — is
+    // left exactly as sent: the client's validator, not the lift, decides
+    // what becomes of it. Inside a valid object the teaflask namespace is
+    // this package's own: a value there that is not an object was never
+    // written by this package and never read by anything, and the wire's
+    // extras must survive, so the lift takes the namespace over rather than
+    // letting the extras be stripped in silence.
+    const metadata = source.metadata === undefined ? {} : _record(source.metadata);
+    if (metadata === null) {
+        return event;
+    }
+    const namespace = _record(metadata[NAMESPACE]) ?? {};
+    const outcome = _record(namespace[OUTCOME_KEY]) ?? {};
+    rest.metadata = {
+        ...metadata,
+        [NAMESPACE]: {
+            ...namespace,
+            [OUTCOME_KEY]: { ...outcome, ...lifted },
+        },
+    };
+    return rest;
+}
+/** The lifted extras of an event — empty for anything that carries none,
+ *  a non-object, or extras left on the top level (enforcement would have
+ *  dropped those; reading them here would report a state the pipeline
+ *  never delivers). */
+export function toolOutcomeOf(event) {
+    const source = _record(event);
+    if (source === null) {
+        return {};
+    }
+    const namespace = _record(_record(source.metadata)?.[NAMESPACE]);
+    const outcome = _record(namespace?.[OUTCOME_KEY]);
+    if (outcome === null) {
+        return {};
+    }
+    const result = {};
+    for (const field of TOOL_OUTCOME_FIELDS) {
+        if (Object.prototype.hasOwnProperty.call(outcome, field)) {
+            result[field] = outcome[field];
+        }
+    }
+    return result;
+}
+/** The transport seam: pipe a run's events through the lift before the
+ *  client enforces its schema. A plain function over the Observable so a
+ *  host agent needs no rxjs import of its own. */
+export function liftToolOutcome(events$) {
+    return events$.pipe(map(withToolOutcomeLifted));
+}
+//# sourceMappingURL=tool-outcome.js.map

package/dist/core/tool-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-outcome.js","sourceRoot":"","sources":["../../src/core/tool-outcome.ts"],"names":[],"mappings":"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"}