tool-wrap 0.1.0

package/README.md

@@ -0,0 +1,147 @@
+# tool-wrap
+
+Runtime repair layer for Anthropic tool-calling failures.
+
+LLM tool-call failures are overwhelmingly a harness problem, not a model capability problem. This library sits between the model's raw output and your tool implementation: it validates input with Zod, attempts a small set of well-known shape repairs, and returns a model-readable error string when repair is not possible.
+
+## Install
+
+```sh
+npm install tool-wrap
+# peer dependency
+npm install zod
+```
+
+## Usage
+
+```typescript
+import Anthropic from "@anthropic-ai/sdk"
+import { z } from "zod"
+import { wrap, pathString } from "tool-wrap"
+
+// Default: Anthropic format
+const readFile = wrap({
+  name: "read_file",
+  description: "Read the contents of a file",
+  schema: z.object({
+    path: pathString(),           // unwraps markdown auto-links
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  }),
+  execute: async ({ path, limit, offset }) => {
+    // your implementation
+  },
+  relationalDefaults: [
+    { ifPresent: "limit", thenDefault: { offset: 0 } },
+  ],
+  logger: console,
+})
+
+// OpenAI / DeepSeek format — pass openaiAdapter
+import { openaiAdapter } from "tool-wrap"
+import OpenAI from "openai"
+
+const readFileOAI = wrap({
+  name: "read_file",
+  description: "Read the contents of a file",
+  schema: z.object({ path: pathString(), limit: z.number().optional() }),
+  execute: async ({ path, limit }) => { /* your implementation */ },
+  adapter: openaiAdapter,
+})
+
+// Pass definition to Anthropic
+const client = new Anthropic()
+const response = await client.messages.create({
+  model: "claude-opus-4-7",
+  tools: [readFile.definition],   // Anthropic.Tool shape
+  messages: [...],
+})
+
+// Or pass to DeepSeek / OpenAI
+const deepseek = new OpenAI({ baseURL: "https://api.deepseek.com", apiKey: "..." })
+const response2 = await deepseek.chat.completions.create({
+  model: "deepseek-chat",
+  tools: [readFileOAI.definition],  // OpenAI ChatCompletionTool shape
+  messages: [...],
+})
+
+// Handle tool_use blocks
+for (const block of response.content) {
+  if (block.type === "tool_use" && block.name === "read_file") {
+    const result = await readFile.execute(block.input)
+    // result is your tool's return value, or a model-readable error string
+  }
+}
+```
+
+## What it repairs
+
+Four shape errors cover ~90% of tool-call failures across open models:
+
+| # | Failure | Example | Repair |
+|---|---------|---------|--------|
+| 2 | JSON array emitted as string | `"[\"a\",\"b\"]"` | parse stringified JSON |
+| 4 | Bare string where array expected | `"foo"` | wrap to `["foo"]` |
+| 1 | `null` for optional field | `{ limit: null }` | drop the key |
+| 3 | Single object where array expected | `{ id: 1 }` | wrap to `[{ id: 1 }]` |
+
+Repairs run in the order shown (#2 before #4 so stringified arrays are parsed, not re-wrapped). Valid inputs are never touched.
+
+## API
+
+### `wrap(options)`
+
+```typescript
+wrap({
+  name: string
+  description: string
+  schema: ZodObject           // Zod schema; input_schema is derived from this
+  execute: (input) => Promise<unknown>
+  relationalDefaults?: Array<{ ifPresent: string; thenDefault: Record<string, unknown> }>
+  logger?: { info(...): void; warn(...): void }  // optional; pino, winston, console, etc.
+  adapter?: ToolAdapter<TDef> // optional; defaults to anthropicAdapter
+}): {
+  definition: TDef            // shape determined by adapter (Anthropic.Tool by default)
+  execute: (rawInput: unknown) => Promise<unknown>
+}
+```
+
+Two built-in adapters are exported:
+
+```typescript
+import { anthropicAdapter, openaiAdapter } from "tool-wrap"
+// anthropicAdapter → { name, description, input_schema }
+// openaiAdapter    → { type: "function", function: { name, description, parameters } }
+```
+
+Custom adapters implement `ToolAdapter<TDef>`:
+
+```typescript
+import type { ToolAdapter, BaseDefinition } from "tool-wrap"
+
+const myAdapter: ToolAdapter<MyProviderTool> = (base: BaseDefinition) => ({
+  // map base.name, base.description, base.inputSchema to your provider's format
+})
+```
+
+On unrecoverable failure, `execute` returns a model-readable string (no `Error:` prefix) so the model can self-correct and retry.
+
+### `pathString()`
+
+A Zod type that unwraps markdown auto-links before validation:
+
+```
+"[notes.md](http://notes.md)"  →  "notes.md"
+```
+
+Use it for any field that accepts a file path.
+
+## Logging
+
+Pass any logger with `.info()` and `.warn()` methods. Two events are emitted:
+
+| Event | Level | When |
+|-------|-------|------|
+| `tool_input_repaired` | info | repair succeeded; includes `{ tool, repairs }` |
+| `tool_input_invalid` | warn | unrecoverable; includes `{ tool, issues }` |
+| `tool_relational_defaults_applied` | info | defaults were injected; includes `{ tool, defaults }` |

package/dist/index.cjs

@@ -0,0 +1,202 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  anthropicAdapter: () => anthropicAdapter,
+  openaiAdapter: () => openaiAdapter,
+  pathString: () => pathString,
+  wrap: () => wrap
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/wrap.ts
+var import_zod_to_json_schema = require("zod-to-json-schema");
+
+// src/repair.ts
+function getAtPath(obj, path) {
+  let cur = obj;
+  for (const key of path) {
+    if (cur == null || typeof cur !== "object") return void 0;
+    cur = cur[key];
+  }
+  return cur;
+}
+function setAtPath(obj, path, value) {
+  let cur = obj;
+  for (const key of path.slice(0, -1)) {
+    if (cur == null || typeof cur !== "object") return;
+    cur = cur[key];
+  }
+  const last = path[path.length - 1];
+  if (cur != null && typeof cur === "object") {
+    ;
+    cur[last] = value;
+  }
+}
+function deleteAtPath(obj, path) {
+  let cur = obj;
+  for (const key of path.slice(0, -1)) {
+    if (cur == null || typeof cur !== "object") return;
+    cur = cur[key];
+  }
+  const last = path[path.length - 1];
+  if (cur != null && typeof cur === "object") {
+    delete cur[last];
+  }
+}
+function isOptionalField(schema, path) {
+  if (path.length !== 1 || typeof path[0] !== "string") return false;
+  return schema.shape[path[0]]?.isOptional() ?? false;
+}
+function repair(args, error, schema) {
+  const repaired = structuredClone(args);
+  const repairs = [];
+  for (const issue of error.issues) {
+    if (issue.path.length === 0) continue;
+    const value = getAtPath(repaired, issue.path);
+    if (issue.code === "invalid_type" && issue.expected === "array" && typeof value === "string") {
+      try {
+        const parsed = JSON.parse(value);
+        if (Array.isArray(parsed)) {
+          setAtPath(repaired, issue.path, parsed);
+          repairs.push("stringify_parse");
+          continue;
+        }
+      } catch {
+      }
+    }
+    if (issue.code === "invalid_type" && issue.expected === "array" && typeof value === "string") {
+      setAtPath(repaired, issue.path, [value]);
+      repairs.push("string_to_array");
+      continue;
+    }
+    if (value === null && isOptionalField(schema, issue.path)) {
+      deleteAtPath(repaired, issue.path);
+      repairs.push("null_drop");
+      continue;
+    }
+    if (issue.code === "invalid_type" && issue.expected === "array" && value !== null && typeof value === "object" && !Array.isArray(value)) {
+      setAtPath(repaired, issue.path, [value]);
+      repairs.push("object_to_array");
+      continue;
+    }
+  }
+  return { repaired, repairs };
+}
+
+// src/relational.ts
+function applyRelationalDefaults(args, defaults) {
+  const result = { ...args };
+  const applied = [];
+  for (const def of defaults) {
+    if (result[def.ifPresent] !== void 0) {
+      let anyApplied = false;
+      for (const [key, value] of Object.entries(def.thenDefault)) {
+        if (result[key] === void 0) {
+          result[key] = value;
+          anyApplied = true;
+        }
+      }
+      if (anyApplied) applied.push(def);
+    }
+  }
+  return { result, applied };
+}
+
+// src/adapters.ts
+var anthropicAdapter = (base) => ({
+  name: base.name,
+  description: base.description,
+  input_schema: base.inputSchema
+});
+var openaiAdapter = (base) => ({
+  type: "function",
+  function: {
+    name: base.name,
+    description: base.description,
+    parameters: base.inputSchema
+  }
+});
+
+// src/wrap.ts
+function wrap(options) {
+  const { name, description, schema, execute, relationalDefaults = [], logger, adapter } = options;
+  const { $schema: _$schema, ...inputSchema } = (0, import_zod_to_json_schema.zodToJsonSchema)(schema);
+  const base = { name, description, inputSchema };
+  const resolvedAdapter = adapter ?? anthropicAdapter;
+  const definition = resolvedAdapter(base);
+  async function executeWrapped(rawInput) {
+    if (rawInput == null || typeof rawInput !== "object" || Array.isArray(rawInput)) {
+      return `Input for "${name}" must be an object. Received: ${typeof rawInput}. Retry with a valid JSON object.`;
+    }
+    const args = rawInput;
+    const { result: withDefaults, applied } = applyRelationalDefaults(args, relationalDefaults);
+    if (applied.length > 0) {
+      logger?.info("tool_relational_defaults_applied", {
+        tool: name,
+        defaults: applied.map((d) => ({ ifPresent: d.ifPresent, thenDefault: d.thenDefault }))
+      });
+    }
+    const first = schema.safeParse(withDefaults);
+    if (first.success) {
+      return execute(first.data);
+    }
+    const { repaired, repairs } = repair(withDefaults, first.error, schema);
+    const second = schema.safeParse(repaired);
+    if (second.success) {
+      logger?.info("tool_input_repaired", { tool: name, repairs });
+      return execute(second.data);
+    }
+    logger?.warn("tool_input_invalid", {
+      tool: name,
+      issues: second.error.issues.map((i) => ({ path: i.path, message: i.message }))
+    });
+    return formatFailureMessage(name, second.error);
+  }
+  return { definition, execute: executeWrapped };
+}
+function formatFailureMessage(tool, error) {
+  const lines = error.issues.map((i) => {
+    const path = i.path.length > 0 ? i.path.join(".") : "(root)";
+    return `  - ${path}: ${i.message}`;
+  });
+  return [
+    `Input for "${tool}" could not be parsed after repair attempts.`,
+    `Issues:`,
+    ...lines,
+    `Retry with corrected input.`
+  ].join("\n");
+}
+
+// src/types.ts
+var import_zod = require("zod");
+var pathString = () => import_zod.z.string().transform((val) => {
+  const match = val.match(/^\[.*?\]\((.*?)\)$/);
+  return match ? match[1] : val;
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  anthropicAdapter,
+  openaiAdapter,
+  pathString,
+  wrap
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/wrap.ts","../src/repair.ts","../src/relational.ts","../src/adapters.ts","../src/types.ts"],"sourcesContent":["export { wrap } from \"./wrap\"\r\nexport { pathString } from \"./types\"\r\nexport { anthropicAdapter, openaiAdapter } from \"./adapters\"\r\nexport type { WrapOptions, WrappedTool } from \"./wrap\"\r\nexport type { RelationalDefault, Logger, BaseDefinition, ToolAdapter } from \"./types\"\r\nexport type { AnthropicToolDefinition, OpenAIToolDefinition } from \"./adapters\"\r\n","import { z, ZodObject, ZodRawShape } from \"zod\"\r\nimport { zodToJsonSchema } from \"zod-to-json-schema\"\r\nimport { repair } from \"./repair\"\r\nimport { applyRelationalDefaults } from \"./relational\"\r\nimport type { RelationalDefault, Logger, BaseDefinition, ToolAdapter } from \"./types\"\r\nimport { anthropicAdapter, type AnthropicToolDefinition } from \"./adapters\"\r\n\r\nexport interface WrapOptions<S extends ZodObject<ZodRawShape>> {\r\n  name: string\r\n  description: string\r\n  schema: S\r\n  execute: (input: z.infer<S>) => Promise<unknown>\r\n  relationalDefaults?: RelationalDefault[]\r\n  logger?: Logger\r\n}\r\n\r\nexport interface WrappedTool<TDef> {\r\n  definition: TDef\r\n  execute: (rawInput: unknown) => Promise<unknown>\r\n}\r\n\r\nexport function wrap<S extends ZodObject<ZodRawShape>>(\r\n  options: WrapOptions<S> & { adapter?: undefined }\r\n): WrappedTool<AnthropicToolDefinition>\r\n\r\nexport function wrap<S extends ZodObject<ZodRawShape>, TDef>(\r\n  options: WrapOptions<S> & { adapter: ToolAdapter<TDef> }\r\n): WrappedTool<TDef>\r\n\r\nexport function wrap<S extends ZodObject<ZodRawShape>, TDef = AnthropicToolDefinition>(\r\n  options: WrapOptions<S> & { adapter?: ToolAdapter<TDef> }\r\n): WrappedTool<TDef> {\r\n  const { name, description, schema, execute, relationalDefaults = [], logger, adapter } = options\r\n\r\n  const { $schema: _$schema, ...inputSchema } = zodToJsonSchema(schema) as Record<string, unknown>\r\n\r\n  const base: BaseDefinition = { name, description, inputSchema }\r\n  const resolvedAdapter = (adapter ?? anthropicAdapter) as ToolAdapter<TDef>\r\n  const definition = resolvedAdapter(base)\r\n\r\n  async function executeWrapped(rawInput: unknown): Promise<unknown> {\r\n    if (rawInput == null || typeof rawInput !== \"object\" || Array.isArray(rawInput)) {\r\n      return `Input for \"${name}\" must be an object. Received: ${typeof rawInput}. Retry with a valid JSON object.`\r\n    }\r\n\r\n    const args = rawInput as Record<string, unknown>\r\n    const { result: withDefaults, applied } = applyRelationalDefaults(args, relationalDefaults)\r\n\r\n    if (applied.length > 0) {\r\n      logger?.info(\"tool_relational_defaults_applied\", {\r\n        tool: name,\r\n        defaults: applied.map((d) => ({ ifPresent: d.ifPresent, thenDefault: d.thenDefault })),\r\n      })\r\n    }\r\n\r\n    const first = schema.safeParse(withDefaults)\r\n    if (first.success) {\r\n      return execute(first.data)\r\n    }\r\n\r\n    const { repaired, repairs } = repair(withDefaults, first.error, schema)\r\n    const second = schema.safeParse(repaired)\r\n\r\n    if (second.success) {\r\n      logger?.info(\"tool_input_repaired\", { tool: name, repairs })\r\n      return execute(second.data)\r\n    }\r\n\r\n    logger?.warn(\"tool_input_invalid\", {\r\n      tool: name,\r\n      issues: second.error.issues.map((i) => ({ path: i.path, message: i.message })),\r\n    })\r\n\r\n    return formatFailureMessage(name, second.error)\r\n  }\r\n\r\n  return { definition, execute: executeWrapped }\r\n}\r\n\r\nfunction formatFailureMessage(tool: string, error: z.ZodError): string {\r\n  const lines = error.issues.map((i) => {\r\n    const path = i.path.length > 0 ? i.path.join(\".\") : \"(root)\"\r\n    return `  - ${path}: ${i.message}`\r\n  })\r\n  return [\r\n    `Input for \"${tool}\" could not be parsed after repair attempts.`,\r\n    `Issues:`,\r\n    ...lines,\r\n    `Retry with corrected input.`,\r\n  ].join(\"\\n\")\r\n}\r\n","import { ZodError, ZodObject, ZodRawShape } from \"zod\"\n\nexport type RepairType = \"stringify_parse\" | \"string_to_array\" | \"null_drop\" | \"object_to_array\"\n\nfunction getAtPath(obj: unknown, path: (string | number)[]): unknown {\n  let cur: unknown = obj\n  for (const key of path) {\n    if (cur == null || typeof cur !== \"object\") return undefined\n    cur = (cur as Record<string | number, unknown>)[key]\n  }\n  return cur\n}\n\nfunction setAtPath(obj: unknown, path: (string | number)[], value: unknown): void {\n  let cur: unknown = obj\n  for (const key of path.slice(0, -1)) {\n    if (cur == null || typeof cur !== \"object\") return\n    cur = (cur as Record<string | number, unknown>)[key]\n  }\n  const last = path[path.length - 1]\n  if (cur != null && typeof cur === \"object\") {\n    ;(cur as Record<string | number, unknown>)[last] = value\n  }\n}\n\nfunction deleteAtPath(obj: unknown, path: (string | number)[]): void {\n  let cur: unknown = obj\n  for (const key of path.slice(0, -1)) {\n    if (cur == null || typeof cur !== \"object\") return\n    cur = (cur as Record<string | number, unknown>)[key]\n  }\n  const last = path[path.length - 1]\n  if (cur != null && typeof cur === \"object\") {\n    delete (cur as Record<string | number, unknown>)[last]\n  }\n}\n\nfunction isOptionalField(schema: ZodObject<ZodRawShape>, path: (string | number)[]): boolean {\n  if (path.length !== 1 || typeof path[0] !== \"string\") return false\n  return schema.shape[path[0]]?.isOptional() ?? false\n}\n\nexport function repair(\n  args: Record<string, unknown>,\n  error: ZodError,\n  schema: ZodObject<ZodRawShape>,\n): { repaired: Record<string, unknown>; repairs: RepairType[] } {\n  const repaired = structuredClone(args) as Record<string, unknown>\n  const repairs: RepairType[] = []\n\n  for (const issue of error.issues) {\n    if (issue.path.length === 0) continue\n\n    const value = getAtPath(repaired, issue.path)\n\n    // #2: stringified JSON array — must run before #4\n    if (issue.code === \"invalid_type\" && issue.expected === \"array\" && typeof value === \"string\") {\n      try {\n        const parsed = JSON.parse(value)\n        if (Array.isArray(parsed)) {\n          setAtPath(repaired, issue.path, parsed)\n          repairs.push(\"stringify_parse\")\n          continue\n        }\n      } catch {\n        // not valid JSON, fall through to #4\n      }\n    }\n\n    // #4: bare string where array expected\n    if (issue.code === \"invalid_type\" && issue.expected === \"array\" && typeof value === \"string\") {\n      setAtPath(repaired, issue.path, [value])\n      repairs.push(\"string_to_array\")\n      continue\n    }\n\n    // #1: null for optional field only — dropping null from a required field just\n    // changes the error from \"wrong type\" to \"missing required\", no net benefit\n    if (value === null && isOptionalField(schema, issue.path)) {\n      deleteAtPath(repaired, issue.path)\n      repairs.push(\"null_drop\")\n      continue\n    }\n\n    // #3: single object where array expected\n    if (\n      issue.code === \"invalid_type\" &&\n      issue.expected === \"array\" &&\n      value !== null &&\n      typeof value === \"object\" &&\n      !Array.isArray(value)\n    ) {\n      setAtPath(repaired, issue.path, [value])\n      repairs.push(\"object_to_array\")\n      continue\n    }\n  }\n\n  return { repaired, repairs }\n}\n","import type { RelationalDefault } from \"./types\"\n\nexport function applyRelationalDefaults(\n  args: Record<string, unknown>,\n  defaults: RelationalDefault[],\n): { result: Record<string, unknown>; applied: RelationalDefault[] } {\n  const result = { ...args }\n  const applied: RelationalDefault[] = []\n\n  for (const def of defaults) {\n    if (result[def.ifPresent] !== undefined) {\n      let anyApplied = false\n      for (const [key, value] of Object.entries(def.thenDefault)) {\n        if (result[key] === undefined) {\n          result[key] = value\n          anyApplied = true\n        }\n      }\n      if (anyApplied) applied.push(def)\n    }\n  }\n\n  return { result, applied }\n}\n","import type { BaseDefinition, ToolAdapter } from \"./types\"\r\n\r\nexport interface AnthropicToolDefinition {\r\n  name: string\r\n  description: string\r\n  input_schema: {\r\n    type: \"object\"\r\n    properties?: Record<string, unknown>\r\n    required?: string[]\r\n    [key: string]: unknown\r\n  }\r\n}\r\n\r\nexport interface OpenAIToolDefinition {\r\n  type: \"function\"\r\n  function: {\r\n    name: string\r\n    description: string\r\n    parameters: Record<string, unknown>\r\n  }\r\n}\r\n\r\nexport const anthropicAdapter: ToolAdapter<AnthropicToolDefinition> = (base: BaseDefinition) => ({\r\n  name: base.name,\r\n  description: base.description,\r\n  input_schema: base.inputSchema as AnthropicToolDefinition[\"input_schema\"],\r\n})\r\n\r\nexport const openaiAdapter: ToolAdapter<OpenAIToolDefinition> = (base: BaseDefinition) => ({\r\n  type: \"function\",\r\n  function: {\r\n    name: base.name,\r\n    description: base.description,\r\n    parameters: base.inputSchema,\r\n  },\r\n})\r\n","import { z } from \"zod\"\r\n\r\nexport interface RelationalDefault {\r\n  ifPresent: string\r\n  thenDefault: Record<string, unknown>\r\n}\r\n\r\nexport interface Logger {\r\n  info(msg: string, meta?: Record<string, unknown>): void\r\n  warn(msg: string, meta?: Record<string, unknown>): void\r\n}\r\n\r\nexport interface BaseDefinition {\r\n  name: string\r\n  description: string\r\n  inputSchema: Record<string, unknown>\r\n}\r\n\r\nexport type ToolAdapter<TDef> = (base: BaseDefinition) => TDef\r\n\r\n// Unwraps markdown auto-links that bleed through from chat prior:\r\n//   \"[notes.md](http://notes.md)\" → \"notes.md\"\r\nexport const pathString = () =>\r\n  z.string().transform((val) => {\r\n    const match = val.match(/^\\[.*?\\]\\((.*?)\\)$/)\r\n    return match ? match[1] : val\r\n  })\r\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+import { z, ZodObject, ZodRawShape } from 'zod';
+
+interface RelationalDefault {
+    ifPresent: string;
+    thenDefault: Record<string, unknown>;
+}
+interface Logger {
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+}
+interface BaseDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+type ToolAdapter<TDef> = (base: BaseDefinition) => TDef;
+declare const pathString: () => z.ZodEffects<z.ZodString, string, string>;
+
+interface AnthropicToolDefinition {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+}
+interface OpenAIToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+declare const anthropicAdapter: ToolAdapter<AnthropicToolDefinition>;
+declare const openaiAdapter: ToolAdapter<OpenAIToolDefinition>;
+
+interface WrapOptions<S extends ZodObject<ZodRawShape>> {
+    name: string;
+    description: string;
+    schema: S;
+    execute: (input: z.infer<S>) => Promise<unknown>;
+    relationalDefaults?: RelationalDefault[];
+    logger?: Logger;
+}
+interface WrappedTool<TDef> {
+    definition: TDef;
+    execute: (rawInput: unknown) => Promise<unknown>;
+}
+declare function wrap<S extends ZodObject<ZodRawShape>>(options: WrapOptions<S> & {
+    adapter?: undefined;
+}): WrappedTool<AnthropicToolDefinition>;
+declare function wrap<S extends ZodObject<ZodRawShape>, TDef>(options: WrapOptions<S> & {
+    adapter: ToolAdapter<TDef>;
+}): WrappedTool<TDef>;
+
+export { type AnthropicToolDefinition, type BaseDefinition, type Logger, type OpenAIToolDefinition, type RelationalDefault, type ToolAdapter, type WrapOptions, type WrappedTool, anthropicAdapter, openaiAdapter, pathString, wrap };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { z, ZodObject, ZodRawShape } from 'zod';
+
+interface RelationalDefault {
+    ifPresent: string;
+    thenDefault: Record<string, unknown>;
+}
+interface Logger {
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+}
+interface BaseDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+type ToolAdapter<TDef> = (base: BaseDefinition) => TDef;
+declare const pathString: () => z.ZodEffects<z.ZodString, string, string>;
+
+interface AnthropicToolDefinition {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+}
+interface OpenAIToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+declare const anthropicAdapter: ToolAdapter<AnthropicToolDefinition>;
+declare const openaiAdapter: ToolAdapter<OpenAIToolDefinition>;
+
+interface WrapOptions<S extends ZodObject<ZodRawShape>> {
+    name: string;
+    description: string;
+    schema: S;
+    execute: (input: z.infer<S>) => Promise<unknown>;
+    relationalDefaults?: RelationalDefault[];
+    logger?: Logger;
+}
+interface WrappedTool<TDef> {
+    definition: TDef;
+    execute: (rawInput: unknown) => Promise<unknown>;
+}
+declare function wrap<S extends ZodObject<ZodRawShape>>(options: WrapOptions<S> & {
+    adapter?: undefined;
+}): WrappedTool<AnthropicToolDefinition>;
+declare function wrap<S extends ZodObject<ZodRawShape>, TDef>(options: WrapOptions<S> & {
+    adapter: ToolAdapter<TDef>;
+}): WrappedTool<TDef>;
+
+export { type AnthropicToolDefinition, type BaseDefinition, type Logger, type OpenAIToolDefinition, type RelationalDefault, type ToolAdapter, type WrapOptions, type WrappedTool, anthropicAdapter, openaiAdapter, pathString, wrap };

package/dist/index.js

@@ -0,0 +1,172 @@
+// src/wrap.ts
+import { zodToJsonSchema } from "zod-to-json-schema";
+
+// src/repair.ts
+function getAtPath(obj, path) {
+  let cur = obj;
+  for (const key of path) {
+    if (cur == null || typeof cur !== "object") return void 0;
+    cur = cur[key];
+  }
+  return cur;
+}
+function setAtPath(obj, path, value) {
+  let cur = obj;
+  for (const key of path.slice(0, -1)) {
+    if (cur == null || typeof cur !== "object") return;
+    cur = cur[key];
+  }
+  const last = path[path.length - 1];
+  if (cur != null && typeof cur === "object") {
+    ;
+    cur[last] = value;
+  }
+}
+function deleteAtPath(obj, path) {
+  let cur = obj;
+  for (const key of path.slice(0, -1)) {
+    if (cur == null || typeof cur !== "object") return;
+    cur = cur[key];
+  }
+  const last = path[path.length - 1];
+  if (cur != null && typeof cur === "object") {
+    delete cur[last];
+  }
+}
+function isOptionalField(schema, path) {
+  if (path.length !== 1 || typeof path[0] !== "string") return false;
+  return schema.shape[path[0]]?.isOptional() ?? false;
+}
+function repair(args, error, schema) {
+  const repaired = structuredClone(args);
+  const repairs = [];
+  for (const issue of error.issues) {
+    if (issue.path.length === 0) continue;
+    const value = getAtPath(repaired, issue.path);
+    if (issue.code === "invalid_type" && issue.expected === "array" && typeof value === "string") {
+      try {
+        const parsed = JSON.parse(value);
+        if (Array.isArray(parsed)) {
+          setAtPath(repaired, issue.path, parsed);
+          repairs.push("stringify_parse");
+          continue;
+        }
+      } catch {
+      }
+    }
+    if (issue.code === "invalid_type" && issue.expected === "array" && typeof value === "string") {
+      setAtPath(repaired, issue.path, [value]);
+      repairs.push("string_to_array");
+      continue;
+    }
+    if (value === null && isOptionalField(schema, issue.path)) {
+      deleteAtPath(repaired, issue.path);
+      repairs.push("null_drop");
+      continue;
+    }
+    if (issue.code === "invalid_type" && issue.expected === "array" && value !== null && typeof value === "object" && !Array.isArray(value)) {
+      setAtPath(repaired, issue.path, [value]);
+      repairs.push("object_to_array");
+      continue;
+    }
+  }
+  return { repaired, repairs };
+}
+
+// src/relational.ts
+function applyRelationalDefaults(args, defaults) {
+  const result = { ...args };
+  const applied = [];
+  for (const def of defaults) {
+    if (result[def.ifPresent] !== void 0) {
+      let anyApplied = false;
+      for (const [key, value] of Object.entries(def.thenDefault)) {
+        if (result[key] === void 0) {
+          result[key] = value;
+          anyApplied = true;
+        }
+      }
+      if (anyApplied) applied.push(def);
+    }
+  }
+  return { result, applied };
+}
+
+// src/adapters.ts
+var anthropicAdapter = (base) => ({
+  name: base.name,
+  description: base.description,
+  input_schema: base.inputSchema
+});
+var openaiAdapter = (base) => ({
+  type: "function",
+  function: {
+    name: base.name,
+    description: base.description,
+    parameters: base.inputSchema
+  }
+});
+
+// src/wrap.ts
+function wrap(options) {
+  const { name, description, schema, execute, relationalDefaults = [], logger, adapter } = options;
+  const { $schema: _$schema, ...inputSchema } = zodToJsonSchema(schema);
+  const base = { name, description, inputSchema };
+  const resolvedAdapter = adapter ?? anthropicAdapter;
+  const definition = resolvedAdapter(base);
+  async function executeWrapped(rawInput) {
+    if (rawInput == null || typeof rawInput !== "object" || Array.isArray(rawInput)) {
+      return `Input for "${name}" must be an object. Received: ${typeof rawInput}. Retry with a valid JSON object.`;
+    }
+    const args = rawInput;
+    const { result: withDefaults, applied } = applyRelationalDefaults(args, relationalDefaults);
+    if (applied.length > 0) {
+      logger?.info("tool_relational_defaults_applied", {
+        tool: name,
+        defaults: applied.map((d) => ({ ifPresent: d.ifPresent, thenDefault: d.thenDefault }))
+      });
+    }
+    const first = schema.safeParse(withDefaults);
+    if (first.success) {
+      return execute(first.data);
+    }
+    const { repaired, repairs } = repair(withDefaults, first.error, schema);
+    const second = schema.safeParse(repaired);
+    if (second.success) {
+      logger?.info("tool_input_repaired", { tool: name, repairs });
+      return execute(second.data);
+    }
+    logger?.warn("tool_input_invalid", {
+      tool: name,
+      issues: second.error.issues.map((i) => ({ path: i.path, message: i.message }))
+    });
+    return formatFailureMessage(name, second.error);
+  }
+  return { definition, execute: executeWrapped };
+}
+function formatFailureMessage(tool, error) {
+  const lines = error.issues.map((i) => {
+    const path = i.path.length > 0 ? i.path.join(".") : "(root)";
+    return `  - ${path}: ${i.message}`;
+  });
+  return [
+    `Input for "${tool}" could not be parsed after repair attempts.`,
+    `Issues:`,
+    ...lines,
+    `Retry with corrected input.`
+  ].join("\n");
+}
+
+// src/types.ts
+import { z } from "zod";
+var pathString = () => z.string().transform((val) => {
+  const match = val.match(/^\[.*?\]\((.*?)\)$/);
+  return match ? match[1] : val;
+});
+export {
+  anthropicAdapter,
+  openaiAdapter,
+  pathString,
+  wrap
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wrap.ts","../src/repair.ts","../src/relational.ts","../src/adapters.ts","../src/types.ts"],"sourcesContent":["import { z, ZodObject, ZodRawShape } from \"zod\"\r\nimport { zodToJsonSchema } from \"zod-to-json-schema\"\r\nimport { repair } from \"./repair\"\r\nimport { applyRelationalDefaults } from \"./relational\"\r\nimport type { RelationalDefault, Logger, BaseDefinition, ToolAdapter } from \"./types\"\r\nimport { anthropicAdapter, type AnthropicToolDefinition } from \"./adapters\"\r\n\r\nexport interface WrapOptions<S extends ZodObject<ZodRawShape>> {\r\n  name: string\r\n  description: string\r\n  schema: S\r\n  execute: (input: z.infer<S>) => Promise<unknown>\r\n  relationalDefaults?: RelationalDefault[]\r\n  logger?: Logger\r\n}\r\n\r\nexport interface WrappedTool<TDef> {\r\n  definition: TDef\r\n  execute: (rawInput: unknown) => Promise<unknown>\r\n}\r\n\r\nexport function wrap<S extends ZodObject<ZodRawShape>>(\r\n  options: WrapOptions<S> & { adapter?: undefined }\r\n): WrappedTool<AnthropicToolDefinition>\r\n\r\nexport function wrap<S extends ZodObject<ZodRawShape>, TDef>(\r\n  options: WrapOptions<S> & { adapter: ToolAdapter<TDef> }\r\n): WrappedTool<TDef>\r\n\r\nexport function wrap<S extends ZodObject<ZodRawShape>, TDef = AnthropicToolDefinition>(\r\n  options: WrapOptions<S> & { adapter?: ToolAdapter<TDef> }\r\n): WrappedTool<TDef> {\r\n  const { name, description, schema, execute, relationalDefaults = [], logger, adapter } = options\r\n\r\n  const { $schema: _$schema, ...inputSchema } = zodToJsonSchema(schema) as Record<string, unknown>\r\n\r\n  const base: BaseDefinition = { name, description, inputSchema }\r\n  const resolvedAdapter = (adapter ?? anthropicAdapter) as ToolAdapter<TDef>\r\n  const definition = resolvedAdapter(base)\r\n\r\n  async function executeWrapped(rawInput: unknown): Promise<unknown> {\r\n    if (rawInput == null || typeof rawInput !== \"object\" || Array.isArray(rawInput)) {\r\n      return `Input for \"${name}\" must be an object. Received: ${typeof rawInput}. Retry with a valid JSON object.`\r\n    }\r\n\r\n    const args = rawInput as Record<string, unknown>\r\n    const { result: withDefaults, applied } = applyRelationalDefaults(args, relationalDefaults)\r\n\r\n    if (applied.length > 0) {\r\n      logger?.info(\"tool_relational_defaults_applied\", {\r\n        tool: name,\r\n        defaults: applied.map((d) => ({ ifPresent: d.ifPresent, thenDefault: d.thenDefault })),\r\n      })\r\n    }\r\n\r\n    const first = schema.safeParse(withDefaults)\r\n    if (first.success) {\r\n      return execute(first.data)\r\n    }\r\n\r\n    const { repaired, repairs } = repair(withDefaults, first.error, schema)\r\n    const second = schema.safeParse(repaired)\r\n\r\n    if (second.success) {\r\n      logger?.info(\"tool_input_repaired\", { tool: name, repairs })\r\n      return execute(second.data)\r\n    }\r\n\r\n    logger?.warn(\"tool_input_invalid\", {\r\n      tool: name,\r\n      issues: second.error.issues.map((i) => ({ path: i.path, message: i.message })),\r\n    })\r\n\r\n    return formatFailureMessage(name, second.error)\r\n  }\r\n\r\n  return { definition, execute: executeWrapped }\r\n}\r\n\r\nfunction formatFailureMessage(tool: string, error: z.ZodError): string {\r\n  const lines = error.issues.map((i) => {\r\n    const path = i.path.length > 0 ? i.path.join(\".\") : \"(root)\"\r\n    return `  - ${path}: ${i.message}`\r\n  })\r\n  return [\r\n    `Input for \"${tool}\" could not be parsed after repair attempts.`,\r\n    `Issues:`,\r\n    ...lines,\r\n    `Retry with corrected input.`,\r\n  ].join(\"\\n\")\r\n}\r\n","import { ZodError, ZodObject, ZodRawShape } from \"zod\"\n\nexport type RepairType = \"stringify_parse\" | \"string_to_array\" | \"null_drop\" | \"object_to_array\"\n\nfunction getAtPath(obj: unknown, path: (string | number)[]): unknown {\n  let cur: unknown = obj\n  for (const key of path) {\n    if (cur == null || typeof cur !== \"object\") return undefined\n    cur = (cur as Record<string | number, unknown>)[key]\n  }\n  return cur\n}\n\nfunction setAtPath(obj: unknown, path: (string | number)[], value: unknown): void {\n  let cur: unknown = obj\n  for (const key of path.slice(0, -1)) {\n    if (cur == null || typeof cur !== \"object\") return\n    cur = (cur as Record<string | number, unknown>)[key]\n  }\n  const last = path[path.length - 1]\n  if (cur != null && typeof cur === \"object\") {\n    ;(cur as Record<string | number, unknown>)[last] = value\n  }\n}\n\nfunction deleteAtPath(obj: unknown, path: (string | number)[]): void {\n  let cur: unknown = obj\n  for (const key of path.slice(0, -1)) {\n    if (cur == null || typeof cur !== \"object\") return\n    cur = (cur as Record<string | number, unknown>)[key]\n  }\n  const last = path[path.length - 1]\n  if (cur != null && typeof cur === \"object\") {\n    delete (cur as Record<string | number, unknown>)[last]\n  }\n}\n\nfunction isOptionalField(schema: ZodObject<ZodRawShape>, path: (string | number)[]): boolean {\n  if (path.length !== 1 || typeof path[0] !== \"string\") return false\n  return schema.shape[path[0]]?.isOptional() ?? false\n}\n\nexport function repair(\n  args: Record<string, unknown>,\n  error: ZodError,\n  schema: ZodObject<ZodRawShape>,\n): { repaired: Record<string, unknown>; repairs: RepairType[] } {\n  const repaired = structuredClone(args) as Record<string, unknown>\n  const repairs: RepairType[] = []\n\n  for (const issue of error.issues) {\n    if (issue.path.length === 0) continue\n\n    const value = getAtPath(repaired, issue.path)\n\n    // #2: stringified JSON array — must run before #4\n    if (issue.code === \"invalid_type\" && issue.expected === \"array\" && typeof value === \"string\") {\n      try {\n        const parsed = JSON.parse(value)\n        if (Array.isArray(parsed)) {\n          setAtPath(repaired, issue.path, parsed)\n          repairs.push(\"stringify_parse\")\n          continue\n        }\n      } catch {\n        // not valid JSON, fall through to #4\n      }\n    }\n\n    // #4: bare string where array expected\n    if (issue.code === \"invalid_type\" && issue.expected === \"array\" && typeof value === \"string\") {\n      setAtPath(repaired, issue.path, [value])\n      repairs.push(\"string_to_array\")\n      continue\n    }\n\n    // #1: null for optional field only — dropping null from a required field just\n    // changes the error from \"wrong type\" to \"missing required\", no net benefit\n    if (value === null && isOptionalField(schema, issue.path)) {\n      deleteAtPath(repaired, issue.path)\n      repairs.push(\"null_drop\")\n      continue\n    }\n\n    // #3: single object where array expected\n    if (\n      issue.code === \"invalid_type\" &&\n      issue.expected === \"array\" &&\n      value !== null &&\n      typeof value === \"object\" &&\n      !Array.isArray(value)\n    ) {\n      setAtPath(repaired, issue.path, [value])\n      repairs.push(\"object_to_array\")\n      continue\n    }\n  }\n\n  return { repaired, repairs }\n}\n","import type { RelationalDefault } from \"./types\"\n\nexport function applyRelationalDefaults(\n  args: Record<string, unknown>,\n  defaults: RelationalDefault[],\n): { result: Record<string, unknown>; applied: RelationalDefault[] } {\n  const result = { ...args }\n  const applied: RelationalDefault[] = []\n\n  for (const def of defaults) {\n    if (result[def.ifPresent] !== undefined) {\n      let anyApplied = false\n      for (const [key, value] of Object.entries(def.thenDefault)) {\n        if (result[key] === undefined) {\n          result[key] = value\n          anyApplied = true\n        }\n      }\n      if (anyApplied) applied.push(def)\n    }\n  }\n\n  return { result, applied }\n}\n","import type { BaseDefinition, ToolAdapter } from \"./types\"\r\n\r\nexport interface AnthropicToolDefinition {\r\n  name: string\r\n  description: string\r\n  input_schema: {\r\n    type: \"object\"\r\n    properties?: Record<string, unknown>\r\n    required?: string[]\r\n    [key: string]: unknown\r\n  }\r\n}\r\n\r\nexport interface OpenAIToolDefinition {\r\n  type: \"function\"\r\n  function: {\r\n    name: string\r\n    description: string\r\n    parameters: Record<string, unknown>\r\n  }\r\n}\r\n\r\nexport const anthropicAdapter: ToolAdapter<AnthropicToolDefinition> = (base: BaseDefinition) => ({\r\n  name: base.name,\r\n  description: base.description,\r\n  input_schema: base.inputSchema as AnthropicToolDefinition[\"input_schema\"],\r\n})\r\n\r\nexport const openaiAdapter: ToolAdapter<OpenAIToolDefinition> = (base: BaseDefinition) => ({\r\n  type: \"function\",\r\n  function: {\r\n    name: base.name,\r\n    description: base.description,\r\n    parameters: base.inputSchema,\r\n  },\r\n})\r\n","import { z } from \"zod\"\r\n\r\nexport interface RelationalDefault {\r\n  ifPresent: string\r\n  thenDefault: Record<string, unknown>\r\n}\r\n\r\nexport interface Logger {\r\n  info(msg: string, meta?: Record<string, unknown>): void\r\n  warn(msg: string, meta?: Record<string, unknown>): void\r\n}\r\n\r\nexport interface BaseDefinition {\r\n  name: string\r\n  description: string\r\n  inputSchema: Record<string, unknown>\r\n}\r\n\r\nexport type ToolAdapter<TDef> = (base: BaseDefinition) => TDef\r\n\r\n// Unwraps markdown auto-links that bleed through from chat prior:\r\n//   \"[notes.md](http://notes.md)\" → \"notes.md\"\r\nexport const pathString = () =>\r\n  z.string().transform((val) => {\r\n    const match = val.match(/^\\[.*?\\]\\((.*?)\\)$/)\r\n    return match ? match[1] : val\r\n  })\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "tool-wrap",
+  "version": "0.1.0",
+  "description": "Runtime repair layer for Anthropic tool-calling failures",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/venotyh/toolharness.git"
+  },
+  "keywords": ["anthropic", "openai", "deepseek", "tool-calling", "zod", "llm"],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "dev": "vitest"
+  },
+  "peerDependencies": {
+    "zod": ">=3.0.0"
+  },
+  "dependencies": {
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0",
+    "zod": "^3.23.0"
+  }
+}