@teaflask/assistant 0.0.0 → 0.3.0

package/dist/core/execution-inbox.js

@@ -0,0 +1,344 @@
+import { TOOL_EXECUTION_REQUESTED_EVENT_NAME, TOOL_RESULT_RECORDED_EVENT_NAME, } from "../contract/events.js";
+import { isTerminalTurnStatus } from "./activity.js";
+import { MEMBER_ANSWERABLE_KINDS } from "./execution-kinds.js";
+import { coworkerExecutionRequestOf, executionRequestedPayloadOf, recordOrNull, } from "./execution-request-narrowing.js";
+export { coworkerExecutionRequestOf, executionRequestedPayloadOf, } from "./execution-request-narrowing.js";
+const PENDING = { kind: "pending" };
+/** Narrow a tool_result_recorded CUSTOM event's wire value. */
+export function toolResultRecordedPayloadOf(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const record = value;
+    if (typeof record.interrupt_id !== "string" || record.interrupt_id === "") {
+        return null;
+    }
+    return {
+        interruptId: record.interrupt_id,
+        ok: typeof record.ok === "boolean" ? record.ok : true,
+    };
+}
+export class ExecutionInbox {
+    currentRunId = null;
+    seenRunIds = new Set();
+    seenToolCallIds = new Set();
+    // The coworker requests REST has named, by interrupt id — what a
+    // stream marker for one of them is re-labelled from.
+    coworkerAsks = new Map();
+    entryList = [];
+    // --- the stream side -------------------------------------------------
+    noteRunStarted(runId) {
+        this.currentRunId = runId;
+        if (this.seenRunIds.has(runId)) {
+            // A run id already seen is a RE-ENTERED historical segment: the
+            // thread stream re-opens an old run's segment whenever a row lands
+            // late under it (a coworker's answer is recorded under its
+            // dispatching turn's run) — nothing began, nothing closes.
+            return false;
+        }
+        this.seenRunIds.add(runId);
+        // A run beginning for the first time is closing evidence for the
+        // assistant's straggler entries — only the newest run can still be
+        // awaiting input. A coworker's pause outlives the parent's runs.
+        return this._removeWhere((entry) => entry.asker.kind === "assistant" && entry.runId !== runId);
+    }
+    noteToolCallStart(toolCallId) {
+        // TOOL_CALL_START precedes its pause marker in stream order, so the
+        // set is complete by the time anchoring is judged — nothing to
+        // publish here (the approval inbox's own semantics).
+        this.seenToolCallIds.add(toolCallId);
+        return false;
+    }
+    noteExecutionRequested(payload) {
+        if (this.currentRunId === null) {
+            // A marker outside any run segment is unanchorable — ignore it.
+            return false;
+        }
+        const runId = this.currentRunId;
+        if (this._hasEntry(payload.interrupt_id)) {
+            // A replayed marker for an entry we already hold: keep the entry's
+            // status — replay must never reopen an already-reported request.
+            return false;
+        }
+        const coworkerAsk = this.coworkerAsks.get(payload.interrupt_id);
+        if (coworkerAsk !== undefined) {
+            if (MEMBER_ANSWERABLE_KINDS.has(payload.request.kind)) {
+                // The stream door of the adoption's skip below: not held here
+                // either, or it would be an assistant entry minting a question card.
+                return false;
+            }
+            // A marker for a request REST already named as a coworker's: its
+            // round is the coworker's own and never meets the parent's
+            // arbitration below.
+            this.entryList.push(_entryOf(payload, this.seenToolCallIds, coworkerAsk.runId, coworkerAsk));
+            return true;
+        }
+        // THE PREMISE: round arbitration is the ASSISTANT's alone. A coworker's
+        // entry carries the dispatching turn's run id and the CHILD's segment
+        // round — two namespaces that share a bucket only by accident — and its
+        // lifetime is REST's, so it neither competes with nor supersedes the
+        // parent's rounds (the dashboard's inbox-asker census pins it).
+        const newestRound = this._newestRoundOf(runId);
+        if (newestRound !== null && payload.round < newestRound) {
+            // A lower round replaying after a later pause is history, not an ask.
+            return false;
+        }
+        // A higher round supersedes the run's earlier entries (round
+        // namespacing: multi-pause turns re-emit cards and must not collide).
+        if (newestRound !== null && payload.round > newestRound) {
+            this._removeWhere((entry) => entry.asker.kind === "assistant" &&
+                entry.runId === runId &&
+                entry.round < payload.round);
+        }
+        this.entryList.push(_entryOf(payload, this.seenToolCallIds, runId, null));
+        return true;
+    }
+    // --- the REST side -------------------------------------------
+    /**
+     * The coworker requests the turn snapshot lists, adopted: a card not
+     * held opens a pending entry addressed to its dispatching turn; a held
+     * pending entry the stream delivered first is re-labelled; a coworker
+     * entry no turn lists anymore is gone (its row left paused). Bypasses
+     * the marker path's round arbitration — a coworker's round is its own.
+     */
+    adoptCoworkerRequests(turns) {
+        let changed = false;
+        const listed = new Set();
+        for (const turn of turns) {
+            for (const raw of turn.pending_coworker_executions ?? []) {
+                const request = coworkerExecutionRequestOf(raw);
+                if (request === null) {
+                    continue;
+                }
+                const interruptId = request.card.interrupt_id;
+                // The label and drill-in handle the snapshot carries are the ledger
+                // join's to render; the entry keeps only what its readers use.
+                const ask = {
+                    asker: { kind: "coworker", ordinal: request.ordinal },
+                    turnId: turn.id,
+                    runId: turn.run_id ?? turn.id,
+                };
+                this.coworkerAsks.set(interruptId, ask);
+                if (MEMBER_ANSWERABLE_KINDS.has(request.card.request.kind)) {
+                    // A coworker's request has exactly one door, the driver's POST
+                    // under its dispatching turn. A member-answerable kind would leave
+                    // through the question-set submit instead, addressed by the
+                    // assistant's run and staling that whole run on a 409 — so it is
+                    // held on neither door: not adopted here, and the ask is remembered
+                    // so a stream marker for the id is dropped by noteExecutionRequested
+                    // instead of landing as the assistant's (the playground twin's
+                    // posture). Unreachable today: a coworker runs HEADLESS and ask_user
+                    // mounts on LIVE only — the approval inbox's asker-carrying card
+                    // does not change that.
+                    // A marker that beat the snapshot here landed as the assistant's;
+                    // it leaves now.
+                    const dropped = this._removeWhere((entry) => entry.interruptId === interruptId);
+                    changed = dropped || changed;
+                    continue;
+                }
+                listed.add(interruptId);
+                const held = this.entryList.find((entry) => entry.interruptId === interruptId);
+                if (held === undefined) {
+                    this.entryList.push(_entryOf(request.card, this.seenToolCallIds, ask.runId, ask));
+                    changed = true;
+                }
+                else if (held.asker.kind === "assistant") {
+                    held.asker = ask.asker;
+                    held.turnId = ask.turnId;
+                    changed = true;
+                }
+            }
+        }
+        if (turns.length > 0) {
+            const removed = this._removeWhere((entry) => entry.asker.kind === "coworker" && !listed.has(entry.interruptId));
+            changed = removed || changed;
+        }
+        return changed;
+    }
+    /** A 409 for a coworker's request speaks for that request alone. */
+    markCoworkerRequestStale(interruptId) {
+        return this._staleWhere((entry) => entry.asker.kind === "coworker" && entry.interruptId === interruptId);
+    }
+    /** The member's send voids every paused coworker of the thread. */
+    markCoworkerRequestsStale() {
+        return this._staleWhere((entry) => entry.asker.kind === "coworker");
+    }
+    noteToolResultRecorded(interruptId, ok) {
+        // The receipt is the stream saying "a delivery happened" — on a replay
+        // it lands right after the marker it answers, so the entry flips to
+        // reported in the same burst and the driver can never claim an
+        // already-answered request. The gated call's result (or RUN_ERROR, or
+        // the settled turn's word) still closes the entry, as on the live path.
+        return this._transition(interruptId, ["pending", "executing"], {
+            kind: "reported",
+            ok,
+        });
+    }
+    noteToolCallResult(toolCallId) {
+        // The gated call producing a result is the resume made visible.
+        return this._removeWhere((entry) => entry.toolCallId === toolCallId);
+    }
+    noteRunFinished() {
+        // A RUN_FINISHED closes nothing by itself. THE PREMISE: the thread
+        // streamer synthesizes a RUN_FINISHED for the LIVE run right before it
+        // re-enters an old run's segment for a late row (a coworker's answer or
+        // receipt lands under its dispatching turn's run), and the two frames
+        // are indistinguishable on the wire from a real terminal — so removing
+        // the run's entries here would lose a live pause's ask that nothing
+        // re-delivers. The run's entries die on their own evidence (the receipt,
+        // the gated call's result), on a first-seen run beginning (the
+        // straggler wipe above), on RUN_ERROR, or on the durable turn record's
+        // word (reconcileWithTurns) — the approval inbox's posture too
+        // (the dashboard's run-lifecycle census pins it).
+        return false;
+    }
+    /** The durable turn record's word: the assistant's entries
+     *  whose run belongs to a SETTLED turn are gone — the REST-driven close a
+     *  synthesized terminal cannot fake. */
+    reconcileWithTurns(turns) {
+        const settledRuns = new Set(turns
+            .filter((turn) => isTerminalTurnStatus(turn.status))
+            .map((turn) => turn.run_id)
+            .filter((runId) => runId !== null));
+        return this._removeWhere((entry) => entry.asker.kind === "assistant" && settledRuns.has(entry.runId));
+    }
+    noteRunError() {
+        // RUN_ERROR carries no runId, and a serving RUN_ERROR ends the stream —
+        // nothing of the assistant's can be answered anymore.
+        return this._removeWhere((entry) => entry.asker.kind === "assistant");
+    }
+    // --- the driver side ---------------------------------------------------
+    beginExecution(interruptId) {
+        // The at-most-once claim: synchronous, so two overlapping passes (or
+        // StrictMode's double connection) can never both win the same entry.
+        return this._transition(interruptId, ["pending"], { kind: "executing" });
+    }
+    settleReported(interruptId, ok) {
+        return this._transition(interruptId, ["executing"], {
+            kind: "reported",
+            ok,
+        });
+    }
+    settlePostFailed(interruptId) {
+        // The POST failed, not the execution — the entry returns to pending so
+        // a later pass re-POSTs the stored outcome. Re-execution is the
+        // ledger's to prevent, never this transition's to allow.
+        return this._transition(interruptId, ["executing"], PENDING);
+    }
+    markRunStale(runId) {
+        // A 409 speaks for the whole pause: none of the run's open asks can
+        // land anymore. Reported entries keep their honest note.
+        return this._staleWhere((entry) => entry.asker.kind === "assistant" && entry.runId === runId);
+    }
+    // --- reading -------------------------------------------------------------
+    entries() {
+        return this.entryList.map((entry) => ({ ...entry }));
+    }
+    // --- internals -------------------------------------------------------------
+    _hasEntry(interruptId) {
+        return this.entryList.some((entry) => entry.interruptId === interruptId);
+    }
+    _newestRoundOf(runId) {
+        const rounds = this.entryList
+            .filter((entry) => entry.asker.kind === "assistant" && entry.runId === runId)
+            .map((entry) => entry.round);
+        return rounds.length > 0 ? Math.max(...rounds) : null;
+    }
+    _staleWhere(doomed) {
+        let changed = false;
+        for (const entry of this.entryList) {
+            if (doomed(entry) &&
+                (entry.status.kind === "pending" || entry.status.kind === "executing")) {
+                entry.status = { kind: "stale" };
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    _removeWhere(doomed) {
+        const kept = this.entryList.filter((entry) => !doomed(entry));
+        if (kept.length === this.entryList.length) {
+            return false;
+        }
+        this.entryList = kept;
+        return true;
+    }
+    _transition(interruptId, fromKinds, to) {
+        const entry = this.entryList.find((known) => known.interruptId === interruptId);
+        if (entry === undefined || !fromKinds.includes(entry.status.kind)) {
+            return false;
+        }
+        entry.status = to;
+        return true;
+    }
+}
+function _entryOf(payload, seenToolCallIds, runId, ask) {
+    return {
+        interruptId: payload.interrupt_id,
+        toolName: payload.tool_name,
+        toolCallId: payload.tool_call_id ?? null,
+        // A coworker's card names the CHILD run's tool call, which never
+        // streams in the parent's transcript — it anchors nothing here.
+        anchored: payload.tool_call_id != null && seenToolCallIds.has(payload.tool_call_id),
+        kind: payload.request.kind,
+        action: recordOrNull(payload.request.action),
+        intent: recordOrNull(payload.request.intent),
+        round: payload.round,
+        runId,
+        status: PENDING,
+        asker: ask?.asker ?? { kind: "assistant" },
+        turnId: ask?.turnId ?? null,
+    };
+}
+/**
+ * The subscriber that feeds the stream into the inbox: markers open
+ * entries, receipts report them, and the resume's own evidence closes
+ * them. Only the server-named run id from RUN_STARTED is trusted — the
+ * connect-run's input.runId is the client's own and never names a
+ * recorded run.
+ *
+ * A quiet close needs nothing from this recorder: an open entry survives
+ * it untouched, because nothing about being answerable depends on whether
+ * the turn parked. The REST consult that tells a park from a dropped
+ * connection, and the go/no-go it drives, stay the approval recorder's.
+ */
+export function executionInboxRecorder(inbox, onEntriesChanged) {
+    const publishWhen = (changed) => {
+        if (changed) {
+            onEntriesChanged(inbox.entries());
+        }
+    };
+    return {
+        onRunStartedEvent({ event }) {
+            publishWhen(inbox.noteRunStarted(event.runId));
+        },
+        onCustomEvent({ event }) {
+            if (event.name === TOOL_EXECUTION_REQUESTED_EVENT_NAME) {
+                const payload = executionRequestedPayloadOf(event.value);
+                if (payload !== null) {
+                    publishWhen(inbox.noteExecutionRequested(payload));
+                }
+                return;
+            }
+            if (event.name === TOOL_RESULT_RECORDED_EVENT_NAME) {
+                const receipt = toolResultRecordedPayloadOf(event.value);
+                if (receipt !== null) {
+                    publishWhen(inbox.noteToolResultRecorded(receipt.interruptId, receipt.ok));
+                }
+            }
+        },
+        onToolCallStartEvent({ event }) {
+            publishWhen(inbox.noteToolCallStart(event.toolCallId));
+        },
+        onToolCallResultEvent({ event }) {
+            publishWhen(inbox.noteToolCallResult(event.toolCallId));
+        },
+        onRunFinishedEvent() {
+            publishWhen(inbox.noteRunFinished());
+        },
+        onRunErrorEvent() {
+            publishWhen(inbox.noteRunError());
+        },
+    };
+}
+//# sourceMappingURL=execution-inbox.js.map

package/dist/core/execution-inbox.js.map

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

package/dist/core/execution-kinds.d.ts

@@ -0,0 +1,57 @@
+export declare const NAVIGATE_REQUEST_KIND = "builtin.navigate";
+export declare const HTTP_INTENT_REQUEST_KIND = "http_intent";
+export declare const READ_PAGE_REQUEST_KIND = "builtin.read_page";
+export declare const HIGHLIGHT_REQUEST_KIND = "builtin.highlight";
+export declare const PREFILL_FORM_REQUEST_KIND = "builtin.prefill_form";
+export declare const ASK_QUESTIONS_REQUEST_KIND = "builtin.ask_questions";
+/**
+ * The kinds whose executor is the MEMBER, not this client: the driver
+ * must never auto-answer them (its unknown-kind fallback would post
+ * kind_unsupported and withdraw the ask). Their entries stay pending in
+ * the inbox — closing on stream evidence like every entry — and are
+ * answered through the store's submitQuestionAnswers / cancelQuestionSet
+ * when the member submits the rendered panel. Any kind NOT here — one
+ * this client predates, or one it has since retired (the question set's
+ * one-question predecessor) — is answered
+ * kind_unsupported through the driver: the contract's documented
+ * degrade, which the server turns into "ask it in chat" — never an
+ * invisible wait.
+ */
+export declare const MEMBER_ANSWERABLE_KINDS: ReadonlySet<string>;
+export declare const MAX_DELIVERY_ATTEMPTS = 3;
+type ExecutionErrorCode = "kind_unsupported" | "execution_failed";
+/** What the failing API itself said, when the host adapter's error
+ *  carried it: the HTTP status, the API's own error code, and its
+ *  per-field problems (a 422's validation list). Optional and additive
+ *  — an adapter that throws a bare Error yields none. Every member is
+ *  bounded before it rides (execution-handlers.ts). */
+export interface ExecutionFailureDetail {
+    status: number;
+    code: string;
+    fields?: {
+        path: string;
+        message: string;
+    }[];
+    /** How many problems the API named beyond `fields` — the per-detail
+     *  cap and the door fit both drop from the tail, and a partial list
+     *  must never read as complete. Present only when positive. */
+    fieldsOmitted?: number;
+}
+interface ExecutionError {
+    /** Distinguishes "this client can't serve the kind" from a real failure. */
+    code: ExecutionErrorCode;
+    message: string;
+    detail?: ExecutionFailureDetail;
+}
+export type ExecutionOutcome = {
+    ok: true;
+    result: Record<string, unknown>;
+} | {
+    ok: false;
+    error: ExecutionError;
+};
+export declare const KIND_UNSUPPORTED_OUTCOME: Extract<ExecutionOutcome, {
+    ok: false;
+}>;
+export {};
+//# sourceMappingURL=execution-kinds.d.ts.map

package/dist/core/execution-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-kinds.d.ts","sourceRoot":"","sources":["../../src/core/execution-kinds.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,wBAAwB,gBAAgB,CAAC;AACtD,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAIhE,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAEtD,CAAC;AAQH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,KAAK,kBAAkB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAElE;;;;uDAIuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C;;mEAE+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,4EAA4E;IAC5E,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAEzC,eAAO,MAAM,wBAAwB,EAAE,OAAO,CAC5C,gBAAgB,EAChB;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CASd,CAAC"}

package/dist/core/execution-kinds.js

@@ -0,0 +1,63 @@
+// The execution-request kind vocabulary, as a dependency-free leaf:
+// these constants used to live in execution-handlers.ts,
+// whose HANDLERS legitimately import the transport adapter, the DOM
+// reader subtree and the affordances — but the KINDS are pure
+// vocabulary, and the tool-decision anchor family (a value export of
+// the ./transcript projection entry) needs only the member-answerable
+// table. Reading it through the handlers dragged 16
+// transport/reader/affordance modules into an entry whose own law is
+// "React-free and transport-free by construction"
+// (tests/bundle-closure.test.ts pins the closure now).
+// execution-handlers.ts re-exports everything here, so its consumers
+// are unchanged.
+//
+// The same maneuver holds for the outcome vocabulary: the canned
+// kind-unsupported refusal (and the ExecutionOutcome shape it inhabits)
+// moved here from execution-handlers.ts so ./transcript can export it —
+// the dashboard playground answers unservable execution kinds with the
+// package's own sentence rather than a transcription of it. Like the
+// kinds, these are import-free values, so the entry's closure stays
+// transport-free.
+// The execution-request kinds the navigate, http_actions, and read_page
+// capabilities mint (the serving contract, "Execution-request kinds").
+export const NAVIGATE_REQUEST_KIND = "builtin.navigate";
+export const HTTP_INTENT_REQUEST_KIND = "http_intent";
+export const READ_PAGE_REQUEST_KIND = "builtin.read_page";
+export const HIGHLIGHT_REQUEST_KIND = "builtin.highlight";
+export const PREFILL_FORM_REQUEST_KIND = "builtin.prefill_form";
+// The conversational elicitation kind: the assistant asked the
+// member a SET of questions in one pause; every answer is plain text.
+// Deliberately NOT in execution-handlers' handler registry.
+export const ASK_QUESTIONS_REQUEST_KIND = "builtin.ask_questions";
+/**
+ * The kinds whose executor is the MEMBER, not this client: the driver
+ * must never auto-answer them (its unknown-kind fallback would post
+ * kind_unsupported and withdraw the ask). Their entries stay pending in
+ * the inbox — closing on stream evidence like every entry — and are
+ * answered through the store's submitQuestionAnswers / cancelQuestionSet
+ * when the member submits the rendered panel. Any kind NOT here — one
+ * this client predates, or one it has since retired (the question set's
+ * one-question predecessor) — is answered
+ * kind_unsupported through the driver: the contract's documented
+ * degrade, which the server turns into "ask it in chat" — never an
+ * invisible wait.
+ */
+export const MEMBER_ANSWERABLE_KINDS = new Set([
+    ASK_QUESTIONS_REQUEST_KIND,
+]);
+// A delivery that keeps failing on transport trouble stops re-posting
+// after this many attempts went wrong — the turn then parks exactly as
+// it did before the driver existed, and reopening the thread re-arms the
+// pass. One value for every deliverer (the package driver and the
+// dashboard playground's refusal pass), here because the
+// ./transcript entry exports it and this leaf is import-free.
+export const MAX_DELIVERY_ATTEMPTS = 3;
+export const KIND_UNSUPPORTED_OUTCOME = {
+    ok: false,
+    error: {
+        code: "kind_unsupported",
+        message: "This page cannot perform this action itself. Tell the user what " +
+            "you were trying to do and how they can do it themselves.",
+    },
+};
+//# sourceMappingURL=execution-kinds.js.map

package/dist/core/execution-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-kinds.js","sourceRoot":"","sources":["../../src/core/execution-kinds.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,yDAAyD;AACzD,oEAAoE;AACpE,8DAA8D;AAC9D,qEAAqE;AACrE,sEAAsE;AACtE,oDAAoD;AACpD,qEAAqE;AACrE,kDAAkD;AAClD,uDAAuD;AACvD,qEAAqE;AACrE,iBAAiB;AACjB,EAAE;AACF,iEAAiE;AACjE,wEAAwE;AACxE,wEAAwE;AACxE,uEAAuE;AACvE,qEAAqE;AACrE,oEAAoE;AACpE,kBAAkB;AAElB,wEAAwE;AACxE,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAChE,+DAA+D;AAC/D,sEAAsE;AACtE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC;IAClE,0BAA0B;CAC3B,CAAC,CAAC;AAEH,sEAAsE;AACtE,uEAAuE;AACvE,yEAAyE;AACzE,kEAAkE;AAClE,yDAAyD;AACzD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AA8BvC,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,EAAE,EAAE,KAAK;IACT,KAAK,EAAE;QACL,IAAI,EAAE,kBAAkB;QACxB,OAAO,EACL,kEAAkE;YAClE,0DAA0D;KAC7D;CACF,CAAC"}

package/dist/core/execution-request-narrowing.d.ts

@@ -0,0 +1,30 @@
+import type { ToolExecutionRequestedPayload } from "../contract/events.js";
+/** One coworker request as the turn snapshot lists it, narrowed. */
+export interface CoworkerExecutionRequest {
+    ordinal: number;
+    label: string;
+    childSessionId: string;
+    card: ToolExecutionRequestedPayload;
+}
+/** The turn fields the coworker adoption reads — the serving and the
+ *  dashboard turn shapes both satisfy it. */
+export interface CoworkerRequestTurn {
+    id: string;
+    run_id: string | null;
+    pending_coworker_executions?: readonly unknown[] | null;
+}
+/**
+ * Narrow one pending_coworker_executions item (any by contract): the
+ * asker's identity plus the card in the marker's own shape, so the
+ * marker narrowing above serves both askers. Malformed → null.
+ */
+export declare function coworkerExecutionRequestOf(value: unknown): CoworkerExecutionRequest | null;
+/**
+ * Narrow a tool_execution_requested CUSTOM event's wire value (any by
+ * contract). Malformed payloads return null and are ignored — the
+ * contract's "clients MUST ignore events and fields they do not
+ * recognize".
+ */
+export declare function executionRequestedPayloadOf(value: unknown): ToolExecutionRequestedPayload | null;
+export declare function recordOrNull(value: unknown): Record<string, unknown> | null;
+//# sourceMappingURL=execution-request-narrowing.d.ts.map

package/dist/core/execution-request-narrowing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-request-narrowing.d.ts","sourceRoot":"","sources":["../../src/core/execution-request-narrowing.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAE3E,oEAAoE;AACpE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,6BAA6B,CAAC;CACrC;AAED;6CAC6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2BAA2B,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,wBAAwB,GAAG,IAAI,CAsBjC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,6BAA6B,GAAG,IAAI,CAuBtC;AAmBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK3E"}

package/dist/core/execution-request-narrowing.js

@@ -0,0 +1,82 @@
+// The execution wire's narrowers: a
+// tool_execution_requested marker's value and a turn snapshot's coworker
+// request item, both `any` by contract. Malformed values return null and
+// are ignored — the contract's "clients MUST ignore events and fields they
+// do not recognize". A dependency-free leaf, so the ./transcript entry
+// exports the coworker narrowing without dragging the inbox along.
+/**
+ * Narrow one pending_coworker_executions item (any by contract): the
+ * asker's identity plus the card in the marker's own shape, so the
+ * marker narrowing above serves both askers. Malformed → null.
+ */
+export function coworkerExecutionRequestOf(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const record = value;
+    if (typeof record.ordinal !== "number" ||
+        typeof record.label !== "string" ||
+        typeof record.child_session_id !== "string") {
+        return null;
+    }
+    const card = executionRequestedPayloadOf(record.card);
+    if (card === null) {
+        return null;
+    }
+    return {
+        ordinal: record.ordinal,
+        label: record.label,
+        childSessionId: record.child_session_id,
+        card,
+    };
+}
+/**
+ * Narrow a tool_execution_requested CUSTOM event's wire value (any by
+ * contract). Malformed payloads return null and are ignored — the
+ * contract's "clients MUST ignore events and fields they do not
+ * recognize".
+ */
+export function executionRequestedPayloadOf(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const record = value;
+    if (typeof record.interrupt_id !== "string" || record.interrupt_id === "") {
+        return null;
+    }
+    if (typeof record.tool_name !== "string") {
+        return null;
+    }
+    const request = _requestOf(record.request);
+    if (request === null) {
+        return null;
+    }
+    return {
+        interrupt_id: record.interrupt_id,
+        tool_name: record.tool_name,
+        tool_call_id: typeof record.tool_call_id === "string" ? record.tool_call_id : null,
+        round: typeof record.round === "number" ? record.round : 0,
+        request,
+    };
+}
+function _requestOf(value) {
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const record = value;
+    if (typeof record.kind !== "string" || record.kind === "") {
+        return null;
+    }
+    return {
+        kind: record.kind,
+        intent: recordOrNull(record.intent),
+        action: recordOrNull(record.action),
+    };
+}
+export function recordOrNull(value) {
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        return value;
+    }
+    return null;
+}
+//# sourceMappingURL=execution-request-narrowing.js.map

package/dist/core/execution-request-narrowing.js.map

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

package/dist/core/host-fill.d.ts

@@ -0,0 +1,2 @@
+export declare function hostFillDeclines(fill: unknown): boolean;
+//# sourceMappingURL=host-fill.d.ts.map

package/dist/core/host-fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-fill.d.ts","sourceRoot":"","sources":["../../src/core/host-fill.ts"],"names":[],"mappings":"AAOA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEvD"}

package/dist/core/host-fill.js

@@ -0,0 +1,11 @@
+// The fall-through rule for every host-provided node slot in the package:
+// a fill declines exactly when it is a value React renders as nothing
+// REGARDLESS of content — null, undefined, and both booleans, so the
+// idiomatic `cond && <X/>` falls through on its false arm to the package
+// default. Renderable emptiness ("", 0, []) is the host's deliberate
+// content and counts as filled. One predicate, so no slot can gate on
+// `!= null` and hand a `false` to the screen as a blank.
+export function hostFillDeclines(fill) {
+    return fill === null || fill === undefined || typeof fill === "boolean";
+}
+//# sourceMappingURL=host-fill.js.map

package/dist/core/host-fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-fill.js","sourceRoot":"","sources":["../../src/core/host-fill.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,sEAAsE;AACtE,qEAAqE;AACrE,yEAAyE;AACzE,qEAAqE;AACrE,sEAAsE;AACtE,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,SAAS,CAAC;AAC1E,CAAC"}