@aviasole/shapecraft 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2024 Aviasole Technologies
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,81 @@
+# @aviasole/shapecraft
+
+Structured output generation for LLMs in Node.js. Token-level constraints for local models, native JSON modes for cloud APIs — one unified Zod API.
+
+## Install
+
+```bash
+npm install @aviasole/shapecraft zod
+```
+
+Install backend SDK as needed:
+
+```bash
+npm install openai          # OpenAI
+npm install groq-sdk        # Groq
+npm install @anthropic-ai/sdk  # Anthropic
+# Ollama: no extra SDK, uses fetch
+```
+
+## Usage
+
+```typescript
+import { z } from "zod";
+import { generate, openai, ollama, anthropic, groq } from "@aviasole/shapecraft";
+
+const PersonSchema = z.object({
+  name: z.string(),
+  age: z.number(),
+  email: z.string().email(),
+});
+
+// OpenAI — native constrained (server-side)
+const model = openai({ model: "gpt-4o-mini" });
+
+const result = await generate(model, PersonSchema, "Extract person info: John Doe, 32, john@example.com");
+
+console.log(result.data);          // { name: "John Doe", age: 32, email: "john@example.com" }
+console.log(result.guaranteeLevel); // "native"
+console.log(result.attempts);       // 1
+```
+
+## Backends & Guarantee Levels
+
+| Backend | Guarantee | Notes |
+|---|---|---|
+| `ollama()` | `constrained` | Token-level via GBNF grammar |
+| `openai()` | `native` | Server-side strict JSON schema |
+| `groq()` | `native` | JSON mode |
+| `anthropic()` | `best-effort` | Prompt + parse + retry |
+
+```typescript
+// Ollama — true token-level constraint (local model)
+const local = ollama({ model: "llama3.2" });
+
+// Anthropic — best-effort with auto-retry
+const claude = anthropic({ model: "claude-sonnet-4-6", maxRetries: 3 });
+
+// Groq — fast native JSON mode
+const fast = groq({ model: "llama-3.3-70b-versatile" });
+```
+
+## Error Handling
+
+```typescript
+import { SchemaViolationError, MaxRetriesExceededError } from "@aviasole/shapecraft";
+
+try {
+  const result = await generate(model, schema, prompt, { maxRetries: 3 });
+} catch (err) {
+  if (err instanceof MaxRetriesExceededError) {
+    console.error(`Failed after ${err.attempts} attempts`);
+  }
+  if (err instanceof SchemaViolationError) {
+    console.error("Raw output:", err.raw);
+  }
+}
+```
+
+## License
+
+Apache-2.0 © Aviasole Technologies

package/dist/backends/anthropic.d.ts

@@ -0,0 +1,7 @@
+import type { ShapecraftModel } from "../types.js";
+export interface AnthropicBackendOptions {
+    model?: string;
+    apiKey?: string;
+}
+export declare function anthropic(options?: AnthropicBackendOptions): ShapecraftModel;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/backends/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/backends/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAIhE,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,uBAA4B,GAAG,eAAe,CAiChF"}

package/dist/backends/groq.d.ts

@@ -0,0 +1,7 @@
+import type { ShapecraftModel } from "../types.js";
+export interface GroqBackendOptions {
+    model?: string;
+    apiKey?: string;
+}
+export declare function groq(options?: GroqBackendOptions): ShapecraftModel;
+//# sourceMappingURL=groq.d.ts.map

package/dist/backends/groq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groq.d.ts","sourceRoot":"","sources":["../../src/backends/groq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAIhE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,IAAI,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAkCtE"}

package/dist/backends/index.d.ts

@@ -0,0 +1,5 @@
+export { openai } from "./openai.js";
+export { ollama } from "./ollama.js";
+export { anthropic } from "./anthropic.js";
+export { groq } from "./groq.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/backends/ollama.d.ts

@@ -0,0 +1,7 @@
+import type { ShapecraftModel } from "../types.js";
+export interface OllamaBackendOptions {
+    model: string;
+    host?: string;
+}
+export declare function ollama(options: OllamaBackendOptions): ShapecraftModel;
+//# sourceMappingURL=ollama.d.ts.map

package/dist/backends/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/backends/ollama.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAKhE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CA0CrE"}

package/dist/backends/openai.d.ts

@@ -0,0 +1,8 @@
+import type { ShapecraftModel } from "../types.js";
+export interface OpenAIBackendOptions {
+    model?: string;
+    apiKey?: string;
+    baseURL?: string;
+}
+export declare function openai(options?: OpenAIBackendOptions): ShapecraftModel;
+//# sourceMappingURL=openai.d.ts.map

package/dist/backends/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/backends/openai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAKhE,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,oBAAyB,GAAG,eAAe,CAgD1E"}

package/dist/core/generate.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateOptions, GenerateResult, SchemaInput, ShapecraftModel } from "../types.js";
+export declare function generate<T>(model: ShapecraftModel, schema: SchemaInput<T>, prompt: string, options?: GenerateOptions): Promise<GenerateResult<T>>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/core/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/core/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIjG,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAoB5B"}

package/dist/core/parse.d.ts

@@ -0,0 +1,5 @@
+import type { SchemaInput } from "../types.js";
+export declare function parseAndValidate<T>(raw: string, schema: SchemaInput<T>, opts?: {
+    extractJson?: boolean;
+}): T;
+//# sourceMappingURL=parse.d.ts.map

package/dist/core/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/core/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,CAAC,CAsBH"}

package/dist/core/schema.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import type { SchemaInput } from "../types.js";
+export declare function toJsonSchema(schema: z.ZodType<any>): Record<string, unknown>;
+export declare function buildStructuredPrompt(prompt: string, schema: SchemaInput, systemPrompt?: string): {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,wBAAgB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG5E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkBlC"}

package/dist/core/validate.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import type { SchemaInput } from "../types.js";
+export declare function isZodSchema(schema: SchemaInput): schema is z.ZodType<any>;
+export declare function validateOutput<T>(output: unknown, schema: SchemaInput<T>): T;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAEzE;AAkDD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAgC5E"}

package/dist/index.cjs

@@ -0,0 +1,297 @@
+'use strict';
+
+var zod = require('zod');
+var zodToJsonSchema = require('zod-to-json-schema');
+
+// src/types.ts
+var SchemaViolationError = class extends Error {
+  constructor(raw, validationErrors) {
+    super("Model output failed schema validation");
+    this.raw = raw;
+    this.validationErrors = validationErrors;
+    this.name = "SchemaViolationError";
+  }
+};
+var MaxRetriesExceededError = class extends Error {
+  constructor(attempts) {
+    super(`Schema validation failed after ${attempts} attempts`);
+    this.attempts = attempts;
+    this.name = "MaxRetriesExceededError";
+  }
+};
+function isZodSchema(schema) {
+  return schema instanceof zod.z.ZodType;
+}
+function nullToUndefined(value) {
+  if (value === null) return void 0;
+  if (Array.isArray(value)) return value.map(nullToUndefined);
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(
+      Object.entries(value).map(([k, v]) => [k, nullToUndefined(v)])
+    );
+  }
+  return value;
+}
+function checkJsonSchema(value, schema) {
+  const type = schema.type;
+  if (type) {
+    const actual = Array.isArray(value) ? "array" : value === null ? "null" : typeof value;
+    if (actual !== type) {
+      throw new Error(`Expected type "${type}", got "${actual}"`);
+    }
+  }
+  if (schema.enum) {
+    if (!schema.enum.includes(value)) {
+      throw new Error(`Value not in enum: ${JSON.stringify(value)}`);
+    }
+  }
+  if (typeof value === "object" && value !== null && !Array.isArray(value) && schema.properties) {
+    const obj = value;
+    const required = schema.required ?? [];
+    const properties = schema.properties;
+    for (const key of required) {
+      if (!(key in obj)) throw new Error(`Missing required property: "${key}"`);
+    }
+    for (const [key, propSchema] of Object.entries(properties)) {
+      if (key in obj) checkJsonSchema(obj[key], propSchema);
+    }
+  }
+  if (Array.isArray(value) && schema.items) {
+    for (const item of value) {
+      checkJsonSchema(item, schema.items);
+    }
+  }
+}
+function validateOutput(output, schema) {
+  if (isZodSchema(schema)) {
+    const result = schema.safeParse(nullToUndefined(output));
+    if (!result.success) throw new SchemaViolationError(JSON.stringify(output), result.error);
+    return result.data;
+  }
+  if ("jsonSchema" in schema) {
+    try {
+      checkJsonSchema(output, schema.jsonSchema);
+    } catch (err) {
+      throw new SchemaViolationError(JSON.stringify(output), err);
+    }
+    return output;
+  }
+  if ("pattern" in schema) {
+    const str = typeof output === "string" ? output : JSON.stringify(output);
+    if (!schema.pattern.test(str)) {
+      throw new SchemaViolationError(str, `Output does not match pattern ${schema.pattern}`);
+    }
+    return output;
+  }
+  if ("validate" in schema) {
+    if (!schema.validate(output)) {
+      throw new SchemaViolationError(JSON.stringify(output), "Custom validator returned false");
+    }
+    return output;
+  }
+  throw new Error("Unknown schema type");
+}
+
+// src/core/generate.ts
+async function generate(model, schema, prompt, options = {}) {
+  const maxRetries = options.maxRetries ?? 3;
+  const { systemPrompt } = options;
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      const raw = await model.generate(prompt, schema, systemPrompt);
+      const data = validateOutput(raw, schema);
+      return {
+        data,
+        guaranteeLevel: model.guaranteeLevel,
+        attempts: attempt
+      };
+    } catch (err) {
+      if (!(err instanceof SchemaViolationError)) throw err;
+      if (attempt === maxRetries) break;
+    }
+  }
+  throw new MaxRetriesExceededError(maxRetries);
+}
+function toJsonSchema(schema) {
+  return zodToJsonSchema.zodToJsonSchema(schema, { target: "openApi3" });
+}
+function buildStructuredPrompt(prompt, schema, systemPrompt) {
+  let schemaInfo;
+  if (schema instanceof zod.z.ZodType) {
+    schemaInfo = `Respond with valid JSON matching this schema exactly:
+
+${JSON.stringify(toJsonSchema(schema), null, 2)}`;
+  } else if ("jsonSchema" in schema) {
+    schemaInfo = `Respond with valid JSON matching this schema exactly:
+
+${JSON.stringify(schema.jsonSchema, null, 2)}`;
+  } else if ("pattern" in schema) {
+    schemaInfo = `Respond with a plain string matching this pattern: ${schema.pattern}`;
+  } else {
+    schemaInfo = "Respond with valid output as required.";
+  }
+  const system = systemPrompt ? `${systemPrompt}
+
+${schemaInfo} No extra text, no markdown, no explanation.` : `You are a precise assistant. ${schemaInfo} No extra text, no markdown, no explanation.`;
+  return { system, user: prompt };
+}
+
+// src/core/parse.ts
+function parseAndValidate(raw, schema, opts = {}) {
+  if ("pattern" in schema) return raw;
+  try {
+    const text = opts.extractJson ? raw.match(/\{[\s\S]*\}|\[[\s\S]*\]/)?.[0] ?? raw : raw;
+    const parsed = JSON.parse(text);
+    if (isZodSchema(schema)) {
+      const result = schema.safeParse(parsed);
+      if (!result.success) throw new SchemaViolationError(raw, result.error);
+      return result.data;
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SchemaViolationError) throw err;
+    throw new SchemaViolationError(raw, err);
+  }
+}
+
+// src/backends/openai.ts
+function openai(options = {}) {
+  const modelId = options.model ?? "gpt-4o-mini";
+  return {
+    id: `openai:${modelId}`,
+    guaranteeLevel: "native",
+    async generate(prompt, schema, systemPrompt) {
+      const mod = await import('openai').catch(() => {
+        throw new Error("Install openai: npm install openai");
+      });
+      const OpenAI = mod.default ?? mod;
+      const client = new OpenAI({
+        apiKey: options.apiKey ?? process.env.OPENAI_API_KEY,
+        baseURL: options.baseURL
+      });
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      const responseFormat = isZodSchema(schema) ? {
+        type: "json_schema",
+        json_schema: { name: "output", strict: true, schema: toJsonSchema(schema) }
+      } : "jsonSchema" in schema ? {
+        type: "json_schema",
+        json_schema: { name: "output", strict: false, schema: schema.jsonSchema }
+      } : { type: "json_object" };
+      const response = await client.chat.completions.create({
+        model: modelId,
+        messages: [
+          { role: "system", content: system },
+          { role: "user", content: user }
+        ],
+        response_format: responseFormat
+      });
+      const raw = response.choices[0]?.message?.content ?? "";
+      return parseAndValidate(raw, schema);
+    }
+  };
+}
+
+// src/backends/ollama.ts
+function ollama(options) {
+  const host = options.host ?? "http://localhost:11434";
+  return {
+    id: `ollama:${options.model}`,
+    guaranteeLevel: "constrained",
+    async generate(prompt, schema, systemPrompt) {
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      let format = void 0;
+      if (isZodSchema(schema)) {
+        format = toJsonSchema(schema);
+      } else if ("jsonSchema" in schema) {
+        format = schema.jsonSchema;
+      }
+      const response = await fetch(`${host}/api/chat`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          model: options.model,
+          messages: [
+            { role: "system", content: system },
+            { role: "user", content: user }
+          ],
+          ...format ? { format } : {},
+          stream: false
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`Ollama error: ${response.status} ${response.statusText}`);
+      }
+      const json = await response.json();
+      const raw = json.message?.content ?? "";
+      return parseAndValidate(raw, schema);
+    }
+  };
+}
+
+// src/backends/anthropic.ts
+function anthropic(options = {}) {
+  const modelId = options.model ?? "claude-sonnet-4-6";
+  return {
+    id: `anthropic:${modelId}`,
+    guaranteeLevel: "best-effort",
+    async generate(prompt, schema, systemPrompt) {
+      const mod = await import('@anthropic-ai/sdk').catch(() => {
+        throw new Error("Install sdk: npm install @anthropic-ai/sdk");
+      });
+      const AnthropicClass = mod.default ?? mod;
+      const client = new AnthropicClass({
+        apiKey: options.apiKey ?? process.env.ANTHROPIC_API_KEY
+      });
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      const response = await client.messages.create({
+        model: modelId,
+        max_tokens: 4096,
+        system,
+        messages: [{ role: "user", content: user }]
+      });
+      const raw = response.content[0]?.type === "text" ? response.content[0].text : "";
+      return parseAndValidate(raw, schema, { extractJson: true });
+    }
+  };
+}
+
+// src/backends/groq.ts
+function groq(options = {}) {
+  const modelId = options.model ?? "llama-3.3-70b-versatile";
+  return {
+    id: `groq:${modelId}`,
+    guaranteeLevel: "native",
+    async generate(prompt, schema, systemPrompt) {
+      const mod = await import('groq-sdk').catch(() => {
+        throw new Error("Install groq: npm install groq-sdk");
+      });
+      const Groq = mod.default ?? mod;
+      const client = new Groq({
+        apiKey: options.apiKey ?? process.env.GROQ_API_KEY
+      });
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      const response = await client.chat.completions.create({
+        model: modelId,
+        messages: [
+          { role: "system", content: system },
+          { role: "user", content: user }
+        ],
+        response_format: { type: "json_object" }
+      });
+      const raw = response.choices[0]?.message?.content ?? "";
+      return parseAndValidate(raw, schema);
+    }
+  };
+}
+
+exports.MaxRetriesExceededError = MaxRetriesExceededError;
+exports.SchemaViolationError = SchemaViolationError;
+exports.anthropic = anthropic;
+exports.buildStructuredPrompt = buildStructuredPrompt;
+exports.generate = generate;
+exports.groq = groq;
+exports.ollama = ollama;
+exports.openai = openai;
+exports.toJsonSchema = toJsonSchema;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/core/validate.ts","../src/core/generate.ts","../src/core/schema.ts","../src/core/parse.ts","../src/backends/openai.ts","../src/backends/ollama.ts","../src/backends/anthropic.ts","../src/backends/groq.ts"],"names":["z","zodToJsonSchema"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from \"zod\";\n\nexport type GuaranteeLevel = \"constrained\" | \"native\" | \"best-effort\";\n\nexport type JsonSchemaInput = { jsonSchema: Record<string, unknown> };\nexport type PatternInput = { pattern: RegExp };\nexport type ValidatorInput = { validate: (output: unknown) => boolean };\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type SchemaInput<T = unknown> = z.ZodType<T> | JsonSchemaInput | PatternInput | ValidatorInput;\n\nexport interface ShapecraftModel {\n  id: string;\n  guaranteeLevel: GuaranteeLevel;\n  generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T>;\n}\n\nexport interface GenerateOptions {\n  maxRetries?: number;\n  systemPrompt?: string;\n  temperature?: number;\n}\n\nexport interface GenerateResult<T> {\n  data: T;\n  guaranteeLevel: GuaranteeLevel;\n  attempts: number;\n}\n\nexport class SchemaViolationError extends Error {\n  constructor(\n    public readonly raw: string,\n    public readonly validationErrors: unknown\n  ) {\n    super(\"Model output failed schema validation\");\n    this.name = \"SchemaViolationError\";\n  }\n}\n\nexport class MaxRetriesExceededError extends Error {\n  constructor(public readonly attempts: number) {\n    super(`Schema validation failed after ${attempts} attempts`);\n    this.name = \"MaxRetriesExceededError\";\n  }\n}\n","import { z } from \"zod\";\nimport type { SchemaInput } from \"../types.js\";\nimport { SchemaViolationError } from \"../types.js\";\n\nexport function isZodSchema(schema: SchemaInput): schema is z.ZodType<any> {\n  return schema instanceof z.ZodType;\n}\n\nfunction nullToUndefined(value: unknown): unknown {\n  if (value === null) return undefined;\n  if (Array.isArray(value)) return value.map(nullToUndefined);\n  if (typeof value === \"object\" && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>).map(([k, v]) => [k, nullToUndefined(v)])\n    );\n  }\n  return value;\n}\n\nfunction checkJsonSchema(value: unknown, schema: Record<string, unknown>): void {\n  const type = schema.type as string | undefined;\n\n  if (type) {\n    const actual = Array.isArray(value) ? \"array\" : value === null ? \"null\" : typeof value;\n    if (actual !== type) {\n      throw new Error(`Expected type \"${type}\", got \"${actual}\"`);\n    }\n  }\n\n  if (schema.enum) {\n    if (!(schema.enum as unknown[]).includes(value)) {\n      throw new Error(`Value not in enum: ${JSON.stringify(value)}`);\n    }\n  }\n\n  if (typeof value === \"object\" && value !== null && !Array.isArray(value) && schema.properties) {\n    const obj = value as Record<string, unknown>;\n    const required = (schema.required as string[]) ?? [];\n    const properties = schema.properties as Record<string, Record<string, unknown>>;\n\n    for (const key of required) {\n      if (!(key in obj)) throw new Error(`Missing required property: \"${key}\"`);\n    }\n\n    for (const [key, propSchema] of Object.entries(properties)) {\n      if (key in obj) checkJsonSchema(obj[key], propSchema);\n    }\n  }\n\n  if (Array.isArray(value) && schema.items) {\n    for (const item of value) {\n      checkJsonSchema(item, schema.items as Record<string, unknown>);\n    }\n  }\n}\n\nexport function validateOutput<T>(output: unknown, schema: SchemaInput<T>): T {\n  if (isZodSchema(schema)) {\n    const result = schema.safeParse(nullToUndefined(output));\n    if (!result.success) throw new SchemaViolationError(JSON.stringify(output), result.error);\n    return result.data;\n  }\n\n  if (\"jsonSchema\" in schema) {\n    try {\n      checkJsonSchema(output, schema.jsonSchema);\n    } catch (err) {\n      throw new SchemaViolationError(JSON.stringify(output), err);\n    }\n    return output as T;\n  }\n\n  if (\"pattern\" in schema) {\n    const str = typeof output === \"string\" ? output : JSON.stringify(output);\n    if (!schema.pattern.test(str)) {\n      throw new SchemaViolationError(str, `Output does not match pattern ${schema.pattern}`);\n    }\n    return output as T;\n  }\n\n  if (\"validate\" in schema) {\n    if (!schema.validate(output)) {\n      throw new SchemaViolationError(JSON.stringify(output), \"Custom validator returned false\");\n    }\n    return output as T;\n  }\n\n  throw new Error(\"Unknown schema type\");\n}\n","import type { GenerateOptions, GenerateResult, SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { MaxRetriesExceededError, SchemaViolationError } from \"../types.js\";\nimport { validateOutput } from \"./validate.js\";\n\nexport async function generate<T>(\n  model: ShapecraftModel,\n  schema: SchemaInput<T>,\n  prompt: string,\n  options: GenerateOptions = {}\n): Promise<GenerateResult<T>> {\n  const maxRetries = options.maxRetries ?? 3;\n  const { systemPrompt } = options;\n\n  for (let attempt = 1; attempt <= maxRetries; attempt++) {\n    try {\n      const raw = await model.generate<T>(prompt, schema, systemPrompt);\n      const data = validateOutput<T>(raw, schema);\n      return {\n        data,\n        guaranteeLevel: model.guaranteeLevel,\n        attempts: attempt,\n      };\n    } catch (err) {\n      if (!(err instanceof SchemaViolationError)) throw err;\n      if (attempt === maxRetries) break;\n    }\n  }\n\n  throw new MaxRetriesExceededError(maxRetries);\n}\n","import { z } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport type { SchemaInput } from \"../types.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function toJsonSchema(schema: z.ZodType<any>): Record<string, unknown> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return zodToJsonSchema(schema as any, { target: \"openApi3\" }) as Record<string, unknown>;\n}\n\nexport function buildStructuredPrompt(\n  prompt: string,\n  schema: SchemaInput,\n  systemPrompt?: string\n): { system: string; user: string } {\n  let schemaInfo: string;\n\n  if (schema instanceof z.ZodType) {\n    schemaInfo = `Respond with valid JSON matching this schema exactly:\\n\\n${JSON.stringify(toJsonSchema(schema), null, 2)}`;\n  } else if (\"jsonSchema\" in schema) {\n    schemaInfo = `Respond with valid JSON matching this schema exactly:\\n\\n${JSON.stringify(schema.jsonSchema, null, 2)}`;\n  } else if (\"pattern\" in schema) {\n    schemaInfo = `Respond with a plain string matching this pattern: ${schema.pattern}`;\n  } else {\n    schemaInfo = \"Respond with valid output as required.\";\n  }\n\n  const system = systemPrompt\n    ? `${systemPrompt}\\n\\n${schemaInfo} No extra text, no markdown, no explanation.`\n    : `You are a precise assistant. ${schemaInfo} No extra text, no markdown, no explanation.`;\n\n  return { system, user: prompt };\n}\n","import type { SchemaInput } from \"../types.js\";\nimport { SchemaViolationError } from \"../types.js\";\nimport { isZodSchema } from \"./validate.js\";\n\nexport function parseAndValidate<T>(\n  raw: string,\n  schema: SchemaInput<T>,\n  opts: { extractJson?: boolean } = {}\n): T {\n  // Pattern schemas return the raw string directly — no JSON parsing\n  if (\"pattern\" in (schema as object)) return raw as T;\n\n  try {\n    const text = opts.extractJson\n      ? (raw.match(/\\{[\\s\\S]*\\}|\\[[\\s\\S]*\\]/)?.[0] ?? raw)\n      : raw;\n    const parsed = JSON.parse(text);\n\n    if (isZodSchema(schema)) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const result = (schema as any).safeParse(parsed);\n      if (!result.success) throw new SchemaViolationError(raw, result.error);\n      return result.data as T;\n    }\n\n    return parsed as T;\n  } catch (err) {\n    if (err instanceof SchemaViolationError) throw err;\n    throw new SchemaViolationError(raw, err);\n  }\n}\n","import { z } from \"zod\";\nimport type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { toJsonSchema, buildStructuredPrompt } from \"../core/schema.js\";\nimport { isZodSchema } from \"../core/validate.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface OpenAIBackendOptions {\n  model?: string;\n  apiKey?: string;\n  baseURL?: string;\n}\n\nexport function openai(options: OpenAIBackendOptions = {}): ShapecraftModel {\n  const modelId = options.model ?? \"gpt-4o-mini\";\n\n  return {\n    id: `openai:${modelId}`,\n    guaranteeLevel: \"native\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const mod: any = await import(\"openai\").catch(() => {\n        throw new Error(\"Install openai: npm install openai\");\n      });\n\n      const OpenAI = mod.default ?? mod;\n      const client = new OpenAI({\n        apiKey: options.apiKey ?? process.env.OPENAI_API_KEY,\n        baseURL: options.baseURL,\n      });\n\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      // Use strict json_schema mode for Zod, non-strict for raw jsonSchema, json_object otherwise\n      const responseFormat = isZodSchema(schema)\n        ? {\n            type: \"json_schema\" as const,\n            json_schema: { name: \"output\", strict: true, schema: toJsonSchema(schema as z.ZodType<any>) },\n          }\n        : \"jsonSchema\" in (schema as object)\n          ? {\n              type: \"json_schema\" as const,\n              json_schema: { name: \"output\", strict: false, schema: (schema as { jsonSchema: Record<string, unknown> }).jsonSchema },\n            }\n          : { type: \"json_object\" as const };\n\n      const response = await client.chat.completions.create({\n        model: modelId,\n        messages: [\n          { role: \"system\", content: system },\n          { role: \"user\", content: user },\n        ],\n        response_format: responseFormat,\n      });\n\n      const raw: string = response.choices[0]?.message?.content ?? \"\";\n\n      return parseAndValidate<T>(raw, schema);\n    },\n  };\n}\n","import { z } from \"zod\";\nimport type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { toJsonSchema, buildStructuredPrompt } from \"../core/schema.js\";\nimport { isZodSchema } from \"../core/validate.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface OllamaBackendOptions {\n  model: string;\n  host?: string;\n}\n\nexport function ollama(options: OllamaBackendOptions): ShapecraftModel {\n  const host = options.host ?? \"http://localhost:11434\";\n\n  return {\n    id: `ollama:${options.model}`,\n    guaranteeLevel: \"constrained\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      // Pass JSON schema to Ollama's format param for constrained decoding when possible\n      let format: unknown = undefined;\n      if (isZodSchema(schema)) {\n        format = toJsonSchema(schema as z.ZodType<any>);\n      } else if (\"jsonSchema\" in (schema as object)) {\n        format = (schema as { jsonSchema: Record<string, unknown> }).jsonSchema;\n      }\n\n      const response = await fetch(`${host}/api/chat`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          model: options.model,\n          messages: [\n            { role: \"system\", content: system },\n            { role: \"user\", content: user },\n          ],\n          ...(format ? { format } : {}),\n          stream: false,\n        }),\n      });\n\n      if (!response.ok) {\n        throw new Error(`Ollama error: ${response.status} ${response.statusText}`);\n      }\n\n      const json = await response.json() as { message?: { content?: string } };\n      const raw = json.message?.content ?? \"\";\n\n      return parseAndValidate<T>(raw, schema);\n    },\n  };\n}\n","import type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { buildStructuredPrompt } from \"../core/schema.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface AnthropicBackendOptions {\n  model?: string;\n  apiKey?: string;\n}\n\nexport function anthropic(options: AnthropicBackendOptions = {}): ShapecraftModel {\n  const modelId = options.model ?? \"claude-sonnet-4-6\";\n\n  return {\n    id: `anthropic:${modelId}`,\n    guaranteeLevel: \"best-effort\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const mod: any = await import(\"@anthropic-ai/sdk\").catch(() => {\n        throw new Error(\"Install sdk: npm install @anthropic-ai/sdk\");\n      });\n\n      const AnthropicClass = mod.default ?? mod;\n      const client = new AnthropicClass({\n        apiKey: options.apiKey ?? process.env.ANTHROPIC_API_KEY,\n      });\n\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      const response = await client.messages.create({\n        model: modelId,\n        max_tokens: 4096,\n        system,\n        messages: [{ role: \"user\", content: user }],\n      });\n\n      const raw: string =\n        response.content[0]?.type === \"text\" ? response.content[0].text : \"\";\n\n      return parseAndValidate<T>(raw, schema, { extractJson: true });\n    },\n  };\n}\n","import type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { buildStructuredPrompt } from \"../core/schema.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface GroqBackendOptions {\n  model?: string;\n  apiKey?: string;\n}\n\nexport function groq(options: GroqBackendOptions = {}): ShapecraftModel {\n  const modelId = options.model ?? \"llama-3.3-70b-versatile\";\n\n  return {\n    id: `groq:${modelId}`,\n    guaranteeLevel: \"native\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const mod: any = await import(\"groq-sdk\").catch(() => {\n        throw new Error(\"Install groq: npm install groq-sdk\");\n      });\n\n      const Groq = mod.default ?? mod;\n      const client = new Groq({\n        apiKey: options.apiKey ?? process.env.GROQ_API_KEY,\n      });\n\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      const response = await client.chat.completions.create({\n        model: modelId,\n        messages: [\n          { role: \"system\", content: system },\n          { role: \"user\", content: user },\n        ],\n        response_format: { type: \"json_object\" },\n      });\n\n      const raw: string = response.choices[0]?.message?.content ?? \"\";\n\n      return parseAndValidate<T>(raw, schema);\n    },\n  };\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { generate } from "./core/generate.js";
+export { toJsonSchema, buildStructuredPrompt } from "./core/schema.js";
+export * from "./backends/index.js";
+export type { ShapecraftModel, SchemaInput, GenerateOptions, GenerateResult, GuaranteeLevel, } from "./types.js";
+export { SchemaViolationError, MaxRetriesExceededError } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,cAAc,qBAAqB,CAAC;AAEpC,YAAY,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,287 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+
+// src/types.ts
+var SchemaViolationError = class extends Error {
+  constructor(raw, validationErrors) {
+    super("Model output failed schema validation");
+    this.raw = raw;
+    this.validationErrors = validationErrors;
+    this.name = "SchemaViolationError";
+  }
+};
+var MaxRetriesExceededError = class extends Error {
+  constructor(attempts) {
+    super(`Schema validation failed after ${attempts} attempts`);
+    this.attempts = attempts;
+    this.name = "MaxRetriesExceededError";
+  }
+};
+function isZodSchema(schema) {
+  return schema instanceof z.ZodType;
+}
+function nullToUndefined(value) {
+  if (value === null) return void 0;
+  if (Array.isArray(value)) return value.map(nullToUndefined);
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(
+      Object.entries(value).map(([k, v]) => [k, nullToUndefined(v)])
+    );
+  }
+  return value;
+}
+function checkJsonSchema(value, schema) {
+  const type = schema.type;
+  if (type) {
+    const actual = Array.isArray(value) ? "array" : value === null ? "null" : typeof value;
+    if (actual !== type) {
+      throw new Error(`Expected type "${type}", got "${actual}"`);
+    }
+  }
+  if (schema.enum) {
+    if (!schema.enum.includes(value)) {
+      throw new Error(`Value not in enum: ${JSON.stringify(value)}`);
+    }
+  }
+  if (typeof value === "object" && value !== null && !Array.isArray(value) && schema.properties) {
+    const obj = value;
+    const required = schema.required ?? [];
+    const properties = schema.properties;
+    for (const key of required) {
+      if (!(key in obj)) throw new Error(`Missing required property: "${key}"`);
+    }
+    for (const [key, propSchema] of Object.entries(properties)) {
+      if (key in obj) checkJsonSchema(obj[key], propSchema);
+    }
+  }
+  if (Array.isArray(value) && schema.items) {
+    for (const item of value) {
+      checkJsonSchema(item, schema.items);
+    }
+  }
+}
+function validateOutput(output, schema) {
+  if (isZodSchema(schema)) {
+    const result = schema.safeParse(nullToUndefined(output));
+    if (!result.success) throw new SchemaViolationError(JSON.stringify(output), result.error);
+    return result.data;
+  }
+  if ("jsonSchema" in schema) {
+    try {
+      checkJsonSchema(output, schema.jsonSchema);
+    } catch (err) {
+      throw new SchemaViolationError(JSON.stringify(output), err);
+    }
+    return output;
+  }
+  if ("pattern" in schema) {
+    const str = typeof output === "string" ? output : JSON.stringify(output);
+    if (!schema.pattern.test(str)) {
+      throw new SchemaViolationError(str, `Output does not match pattern ${schema.pattern}`);
+    }
+    return output;
+  }
+  if ("validate" in schema) {
+    if (!schema.validate(output)) {
+      throw new SchemaViolationError(JSON.stringify(output), "Custom validator returned false");
+    }
+    return output;
+  }
+  throw new Error("Unknown schema type");
+}
+
+// src/core/generate.ts
+async function generate(model, schema, prompt, options = {}) {
+  const maxRetries = options.maxRetries ?? 3;
+  const { systemPrompt } = options;
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      const raw = await model.generate(prompt, schema, systemPrompt);
+      const data = validateOutput(raw, schema);
+      return {
+        data,
+        guaranteeLevel: model.guaranteeLevel,
+        attempts: attempt
+      };
+    } catch (err) {
+      if (!(err instanceof SchemaViolationError)) throw err;
+      if (attempt === maxRetries) break;
+    }
+  }
+  throw new MaxRetriesExceededError(maxRetries);
+}
+function toJsonSchema(schema) {
+  return zodToJsonSchema(schema, { target: "openApi3" });
+}
+function buildStructuredPrompt(prompt, schema, systemPrompt) {
+  let schemaInfo;
+  if (schema instanceof z.ZodType) {
+    schemaInfo = `Respond with valid JSON matching this schema exactly:
+
+${JSON.stringify(toJsonSchema(schema), null, 2)}`;
+  } else if ("jsonSchema" in schema) {
+    schemaInfo = `Respond with valid JSON matching this schema exactly:
+
+${JSON.stringify(schema.jsonSchema, null, 2)}`;
+  } else if ("pattern" in schema) {
+    schemaInfo = `Respond with a plain string matching this pattern: ${schema.pattern}`;
+  } else {
+    schemaInfo = "Respond with valid output as required.";
+  }
+  const system = systemPrompt ? `${systemPrompt}
+
+${schemaInfo} No extra text, no markdown, no explanation.` : `You are a precise assistant. ${schemaInfo} No extra text, no markdown, no explanation.`;
+  return { system, user: prompt };
+}
+
+// src/core/parse.ts
+function parseAndValidate(raw, schema, opts = {}) {
+  if ("pattern" in schema) return raw;
+  try {
+    const text = opts.extractJson ? raw.match(/\{[\s\S]*\}|\[[\s\S]*\]/)?.[0] ?? raw : raw;
+    const parsed = JSON.parse(text);
+    if (isZodSchema(schema)) {
+      const result = schema.safeParse(parsed);
+      if (!result.success) throw new SchemaViolationError(raw, result.error);
+      return result.data;
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SchemaViolationError) throw err;
+    throw new SchemaViolationError(raw, err);
+  }
+}
+
+// src/backends/openai.ts
+function openai(options = {}) {
+  const modelId = options.model ?? "gpt-4o-mini";
+  return {
+    id: `openai:${modelId}`,
+    guaranteeLevel: "native",
+    async generate(prompt, schema, systemPrompt) {
+      const mod = await import('openai').catch(() => {
+        throw new Error("Install openai: npm install openai");
+      });
+      const OpenAI = mod.default ?? mod;
+      const client = new OpenAI({
+        apiKey: options.apiKey ?? process.env.OPENAI_API_KEY,
+        baseURL: options.baseURL
+      });
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      const responseFormat = isZodSchema(schema) ? {
+        type: "json_schema",
+        json_schema: { name: "output", strict: true, schema: toJsonSchema(schema) }
+      } : "jsonSchema" in schema ? {
+        type: "json_schema",
+        json_schema: { name: "output", strict: false, schema: schema.jsonSchema }
+      } : { type: "json_object" };
+      const response = await client.chat.completions.create({
+        model: modelId,
+        messages: [
+          { role: "system", content: system },
+          { role: "user", content: user }
+        ],
+        response_format: responseFormat
+      });
+      const raw = response.choices[0]?.message?.content ?? "";
+      return parseAndValidate(raw, schema);
+    }
+  };
+}
+
+// src/backends/ollama.ts
+function ollama(options) {
+  const host = options.host ?? "http://localhost:11434";
+  return {
+    id: `ollama:${options.model}`,
+    guaranteeLevel: "constrained",
+    async generate(prompt, schema, systemPrompt) {
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      let format = void 0;
+      if (isZodSchema(schema)) {
+        format = toJsonSchema(schema);
+      } else if ("jsonSchema" in schema) {
+        format = schema.jsonSchema;
+      }
+      const response = await fetch(`${host}/api/chat`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          model: options.model,
+          messages: [
+            { role: "system", content: system },
+            { role: "user", content: user }
+          ],
+          ...format ? { format } : {},
+          stream: false
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`Ollama error: ${response.status} ${response.statusText}`);
+      }
+      const json = await response.json();
+      const raw = json.message?.content ?? "";
+      return parseAndValidate(raw, schema);
+    }
+  };
+}
+
+// src/backends/anthropic.ts
+function anthropic(options = {}) {
+  const modelId = options.model ?? "claude-sonnet-4-6";
+  return {
+    id: `anthropic:${modelId}`,
+    guaranteeLevel: "best-effort",
+    async generate(prompt, schema, systemPrompt) {
+      const mod = await import('@anthropic-ai/sdk').catch(() => {
+        throw new Error("Install sdk: npm install @anthropic-ai/sdk");
+      });
+      const AnthropicClass = mod.default ?? mod;
+      const client = new AnthropicClass({
+        apiKey: options.apiKey ?? process.env.ANTHROPIC_API_KEY
+      });
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      const response = await client.messages.create({
+        model: modelId,
+        max_tokens: 4096,
+        system,
+        messages: [{ role: "user", content: user }]
+      });
+      const raw = response.content[0]?.type === "text" ? response.content[0].text : "";
+      return parseAndValidate(raw, schema, { extractJson: true });
+    }
+  };
+}
+
+// src/backends/groq.ts
+function groq(options = {}) {
+  const modelId = options.model ?? "llama-3.3-70b-versatile";
+  return {
+    id: `groq:${modelId}`,
+    guaranteeLevel: "native",
+    async generate(prompt, schema, systemPrompt) {
+      const mod = await import('groq-sdk').catch(() => {
+        throw new Error("Install groq: npm install groq-sdk");
+      });
+      const Groq = mod.default ?? mod;
+      const client = new Groq({
+        apiKey: options.apiKey ?? process.env.GROQ_API_KEY
+      });
+      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);
+      const response = await client.chat.completions.create({
+        model: modelId,
+        messages: [
+          { role: "system", content: system },
+          { role: "user", content: user }
+        ],
+        response_format: { type: "json_object" }
+      });
+      const raw = response.choices[0]?.message?.content ?? "";
+      return parseAndValidate(raw, schema);
+    }
+  };
+}
+
+export { MaxRetriesExceededError, SchemaViolationError, anthropic, buildStructuredPrompt, generate, groq, ollama, openai, toJsonSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/core/validate.ts","../src/core/generate.ts","../src/core/schema.ts","../src/core/parse.ts","../src/backends/openai.ts","../src/backends/ollama.ts","../src/backends/anthropic.ts","../src/backends/groq.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from \"zod\";\n\nexport type GuaranteeLevel = \"constrained\" | \"native\" | \"best-effort\";\n\nexport type JsonSchemaInput = { jsonSchema: Record<string, unknown> };\nexport type PatternInput = { pattern: RegExp };\nexport type ValidatorInput = { validate: (output: unknown) => boolean };\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type SchemaInput<T = unknown> = z.ZodType<T> | JsonSchemaInput | PatternInput | ValidatorInput;\n\nexport interface ShapecraftModel {\n  id: string;\n  guaranteeLevel: GuaranteeLevel;\n  generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T>;\n}\n\nexport interface GenerateOptions {\n  maxRetries?: number;\n  systemPrompt?: string;\n  temperature?: number;\n}\n\nexport interface GenerateResult<T> {\n  data: T;\n  guaranteeLevel: GuaranteeLevel;\n  attempts: number;\n}\n\nexport class SchemaViolationError extends Error {\n  constructor(\n    public readonly raw: string,\n    public readonly validationErrors: unknown\n  ) {\n    super(\"Model output failed schema validation\");\n    this.name = \"SchemaViolationError\";\n  }\n}\n\nexport class MaxRetriesExceededError extends Error {\n  constructor(public readonly attempts: number) {\n    super(`Schema validation failed after ${attempts} attempts`);\n    this.name = \"MaxRetriesExceededError\";\n  }\n}\n","import { z } from \"zod\";\nimport type { SchemaInput } from \"../types.js\";\nimport { SchemaViolationError } from \"../types.js\";\n\nexport function isZodSchema(schema: SchemaInput): schema is z.ZodType<any> {\n  return schema instanceof z.ZodType;\n}\n\nfunction nullToUndefined(value: unknown): unknown {\n  if (value === null) return undefined;\n  if (Array.isArray(value)) return value.map(nullToUndefined);\n  if (typeof value === \"object\" && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>).map(([k, v]) => [k, nullToUndefined(v)])\n    );\n  }\n  return value;\n}\n\nfunction checkJsonSchema(value: unknown, schema: Record<string, unknown>): void {\n  const type = schema.type as string | undefined;\n\n  if (type) {\n    const actual = Array.isArray(value) ? \"array\" : value === null ? \"null\" : typeof value;\n    if (actual !== type) {\n      throw new Error(`Expected type \"${type}\", got \"${actual}\"`);\n    }\n  }\n\n  if (schema.enum) {\n    if (!(schema.enum as unknown[]).includes(value)) {\n      throw new Error(`Value not in enum: ${JSON.stringify(value)}`);\n    }\n  }\n\n  if (typeof value === \"object\" && value !== null && !Array.isArray(value) && schema.properties) {\n    const obj = value as Record<string, unknown>;\n    const required = (schema.required as string[]) ?? [];\n    const properties = schema.properties as Record<string, Record<string, unknown>>;\n\n    for (const key of required) {\n      if (!(key in obj)) throw new Error(`Missing required property: \"${key}\"`);\n    }\n\n    for (const [key, propSchema] of Object.entries(properties)) {\n      if (key in obj) checkJsonSchema(obj[key], propSchema);\n    }\n  }\n\n  if (Array.isArray(value) && schema.items) {\n    for (const item of value) {\n      checkJsonSchema(item, schema.items as Record<string, unknown>);\n    }\n  }\n}\n\nexport function validateOutput<T>(output: unknown, schema: SchemaInput<T>): T {\n  if (isZodSchema(schema)) {\n    const result = schema.safeParse(nullToUndefined(output));\n    if (!result.success) throw new SchemaViolationError(JSON.stringify(output), result.error);\n    return result.data;\n  }\n\n  if (\"jsonSchema\" in schema) {\n    try {\n      checkJsonSchema(output, schema.jsonSchema);\n    } catch (err) {\n      throw new SchemaViolationError(JSON.stringify(output), err);\n    }\n    return output as T;\n  }\n\n  if (\"pattern\" in schema) {\n    const str = typeof output === \"string\" ? output : JSON.stringify(output);\n    if (!schema.pattern.test(str)) {\n      throw new SchemaViolationError(str, `Output does not match pattern ${schema.pattern}`);\n    }\n    return output as T;\n  }\n\n  if (\"validate\" in schema) {\n    if (!schema.validate(output)) {\n      throw new SchemaViolationError(JSON.stringify(output), \"Custom validator returned false\");\n    }\n    return output as T;\n  }\n\n  throw new Error(\"Unknown schema type\");\n}\n","import type { GenerateOptions, GenerateResult, SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { MaxRetriesExceededError, SchemaViolationError } from \"../types.js\";\nimport { validateOutput } from \"./validate.js\";\n\nexport async function generate<T>(\n  model: ShapecraftModel,\n  schema: SchemaInput<T>,\n  prompt: string,\n  options: GenerateOptions = {}\n): Promise<GenerateResult<T>> {\n  const maxRetries = options.maxRetries ?? 3;\n  const { systemPrompt } = options;\n\n  for (let attempt = 1; attempt <= maxRetries; attempt++) {\n    try {\n      const raw = await model.generate<T>(prompt, schema, systemPrompt);\n      const data = validateOutput<T>(raw, schema);\n      return {\n        data,\n        guaranteeLevel: model.guaranteeLevel,\n        attempts: attempt,\n      };\n    } catch (err) {\n      if (!(err instanceof SchemaViolationError)) throw err;\n      if (attempt === maxRetries) break;\n    }\n  }\n\n  throw new MaxRetriesExceededError(maxRetries);\n}\n","import { z } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport type { SchemaInput } from \"../types.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function toJsonSchema(schema: z.ZodType<any>): Record<string, unknown> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return zodToJsonSchema(schema as any, { target: \"openApi3\" }) as Record<string, unknown>;\n}\n\nexport function buildStructuredPrompt(\n  prompt: string,\n  schema: SchemaInput,\n  systemPrompt?: string\n): { system: string; user: string } {\n  let schemaInfo: string;\n\n  if (schema instanceof z.ZodType) {\n    schemaInfo = `Respond with valid JSON matching this schema exactly:\\n\\n${JSON.stringify(toJsonSchema(schema), null, 2)}`;\n  } else if (\"jsonSchema\" in schema) {\n    schemaInfo = `Respond with valid JSON matching this schema exactly:\\n\\n${JSON.stringify(schema.jsonSchema, null, 2)}`;\n  } else if (\"pattern\" in schema) {\n    schemaInfo = `Respond with a plain string matching this pattern: ${schema.pattern}`;\n  } else {\n    schemaInfo = \"Respond with valid output as required.\";\n  }\n\n  const system = systemPrompt\n    ? `${systemPrompt}\\n\\n${schemaInfo} No extra text, no markdown, no explanation.`\n    : `You are a precise assistant. ${schemaInfo} No extra text, no markdown, no explanation.`;\n\n  return { system, user: prompt };\n}\n","import type { SchemaInput } from \"../types.js\";\nimport { SchemaViolationError } from \"../types.js\";\nimport { isZodSchema } from \"./validate.js\";\n\nexport function parseAndValidate<T>(\n  raw: string,\n  schema: SchemaInput<T>,\n  opts: { extractJson?: boolean } = {}\n): T {\n  // Pattern schemas return the raw string directly — no JSON parsing\n  if (\"pattern\" in (schema as object)) return raw as T;\n\n  try {\n    const text = opts.extractJson\n      ? (raw.match(/\\{[\\s\\S]*\\}|\\[[\\s\\S]*\\]/)?.[0] ?? raw)\n      : raw;\n    const parsed = JSON.parse(text);\n\n    if (isZodSchema(schema)) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const result = (schema as any).safeParse(parsed);\n      if (!result.success) throw new SchemaViolationError(raw, result.error);\n      return result.data as T;\n    }\n\n    return parsed as T;\n  } catch (err) {\n    if (err instanceof SchemaViolationError) throw err;\n    throw new SchemaViolationError(raw, err);\n  }\n}\n","import { z } from \"zod\";\nimport type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { toJsonSchema, buildStructuredPrompt } from \"../core/schema.js\";\nimport { isZodSchema } from \"../core/validate.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface OpenAIBackendOptions {\n  model?: string;\n  apiKey?: string;\n  baseURL?: string;\n}\n\nexport function openai(options: OpenAIBackendOptions = {}): ShapecraftModel {\n  const modelId = options.model ?? \"gpt-4o-mini\";\n\n  return {\n    id: `openai:${modelId}`,\n    guaranteeLevel: \"native\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const mod: any = await import(\"openai\").catch(() => {\n        throw new Error(\"Install openai: npm install openai\");\n      });\n\n      const OpenAI = mod.default ?? mod;\n      const client = new OpenAI({\n        apiKey: options.apiKey ?? process.env.OPENAI_API_KEY,\n        baseURL: options.baseURL,\n      });\n\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      // Use strict json_schema mode for Zod, non-strict for raw jsonSchema, json_object otherwise\n      const responseFormat = isZodSchema(schema)\n        ? {\n            type: \"json_schema\" as const,\n            json_schema: { name: \"output\", strict: true, schema: toJsonSchema(schema as z.ZodType<any>) },\n          }\n        : \"jsonSchema\" in (schema as object)\n          ? {\n              type: \"json_schema\" as const,\n              json_schema: { name: \"output\", strict: false, schema: (schema as { jsonSchema: Record<string, unknown> }).jsonSchema },\n            }\n          : { type: \"json_object\" as const };\n\n      const response = await client.chat.completions.create({\n        model: modelId,\n        messages: [\n          { role: \"system\", content: system },\n          { role: \"user\", content: user },\n        ],\n        response_format: responseFormat,\n      });\n\n      const raw: string = response.choices[0]?.message?.content ?? \"\";\n\n      return parseAndValidate<T>(raw, schema);\n    },\n  };\n}\n","import { z } from \"zod\";\nimport type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { toJsonSchema, buildStructuredPrompt } from \"../core/schema.js\";\nimport { isZodSchema } from \"../core/validate.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface OllamaBackendOptions {\n  model: string;\n  host?: string;\n}\n\nexport function ollama(options: OllamaBackendOptions): ShapecraftModel {\n  const host = options.host ?? \"http://localhost:11434\";\n\n  return {\n    id: `ollama:${options.model}`,\n    guaranteeLevel: \"constrained\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      // Pass JSON schema to Ollama's format param for constrained decoding when possible\n      let format: unknown = undefined;\n      if (isZodSchema(schema)) {\n        format = toJsonSchema(schema as z.ZodType<any>);\n      } else if (\"jsonSchema\" in (schema as object)) {\n        format = (schema as { jsonSchema: Record<string, unknown> }).jsonSchema;\n      }\n\n      const response = await fetch(`${host}/api/chat`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          model: options.model,\n          messages: [\n            { role: \"system\", content: system },\n            { role: \"user\", content: user },\n          ],\n          ...(format ? { format } : {}),\n          stream: false,\n        }),\n      });\n\n      if (!response.ok) {\n        throw new Error(`Ollama error: ${response.status} ${response.statusText}`);\n      }\n\n      const json = await response.json() as { message?: { content?: string } };\n      const raw = json.message?.content ?? \"\";\n\n      return parseAndValidate<T>(raw, schema);\n    },\n  };\n}\n","import type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { buildStructuredPrompt } from \"../core/schema.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface AnthropicBackendOptions {\n  model?: string;\n  apiKey?: string;\n}\n\nexport function anthropic(options: AnthropicBackendOptions = {}): ShapecraftModel {\n  const modelId = options.model ?? \"claude-sonnet-4-6\";\n\n  return {\n    id: `anthropic:${modelId}`,\n    guaranteeLevel: \"best-effort\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const mod: any = await import(\"@anthropic-ai/sdk\").catch(() => {\n        throw new Error(\"Install sdk: npm install @anthropic-ai/sdk\");\n      });\n\n      const AnthropicClass = mod.default ?? mod;\n      const client = new AnthropicClass({\n        apiKey: options.apiKey ?? process.env.ANTHROPIC_API_KEY,\n      });\n\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      const response = await client.messages.create({\n        model: modelId,\n        max_tokens: 4096,\n        system,\n        messages: [{ role: \"user\", content: user }],\n      });\n\n      const raw: string =\n        response.content[0]?.type === \"text\" ? response.content[0].text : \"\";\n\n      return parseAndValidate<T>(raw, schema, { extractJson: true });\n    },\n  };\n}\n","import type { SchemaInput, ShapecraftModel } from \"../types.js\";\nimport { buildStructuredPrompt } from \"../core/schema.js\";\nimport { parseAndValidate } from \"../core/parse.js\";\n\nexport interface GroqBackendOptions {\n  model?: string;\n  apiKey?: string;\n}\n\nexport function groq(options: GroqBackendOptions = {}): ShapecraftModel {\n  const modelId = options.model ?? \"llama-3.3-70b-versatile\";\n\n  return {\n    id: `groq:${modelId}`,\n    guaranteeLevel: \"native\",\n\n    async generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const mod: any = await import(\"groq-sdk\").catch(() => {\n        throw new Error(\"Install groq: npm install groq-sdk\");\n      });\n\n      const Groq = mod.default ?? mod;\n      const client = new Groq({\n        apiKey: options.apiKey ?? process.env.GROQ_API_KEY,\n      });\n\n      const { system, user } = buildStructuredPrompt(prompt, schema, systemPrompt);\n\n      const response = await client.chat.completions.create({\n        model: modelId,\n        messages: [\n          { role: \"system\", content: system },\n          { role: \"user\", content: user },\n        ],\n        response_format: { type: \"json_object\" },\n      });\n\n      const raw: string = response.choices[0]?.message?.content ?? \"\";\n\n      return parseAndValidate<T>(raw, schema);\n    },\n  };\n}\n"]}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export type GuaranteeLevel = "constrained" | "native" | "best-effort";
+export type JsonSchemaInput = {
+    jsonSchema: Record<string, unknown>;
+};
+export type PatternInput = {
+    pattern: RegExp;
+};
+export type ValidatorInput = {
+    validate: (output: unknown) => boolean;
+};
+export type SchemaInput<T = unknown> = z.ZodType<T> | JsonSchemaInput | PatternInput | ValidatorInput;
+export interface ShapecraftModel {
+    id: string;
+    guaranteeLevel: GuaranteeLevel;
+    generate<T>(prompt: string, schema: SchemaInput<T>, systemPrompt?: string): Promise<T>;
+}
+export interface GenerateOptions {
+    maxRetries?: number;
+    systemPrompt?: string;
+    temperature?: number;
+}
+export interface GenerateResult<T> {
+    data: T;
+    guaranteeLevel: GuaranteeLevel;
+    attempts: number;
+}
+export declare class SchemaViolationError extends Error {
+    readonly raw: string;
+    readonly validationErrors: unknown;
+    constructor(raw: string, validationErrors: unknown);
+}
+export declare class MaxRetriesExceededError extends Error {
+    readonly attempts: number;
+    constructor(attempts: number);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/C,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,eAAe,GAAG,YAAY,GAAG,cAAc,CAAC;AAEtG,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,GAAG,EAAE,MAAM;aACX,gBAAgB,EAAE,OAAO;gBADzB,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,OAAO;CAK5C;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aACpB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAI7C"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@aviasole/shapecraft",
+  "version": "0.1.0",
+  "description": "Structured output generation for LLMs in Node.js — token-level constraints for local models, native JSON modes for cloud APIs",
+  "author": "Aviasole Technologies",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aviasoletechnologies/shapecraft.git"
+  },
+  "homepage": "https://github.com/aviasoletechnologies/shapecraft#readme",
+  "bugs": {
+    "url": "https://github.com/aviasoletechnologies/shapecraft/issues"
+  },
+  "keywords": [
+    "llm",
+    "structured-output",
+    "constrained-generation",
+    "json-schema",
+    "zod",
+    "openai",
+    "ollama",
+    "llama",
+    "ai"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run typecheck && npm run test"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "peerDependencies": {
+    "node-llama-cpp": ">=3.0.0",
+    "openai": ">=4.0.0",
+    "ollama": ">=0.5.0",
+    "zod": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "node-llama-cpp": { "optional": true },
+    "openai": { "optional": true },
+    "ollama": { "optional": true }
+  },
+  "dependencies": {
+    "zod-to-json-schema": "^3.23.0"
+  }
+}