@dex-ai/sdk 0.1.30

package/dist/resolve-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-schema.d.ts","sourceRoot":"","sources":["../src/resolve-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAY5E;AAoPD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,oBAAoB,EAAE,CAmFxB"}

package/dist/resolve-schema.js

@@ -0,0 +1,367 @@
+/**
+ * resolveJsonSchema — resolve a StandardSchemaV1 to a JSON Schema object.
+ *
+ * This is the SDK's single point of truth for schema → JSON Schema conversion.
+ * It handles:
+ *   1. Pre-computed `~standard.jsonSchema` (fast path — already resolved)
+ *   2. Zod v4 native `toJSONSchema()` (schema carries its own converter)
+ *   3. Zod v3 via `zod-to-json-schema` (legacy path)
+ *   4. Any Standard Schema with `~standard.schema` field
+ *
+ * The result is cached on the schema object so repeated calls are free.
+ *
+ * Providers should call `resolveJsonSchema(tool.parameters)` instead of
+ * doing their own Zod import gymnastics.
+ */
+/** WeakMap cache so we resolve each schema object only once. */
+const cache = new WeakMap();
+/**
+ * Resolve a Standard Schema to a JSON Schema object.
+ *
+ * Call this from providers when building API requests. It handles all
+ * supported schema libraries transparently.
+ */
+export function resolveJsonSchema(schema) {
+    if (!schema)
+        return { type: "object", properties: {} };
+    // Check cache first
+    const cached = cache.get(schema);
+    if (cached)
+        return cached;
+    let result = doResolve(schema);
+    result = sanitize(result);
+    cache.set(schema, result);
+    return result;
+}
+/* ------------------------------------------------------------------ */
+/* Resolution strategies                                               */
+/* ------------------------------------------------------------------ */
+function doResolve(schema) {
+    const std = schema["~standard"];
+    // 1. Fast path: pre-computed jsonSchema (set by SDK Schema builder or manually)
+    if (std?.jsonSchema && typeof std.jsonSchema === "object") {
+        const js = std.jsonSchema;
+        // Validate it looks like actual JSON Schema (not Zod v4's types descriptor)
+        if (looksLikeJsonSchema(js))
+            return { ...js };
+    }
+    // 2. Zod v4 path: schema has toJSONSchema on its module
+    if (std?.vendor === "zod") {
+        const resolved = tryZodV4(schema);
+        if (resolved)
+            return resolved;
+    }
+    // 3. Zod v3 path: try zod-to-json-schema
+    const zodV3Result = tryZodV3(schema);
+    if (zodV3Result)
+        return zodV3Result;
+    // 4. Fallback: ~standard.schema field (some libs put raw JSON Schema here)
+    if (std?.schema && typeof std.schema === "object") {
+        return { ...std.schema };
+    }
+    // Nothing worked — return empty object schema
+    return { type: "object", properties: {} };
+}
+/* ------------------------------------------------------------------ */
+/* Zod v4: use its native toJSONSchema                                 */
+/* ------------------------------------------------------------------ */
+function tryZodV4(schema) {
+    try {
+        // Zod v4 schemas have a _zod property with their registry
+        const zod = schema;
+        // Strategy A: try importing from zod/v4/core which has toJSONSchema
+        // The schema object in Zod v4 has `_zod.def` — we can use the Zod module
+        // that created it if it's accessible.
+        if (zod._zod?.def) {
+            // Try to get toJSONSchema from the zod module that created this schema.
+            // Zod v4 schemas are created by a specific zod instance — the instance
+            // may expose toJSONSchema.
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const zodMod = require("zod");
+                if (typeof zodMod.toJSONSchema === "function") {
+                    const raw = zodMod.toJSONSchema(schema);
+                    if (raw && typeof raw === "object" && Object.keys(raw).length > 0) {
+                        return stripMeta(raw);
+                    }
+                }
+            }
+            catch {
+                // zod not resolvable from SDK context — try alternative
+            }
+            // Try zod/v4/core
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const zodCore = require("zod/v4/core");
+                if (typeof zodCore.toJSONSchema === "function") {
+                    const raw = zodCore.toJSONSchema(schema);
+                    if (raw && typeof raw === "object" && Object.keys(raw).length > 0) {
+                        return stripMeta(raw);
+                    }
+                }
+            }
+            catch {
+                // not available
+            }
+        }
+        // Strategy B: Zod v4 may also export from main entry
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { toJSONSchema } = require("zod");
+            if (typeof toJSONSchema === "function") {
+                const raw = toJSONSchema(schema);
+                if (raw && typeof raw === "object" && Object.keys(raw).length > 0) {
+                    return stripMeta(raw);
+                }
+            }
+        }
+        catch {
+            // not available
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/* ------------------------------------------------------------------ */
+/* Zod v3: use zod-to-json-schema                                      */
+/* ------------------------------------------------------------------ */
+function tryZodV3(schema) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { zodToJsonSchema } = require("zod-to-json-schema");
+        const raw = zodToJsonSchema(schema, {
+            target: "openApi3",
+            $refStrategy: "none",
+        });
+        if (raw && typeof raw === "object" && Object.keys(raw).length > 0) {
+            return stripMeta(raw);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/* ------------------------------------------------------------------ */
+/* Sanitization — clean up for Anthropic/Bedrock compatibility         */
+/* ------------------------------------------------------------------ */
+/**
+ * Sanitize JSON Schema for maximum provider compatibility.
+ *
+ * Handles:
+ * - Strips $schema, additionalProperties (Bedrock rejects these)
+ * - Converts anyOf: [{type: X}, {type: "null"}] → {type: X} (Bedrock no anyOf)
+ * - Converts draft-04 boolean exclusiveMinimum/Maximum to numeric form
+ * - Converts type: ["string", "null"] → type: "string"
+ */
+function sanitize(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(sanitize);
+    const src = obj;
+    const result = {};
+    const hasExclMin = src.exclusiveMinimum === true && typeof src.minimum === "number";
+    const hasExclMax = src.exclusiveMaximum === true && typeof src.maximum === "number";
+    for (const [key, value] of Object.entries(src)) {
+        // Strip meta fields that providers reject
+        if (key === "$schema")
+            continue;
+        if (key === "additionalProperties")
+            continue;
+        // Draft-04 boolean exclusiveMinimum → numeric
+        if (key === "exclusiveMinimum" && value === true) {
+            result.exclusiveMinimum = src.minimum;
+            continue;
+        }
+        if (key === "exclusiveMaximum" && value === true) {
+            result.exclusiveMaximum = src.maximum;
+            continue;
+        }
+        if (key === "minimum" && hasExclMin)
+            continue;
+        if (key === "maximum" && hasExclMax)
+            continue;
+        // type: ["string", "null"] → "string"
+        if (key === "type" && Array.isArray(value)) {
+            const nonNull = value.filter((t) => t !== "null");
+            result[key] = nonNull.length === 1 ? nonNull[0] : nonNull;
+            continue;
+        }
+        // anyOf: [{...}, {type: "null"}] → unwrap non-null branch
+        if (key === "anyOf" && Array.isArray(value)) {
+            const nonNull = value.filter((v) => !(v && typeof v === "object" && v.type === "null"));
+            if (nonNull.length === 1) {
+                // Merge the non-null branch into current level
+                const inner = sanitize(nonNull[0]);
+                Object.assign(result, inner);
+            }
+            else {
+                result[key] = nonNull.map(sanitize);
+            }
+            continue;
+        }
+        // Recurse into nested objects/arrays
+        result[key] = typeof value === "object" ? sanitize(value) : value;
+    }
+    return result;
+}
+/* ------------------------------------------------------------------ */
+/* Helpers                                                             */
+/* ------------------------------------------------------------------ */
+/** Strip $schema from top-level output */
+function stripMeta(raw) {
+    if (!raw || typeof raw !== "object")
+        return raw;
+    const { $schema, ...rest } = raw;
+    return rest;
+}
+/** Check if an object looks like a JSON Schema (has structural keys, not functions). */
+function looksLikeJsonSchema(obj) {
+    const keys = Object.keys(obj);
+    if (keys.length === 0)
+        return false;
+    // JSON Schema objects have keys like type, properties, items, enum, anyOf, etc.
+    // Reject objects whose values are functions (like Zod v4's {input: fn, output: fn})
+    const jsonSchemaKeys = new Set([
+        "type",
+        "properties",
+        "required",
+        "items",
+        "enum",
+        "const",
+        "anyOf",
+        "oneOf",
+        "allOf",
+        "not",
+        "$ref",
+        "description",
+        "default",
+        "title",
+        "minimum",
+        "maximum",
+        "exclusiveMinimum",
+        "exclusiveMaximum",
+        "minLength",
+        "maxLength",
+        "pattern",
+        "minItems",
+        "maxItems",
+        "uniqueItems",
+        "$schema",
+        "additionalProperties",
+        "format",
+    ]);
+    return keys.some((k) => jsonSchemaKeys.has(k));
+}
+/* ------------------------------------------------------------------ */
+/* Tool schema validation                                              */
+/* ------------------------------------------------------------------ */
+/**
+ * Validate tool schemas eagerly. Returns diagnostics for tools whose
+ * schemas cannot be resolved or produce degenerate JSON Schema.
+ *
+ * Call at agent startup or tool collection time to surface bad schemas
+ * immediately rather than getting opaque 502s from providers at runtime.
+ */
+export function validateToolSchemas(tools, opts) {
+    const diagnostics = [];
+    for (const tool of tools) {
+        if (!tool.parameters) {
+            diagnostics.push({
+                toolName: tool.name,
+                extensionName: opts?.extensionName,
+                issue: "Tool has no parameters schema",
+                severity: "warning",
+            });
+            continue;
+        }
+        try {
+            const schema = resolveJsonSchema(tool.parameters);
+            // Check if author pre-computed jsonSchema (fast path) — trust it
+            const std = tool.parameters["~standard"];
+            const hasPrecomputed = std?.jsonSchema && typeof std.jsonSchema === "object";
+            // Empty schema = resolution failed silently
+            if (!schema.type &&
+                !schema.properties &&
+                !schema.anyOf &&
+                !schema.oneOf &&
+                !schema.allOf) {
+                diagnostics.push({
+                    toolName: tool.name,
+                    extensionName: opts?.extensionName,
+                    issue: "Schema resolved to empty object — likely a Zod version mismatch. " +
+                        "Ensure zod-to-json-schema supports your Zod version, or use @dex-ai/sdk Schema builder.",
+                    severity: "error",
+                });
+                continue;
+            }
+            // Check for type: "object" with no properties — schema conversion likely failed
+            // UNLESS the author explicitly pre-computed it (via Schema.fromJsonSchema or ~standard.jsonSchema)
+            if (!hasPrecomputed &&
+                schema.type === "object" &&
+                schema.properties &&
+                Object.keys(schema.properties).length === 0) {
+                diagnostics.push({
+                    toolName: tool.name,
+                    extensionName: opts?.extensionName,
+                    issue: "Schema resolved to object with no properties — schema conversion likely failed. " +
+                        "Ensure zod-to-json-schema supports your Zod version, or use @dex-ai/sdk Schema builder.",
+                    severity: "error",
+                });
+                continue;
+            }
+            // Warn about remaining anyOf/oneOf (Bedrock incompatible)
+            const unsupported = findUnsupportedPatterns(schema);
+            for (const pattern of unsupported) {
+                diagnostics.push({
+                    toolName: tool.name,
+                    extensionName: opts?.extensionName,
+                    issue: `Schema contains ${pattern} which some providers (Bedrock) do not support`,
+                    severity: "warning",
+                });
+            }
+        }
+        catch (err) {
+            diagnostics.push({
+                toolName: tool.name,
+                extensionName: opts?.extensionName,
+                issue: `Schema resolution threw: ${err instanceof Error ? err.message : String(err)}`,
+                severity: "error",
+            });
+        }
+    }
+    return diagnostics;
+}
+/**
+ * Recursively find JSON Schema patterns that are known to be unsupported
+ * by restrictive providers (AWS Bedrock).
+ */
+function findUnsupportedPatterns(obj, path = "") {
+    if (obj === null || typeof obj !== "object" || Array.isArray(obj))
+        return [];
+    const patterns = [];
+    const src = obj;
+    // anyOf with multiple non-null branches (nullable was already stripped by sanitize)
+    if (src.anyOf &&
+        Array.isArray(src.anyOf) &&
+        src.anyOf.length > 1) {
+        patterns.push(`anyOf${path ? " at " + path : ""}`);
+    }
+    if (src.oneOf && Array.isArray(src.oneOf)) {
+        patterns.push(`oneOf${path ? " at " + path : ""}`);
+    }
+    // Recurse into properties, items, etc.
+    if (src.properties && typeof src.properties === "object") {
+        for (const [key, val] of Object.entries(src.properties)) {
+            patterns.push(...findUnsupportedPatterns(val, `${path}.${key}`));
+        }
+    }
+    if (src.items && typeof src.items === "object" && !Array.isArray(src.items)) {
+        patterns.push(...findUnsupportedPatterns(src.items, `${path}[]`));
+    }
+    return patterns;
+}
+//# sourceMappingURL=resolve-schema.js.map

package/dist/resolve-schema.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Re-export of the Standard Schema v1 interface.
+ *
+ * We do not take a runtime dependency on `@standard-schema/spec` — only the
+ * type surface, inlined here so dex-sdk has zero runtime deps. Any schema
+ * library that implements Standard Schema (zod v3.24+, valibot, arktype,
+ * effect/schema, etc.) will satisfy this.
+ *
+ * Spec: https://standardschema.dev
+ */
+import type { JsonSchemaObject } from "./resolve-schema";
+/** A single element of a Standard Schema issue path. */
+export type PathSegment = {
+    readonly key: PropertyKey;
+};
+/** One validation issue. */
+export interface StandardSchemaIssue {
+    readonly message: string;
+    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+}
+export type SuccessResult<Output> = {
+    readonly value: Output;
+};
+export type FailureResult = {
+    readonly issues: ReadonlyArray<StandardSchemaIssue>;
+};
+export type Result<Output> = SuccessResult<Output> | FailureResult;
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly "~standard": {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        } | undefined;
+    };
+}
+export type InferInput<S> = S extends StandardSchemaV1<infer I, unknown> ? I : never;
+export type InferOutput<S> = S extends StandardSchemaV1<unknown, infer O> ? O : never;
+/**
+ * Create a StandardSchemaV1 from a raw JSON Schema object.
+ *
+ * Use this when you don't want a Zod/Valibot dependency — just provide
+ * the JSON Schema directly. The resulting object satisfies StandardSchemaV1
+ * so it works with `Tool.define({ parameters: Schema.fromJsonSchema({...}) })`.
+ *
+ * Note: no runtime validation is performed (validate always succeeds).
+ * The schema is used purely for declaring the tool's input shape to the model.
+ *
+ * @example
+ * ```ts
+ * import { Schema, Tool } from "@dex-ai/sdk";
+ *
+ * const myTool = Tool.define({
+ *   name: "read_file",
+ *   parameters: Schema.fromJsonSchema({
+ *     type: "object",
+ *     properties: {
+ *       path: { type: "string", description: "File path" },
+ *       lineStart: { type: "integer", minimum: 1 },
+ *     },
+ *     required: ["path"],
+ *   }),
+ *   execute(input) { ... }
+ * });
+ * ```
+ */
+export declare const Schema: {
+    /**
+     * Wrap a JSON Schema object as a StandardSchemaV1.
+     * Input type is `unknown` (no compile-time inference).
+     *
+     * Performs lightweight runtime validation:
+     * - Ensures value is an object (when schema type is "object")
+     * - Checks `required` fields are present and non-undefined
+     */
+    fromJsonSchema<Input = unknown>(jsonSchema: JsonSchemaObject): StandardSchemaV1<Input>;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC;AAExD,4BAA4B;AAC5B,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC;CACrE;AAED,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CACpD,CAAC;AACF,MAAM,MAAM,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;AAEnE,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAChE,QAAQ,CAAC,WAAW,EAAE;QACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,CAClB,KAAK,EAAE,OAAO,KACV,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,QAAQ,CAAC,KAAK,CAAC,EACZ;YAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAClD,SAAS,CAAC;KACb,CAAC;CACF;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IACvB,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAC1D,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAM1D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,MAAM;IAClB;;;;;;;OAOG;mBACY,KAAK,wBACP,gBAAgB,GAC1B,gBAAgB,CAAC,KAAK,CAAC;CAyC1B,CAAC"}

package/dist/schema.js

@@ -0,0 +1,90 @@
+/**
+ * Re-export of the Standard Schema v1 interface.
+ *
+ * We do not take a runtime dependency on `@standard-schema/spec` — only the
+ * type surface, inlined here so dex-sdk has zero runtime deps. Any schema
+ * library that implements Standard Schema (zod v3.24+, valibot, arktype,
+ * effect/schema, etc.) will satisfy this.
+ *
+ * Spec: https://standardschema.dev
+ */
+/* ------------------------------------------------------------------ */
+/* Schema — zero-dependency helpers to create StandardSchemaV1 objects  */
+/* ------------------------------------------------------------------ */
+/**
+ * Create a StandardSchemaV1 from a raw JSON Schema object.
+ *
+ * Use this when you don't want a Zod/Valibot dependency — just provide
+ * the JSON Schema directly. The resulting object satisfies StandardSchemaV1
+ * so it works with `Tool.define({ parameters: Schema.fromJsonSchema({...}) })`.
+ *
+ * Note: no runtime validation is performed (validate always succeeds).
+ * The schema is used purely for declaring the tool's input shape to the model.
+ *
+ * @example
+ * ```ts
+ * import { Schema, Tool } from "@dex-ai/sdk";
+ *
+ * const myTool = Tool.define({
+ *   name: "read_file",
+ *   parameters: Schema.fromJsonSchema({
+ *     type: "object",
+ *     properties: {
+ *       path: { type: "string", description: "File path" },
+ *       lineStart: { type: "integer", minimum: 1 },
+ *     },
+ *     required: ["path"],
+ *   }),
+ *   execute(input) { ... }
+ * });
+ * ```
+ */
+export const Schema = {
+    /**
+     * Wrap a JSON Schema object as a StandardSchemaV1.
+     * Input type is `unknown` (no compile-time inference).
+     *
+     * Performs lightweight runtime validation:
+     * - Ensures value is an object (when schema type is "object")
+     * - Checks `required` fields are present and non-undefined
+     */
+    fromJsonSchema(jsonSchema) {
+        return {
+            "~standard": {
+                version: 1,
+                vendor: "dex",
+                validate: (value) => {
+                    // Basic structural validation for object schemas
+                    if (jsonSchema.type === "object") {
+                        if (value == null || typeof value !== "object") {
+                            return {
+                                issues: [
+                                    {
+                                        message: "Expected an object but received " +
+                                            (value === null ? "null" : typeof value),
+                                    },
+                                ],
+                            };
+                        }
+                        const required = jsonSchema.required;
+                        if (required?.length) {
+                            const obj = value;
+                            const missing = required.filter((k) => !(k in obj) || obj[k] === undefined);
+                            if (missing.length > 0) {
+                                return {
+                                    issues: missing.map((k) => ({
+                                        message: `Missing required field: "${k}"`,
+                                        path: [k],
+                                    })),
+                                };
+                            }
+                        }
+                    }
+                    return { value: value };
+                },
+                jsonSchema,
+            },
+        };
+    },
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqCH,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB;;;;;;;OAOG;IACH,cAAc,CACb,UAA4B;QAE5B,OAAO;YACN,WAAW,EAAE;gBACZ,OAAO,EAAE,CAAC;gBACV,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,CAAC,KAAc,EAAiB,EAAE;oBAC3C,iDAAiD;oBACjD,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAClC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BAChD,OAAO;gCACN,MAAM,EAAE;oCACP;wCACC,OAAO,EACN,kCAAkC;4CAClC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;qCACzC;iCACD;6BACD,CAAC;wBACH,CAAC;wBACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAgC,CAAC;wBAC7D,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC;4BACtB,MAAM,GAAG,GAAG,KAAgC,CAAC;4BAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAC1C,CAAC;4BACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gCACxB,OAAO;oCACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wCAC3B,OAAO,EAAE,4BAA4B,CAAC,GAAG;wCACzC,IAAI,EAAE,CAAC,CAAC,CAAC;qCACT,CAAC,CAAC;iCACH,CAAC;4BACH,CAAC;wBACF,CAAC;oBACF,CAAC;oBACD,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;gBAClC,CAAC;gBACD,UAAU;aAC8B;SACzC,CAAC;IACH,CAAC;CACD,CAAC"}

package/dist/tool-dispatch.d.ts

@@ -0,0 +1,24 @@
+/** Dispatch one tool call: validate input → execute → return result. */
+import type { AnyTool, Extension, GenerateContext, ToolCall, ToolResult, ToolOutput, ExecuteResult, ErrorSource } from "./index";
+import { type ResolvedCacheConfig } from "./tool-result-cache";
+/** Wrap an execute() return value into a ToolOutput tagged variant. */
+export declare function toToolOutput(result: ExecuteResult<unknown>): ToolOutput;
+export interface DispatchOptions {
+    readonly call: ToolCall;
+    readonly tool: AnyTool;
+    readonly extensions: ReadonlyArray<Extension>;
+    readonly gctx: GenerateContext;
+    readonly reportError: (err: unknown, source: ErrorSource) => Promise<void>;
+    readonly cacheConfig?: ResolvedCacheConfig;
+}
+export interface DispatchOutcome {
+    result: ToolResult;
+    shortCircuited: boolean;
+    executeError?: unknown;
+}
+/**
+ * Validate and execute a tool call. Tool-start/tool-stop events are handled
+ * by the generate loop — this function only does validation + execution.
+ */
+export declare function dispatchTool(opts: DispatchOptions): Promise<DispatchOutcome>;
+//# sourceMappingURL=tool-dispatch.d.ts.map

package/dist/tool-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatch.d.ts","sourceRoot":"","sources":["../src/tool-dispatch.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,KAAK,EACX,OAAO,EACP,SAAS,EACT,eAAe,EACf,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAgE7E,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,UAAU,CAcvE;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,eAAe,GACnB,OAAO,CAAC,eAAe,CAAC,CAkD1B"}