@archmax-ai/harness 0.9.0 → 1.0.0

package/dist/lifecycle/runner.d.ts

@@ -1,197 +0,0 @@
-import type { RunnableConfig } from "@langchain/core/runnables";
-import type { StructuredTool } from "@langchain/core/tools";
-import { type ScriptExecutor, type ScriptOutcome } from "../sandbox/executor.js";
-import type { WorkflowMachine } from "../machine/machine.js";
-import type { Hook } from "../machine/types.js";
-import { type Rubric } from "../rubrics/rubrics.js";
-import type { VariableStore } from "../machine/variables.js";
-import type { VisitSpan } from "../workflow/visits.js";
-import { type WorkflowEventHandler } from "../core/events.js";
-export type LifecycleVerdict = "ok" | "correct" | "veto";
-/** What a hook said, once its return value has been read. */
-export interface LifecycleDecision {
-    verdict: LifecycleVerdict;
-    reason: string;
-    rubric?: string;
-}
-/**
- * Interpret a lifecycle hook's return value into a decision, an error, or
- * `null` (no opinion — proceed).
- *
- * **One contract for every hook kind**, the one `HookResult` declares: a verdict
- * object decides, a bare `false` vetoes, returning nothing is `ok`, and any
- * *other* object fails closed with its keys named. A hook's return value is its
- * verdict and nothing else, so an object that is not one is a verdict its author
- * got wrong; reading it as `ok` would silently permit what the hook meant to
- * block, with nothing said.
- *
- * A **script** hook's value arrives already reduced — the sandbox wrapper
- * applies the same rules and throws on the last one — so what reaches here from
- * a script is a verdict or an error outcome. The rules are restated because a
- * custom `hookExecutors` kind hands its value through raw, and a consumer's
- * executor is held to the same contract as a script: one governance vocabulary,
- * whoever implements the kind.
- */
-export declare function parseLifecycleDecision(outcome: ScriptOutcome): LifecycleDecision | {
-    error: string;
-} | null;
-export interface LifecycleContext {
-    sessionId: string;
-    tools: StructuredTool[];
-    /** The session's whole transcript. */
-    messages: unknown[];
-    /** Its visits, in order; the last is the one a hook sees. Absent, the whole transcript is one visit. */
-    visits?: VisitSpan[];
-    taskTool?: StructuredTool;
-    config: RunnableConfig;
-    /**
-     * Grade-and-retry iterations already spent, keyed per hook by
-     * {@link iterationKey} — not per state. Two `after` hooks on one state have
-     * independent budgets, and a hook that passes cannot clear the count of the
-     * one still asking for corrections (issue #62).
-     */
-    iterations: Record<string, number>;
-    /**
-     * The trigger that started the run (`id` + optional `args`), read from
-     * checkpointed state. Merged into every hook's script arguments so a
-     * `before`/`after` script can read how the run began.
-     */
-    trigger?: {
-        id: string;
-    };
-    /**
-     * The run's variables at the time the hook runs, as a plain `name → value`
-     * map. Read-only by construction: the sandbox gets a serialized copy. A hook
-     * that could *write* variables would be editing the governance inputs of the
-     * state it judges, which is why the variable tools are excluded from PTC.
-     */
-    variables?: Record<string, unknown>;
-    /**
-     * The same variables as the checkpointed **store** — value plus lock state —
-     * for the kernel's `requires` gate. Must be the run's real store: omitted, the
-     * kernel sees an empty store and refuses to leave any state that declares
-     * `requires`.
-     */
-    variableStore?: VariableStore;
-    /**
-     * The abort signal of the turn the hook runs in, read where the hook runs,
-     * not `config`'s, which is captured at the session's last model call. Once it
-     * aborts, a script hook's eval settles with an error and its calls are refused.
-     */
-    signal?: AbortSignal;
-}
-/**
- * A phase rejection: why the hook phase blocked, and whether the failure is
- * **terminal** — a hook execution error or an exhausted correction budget,
- * which retrying in place cannot fix (the turn ends rejected, subject to
- * `on_error` routing) — as opposed to a recoverable rejection (a deliberate
- * veto or a correction with attempts remaining), where the agent stays in the
- * state to try again.
- */
-export interface PhaseRejection {
-    reason: string;
-    terminal: boolean;
-}
-/**
- * The result of {@link LifecycleRunner.attemptTransition}: whether the
- * transition passed its hooks, and the resulting judge-correction counts for
- * the caller to commit to the checkpoint. Correction counts advance even on a
- * rejection (a consumed judge correction), so they are returned in both cases.
- * `terminal` marks a rejection retrying cannot fix (see {@link PhaseRejection}).
- */
-export type TransitionOutcome = {
-    ok: true;
-    from: string;
-    to: string;
-    corrections: Record<string, number>;
-} | {
-    ok: false;
-    reason: string;
-    terminal: boolean;
-    corrections: Record<string, number>;
-};
-/**
- * Executes one lifecycle hook of a given kind, returning the raw
- * {@link ScriptOutcome} the runner reduces (parse → kernel verdict → events), so
- * every hook kind flows through the same fail-closed path. `script` and
- * `rubric` are built in; consumers register additional kinds via
- * `createAgent`'s `hookExecutors` option. An executor that throws or returns an
- * error outcome vetoes the transition.
- */
-export type HookExecutor = (hook: Hook, ctx: LifecycleContext, args: Record<string, unknown>) => Promise<ScriptOutcome>;
-/**
- * Resolves a hook's declared `script:` value to the authoring-plane path its
- * source lives at, or refuses it with a reason (see `resolveHookScript`).
- */
-export type HookScriptResolver = (declared: string) => {
-    ok: true;
-    path: string;
-} | {
-    ok: false;
-    reason: string;
-};
-/** The built-in hook kinds, which consumer executors may not shadow. */
-export declare const BUILTIN_HOOK_KINDS: readonly ["script", "rubric"];
-/**
- * Runs deterministic `before`/`after` hooks (scripts or grading rubrics) at the
- * machine's fixed points, in the same backend-backed interpreter as the model's
- * own sandbox tool calls.
- */
-export declare class LifecycleRunner {
-    private readonly machine;
-    private readonly executor;
-    private readonly rubrics;
-    private readonly ptcNames;
-    private readonly emit;
-    /** Hook kind → executor. Built-ins (`script`, `rubric`) plus registered custom kinds. */
-    private readonly hookExecutors;
-    /**
-     * Maps a hook's declared `script:` value to the path its source is read from.
-     * Injected so the runner stays ignorant of workspace layout: the harness binds
-     * it to the running workflow (workflow-relative, confined to `hooks/`). The
-     * identity default keeps a bare runner working.
-     */
-    private readonly resolveScript;
-    /**
-     * Per session: the `toolCalls` host function its hooks' sandbox was handed
-     * (a sandbox keeps its first tools, and a call carries no session), and the
-     * context of the hook running now, which that function reads. A session's
-     * hooks run one at a time.
-     */
-    private readonly toolCallQueries;
-    private readonly hookContexts;
-    /** Deprecations already reported — each is said once per assembly. */
-    constructor(machine: WorkflowMachine, executor: ScriptExecutor, rubrics: Map<string, Rubric>, ptcNames: string[], hookExecutors?: Record<string, HookExecutor>, onEvent?: WorkflowEventHandler, opts?: {
-        resolveScript?: HookScriptResolver;
-    });
-    resolvePtcTools(allTools: unknown[]): StructuredTool[];
-    /**
-     * The runtime's own dispatch for an inline grader, through the framework
-     * `task` tool. Reached only by {@link runRubric} — never wired into a script's
-     * sandbox, which has no name to dispatch by.
-     */
-    private rubricDispatch;
-    private runScript;
-    private runRubric;
-    /**
-     * Dispatch a single tagged hook through its kind's registered executor.
-     * An unknown kind (no registered executor) produces an error outcome that
-     * reduces to a fail-closed veto — the same path as any hook execution error.
-     */
-    private runHook;
-    private applyDecision;
-    runPhase(state: string, phase: "before" | "after", ctx: LifecycleContext, extraArgs?: Record<string, unknown>, veto?: boolean): Promise<PhaseRejection | null>;
-    private runSingleHook;
-    attemptTransition(from: string, to: string, ctx: LifecycleContext, reason?: string, 
-    /**
-     * The tool call driving this attempt, when one is. Carried onto the `advance`
-     * event so a consumer can attribute the transition to the call that made it;
-     * a transition the runtime itself performs passes nothing.
-     */
-    options?: {
-        callId?: string;
-    }): Promise<TransitionOutcome>;
-    dispose(sessionId: string): void;
-    /** The session's `toolCalls` host function, answering from the hook context running now. */
-    private toolCallQuery;
-}

package/dist/lifecycle/runner.js

@@ -1,419 +0,0 @@
-import { tool } from "langchain";
-import { z } from "zod";
-import { runContextFromMessages } from "../core/messages.js";
-import { createSubagentBridgeDispatch } from "../sandbox/bridge.js";
-import { PROCESS_SESSION, } from "../sandbox/executor.js";
-import { resolvePtcTools } from "../sandbox/tools.js";
-import { afterHookLabel, hookKind, hookMaxIterations, iterationKey } from "./hook-shape.js";
-import { queryToolCalls } from "./tool-calls.js";
-import { hookTranscript } from "./transcript.js";
-import { buildRubricTaskDescription, isRubricVerdict, resolveRubricResponseFormat, rubricId, } from "../rubrics/rubrics.js";
-import { TOOL_CALLS_QUERY } from "../machine/tool-names.js";
-import { releaseScopes } from "../sessions/scope.js";
-import { createWorkflowEventEmitter, } from "../core/events.js";
-import { decide, reduceHookFact } from "../kernel/kernel.js";
-/**
- * Interpret a lifecycle hook's return value into a decision, an error, or
- * `null` (no opinion — proceed).
- *
- * **One contract for every hook kind**, the one `HookResult` declares: a verdict
- * object decides, a bare `false` vetoes, returning nothing is `ok`, and any
- * *other* object fails closed with its keys named. A hook's return value is its
- * verdict and nothing else, so an object that is not one is a verdict its author
- * got wrong; reading it as `ok` would silently permit what the hook meant to
- * block, with nothing said.
- *
- * A **script** hook's value arrives already reduced — the sandbox wrapper
- * applies the same rules and throws on the last one — so what reaches here from
- * a script is a verdict or an error outcome. The rules are restated because a
- * custom `hookExecutors` kind hands its value through raw, and a consumer's
- * executor is held to the same contract as a script: one governance vocabulary,
- * whoever implements the kind.
- */
-export function parseLifecycleDecision(outcome) {
-    if (!outcome.ok)
-        return { error: outcome.error?.message ?? "script error" };
-    const value = outcome.value;
-    if (isRubricVerdict(value)) {
-        return {
-            verdict: value.verdict,
-            reason: value.reason,
-            ...(value.rubric !== undefined ? { rubric: value.rubric } : {}),
-        };
-    }
-    if (value === false)
-        return { verdict: "veto", reason: "precondition not met" };
-    if (value !== null && typeof value === "object") {
-        return {
-            error: `hook returned ${describeNonVerdict(value)}, which is not a verdict — return ` +
-                `{ verdict: "ok" | "correct" | "veto", reason }, false, or nothing at all`,
-        };
-    }
-    return null;
-}
-/**
- * Name a non-verdict object by its keys, never its values, so a diagnostic
- * cannot leak what the hook was inspecting. Mirrors `__hookShape` in the
- * sandbox prelude, which does the same for a script hook.
- */
-function describeNonVerdict(value) {
-    if (Array.isArray(value))
-        return "an array";
-    const keys = Object.keys(value);
-    if (keys.length === 0)
-        return "an object with no keys";
-    const shown = keys
-        .slice(0, 6)
-        .map((key) => `'${key}'`)
-        .join(", ");
-    return `an object with ${keys.length > 6 ? "keys including " : "keys "}${shown}`;
-}
-/** The built-in hook kinds, which consumer executors may not shadow. */
-export const BUILTIN_HOOK_KINDS = ["script", "rubric"];
-/** Short raw-output excerpt surfaced when a judge response cannot be parsed. */
-function snippet(value) {
-    let text;
-    try {
-        text = typeof value === "string" ? value : JSON.stringify(value);
-    }
-    catch {
-        text = String(value);
-    }
-    if (text === undefined || text === "undefined")
-        text = "(no output)";
-    return text.length > 200 ? `${text.slice(0, 200)}…` : text;
-}
-/**
- * Runs deterministic `before`/`after` hooks (scripts or grading rubrics) at the
- * machine's fixed points, in the same backend-backed interpreter as the model's
- * own sandbox tool calls.
- */
-export class LifecycleRunner {
-    machine;
-    executor;
-    rubrics;
-    ptcNames;
-    emit;
-    /** Hook kind → executor. Built-ins (`script`, `rubric`) plus registered custom kinds. */
-    hookExecutors;
-    /**
-     * Maps a hook's declared `script:` value to the path its source is read from.
-     * Injected so the runner stays ignorant of workspace layout: the harness binds
-     * it to the running workflow (workflow-relative, confined to `hooks/`). The
-     * identity default keeps a bare runner working.
-     */
-    resolveScript;
-    /**
-     * Per session: the `toolCalls` host function its hooks' sandbox was handed
-     * (a sandbox keeps its first tools, and a call carries no session), and the
-     * context of the hook running now, which that function reads. A session's
-     * hooks run one at a time.
-     */
-    toolCallQueries = new Map();
-    hookContexts = new Map();
-    /** Deprecations already reported — each is said once per assembly. */
-    constructor(machine, executor, rubrics, ptcNames, hookExecutors, onEvent, opts = {}) {
-        this.machine = machine;
-        this.executor = executor;
-        this.rubrics = rubrics;
-        this.ptcNames = ptcNames;
-        this.emit = createWorkflowEventEmitter(onEvent);
-        this.resolveScript = opts.resolveScript ?? ((declared) => ({ ok: true, path: declared }));
-        // Built-ins first; consumer executors add kinds alongside them (built-ins
-        // are non-shadowable, enforced at assembly).
-        this.hookExecutors = new Map([
-            ["script", (hook, ctx, args) => this.runScript(String(hook.script), ctx, args)],
-        ]);
-        for (const [kind, exec] of Object.entries(hookExecutors ?? {})) {
-            this.hookExecutors.set(kind, exec);
-        }
-    }
-    resolvePtcTools(allTools) {
-        return resolvePtcTools(allTools, this.ptcNames);
-    }
-    /**
-     * The runtime's own dispatch for an inline grader, through the framework
-     * `task` tool. Reached only by {@link runRubric} — never wired into a script's
-     * sandbox, which has no name to dispatch by.
-     */
-    rubricDispatch(ctx, lifecycleArgs) {
-        if (!ctx.taskTool)
-            return undefined;
-        const base = createSubagentBridgeDispatch(ctx.taskTool, ctx.config, {
-            emit: this.emit,
-            ...(typeof lifecycleArgs.state === "string" ? { state: lifecycleArgs.state } : {}),
-        });
-        return async (input) => {
-            const rubric = this.rubrics.get(input.subagentType);
-            const description = input.description?.trim() ||
-                buildRubricTaskDescription({ ...lifecycleArgs, ...runContextFromMessages(ctx.messages, visitStartOf(ctx)) });
-            const responseSchema = input.responseSchema ?? (rubric ? resolveRubricResponseFormat(rubric) : undefined);
-            return base({
-                description,
-                subagentType: input.subagentType,
-                ...(responseSchema !== undefined
-                    ? { responseSchema: responseSchema }
-                    : {}),
-            });
-        };
-    }
-    async runScript(script, ctx, args) {
-        // A hook that cannot be placed is a hook that cannot be trusted: refusing
-        // here produces an error outcome, and an errored hook vetoes fail-closed —
-        // the same posture as a hook that throws.
-        const resolved = this.resolveScript(script);
-        if (!resolved.ok) {
-            return {
-                ok: false,
-                value: undefined,
-                logs: [],
-                error: { message: resolved.reason },
-                formatted: `error: ${resolved.reason}`,
-            };
-        }
-        this.hookContexts.set(ctx.sessionId, ctx);
-        return this.executor.runFile(resolved.path, {
-            sessionId: ctx.sessionId,
-            sessionNamespace: PROCESS_SESSION,
-            args,
-            tools: [...ctx.tools, this.toolCallQuery(ctx.sessionId)],
-            // No `task()` for a script hook: an inline rubric has no name a script
-            // could pass, so there is nothing to dispatch by. A script that wants a
-            // model verdict gets a `rubric` hook declared beside it in the same list.
-            lifecycle: true,
-            ...(ctx.signal ? { signal: ctx.signal } : {}),
-        });
-    }
-    async runRubric(name, ctx, args) {
-        const dispatch = this.rubricDispatch(ctx, args);
-        if (!dispatch) {
-            const message = `rubric '${name}' could not be dispatched (no task tool)`;
-            return { ok: false, value: undefined, logs: [], error: { message }, formatted: `error: ${message}` };
-        }
-        const rubric = this.rubrics.get(name);
-        const responseSchema = rubric ? resolveRubricResponseFormat(rubric) : undefined;
-        try {
-            const value = await dispatch({
-                subagentType: name,
-                // The grader's payload keeps the compact `userRequest`/`history` view a
-                // rubric's `instructions` are written against.
-                description: buildRubricTaskDescription({ ...args, ...runContextFromMessages(ctx.messages, visitStartOf(ctx)) }),
-                ...(responseSchema !== undefined ? { responseSchema } : {}),
-            });
-            // Fail closed on unreadable grader output, exactly like a thrown error: a
-            // grader whose verdict cannot be read has approved nothing.
-            const verdict = value && typeof value === "object" && isRubricVerdict(value)
-                ? { ...value, rubric: name }
-                : {
-                    verdict: "veto",
-                    reason: `rubric '${name}' returned no parseable verdict: ${snippet(value)}`,
-                    rubric: name,
-                };
-            return { ok: true, value: verdict, logs: [], formatted: JSON.stringify(verdict) };
-        }
-        catch (err) {
-            const message = err.message ?? String(err);
-            return { ok: false, value: undefined, logs: [], error: { message }, formatted: `error: ${message}` };
-        }
-    }
-    /**
-     * Dispatch a single tagged hook through its kind's registered executor.
-     * An unknown kind (no registered executor) produces an error outcome that
-     * reduces to a fail-closed veto — the same path as any hook execution error.
-     */
-    async runHook(hook, ctx, args, at) {
-        const kind = hookKind(hook);
-        // `rubric` is serviced here rather than through the executor map, because
-        // dispatching an inline grader needs the hook's *position* — that is the id
-        // the runtime registered it under, and a `HookExecutor` sees only the hook.
-        // The kind is still non-shadowable: assembly checks `BUILTIN_HOOK_KINDS`.
-        if (kind === "rubric") {
-            return this.runRubric(rubricId(at.state, at.phase, at.index), ctx, args);
-        }
-        const executor = kind ? this.hookExecutors.get(kind) : undefined;
-        if (!executor) {
-            const message = kind
-                ? `no executor registered for hook kind '${kind}'`
-                : `malformed hook (expected a single-key tagged object)`;
-            return { ok: false, value: undefined, logs: [], error: { message }, formatted: `error: ${message}` };
-        }
-        return executor(hook, ctx, args);
-    }
-    applyDecision(state, label, decision, ctx, opts) {
-        this.emit({
-            type: "hook-verdict",
-            state,
-            phase: opts.phase,
-            label,
-            verdict: decision.verdict,
-            reason: decision.reason,
-        });
-        const budget = iterationKey(state, opts.phase, opts.index);
-        const used = ctx.iterations[budget] ?? 0;
-        // Iteration budget, uniform across hook kinds: the hook-level
-        // `max_iterations` sidecar wins (it describes *this* state's retry loop); a
-        // rubric hook falls back to the rubric's own `max_iterations`; otherwise 0
-        // (a `correct` hard-vetoes).
-        const rubric = decision.rubric ? this.rubrics.get(decision.rubric) : undefined;
-        const maxIterations = opts.maxIterations ?? rubric?.max_iterations ?? 0;
-        // The reduction rule lives in the decision kernel; the runner only executes
-        // hooks and applies the verdict (correction bookkeeping + events).
-        const verdict = reduceHookFact({ ...decision, maxIterations, iterationsUsed: used }, { phase: opts.phase, veto: opts.veto, to: opts.to });
-        if (verdict.decision === "block") {
-            if (verdict.correctionConsumed)
-                ctx.iterations[budget] = used + 1;
-            const reason = verdict.reason ?? decision.reason;
-            this.emit({ type: "hook-rejected", state, phase: opts.phase, reason });
-            // Exhausted iteration budget (after-phase correction flow only) cannot be
-            // fixed by retrying in place; a deliberate veto, an in-budget correction,
-            // or a before-phase rejection can. The kernel decides which this is, from
-            // the same reduction that wrote the reason.
-            return { reason, terminal: verdict.budgetExhausted === true };
-        }
-        // Only this hook's own budget is released: a passing hook ahead of a
-        // correcting one must not hand the latter a fresh budget every attempt.
-        delete ctx.iterations[budget];
-        return null;
-    }
-    async runPhase(state, phase, ctx, extraArgs, veto = false) {
-        const hooks = this.machine.lifecycleHooks()[state];
-        const list = phase === "before" ? hooks?.before : hooks?.after;
-        if (!list || list.length === 0)
-            return null;
-        // The hook input (`HookArgs` in the sandbox): the trigger reaches a hook as
-        // its bare id — a run's *input* lives in `variables` — and the transcript as
-        // plain messages.
-        const scriptArgs = {
-            state,
-            phase,
-            ...(ctx.trigger ? { trigger: ctx.trigger.id } : {}),
-            variables: ctx.variables ?? {},
-            messages: hookTranscript(visitMessages(ctx)),
-            ...extraArgs,
-        };
-        const to = typeof extraArgs?.to === "string" ? extraArgs.to : undefined;
-        // Run hooks in declaration order, short-circuiting on the first that fails.
-        // The index travels: an inline rubric has no name, so its position in this
-        // list is its identity — for dispatch and for its own retry budget.
-        for (const [index, hook] of list.entries()) {
-            const reject = await this.runSingleHook(state, phase, hook, ctx, scriptArgs, { veto, to, index });
-            if (reject)
-                return reject;
-        }
-        return null;
-    }
-    async runSingleHook(state, phase, hook, ctx, scriptArgs, opts) {
-        const label = afterHookLabel(hook, opts.index);
-        this.emit({ type: "hook-start", state, phase, label });
-        const outcome = await this.runHook(hook, ctx, scriptArgs, {
-            state,
-            phase,
-            index: opts.index,
-        });
-        for (const line of outcome.logs) {
-            if (line.trim()) {
-                this.emit({ type: "hook-output", state, line: line.trimEnd() });
-            }
-        }
-        const parsed = parseLifecycleDecision(outcome);
-        if (parsed && "error" in parsed) {
-            this.emit({ type: "hook-rejected", state, phase, reason: parsed.error });
-            // A hook that could not execute is a terminal failure: retrying the
-            // same turn re-runs the same broken hook.
-            return { reason: parsed.error, terminal: true };
-        }
-        if (!parsed) {
-            if (phase === "before") {
-                this.emit({ type: "hook-passed", state, phase });
-            }
-            return null;
-        }
-        const maxIterations = hookMaxIterations(hook);
-        return this.applyDecision(state, label, parsed, ctx, {
-            phase,
-            veto: opts.veto,
-            to: opts.to,
-            index: opts.index,
-            ...(maxIterations !== undefined ? { maxIterations } : {}),
-        });
-    }
-    async attemptTransition(from, to, ctx, reason, 
-    /**
-     * The tool call driving this attempt, when one is. Carried onto the `advance`
-     * event so a consumer can attribute the transition to the call that made it;
-     * a transition the runtime itself performs passes nothing.
-     */
-    options) {
-        // Work on a copy of the correction counts so the attempt never mutates the
-        // caller's context; the resulting counts are returned for the caller to
-        // commit to the checkpoint.
-        const corrections = { ...ctx.iterations };
-        const localCtx = { ...ctx, iterations: corrections };
-        // Edge validity is a pure, statically-decidable rule — route it through the
-        // decision kernel so runtime and `agent validate` agree. Hook reduction runs
-        // per-hook inside `runPhase` (also kernel-backed via `applyDecision`).
-        const edgeVerdict = decide(this.machine, { kind: "transition", from, to, hookFacts: [] }, [], undefined, ctx.variableStore ?? {});
-        if (edgeVerdict.decision === "block") {
-            return {
-                ok: false,
-                reason: edgeVerdict.reason ?? `cannot advance from '${from}' to '${to}'.`,
-                // An invalid edge is always recoverable: the agent picks a valid target.
-                terminal: false,
-                corrections,
-            };
-        }
-        const trimmedReason = reason?.trim();
-        const afterReject = await this.runPhase(from, "after", localCtx, { from, to, ...(trimmedReason ? { reason: trimmedReason } : {}) }, true);
-        if (afterReject) {
-            return { ok: false, reason: afterReject.reason, terminal: afterReject.terminal, corrections };
-        }
-        const beforeReject = await this.runPhase(to, "before", localCtx);
-        if (beforeReject) {
-            return { ok: false, reason: beforeReject.reason, terminal: beforeReject.terminal, corrections };
-        }
-        this.emit({
-            type: "advance",
-            from,
-            to,
-            ...(trimmedReason ? { reason: trimmedReason } : {}),
-            ...(options?.callId ? { callId: options.callId } : {}),
-        });
-        return { ok: true, from, to, corrections };
-    }
-    dispose(sessionId) {
-        this.executor.dispose(sessionId, PROCESS_SESSION);
-        releaseScopes(this.toolCallQueries, sessionId);
-        releaseScopes(this.hookContexts, sessionId);
-    }
-    /** The session's `toolCalls` host function, answering from the hook context running now. */
-    toolCallQuery(sessionId) {
-        let query = this.toolCallQueries.get(sessionId);
-        if (!query) {
-            query = tool(async (filter) => {
-                const ctx = this.hookContexts.get(sessionId);
-                return JSON.stringify(ctx ? queryToolCalls(ctx.messages, ctx.visits ?? [], filter) : []);
-            }, { name: TOOL_CALLS_QUERY, description: "The session's tool calls, for a hook.", schema: toolCallFilterSchema });
-            this.toolCallQueries.set(sessionId, query);
-        }
-        return query;
-    }
-}
-/** A hook's `toolCalls` filter; an unknown key is refused, so a misspelt one never matches everything. */
-const toolCallFilterSchema = z
-    .object({
-    name: z.string().optional(),
-    state: z.string().optional(),
-    visit: z.union([z.number().int().positive(), z.literal("current")]).optional(),
-    status: z.enum(["completed", "pending", "failed", "rejected"]).optional(),
-    last: z.number().int().positive().optional(),
-})
-    .strict();
-/** Where the visit a hook sees begins: the last of the context's visits. */
-function visitStartOf(ctx) {
-    return ctx.visits?.at(-1)?.start ?? 0;
-}
-/** The messages of the visit a hook sees. */
-function visitMessages(ctx) {
-    return ctx.messages.slice(visitStartOf(ctx));
-}
-//# sourceMappingURL=runner.js.map

package/dist/lifecycle/runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/lifecycle/runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACL,eAAe,GAGhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,2BAA2B,EAC3B,QAAQ,GAET,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,0BAA0B,GAG3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAW7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAsB;IAEtB,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,cAAc,EAAE,CAAC;IAE5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAChF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO;YACL,KAAK,EACH,iBAAiB,kBAAkB,CAAC,KAAK,CAAC,oCAAoC;gBAC9E,0EAA0E;SAC7E,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI;SACf,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC;SACxB,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,kBAAkB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;AACnF,CAAC;AA4FD,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEhE,gFAAgF;AAChF,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,WAAW;QAAE,IAAI,GAAG,aAAa,CAAC;IACrE,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAuBP;IACA;IACA;IACA;IAzBF,IAAI,CAAuB;IAC5C,yFAAyF;IACxE,aAAa,CAA4B;IAE1D;;;;;OAKG;IACc,aAAa,CAAqB;IACnD;;;;;OAKG;IACc,eAAe,GAAG,IAAI,GAAG,EAA0B,CAAC;IACpD,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;IACpE,sEAAsE;IAEtE,YACmB,OAAwB,EACxB,QAAwB,EACxB,OAA4B,EAC5B,QAAkB,EACnC,aAA4C,EAC5C,OAA8B,EAC9B,OAA+C,EAAE;QANhC,YAAO,GAAP,OAAO,CAAiB;QACxB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,YAAO,GAAP,OAAO,CAAqB;QAC5B,aAAQ,GAAR,QAAQ,CAAU;QAKnC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1F,0EAA0E;QAC1E,6CAA6C;QAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAuB;YACjD,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAE,IAA+B,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;SAC5G,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,eAAe,CAAC,QAAmB;QACjC,OAAO,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,GAAqB,EAAE,aAAsC;QAClF,IAAI,CAAC,GAAG,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QACpC,MAAM,IAAI,GAAG,4BAA4B,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;YAClE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,OAAO,aAAa,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF,CAAC,CAAC;QACH,OAAO,KAAK,EAAE,KAA+E,EAAE,EAAE;YAC/F,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACpD,MAAM,WAAW,GACf,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE;gBACzB,0BAA0B,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/G,MAAM,cAAc,GAClB,KAAK,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC;gBACV,WAAW;gBACX,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,GAAG,CAAC,cAAc,KAAK,SAAS;oBAC9B,CAAC,CAAC,EAAE,cAAc,EAAE,cAAyC,EAAE;oBAC/D,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,MAAc,EACd,GAAqB,EACrB,IAA6B;QAE7B,0EAA0E;QAC1E,2EAA2E;QAC3E,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,EAAE;gBACR,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE;gBACnC,SAAS,EAAE,UAAU,QAAQ,CAAC,MAAM,EAAE;aACvC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC1C,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,gBAAgB,EAAE,eAAe;YACjC,IAAI;YACJ,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxD,uEAAuE;YACvE,wEAAwE;YACxE,0EAA0E;YAC1E,SAAS,EAAE,IAAI;YACf,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,IAAY,EACZ,GAAqB,EACrB,IAA6B;QAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,WAAW,IAAI,0CAA0C,CAAC;YAC1E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QACvG,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC;gBAC3B,YAAY,EAAE,IAAI;gBAClB,wEAAwE;gBACxE,+CAA+C;gBAC/C,WAAW,EAAE,0BAA0B,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAChH,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D,CAAC,CAAC;YACH,0EAA0E;YAC1E,4DAA4D;YAC5D,MAAM,OAAO,GACX,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,eAAe,CAAC,KAAK,CAAC;gBAC1D,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;gBAC5B,CAAC,CAAC;oBACE,OAAO,EAAE,MAAe;oBACxB,MAAM,EAAE,WAAW,IAAI,oCAAoC,OAAO,CAAC,KAAK,CAAC,EAAE;oBAC3E,MAAM,EAAE,IAAI;iBACb,CAAC;YACR,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACpF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAI,GAAa,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;YACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QACvG,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,OAAO,CACnB,IAAU,EACV,GAAqB,EACrB,IAA6B,EAC7B,EAA+D;QAE/D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,0EAA0E;QAC1E,4EAA4E;QAC5E,4EAA4E;QAC5E,0EAA0E;QAC1E,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,IAAI;gBAClB,CAAC,CAAC,yCAAyC,IAAI,GAAG;gBAClD,CAAC,CAAC,sDAAsD,CAAC;YAC3D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QACvG,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAEO,aAAa,CACnB,KAAa,EACb,KAAa,EACb,QAA2B,EAC3B,GAAqB,EACrB,IAAsG;QAEtG,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,cAAc;YACpB,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,8DAA8D;QAC9D,4EAA4E;QAC5E,2EAA2E;QAC3E,6BAA6B;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,MAAM,EAAE,cAAc,IAAI,CAAC,CAAC;QACxE,4EAA4E;QAC5E,mEAAmE;QACnE,MAAM,OAAO,GAAG,cAAc,CAC5B,EAAE,GAAG,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE,EACpD,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CACpD,CAAC;QACF,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,kBAAkB;gBAAE,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACvE,0EAA0E;YAC1E,0EAA0E;YAC1E,0EAA0E;YAC1E,4CAA4C;YAC5C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QAChE,CAAC;QACD,qEAAqE;QACrE,wEAAwE;QACxE,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,KAAa,EACb,KAAyB,EACzB,GAAqB,EACrB,SAAmC,EACnC,IAAI,GAAG,KAAK;QAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC;QAC/D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5C,4EAA4E;QAC5E,6EAA6E;QAC7E,kBAAkB;QAClB,MAAM,UAAU,GAAG;YACjB,KAAK;YACL,KAAK;YACL,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;YAC9B,QAAQ,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YAC5C,GAAG,SAAS;SACb,CAAC;QACF,MAAM,EAAE,GAAG,OAAO,SAAS,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAExE,4EAA4E;QAC5E,2EAA2E;QAC3E,oEAAoE;QACpE,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAClG,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,KAAa,EACb,KAAyB,EACzB,IAAU,EACV,GAAqB,EACrB,UAAmC,EACnC,IAAmD;QAEnD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAEvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE;YACxD,KAAK;YACL,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACzE,oEAAoE;YACpE,0CAA0C;YAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;YACnD,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,IAAY,EACZ,EAAU,EACV,GAAqB,EACrB,MAAe;IACf;;;;OAIG;IACH,OAA6B;QAE7B,2EAA2E;QAC3E,wEAAwE;QACxE,4BAA4B;QAC5B,MAAM,WAAW,GAAG,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAqB,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;QAEvE,4EAA4E;QAC5E,6EAA6E;QAC7E,uEAAuE;QACvE,MAAM,WAAW,GAAG,MAAM,CACxB,IAAI,CAAC,OAAO,EACZ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAC/C,EAAE,EACF,SAAS,EACT,GAAG,CAAC,aAAa,IAAI,EAAE,CACxB,CAAC;QACF,IAAI,WAAW,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,wBAAwB,IAAI,SAAS,EAAE,IAAI;gBACzE,yEAAyE;gBACzE,QAAQ,EAAE,KAAK;gBACf,WAAW;aACZ,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CACrC,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EACjE,IAAI,CACL,CAAC;QACF,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;QAChG,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;QAClG,CAAC;QAED,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,SAAS;YACf,IAAI;YACJ,EAAE;YACF,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAClD,aAAa,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QAC/C,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,4FAA4F;IACpF,aAAa,CAAC,SAAiB;QACrC,IAAI,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,CACV,KAAK,EAAE,MAAM,EAAE,EAAE;gBACf,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC,EACD,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,uCAAuC,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAClF,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,0GAA0G;AAC1G,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,4EAA4E;AAC5E,SAAS,YAAY,CAAC,GAAqB;IACzC,OAAO,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,6CAA6C;AAC7C,SAAS,aAAa,CAAC,GAAqB;IAC1C,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lifecycle/tool-calls.d.ts

@@ -1,9 +0,0 @@
-import type { ToolCallFilter, ToolCallRecord } from "../public/sandbox.js";
-import { type VisitSpan } from "../workflow/visits.js";
-export type { ToolCallFilter, ToolCallRecord };
-/**
- * The session's domain tool calls in the order they were made, narrowed by
- * `filter`. The runtime's control tools are not domain calls, and runtime notes
- * are not calls at all.
- */
-export declare function queryToolCalls(messages: readonly unknown[], visits: readonly VisitSpan[], filter?: ToolCallFilter): ToolCallRecord[];