@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.3

package/dist/execution/host-bridge-coercion.js

@@ -0,0 +1,158 @@
+/**
+ * Undo host-bridge stringification of nested records, numbers, and booleans.
+ *
+ * Hosts that project `z.record` / open objects as JSON Schema maps often
+ * deliver nested objects as JSON strings and numbers/booleans as decimal or
+ * `"true"`/`"false"` strings. Descriptor schemas stay JSON-Schema-safe
+ * (no `.preprocess` / `.transform`); this walk is the receive-side gate.
+ */
+import * as z from 'zod/v4';
+import { createHostBridgeProjection, hostBridgeBranchProjection, hostBridgeChildProjection } from "./host-bridge-projection.js";
+const JSON_OBJECT_OR_ARRAY = /^\s*[[{]/;
+const NUMERIC = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/;
+export function coerceHostBridgeInput(jsonSchema, input) {
+    const schema = asSchema(jsonSchema);
+    // SAFETY: caller expects coerced tool input type T matching schema
+    return coerceValue(input, schema, createHostBridgeProjection(schema));
+}
+function asSchema(value) {
+    if (!value || value === true || Array.isArray(value))
+        return undefined;
+    return value;
+}
+function expectedTypes(schema) {
+    const types = new Set();
+    if (!schema)
+        return types;
+    collectTypes(schema, types);
+    return types;
+}
+function collectTypes(schema, types) {
+    if (!declaresType(schema)) {
+        types.add('unknown');
+        return;
+    }
+    if (Array.isArray(schema.type)) {
+        for (const type of schema.type)
+            types.add(String(type));
+    }
+    else if (schema.type) {
+        types.add(String(schema.type));
+    }
+    for (const branch of schema.anyOf ?? [])
+        collectTypes(branch, types);
+    for (const branch of schema.oneOf ?? [])
+        collectTypes(branch, types);
+    if (schema.properties || schema.additionalProperties !== undefined)
+        types.add('object');
+    if (schema.items)
+        types.add('array');
+}
+function coerceValue(value, schema, projection) {
+    const expected = expectedTypes(schema);
+    // An untyped value or an admitted string belongs to the caller, not the bridge.
+    if (expected.size === 0 || expected.has('unknown'))
+        return value;
+    const stringParsed = z.string().safeParse(value);
+    if (stringParsed.success) {
+        const str = stringParsed.data;
+        if (expected.has('string') && projection()?.safeParse(str).success)
+            return str;
+        if (shouldParseJsonString(str, expected)) {
+            const jsonParsed = (() => {
+                try {
+                    // SAFETY: JSON.parse on valid JSON string produces HostBridgeValue
+                    return { ok: true, data: JSON.parse(str) };
+                }
+                catch (error) {
+                    return { ok: false, error };
+                }
+            })();
+            if (jsonParsed.ok) {
+                return coerceValue(jsonParsed.data, schema, projection);
+            }
+            if (!(jsonParsed.error instanceof SyntaxError)) {
+                throw jsonParsed.error;
+            }
+        }
+        if (expected.has('integer') || expected.has('number')) {
+            const trimmed = str.trim();
+            if (NUMERIC.test(trimmed)) {
+                const numeric = Number(trimmed);
+                if (Number.isFinite(numeric)) {
+                    if (expected.has('integer') && !expected.has('number') && !Number.isInteger(numeric)) {
+                        return str;
+                    }
+                    return numeric;
+                }
+            }
+        }
+        if (expected.has('boolean')) {
+            if (str === 'true')
+                return true;
+            if (str === 'false')
+                return false;
+        }
+        return str;
+    }
+    const alternatives = schema?.anyOf ?? schema?.oneOf;
+    if (alternatives && value instanceof Object) {
+        const type = Array.isArray(value) ? 'array' : 'object';
+        const candidates = alternatives.flatMap((branch, index) => expectedTypes(branch).has(type) ? [{ branch, index }] : []);
+        // Only a single declared container branch supplies an unambiguous child schema.
+        const candidate = candidates[0];
+        return candidates.length === 1 && candidate
+            ? coerceValue(value, candidate.branch, hostBridgeBranchProjection(projection, candidate.index))
+            : value;
+    }
+    if (Array.isArray(value)) {
+        const itemSchema = Array.isArray(schema?.items) ? undefined : asSchema(schema?.items);
+        let changed = false;
+        const next = value.map((item) => {
+            const coerced = coerceValue(item, itemSchema, hostBridgeChildProjection(projection));
+            if (coerced !== item)
+                changed = true;
+            return coerced;
+        });
+        return changed ? next : value;
+    }
+    if (value && value instanceof Object && !Array.isArray(value)) {
+        const properties = schema?.properties;
+        const additional = schema?.additionalProperties;
+        // SAFETY: additional checked to be non-array Object
+        const additionalSchema = additional && additional instanceof Object && !Array.isArray(additional)
+            ? additional
+            : undefined;
+        const out = {};
+        let changed = false;
+        // SAFETY: value is confirmed non-array Object
+        const entries = Object.entries(value);
+        for (const [key, child] of entries) {
+            const childSchema = asSchema(properties?.[key] ?? (declaresType(additionalSchema) ? additionalSchema : undefined));
+            if (childSchema === undefined) {
+                out[key] = child;
+                continue;
+            }
+            const coerced = coerceValue(child, childSchema, hostBridgeChildProjection(projection, key));
+            if (coerced !== child)
+                changed = true;
+            out[key] = coerced;
+        }
+        return changed ? out : value;
+    }
+    return value;
+}
+/** Whether a schema says anything about its value's type. `{}` / `true` say nothing. */
+function declaresType(schema) {
+    return (!!schema &&
+        (schema.type !== undefined ||
+            schema.anyOf !== undefined ||
+            schema.oneOf !== undefined ||
+            schema.properties !== undefined ||
+            schema.items !== undefined ||
+            schema.$ref !== undefined));
+}
+function shouldParseJsonString(value, expected) {
+    return JSON_OBJECT_OR_ARRAY.test(value) && (expected.has('object') || expected.has('array'));
+}
+//# sourceMappingURL=host-bridge-coercion.js.map

package/dist/execution/host-bridge-coercion.js.map

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

package/dist/execution/host-bridge-projection.d.ts

@@ -0,0 +1,9 @@
+import * as z from 'zod/v4';
+import type { HostBridgeJsonSchema } from './schemas/host-bridge.ts';
+/** Convert the complete document once, retaining the converter's root/reference context. */
+export declare function createHostBridgeProjection(schema: HostBridgeJsonSchema | undefined): () => z.ZodType | undefined;
+/** Keep union branches aligned with the standard converter's declared option order. */
+export declare function hostBridgeBranchProjection(projection: () => z.ZodType | undefined, index: number): () => z.ZodType | undefined;
+/** Read a child of that converted document; never reconstruct a detached JSON subschema. */
+export declare function hostBridgeChildProjection(projection: () => z.ZodType | undefined, key?: string): () => z.ZodType | undefined;
+//# sourceMappingURL=host-bridge-projection.d.ts.map

package/dist/execution/host-bridge-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge-projection.d.ts","sourceRoot":"","sources":["../../src/execution/host-bridge-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC,OAAO,GAAG,SAAS,CAOhH;AAED,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,GAAG,SAAS,CAM9H;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,OAAO,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,GAAG,SAAS,CAE5H"}

package/dist/execution/host-bridge-projection.js

@@ -0,0 +1,46 @@
+import * as z from 'zod/v4';
+/** Convert the complete document once, retaining the converter's root/reference context. */
+export function createHostBridgeProjection(schema) {
+    let parsed;
+    return () => {
+        if (!schema)
+            return undefined;
+        // SAFETY: Zod implements JSON Schema type arrays; its declaration omits that supported form.
+        return parsed ??= z.fromJSONSchema(schema, { registry: z.registry() });
+    };
+}
+/** Keep union branches aligned with the standard converter's declared option order. */
+export function hostBridgeBranchProjection(projection, index) {
+    return () => {
+        const schema = unwrap(projection());
+        const branch = schema instanceof z.ZodUnion || schema instanceof z.ZodXor ? schema.options[index] : undefined;
+        return branch instanceof z.ZodType ? branch : undefined;
+    };
+}
+/** Read a child of that converted document; never reconstruct a detached JSON subschema. */
+export function hostBridgeChildProjection(projection, key) {
+    return () => childSchema(unwrap(projection()), key);
+}
+function unwrap(schema) {
+    if (schema instanceof z.ZodDefault || schema instanceof z.ZodReadonly || schema instanceof z.ZodLazy ||
+        schema instanceof z.ZodOptional || schema instanceof z.ZodNullable) {
+        const inner = schema.unwrap();
+        return unwrap(inner instanceof z.ZodType ? inner : undefined);
+    }
+    return schema;
+}
+function childSchema(schema, key) {
+    if (schema instanceof z.ZodUnion || schema instanceof z.ZodXor) {
+        const children = schema.options.flatMap(option => {
+            const child = childSchema(unwrap(option instanceof z.ZodType ? option : undefined), key);
+            return child ? [child] : [];
+        });
+        return children.length === 1 ? children[0] : undefined;
+    }
+    const child = schema instanceof z.ZodArray && key === undefined ? schema.element
+        : schema instanceof z.ZodObject && key !== undefined ? schema.shape[key] ?? schema.def.catchall
+            : schema instanceof z.ZodRecord && key !== undefined ? schema.valueType
+                : undefined;
+    return child instanceof z.ZodType ? child : undefined;
+}
+//# sourceMappingURL=host-bridge-projection.js.map

package/dist/execution/host-bridge-projection.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tool Execution
+ *
+ * Central entry point for running a tool through the runtime with hook-bus
+ * events emitted around execution (contextBuild, beforeExecute, afterExecute,
+ * error).
+ */
+export { invokeTool, type InvokeToolOptions, type ToolInvocationErrorMetadata } from './invoke.ts';
+export { executeTool, type CustomToolResolver, type ExecuteToolOptions } from './execute-tool.ts';
+export { buildDirectToolCallContext } from './direct-context.ts';
+export { callerFromRuntimeScope, invokeToolAsCaller } from './caller-invocation.ts';
+export type { BindCallerWorkspace, CallerIdentity, CallerIdentityOptions, CallerToolRun } from './schemas/caller-invocation.ts';
+export { BEFORE_EXECUTE_REJECT_KEY, invokeToolCore, ToolInputValidationError, validateToolInput, validateToolInputForRuntime, type InvokeToolCoreOptions, type ToolInputValidationIssue, type ToolInputValidationResult } from './core.ts';
+export { coerceHostBridgeInput } from './host-bridge-coercion.ts';
+export { toolContextBuildEvent, toolBeforeExecuteEvent, toolAfterExecuteEvent, toolErrorEvent, toolEventDescriptors } from './tool-events.descriptor.ts';
+export { default as tierEnforcementSubscriptionDescriptor } from './tier-enforcement.subscription.descriptor.ts';
+export { CapabilityTierExceededError, ToolCapabilityMissingError } from './tier-enforcement.errors.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAChI,OAAO,EACN,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EACN,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,EAAE,OAAO,IAAI,qCAAqC,EAAE,MAAM,+CAA+C,CAAC;AACjH,OAAO,EACN,2BAA2B,EAC3B,0BAA0B,EAC1B,MAAM,8BAA8B,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,19 @@
+/**
+ * Tool Execution
+ *
+ * Central entry point for running a tool through the runtime with hook-bus
+ * events emitted around execution (contextBuild, beforeExecute, afterExecute,
+ * error).
+ */
+export { invokeTool } from "./invoke.js";
+export { executeTool } from "./execute-tool.js";
+export { buildDirectToolCallContext } from "./direct-context.js";
+export { callerFromRuntimeScope, invokeToolAsCaller } from "./caller-invocation.js";
+export { BEFORE_EXECUTE_REJECT_KEY, invokeToolCore, ToolInputValidationError, validateToolInput, validateToolInputForRuntime } from "./core.js";
+export { coerceHostBridgeInput } from "./host-bridge-coercion.js";
+export { toolContextBuildEvent, toolBeforeExecuteEvent, toolAfterExecuteEvent, toolErrorEvent, toolEventDescriptors } from "./tool-events.descriptor.js";
+// Tier enforcement: descriptor + pure errors only (framework barrel).
+// Implementation is loaded via runtime.registerLoader — do not re-export *.impl.* here.
+export { default as tierEnforcementSubscriptionDescriptor } from "./tier-enforcement.subscription.descriptor.js";
+export { CapabilityTierExceededError, ToolCapabilityMissingError } from "./tier-enforcement.errors.js";
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAA4D,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,WAAW,EAAoD,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EACN,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAI3B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EACN,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,MAAM,6BAA6B,CAAC;AAErC,sEAAsE;AACtE,wFAAwF;AACxF,OAAO,EAAE,OAAO,IAAI,qCAAqC,EAAE,MAAM,+CAA+C,CAAC;AACjH,OAAO,EACN,2BAA2B,EAC3B,0BAA0B,EAC1B,MAAM,8BAA8B,CAAC"}

package/dist/execution/input-validation.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Tool input validation at the tools invoke boundary.
+ *
+ * `invokeToolCore` runs `validateToolInput` against `descriptor.schemas.input`
+ * before any tool implementation receives untrusted payload. Keeping this in
+ * `tools` makes the universal tools runtime the owner of descriptor
+ * validation instead of leaking tool semantics into runtime core.
+ *
+ * Discriminated-union inputs use the shared wire helper
+ * (`schemas/discriminated-union-wire`) only to project host-bridge repair.
+ * The owner schema's parsed data, including a branch transform, is what the
+ * implementation receives.
+ */
+import { type RuntimeRef, CapabilityError } from '@vibesdotdev/kernel';
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import { type ToolInputValidationIssue, type ToolInputValidationResult } from './schemas/input-validation.ts';
+export { flattenDiscriminatedUnionToObject } from '../schemas/discriminated-union-wire.ts';
+export type { ToolInputValidationIssue, ToolInputValidationResult } from './schemas/input-validation.ts';
+/**
+ * Error thrown when descriptor-declared input validation fails.
+ *
+ * Carries the raw issues so audit subscribers and clients can render
+ * structured feedback without re-running the parser.
+ */
+export declare class ToolInputValidationError extends CapabilityError {
+    readonly toolId: string;
+    readonly issues: ToolInputValidationIssue[];
+    readonly retryable = false;
+    constructor(toolId: string, issues: ToolInputValidationIssue[]);
+}
+/**
+ * Pull `descriptor.schemas.input` for `toolId` and validate `input`
+ * against it. Returns `{ ok: true, value: input }` when there is no Zod
+ * schema attached.
+ */
+export declare function validateToolInputForRuntime<TInput>(runtime: VibesRuntime, toolId: string, input: TInput): ToolInputValidationResult;
+/**
+ * Validate `input` against `rawSchema`.
+ *
+ * - When `rawSchema` is missing, returns `{ ok: true, value: input }`.
+ * - When `rawSchema` is present but not Zod-shaped, fails closed. Plain JSON
+ *   Schema descriptors must be converted at registration, not skipped here.
+ * - Host-bridge stringification (nested JSON strings, numeric/boolean strings)
+ *   is undone before `safeParse`.
+ * - When `rawSchema` is a discriminated union, flatten only to project the
+ *   host-bridge repair. The owner schema then parses once, and that parsed
+ *   data — branch transforms included — is what the implementation receives.
+ *   A different variant's defaults are not applied.
+ * - A schema without a JSON Schema projection skips host-bridge repair; the
+ *   handed runtime's Logging records why.
+ */
+export declare function validateToolInput<TSchema, TInput>(runtime: RuntimeRef, rawSchema: TSchema, input: TInput): ToolInputValidationResult;
+//# sourceMappingURL=input-validation.d.ts.map

package/dist/execution/input-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validation.d.ts","sourceRoot":"","sources":["../../src/execution/input-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,KAAK,UAAU,EACf,eAAe,EAGf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AASpE,OAAO,EAA2B,KAAK,wBAAwB,EAAE,KAAK,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAEvI,OAAO,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAE3F,YAAY,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAEzG;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,SAAS;gBAEf,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,EAAE;CAa9D;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EACjD,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACX,yBAAyB,CAW3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAChD,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,MAAM,GACX,yBAAyB,CAuB3B"}

package/dist/execution/input-validation.js

@@ -0,0 +1,154 @@
+/**
+ * Tool input validation at the tools invoke boundary.
+ *
+ * `invokeToolCore` runs `validateToolInput` against `descriptor.schemas.input`
+ * before any tool implementation receives untrusted payload. Keeping this in
+ * `tools` makes the universal tools runtime the owner of descriptor
+ * validation instead of leaking tool semantics into runtime core.
+ *
+ * Discriminated-union inputs use the shared wire helper
+ * (`schemas/discriminated-union-wire`) only to project host-bridge repair.
+ * The owner schema's parsed data, including a branch transform, is what the
+ * implementation receives.
+ */
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { flattenDiscriminatedUnionToObject, isDiscriminatedUnion } from "../schemas/discriminated-union-wire.js";
+import { coerceHostBridgeInput } from "./host-bridge-coercion.js";
+import { getLogger } from '@vibesdotdev/logging';
+import { ZodErrorContainerSchema } from "./schemas/input-validation.js";
+export { flattenDiscriminatedUnionToObject } from "../schemas/discriminated-union-wire.js";
+/**
+ * Error thrown when descriptor-declared input validation fails.
+ *
+ * Carries the raw issues so audit subscribers and clients can render
+ * structured feedback without re-running the parser.
+ */
+export class ToolInputValidationError extends CapabilityError {
+    toolId;
+    issues;
+    retryable = false;
+    constructor(toolId, issues) {
+        super(formatValidationMessage(toolId, issues), 'INVALID_INPUT', {
+            reason: 'tool-input-validation-failed',
+            details: { toolId, issues }
+        });
+        this.name = 'ToolInputValidationError';
+        this.toolId = toolId;
+        this.issues = issues;
+    }
+}
+/**
+ * Pull `descriptor.schemas.input` for `toolId` and validate `input`
+ * against it. Returns `{ ok: true, value: input }` when there is no Zod
+ * schema attached.
+ */
+export function validateToolInputForRuntime(runtime, toolId, input) {
+    if (!runtime.hasKind('tools/tool'))
+        return { ok: true, value: input };
+    const accessor = runtime.assets('tools/tool');
+    // SAFETY: descriptor has optional schemas matching the tool contract
+    const descriptor = accessor.descriptor(toolId);
+    const rawSchema = descriptor?.schemas?.input;
+    return validateToolInput(runtime, rawSchema, input);
+}
+/**
+ * Validate `input` against `rawSchema`.
+ *
+ * - When `rawSchema` is missing, returns `{ ok: true, value: input }`.
+ * - When `rawSchema` is present but not Zod-shaped, fails closed. Plain JSON
+ *   Schema descriptors must be converted at registration, not skipped here.
+ * - Host-bridge stringification (nested JSON strings, numeric/boolean strings)
+ *   is undone before `safeParse`.
+ * - When `rawSchema` is a discriminated union, flatten only to project the
+ *   host-bridge repair. The owner schema then parses once, and that parsed
+ *   data — branch transforms included — is what the implementation receives.
+ *   A different variant's defaults are not applied.
+ * - A schema without a JSON Schema projection skips host-bridge repair; the
+ *   handed runtime's Logging records why.
+ */
+export function validateToolInput(runtime, rawSchema, input) {
+    if (rawSchema == null)
+        return { ok: true, value: input };
+    if (!isZodSchema(rawSchema)) {
+        return {
+            ok: false,
+            issues: [
+                {
+                    path: [],
+                    message: 'Tool input schema is not a Zod schema; refuse to invoke without validation'
+                }
+            ]
+        };
+    }
+    const isDU = isDiscriminatedUnion(rawSchema);
+    const projectionSchema = isDU ? flattenDiscriminatedUnionToObject(rawSchema) : rawSchema;
+    const projection = projectInputJsonSchema(runtime, projectionSchema);
+    // SAFETY: input is coerced against JSON Schema if schema projection succeeds; host-bridge input conforms to HostBridgeValue
+    const coerced = projection.schema ? coerceHostBridgeInput(projection.schema, input) : input;
+    const parsed = rawSchema.safeParse(coerced);
+    if (!parsed.success)
+        return { ok: false, issues: normalizeIssues(parsed.error) };
+    return { ok: true, value: parsed.data };
+}
+function projectInputJsonSchema(runtime, schema) {
+    try {
+        // SAFETY: z.toJSONSchema produces a valid JSON Schema object conforming to HostBridgeJsonSchema
+        const schemaObj = z.toJSONSchema(schema, {
+            io: 'input',
+            unrepresentable: 'any'
+        });
+        return { schema: schemaObj };
+    }
+    catch (error) {
+        // Not every Zod schema is representable as JSON Schema; the projection is optional.
+        const logger = getLogger('tools:input-validation', runtime);
+        logger.warn('Input schema has no JSON Schema projection', {
+            error: valueFreeFailure(CaughtFailureSchema.parse(error))
+        });
+        return {
+            failure: valueFreeFailure(CaughtFailureSchema.parse(error))
+        };
+    }
+}
+function isZodSchema(value) {
+    return value instanceof z.ZodType;
+}
+function normalizeIssues(error) {
+    const parsed = ZodErrorContainerSchema.safeParse(error);
+    if (!parsed.success) {
+        return [{ path: [], message: 'Invalid input' }];
+    }
+    return parsed.data.issues.map((rawIssue) => {
+        const allowedSource = rawIssue.values ?? rawIssue.options ?? [];
+        const allowedValues = allowedSource.map((value) => String(value));
+        const issueItem = {
+            path: rawIssue.path,
+            message: rawIssue.message
+        };
+        if (rawIssue.code !== undefined) {
+            issueItem.code = rawIssue.code;
+        }
+        if (allowedValues.length > 0) {
+            issueItem.allowedValues = allowedValues;
+        }
+        return issueItem;
+    });
+}
+function formatValidationMessage(toolId, issues) {
+    if (issues.length === 0)
+        return `Tool '${toolId}' input failed validation`;
+    const summary = issues
+        .slice(0, 3)
+        .map((issue) => {
+        const where = issue.path.length > 0 ? issue.path.join('.') : '<root>';
+        const allowed = issue.allowedValues && issue.allowedValues.length > 0
+            ? ` (allowed: ${issue.allowedValues.join(', ')})`
+            : '';
+        return `${where}: ${issue.message}${allowed}`;
+    })
+        .join('; ');
+    const more = issues.length > 3 ? ` (+${issues.length - 3} more)` : '';
+    return `Tool '${toolId}' input failed validation: ${summary}${more}`;
+}
+//# sourceMappingURL=input-validation.js.map

package/dist/execution/input-validation.js.map

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

package/dist/execution/invoke.d.ts

@@ -0,0 +1,16 @@
+/**
+ * invokeTool — tools-package entry point for executing a tool through the runtime.
+ *
+ * Thin wrapper around `invokeToolCore` that adds tools-specific
+ * resolution behaviour:
+ *   - discriminated/variant dispatch via the `tools/tool` accessor
+ *   - lazy implementation resolution via `runtime.resolve('tools/tool', …)`
+ *
+ * All cross-cutting concerns (hook-bus emission, timeout handling,
+ * error recovery-hint enrichment) live in {@link invokeToolCore} so the
+ * daemon RPC invoker stays in sync automatically.
+ */
+import type { InvokeToolOptions, ToolInvocationErrorMetadata } from './schemas/invoke.ts';
+export type { InvokeToolOptions, ToolInvocationErrorMetadata };
+export declare function invokeTool<T = unknown>(options: InvokeToolOptions): Promise<T>;
+//# sourceMappingURL=invoke.d.ts.map

package/dist/execution/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/execution/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,KAAK,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAE1F,YAAY,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,CAAC;AAM/D,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAsDpF"}