@nodetool-ai/agents 0.7.0-rc.23 → 0.8.1

package/dist/codeact/tool-api.d.ts

@@ -0,0 +1,197 @@
+/**
+ * CodeAct tool API — the bridge that exposes an agent toolbelt to sandboxed
+ * JavaScript actions, and the signature rendering that documents it in the
+ * system prompt.
+ *
+ * One host bridge (`__callTool`) serves every tool; a generated guest prelude
+ * builds the belt caller on top of it. Host bridges follow the
+ * js-sandbox never-reject convention: they resolve `{ok, ...}` envelopes and
+ * the guest wrapper re-throws, so the QuickJS host-promise-rejection leak is
+ * never hit.
+ */
+import { type ProcessingContext } from "@nodetool-ai/runtime";
+import type { MessageImageContent, ProviderTool } from "@nodetool-ai/runtime";
+import { Tool } from "../tools/base-tool.js";
+import type { JsonValue } from "../utils/json-parser.js";
+export { TOOLS_PRELUDE } from "./tools-prelude.js";
+/** Tool-call ceiling per code action; a runaway guest loop stops here. */
+export declare const DEFAULT_MAX_TOOL_CALLS_PER_ACTION = 50;
+export interface ToolCallRecord {
+    name: string;
+    args: Record<string, unknown>;
+    /** Synthetic id (`codeact_<n>`) this call runs under. */
+    toolCallId: string;
+}
+/** What a bridged tool handed back, as the UI reports it. */
+export interface ToolResultRecord {
+    name: string;
+    toolCallId: string;
+    /** The tool's return value, or the error text when the call failed. */
+    result: unknown;
+    isError: boolean;
+}
+interface ToolBridgeOptions {
+    tools: Tool[];
+    context: ProcessingContext;
+    /** Observability hook — fires before each bridged tool executes. */
+    onToolCall?: (record: ToolCallRecord) => void;
+    /** Observability hook — fires with what the call returned. */
+    onToolResult?: (record: ToolResultRecord) => void;
+    maxToolCallsPerAction?: number;
+}
+export interface ToolBridge {
+    /** Globals to merge into the sandbox run (`__callTool`, `__toolNames`). */
+    globals: Record<string, unknown>;
+    /** Calls consumed so far in the current action. Reset per action. */
+    callCount: () => number;
+    resetActionBudget: () => void;
+    /**
+     * Pixels a tool returned during this action, removed from the observation
+     * and waiting to ride the tool result as a provider image message. At most
+     * {@link MAX_ACTION_IMAGES} are kept; `dropped` counts the rest. Draining
+     * clears both.
+     */
+    drainImages: () => {
+        images: MessageImageContent[];
+        dropped: number;
+    };
+    /**
+     * The `generation_id` of every result a bridged call answered with, across
+     * all of the step's actions. A failing step intersects the user's completed
+     * generations with this set so it names its own paid work and not a
+     * sibling step's.
+     */
+    generationIds: () => ReadonlySet<string>;
+}
+/** Force a value through JSON so it marshals cleanly across the WASM boundary. */
+export declare function toTransferable(value: unknown): JsonValue;
+/**
+ * Tool errors and failed edit batches stop dependent guest code. Successful
+ * operations in a partial batch may already be persisted.
+ */
+export declare function extractErrorPayload(result: unknown): string | null;
+/**
+ * Wire name → the capability namespace it is imported from, for the names a
+ * module owns. A session tool (a client `ui_*` schema, an external MCP tool)
+ * owns no module and is left out, which is how the guest's `tools` thrower
+ * tells "import it from here" from "ask searchTools".
+ */
+export declare function toolModuleMap(tools: readonly {
+    name: string;
+}[]): Record<string, string>;
+export declare function buildToolBridge(options: ToolBridgeOptions): ToolBridge;
+/**
+ * Split a toolbelt into the tools also offered top level and the rest.
+ *
+ * Membership is {@link DIRECT_TOOL_NAMES}: the core set that mirrors a Claude
+ * Agent SDK built-in, plus discovery — which providers, models and node types
+ * this install has. Both are shapes a plain tool call fits, so a sandbox round
+ * trip whose only job is to forward one buys nothing.
+ *
+ * `core` is a view, not a removal: the belt keeps every tool, because the
+ * object model (`nodetool.models.pick`, `nodetool.web`, `nodetool.agents`) and
+ * any hand-written fan-out call them from inside an action. What the top-level
+ * offer changes is the *documented* path — the prompt catalog lists them as
+ * direct tools, and the default way to reach one is a tool call.
+ */
+export declare function splitCoreTools(tools: Tool[]): {
+    core: Tool[];
+    belt: Tool[];
+};
+/**
+ * Render core tools as provider tool definitions that execute themselves.
+ *
+ * The result travels as text; pixels a tool returns are handed back as image
+ * content blocks instead, the way the sandbox bridge holds them out of the
+ * observation.
+ */
+export declare function buildCoreProviderTools(options: {
+    tools: Tool[];
+    context: ProcessingContext;
+    onToolCall?: (record: ToolCallRecord) => void;
+}): ProviderTool[];
+/**
+ * Guest-side prelude prepended to every code action. Builds the belt caller
+ * over `__callTool` (via {@link TOOLS_PRELUDE}) and `finish()` over
+ * `__finish`. Hosts without a `__finish` bridge — the Code node — prepend
+ * `TOOLS_PRELUDE` alone. Tool discovery lives on the object model as
+ * `nodetool.searchTools()`, so a session reaches every capability under one
+ * name.
+ */
+export declare const CODEACT_PRELUDE = "\nconst __callBeltTool = (name) => async (args) => {\n  const __r = await __callTool(\n    name,\n    JSON.stringify(args === undefined ? {} : args)\n  );\n  if (!__r || __r.ok !== true) {\n    throw new Error(__r && __r.error ? __r.error : \"tool call failed: \" + name);\n  }\n  return __r.result;\n};\nconst tools = new Proxy({}, {\n  get(target, prop) {\n    // \"then\" is excluded so awaiting or resolving this object cannot mistake\n    // it for a thenable and call the thrower.\n    if (typeof prop !== \"string\" || prop === \"then\") return undefined;\n    return () => {\n      const __module =\n        typeof __toolModules === \"object\" && __toolModules !== null\n          ? __toolModules[prop]\n          : undefined;\n      throw new Error(\n        __module\n          ? 'tools.' + prop + ' is gone. Import it instead: ' +\n            'import { ' + prop + ' } from ' +\n            '\"@nodetool-ai/sandbox-nodetool/' + __module + '\";'\n          : 'tools.' + prop + ' is gone \u2014 every capability is an import now. ' +\n            'nodetool.searchTools(\"' + prop + '\") reports the module to ' +\n            'import it from.'\n      );\n    };\n  }\n});\n\nasync function finish(result) {\n  const __r = await __finish(JSON.stringify(result === undefined ? null : result));\n  if (!__r || __r.ok !== true) {\n    throw new Error(__r && __r.error ? __r.error : \"finish() rejected the result\");\n  }\n  return \"step finished\";\n}\n";
+/**
+ * Every name the guest already has beyond the sandbox manifest's own surface:
+ * the host bridges the executors install as `globals`, the wrappers
+ * {@link CODEACT_PRELUDE} builds over them, and the two optional object-model
+ * preludes. User code cannot rebind these, and prompt text may name them
+ * without the sandbox-manifest drift check calling them undefined.
+ */
+export declare const CODEACT_INJECTED_GLOBALS: readonly ["tools", "finish", "__callTool", "__finish", "__toolNames", "__toolModules", "__callBeltTool", "__searchTools", "__graphQueues", "openWorkflow", "nodetool", "__NT_NAMESPACE_TOOLS", "__graphJsonOf"];
+/**
+ * The injected names a model's own code can collide with: the bindings above
+ * minus the `__`-prefixed host bridges, which nobody writes by accident.
+ *
+ * The prelude declares them with `const`, so `const tools = [...]` in an action
+ * is a SyntaxError before a line runs ("lexical redefinition of 'tools'") — a
+ * failure whose cause is invisible from the action's own source. They are named
+ * in the `execute_code` contract, and {@link annotateFailure} names the one
+ * that collided.
+ */
+export declare const RESERVED_ACTION_BINDINGS: readonly string[];
+/** One sentence naming the reserved bindings, for the action contract. */
+export declare const RESERVED_BINDINGS_SENTENCE: string;
+/**
+ * The structural slice of a tool the signature renderer needs. `Tool`
+ * instances satisfy it, and so do bare provider-tool schemas — the chat
+ * runner documents client (`ui_*`) tools that exist only as JSON schemas.
+ */
+export interface ToolSignatureSource {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+}
+/** The bare call signature: `await web_search({query: string, ...})`. */
+export declare function toolSignature(tool: ToolSignatureSource): string;
+/** The specifier a capability is imported from, or `undefined` for a session tool. */
+export declare function toolSpecifier(name: string): string | undefined;
+/**
+ * The import statement that makes one capability callable, or `undefined` for
+ * a name no module owns.
+ */
+export declare function toolImportLine(name: string): string | undefined;
+/** Signature bullet + first sentence of the description. */
+export declare function renderToolSignature(tool: ToolSignatureSource): string;
+/**
+ * The catalog, grouped by the module each capability is imported from.
+ *
+ * The group header IS the import statement the action has to write, with every
+ * name in that group already in the braces — so a model that copies the header
+ * and then calls two of the listed signatures has written a working action.
+ * Listing a signature without saying where the name comes from is what made
+ * the flat belt readable at a glance and unwritable in practice.
+ */
+export declare function renderToolCatalog(tools: ToolSignatureSource[], 
+/**
+ * Specifiers for names no capability module owns but the host has grafted
+ * onto a namespace anyway — a chat session's `ui_*` tools, a step's own
+ * belt. A name absent from it is documented as a plain tool call, which is
+ * what an external MCP tool is.
+ */
+grafted?: ReadonlyMap<string, string>): string;
+/** What `nodetool.searchTools()` returns to the guest, per matched tool. */
+export interface ToolSearchHit {
+    name: string;
+    signature: string;
+    description: string;
+    /** The capability namespace, absent for a tool no module owns. */
+    module?: string;
+    /** The specifier to import it from, absent for the same reason. */
+    specifier?: string;
+    /** The exact import statement to write. */
+    import?: string;
+}
+/** One search hit, with everything needed to write the call. */
+export declare function toolSearchHit(tool: ToolSignatureSource, 
+/** The namespace a host grafted this name onto, if any. */
+graftedModule?: string): ToolSearchHit;
+//# sourceMappingURL=tool-api.d.ts.map

package/dist/codeact/tool-api.d.ts.map

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

package/dist/codeact/tool-api.js

@@ -0,0 +1,445 @@
+/**
+ * CodeAct tool API — the bridge that exposes an agent toolbelt to sandboxed
+ * JavaScript actions, and the signature rendering that documents it in the
+ * system prompt.
+ *
+ * One host bridge (`__callTool`) serves every tool; a generated guest prelude
+ * builds the belt caller on top of it. Host bridges follow the
+ * js-sandbox never-reject convention: they resolve `{ok, ...}` envelopes and
+ * the guest wrapper re-throws, so the QuickJS host-promise-rejection leak is
+ * never hit.
+ */
+import { DIRECT_TOOL_NAMES } from "@nodetool-ai/runtime";
+import { sandboxCapabilitySpecifier } from "@nodetool-ai/protocol";
+import { capabilityModuleOf } from "../capabilities/registry.js";
+import { MAX_ACTION_IMAGES } from "../constants.js";
+import { Tool } from "../tools/base-tool.js";
+import { extractInjectableImages, stripImagePayload } from "../tools/image-injection.js";
+import { compactResourceIds } from "./compact-ids.js";
+import { GRAPH_MODEL_GLOBALS } from "./graph-model.js";
+import { NODETOOL_API_GLOBALS } from "./nodetool-api.js";
+import { TOOLS_PRELUDE } from "./tools-prelude.js";
+import { isBoolean, isNonEmptyString, isNumber, isObjectLike, isRecord, isString } from "../utils/type-guards.js";
+export { TOOLS_PRELUDE } from "./tools-prelude.js";
+/** Tool-call ceiling per code action; a runaway guest loop stops here. */
+export const DEFAULT_MAX_TOOL_CALLS_PER_ACTION = 50;
+/** The `generation_id` a generation-producing capability answers with. */
+function generationIdOf(result) {
+    if (!isRecord(result))
+        return null;
+    const id = result["generation_id"];
+    return isNonEmptyString(id) ? id : null;
+}
+/** Force a value through JSON so it marshals cleanly across the WASM boundary. */
+export function toTransferable(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (isString(value) ||
+        isNumber(value) ||
+        isBoolean(value)) {
+        return value;
+    }
+    try {
+        return JSON.parse(JSON.stringify(value));
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Tool errors and failed edit batches stop dependent guest code. Successful
+ * operations in a partial batch may already be persisted.
+ */
+export function extractErrorPayload(result) {
+    if (!isObjectLike(result) || Array.isArray(result)) {
+        return null;
+    }
+    const record = result;
+    if (isString(record["error"])) {
+        const message = record["message"];
+        const summary = isNonEmptyString(message) ? message : record["error"];
+        const validation = record["validation"];
+        return isObjectLike(validation)
+            ? summary + "\n" + JSON.stringify(validation, null, 2)
+            : summary;
+    }
+    const { applied, failed, ops } = record;
+    if (isNumber(applied) && isNumber(failed) && failed > 0 && Array.isArray(ops)) {
+        const errors = ops.flatMap((op) => {
+            if (!isObjectLike(op) || op.ok !== false || !isString(op.error)) {
+                return [];
+            }
+            return [`${isString(op.op) ? op.op : "operation"}: ${op.error}`];
+        });
+        return (`Edit batch: ${applied} applied, ${failed} failed. ${errors.join(" ")} ` +
+            (applied > 0
+                ? "Successful operations may already be saved. "
+                : "No operations applied. ") +
+            "Read the current document state before retrying or issuing dependent edits.");
+    }
+    return null;
+}
+/**
+ * Wire name → the capability namespace it is imported from, for the names a
+ * module owns. A session tool (a client `ui_*` schema, an external MCP tool)
+ * owns no module and is left out, which is how the guest's `tools` thrower
+ * tells "import it from here" from "ask searchTools".
+ */
+export function toolModuleMap(tools) {
+    const map = {};
+    for (const tool of tools) {
+        const module = capabilityModuleOf(tool.name);
+        if (module !== undefined)
+            map[tool.name] = module;
+    }
+    return map;
+}
+export function buildToolBridge(options) {
+    const byName = new Map(options.tools.map((t) => [t.name, t]));
+    const maxCalls = options.maxToolCallsPerAction ?? DEFAULT_MAX_TOOL_CALLS_PER_ACTION;
+    let calls = 0;
+    // Lifetime count across actions — the id a tool sees must stay unique.
+    let totalCalls = 0;
+    let pendingImages = [];
+    let droppedImages = 0;
+    const generationIds = new Set();
+    const callTool = async (name, argsJson) => {
+        try {
+            if (!isString(name) || !byName.has(name)) {
+                return {
+                    ok: false,
+                    error: `Unknown tool "${String(name)}". Available: ${[...byName.keys()].join(", ")}`
+                };
+            }
+            if (calls >= maxCalls) {
+                return {
+                    ok: false,
+                    error: `Tool-call budget for this action exhausted (max ${maxCalls} calls). Return an intermediate result and continue in the next action.`
+                };
+            }
+            calls++;
+            let args = {};
+            if (isNonEmptyString(argsJson)) {
+                try {
+                    const parsed = JSON.parse(argsJson);
+                    if (isRecord(parsed)) {
+                        args = parsed;
+                    }
+                    else if (parsed !== null) {
+                        return {
+                            ok: false,
+                            error: `tools.${name}: arguments must be an object`
+                        };
+                    }
+                }
+                catch {
+                    return { ok: false, error: `tools.${name}: arguments must be JSON-serializable` };
+                }
+            }
+            const tool = byName.get(name);
+            totalCalls++;
+            const toolCallId = `codeact_${totalCalls}`;
+            options.onToolCall?.({ name, args, toolCallId });
+            let result = await Tool.executeTool(tool, options.context, args, {
+                toolCallId
+            });
+            // Read before the error branch: a failed generation still answers with
+            // its id, and the registry decides later whether it completed.
+            const generationId = generationIdOf(result);
+            if (generationId !== null)
+                generationIds.add(generationId);
+            // A view-image-style result carries pixels the model asked for. They
+            // cannot ride the JSON observation (base64 would burn the context for
+            // nothing), so strip them here and let the caller forward them as a
+            // provider image message alongside the observation.
+            const injected = extractInjectableImages(result);
+            if (injected) {
+                for (const image of injected.images) {
+                    if (pendingImages.length < MAX_ACTION_IMAGES)
+                        pendingImages.push(image);
+                    else
+                        droppedImages++;
+                }
+                result = stripImagePayload(result);
+            }
+            const errorPayload = extractErrorPayload(result);
+            if (errorPayload !== null) {
+                options.onToolResult?.({
+                    name,
+                    toolCallId,
+                    result: errorPayload,
+                    isError: true
+                });
+                return { ok: false, error: `tools.${name}: ${errorPayload}` };
+            }
+            const transferable = toTransferable(compactResourceIds(result));
+            options.onToolResult?.({
+                name,
+                toolCallId,
+                result: transferable,
+                isError: false
+            });
+            return { ok: true, result: transferable };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                error: e instanceof Error ? e.message : String(e)
+            };
+        }
+    };
+    return {
+        globals: {
+            __callTool: callTool,
+            __toolNames: options.tools.map((t) => t.name),
+            __toolModules: toolModuleMap(options.tools)
+        },
+        callCount: () => calls,
+        resetActionBudget: () => {
+            calls = 0;
+        },
+        drainImages: () => {
+            const images = pendingImages;
+            const dropped = droppedImages;
+            pendingImages = [];
+            droppedImages = 0;
+            return { images, dropped };
+        },
+        generationIds: () => generationIds
+    };
+}
+/**
+ * Split a toolbelt into the tools also offered top level and the rest.
+ *
+ * Membership is {@link DIRECT_TOOL_NAMES}: the core set that mirrors a Claude
+ * Agent SDK built-in, plus discovery — which providers, models and node types
+ * this install has. Both are shapes a plain tool call fits, so a sandbox round
+ * trip whose only job is to forward one buys nothing.
+ *
+ * `core` is a view, not a removal: the belt keeps every tool, because the
+ * object model (`nodetool.models.pick`, `nodetool.web`, `nodetool.agents`) and
+ * any hand-written fan-out call them from inside an action. What the top-level
+ * offer changes is the *documented* path — the prompt catalog lists them as
+ * direct tools, and the default way to reach one is a tool call.
+ */
+export function splitCoreTools(tools) {
+    const core = [];
+    const belt = [];
+    for (const tool of tools) {
+        (DIRECT_TOOL_NAMES.has(tool.name) ? core : belt).push(tool);
+    }
+    return { core, belt };
+}
+/**
+ * Render core tools as provider tool definitions that execute themselves.
+ *
+ * The result travels as text; pixels a tool returns are handed back as image
+ * content blocks instead, the way the sandbox bridge holds them out of the
+ * observation.
+ */
+export function buildCoreProviderTools(options) {
+    return options.tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        execute: async (args, toolCallId) => {
+            const id = toolCallId ?? `core_${tool.name}`;
+            options.onToolCall?.({ name: tool.name, args, toolCallId: id });
+            let result = await Tool.executeTool(tool, options.context, args, {
+                toolCallId: id
+            });
+            const injected = extractInjectableImages(result);
+            if (!injected)
+                return JSON.stringify(toTransferable(result));
+            result = stripImagePayload(result);
+            return [
+                { type: "text", text: JSON.stringify(toTransferable(result)) },
+                ...injected.images
+            ];
+        }
+    }));
+}
+/**
+ * Guest-side prelude prepended to every code action. Builds the belt caller
+ * over `__callTool` (via {@link TOOLS_PRELUDE}) and `finish()` over
+ * `__finish`. Hosts without a `__finish` bridge — the Code node — prepend
+ * `TOOLS_PRELUDE` alone. Tool discovery lives on the object model as
+ * `nodetool.searchTools()`, so a session reaches every capability under one
+ * name.
+ */
+export const CODEACT_PRELUDE = `${TOOLS_PRELUDE}
+async function finish(result) {
+  const __r = await __finish(JSON.stringify(result === undefined ? null : result));
+  if (!__r || __r.ok !== true) {
+    throw new Error(__r && __r.error ? __r.error : "finish() rejected the result");
+  }
+  return "step finished";
+}
+`;
+/**
+ * Every name the guest already has beyond the sandbox manifest's own surface:
+ * the host bridges the executors install as `globals`, the wrappers
+ * {@link CODEACT_PRELUDE} builds over them, and the two optional object-model
+ * preludes. User code cannot rebind these, and prompt text may name them
+ * without the sandbox-manifest drift check calling them undefined.
+ */
+export const CODEACT_INJECTED_GLOBALS = [
+    // Host bridges (`runInSandbox` globals) plus the prelude's wrappers.
+    "tools",
+    "finish",
+    "__callTool",
+    "__finish",
+    "__toolNames",
+    "__toolModules",
+    "__callBeltTool",
+    "__searchTools",
+    "__graphQueues",
+    ...GRAPH_MODEL_GLOBALS,
+    ...NODETOOL_API_GLOBALS
+];
+/**
+ * The injected names a model's own code can collide with: the bindings above
+ * minus the `__`-prefixed host bridges, which nobody writes by accident.
+ *
+ * The prelude declares them with `const`, so `const tools = [...]` in an action
+ * is a SyntaxError before a line runs ("lexical redefinition of 'tools'") — a
+ * failure whose cause is invisible from the action's own source. They are named
+ * in the `execute_code` contract, and {@link annotateFailure} names the one
+ * that collided.
+ */
+export const RESERVED_ACTION_BINDINGS = CODEACT_INJECTED_GLOBALS.filter((name) => !name.startsWith("__"));
+/** One sentence naming the reserved bindings, for the action contract. */
+export const RESERVED_BINDINGS_SENTENCE = `The prelude already declares ${RESERVED_ACTION_BINDINGS.map((n) => `\`${n}\``).join(", ")}. ` +
+    "Declaring one of them again is a SyntaxError before your code runs, so " +
+    "name your own variables something else.";
+function schemaTypeLabel(schema, depth = 0) {
+    if (!isObjectLike(schema))
+        return "unknown";
+    const s = schema;
+    if (Array.isArray(s["enum"])) {
+        return s["enum"]
+            .slice(0, 6)
+            .map((v) => JSON.stringify(v))
+            .join(" | ");
+    }
+    const type = s["type"];
+    if (type === "array") {
+        return `${schemaTypeLabel(s["items"], depth + 1)}[]`;
+    }
+    if (type === "object") {
+        const props = s["properties"];
+        if (!props || depth >= 2)
+            return "object";
+        const required = new Set(Array.isArray(s["required"]) ? s["required"] : []);
+        const fields = Object.entries(props)
+            .map(([key, value]) => `${key}${required.has(key) ? "" : "?"}: ${schemaTypeLabel(value, depth + 1)}`)
+            .join(", ");
+        return `{${fields}}`;
+    }
+    if (type === "integer")
+        return "number";
+    if (isString(type))
+        return type;
+    if (Array.isArray(type))
+        return type.join(" | ");
+    return "unknown";
+}
+function firstSentence(text) {
+    const trimmed = text.trim().replace(/\s+/g, " ");
+    const period = trimmed.indexOf(". ");
+    return period > 0 ? trimmed.slice(0, period + 1) : trimmed;
+}
+/** The bare call signature: `await web_search({query: string, ...})`. */
+export function toolSignature(tool) {
+    const schema = tool.inputSchema;
+    const params = schemaTypeLabel(schema);
+    const args = params === "{}" ? "" : params;
+    return `await ${tool.name}(${args})`;
+}
+/** The specifier a capability is imported from, or `undefined` for a session tool. */
+export function toolSpecifier(name) {
+    const module = capabilityModuleOf(name);
+    return module === undefined
+        ? undefined
+        : sandboxCapabilitySpecifier(module);
+}
+/**
+ * The import statement that makes one capability callable, or `undefined` for
+ * a name no module owns.
+ */
+export function toolImportLine(name) {
+    const specifier = toolSpecifier(name);
+    return specifier === undefined
+        ? undefined
+        : `import { ${name} } from ${JSON.stringify(specifier)};`;
+}
+/** Signature bullet + first sentence of the description. */
+export function renderToolSignature(tool) {
+    const description = firstSentence(tool.description ?? "");
+    return description
+        ? `- ${toolSignature(tool)}\n  ${description}`
+        : `- ${toolSignature(tool)}`;
+}
+/**
+ * The catalog, grouped by the module each capability is imported from.
+ *
+ * The group header IS the import statement the action has to write, with every
+ * name in that group already in the braces — so a model that copies the header
+ * and then calls two of the listed signatures has written a working action.
+ * Listing a signature without saying where the name comes from is what made
+ * the flat belt readable at a glance and unwritable in practice.
+ */
+export function renderToolCatalog(tools, 
+/**
+ * Specifiers for names no capability module owns but the host has grafted
+ * onto a namespace anyway — a chat session's `ui_*` tools, a step's own
+ * belt. A name absent from it is documented as a plain tool call, which is
+ * what an external MCP tool is.
+ */
+grafted = new Map()) {
+    if (tools.length === 0)
+        return "(no tools available)";
+    const groups = new Map();
+    const ungrouped = [];
+    for (const tool of tools) {
+        const specifier = toolSpecifier(tool.name) ?? grafted.get(tool.name);
+        if (specifier === undefined) {
+            ungrouped.push(tool);
+            continue;
+        }
+        const group = groups.get(specifier);
+        if (group === undefined)
+            groups.set(specifier, [tool]);
+        else
+            group.push(tool);
+    }
+    const blocks = [...groups.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([specifier, group]) => [
+        `import { ${group.map((t) => t.name).join(", ")} } from ${JSON.stringify(specifier)};`,
+        ...group.map(renderToolSignature)
+    ].join("\n"));
+    if (ungrouped.length > 0) {
+        blocks.push(["// no import — these are called as ordinary tools:",
+            ...ungrouped.map(renderToolSignature)].join("\n"));
+    }
+    return blocks.join("\n\n");
+}
+/** One search hit, with everything needed to write the call. */
+export function toolSearchHit(tool, 
+/** The namespace a host grafted this name onto, if any. */
+graftedModule) {
+    const hit = {
+        name: tool.name,
+        signature: toolSignature(tool),
+        description: tool.description ?? ""
+    };
+    const module = capabilityModuleOf(tool.name) ?? graftedModule;
+    if (module !== undefined) {
+        hit.module = module;
+        hit.specifier = sandboxCapabilitySpecifier(module);
+        hit.import = `import { ${tool.name} } from ${JSON.stringify(sandboxCapabilitySpecifier(module))};`;
+    }
+    return hit;
+}
+//# sourceMappingURL=tool-api.js.map

package/dist/codeact/tool-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-api.js","sourceRoot":"","sources":["../../src/codeact/tool-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAA0B,MAAM,sBAAsB,CAAC;AAOjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,QAAQ,EACT,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAqDpD,0EAA0E;AAC1E,SAAS,cAAc,CAAC,MAAe;IACrC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;IACnC,OAAO,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,IACE,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC;QACf,SAAS,CAAC,KAAK,CAAC,EAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,YAAY,CAAC,UAAU,CAAC;YAC7B,CAAC,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC,CAAC,OAAO,CAAC;IACd,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IACxC,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9E,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YAChC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChE,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QACH,OAAO,CACL,eAAe,OAAO,aAAa,MAAM,YAAY,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;YACxE,CAAC,OAAO,GAAG,CAAC;gBACV,CAAC,CAAC,8CAA8C;gBAChD,CAAC,CAAC,yBAAyB,CAAC;YAC9B,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkC;IAElC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,QAAQ,GACZ,OAAO,CAAC,qBAAqB,IAAI,iCAAiC,CAAC;IACrE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,uEAAuE;IACvE,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,aAAa,GAA0B,EAAE,CAAC;IAC9C,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,MAAM,QAAQ,GAAG,KAAK,EACpB,IAAa,EACb,QAAiB,EACM,EAAE;QACzB,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,iBAAiB,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACrF,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;gBACtB,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,mDAAmD,QAAQ,yEAAyE;iBAC5I,CAAC;YACJ,CAAC;YACD,KAAK,EAAE,CAAC;YAER,IAAI,IAAI,GAA4B,EAAE,CAAC;YACvC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAC;oBAC/C,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBACrB,IAAI,GAAG,MAAiC,CAAC;oBAC3C,CAAC;yBAAM,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;wBAC3B,OAAO;4BACL,EAAE,EAAE,KAAK;4BACT,KAAK,EAAE,SAAS,IAAI,+BAA+B;yBACpD,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,IAAI,uCAAuC,EAAE,CAAC;gBACpF,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAS,CAAC;YACtC,UAAU,EAAE,CAAC;YACb,MAAM,UAAU,GAAG,WAAW,UAAU,EAAE,CAAC;YAC3C,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YAEjD,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;gBAC/D,UAAU;aACX,CAAC,CAAC;YACH,uEAAuE;YACvE,+DAA+D;YAC/D,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,YAAY,KAAK,IAAI;gBAAE,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC3D,qEAAqE;YACrE,sEAAsE;YACtE,oEAAoE;YACpE,oDAAoD;YACpD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACpC,IAAI,aAAa,CAAC,MAAM,GAAG,iBAAiB;wBAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;wBACnE,aAAa,EAAE,CAAC;gBACvB,CAAC;gBACD,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;YACD,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;oBACrB,IAAI;oBACJ,UAAU;oBACV,MAAM,EAAE,YAAY;oBACpB,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;gBACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,IAAI,KAAK,YAAY,EAAE,EAAE,CAAC;YAChE,CAAC;YACD,MAAM,YAAY,GAAG,cAAc,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,YAAY,EAAE,CAAC;gBACrB,IAAI;gBACJ,UAAU;gBACV,MAAM,EAAE,YAAY;gBACpB,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aAClD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7C,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC;SAC5C;QACD,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK;QACtB,iBAAiB,EAAE,GAAG,EAAE;YACtB,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;QACD,WAAW,EAAE,GAAG,EAAE;YAChB,MAAM,MAAM,GAAG,aAAa,CAAC;YAC7B,MAAM,OAAO,GAAG,aAAa,CAAC;YAC9B,aAAa,GAAG,EAAE,CAAC;YACnB,aAAa,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7B,CAAC;QACD,aAAa,EAAE,GAAG,EAAE,CAAC,aAAa;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,IAAI,GAAW,EAAE,CAAC;IACxB,MAAM,IAAI,GAAW,EAAE,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAItC;IACC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,KAAK,EACZ,IAA6B,EAC7B,UAAmB,EACiB,EAAE;YACtC,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAC7C,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;YAChE,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;gBAC/D,UAAU,EAAE,EAAE;aACf,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7D,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE;gBAC9D,GAAG,QAAQ,CAAC,MAAM;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,aAAa;;;;;;;;CAQ9C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,qEAAqE;IACrE,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;CACf,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GACrC,gCAAgC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;IAC9F,yEAAyE;IACzE,yCAAyC,CAAC;AAiB5C,SAAS,eAAe,CAAC,MAAe,EAAE,KAAK,GAAG,CAAC;IACjD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC7B,OAAQ,CAAC,CAAC,MAAM,CAAe;aAC5B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;aAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACvB,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,CAAC,CAAC,YAAY,CAAwC,CAAC;QACrE,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,UAAU,CAAc,CAAC,CAAC,CAAC,EAAE,CAChE,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aACjC,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,GAAG,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAChF;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,IAAI,MAAM,GAAG,CAAC;IACvB,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC7D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,IAAyB;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAyB,CAAC;IAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,SAAS,IAAI,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC;AACvC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,SAAS,KAAK,SAAS;QAC5B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,YAAY,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,IAAyB;IAC3D,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC1D,OAAO,WAAW;QAChB,CAAC,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,OAAO,WAAW,EAAE;QAC9C,CAAC,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA4B;AAC5B;;;;;GAKG;AACH,OAAO,GAAgC,IAAI,GAAG,EAAE;IAEhD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,sBAAsB,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiC,CAAC;IACxD,MAAM,SAAS,GAA0B,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;;YAClD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACjC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAC1B;QACE,YAAY,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG;QACtF,GAAG,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CACT,CAAC,oDAAoD;YACnD,GAAG,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAeD,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAC3B,IAAyB;AACzB,2DAA2D;AAC3D,aAAsB;IAEtB,MAAM,GAAG,GAAkB;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC;QAC9B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;KACpC,CAAC;IACF,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC;IAC9D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QACpB,GAAG,CAAC,SAAS,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACnD,GAAG,CAAC,MAAM,GAAG,YAAY,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;IACrG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}