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

package/dist/tools/external-mcp-tools.js

@@ -0,0 +1,552 @@
+/**
+ * External MCP servers on the toolbelt.
+ *
+ * A user configures a server (Blender, Hugging Face, a local script) and its
+ * tools become ordinary {@link Tool}s named `mcp_<server>_<tool>`. Because
+ * they are plain belt tools, every loop reaches them the same way: the base
+ * provider loop and the Responses loop dispatch through the harness
+ * `executeTool`, the Claude Agent SDK wraps the belt in its in-process MCP
+ * server, and a CodeAct guest imports them from
+ * `@nodetool-ai/sandbox-nodetool/mcp`.
+ *
+ * Connections live in an {@link McpClientPool}: one client per server config,
+ * opened on first use, replaced when the config changes, and closed when the
+ * server is removed. Discovery (`listTools`) is cached per connection so a
+ * belt can be assembled synchronously from the last-known list after the
+ * first turn has awaited it.
+ */
+import { createLogger } from "@nodetool-ai/config";
+import { mcpToolName, resolveSecretReferences } from "@nodetool-ai/protocol";
+import { Tool } from "./base-tool.js";
+import { IMAGE_CONTENTS_FIELD } from "./image-injection.js";
+import { isRecord, isString } from "../utils/type-guards.js";
+const log = createLogger("nodetool.agents.external-mcp");
+/** Longest stderr line kept in a log record. */
+const MAX_STDERR_CHARS = 500;
+/**
+ * How long one server has to finish opening. `Client.connect` awaits
+ * `transport.start()` before it sends the timed `initialize` request, so a
+ * server that accepts the socket and then says nothing — an HTTP server that
+ * refuses the Streamable POST and opens an SSE stream with no `endpoint`
+ * event — leaves that first await pending forever. Discovery holds the pool's
+ * queue while it waits, and every later save or delete queues behind it.
+ */
+const DEFAULT_CONNECT_TIMEOUT_MS = 30_000;
+/**
+ * Values shorter than this are not redacted. A one- or two-character secret
+ * would blank unrelated text everywhere it happened to occur, and nothing a
+ * server authenticates with is that short.
+ */
+const MIN_REDACTABLE_SECRET_CHARS = 4;
+/** Remember one value to blank out of anything this connection reports. */
+function rememberSecret(secrets, value) {
+    if (value.length >= MIN_REDACTABLE_SECRET_CHARS)
+        secrets.add(value);
+}
+/** Replace every value in `secrets` found in `text` with a marker. */
+function redact(text, secrets) {
+    let out = text;
+    for (const value of secrets) {
+        out = out.split(value).join("[redacted]");
+    }
+    return out;
+}
+/**
+ * An error's first line, bounded and with the entry's secrets blanked, so a
+ * response body never floods a log or carries a token into one. Redaction
+ * runs before the cut, so a token straddling the cut cannot survive it.
+ */
+function describeError(err, secrets) {
+    const message = err instanceof Error ? err.message : String(err);
+    return redact(message, secrets).split("\n")[0].slice(0, 200);
+}
+/** The same error, with its message redacted, for a caller's callback. */
+function redactedError(err, secrets) {
+    const message = err instanceof Error ? err.message : String(err);
+    return new Error(redact(message, secrets));
+}
+/**
+ * Keeps one live MCP client per configured server.
+ *
+ * `sync` is idempotent on the config list: unchanged servers keep their
+ * connection, changed ones reconnect, removed ones close. Nothing connects
+ * until `discover()` or a call needs it. Reconciliation is serialized so a
+ * `sync` cannot interleave with a `discover` that is dropping a dead entry.
+ */
+export class McpClientPool {
+    entries = new Map();
+    getSecret;
+    fetchImpl;
+    connectFn;
+    connectTimeoutMs;
+    queue = Promise.resolve();
+    constructor(options = {}) {
+        this.getSecret = options.getSecret ?? (async () => undefined);
+        this.fetchImpl = options.fetch;
+        this.connectFn =
+            options.connect ??
+                ((config, secrets, signal) => this.connect(config, secrets, signal));
+        this.connectTimeoutMs =
+            options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+    }
+    /** Run `fn` after every queued reconciliation, and before the next. */
+    serialized(fn) {
+        const next = this.queue.then(fn, fn);
+        this.queue = next.catch(() => undefined);
+        return next;
+    }
+    /** Reconcile the pool with the current config list. */
+    sync(configs) {
+        const wanted = new Map(configs.filter((c) => c.enabled).map((c) => [c.id, c]));
+        // Cancel what this list drops *before* queueing. A discovery waiting on a
+        // server that never answers holds the queue for the whole deadline, and
+        // disabling that server is exactly how the user recovers from it — so the
+        // cancellation must not be behind the discovery it ends.
+        for (const [id, entry] of this.entries) {
+            const next = wanted.get(id);
+            if (next === undefined || fingerprintOf(next) !== entry.fingerprint) {
+                entry.cancel.abort(cancelledError(entry.config.id));
+            }
+        }
+        return this.serialized(async () => {
+            for (const [id, entry] of this.entries) {
+                const next = wanted.get(id);
+                if (next === undefined || fingerprintOf(next) !== entry.fingerprint) {
+                    this.entries.delete(id);
+                    await closeEntry(entry);
+                }
+            }
+            for (const [id, config] of wanted) {
+                if (!this.entries.has(id)) {
+                    this.entries.set(id, this.openEntry(config));
+                }
+            }
+        });
+    }
+    /**
+     * Start one connection under its deadline. The timer aborts the entry's
+     * signal, which the transport is closed by, so an expired startup rejects
+     * here instead of pending inside the SDK.
+     */
+    openEntry(config) {
+        const secrets = new Set();
+        const cancel = new AbortController();
+        const timer = setTimeout(() => {
+            cancel.abort(new Error(`MCP server "${config.id}" did not answer within ${this.connectTimeoutMs}ms`));
+        }, this.connectTimeoutMs);
+        timer.unref?.();
+        const started = this.connectFn(config, secrets, cancel.signal);
+        // A connection that lands after its deadline has no owner: close it
+        // rather than leave a socket or a child process behind.
+        void started.then((client) => {
+            if (cancel.signal.aborted)
+                void client.close().catch(() => undefined);
+        }, () => undefined);
+        const client = Promise.race([
+            started,
+            abortRejection(cancel.signal)
+        ]).finally(() => clearTimeout(timer));
+        // The rejection is observed by whoever awaits the entry; without this a
+        // server that refuses between `sync` and `discover` is an unhandled
+        // rejection.
+        client.catch(() => undefined);
+        return {
+            config,
+            fingerprint: fingerprintOf(config),
+            client,
+            tools: null,
+            secrets,
+            cancel
+        };
+    }
+    /** Every configured server id with a live or pending connection. */
+    serverIds() {
+        return [...this.entries.keys()];
+    }
+    /**
+     * Discover the tools of every server, connecting where needed. A server
+     * that fails to connect is reported through `onError`, closed, and dropped
+     * so the next `sync` retries it; it does not sink the belt.
+     */
+    discover(onError) {
+        return this.serialized(async () => {
+            const out = new Map();
+            await Promise.all([...this.entries.values()].map(async (entry) => {
+                try {
+                    if (entry.tools === null) {
+                        const client = await entry.client;
+                        entry.tools = await listAllTools(client);
+                    }
+                    out.set(entry.config.id, entry.tools);
+                }
+                catch (err) {
+                    log.warn("MCP server unavailable", {
+                        server: entry.config.id,
+                        error: describeError(err, entry.secrets)
+                    });
+                    await this.evict(entry);
+                    onError?.(entry.config.id, redactedError(err, entry.secrets));
+                }
+            }));
+            return out;
+        });
+    }
+    /** The last discovered tool list, without connecting. */
+    cachedTools() {
+        const out = new Map();
+        for (const entry of this.entries.values()) {
+            if (entry.tools !== null)
+                out.set(entry.config.id, entry.tools);
+        }
+        return out;
+    }
+    /**
+     * Invoke one remote tool. A transport failure evicts the connection so the
+     * next turn reconnects; a tool that answered `isError` is not a failure.
+     */
+    async call(serverId, remoteName, args, signal) {
+        const entry = this.entries.get(serverId);
+        if (entry === undefined) {
+            throw new Error(`MCP server "${serverId}" is not configured or enabled`);
+        }
+        try {
+            const client = await entry.client;
+            const result = await client.callTool({ name: remoteName, arguments: args }, undefined, signal === undefined ? {} : { signal });
+            return normalizeCallResult(result);
+        }
+        catch (err) {
+            if (signal?.aborted !== true) {
+                await this.serialized(() => this.evict(entry));
+            }
+            throw redactedError(err, entry.secrets);
+        }
+    }
+    /** Close every connection. */
+    close() {
+        for (const entry of this.entries.values()) {
+            entry.cancel.abort(cancelledError(entry.config.id));
+        }
+        return this.serialized(async () => {
+            const entries = [...this.entries.values()];
+            this.entries.clear();
+            await Promise.all(entries.map(closeEntry));
+        });
+    }
+    /**
+     * Drop one entry — only if it is still the one the map holds, so a stale
+     * failure cannot remove a replacement a later `sync` installed. The close
+     * runs under the queue, so no reconnect starts before it finishes.
+     */
+    evict(entry) {
+        if (this.entries.get(entry.config.id) === entry) {
+            this.entries.delete(entry.config.id);
+        }
+        return closeEntry(entry);
+    }
+    async connect(config, secrets, signal) {
+        const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
+        const client = new Client({ name: "nodetool", version: "1.0.0" });
+        const transport = config.transport;
+        if (transport.type === "stdio") {
+            const { StdioClientTransport } = await import("@modelcontextprotocol/sdk/client/stdio.js");
+            const env = await resolveSecretReferences(transport.env, this.getSecret, (value) => rememberSecret(secrets, value));
+            rememberResolved(transport.env, env, secrets);
+            const stdio = new StdioClientTransport({
+                command: transport.command,
+                args: transport.args,
+                env: { ...inheritedChildEnv(), ...env },
+                cwd: transport.cwd,
+                stderr: "pipe"
+            });
+            // Drain the child's stderr before the handshake: an undrained pipe
+            // fills and blocks a server that logs before it answers `initialize`.
+            // Only a bounded line reaches the log, never the environment.
+            stdio.stderr?.on("data", (chunk) => {
+                const text = redact(chunk.toString(), secrets)
+                    .trim()
+                    .slice(0, MAX_STDERR_CHARS);
+                if (text)
+                    log.debug("MCP server stderr", { server: config.id, text });
+            });
+            await startTransport(client, stdio, signal, config.id);
+            return client;
+        }
+        const headers = await resolveSecretReferences(transport.headers, this.getSecret, (value) => rememberSecret(secrets, value));
+        rememberResolved(transport.headers, headers, secrets);
+        const url = new URL(transport.url);
+        const fetchOpt = this.fetchImpl === undefined ? {} : { fetch: this.fetchImpl };
+        const { StreamableHTTPClientTransport } = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
+        try {
+            const streamable = new StreamableHTTPClientTransport(url, {
+                requestInit: { headers },
+                ...fetchOpt
+            });
+            await startTransport(client, streamable, signal, config.id);
+            return client;
+        }
+        catch (err) {
+            await client.close().catch(() => undefined);
+            // A cancelled entry must not fall through and open a second transport.
+            if (signal.aborted)
+                throw cancelledError(config.id);
+            log.debug("Streamable HTTP failed, trying SSE", {
+                server: config.id,
+                error: describeError(err, secrets)
+            });
+        }
+        const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
+        const sseClient = new Client({ name: "nodetool", version: "1.0.0" });
+        const sse = new SSEClientTransport(url, {
+            requestInit: { headers },
+            ...fetchOpt
+        });
+        await startTransport(sseClient, sse, signal, config.id);
+        return sseClient;
+    }
+}
+/** The error a dropped or expired entry rejects its pending connection with. */
+function cancelledError(serverId) {
+    return new Error(`MCP server "${serverId}" connection cancelled`);
+}
+/** A promise that rejects when `signal` aborts, and never resolves. */
+function abortRejection(signal) {
+    return new Promise((_resolve, reject) => {
+        const fail = () => {
+            reject(signal.reason instanceof Error
+                ? signal.reason
+                : new Error("MCP connection cancelled"));
+        };
+        if (signal.aborted)
+            fail();
+        else
+            signal.addEventListener("abort", fail, { once: true });
+    });
+}
+/**
+ * Close a transport when its entry is cancelled. `Client.connect` awaits
+ * `transport.start()` before the timed `initialize` request, so closing the
+ * transport is the only thing that ends a startup nobody can finish.
+ */
+function closeOnAbort(signal, transport) {
+    const close = () => void transport.close().catch(() => undefined);
+    if (signal.aborted)
+        close();
+    else
+        signal.addEventListener("abort", close, { once: true });
+}
+/**
+ * Start one transport, refusing a startup its entry has already dropped.
+ *
+ * Everything before this point is awaited — resolving `${SECRET}` references,
+ * importing the SDK's transport module — so the user can disable the server,
+ * or the deadline can expire, while this connection is still being prepared.
+ * Closing an unstarted stdio transport does not mark it closed, so a
+ * `closeOnAbort` that fired during those awaits would not stop the `start()`
+ * below from spawning the command afterwards. The check and the start share
+ * one tick: `Client.connect` reaches `transport.start()` before its first
+ * await, so nothing can abort between them.
+ */
+async function startTransport(client, transport, signal, serverId) {
+    if (signal.aborted)
+        throw cancelledError(serverId);
+    closeOnAbort(signal, transport);
+    await client.connect(transport);
+}
+/** Every page of `tools/list`. */
+async function listAllTools(client) {
+    const tools = [];
+    let cursor;
+    do {
+        const page = await client.listTools(cursor === undefined ? undefined : { cursor });
+        for (const t of page.tools) {
+            tools.push({
+                name: t.name,
+                description: t.description,
+                inputSchema: (t.inputSchema ?? {
+                    type: "object",
+                    properties: {}
+                })
+            });
+        }
+        cursor = page.nextCursor;
+    } while (cursor !== undefined);
+    return tools;
+}
+async function closeEntry(entry) {
+    // Cancel first: a connection still opening is closed through its transport
+    // and rejects, rather than being waited on until its deadline.
+    entry.cancel.abort(cancelledError(entry.config.id));
+    try {
+        const client = await entry.client;
+        await client.close();
+    }
+    catch {
+        // A connection that never opened has nothing to close.
+    }
+}
+/**
+ * Record the finished values, beside the individual secrets the resolver
+ * already reported. Both are needed: an upstream error quotes the token
+ * (`Invalid token <tok>`) as readily as the header it arrived in
+ * (`Bearer <tok>`), and neither substring covers the other. Only what came
+ * out of a secret counts — a literal the user typed into the config is not a
+ * secret to blank.
+ */
+function rememberResolved(raw, resolved, secrets) {
+    for (const [key, value] of Object.entries(resolved)) {
+        if (value !== raw[key])
+            rememberSecret(secrets, value);
+    }
+}
+/** The parent's env: the SDK's default env is a short allowlist. */
+function inheritedChildEnv() {
+    const out = {};
+    for (const [k, v] of Object.entries(process.env)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+function fingerprintOf(config) {
+    return JSON.stringify(config);
+}
+export function normalizeCallResult(result) {
+    const out = {
+        text: "",
+        isError: false,
+        images: [],
+        links: []
+    };
+    if (!isRecord(result))
+        return out;
+    out.isError = result.isError === true;
+    if (result.structuredContent !== undefined) {
+        out.structured = result.structuredContent;
+    }
+    const parts = [];
+    const content = Array.isArray(result.content) ? result.content : [];
+    for (const block of content) {
+        if (!isRecord(block))
+            continue;
+        if (block.type === "text" && isString(block.text)) {
+            parts.push(block.text);
+        }
+        else if (block.type === "image" && isString(block.data)) {
+            out.images.push({
+                data: block.data,
+                mimeType: isString(block.mimeType) ? block.mimeType : "image/png"
+            });
+        }
+        else if (block.type === "resource" && isRecord(block.resource)) {
+            const res = block.resource;
+            if (isString(res.text))
+                parts.push(res.text);
+            else if (isString(res.uri))
+                parts.push(`[resource ${res.uri}]`);
+        }
+        else if (block.type === "resource_link" && isString(block.uri)) {
+            // A file the tool produced rather than inlined — the render it was
+            // asked for. Dropping it left a successful call with nothing to use.
+            const link = { uri: block.uri };
+            if (isString(block.name))
+                link.name = block.name;
+            if (isString(block.mimeType))
+                link.mimeType = block.mimeType;
+            if (isString(block.description))
+                link.description = block.description;
+            out.links.push(link);
+            parts.push(link.name === undefined
+                ? `[resource ${link.uri}]`
+                : `[resource ${link.name}: ${link.uri}]`);
+        }
+    }
+    out.text = parts.join("\n");
+    return out;
+}
+/** One remote MCP tool, as a belt tool. */
+export class ExternalMcpTool extends Tool {
+    pool;
+    serverId;
+    remote;
+    name;
+    description;
+    jsonSchema;
+    constructor(pool, serverId, remote, name = mcpToolName(serverId, remote.name)) {
+        super();
+        this.pool = pool;
+        this.serverId = serverId;
+        this.remote = remote;
+        this.name = name;
+        this.description =
+            remote.description?.trim() ||
+                `Tool "${remote.name}" from the MCP server "${serverId}".`;
+        this.jsonSchema = remote.inputSchema;
+    }
+    async process(context, params) {
+        let result;
+        try {
+            result = await this.pool.call(this.serverId, this.remote.name, params, context.signal);
+        }
+        catch (err) {
+            // `call` already redacted the message against the entry's secrets.
+            const message = err instanceof Error ? err.message : String(err);
+            return { error: "mcp_server_error", message: message.slice(0, 200) };
+        }
+        if (result.isError) {
+            return { error: "mcp_tool_error", message: result.text || "tool failed" };
+        }
+        const out = {};
+        if (result.structured !== undefined)
+            out.result = result.structured;
+        if (result.text)
+            out.text = result.text;
+        if (result.links.length > 0)
+            out.resource_links = result.links;
+        if (result.images.length > 0) {
+            out[IMAGE_CONTENTS_FIELD] = result.images.map((img) => ({
+                data: img.data,
+                mimeType: img.mimeType
+            }));
+        }
+        return out;
+    }
+}
+/**
+ * The belt contribution of every reachable server: one {@link ExternalMcpTool}
+ * per remote tool. Connects and discovers where needed.
+ */
+export async function getExternalMcpTools(pool, onError) {
+    const discovered = await pool.discover(onError);
+    return toolsFrom(pool, discovered);
+}
+/** Same as {@link getExternalMcpTools} from the cached discovery, no I/O. */
+export function getCachedExternalMcpTools(pool) {
+    return toolsFrom(pool, pool.cachedTools());
+}
+/**
+ * Two remote names that normalize to one belt name (`render.scene` and
+ * `render_scene`) get numbered suffixes, so neither is silently dropped by
+ * the belt's first-wins dedup. Servers and tools are walked in sorted order,
+ * so the same name maps to the same tool on every turn, whatever order
+ * discovery answered in.
+ */
+function toolsFrom(pool, byServer) {
+    const tools = [];
+    const taken = new Set();
+    const servers = [...byServer.entries()].sort(([a], [b]) => a.localeCompare(b));
+    for (const [serverId, unsorted] of servers) {
+        const remotes = [...unsorted].sort((a, b) => a.name.localeCompare(b.name));
+        for (const remote of remotes) {
+            const base = mcpToolName(serverId, remote.name);
+            let name = base;
+            for (let n = 2; taken.has(name); n += 1) {
+                const suffix = `_${n}`;
+                name = `${base.slice(0, 64 - suffix.length)}${suffix}`;
+            }
+            taken.add(name);
+            tools.push(new ExternalMcpTool(pool, serverId, remote, name));
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=external-mcp-tools.js.map

package/dist/tools/external-mcp-tools.js.map

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

package/dist/tools/finish-step-tool.d.ts

@@ -8,7 +8,7 @@ import { Tool } from "./base-tool.js";
 export declare class FinishStepTool extends Tool {
     readonly name = "finish_step";
     readonly description: string;
-    readonly inputSchema: Record<string, unknown>;
+    readonly jsonSchema: Record<string, unknown>;
     constructor(outputSchema?: Record<string, unknown>);
     process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
     userMessage(_params: Record<string, unknown>): string;

package/dist/tools/finish-step-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish-step-tool.d.ts","sourceRoot":"","sources":["../../src/tools/finish-step-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,qBAAa,cAAe,SAAQ,IAAI;IACtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,SAG8C;IAElE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAElC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgD5C,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAMnB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAGtD"}
+{"version":3,"file":"finish-step-tool.d.ts","sourceRoot":"","sources":["../../src/tools/finish-step-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,qBAAa,cAAe,SAAQ,IAAI;IACtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,SAG8C;IAElE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7C,YAAY,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EA8CjD;IAEK,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAIlB;IAED,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEpD;CACF"}

package/dist/tools/finish-step-tool.js

@@ -9,7 +9,7 @@ export class FinishStepTool extends Tool {
     description = "Call this tool when you have completed the step and have the final result ready. " +
         "This is the ONLY way to properly signal step completion. Do not output raw JSON blocks. " +
         "The result must conform to the step's declared output schema.";
-    inputSchema;
+    jsonSchema;
     constructor(outputSchema) {
         super();
         if (outputSchema) {
@@ -33,7 +33,7 @@ export class FinishStepTool extends Tool {
                 !("additionalProperties" in resultSchema)) {
                 resultSchema["additionalProperties"] = false;
             }
-            this.inputSchema = {
+            this.jsonSchema = {
                 type: "object",
                 properties: {
                     result: resultSchema
@@ -43,7 +43,7 @@ export class FinishStepTool extends Tool {
             };
         }
         else {
-            this.inputSchema = {
+            this.jsonSchema = {
                 type: "object",
                 properties: {
                     result: {

package/dist/tools/finish-step-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"finish-step-tool.js","sourceRoot":"","sources":["../../src/tools/finish-step-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,MAAM,OAAO,cAAe,SAAQ,IAAI;IAC7B,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAClB,mFAAmF;QACnF,0FAA0F;QAC1F,+DAA+D,CAAC;IAEzD,WAAW,CAA0B;IAE9C,YAAY,YAAsC;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;YACvC,wEAAwE;YACxE,qEAAqE;YACrE,mEAAmE;YACnE,wBAAwB;YACxB,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;gBACrC,YAAY,GAAG;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,IAAI,gBAAgB;oBAC5D,UAAU,EAAE;wBACV,KAAK,EAAE,YAAY;qBACpB;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;oBACnB,oBAAoB,EAAE,KAAK;iBAC5B,CAAC;YACJ,CAAC;YACD,IACE,YAAY,CAAC,MAAM,CAAC,KAAK,QAAQ;gBACjC,CAAC,CAAC,sBAAsB,IAAI,YAAY,CAAC,EACzC,CAAC;gBACD,YAAY,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,WAAW,GAAG;gBACjB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,YAAY;iBACrB;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,GAAG;gBACjB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,yBAAyB;qBACvC;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAA2B,EAC3B,MAA+B;QAE/B,0DAA0D;QAC1D,oEAAoE;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,OAAgC;QAC1C,OAAO,gCAAgC,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"finish-step-tool.js","sourceRoot":"","sources":["../../src/tools/finish-step-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,MAAM,OAAO,cAAe,SAAQ,IAAI;IAC7B,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAClB,mFAAmF;QACnF,0FAA0F;QAC1F,+DAA+D,CAAC;IAEzD,UAAU,CAA0B;IAE7C,YAAY,YAAsC;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;YACvC,wEAAwE;YACxE,qEAAqE;YACrE,mEAAmE;YACnE,wBAAwB;YACxB,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;gBACrC,YAAY,GAAG;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,IAAI,gBAAgB;oBAC5D,UAAU,EAAE;wBACV,KAAK,EAAE,YAAY;qBACpB;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;oBACnB,oBAAoB,EAAE,KAAK;iBAC5B,CAAC;YACJ,CAAC;YACD,IACE,YAAY,CAAC,MAAM,CAAC,KAAK,QAAQ;gBACjC,CAAC,CAAC,sBAAsB,IAAI,YAAY,CAAC,EACzC,CAAC;gBACD,YAAY,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,UAAU,GAAG;gBAChB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE,YAAY;iBACrB;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,GAAG;gBAChB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,yBAAyB;qBACvC;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAA2B,EAC3B,MAA+B;QAE/B,0DAA0D;QAC1D,oEAAoE;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,OAAgC;QAC1C,OAAO,gCAAgC,CAAC;IAC1C,CAAC;CACF"}