@tetherto/mdk-ui-agent 0.0.0 → 0.12.1

package/dist/core/error-text.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Operator-readable text for the failures a turn can end on.
+ *
+ * `reduceTurn` stores whatever the `error` event carried, which is a bare code
+ * like `ERR_AGENT_STREAM_TRUNCATED` — useful in a bug report, meaningless in a
+ * transcript. The raw code stays on the message; this is applied at render time,
+ * so the stored history keeps the diagnosable value.
+ */
+/** Shown when a turn dies before the gateway said anything useful. */
+export declare const GENERIC_TURN_ERROR = "The agent could not complete that request.";
+/**
+ * Maps a code to a sentence, passing anything that is not one through unchanged.
+ *
+ * The producer's codes are all `ERR_*`, so a value in that shape that is not in
+ * the table is a code this release has never seen — it becomes the generic
+ * sentence rather than being shown verbatim. Anything else is already prose.
+ */
+export declare function describeAgentError(error: string | null | undefined): string | null;
+//# sourceMappingURL=error-text.d.ts.map

package/dist/core/error-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-text.d.ts","sourceRoot":"","sources":["../../src/core/error-text.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,+CAA+C,CAAA;AAW9E;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIlF"}

package/dist/core/error-text.js

@@ -0,0 +1,35 @@
+/**
+ * Operator-readable text for the failures a turn can end on.
+ *
+ * `reduceTurn` stores whatever the `error` event carried, which is a bare code
+ * like `ERR_AGENT_STREAM_TRUNCATED` — useful in a bug report, meaningless in a
+ * transcript. The raw code stays on the message; this is applied at render time,
+ * so the stored history keeps the diagnosable value.
+ */
+import { ERR_STREAM_IDLE, ERR_STREAM_TRUNCATED } from './sse';
+import { AGENT_ERROR } from './transport';
+/** Shown when a turn dies before the gateway said anything useful. */
+export const GENERIC_TURN_ERROR = 'The agent could not complete that request.';
+const TEXT_FOR_CODE = {
+    [AGENT_ERROR.UNAVAILABLE]: 'The agent is not configured on this gateway.',
+    [AGENT_ERROR.TURN_ACTIVE]: 'A turn is already running in this conversation.',
+    [AGENT_ERROR.TEXT_REQUIRED]: 'Type a message first.',
+    [AGENT_ERROR.SESSION_NOT_FOUND]: 'That conversation is no longer open on the gateway.',
+    [ERR_STREAM_TRUNCATED]: 'The connection to the agent ended before the answer finished.',
+    [ERR_STREAM_IDLE]: 'The agent stopped responding, so the connection was assumed lost.',
+};
+/**
+ * Maps a code to a sentence, passing anything that is not one through unchanged.
+ *
+ * The producer's codes are all `ERR_*`, so a value in that shape that is not in
+ * the table is a code this release has never seen — it becomes the generic
+ * sentence rather than being shown verbatim. Anything else is already prose.
+ */
+export function describeAgentError(error) {
+    if (!error)
+        return null;
+    if (TEXT_FOR_CODE[error])
+        return TEXT_FOR_CODE[error];
+    return error.startsWith('ERR_') ? GENERIC_TURN_ERROR : error;
+}
+//# sourceMappingURL=error-text.js.map

package/dist/core/error-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-text.js","sourceRoot":"","sources":["../../src/core/error-text.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,4CAA4C,CAAA;AAE9E,MAAM,aAAa,GAA2B;IAC5C,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,8CAA8C;IACzE,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,iDAAiD;IAC5E,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,uBAAuB;IACpD,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,qDAAqD;IACtF,CAAC,oBAAoB,CAAC,EAAE,+DAA+D;IACvF,CAAC,eAAe,CAAC,EAAE,mEAAmE;CACvF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IACjE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;IACrD,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAA;AAC9D,CAAC"}

package/dist/core/events.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The agent event contract, redeclared for the browser.
+ *
+ * The producer of record is `backend/core/agent/src/events.js`. That module is
+ * Node-only ESM inside a private package with no `exports` map, and importing it
+ * would pull the model provider and the MCP client into the bundle — so the six
+ * events are restated here instead. `src/core/events.contract.test.ts` reads the
+ * backend file and fails if the two ever drift.
+ */
+/** Bump only alongside the producer's `CONTRACT_VERSION`. */
+export declare const AGENT_CONTRACT_VERSION = "v1";
+/** Reference these constants, never the raw strings, so a typo is a type error. */
+export declare const EVENT: {
+    readonly TOKEN: 'token';
+    readonly TOOL_CALL: 'tool_call';
+    readonly TOOL_RESULT: 'tool_result';
+    readonly PENDING_APPROVAL: 'pending_approval';
+    readonly ERROR: 'error';
+    readonly DONE: 'done';
+};
+export type EventType = (typeof EVENT)[keyof typeof EVENT];
+/** `done` and `error` only. Exactly one of them ends a turn, and it is always last. */
+export declare const TERMINAL_EVENTS: readonly ["done", "error"];
+export type TerminalEventType = (typeof TERMINAL_EVENTS)[number];
+export type ToolArgs = Record<string, unknown>;
+/** A chunk of the answer, to append to the open bubble. */
+export type TokenEvent = {
+    type: typeof EVENT.TOKEN;
+    text: string;
+};
+/** The model chose a tool. Always followed by a `tool_result` with the same `name`. */
+export type ToolCallEvent = {
+    type: typeof EVENT.TOOL_CALL;
+    name: string;
+    args: ToolArgs;
+};
+/**
+ * The tool answered. `isError` means the call itself failed; `contractViolation`
+ * — which the producer only ever emits together with `isError` — means the tool
+ * answered but the answer broke its verb's contract.
+ */
+export type ToolResultEvent = {
+    type: typeof EVENT.TOOL_RESULT;
+    name: string;
+    text: string;
+    isError?: boolean;
+    contractViolation?: string;
+    /**
+     * How long the operator held the turn at the approval prompt, on a gated call only.
+     * Subtract it before showing a duration: the gap between a `tool_call` and its
+     * `tool_result` spans the wait, so a card left open for a minute reads as a minute
+     * of tool.
+     */
+    approvalWaitMs?: number;
+};
+/** A write tool is waiting on the operator. The stream PAUSES here. */
+export type PendingApprovalEvent = {
+    type: typeof EVENT.PENDING_APPROVAL;
+    name: string;
+    args: ToolArgs;
+};
+/** Terminal. Distinct from a decline, which is tokens + `done` with no `tool_call`. */
+export type ErrorEvent = {
+    type: typeof EVENT.ERROR;
+    error: string;
+};
+/** Terminal. */
+export type DoneEvent = {
+    type: typeof EVENT.DONE;
+    text?: string;
+    usage?: Record<string, unknown>;
+};
+export type AgentEvent = TokenEvent | ToolCallEvent | ToolResultEvent | PendingApprovalEvent | ErrorEvent | DoneEvent;
+/**
+ * What actually arrives on the wire: the event's own fields with the gateway's
+ * envelope spread onto the same flat object, not nested under a key.
+ */
+export type WireEvent = AgentEvent & {
+    /** Correlates every event of one turn. */
+    turnId: string;
+    /** Monotonic per turn — ordering and dedup. */
+    seq: number;
+    /** Stamped by the gateway on every event, despite being optional in the docs. */
+    ts: number;
+    /** Present ONLY on `pending_approval`. Echo it back to decide. */
+    approvalId?: string;
+};
+export declare function isTerminal(event: Pick<AgentEvent, 'type'>): boolean;
+/**
+ * Structural check only — enough to decide whether we know how to render it.
+ *
+ * Contract invariant 5: unknown event types MUST be ignored, not thrown on. That
+ * is what lets the producer add event types without a breaking release, so this
+ * returns false rather than raising.
+ */
+export declare function isAgentEvent(value: unknown): value is AgentEvent;
+export declare function isWireEvent(value: unknown): value is WireEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/core/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,mFAAmF;AACnF,eAAO,MAAM,KAAK;aAChB,KAAK,EAAE,OAAO;aACd,SAAS,EAAE,WAAW;aACtB,WAAW,EAAE,aAAa;aAC1B,gBAAgB,EAAE,kBAAkB;aACpC,KAAK,EAAE,OAAO;aACd,IAAI,EAAE,MAAM;CACJ,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAA;AAE1D,uFAAuF;AACvF,eAAO,MAAM,eAAe,4BAAqC,CAAA;AAEjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE9C,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnE,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,KAAK,CAAC,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAE1F;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,KAAK,CAAC,WAAW,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,OAAO,KAAK,CAAC,gBAAgB,CAAA;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;CACf,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpE,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,aAAa,GACb,eAAe,GACf,oBAAoB,GACpB,UAAU,GACV,SAAS,CAAA;AAEb;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG;IACnC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAA;IACV,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,OAAO,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAMhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAI9D"}

package/dist/core/events.js

@@ -0,0 +1,50 @@
+/**
+ * The agent event contract, redeclared for the browser.
+ *
+ * The producer of record is `backend/core/agent/src/events.js`. That module is
+ * Node-only ESM inside a private package with no `exports` map, and importing it
+ * would pull the model provider and the MCP client into the bundle — so the six
+ * events are restated here instead. `src/core/events.contract.test.ts` reads the
+ * backend file and fails if the two ever drift.
+ */
+import isPlainObject from 'lodash/isPlainObject';
+/** Bump only alongside the producer's `CONTRACT_VERSION`. */
+export const AGENT_CONTRACT_VERSION = 'v1';
+/** Reference these constants, never the raw strings, so a typo is a type error. */
+export const EVENT = {
+    TOKEN: 'token',
+    TOOL_CALL: 'tool_call',
+    TOOL_RESULT: 'tool_result',
+    PENDING_APPROVAL: 'pending_approval',
+    ERROR: 'error',
+    DONE: 'done',
+};
+/** `done` and `error` only. Exactly one of them ends a turn, and it is always last. */
+export const TERMINAL_EVENTS = [EVENT.DONE, EVENT.ERROR];
+const EVENT_TYPES = new Set(Object.values(EVENT));
+const TERMINAL_TYPES = new Set(TERMINAL_EVENTS);
+export function isTerminal(event) {
+    return TERMINAL_TYPES.has(event.type);
+}
+/**
+ * Structural check only — enough to decide whether we know how to render it.
+ *
+ * Contract invariant 5: unknown event types MUST be ignored, not thrown on. That
+ * is what lets the producer add event types without a breaking release, so this
+ * returns false rather than raising.
+ */
+export function isAgentEvent(value) {
+    // Every event arrives from `JSON.parse`, so a plain object is exactly the shape
+    // to accept — anything else on the wire is malformed by definition.
+    if (!isPlainObject(value))
+        return false;
+    const type = value.type;
+    return typeof type === 'string' && EVENT_TYPES.has(type);
+}
+export function isWireEvent(value) {
+    if (!isAgentEvent(value))
+        return false;
+    const { turnId, seq } = value;
+    return typeof turnId === 'string' && typeof seq === 'number';
+}
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,aAAa,MAAM,sBAAsB,CAAA;AAEhD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAA;AAE1C,mFAAmF;AACnF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAA;AAIV,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAU,CAAA;AAwEjE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACzD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,eAAe,CAAC,CAAA;AAEvD,MAAM,UAAU,UAAU,CAAC,KAA+B;IACxD,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,gFAAgF;IAChF,oEAAoE;IACpE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACvC,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAA;IAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAA2B,CAAA;IACnD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAA;AAC9D,CAAC"}

package/dist/core/format.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Formatting for the conversation list.
+ *
+ * Deliberately local-time, not the fleet timezone from `timezoneStore`: these
+ * are records of when the operator had a conversation in this browser, not
+ * telemetry timestamps.
+ */
+/** `Today` / `Yesterday` / `Jul 28`. */
+export declare function formatDay(at: number, now?: number): string;
+/** `14:32`, 24-hour so it lines up in a monospace column. */
+export declare function formatClock(at: number): string;
+export declare function formatMessageCount(count: number): string;
+/**
+ * `4 conversations · 1 running` — the header line for the conversations view.
+ *
+ * "Running" counts only what this client is streaming: the gateway holds
+ * sessions in memory per process and exposes no way to list them, so a turn
+ * started in another tab is invisible here.
+ */
+export declare function formatConversationSummary(count: number, running: boolean): string;
+/** `Today · 14:32 · 6 messages` */
+export declare function formatConversationMeta(updatedAt: number, messageCount: number, now?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/core/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/core/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAKtE;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAGjF;AAED,mCAAmC;AACnC,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAIR"}

package/dist/core/format.js

@@ -0,0 +1,49 @@
+/**
+ * Formatting for the conversation list.
+ *
+ * Deliberately local-time, not the fleet timezone from `timezoneStore`: these
+ * are records of when the operator had a conversation in this browser, not
+ * telemetry timestamps.
+ */
+const DAY_MS = 86_400_000;
+function startOfDay(at) {
+    const date = new Date(at);
+    date.setHours(0, 0, 0, 0);
+    return date.getTime();
+}
+/** `Today` / `Yesterday` / `Jul 28`. */
+export function formatDay(at, now = Date.now()) {
+    const days = Math.round((startOfDay(now) - startOfDay(at)) / DAY_MS);
+    if (days <= 0)
+        return 'Today';
+    if (days === 1)
+        return 'Yesterday';
+    return new Date(at).toLocaleDateString(undefined, { month: 'short', day: 'numeric' });
+}
+/** `14:32`, 24-hour so it lines up in a monospace column. */
+export function formatClock(at) {
+    return new Date(at).toLocaleTimeString(undefined, {
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    });
+}
+export function formatMessageCount(count) {
+    return count === 1 ? '1 message' : `${count} messages`;
+}
+/**
+ * `4 conversations · 1 running` — the header line for the conversations view.
+ *
+ * "Running" counts only what this client is streaming: the gateway holds
+ * sessions in memory per process and exposes no way to list them, so a turn
+ * started in another tab is invisible here.
+ */
+export function formatConversationSummary(count, running) {
+    const conversations = count === 1 ? '1 conversation' : `${count} conversations`;
+    return running ? `${conversations} · 1 running` : conversations;
+}
+/** `Today · 14:32 · 6 messages` */
+export function formatConversationMeta(updatedAt, messageCount, now) {
+    return [formatDay(updatedAt, now), formatClock(updatedAt), formatMessageCount(messageCount)].join(' · ');
+}
+//# sourceMappingURL=format.js.map

package/dist/core/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/core/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,GAAG,UAAU,CAAA;AAEzB,SAAS,UAAU,CAAC,EAAU;IAC5B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IACzB,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACzB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAA;AACvB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,GAAG,GAAW,IAAI,CAAC,GAAG,EAAE;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;IACpE,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IAC7B,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,WAAW,CAAA;IAClC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;AACvF,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE;QAChD,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACd,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAA;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa,EAAE,OAAgB;IACvE,MAAM,aAAa,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,gBAAgB,CAAA;IAC/E,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,cAAc,CAAC,CAAC,CAAC,aAAa,CAAA;AACjE,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,YAAoB,EACpB,GAAY;IAEZ,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAC/F,KAAK,CACN,CAAA;AACH,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The headless half of the package: contract types, SSE transport, the turn
+ * reducer and the conversation store. No React, no DOM.
+ *
+ * Exported as a subpath (`@tetherto/mdk-ui-agent/core`) so a consumer building
+ * its own chat surface can reuse the protocol work without the components.
+ */
+export type { ChatMessage, Conversation, ConversationActions, ConversationState, ConversationStorage, ConversationStore, ConversationStoreOptions, MessageRole, } from './conversation-store';
+export { CONVERSATION_STORAGE_KEY, conversationStore, createConversationStore, deriveTitle, MAX_CONVERSATIONS, MAX_MESSAGES_PER_CONVERSATION, MAX_PERSISTED_TOOL_TEXT_CHARS, mergeConversations, MESSAGE_ROLE, newConversation, } from './conversation-store';
+export { describeAgentError, GENERIC_TURN_ERROR } from './error-text';
+export type { AgentEvent, DoneEvent, ErrorEvent, EventType, PendingApprovalEvent, TerminalEventType, TokenEvent, ToolArgs, ToolCallEvent, ToolResultEvent, WireEvent, } from './events';
+export { AGENT_CONTRACT_VERSION, EVENT, isAgentEvent, isTerminal, isWireEvent, TERMINAL_EVENTS, } from './events';
+export { formatClock, formatConversationMeta, formatConversationSummary, formatDay, formatMessageCount, } from './format';
+export { clipToBoundary, unwrapWholeAnswerFence } from './markdown';
+export type { LeakedToolCall } from './prose';
+export { parseLeakedToolCall } from './prose';
+export { isSmallTalk } from './small-talk';
+export type { ReadAgentStreamOptions, ReadFramesOptions } from './sse';
+export { APPROVAL_IDLE_TIMEOUT_MS, ERR_STREAM_IDLE, ERR_STREAM_TRUNCATED, FIRST_EVENT_IDLE_TIMEOUT_MS, parseFrame, readAgentStream, readFrames, STREAM_IDLE_TIMEOUT_MS, StreamIdleError, } from './sse';
+export type { ToolLabels } from './tool-label';
+export { formatDuration, humanizeToolName, toolLabel } from './tool-label';
+export type { AgentErrorCode, AgentTransportOptions, StreamTurnOptions, TokenSource, } from './transport';
+export { AGENT_ERROR, AGENT_ROUTE_PREFIX, AgentApiError, createSession, decideApproval, deleteSession, streamTurn, } from './transport';
+export type { AgentTurnState, PendingApproval, ToolStatus, ToolStep, TurnStatus } from './turn';
+export { abortTurn, createTurnState, failTurn, isRejectionResult, isTurnSettled, reduceTurn, TOOL_STATUS, TURN_STATUS, } from './turn';
+export { uuid } from './uuid';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,WAAW,GACZ,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,EAClB,YAAY,EACZ,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAErE,YAAY,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,SAAS,GACV,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,sBAAsB,EACtB,KAAK,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,SAAS,EACT,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEnE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AACtE,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,eAAe,GAChB,MAAM,OAAO,CAAA;AAEd,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE1E,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC/F,OAAO,EACL,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,QAAQ,CAAA;AAEf,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,20 @@
+/**
+ * The headless half of the package: contract types, SSE transport, the turn
+ * reducer and the conversation store. No React, no DOM.
+ *
+ * Exported as a subpath (`@tetherto/mdk-ui-agent/core`) so a consumer building
+ * its own chat surface can reuse the protocol work without the components.
+ */
+export { CONVERSATION_STORAGE_KEY, conversationStore, createConversationStore, deriveTitle, MAX_CONVERSATIONS, MAX_MESSAGES_PER_CONVERSATION, MAX_PERSISTED_TOOL_TEXT_CHARS, mergeConversations, MESSAGE_ROLE, newConversation, } from './conversation-store';
+export { describeAgentError, GENERIC_TURN_ERROR } from './error-text';
+export { AGENT_CONTRACT_VERSION, EVENT, isAgentEvent, isTerminal, isWireEvent, TERMINAL_EVENTS, } from './events';
+export { formatClock, formatConversationMeta, formatConversationSummary, formatDay, formatMessageCount, } from './format';
+export { clipToBoundary, unwrapWholeAnswerFence } from './markdown';
+export { parseLeakedToolCall } from './prose';
+export { isSmallTalk } from './small-talk';
+export { APPROVAL_IDLE_TIMEOUT_MS, ERR_STREAM_IDLE, ERR_STREAM_TRUNCATED, FIRST_EVENT_IDLE_TIMEOUT_MS, parseFrame, readAgentStream, readFrames, STREAM_IDLE_TIMEOUT_MS, StreamIdleError, } from './sse';
+export { formatDuration, humanizeToolName, toolLabel } from './tool-label';
+export { AGENT_ERROR, AGENT_ROUTE_PREFIX, AgentApiError, createSession, decideApproval, deleteSession, streamTurn, } from './transport';
+export { abortTurn, createTurnState, failTurn, isRejectionResult, isTurnSettled, reduceTurn, TOOL_STATUS, TURN_STATUS, } from './turn';
+export { uuid } from './uuid';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,EAClB,YAAY,EACZ,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAerE,OAAO,EACL,sBAAsB,EACtB,KAAK,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,SAAS,EACT,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAInE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG1C,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,eAAe,GAChB,MAAM,OAAO,CAAA;AAGd,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAQ1E,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,QAAQ,CAAA;AAEf,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA"}

package/dist/core/markdown.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Two text repairs applied before an answer is rendered as markdown.
+ *
+ * Both exist because the model decides its own output format and nothing in the
+ * charter constrains it: the panel has to read whatever comes back.
+ */
+/**
+ * Unwraps an answer the model wrapped entirely in a ```markdown fence.
+ *
+ * A common quirk: asked for a formatted answer, the model returns the formatted
+ * answer inside a fence, and the panel renders the whole reply as one code block
+ * — table syntax, bullets and all. Only the whole-answer case is unwrapped, and
+ * only when the fence actually closes at the end: an ordinary code fence, an
+ * unclosed fence mid-stream, and a fence with prose after it are all left alone.
+ */
+export declare function unwrapWholeAnswerFence(text: string): string;
+/**
+ * Cuts `text` to roughly `max` characters, on the last paragraph or line break
+ * before the limit.
+ *
+ * Slicing markdown at an arbitrary character can split a fence or a table row and
+ * make the preview render as something the answer never said, so the cut lands on
+ * a block boundary where there is one within reach.
+ */
+export declare function clipToBoundary(text: string, max: number): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/core/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/core/markdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW3D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAShE"}

package/dist/core/markdown.js

@@ -0,0 +1,49 @@
+/**
+ * Two text repairs applied before an answer is rendered as markdown.
+ *
+ * Both exist because the model decides its own output format and nothing in the
+ * charter constrains it: the panel has to read whatever comes back.
+ */
+/** Opening fence of a whole-answer wrapper: ```markdown / ```md, nothing else on the line. */
+const MARKDOWN_FENCE_OPEN = /^`{3,}\s*(?:markdown|md)\s*$/i;
+/** Any closing fence line. */
+const FENCE_CLOSE = /^`{3,}\s*$/;
+/**
+ * Unwraps an answer the model wrapped entirely in a ```markdown fence.
+ *
+ * A common quirk: asked for a formatted answer, the model returns the formatted
+ * answer inside a fence, and the panel renders the whole reply as one code block
+ * — table syntax, bullets and all. Only the whole-answer case is unwrapped, and
+ * only when the fence actually closes at the end: an ordinary code fence, an
+ * unclosed fence mid-stream, and a fence with prose after it are all left alone.
+ */
+export function unwrapWholeAnswerFence(text) {
+    const lines = text.trim().split('\n');
+    const first = lines[0];
+    if (lines.length < 2 || first === undefined || !MARKDOWN_FENCE_OPEN.test(first))
+        return text;
+    // Paired with the last fence line, which is a whole-answer wrapper only if it is
+    // also the final line: an unclosed fence, or one with prose after it, is not.
+    const last = lines[lines.length - 1];
+    if (last === undefined || !FENCE_CLOSE.test(last))
+        return text;
+    return lines.slice(1, -1).join('\n');
+}
+/**
+ * Cuts `text` to roughly `max` characters, on the last paragraph or line break
+ * before the limit.
+ *
+ * Slicing markdown at an arbitrary character can split a fence or a table row and
+ * make the preview render as something the answer never said, so the cut lands on
+ * a block boundary where there is one within reach.
+ */
+export function clipToBoundary(text, max) {
+    if (text.length <= max)
+        return text;
+    const head = text.slice(0, max);
+    const paragraph = head.lastIndexOf('\n\n');
+    const line = head.lastIndexOf('\n');
+    const cut = paragraph > max / 2 ? paragraph : line > max / 2 ? line : max;
+    return head.slice(0, cut).trimEnd();
+}
+//# sourceMappingURL=markdown.js.map

package/dist/core/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/core/markdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8FAA8F;AAC9F,MAAM,mBAAmB,GAAG,+BAA+B,CAAA;AAC3D,8BAA8B;AAC9B,MAAM,WAAW,GAAG,YAAY,CAAA;AAEhC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAE5F,iFAAiF;IACjF,8EAA8E;IAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAE9D,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW;IACtD,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAA;IAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAA;IAEzE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;AACrC,CAAC"}

package/dist/core/prose.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Detects a tool call that leaked into the answer.
+ *
+ * The agent loop is prompt-based, not native function calling: the model is told
+ * to reply with only `{"tool": "<name>", "args": { ... }}`, and
+ * `backend/core/agent/src/loop.js` decides prose-vs-tool-call from the first
+ * non-whitespace character being `{`. A model that wraps its JSON in a ```json
+ * fence therefore leads with a backtick, is classified as prose, and the raw
+ * tool call is streamed to the operator as if it were the answer. Measured at
+ * roughly one read in eight against `gemma3:4b` — common enough to handle.
+ *
+ * Rendering that verbatim is the single most confusing failure mode in the
+ * stack, so it is detected and labelled instead.
+ */
+export type LeakedToolCall = {
+    tool: string;
+    args: Record<string, unknown>;
+};
+/**
+ * Returns the leaked call when `text` is nothing but a tool call, else null.
+ *
+ * Deliberately strict: the JSON must be the whole message once code fences are
+ * stripped. A genuine answer that merely quotes some JSON keeps rendering as
+ * prose.
+ */
+export declare function parseLeakedToolCall(text: string): LeakedToolCall | null;
+//# sourceMappingURL=prose.d.ts.map

package/dist/core/prose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.d.ts","sourceRoot":"","sources":["../../src/core/prose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqCH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAE5E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAkBvE"}

package/dist/core/prose.js

@@ -0,0 +1,79 @@
+/**
+ * Detects a tool call that leaked into the answer.
+ *
+ * The agent loop is prompt-based, not native function calling: the model is told
+ * to reply with only `{"tool": "<name>", "args": { ... }}`, and
+ * `backend/core/agent/src/loop.js` decides prose-vs-tool-call from the first
+ * non-whitespace character being `{`. A model that wraps its JSON in a ```json
+ * fence therefore leads with a backtick, is classified as prose, and the raw
+ * tool call is streamed to the operator as if it were the answer. Measured at
+ * roughly one read in eight against `gemma3:4b` — common enough to handle.
+ *
+ * Rendering that verbatim is the single most confusing failure mode in the
+ * stack, so it is detected and labelled instead.
+ */
+const FENCE = /^```[a-z]*\s*|\n?```$/gi;
+/**
+ * The first balanced JSON object in `text`, string-aware so a brace inside a
+ * string literal does not close it. Mirrors `extractJsonObject` in the producer.
+ */
+function extractJsonObject(text) {
+    const start = text.indexOf('{');
+    if (start === -1)
+        return null;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let index = start; index < text.length; index += 1) {
+        const char = text[index];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (char === '\\')
+                escaped = true;
+            else if (char === '"')
+                inString = false;
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            continue;
+        }
+        if (char === '{')
+            depth += 1;
+        else if (char === '}') {
+            depth -= 1;
+            if (depth === 0)
+                return text.slice(start, index + 1);
+        }
+    }
+    return null;
+}
+/**
+ * Returns the leaked call when `text` is nothing but a tool call, else null.
+ *
+ * Deliberately strict: the JSON must be the whole message once code fences are
+ * stripped. A genuine answer that merely quotes some JSON keeps rendering as
+ * prose.
+ */
+export function parseLeakedToolCall(text) {
+    const stripped = text.trim().replace(FENCE, '').trim();
+    if (!stripped.startsWith('{'))
+        return null;
+    const raw = extractJsonObject(stripped);
+    if (raw === null || raw !== stripped)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.tool !== 'string')
+            return null;
+        const args = typeof parsed.args === 'object' && parsed.args !== null
+            ? parsed.args
+            : {};
+        return { tool: parsed.tool, args };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=prose.js.map

package/dist/core/prose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.js","sourceRoot":"","sources":["../../src/core/prose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,KAAK,GAAG,yBAAyB,CAAA;AAEvC;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAE7B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACxB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,OAAO;gBAAE,OAAO,GAAG,KAAK,CAAA;iBACvB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAA;iBACjC,IAAI,IAAI,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAA;YACvC,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAA;YACf,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAA;aACvB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,CAAA;YACV,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACtD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAE1C,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACvC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuC,CAAA;QACpE,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QAChD,MAAM,IAAI,GACN,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;YACvD,CAAC,CAAE,MAAM,CAAC,IAAgC;YAC1C,CAAC,CAAC,EAAE,CAAA;QACR,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/core/small-talk.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Was an operator message conversation rather than a question about the fleet?
+ *
+ * This exists for one caller: whether an answer is worth marking as having used no tools. The
+ * marker is there to catch an answer that should have consulted the fleet and did not — and
+ * against a greeting, a thank-you, or "what can you do", calling nothing was the right move, so
+ * every one of those was carrying a warning about a failure that had not happened.
+ *
+ * Deliberately asymmetric. All three gates below must agree before a message counts as small
+ * talk, and any fleet word vetoes it outright, because the two mistakes are not equal: missing a
+ * greeting costs one redundant marker, while reading a fleet question as small talk hides exactly
+ * the warning the marker exists to give.
+ */
+export declare function isSmallTalk(text: string): boolean;
+//# sourceMappingURL=small-talk.d.ts.map

package/dist/core/small-talk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"small-talk.d.ts","sourceRoot":"","sources":["../../src/core/small-talk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWjD"}

package/dist/core/small-talk.js

@@ -0,0 +1,42 @@
+/**
+ * Was an operator message conversation rather than a question about the fleet?
+ *
+ * This exists for one caller: whether an answer is worth marking as having used no tools. The
+ * marker is there to catch an answer that should have consulted the fleet and did not — and
+ * against a greeting, a thank-you, or "what can you do", calling nothing was the right move, so
+ * every one of those was carrying a warning about a failure that had not happened.
+ *
+ * Deliberately asymmetric. All three gates below must agree before a message counts as small
+ * talk, and any fleet word vetoes it outright, because the two mistakes are not equal: missing a
+ * greeting costs one redundant marker, while reading a fleet question as small talk hides exactly
+ * the warning the marker exists to give.
+ */
+/** Openers where the greeting *is* the message — nothing is being asked of the fleet. */
+const CONVERSATIONAL = [
+    /^(?:hi|hey|hello|yo|hiya|howdy|greetings|good (?:morning|afternoon|evening|day))\b/,
+    /^(?:how are you|how's it going|what's up|sup)\b/,
+    /^(?:thanks|thank you|thx|ty|cheers|nice|great|cool|awesome|perfect|got it|ok|okay|sure|sorry|never mind|nvm)\b/,
+    /^(?:bye|goodbye|see you|see ya|later)\b/,
+    /^(?:who are you|what are you|what can you do|what do you do|can you help|help)\b/,
+];
+/**
+ * Words that make a message about the fleet however it opens, so "hey, list the miners" is not
+ * small talk. Kept to unambiguous terms: "up" and "down" are fleet state but also "what's up".
+ */
+const FLEET_TERMS = /\b(?:device|devices|miner|miners|asic|asics|rig|rigs|worker|workers|site|container|containers|pool|pools|sensor|sensors|powermeter|powermeters|power meter|hashrate|hash rate|temperature|telemetry|fleet|rank|reboot|restart|offline|online|status|list|show|count)\b/;
+/** Past this, a message is doing more than saying hello, whatever it opened with. */
+const MAX_WORDS = 6;
+export function isSmallTalk(text) {
+    const normalized = text
+        .toLowerCase()
+        .replaceAll('’', '\'') // a typographic apostrophe still spells "what's"
+        .trim();
+    if (normalized.length === 0)
+        return false;
+    if (FLEET_TERMS.test(normalized))
+        return false;
+    if (normalized.split(/\s+/).length > MAX_WORDS)
+        return false;
+    return CONVERSATIONAL.some((pattern) => pattern.test(normalized));
+}
+//# sourceMappingURL=small-talk.js.map