@nxisai/agent-harness 0.2.0

package/dist/harness/harness.js

@@ -0,0 +1,568 @@
+/**
+ * The turn loop: discover tools, generate, parse the tool call, resolve what is
+ * still unknown, decide whether to ask or act, run the tool, report the result.
+ *
+ * The harness decides; a {@link HarnessRenderer} draws. What a turn does
+ * depends on the tool's own annotations and on how much the model supplied:
+ *
+ * | Tool | Missing values | Outcome |
+ * |---|---|---|
+ * | read | none | runs immediately, no UI |
+ * | read | some | asks for those, then runs |
+ * | write | none | read-only summary and one Submit |
+ * | write | several | a stepper, then a confirmation |
+ *
+ * @module
+ */
+import { stripMarkers, humanize, } from '../engine.js';
+import { LocalGemmaProvider } from '../engine.js';
+import { WebMcpTools } from './tools/webmcp.js';
+import { extractResult, reconcileArgs, toolSchema } from './tools/schema.js';
+import { decide, policyFor } from './policy.js';
+import { buildPlan } from './plan.js';
+import { resolveSlots, summarySlots } from './slots.js';
+/**
+ * Whether a reply reads as the model asking rather than answering.
+ *
+ * Intentionally crude: it gates one extra generation, so a false positive costs
+ * a wasted round rather than a wrong action.
+ */
+function looksLikeQuestion(text) {
+    return /\?\s*$/.test(stripMarkers(text).trim());
+}
+/** Stands in when a reply was neither prose nor a recognisable tool call. */
+const WORKING_ON_IT = 'Working on that.';
+/**
+ * Whether an error represents a cancelled operation rather than a failure.
+ *
+ * @param err - The caught value.
+ * @returns True for a DOM `AbortError`, as thrown by an aborted `fetch`.
+ */
+export function isAbort(err) {
+    return err?.name === 'AbortError';
+}
+/**
+ * A sentence to show for a turn whose model output was only a tool call.
+ *
+ * Claims no more than the harness knows at that point: which tool was chosen,
+ * and whether it reads or writes.
+ *
+ * @param call - The parsed tool call, or null if there was none.
+ * @param tools - The tools available this turn, used to read the annotations.
+ * @returns A short line to display in place of the model's own words.
+ */
+export function narrateCall(call, tools) {
+    if (!call)
+        return WORKING_ON_IT;
+    const tool = tools.find((t) => t.name === call.name);
+    if (tool && policyFor(tool).readOnly)
+        return 'Looking that up.';
+    return `Filling in the ${humanize(call.name).toLowerCase()}.`;
+}
+/**
+ * How many records a tool response contained.
+ *
+ * Best-effort: it feeds a summary line, so an unrecognised shape reports
+ * nothing rather than guessing.
+ *
+ * @param res - The tool response, whose `structuredContent` is preferred.
+ * @param text - The same response flattened to text, parsed as JSON if needed.
+ * @returns The record count, or undefined when the shape is not recognised.
+ */
+export function countRecords(res, text) {
+    const structured = res?.structuredContent;
+    if (Array.isArray(structured?.results))
+        return structured.results.length;
+    if (typeof structured?.total === 'number')
+        return structured.total;
+    try {
+        const parsed = JSON.parse(text);
+        if (Array.isArray(parsed?.results))
+            return parsed.results.length;
+        if (typeof parsed?.total === 'number')
+            return parsed.total;
+    }
+    catch {
+        // A plain-text response carries no count.
+    }
+    return undefined;
+}
+/**
+ * One agent: a provider, a set of tools, and the loop that runs a turn.
+ *
+ * Use it directly for a single-agent page, or several behind an
+ * {@link AgentCoordinator} to route between specialists.
+ *
+ * @example
+ * ```ts
+ * const harness = new AgentHarness({ renderer });
+ * const messages: ChatMessage[] = [];
+ * await harness.turn('what are your opening hours?', messages);
+ * ```
+ */
+export class AgentHarness {
+    constructor(opts) {
+        /** Values typed into a prompt that is still open, kept across turns. */
+        this.entered = {};
+        this.liveTool = null;
+        /** The in-flight turn's controller, so it can be cancelled. */
+        this.abort = null;
+        /** The previous request's system prompt and tool names, for the cache hint. */
+        this.lastPrompt = '';
+        this.lastTools = '';
+        this.provider = opts.provider ?? new LocalGemmaProvider();
+        this.toolSource = opts.toolSource ?? new WebMcpTools();
+        this.renderer = opts.renderer;
+        this.opts = opts;
+    }
+    /**
+     * End a turn that the user stopped.
+     *
+     * Discards any partial answer and keeps the question, recording it if the
+     * stop arrived before the turn had done so, so the transcript matches what is
+     * on screen.
+     */
+    stopTurn(bubble, messages, goal) {
+        bubble.finalize('');
+        this.renderer.status('');
+        const asked = [...messages].reverse().find((m) => m.role === 'user');
+        if (asked?.content !== goal) {
+            messages.push({ role: 'user', content: goal });
+            this.opts.onMessages?.(messages);
+        }
+        return this.finished({ decision: 'stopped' });
+    }
+    /** Report a finished turn and clear the stoppable state. */
+    finished(result) {
+        this.renderer.stoppable?.(false);
+        return result;
+    }
+    /** Whether the current turn has been stopped. */
+    get stopped() {
+        return !!this.abort?.signal.aborted;
+    }
+    /**
+     * Abandon the turn in flight.
+     *
+     * Aborts tool discovery or generation, whichever is running. The turn
+     * resolves as `'stopped'` rather than rejecting, so a cancellation is not
+     * reported as a failure. Safe to call when nothing is running.
+     *
+     * A tool call already in progress is not interrupted, since it may have
+     * reached a server already.
+     */
+    stop() {
+        this.abort?.abort();
+        this.abort = null;
+    }
+    /**
+     * Render a completion for the transcript.
+     *
+     * The transcript must record the tool call, or the model repeats it on the
+     * next turn. Providers returning structured calls have no text form for one,
+     * so this writes it. Never displayed: the UI shows `completion.text`.
+     */
+    transcribe(completion) {
+        if (!completion.call)
+            return completion.text;
+        const args = JSON.stringify(completion.call.args ?? {});
+        const said = completion.text ? `${completion.text}\n` : '';
+        return `${said}[called ${completion.call.name} with ${args}]`;
+    }
+    /**
+     * Compare this request with the previous one to build a {@link CacheHint}.
+     *
+     * Must be called after `applySystemPrompt`, since a handoff between agents
+     * replaces both the system message and the tool slice.
+     */
+    cacheHint(messages, tools) {
+        const names = tools.map((t) => t.name).join(',');
+        const prompt = messages[0]?.role === 'system' ? messages[0].content : '';
+        const hint = {
+            stableMessages: prompt && prompt === this.lastPrompt ? 1 : 0,
+            toolsStable: names === this.lastTools,
+        };
+        this.lastPrompt = prompt;
+        this.lastTools = names;
+        return hint;
+    }
+    /**
+     * Run one turn.
+     *
+     * The turn moves through phases the renderer is told about as they happen
+     * (loading the model, finding tools, generating, running the tool), each on a
+     * {@link HarnessRenderer.streaming} bubble with its own label. A renderer
+     * should expect the first bubble before any token exists.
+     *
+     * Starting a turn supersedes any turn still running.
+     *
+     * @param goal - The user's message.
+     * @param messages - The live conversation, appended to in place. The caller
+     * keeps ownership of persistence; see {@link HarnessOptions.onMessages}.
+     * @returns How the turn ended. A page with no tools, a tool that errors, and
+     * a cancellation all resolve normally; see {@link TurnResult.decision}.
+     * @throws If the model cannot be loaded (no WebGPU, unreachable weights) or a
+     * generation fails for a reason other than being aborted.
+     */
+    async turn(goal, messages) {
+        // Created before the first await, so `stopped` reads this turn's signal
+        // rather than the previous turn's.
+        this.abort?.abort();
+        this.abort = new AbortController();
+        this.renderer.stoppable?.(true);
+        // Opened before the model is touched: loading weights is the longest
+        // silence in a turn, and the thread should not be empty during it.
+        const bubble = this.renderer.streaming();
+        bubble.thinking(this.provider.ready ? 'Thinking…' : 'Loading model…');
+        try {
+            await this.provider.load?.();
+        }
+        catch (err) {
+            // A stop during a load is not a failure to load. The download continues
+            // and its bytes are cached, so the next attempt resumes rather than
+            // starting over.
+            if (this.stopped || isAbort(err))
+                return this.stopTurn(bubble, messages, goal);
+            bubble.finalize('');
+            throw err;
+        }
+        // Asserted per turn rather than seeded once, because agents share the
+        // transcript and each has its own prompt.
+        this.applySystemPrompt(messages);
+        if (this.stopped) {
+            return this.stopTurn(bubble, messages, goal);
+        }
+        bubble.thinking('Finding tools…');
+        const registered = await this.toolSource.discoverTools(this.abort?.signal);
+        if (this.stopped) {
+            return this.stopTurn(bubble, messages, goal);
+        }
+        const tools = this.visibleTools(registered);
+        if (!tools.length) {
+            bubble.finalize('');
+            this.renderer.status('');
+            // A page with no tools at all is a host misconfiguration; this agent
+            // having none of them is answerable to the user. The slice is never
+            // widened to compensate, since using the wrong tool succeeds at the wrong
+            // thing rather than failing visibly.
+            if (registered.length) {
+                console.warn(`[nxis-agent] ${this.opts.name ?? 'agent'} has no tools on this page ` +
+                    `(page has: ${registered.map((t) => t.name).join(', ')})`);
+                this.renderer.message('assistant', this.opts.unavailable ??
+                    'I cannot do that from this page — the tools for it are not available here.');
+                return { decision: 'unavailable' };
+            }
+            // Actionable only by the host, so the detail goes to the console.
+            console.warn('No tools are registered on this page yet — make sure nxis.js has loaded.');
+            this.renderer.message('assistant', 'No tools are registered on this page yet.');
+            return { decision: 'none' };
+        }
+        messages.push({ role: 'user', content: goal });
+        bubble.thinking('Thinking…');
+        this.renderer.status('Thinking…');
+        let completion;
+        try {
+            completion = await this.provider.complete({
+                messages,
+                tools,
+                onToken: (t) => bubble.update(t),
+                signal: this.abort?.signal,
+                cache: this.cacheHint(messages, tools),
+            });
+        }
+        catch (err) {
+            // A remote provider rejects on abort (as `fetch` does); the local one
+            // returns what it had. Neither is a failure to report.
+            if (this.stopped || isAbort(err))
+                return this.stopTurn(bubble, messages, goal);
+            bubble.finalize('');
+            throw err;
+        }
+        // Nothing the model produced survives a stop, on screen or in the
+        // transcript: a model that reads its own unfinished reply back as history
+        // will continue from it or contradict it.
+        if (this.stopped) {
+            return this.stopTurn(bubble, messages, goal);
+        }
+        // A reply is often nothing but the tool call. Left empty the bubble would
+        // be dropped, and the thread would jump from the question to a rendered
+        // card with no turn between them.
+        bubble.finalize(completion.text || narrateCall(completion.call ?? null, tools));
+        messages.push({ role: 'assistant', content: this.transcribe(completion) });
+        this.opts.onMessages?.(messages);
+        this.renderer.status('');
+        let call = completion.call ?? null;
+        // Small models sometimes ask in prose instead of calling the tool. One
+        // nudge, then accept the question: a clarifying question is better than a
+        // retry loop.
+        if (!call && looksLikeQuestion(completion.text)) {
+            const retry = await this.retryForToolCall(messages, tools, bubble);
+            if (retry)
+                call = retry;
+            else if (this.stopped)
+                return this.finished({ decision: 'stopped' });
+        }
+        // Still prose: a legitimate turn, already rendered and in the transcript.
+        if (!call)
+            return { decision: 'none' };
+        const tool = tools.find((t) => t.name === call.name);
+        if (!tool) {
+            // A tool the page has but this agent may not use is a routing problem,
+            // which a coordinator can correct. A tool no page has was invented by the
+            // model.
+            const elsewhere = registered.some((t) => t.name === call.name);
+            if (elsewhere)
+                return { decision: 'handback', wanted: call.name };
+            this.renderer.message('assistant', `I picked an unknown tool ("${call.name}"). Try rephrasing.`);
+            return { decision: 'none' };
+        }
+        return this.act(tool, call.args, messages);
+    }
+    /**
+     * Narrow the page's tools to this agent's slice.
+     *
+     * @param registered - Every tool the tool source reported.
+     * @returns The tools matching {@link HarnessOptions.tools}, or all of them
+     * when no filter is set.
+     */
+    visibleTools(tools) {
+        const filter = this.opts.tools;
+        return filter ? tools.filter((t) => filter(t)) : tools;
+    }
+    /**
+     * Whether this agent's filter accepts a tool, by name.
+     *
+     * Called by {@link AgentCoordinator} when another agent hands a turn back.
+     * The filter receives a tool with only its name set, so a filter that
+     * inspects annotations should reject a bare name and let the fallback take
+     * the turn.
+     *
+     * @param name - The tool name to test.
+     * @returns True when this agent would use that tool.
+     */
+    owns(name) {
+        const filter = this.opts.tools;
+        if (!filter)
+            return true;
+        try {
+            return filter({ name });
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Place this agent's instructions at the head of the shared transcript,
+     * replacing another agent's if one is there.
+     */
+    applySystemPrompt(messages) {
+        const prompt = this.opts.systemPrompt;
+        if (!prompt)
+            return;
+        if (messages[0]?.role === 'system') {
+            if (messages[0].content !== prompt)
+                messages[0] = { role: 'system', content: prompt };
+        }
+        else {
+            messages.unshift({ role: 'system', content: prompt });
+        }
+    }
+    /**
+     * Generate once more, instructing the model to call a tool.
+     *
+     * The instruction is added as a user turn, which carries the most weight in a
+     * chat template mid-conversation, and is removed again afterwards so it never
+     * remains in the transcript as something the user said.
+     *
+     * @returns The tool call, or null if the model still did not produce one.
+     */
+    async retryForToolCall(messages, tools, bubble) {
+        const nudge = {
+            role: 'user',
+            content: 'Call the appropriate tool now with the fields you already have. ' +
+                'Omit any field you do not know — do not ask me for it.',
+        };
+        messages.push(nudge);
+        let completion;
+        try {
+            completion = await this.provider.complete({
+                messages,
+                tools,
+                onToken: (t) => bubble.update(t),
+                signal: this.abort?.signal,
+            });
+        }
+        catch (err) {
+            // The nudge is the harness's own text, so it is removed however the retry
+            // ends rather than being left in the transcript.
+            messages.splice(messages.indexOf(nudge), 1);
+            if (this.stopped || isAbort(err))
+                return null;
+            throw err;
+        }
+        const call = completion.call ?? null;
+        if (this.stopped) {
+            messages.splice(messages.indexOf(nudge), 1);
+            return null;
+        }
+        if (call) {
+            // Keep the assistant's tool call; drop the nudge the user never said.
+            messages.splice(messages.indexOf(nudge), 1);
+            messages.push({ role: 'assistant', content: this.transcribe(completion) });
+            bubble.finalize(completion.text || narrateCall(call, tools));
+        }
+        else {
+            messages.splice(messages.indexOf(nudge), 1);
+        }
+        return call;
+    }
+    /**
+     * Resolve a proposed call's arguments, then run it, confirm it, or ask.
+     *
+     * @param tool - The tool the model chose.
+     * @param rawArgs - Its arguments, before reconciliation against the schema.
+     * @param messages - The live conversation.
+     * @returns The decision taken and the values it was taken with.
+     */
+    async act(tool, rawArgs, messages) {
+        const schema = toolSchema(tool);
+        const modelArgs = reconcileArgs(rawArgs, schema);
+        // Keep values already typed while the model revises a call to the same
+        // tool; discard them when it moves to a different one.
+        const entered = this.liveTool?.name === tool.name ? this.entered : {};
+        const resolution = resolveSlots(schema, {
+            modelArgs,
+            entered,
+            profile: this.opts.profile?.(schema),
+            context: this.opts.context?.(tool),
+        });
+        const policy = policyFor(tool);
+        const decision = decide(policy, resolution.missing.length);
+        if (decision === 'execute') {
+            await this.run(tool, resolution.values, messages);
+            return { decision, tool, values: resolution.values };
+        }
+        if (decision === 'confirm') {
+            this.liveTool = tool;
+            this.renderer.confirm({
+                tool,
+                slots: summarySlots(resolution),
+                values: resolution.values,
+                onSubmit: (values) => void this.run(tool, values, messages),
+                onCancel: () => this.cancel(),
+                onEdit: () => this.askAll(tool, resolution, messages),
+            });
+            return { decision, tool, values: resolution.values };
+        }
+        // decision === 'ask': the gaps only, stepped when there are several.
+        this.liveTool = tool;
+        const plan = buildPlan(resolution.missing, this.opts.groupRelated !== false);
+        this.renderer.message('assistant', plan.stepped
+            ? `I need ${plan.steps.length} more details for ${humanize(tool.name)}.`
+            : `One more thing for ${humanize(tool.name)}.`);
+        this.renderer.ask({
+            tool,
+            plan,
+            resolution,
+            onComplete: (answers) => {
+                const values = { ...resolution.values, ...answers };
+                this.entered = values;
+                // A read was waiting only on the gap. A write still needs its
+                // confirmation, now a summary rather than a form.
+                if (policy.confirmWhenSatisfied) {
+                    this.renderer.confirm({
+                        tool,
+                        slots: summarySlots(resolveSlots(schema, { modelArgs: values })),
+                        values,
+                        onSubmit: (v) => void this.run(tool, v, messages),
+                        onCancel: () => this.cancel(),
+                        onEdit: () => this.askAll(tool, resolution, messages),
+                    });
+                }
+                else {
+                    void this.run(tool, values, messages);
+                }
+            },
+            onCancel: () => this.cancel(),
+        });
+        return { decision, tool, values: resolution.values };
+    }
+    /**
+     * Reopen a confirmation as an editable form covering every field, not only
+     * the gaps. Reached through {@link ConfirmRequest.onEdit}.
+     */
+    askAll(tool, resolution, messages) {
+        const editable = resolution.all.filter((s) => s.name in resolution.values || s.required);
+        this.renderer.ask({
+            tool,
+            plan: buildPlan(editable, false),
+            resolution,
+            onComplete: (answers) => void this.run(tool, { ...resolution.values, ...answers }, messages),
+            onCancel: () => this.cancel(),
+        });
+    }
+    /** Discard a live prompt and the values typed into it. */
+    cancel() {
+        this.entered = {};
+        this.liveTool = null;
+        this.renderer.dismissPrompt?.();
+        this.renderer.message('assistant', 'Okay — cancelled. Tell me what you’d like to do.');
+    }
+    /**
+     * Execute a fully resolved call and render its result.
+     *
+     * Read tools render as records, writes as a detail card. Either way the
+     * outcome is written into the transcript so the model can refer back to it.
+     */
+    async run(tool, values, messages) {
+        this.renderer.dismissPrompt?.();
+        // Past this point the turn cannot be stopped: the call may reach a server
+        // before an abort could arrive.
+        this.renderer.stoppable?.(false);
+        this.renderer.status(`Running ${tool.name}…`);
+        // A remote tool call is another silence, and the generation bubble that
+        // covered the last one has been finalized by now.
+        const working = this.renderer.streaming();
+        working.thinking(`Running ${humanize(tool.name)}…`);
+        try {
+            const res = await this.toolSource.execTool(tool, tool.name, values);
+            const text = extractResult(res);
+            working.finalize('');
+            this.renderer.status('');
+            this.renderer.trace?.({
+                tool,
+                args: values,
+                text,
+                isError: !!res?.isError,
+                count: countRecords(res, text),
+            });
+            if (res?.isError) {
+                this.renderer.toolError(tool, text || 'Failed');
+                return;
+            }
+            this.entered = {};
+            this.liveTool = null;
+            if (policyFor(tool).readOnly) {
+                this.renderer.results(tool, res);
+                messages.push({ role: 'user', content: `[${tool.name} returned: ${text.slice(0, 400)}]` });
+            }
+            else {
+                this.renderer.detail(tool, values, text);
+                messages.push({
+                    role: 'user',
+                    content: `[${tool.name} submitted with: ${JSON.stringify(values)}]. Keep these unless I ask to change them.`,
+                });
+            }
+            this.opts.onMessages?.(messages);
+        }
+        catch (err) {
+            const message = String(err?.message || err);
+            working.finalize('');
+            this.renderer.status('');
+            // A call that threw is the main reason to open a trace.
+            this.renderer.trace?.({ tool, args: values, text: message, isError: true });
+            this.renderer.toolError(tool, message);
+        }
+    }
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/harness/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAGL,YAAY,EACZ,QAAQ,GAET,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAmB,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,MAAM,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC;AAkEzE;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AA4BD,6EAA6E;AAC7E,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAQ,GAAyB,EAAE,IAAI,KAAK,YAAY,CAAC;AAC3D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsC,EACtC,KAA6B;IAE7B,IAAI,CAAC,IAAI;QAAE,OAAO,aAAa,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,kBAAkB,CAAC;IAChE,OAAO,kBAAkB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,GAA6B,EAAE,IAAY;IACtE,MAAM,UAAU,GAAG,GAAG,EAAE,iBAAwE,CAAC;IACjG,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;IACzE,IAAI,OAAO,UAAU,EAAE,KAAK,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4C,CAAC;QAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QACjE,IAAI,OAAO,MAAM,EAAE,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IAiBvB,YAAY,IAAoB;QAThC,wEAAwE;QAChE,YAAO,GAA4B,EAAE,CAAC;QACtC,aAAQ,GAAgC,IAAI,CAAC;QACrD,+DAA+D;QACvD,UAAK,GAA2B,IAAI,CAAC;QAC7C,+EAA+E;QACvE,eAAU,GAAG,EAAE,CAAC;QAChB,cAAS,GAAG,EAAE,CAAC;QAGrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,WAAW,EAAE,CAAC;QACvD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACK,QAAQ,CAAC,MAAuB,EAAE,QAAuB,EAAE,IAAY;QAC7E,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACrE,IAAI,KAAK,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,SAAkB,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,4DAA4D;IACpD,QAAQ,CAAuB,MAAS;QAC9C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iDAAiD;IACjD,IAAY,OAAO;QACjB,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtC,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI;QACF,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACK,UAAU,CAAC,UAAsB;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI;YAAE,OAAO,UAAU,CAAC,IAAI,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,GAAG,IAAI,WAAW,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,GAAG,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACK,SAAS,CAAC,QAAuB,EAAE,KAA6B;QACtE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,GAAc;YACtB,cAAc,EAAE,MAAM,IAAI,MAAM,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC,SAAS;SACtC,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,QAAuB;QAC9C,wEAAwE;QACxE,mCAAmC;QACnC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;QAEhC,qEAAqE;QACrE,mEAAmE;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAEtE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,wEAAwE;YACxE,oEAAoE;YACpE,iBAAiB;YACjB,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC/E,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,sEAAsE;QACtE,0CAA0C;QAC1C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEzB,qEAAqE;YACrE,oEAAoE;YACpE,0EAA0E;YAC1E,qCAAqC;YACrC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CACV,gBAAgB,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,6BAA6B;oBACpE,cAAc,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5D,CAAC;gBACF,IAAI,CAAC,QAAQ,CAAC,OAAO,CACnB,WAAW,EACX,IAAI,CAAC,IAAI,CAAC,WAAW;oBACnB,4EAA4E,CAC/E,CAAC;gBACF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;YACrC,CAAC;YAED,kEAAkE;YAClE,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;YACzF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,2CAA2C,CAAC,CAAC;YAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC9B,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClC,IAAI,UAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACxC,QAAQ;gBACR,KAAK;gBACL,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAChC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM;gBAC1B,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,sEAAsE;YACtE,uDAAuD;YACvD,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC/E,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,kEAAkE;QAClE,0EAA0E;QAC1E,0CAA0C;QAC1C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,0EAA0E;QAC1E,wEAAwE;QACxE,kCAAkC;QAClC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEzB,IAAI,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC;QAEnC,uEAAuE;QACvE,0EAA0E;QAC1E,cAAc;QACd,IAAI,CAAC,IAAI,IAAI,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACnE,IAAI,KAAK;gBAAE,IAAI,GAAG,KAAK,CAAC;iBACnB,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,SAAkB,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,0EAA0E;QAC1E,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,uEAAuE;YACvE,0EAA0E;YAC1E,SAAS;YACT,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/D,IAAI,SAAS;gBAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAElE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,8BAA8B,IAAI,CAAC,IAAI,qBAAqB,CAAC,CAAC;YACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACK,YAAY,CAAC,KAA6B;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAY;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,EAAE,IAAI,EAA0B,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,iBAAiB,CAAC,QAAuB;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM;gBAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACxF,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,gBAAgB,CAC5B,QAAuB,EACvB,KAA6B,EAC7B,MAAuB;QAEvB,MAAM,KAAK,GAAgB;YACzB,IAAI,EAAE,MAAM;YACZ,OAAO,EACL,kEAAkE;gBAClE,wDAAwD;SAC3D,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAErB,IAAI,UAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACxC,QAAQ;gBACR,KAAK;gBACL,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAChC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,0EAA0E;YAC1E,iDAAiD;YACjD,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5C,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9C,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC;QAErC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,sEAAsE;YACtE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC3E,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,GAAG,CACf,IAA0B,EAC1B,OAA4C,EAC5C,QAAuB;QAEvB,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEjD,uEAAuE;QACvE,uDAAuD;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAEtE,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,EAAE;YACtC,SAAS;YACT,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC;YACpC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC;SACnC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE3D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAClD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACpB,IAAI;gBACJ,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC;gBAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;gBAC3D,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;gBAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC;aACtD,CAAC,CAAC;YACH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;QAED,qEAAqE;QACrE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC;QAC7E,IAAI,CAAC,QAAQ,CAAC,OAAO,CACnB,WAAW,EACX,IAAI,CAAC,OAAO;YACV,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM,qBAAqB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACxE,CAAC,CAAC,sBAAsB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjD,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAChB,IAAI;YACJ,IAAI;YACJ,UAAU;YACV,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE;gBACtB,MAAM,MAAM,GAAG,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;gBACpD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;gBACtB,8DAA8D;gBAC9D,kDAAkD;gBAClD,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;oBAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;wBACpB,IAAI;wBACJ,KAAK,EAAE,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;wBAChE,MAAM;wBACN,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC;wBACjD,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;wBAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC;qBACtD,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;SAC9B,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACvD,CAAC;IAED;;;OAGG;IACK,MAAM,CACZ,IAA0B,EAC1B,UAAsB,EACtB,QAAuB;QAEvB,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAChB,IAAI;YACJ,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC;YAChC,UAAU;YACV,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,QAAQ,CAAC;YAC5F,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,0DAA0D;IAClD,MAAM;QACZ,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,kDAAkD,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,GAAG,CACf,IAA0B,EAC1B,MAA+B,EAC/B,QAAuB;QAEvB,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC;QAChC,0EAA0E;QAC1E,gCAAgC;QAChC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9C,wEAAwE;QACxE,kDAAkD;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,GAAG,GAA6B,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9F,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YAChC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEzB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACpB,IAAI;gBACJ,IAAI,EAAE,MAAM;gBACZ,IAAI;gBACJ,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO;gBACvB,KAAK,EAAE,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC;aAC/B,CAAC,CAAC;YAEH,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,QAAQ,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YAErB,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YAC7F,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;gBACzC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,oBAAoB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,4CAA4C;iBAC7G,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,CAAE,GAAa,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;YACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,wDAAwD;YACxD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/harness/plan.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Arranges missing values into the steps a renderer asks for them in.
+ *
+ * A single missing value is one question; several become a stepper.
+ *
+ * @module
+ */
+import type { Slot } from './slots.js';
+/** One screen of the plan. */
+export interface PlanStep {
+    /** Position in {@link ClarificationPlan.steps}, from zero. */
+    index: number;
+    /** Slots asked together. One by default; grouped when they belong together. */
+    slots: Slot[];
+    title: string;
+}
+/** The questions to ask before a tool call can proceed. */
+export interface ClarificationPlan {
+    steps: PlanStep[];
+    /** True when the renderer should draw stepper chrome (Back, Step n of m). */
+    stepped: boolean;
+}
+/**
+ * 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 declare function buildPlan(missing: Slot[], groupRelated?: boolean): ClarificationPlan;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/harness/plan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;CAClB;AAkBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,YAAY,UAAO,GAAG,iBAAiB,CAyBjF"}