@teaflask/assistant 0.0.0 → 0.3.0

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

@@ -0,0 +1,61 @@
+import type { AssistantThreadDetailResponse, ResolveTurnToolResultsRequest, ResolveTurnToolResultsResponse } from "../contract/threads.js";
+import { type ExecutionHandler } from "./execution-handlers.js";
+import { type ExecutionEntryModel, type ExecutionInbox } from "./execution-inbox.js";
+export interface ExecutionPassContext {
+    inbox: ExecutionInbox;
+    threadId: string;
+    handlers: ReadonlyMap<string, ExecutionHandler>;
+    /** Delivery attempts per interrupt id — exhausted entries stay pending
+     *  for the NEXT connection's pass (re-POST is the designed recovery). */
+    attempts: Map<string, number>;
+    fetchThreadDetail: () => Promise<AssistantThreadDetailResponse>;
+    postResults: (turnId: string, request: ResolveTurnToolResultsRequest) => Promise<ResolveTurnToolResultsResponse>;
+    publishEntries: (entries: readonly ExecutionEntryModel[]) => void;
+    onWorkflowRestarted: () => void;
+}
+/**
+ * One drain of the inbox's pending entries. Exported so the pass logic
+ * unit-tests in node — the ExecutionDriver below is only a scheduler
+ * around it.
+ */
+export declare function runExecutionPass(context: ExecutionPassContext): Promise<void>;
+export interface ExecutionDriverDeps {
+    inbox: ExecutionInbox;
+    threadId: string;
+    /** Read fresh at each pass: the host's handlers map changes identity
+     *  with the provider's re-renders (navigate ref), and the driver must
+     *  never act on a stale one. */
+    handlersOf: () => ReadonlyMap<string, ExecutionHandler>;
+    fetchThreadDetail: () => Promise<AssistantThreadDetailResponse>;
+    postResults: (turnId: string, request: ResolveTurnToolResultsRequest) => Promise<ResolveTurnToolResultsResponse>;
+    publishEntries: (entries: readonly ExecutionEntryModel[]) => void;
+    onWorkflowRestarted: () => void;
+}
+/**
+ * Schedules a drain whenever the inbox holds actionable entries. One pass
+ * runs at a time; a signal that lands mid-pass queues exactly one
+ * follow-up, so evidence arriving during a pass is never missed. The
+ * timer dies with `dispose()`, but an in-flight pass runs to completion —
+ * that is what carries the result POST across whatever tears the driver
+ * down.
+ */
+export declare class ExecutionDriver {
+    private readonly deps;
+    /** Per-driver on purpose: exhausted entries stay pending for the NEXT
+     *  connection's driver (re-POST is the designed recovery). */
+    private readonly attempts;
+    private passRunning;
+    private passQueued;
+    private timer;
+    private disposed;
+    constructor(deps: ExecutionDriverDeps);
+    /** Call with every published entries snapshot; each call resets the
+     *  pending timer, so the drain fires one quiet delay after the latest
+     *  evidence rather than racing a replay burst. */
+    noteEntriesChanged(entries: readonly ExecutionEntryModel[]): void;
+    dispose(): void;
+    private _drainInbox;
+    private _someDeliveryWasAttempted;
+    private _clearTimer;
+}
+//# sourceMappingURL=execution-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-driver.d.ts","sourceRoot":"","sources":["../../src/core/execution-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,8BAA8B,EAE/B,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAe9B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChD;6EACyE;IACzE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB,EAAE,MAAM,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAChE,WAAW,EAAE,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,cAAc,EAAE,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,KAAK,IAAI,CAAC;IAClE,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAYf;AAuQD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB;;oCAEgC;IAChC,UAAU,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxD,iBAAiB,EAAE,MAAM,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAChE,WAAW,EAAE,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7C,cAAc,EAAE,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,KAAK,IAAI,CAAC;IAClE,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IASd,OAAO,CAAC,QAAQ,CAAC,IAAI;IARjC;kEAC8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAS;gBAEI,IAAI,EAAE,mBAAmB;IAEtD;;sDAEkD;IAClD,kBAAkB,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI;IAmBjE,OAAO,IAAI,IAAI;YAKD,WAAW;IA0BzB,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,WAAW;CAMpB"}

package/dist/core/execution-driver.js

@@ -0,0 +1,315 @@
+import { readExecutedOutcome, recordExecutedOutcome, recordExecutionClaimed, } from "../persistence/execution-ledger.js";
+import { ServingApiError } from "../transport/serving-error.js";
+import { KIND_UNSUPPORTED_OUTCOME, MEMBER_ANSWERABLE_KINDS, } from "./execution-handlers.js";
+import { coworkerExecutionRequestOf, } from "./execution-inbox.js";
+import { MAX_DELIVERY_ATTEMPTS } from "./execution-kinds.js";
+// The driver that drains the execution inbox — the automatic half the
+// approval flow leaves to a human. Never inside an event callback: a
+// deferred pass lets a replay burst's own evidence (the receipt, the
+// gated call's result) close stale entries before anything acts, then a
+// REST read confirms the pause is genuinely open, the inbox claim takes
+// the entry, and the ledger makes the execution at-most-once even across
+// the remount a navigation causes.
+const EXECUTION_PASS_DELAY_MS = 400;
+// A failed POST retries on a slower cadence — the outcome is already in
+// the ledger, so only the delivery is being retried.
+const EXECUTION_RETRY_DELAY_MS = 2000;
+/**
+ * One drain of the inbox's pending entries. Exported so the pass logic
+ * unit-tests in node — the ExecutionDriver below is only a scheduler
+ * around it.
+ */
+export async function runExecutionPass(context) {
+    const eligible = eligibleEntriesOf(context.inbox.entries(), context.attempts);
+    if (eligible.length === 0) {
+        return;
+    }
+    const turns = await _theTurnsOrNull(context);
+    if (turns === null || turns.length === 0) {
+        return;
+    }
+    for (const entry of eligible) {
+        await _serveEntry(context, entry, turns);
+    }
+}
+function eligibleEntriesOf(entries, attempts) {
+    return entries.filter((entry) => entry.status.kind === "pending" &&
+        // A member-answerable kind (builtin.ask_questions) is never the
+        // driver's to serve: auto-answering it — even as unsupported —
+        // would withdraw the ask. Its entry stays pending for the member's
+        // own submit and closes on stream evidence like every entry.
+        !MEMBER_ANSWERABLE_KINDS.has(entry.kind) &&
+        (attempts.get(entry.interruptId) ?? 0) < MAX_DELIVERY_ATTEMPTS);
+}
+async function _serveEntry(context, entry, turns) {
+    const stored = readExecutedOutcome(context.threadId, entry.interruptId);
+    // The pause's holder is resolved across the WHOLE window, newest match
+    // first (there is no busy 409, so the answerable turn can sit
+    // behind QUEUED rows — "newest turn" is not "the pause").
+    const holder = _theTurnStillHoldingThisPause(turns, entry);
+    if (stored === null && holder === null) {
+        // REST is the acting authority, never the lifetime authority: the
+        // entry stays untouched and the stream's own evidence closes it.
+        return;
+    }
+    if (!context.inbox.beginExecution(entry.interruptId)) {
+        return;
+    }
+    context.publishEntries(context.inbox.entries());
+    const outcome = stored ?? (await _freshOutcomeOf(context, entry));
+    // A stored outcome with no live holder re-POSTs to the ORIGIN turn —
+    // the run the card came from — where the door's evidence arms
+    // (recorded_after_void / already_recorded) expect it; a queued newer
+    // member turn must never be guessed at (it would 409 and markRunStale
+    // would drop the executed result). The newest turn remains only the
+    // lost-capture fallback, backstopped by the door's own 409.
+    // THE PREMISE: a coworker's request has exactly ONE legal
+    // door — its dispatching turn. The door's coworker arms key on the
+    // coworker's ordinal across the whole thread and on the posted turn's
+    // own status, so a wrong turn is not backstopped by a 409 the way the
+    // assistant's newest-turn guess is: it can DELIVER under a pause that
+    // never asked, or record evidence under an unrelated run, and it would
+    // dodge the door's off-page refusal by naming an on-page turn. So a
+    // coworker's stored outcome re-POSTs to its dispatching turn or waits
+    // this pass — the entry stays pending; the row leaving paused delists it.
+    const target = holder ??
+        (entry.asker.kind === "coworker"
+            ? turns.find((turn) => turn.id === entry.turnId)
+            : (_theTurnOfThisEntriesRun(turns, entry) ?? turns.at(-1)));
+    if (target === undefined) {
+        // Reachable only for a coworker's stored outcome whose dispatching turn
+        // is off the fetched window. Every arm that returns an entry to pending
+        // without a delivery counts an attempt (tests/driver-retry-arms): the
+        // driver's next pass then rides the retry cadence and the cap parks the
+        // entry for the next connection — a bounded wait, never a spin.
+        _countDeliveryAttempt(context.attempts, entry.interruptId);
+        if (context.inbox.settlePostFailed(entry.interruptId)) {
+            context.publishEntries(context.inbox.entries());
+        }
+        return;
+    }
+    await _reportOutcome(context, entry, target.id, outcome);
+}
+function _theTurnStillHoldingThisPause(turns, entry) {
+    for (let index = turns.length - 1; index >= 0; index -= 1) {
+        const turn = turns[index];
+        if (_turnStillHoldsThisPause(turn, entry)) {
+            return turn;
+        }
+    }
+    return null;
+}
+function _theTurnOfThisEntriesRun(turns, entry) {
+    return turns.find((turn) => turn.run_id === entry.runId);
+}
+async function _freshOutcomeOf(context, entry) {
+    // Claimed in the ledger before the handler runs: a tab dying mid-handler
+    // must read back as unknown-outcome, never as unexecuted.
+    recordExecutionClaimed(context.threadId, entry.interruptId);
+    const handler = context.handlers.get(entry.kind);
+    const outcome = handler === undefined
+        ? KIND_UNSUPPORTED_OUTCOME
+        : await _outcomeNeverThrown(handler, entry);
+    recordExecutedOutcome(context.threadId, entry.interruptId, outcome);
+    return outcome;
+}
+async function _reportOutcome(context, entry, turnId, outcome) {
+    try {
+        const resolution = await context.postResults(turnId, {
+            results: [
+                {
+                    interrupt_id: entry.interruptId,
+                    ok: outcome.ok,
+                    ...(outcome.ok
+                        ? { result: outcome.result }
+                        : { error: { ...outcome.error } }),
+                    // Names the coworker for a report that lands after its row
+                    // settled — the door's evidence arm reads it.
+                    ...(entry.asker.kind === "coworker"
+                        ? { coworker_ordinal: entry.asker.ordinal }
+                        : {}),
+                },
+            ],
+        });
+        context.inbox.settleReported(entry.interruptId, outcome.ok);
+        // Delivery is asynchronous (the response's turn still says
+        // awaiting_input); on a live pause the stream's own resume closes the
+        // entry. A result that restarted a parked turn's workflow has no live
+        // stream to do that — reconnecting is what picks up the restarted run.
+        // The delivery field alone decides (the submit paths' law): a notice
+        // can accompany a DELIVERED restart too — the door pairs the
+        // oversize-drop notice with workflow_restarted — and skipping the
+        // reconnect there would freeze the transcript on the dead run.
+        if (resolution.delivery === "workflow_restarted") {
+            context.onWorkflowRestarted();
+        }
+    }
+    catch (error) {
+        if (_turnNoLongerAwaitingToolResults(error)) {
+            // Voided, settled, or answered elsewhere: the whole pause is over —
+            // or, for a coworker's request, that one request is.
+            if (entry.asker.kind === "coworker") {
+                context.inbox.markCoworkerRequestStale(entry.interruptId);
+            }
+            else {
+                context.inbox.markRunStale(entry.runId);
+            }
+        }
+        else {
+            // The POST failed, not the execution — pending again, and the next
+            // pass re-POSTs the stored outcome on the retry cadence.
+            _countDeliveryAttempt(context.attempts, entry.interruptId);
+            context.inbox.settlePostFailed(entry.interruptId);
+        }
+    }
+    finally {
+        context.publishEntries(context.inbox.entries());
+    }
+}
+async function _outcomeNeverThrown(handler, entry) {
+    try {
+        return await handler(entry);
+    }
+    catch (error) {
+        // Handlers shape their own failures; this catches only a handler bug,
+        // and the turn must still resume.
+        return {
+            ok: false,
+            error: {
+                code: "execution_failed",
+                message: "The page hit an unexpected error while performing this action. " +
+                    "Tell the user what was being attempted so they can do it " +
+                    `themselves. (${error instanceof Error ? error.message : String(error)})`,
+            },
+        };
+    }
+}
+async function _theTurnsOrNull(context) {
+    try {
+        // The whole newest window, not just the newest row: a
+        // message during a live turn QUEUES, so the turn holding the pause
+        // is not necessarily the newest one.
+        return (await context.fetchThreadDetail()).turns;
+    }
+    catch {
+        // A transient read failure: the entries stay pending and the next
+        // publish (or the next connection) schedules another pass.
+        return null;
+    }
+}
+function _turnStillHoldsThisPause(turn, entry) {
+    if (entry.asker.kind === "coworker") {
+        // A coworker's request is held by its DISPATCHING turn, whatever that
+        // turn's status (normally settled), for as long as the snapshot lists
+        // it — the coworker's row leaving paused is what delists it.
+        return (turn.id === entry.turnId &&
+            (turn.pending_coworker_executions ?? []).some((raw) => coworkerExecutionRequestOf(raw)?.card.interrupt_id ===
+                entry.interruptId));
+    }
+    const stillAnswerable = turn.status === "awaiting_input" || turn.status === "parked";
+    if (!stillAnswerable) {
+        return false;
+    }
+    // A null run_id is a lost capture — the server cannot locate the
+    // pause's cards either (pending_interrupt_ids reads empty), so the
+    // status gate alone holds and the door's own 409 backstops a stale
+    // guess.
+    if (turn.run_id === null) {
+        return true;
+    }
+    return (turn.run_id === entry.runId && _turnStillAwaitsThisInterrupt(turn, entry));
+}
+function _turnStillAwaitsThisInterrupt(turn, entry) {
+    // A replayed card from a superseded round must not act even though
+    // status and run still match. A server predating the field sends no
+    // array at all — that degrades to the status+run gate; an actual empty
+    // list means the pause moved on, so absent must never read as empty.
+    return (!Array.isArray(turn.pending_interrupt_ids) ||
+        turn.pending_interrupt_ids.includes(entry.interruptId));
+}
+function _turnNoLongerAwaitingToolResults(error) {
+    return (error instanceof ServingApiError &&
+        error.code === "ASSISTANT_TURN_NOT_AWAITING_TOOL_RESULTS");
+}
+function _countDeliveryAttempt(attempts, interruptId) {
+    attempts.set(interruptId, (attempts.get(interruptId) ?? 0) + 1);
+}
+/**
+ * Schedules a drain whenever the inbox holds actionable entries. One pass
+ * runs at a time; a signal that lands mid-pass queues exactly one
+ * follow-up, so evidence arriving during a pass is never missed. The
+ * timer dies with `dispose()`, but an in-flight pass runs to completion —
+ * that is what carries the result POST across whatever tears the driver
+ * down.
+ */
+export class ExecutionDriver {
+    deps;
+    /** Per-driver on purpose: exhausted entries stay pending for the NEXT
+     *  connection's driver (re-POST is the designed recovery). */
+    attempts = new Map();
+    passRunning = false;
+    passQueued = false;
+    timer = null;
+    disposed = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Call with every published entries snapshot; each call resets the
+     *  pending timer, so the drain fires one quiet delay after the latest
+     *  evidence rather than racing a replay burst. */
+    noteEntriesChanged(entries) {
+        if (this.disposed) {
+            return;
+        }
+        this._clearTimer();
+        const eligible = eligibleEntriesOf(entries, this.attempts);
+        if (eligible.length === 0) {
+            return;
+        }
+        this.timer = setTimeout(() => {
+            void this._drainInbox();
+        }, this._someDeliveryWasAttempted(eligible)
+            ? EXECUTION_RETRY_DELAY_MS
+            : EXECUTION_PASS_DELAY_MS);
+    }
+    dispose() {
+        this.disposed = true;
+        this._clearTimer();
+    }
+    async _drainInbox() {
+        if (this.passRunning) {
+            this.passQueued = true;
+            return;
+        }
+        this.passRunning = true;
+        try {
+            do {
+                this.passQueued = false;
+                await runExecutionPass({
+                    inbox: this.deps.inbox,
+                    threadId: this.deps.threadId,
+                    handlers: this.deps.handlersOf(),
+                    attempts: this.attempts,
+                    fetchThreadDetail: this.deps.fetchThreadDetail,
+                    postResults: this.deps.postResults,
+                    publishEntries: this.deps.publishEntries,
+                    onWorkflowRestarted: this.deps.onWorkflowRestarted,
+                });
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a timer firing mid-pass flips the flag during the await above
+            } while (this.passQueued);
+        }
+        finally {
+            this.passRunning = false;
+        }
+    }
+    _someDeliveryWasAttempted(eligible) {
+        return eligible.some((entry) => (this.attempts.get(entry.interruptId) ?? 0) > 0);
+    }
+    _clearTimer() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+}
+//# sourceMappingURL=execution-driver.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { ActionIntent } from "../contract/actions-adapter.js";
+import type { HttpIntentResult } from "../generated/models/index.js";
+import type { ExecutionEntryModel } from "./execution-inbox.js";
+export type ExecutionHandler = (entry: ExecutionEntryModel) => Promise<ExecutionOutcome>;
+/** How the host takes the visitor to an app-relative path. */
+export type HostNavigate = (path: string) => void | Promise<void>;
+/** How the provider's wired adapter executes one action intent. */
+export type ExecuteActionIntent = (intent: ActionIntent) => Promise<HttpIntentResult>;
+export { ASK_QUESTIONS_REQUEST_KIND, HIGHLIGHT_REQUEST_KIND, HTTP_INTENT_REQUEST_KIND, KIND_UNSUPPORTED_OUTCOME, MEMBER_ANSWERABLE_KINDS, NAVIGATE_REQUEST_KIND, PREFILL_FORM_REQUEST_KIND, READ_PAGE_REQUEST_KIND, type ExecutionOutcome, } from "./execution-kinds.js";
+import { type ExecutionOutcome } from "./execution-kinds.js";
+/**
+ * The registry of kinds this mount can serve. A host that wired no
+ * navigation hookup or actions adapter simply has no handler for that
+ * kind — the driver answers the request with KIND_UNSUPPORTED_OUTCOME,
+ * same as any kind this package has never heard of. read_page,
+ * highlight, and prefill_form need no hookup at all: the package
+ * operates on the page it is mounted in, so their handlers are always
+ * present. threadId keys the reader's diff baseline —
+ * the per-thread memory lives at module level in the reader, because
+ * this map's identity churns with its React deps.
+ */
+export declare function executionHandlersFor(navigate: HostNavigate | null, executeActionIntent: ExecuteActionIntent | null, threadId: string): ReadonlyMap<string, ExecutionHandler>;
+//# sourceMappingURL=execution-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-handlers.d.ts","sourceRoot":"","sources":["../../src/core/execution-handlers.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAOnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAcrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,mBAAmB,KACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG,CAChC,MAAM,EAAE,YAAY,KACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAS/B,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAwE9B;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,EAC/C,QAAQ,EAAE,MAAM,GACf,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAsBvC"}