@nexface/tools 0.1.0

package/dist/runtime.js

@@ -0,0 +1,492 @@
+import { isValidAgentContextName } from "./definition.js";
+import { validateAgentToolInput } from "./schema.js";
+import { createBrowserToolset, } from "./browser/toolset.js";
+const CONTEXT_ERROR_CODES = [
+    "CONTEXT_DISPOSED",
+    "CONTEXT_NAME_MISMATCH",
+    "DUPLICATE_CONTEXT",
+    "INVALID_CONTEXT",
+];
+const TOOL_ERROR_CODES = [
+    "ACTION_IN_FLIGHT",
+    "ACTION_NOT_HANDLED",
+    "ACTION_TARGET_UNAVAILABLE",
+    "BROWSER_EXECUTION_FAILED",
+    "BROWSER_SNAPSHOT_REQUIRED",
+    "BROWSER_TOOLS_UNAVAILABLE",
+    "CONTRACT_MISMATCH",
+    "DUPLICATE_BINDING",
+    "INVALID_INPUT",
+    "INVALID_TOOL_RUNTIME",
+    "TOOL_CANCELLED",
+    "TOOL_REGISTRATION_TIMEOUT",
+    "TOOL_SKIPPED",
+    "TOOL_UNAVAILABLE",
+    "UNKNOWN_TOOL",
+];
+const CONTEXT_ERROR_CODE_SET = new Set(CONTEXT_ERROR_CODES);
+const TOOL_ERROR_CODE_SET = new Set(TOOL_ERROR_CODES);
+export function isToolRuntimeError(error) {
+    if (!error || typeof error !== "object")
+        return false;
+    const candidate = error;
+    if (candidate.type !== "tool_runtime_error"
+        || typeof candidate.message !== "string"
+        || typeof candidate.code !== "string") {
+        return false;
+    }
+    if (candidate.domain === "tool") {
+        return TOOL_ERROR_CODE_SET.has(candidate.code);
+    }
+    if (candidate.domain === "context") {
+        return CONTEXT_ERROR_CODE_SET.has(candidate.code);
+    }
+    return false;
+}
+function copyBrowserToolsConfig(config) {
+    if (config === undefined)
+        return false;
+    if (typeof config === "boolean")
+        return config;
+    return {
+        ...config,
+        ...(config.limits ? { limits: { ...config.limits } } : {}),
+        ...(config.snapshotLimits
+            ? { snapshotLimits: { ...config.snapshotLimits } }
+            : {}),
+    };
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function assertContextName(name) {
+    if (!isValidAgentContextName(name)) {
+        throw new AgentContextError("INVALID_CONTEXT", `Invalid or reserved context name: ${name}.`);
+    }
+}
+function normalizeContextValue(value, path = "value", seen = new WeakSet()) {
+    if (value === null
+        || typeof value === "string"
+        || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new AgentContextError("INVALID_CONTEXT", `${path} must contain only finite numbers.`);
+        }
+        return value;
+    }
+    if (!value || typeof value !== "object") {
+        throw new AgentContextError("INVALID_CONTEXT", `${path} must be JSON serializable.`);
+    }
+    if (seen.has(value)) {
+        throw new AgentContextError("INVALID_CONTEXT", `${path} contains a circular reference.`);
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((item, index) => normalizeContextValue(item, `${path}[${index}]`, seen));
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new AgentContextError("INVALID_CONTEXT", `${path} must contain only plain objects.`);
+        }
+        return Object.fromEntries(Object.keys(value)
+            .sort(compareStrings)
+            .map((key) => [
+            key,
+            normalizeContextValue(value[key], `${path}.${key}`, seen),
+        ]));
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function normalizeContext(context) {
+    assertContextName(context.name);
+    if (!context.description.trim()) {
+        throw new AgentContextError("INVALID_CONTEXT", "Context description is required.");
+    }
+    return {
+        name: context.name,
+        description: context.description,
+        value: normalizeContextValue(context.value),
+    };
+}
+class DetailEvent extends Event {
+    detail;
+    constructor(type, detail) {
+        super(type);
+        this.detail = detail;
+    }
+}
+export class AgentToolError extends Error {
+    code;
+    details;
+    type = "tool_runtime_error";
+    domain = "tool";
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "ToolRuntimeError";
+    }
+}
+export class AgentContextError extends Error {
+    code;
+    type = "tool_runtime_error";
+    domain = "context";
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ToolRuntimeError";
+    }
+}
+const runtimeInternals = new WeakMap();
+export function createToolRuntime(options = {}) {
+    return new ToolRuntimeImplementation(options);
+}
+export function getInternalToolRuntime(runtime) {
+    const internal = runtimeInternals.get(runtime);
+    if (!internal) {
+        throw new AgentToolError("INVALID_TOOL_RUNTIME", "ToolRuntime must be created by createToolRuntime().");
+    }
+    return internal;
+}
+export class ToolRuntimeImplementation extends EventTarget {
+    #browserToolsConfig;
+    #bindings = new Map();
+    #contexts = new Map();
+    #contextRevision = 0;
+    #browserToolset;
+    #executionTail;
+    constructor(options = {}) {
+        super();
+        this.#browserToolsConfig = copyBrowserToolsConfig(options.browserTools);
+        runtimeInternals.set(this, this);
+    }
+    register(definition, execute, options = {}) {
+        if (this.#bindings.has(definition.name)) {
+            throw new AgentToolError("DUPLICATE_BINDING", `Tool "${definition.name}" already has an active binding.`);
+        }
+        const binding = { definition, execute };
+        this.#bindings.set(definition.name, binding);
+        this.dispatchEvent(new DetailEvent("toolchange", {
+            name: definition.name,
+            registered: true,
+        }));
+        let disposed = false;
+        const dispose = () => {
+            if (disposed || this.#bindings.get(definition.name) !== binding)
+                return;
+            disposed = true;
+            options.signal?.removeEventListener("abort", dispose);
+            this.#bindings.delete(definition.name);
+            this.dispatchEvent(new DetailEvent("toolchange", {
+                name: definition.name,
+                registered: false,
+            }));
+        };
+        if (options.signal?.aborted)
+            dispose();
+        else
+            options.signal?.addEventListener("abort", dispose, { once: true });
+        return dispose;
+    }
+    registerContext(input, options = {}) {
+        const initial = normalizeContext(input);
+        if (this.#contexts.has(initial.name)) {
+            throw new AgentContextError("DUPLICATE_CONTEXT", `Context "${initial.name}" already has an active registration.`);
+        }
+        this.#contexts.set(initial.name, initial);
+        this.#notifyContextChange(initial.name, "registered");
+        let disposed = false;
+        const dispose = () => {
+            if (disposed)
+                return;
+            disposed = true;
+            options.signal?.removeEventListener("abort", dispose);
+            if (this.#contexts.delete(initial.name)) {
+                this.#notifyContextChange(initial.name, "disposed");
+            }
+        };
+        const update = (nextInput) => {
+            if (disposed) {
+                throw new AgentContextError("CONTEXT_DISPOSED", `Context "${initial.name}" registration has been disposed.`);
+            }
+            const next = normalizeContext(nextInput);
+            if (next.name !== initial.name) {
+                throw new AgentContextError("CONTEXT_NAME_MISMATCH", `Context registration "${initial.name}" cannot be updated to "${next.name}".`);
+            }
+            if (JSON.stringify(this.#contexts.get(initial.name)) === JSON.stringify(next))
+                return;
+            this.#contexts.set(initial.name, next);
+            this.#notifyContextChange(initial.name, "updated");
+        };
+        if (options.signal?.aborted)
+            dispose();
+        else
+            options.signal?.addEventListener("abort", dispose, { once: true });
+        return { update, dispose };
+    }
+    getContextsNow() {
+        return [...this.#contexts.values()]
+            .sort((left, right) => compareStrings(left.name, right.name))
+            .map(normalizeContext);
+    }
+    getContextRevision() {
+        return this.#contextRevision;
+    }
+    async getContexts(options = {}) {
+        options.signal?.throwIfAborted();
+        await Promise.resolve();
+        await new Promise((resolve, reject) => {
+            let settled = false;
+            let frameId;
+            let timeoutId;
+            const cleanup = () => {
+                options.signal?.removeEventListener("abort", onAbort);
+                if (frameId !== undefined && typeof cancelAnimationFrame === "function") {
+                    cancelAnimationFrame(frameId);
+                }
+                if (timeoutId !== undefined)
+                    clearTimeout(timeoutId);
+            };
+            const settle = () => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                resolve();
+            };
+            const onAbort = () => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(options.signal?.reason);
+            };
+            const afterTask = () => {
+                timeoutId = undefined;
+                if (typeof requestAnimationFrame !== "function") {
+                    settle();
+                    return;
+                }
+                frameId = requestAnimationFrame(settle);
+                timeoutId = setTimeout(settle, 50);
+            };
+            options.signal?.addEventListener("abort", onAbort, { once: true });
+            if (options.signal?.aborted) {
+                onAbort();
+                return;
+            }
+            timeoutId = setTimeout(afterTask, 0);
+        });
+        await Promise.resolve();
+        options.signal?.throwIfAborted();
+        return this.getContextsNow();
+    }
+    #notifyContextChange(name, change) {
+        this.#contextRevision += 1;
+        this.dispatchEvent(new DetailEvent("contextchange", {
+            name,
+            change,
+            revision: this.#contextRevision,
+        }));
+    }
+    getApplicationTools() {
+        return [...this.#bindings.values()]
+            .map(({ definition }) => definition)
+            .sort((left, right) => compareStrings(left.name, right.name));
+    }
+    isRegistered(name) {
+        return this.#bindings.has(name);
+    }
+    getTools() {
+        const browserTools = this.#getBrowserToolset()?.definitions ?? [];
+        return [...this.getApplicationTools(), ...browserTools]
+            .sort((left, right) => compareStrings(left.name, right.name));
+    }
+    waitForTool(definition, options = {}) {
+        const isTargetRegistered = () => this.#bindings.has(definition.name);
+        if (isTargetRegistered())
+            return Promise.resolve();
+        const timeoutMs = Math.max(1, options.timeoutMs ?? 5_000);
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const cleanup = () => {
+                this.removeEventListener("toolchange", onToolChange);
+                options.signal?.removeEventListener("abort", onAbort);
+                clearTimeout(timeoutId);
+            };
+            const settle = (callback) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                callback();
+            };
+            const onToolChange = (event) => {
+                const detail = event.detail;
+                if (detail?.name !== definition.name || !detail.registered)
+                    return;
+                if (isTargetRegistered())
+                    settle(resolve);
+            };
+            const onAbort = () => settle(() => reject(options.signal?.reason));
+            const timeoutId = setTimeout(() => {
+                settle(() => reject(new AgentToolError("TOOL_REGISTRATION_TIMEOUT", `Tool "${definition.name}" did not register within ${timeoutMs}ms.`, {
+                    toolName: definition.name,
+                    timeoutMs,
+                    retryable: false,
+                    browserFallbackAllowed: true,
+                    toolExecuted: false,
+                })));
+            }, timeoutMs);
+            this.addEventListener("toolchange", onToolChange);
+            if (options.signal?.aborted)
+                onAbort();
+            else
+                options.signal?.addEventListener("abort", onAbort, { once: true });
+            if (isTargetRegistered())
+                settle(resolve);
+        });
+    }
+    execute(definition, input, options = {}) {
+        const name = definition.name;
+        const binding = this.#bindings.get(name);
+        if (binding) {
+            if (binding.definition !== definition) {
+                return Promise.reject(new AgentToolError("CONTRACT_MISMATCH", `Tool "${name}" is registered with a different Definition.`));
+            }
+            return this.#enqueue(() => this.#executeApplication(name, input, options, binding), options.signal);
+        }
+        try {
+            const browserToolset = this.#getBrowserToolset();
+            const browserHandler = browserToolset?.handlers.get(name);
+            if (!browserHandler) {
+                return Promise.reject(new AgentToolError("UNKNOWN_TOOL", `Unknown tool: ${name}.`));
+            }
+            if (!browserToolset?.definitions.some((candidate) => candidate === definition)) {
+                return Promise.reject(new AgentToolError("CONTRACT_MISMATCH", `Tool "${name}" is registered with a different Definition.`));
+            }
+            return this.#enqueue(async () => {
+                const signal = options.signal ?? new AbortController().signal;
+                signal.throwIfAborted();
+                return browserHandler.execute(input, {
+                    signal,
+                });
+            }, options.signal);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    }
+    executeApplicationTool(name, input, options = {}) {
+        const binding = this.#bindings.get(name);
+        if (!binding) {
+            return Promise.reject(new AgentToolError("UNKNOWN_TOOL", `Unknown tool: ${name}.`));
+        }
+        return this.#enqueue(() => {
+            const activeBinding = this.#bindings.get(name);
+            if (!activeBinding) {
+                throw new AgentToolError("UNKNOWN_TOOL", `Unknown tool: ${name}.`);
+            }
+            if (options.expectedDefinition
+                && activeBinding.definition !== options.expectedDefinition) {
+                throw new AgentToolError("CONTRACT_MISMATCH", `Tool "${name}" changed after the model request was sent.`);
+            }
+            return this.#executeApplication(name, input, options, activeBinding);
+        }, options.signal);
+    }
+    #enqueue(execute, signal) {
+        const previous = this.#executionTail;
+        let removeQueuedAbort = () => { };
+        const queuedExecution = previous
+            ? previous.then(() => {
+                removeQueuedAbort();
+                signal?.throwIfAborted();
+                return execute();
+            })
+            : execute();
+        let execution = queuedExecution;
+        if (previous && signal) {
+            execution = new Promise((resolve, reject) => {
+                const onAbort = () => {
+                    removeQueuedAbort();
+                    reject(signal.reason);
+                };
+                removeQueuedAbort = () => signal.removeEventListener("abort", onAbort);
+                queuedExecution.then(resolve, reject);
+                if (signal.aborted)
+                    onAbort();
+                else
+                    signal.addEventListener("abort", onAbort, { once: true });
+            });
+        }
+        const tail = queuedExecution.then(() => undefined, () => undefined);
+        this.#executionTail = tail;
+        void tail.then(() => {
+            if (this.#executionTail === tail)
+                this.#executionTail = undefined;
+        });
+        return execution;
+    }
+    async #executeApplication(name, input, options, binding) {
+        const id = globalThis.crypto?.randomUUID?.()
+            ?? `${Date.now()}-${Math.random()}`;
+        const startedAt = Date.now();
+        const running = {
+            id,
+            name,
+            status: "running",
+            startedAt,
+            input,
+        };
+        this.dispatchEvent(new DetailEvent("toolexecution", running));
+        try {
+            if (this.#bindings.get(name) !== binding) {
+                throw new AgentToolError("UNKNOWN_TOOL", `Tool "${name}" is no longer registered for this call.`);
+            }
+            const errors = validateAgentToolInput(binding.definition.inputSchema, input);
+            if (errors.length) {
+                throw new AgentToolError("INVALID_INPUT", errors.join(" "), { errors });
+            }
+            const signal = options.signal ?? new AbortController().signal;
+            signal.throwIfAborted();
+            const result = await binding.execute(input, {
+                signal,
+                waitForTool: (definition, waitOptions = {}) => this.waitForTool(definition, { signal, ...waitOptions }),
+            });
+            signal.throwIfAborted();
+            this.dispatchEvent(new DetailEvent("toolexecution", {
+                ...running,
+                status: "success",
+                finishedAt: Date.now(),
+                result,
+            }));
+            return result;
+        }
+        catch (error) {
+            this.dispatchEvent(new DetailEvent("toolexecution", {
+                ...running,
+                status: "error",
+                finishedAt: Date.now(),
+                error,
+            }));
+            throw error;
+        }
+    }
+    #getBrowserToolset() {
+        if (this.#browserToolsConfig === false)
+            return undefined;
+        if (!this.#browserToolset) {
+            const options = this.#browserToolsConfig === true
+                ? {}
+                : this.#browserToolsConfig;
+            this.#browserToolset = createBrowserToolset(options);
+        }
+        return this.#browserToolset;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+import type { JsonSchema } from "./types.js";
+export declare function validateAgentToolInput(schema: JsonSchema, value: unknown, path?: string): string[];

package/dist/schema.js

@@ -0,0 +1,46 @@
+function typeMatches(schema, value) {
+    switch (schema.type) {
+        case undefined:
+            return true;
+        case "null":
+            return value === null;
+        case "array":
+            return Array.isArray(value);
+        case "object":
+            return value !== null && typeof value === "object" && !Array.isArray(value);
+        case "integer":
+            return typeof value === "number" && Number.isInteger(value);
+        default:
+            return typeof value === schema.type;
+    }
+}
+export function validateAgentToolInput(schema, value, path = "input") {
+    if (!typeMatches(schema, value)) {
+        return [`${path} must be ${schema.type}.`];
+    }
+    if (schema.enum && !schema.enum.some((item) => Object.is(item, value))) {
+        return [`${path} must be one of the declared enum values.`];
+    }
+    if (schema.type === "array" && Array.isArray(value) && schema.items) {
+        return value.flatMap((item, index) => validateAgentToolInput(schema.items, item, `${path}[${index}]`));
+    }
+    if (schema.type !== "object" || value === null || typeof value !== "object") {
+        return [];
+    }
+    const record = value;
+    const errors = [];
+    for (const key of schema.required ?? []) {
+        if (!(key in record))
+            errors.push(`${path}.${key} is required.`);
+    }
+    for (const [key, item] of Object.entries(record)) {
+        const property = schema.properties?.[key];
+        if (property)
+            errors.push(...validateAgentToolInput(property, item, `${path}.${key}`));
+        else if (schema.additionalProperties === false) {
+            errors.push(`${path}.${key} is not allowed.`);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW,CAAC,MAAkB,EAAE,KAAc;IACrD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,IAAI,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9E,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9D;YACE,OAAO,OAAO,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC;IACxC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAkB,EAClB,KAAc,EACd,IAAI,GAAG,OAAO;IAEd,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,IAAI,YAAY,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACvE,OAAO,CAAC,GAAG,IAAI,2CAA2C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnC,sBAAsB,CAAC,MAAM,CAAC,KAAM,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CACjE,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5E,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,eAAe,CAAC,CAAC;IACnE,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;aAClF,IAAI,MAAM,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,kBAAkB,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export type JsonSchema = {
+    type?: "object" | "array" | "string" | "number" | "integer" | "boolean" | "null";
+    description?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: readonly string[];
+    items?: JsonSchema;
+    enum?: readonly unknown[];
+    additionalProperties?: boolean;
+};
+export type AgentToolInputSchema = JsonSchema & {
+    type: "object";
+};
+type Simplify<TValue> = {
+    [TKey in keyof TValue]: TValue[TKey];
+};
+type RequiredPropertyKeys<TSchema extends JsonSchema, TProperties extends Record<string, JsonSchema>> = TSchema extends {
+    readonly required: readonly (infer TKey)[];
+} ? Extract<TKey, keyof TProperties> : never;
+type InferObjectSchema<TSchema extends JsonSchema, TProperties extends Record<string, JsonSchema>> = keyof TProperties extends never ? TSchema extends {
+    readonly additionalProperties: false;
+} ? Record<string, never> : Record<string, unknown> : Simplify<{
+    [TKey in RequiredPropertyKeys<TSchema, TProperties>]-?: InferJsonSchema<TProperties[TKey]>;
+} & {
+    [TKey in Exclude<keyof TProperties, RequiredPropertyKeys<TSchema, TProperties>>]?: InferJsonSchema<TProperties[TKey]>;
+}> & (TSchema extends {
+    readonly additionalProperties: false;
+} ? unknown : Record<string, unknown>);
+export type InferJsonSchema<TSchema extends JsonSchema> = TSchema extends {
+    readonly enum: readonly (infer TValue)[];
+} ? TValue : TSchema extends {
+    readonly type: "string";
+} ? string : TSchema extends {
+    readonly type: "number" | "integer";
+} ? number : TSchema extends {
+    readonly type: "boolean";
+} ? boolean : TSchema extends {
+    readonly type: "null";
+} ? null : TSchema extends {
+    readonly type: "array";
+    readonly items: infer TItem extends JsonSchema;
+} ? InferJsonSchema<TItem>[] : TSchema extends {
+    readonly type: "array";
+} ? unknown[] : TSchema extends {
+    readonly type: "object";
+    readonly properties: infer TProperties extends Record<string, JsonSchema>;
+} ? InferObjectSchema<TSchema, TProperties> : TSchema extends {
+    readonly type: "object";
+} ? TSchema extends {
+    readonly additionalProperties: false;
+} ? Record<string, never> : Record<string, unknown> : unknown;
+export type AgentContextValue = string | number | boolean | null | readonly AgentContextValue[] | {
+    readonly [key: string]: AgentContextValue;
+};
+export interface AgentContextEntry {
+    name: string;
+    description: string;
+    value: AgentContextValue;
+}
+export type AgentContextInput = AgentContextEntry;
+export interface AgentContextRegistration {
+    update(context: AgentContextInput): void;
+    dispose(): void;
+}
+export interface AgentToolMetadata {
+    name: string;
+    description: string;
+    inputSchema: AgentToolInputSchema;
+}
+export interface AgentToolDefinition<TInput = Record<string, unknown>, TResult = unknown> extends AgentToolMetadata {
+    readonly __input?: TInput;
+    readonly __result?: TResult;
+}
+export interface AgentToolExecutionContext {
+    signal: AbortSignal;
+    waitForTool(definition: AgentToolDefinition<any, any>, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+}
+export type AgentToolExecutor<TInput, TResult> = (input: TInput, context: AgentToolExecutionContext) => TResult | Promise<TResult>;
+export {};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/webmcp.d.ts

@@ -0,0 +1,2 @@
+import type { InternalToolRuntime } from "./runtime.js";
+export declare function connectToolRuntimeToWebMcp(runtime: InternalToolRuntime): () => void;