@nxisai/agent-harness 0.2.0

package/dist/harness/plan.js

@@ -0,0 +1,68 @@
+/**
+ * Arranges missing values into the steps a renderer asks for them in.
+ *
+ * A single missing value is one question; several become a stepper.
+ *
+ * @module
+ */
+/**
+ * Field names conventionally asked together, so they share a step.
+ *
+ * Matched by exact field name. Kept short by design: the more fields are
+ * grouped, the less the step count communicates.
+ */
+const AFFINITY = [
+    ['full_name', 'name', 'email', 'phone'],
+    ['city', 'state', 'zip', 'postal_code'],
+];
+/** Index of the {@link AFFINITY} group a field belongs to, or -1. */
+function affinityGroup(name) {
+    return AFFINITY.findIndex(group => group.includes(name));
+}
+/**
+ * Arrange missing slots into steps.
+ *
+ * @param missing - The slots still needing values, in the order to ask for them.
+ * @param groupRelated - Whether to place related fields (see {@link AFFINITY})
+ * on one step. Pass `false` to ask for every field separately.
+ * @returns A plan whose `stepped` flag is true when it has more than one step.
+ */
+export function buildPlan(missing, groupRelated = true) {
+    if (!missing.length)
+        return { steps: [], stepped: false };
+    const steps = [];
+    if (groupRelated) {
+        const used = new Set();
+        for (const slot of missing) {
+            if (used.has(slot))
+                continue;
+            const group = affinityGroup(slot.name);
+            const together = group === -1
+                ? [slot]
+                : missing.filter(s => !used.has(s) && affinityGroup(s.name) === group);
+            together.forEach(s => used.add(s));
+            steps.push({ index: steps.length, slots: together, title: stepTitle(together) });
+        }
+    }
+    else {
+        for (const slot of missing) {
+            steps.push({ index: steps.length, slots: [slot], title: stepTitle([slot]) });
+        }
+    }
+    // Renumber after grouping so index always matches position.
+    steps.forEach((s, i) => (s.index = i));
+    return { steps, stepped: steps.length > 1 };
+}
+/** A human label for a slot: its description, or its name made readable. */
+function label(slot) {
+    return (slot.schema.description ||
+        slot.name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ')
+            .replace(/^\w/, c => c.toUpperCase()));
+}
+/** The heading for a step, joining grouped slots with an ampersand. */
+function stepTitle(slots) {
+    if (slots.length === 1)
+        return label(slots[0]);
+    return slots.map(label).join(' & ');
+}
+//# sourceMappingURL=plan.js.map

package/dist/harness/plan.js.map

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

package/dist/harness/policy.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Tool policy: whether a resolved tool call runs immediately or waits for a
+ * human confirmation.
+ *
+ * The decision comes from the tool's own `readOnlyHint` annotation, so a tool
+ * source that annotates its tools correctly gets the right behaviour with no
+ * further configuration.
+ *
+ * @module
+ */
+import type { ModelContextToolInfo } from '../types.js';
+/** What the harness should do once arguments are resolved. */
+export type Decision = 
+/** Run it now, with no interstitial UI. */
+'execute'
+/** Ask for the missing values, then run without a further confirmation. */
+ | 'ask'
+/** Nothing is missing, but a human still presses Submit. */
+ | 'confirm';
+/** How a single tool should be treated once its arguments are known. */
+export interface ToolPolicy {
+    /** Taken from `annotations.readOnlyHint`. Read-only tools never write. */
+    readOnly: boolean;
+    /**
+     * Whether a call with no missing values still needs a human press.
+     *
+     * True for writes, whose effects reach a real system and cannot be undone by
+     * the harness. The confirmation displays the values read-only: nothing is
+     * missing, so there is nothing to edit.
+     */
+    confirmWhenSatisfied: boolean;
+}
+/**
+ * Derive a tool's policy from its annotations.
+ *
+ * @param tool - The tool as reported by the tool source.
+ * @returns The policy the harness applies to calls of this tool.
+ */
+export declare function policyFor(tool: ModelContextToolInfo): ToolPolicy;
+/**
+ * Resolve the decision from a tool's policy and what is still unknown.
+ *
+ * @param policy - The policy for the tool being called.
+ * @param gapCount - How many required values are still missing.
+ * @returns `'ask'` when anything is missing, otherwise `'confirm'` for writes
+ * and `'execute'` for reads.
+ */
+export declare function decide(policy: ToolPolicy, gapCount: number): Decision;
+//# sourceMappingURL=policy.d.ts.map

package/dist/harness/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/harness/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,8DAA8D;AAC9D,MAAM,MAAM,QAAQ;AAClB,2CAA2C;AACzC,SAAS;AACX,2EAA2E;GACzE,KAAK;AACP,4DAA4D;GAC1D,SAAS,CAAC;AAEd,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,oBAAoB,GAAG,UAAU,CAGhE;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAGrE"}

package/dist/harness/policy.js

@@ -0,0 +1,34 @@
+/**
+ * Tool policy: whether a resolved tool call runs immediately or waits for a
+ * human confirmation.
+ *
+ * The decision comes from the tool's own `readOnlyHint` annotation, so a tool
+ * source that annotates its tools correctly gets the right behaviour with no
+ * further configuration.
+ *
+ * @module
+ */
+/**
+ * Derive a tool's policy from its annotations.
+ *
+ * @param tool - The tool as reported by the tool source.
+ * @returns The policy the harness applies to calls of this tool.
+ */
+export function policyFor(tool) {
+    const readOnly = !!tool.annotations?.readOnlyHint;
+    return { readOnly, confirmWhenSatisfied: !readOnly };
+}
+/**
+ * Resolve the decision from a tool's policy and what is still unknown.
+ *
+ * @param policy - The policy for the tool being called.
+ * @param gapCount - How many required values are still missing.
+ * @returns `'ask'` when anything is missing, otherwise `'confirm'` for writes
+ * and `'execute'` for reads.
+ */
+export function decide(policy, gapCount) {
+    if (gapCount > 0)
+        return 'ask';
+    return policy.confirmWhenSatisfied ? 'confirm' : 'execute';
+}
+//# sourceMappingURL=policy.js.map

package/dist/harness/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/harness/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2BH;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAA0B;IAClD,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC;IAClD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,QAAQ,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,MAAkB,EAAE,QAAgB;IACzD,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC"}

package/dist/harness/renderer.d.ts

@@ -0,0 +1,163 @@
+/**
+ * The interface between the harness and a user interface.
+ *
+ * The harness makes every decision about what to do; a renderer is asked only
+ * to draw and to report what a person did. Keeping this interface narrow is
+ * what allows the same harness to drive the bundled web component, an A2UI
+ * surface, or a UI of your own.
+ *
+ * @module
+ */
+import type { ModelContextToolInfo, ModelContextToolResponse } from '../types.js';
+import type { ClarificationPlan } from './plan.js';
+import type { Resolution, Slot } from './slots.js';
+/** One tool call and its response, for renderers that show their work. */
+export interface TraceEntry {
+    /** The tool that was called. */
+    tool: ModelContextToolInfo;
+    /** Arguments as sent, after the harness reconciled and filled them. */
+    args: Record<string, unknown>;
+    /** The response, flattened to text. */
+    text: string;
+    /** Whether the tool reported a failure. */
+    isError: boolean;
+    /** How many records came back, when the response was a record set. */
+    count?: number;
+}
+/**
+ * The assistant's bubble for one phase of a turn.
+ *
+ * A turn is not one continuous stream. The harness opens a bubble, moves it
+ * through its phases and finalizes it, then opens another when the next silence
+ * begins, so {@link HarnessRenderer.streaming} is called more than once per turn
+ * and each bubble should be treated as independent.
+ *
+ * The usual order:
+ *
+ * ```ts
+ * bubble.thinking('Loading model…');        // no output yet
+ * bubble.update('The nearest plumb');       // text has started arriving
+ * bubble.finalize('The nearest plumber is…'); // the phase is over
+ * ```
+ */
+export interface StreamingBubble {
+    /**
+     * Show that work is happening, before there is anything to show.
+     *
+     * A turn can be silent for a long time: loading model weights takes tens of
+     * seconds on a first visit. Safe to call repeatedly, since each call replaces
+     * the label in place rather than adding a bubble.
+     *
+     * @param label - The current phase, such as `'Loading model…'`. Omit it to
+     * indicate work with nothing worth naming.
+     */
+    thinking(label?: string): void;
+    /**
+     * Stream the answer as it is produced.
+     *
+     * @param text - The whole visible answer so far, not the newest fragment.
+     * Replace the bubble's contents with it; appending accumulates the answer on
+     * itself. Tool-call markers are already stripped.
+     */
+    update(text: string): void;
+    /**
+     * Close the bubble with its final text.
+     *
+     * Usually the last call a bubble receives, but not guaranteed to be: when the
+     * model answers with a question instead of calling a tool, the harness runs a
+     * second generation into the same bubble, so `update` can follow a non-empty
+     * `finalize`. Implementations should stay usable rather than throwing.
+     *
+     * @param text - The text to keep. Empty means the phase produced nothing
+     * worth keeping (a failed load, a finished tool call, a generation that was
+     * only a tool call), and the bubble should be removed rather than left blank.
+     */
+    finalize(text: string): void;
+}
+/** A write tool with every value resolved, awaiting a human press. */
+export interface ConfirmRequest {
+    /** The tool about to be called. */
+    tool: ModelContextToolInfo;
+    /** Rows to display read-only. Nothing is missing, so nothing is editable. */
+    slots: Slot[];
+    /** The values that will be sent. */
+    values: Record<string, unknown>;
+    /** Call to proceed, optionally with values the user amended. */
+    onSubmit(values: Record<string, unknown>): void;
+    /** Call if the user declines. */
+    onCancel(): void;
+    /** Call to open the full editable form instead of confirming. */
+    onEdit(): void;
+}
+/** A tool call missing required values, and the plan for asking about them. */
+export interface AskRequest {
+    /** The tool waiting on the answers. */
+    tool: ModelContextToolInfo;
+    /** The questions to ask, as one step or several. */
+    plan: ClarificationPlan;
+    /** What is already known, and from where. */
+    resolution: Resolution;
+    /** Call with the merged values once the last step is answered. */
+    onComplete(values: Record<string, unknown>): void;
+    /** Call if the user abandons the questions. */
+    onCancel(): void;
+}
+/**
+ * Everything the harness needs from a user interface.
+ *
+ * Required members are called during an ordinary turn. Optional ones may be
+ * omitted by a renderer that has nothing to show for them.
+ */
+export interface HarnessRenderer {
+    /** Add a complete message, already known in full. */
+    message(role: 'user' | 'assistant', text: string): void;
+    /**
+     * Open a bubble for the phase about to start.
+     *
+     * Called several times per turn: once before the model is touched, so the
+     * thread is never silent while weights download, and again around each tool
+     * call. Each bubble is finalized before the next is requested.
+     *
+     * @returns The bubble the harness will drive through that phase.
+     */
+    streaming(): StreamingBubble;
+    /**
+     * Show a one-line status outside the thread, such as a header strip.
+     *
+     * @param text - The status. Empty clears it.
+     * @param isError - Whether to present the status as a failure.
+     */
+    status(text: string, isError?: boolean): void;
+    /** Ask for missing values, as one question or a stepper. */
+    ask(req: AskRequest): void;
+    /** Present a write for confirmation. Nothing is missing. */
+    confirm(req: ConfirmRequest): void;
+    /** A read tool returned records. */
+    results(tool: ModelContextToolInfo, res: ModelContextToolResponse): void;
+    /** A write tool succeeded. */
+    detail(tool: ModelContextToolInfo, values: Record<string, unknown>, text: string): void;
+    /** A tool failed, or returned something that cannot be rendered. */
+    toolError(tool: ModelContextToolInfo, message: string): void;
+    /**
+     * Record the exchange behind a rendered card.
+     *
+     * Distinct from {@link HarnessRenderer.results} and
+     * {@link HarnessRenderer.detail}, which draw the outcome the user asked for.
+     * A trace is the underlying call and raw response, suited to a collapsed
+     * panel. Omit it to record nothing.
+     */
+    trace?(entry: TraceEntry): void;
+    /** Tear down any live ask or confirm UI. */
+    dismissPrompt?(): void;
+    /**
+     * Report whether the turn can still be stopped.
+     *
+     * Called with `true` when a turn starts and `false` when it ends, and also
+     * `false` as soon as a tool is invoked: past that point the call may already
+     * have reached a server, so it can no longer be cancelled.
+     *
+     * @param canStop - Whether {@link AgentHarness.stop} would still take effect.
+     */
+    stoppable?(canStop: boolean): void;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/harness/renderer.d.ts.map

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

package/dist/harness/renderer.js

@@ -0,0 +1,12 @@
+/**
+ * The interface between the harness and a user interface.
+ *
+ * The harness makes every decision about what to do; a renderer is asked only
+ * to draw and to report what a person did. Keeping this interface narrow is
+ * what allows the same harness to drive the bundled web component, an A2UI
+ * surface, or a UI of your own.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=renderer.js.map

package/dist/harness/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/harness/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/harness/router/coordinator.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Routes each turn to one of several {@link AgentHarness} instances.
+ *
+ * The coordinator holds no tools and produces no answers of its own. Its only
+ * job is choosing which agent handles a turn, so that agent sends the model its
+ * own few tool definitions rather than every tool on the page.
+ *
+ * It decides in four stages, cheapest first:
+ *
+ * | Stage | Cost | When it applies |
+ * |---|---|---|
+ * | `rules` | microseconds | A rule table matches the goal unambiguously. |
+ * | `sticky` | none | The rules abstained, and this conversation is already with an agent. |
+ * | `model` | one generation | The rules abstained and there is no history. Requires `provider`. |
+ * | `fallback` | none | Nothing else decided. |
+ *
+ * After the fact it applies one correction: if the chosen agent reports that
+ * the model asked for a tool it does not hold, the turn moves once to the agent
+ * that does.
+ *
+ * @module
+ */
+import type { ChatMessage } from '../../types.js';
+import type { ModelProvider } from '../../providers/types.js';
+import type { AgentHarness, TurnResult } from '../harness.js';
+import { type RouteDecision, type RouteRule } from './rules.js';
+/** How a turn's agent was chosen. */
+/** Which stage of {@link AgentCoordinator} chose the agent for a turn. */
+export type RouteSource = 'rules' | 'sticky' | 'model' | 'fallback' | 'handback';
+/** Configuration for an {@link AgentCoordinator}. */
+export interface CoordinatorOptions {
+    /** The agents to route between, keyed by the name the rules refer to. */
+    agents: Record<string, AgentHarness>;
+    /** The rule table scored against each goal. May be empty. */
+    rules: RouteRule[];
+    /**
+     * The agent an otherwise unroutable turn goes to.
+     *
+     * Must name a key of {@link CoordinatorOptions.agents}; the constructor
+     * throws if it does not.
+     */
+    fallback: string;
+    /**
+     * Enables the model classification stage, which is otherwise skipped.
+     *
+     * This is the only part of routing that costs a generation, so it runs only
+     * when the rules abstain and no stickiness applies.
+     */
+    provider?: ModelProvider;
+    /** One line per agent describing what it handles, shown to the classifier. */
+    descriptions?: Record<string, string>;
+    /** Called with every routing decision, including corrections. */
+    onRoute?(decision: RoutedTurn): void;
+}
+/** A routing decision, reported through {@link CoordinatorOptions.onRoute}. */
+export interface RoutedTurn extends RouteDecision {
+    /** The agent that ran, which may differ from {@link RouteDecision.route}. */
+    agent: string;
+    /** Which stage chose the agent. */
+    via: RouteSource;
+    /** True when no stage decided and the fallback was used. */
+    fellBack: boolean;
+    /** The user message that was routed. */
+    goal: string;
+}
+/**
+ * Routes turns between several agents. See the module description for the
+ * stages it decides in.
+ */
+export declare class AgentCoordinator {
+    private readonly opts;
+    /**
+     * The agent each conversation is currently with.
+     *
+     * Keyed by the transcript array itself, so several conversations can be open
+     * at once and a discarded one takes its routing state with it.
+     */
+    private readonly sticky;
+    /** The classification pass in flight, if any. */
+    private classifying;
+    /** The agent handling the current turn, so {@link stop} can reach it. */
+    private working;
+    constructor(opts: CoordinatorOptions);
+    /**
+     * Abandon the turn in flight, whichever stage it has reached.
+     *
+     * Aborts the classification pass and delegates to the agent handling the
+     * turn, which resolves as `'stopped'`. Safe to call when nothing is running.
+     */
+    stop(): void;
+    /**
+     * Decide which agent should take a turn, without running it.
+     *
+     * Covers the rules, sticky and fallback stages. The model stage is skipped,
+     * since it is asynchronous and costs a generation.
+     *
+     * @param goal - The user's message.
+     * @param messages - The conversation, consulted for stickiness. Optional.
+     * @returns The chosen agent and the stage that chose it.
+     */
+    route(goal: string, messages?: ChatMessage[]): RoutedTurn;
+    /**
+     * Route a turn, run it, and re-route it once if it reached the wrong agent.
+     *
+     * @param goal - The user's message.
+     * @param messages - The live conversation, appended to in place.
+     * @returns The chosen agent's {@link TurnResult}.
+     */
+    turn(goal: string, messages: ChatMessage[]): Promise<TurnResult>;
+    /** The agent holding a tool, ignoring the one that handed the turn back. */
+    private ownerOf;
+    /**
+     * Ask the model which agent should take the turn.
+     *
+     * One short generation with no tools. Any reply that does not name a known
+     * agent returns null, leaving the fallback in place.
+     */
+    private classify;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/harness/router/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/harness/router/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5E,qCAAqC;AACrC,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAEjF,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,6DAA6D;IAC7D,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,iEAAiE;IACjE,OAAO,CAAC,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;CACtC;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,GAAG,EAAE,WAAW,CAAC;IACjB,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAKD;;;GAGG;AACH,qBAAa,gBAAgB;IAaf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZjC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,iDAAiD;IACjD,OAAO,CAAC,WAAW,CAAgC;IACnD,yEAAyE;IACzE,OAAO,CAAC,OAAO,CAA6B;gBAEf,IAAI,EAAE,kBAAkB;IAMrD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAMZ;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,UAAU;IAYzD;;;;;;OAMG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAiCtE,4EAA4E;IAC5E,OAAO,CAAC,OAAO;IAOf;;;;;OAKG;YACW,QAAQ;CAoCvB"}

package/dist/harness/router/coordinator.js

@@ -0,0 +1,145 @@
+import { matchRoute } from './rules.js';
+/** Token ceiling for the classification pass, whose answer is one agent name. */
+const CLASSIFY_MAX_TOKENS = 12;
+/**
+ * Routes turns between several agents. See the module description for the
+ * stages it decides in.
+ */
+export class AgentCoordinator {
+    constructor(opts) {
+        this.opts = opts;
+        /**
+         * The agent each conversation is currently with.
+         *
+         * Keyed by the transcript array itself, so several conversations can be open
+         * at once and a discarded one takes its routing state with it.
+         */
+        this.sticky = new WeakMap();
+        /** The classification pass in flight, if any. */
+        this.classifying = null;
+        /** The agent handling the current turn, so {@link stop} can reach it. */
+        this.working = null;
+        if (!opts.agents[opts.fallback]) {
+            throw new Error(`Coordinator fallback "${opts.fallback}" is not one of its agents.`);
+        }
+    }
+    /**
+     * Abandon the turn in flight, whichever stage it has reached.
+     *
+     * Aborts the classification pass and delegates to the agent handling the
+     * turn, which resolves as `'stopped'`. Safe to call when nothing is running.
+     */
+    stop() {
+        this.classifying?.abort();
+        this.classifying = null;
+        this.working?.stop();
+    }
+    /**
+     * Decide which agent should take a turn, without running it.
+     *
+     * Covers the rules, sticky and fallback stages. The model stage is skipped,
+     * since it is asynchronous and costs a generation.
+     *
+     * @param goal - The user's message.
+     * @param messages - The conversation, consulted for stickiness. Optional.
+     * @returns The chosen agent and the stage that chose it.
+     */
+    route(goal, messages) {
+        const decision = matchRoute(goal, this.opts.rules);
+        const named = decision.route && this.opts.agents[decision.route] ? decision.route : null;
+        if (named)
+            return { ...decision, agent: named, via: 'rules', fellBack: false, goal };
+        const held = messages && this.sticky.get(messages);
+        if (held && this.opts.agents[held]) {
+            return { ...decision, agent: held, via: 'sticky', fellBack: false, goal };
+        }
+        return { ...decision, agent: this.opts.fallback, via: 'fallback', fellBack: true, goal };
+    }
+    /**
+     * Route a turn, run it, and re-route it once if it reached the wrong agent.
+     *
+     * @param goal - The user's message.
+     * @param messages - The live conversation, appended to in place.
+     * @returns The chosen agent's {@link TurnResult}.
+     */
+    async turn(goal, messages) {
+        let routed = this.route(goal, messages);
+        // The model is only asked when nothing cheaper had an opinion.
+        if (routed.via === 'fallback' && this.opts.provider) {
+            const guessed = await this.classify(goal);
+            if (guessed)
+                routed = { ...routed, agent: guessed, via: 'model', fellBack: false };
+        }
+        this.opts.onRoute?.(routed);
+        this.sticky.set(messages, routed.agent);
+        this.working = this.opts.agents[routed.agent];
+        const result = await this.working.turn(goal, messages);
+        // Release stickiness after a refusal, so the next unclear follow-up is not
+        // routed back to the one agent known to lack the tools for it.
+        if (result.decision === 'unavailable')
+            this.sticky.delete(messages);
+        if (result.decision !== 'handback' || !result.wanted)
+            return result;
+        // Exactly one correction: the owner's answer stands whatever it is. Without
+        // the cap, two agents that disagree could pass a turn back and forth.
+        const owner = this.ownerOf(result.wanted, routed.agent);
+        if (!owner)
+            return result;
+        const moved = { ...routed, agent: owner, via: 'handback', fellBack: false };
+        this.opts.onRoute?.(moved);
+        this.sticky.set(messages, owner);
+        this.working = this.opts.agents[owner];
+        return this.working.turn(goal, messages);
+    }
+    /** The agent holding a tool, ignoring the one that handed the turn back. */
+    ownerOf(tool, except) {
+        for (const [name, agent] of Object.entries(this.opts.agents)) {
+            if (name !== except && agent.owns(tool))
+                return name;
+        }
+        return null;
+    }
+    /**
+     * Ask the model which agent should take the turn.
+     *
+     * One short generation with no tools. Any reply that does not name a known
+     * agent returns null, leaving the fallback in place.
+     */
+    async classify(goal) {
+        const provider = this.opts.provider;
+        if (!provider)
+            return null;
+        const names = Object.keys(this.opts.agents);
+        const menu = names
+            .map((n) => `- ${n}: ${this.opts.descriptions?.[n] ?? 'handles ' + n + ' requests'}`)
+            .join('\n');
+        this.classifying = new AbortController();
+        try {
+            const reply = await provider.complete({
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'Choose which assistant should handle the message. ' +
+                            `Answer with exactly one of these names and nothing else:\n${menu}`,
+                    },
+                    { role: 'user', content: goal },
+                ],
+                tools: [],
+                maxTokens: CLASSIFY_MAX_TOKENS,
+                signal: this.classifying.signal,
+            });
+            const said = reply.text.toLowerCase();
+            // Longest name first, so a shorter name that is a substring of another
+            // does not match in its place.
+            const found = [...names]
+                .sort((a, b) => b.length - a.length)
+                .find((n) => said.includes(n.toLowerCase()));
+            return found ?? null;
+        }
+        catch {
+            // Routing must not fail a turn: the fallback covers a failed pass.
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/harness/router/coordinator.js.map

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