structformatter 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.2] - 2025-12-26
+
+### Changed
+
+- Rename npm package + CLI from `structuredformatter` to `structformatter`.
+- Env vars: prefer `STRUCTFORMATTER_*` (old `STRUCTUREDFORMATTER_*` still accepted).
+- Docs/specs updated to the new name.
+
+## [0.1.1] - 2025-12-26
+
+### Added
+
+- `CHANGELOG.md`.
+
+### Changed
+
+- Packaging: run build via `prepack` so `npm pack`/`npm publish` don’t require `pnpm`.
+- Publish docs: note npm’s session-based auth and CI/CD token guidance.
+
+## [0.1.0] - 2025-12-26
+
+### Added
+
+- OpenAI-compatible proxy server that enforces JSON Schema structured outputs via an extract/repair/validate/retry loop.
+- CLI `structformatter` for running the server with a config file.
+- Config schema + validation, plus a `config.example.yaml`.
+- Vitest test suite for core behaviors.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 StructFormatter contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# StructFormatter
+
+<p align="center">
+  <a href="README.md"><img src="https://img.shields.io/badge/lang-English-blue.svg" alt="English"></a>
+  <a href="README.zh-CN.md"><img src="https://img.shields.io/badge/lang-简体中文-red.svg" alt="简体中文"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/FrankQDWang/StructFormatter/actions/workflows/ci.yml"><img src="https://github.com/FrankQDWang/StructFormatter/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/structformatter"><img src="https://img.shields.io/npm/v/structformatter" alt="npm"></a>
+</p>
+
+StructFormatter is an **OpenAI-compatible proxy (sidecar)** that makes **non-native** LLM APIs behave like they support **`response_format: { type: "json_schema" }`**.
+
+It enforces schema validity via a robust “B strategy” loop:
+prompting → JSON extraction → JSON repair → JSON Schema validation (Ajv) → deterministic fixes → re-ask retries.
+
+The `specs/` directory is the source of truth (architecture, API contract, algorithm, testing plan, and checklist).
+
+## Why you may want this
+
+If you use agents that rely on structured outputs, many providers only offer “JSON mode” (valid JSON) but **not** JSON Schema constrained decoding.
+
+This service lets your agent keep calling an OpenAI-shaped endpoint, while StructFormatter enforces schema validity behind the scenes.
+
+## Quickstart (from source)
+
+```bash
+pnpm install
+cp config.example.yaml config.yaml
+export STRUCTFORMATTER_CONFIG=./config.yaml
+pnpm dev
+```
+
+Endpoints:
+- `GET /healthz`
+- `GET /v1/models`
+- `POST /v1/chat/completions`
+
+## Quickstart (npm)
+
+After publishing:
+
+```bash
+pnpm dlx structformatter --config ./config.yaml
+```
+
+or:
+
+```bash
+npx structformatter --config ./config.yaml
+```
+
+## Agent integration (drop-in)
+
+Point your OpenAI SDK `base_url` to this server:
+
+- Base URL: `http://localhost:8080/v1`
+- Model naming: `provider/model` (e.g. `deepseek/deepseek-chat`)
+  - or use `routing.model_aliases` in `config.yaml` (e.g. `glm` → `zai/glm-4.5`)
+
+When your request contains:
+
+```json
+{
+  "response_format": {
+    "type": "json_schema",
+    "json_schema": { "name": "X", "strict": true, "schema": { "...": "..." } }
+  }
+}
+```
+
+StructFormatter will:
+- return `choices[0].message.content` as a JSON string that **validates against your schema**, or
+- return HTTP **422** with a typed error payload (see `specs/api.md`).
+
+## Config
+
+Copy `config.example.yaml` and edit providers + routing:
+
+- `providers.<name>.base_url`
+- `providers.<name>.api_key_env`
+- `providers.<name>.capabilities.json_object` (recommended when upstream supports JSON mode)
+- `routing.model_aliases` (optional)
+
+## Debugging
+
+Optional request headers:
+- `X-SF-Debug: 1` → include `__debug` field in the response
+- `X-SF-Max-Attempts: 5` → override attempt budget for this request (1–10)
+
+## Streaming
+
+Per `specs/api.md` (v1):
+- `stream=true` + `json_schema` → **400** (not supported)
+- `stream=true` without `json_schema` → **SSE pass-through** to upstream
+
+## Examples
+
+```bash
+bash examples/curl_schema_enforced.sh
+python examples/python_openai_sdk_dropin.py
+```
+
+## Publishing to npm
+
+Notes (npm auth changes as of Dec 2025):
+- `npm login` is session-based (short-lived), so publish shortly after logging in.
+- Publishing typically requires 2FA; for CI/CD use a granular token (not classic) or npm trusted publishing (OIDC).
+
+1) Log in:
+
+```bash
+npm login
+npm whoami
+```
+
+2) Publish (runs `npm run build` via `prepack`):
+
+```bash
+npm publish
+```

package/README.zh-CN.md

@@ -0,0 +1,122 @@
+# StructFormatter
+
+<p align="center">
+  <a href="README.md"><img src="https://img.shields.io/badge/lang-English-blue.svg" alt="English"></a>
+  <a href="README.zh-CN.md"><img src="https://img.shields.io/badge/lang-简体中文-red.svg" alt="简体中文"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/FrankQDWang/StructFormatter/actions/workflows/ci.yml"><img src="https://github.com/FrankQDWang/StructFormatter/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/structformatter"><img src="https://img.shields.io/npm/v/structformatter" alt="npm"></a>
+</p>
+
+StructFormatter 是一个 **OpenAI 兼容的代理服务（sidecar/proxy）**：让**不支持原生 JSON Schema 约束解码（A）** 的上游模型，也能“像支持 A 一样”返回结构化 JSON。
+
+它用一套稳健的 **B 策略闭环** 来强制输出满足 schema：
+提示词 → JSON 抽取 → JSON 修复（jsonrepair）→ JSON Schema 校验（Ajv）→ 机械修补 → 带错误信息 re-ask 重试。
+
+`specs/` 目录是项目的设计与验收来源（架构、API 合约、算法、测试计划、任务清单）。
+
+## 适用场景
+
+很多厂商只提供 “JSON mode”（保证输出是合法 JSON），但**不保证**符合你提供的 JSON Schema。
+
+如果你的 agent 流程强依赖结构化输出，StructFormatter 可以作为一个“外置桥接服务”，让你的 agent **基本不用改逻辑**，只改 `base_url` 即可。
+
+## 快速开始（源码运行）
+
+```bash
+pnpm install
+cp config.example.yaml config.yaml
+export STRUCTFORMATTER_CONFIG=./config.yaml
+pnpm dev
+```
+
+对外接口：
+- `GET /healthz`
+- `GET /v1/models`
+- `POST /v1/chat/completions`
+
+## 快速开始（npm）
+
+发布到 npm 后，可直接运行：
+
+```bash
+pnpm dlx structformatter --config ./config.yaml
+```
+
+或：
+
+```bash
+npx structformatter --config ./config.yaml
+```
+
+## 如何嵌入现有 agent（Drop-in）
+
+把 OpenAI SDK 的 `base_url` 指向本服务：
+
+- Base URL：`http://localhost:8080/v1`
+- `model` 命名：`provider/model`（例如 `deepseek/deepseek-chat`）
+  - 或者在 `config.yaml` 里用 `routing.model_aliases` 做别名映射
+
+当你的请求包含：
+
+```json
+{
+  "response_format": {
+    "type": "json_schema",
+    "json_schema": { "name": "X", "strict": true, "schema": { "...": "..." } }
+  }
+}
+```
+
+StructFormatter 会承诺：
+- 成功：`choices[0].message.content` 是**可解析且符合 schema 的 JSON 字符串**
+- 失败：HTTP **422** + 结构化错误（见 `specs/api.md`）
+
+## 配置说明
+
+建议从 `config.example.yaml` 复制一份：
+
+- `providers.<name>.base_url`：上游 OpenAI-compatible 地址
+- `providers.<name>.api_key_env`：从环境变量读取 key（避免写死在文件里）
+- `providers.<name>.capabilities.json_object`：上游支持 JSON mode 时建议开启
+- `routing.model_aliases`：可选别名映射（如 `glm` → `zai/glm-4.5`）
+
+## 调试与可观测性
+
+可选请求头：
+- `X-SF-Debug: 1` → 响应中包含 `__debug`
+- `X-SF-Max-Attempts: 5` → 覆盖本次请求的最大重试次数（1–10）
+
+## Streaming（v1 规则）
+
+严格遵循 `specs/api.md`：
+- `stream=true` 且 `json_schema` → **400**（v1 不支持）
+- `stream=true` 且非 `json_schema` → **SSE 透传上游**
+
+## 示例
+
+```bash
+bash examples/curl_schema_enforced.sh
+python examples/python_openai_sdk_dropin.py
+```
+
+## 发布到 npm
+
+备注（npm 在 2025-12 之后的鉴权变化）：
+- `npm login` 改为基于 session 的短时登录态，建议登录后尽快发布。
+- 发布通常需要 2FA；如果走 CI/CD，请使用 granular token（不要用 classic token）或配置 npm trusted publishing（OIDC）。
+
+1) 先登录 npm：
+
+```bash
+npm login
+npm whoami
+```
+
+2) 发布（`prepack` 会自动执行 `npm run build`）：
+
+```bash
+npm publish
+```

package/config.example.yaml

@@ -0,0 +1,37 @@
+server:
+  host: 0.0.0.0
+  port: 8080
+  request_body_limit_mb: 2
+
+enforcement:
+  max_attempts: 3
+  timeout_ms_per_attempt: 20000
+  enable_jsonrepair: true
+  enable_deterministic_fix: true
+  enable_type_coercion: true
+  schema_max_bytes: 200000
+  validator_cache_size: 128
+
+routing:
+  mode: provider_prefix
+  model_aliases:
+    glm: "zai/glm-4.5"
+    ds: "deepseek/deepseek-chat"
+
+providers:
+  deepseek:
+    type: openai_compatible
+    base_url: "https://api.deepseek.com"
+    api_key_env: "DEEPSEEK_API_KEY"
+    capabilities:
+      json_object: true
+    drop_params: []
+
+  zai:
+    type: openai_compatible
+    base_url: "https://api.z.ai/api/paas/v4"
+    api_key_env: "ZAI_API_KEY"
+    capabilities:
+      json_object: true
+    drop_params: []
+

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const load_1 = require("./config/load");
+const server_1 = require("./server");
+function printHelp() {
+    console.log([
+        'StructFormatter (OpenAI-compatible structured output proxy)',
+        '',
+        'Usage:',
+        '  structformatter [--config <path>]',
+        '',
+        'Options:',
+        '  --config, -c   Path to config.yaml/config.json (defaults to STRUCTFORMATTER_CONFIG or ./config.{yaml,yml,json})',
+        '  --help, -h     Show this help',
+        '',
+    ].join('\n'));
+}
+function parseArgs(argv) {
+    let configPath;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--help' || a === '-h')
+            return { help: true };
+        if (a === '--config' || a === '-c') {
+            configPath = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (a.startsWith('--config=')) {
+            configPath = a.slice('--config='.length);
+            continue;
+        }
+    }
+    return { help: false, configPath };
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        printHelp();
+        return;
+    }
+    const config = (0, load_1.loadConfig)(args.configPath);
+    console.log((0, load_1.summarizeConfig)(config));
+    const app = (0, server_1.createServer)(config);
+    await app.listen({ port: config.server.port, host: config.server.host });
+}
+void main();

package/dist/config/load.d.ts

@@ -0,0 +1,3 @@
+import { type AppConfig } from './schema';
+export declare function loadConfig(explicitPath?: string): AppConfig;
+export declare function summarizeConfig(config: AppConfig): string;

package/dist/config/load.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.summarizeConfig = summarizeConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = __importDefault(require("yaml"));
+const schema_1 = require("./schema");
+function readConfigFile(filePath) {
+    const text = node_fs_1.default.readFileSync(filePath, 'utf8');
+    const ext = node_path_1.default.extname(filePath).toLowerCase();
+    if (ext === '.yaml' || ext === '.yml')
+        return yaml_1.default.parse(text);
+    if (ext === '.json')
+        return JSON.parse(text);
+    throw new Error(`Unsupported config extension: ${ext}`);
+}
+function candidatePaths(explicitPath) {
+    const fromEnv = process.env.STRUCTFORMATTER_CONFIG ?? process.env.STRUCTUREDFORMATTER_CONFIG;
+    const candidates = [
+        explicitPath,
+        fromEnv && fromEnv !== explicitPath ? fromEnv : undefined,
+        'config.yaml',
+        'config.yml',
+        'config.json',
+    ].filter(Boolean);
+    return [...new Set(candidates)];
+}
+function loadConfig(explicitPath) {
+    let raw = {};
+    for (const p of candidatePaths(explicitPath)) {
+        if (!node_fs_1.default.existsSync(p))
+            continue;
+        raw = readConfigFile(p);
+        break;
+    }
+    const config = schema_1.AppConfigSchema.parse(raw);
+    const hostEnv = process.env.STRUCTFORMATTER_HOST ?? process.env.STRUCTUREDFORMATTER_HOST;
+    if (hostEnv)
+        config.server.host = hostEnv;
+    const portEnv = process.env.STRUCTFORMATTER_PORT ?? process.env.STRUCTUREDFORMATTER_PORT;
+    if (portEnv) {
+        const port = Number(portEnv);
+        if (!Number.isInteger(port) || port <= 0 || port > 65535) {
+            throw new Error('STRUCTFORMATTER_PORT must be an integer in [1, 65535].');
+        }
+        config.server.port = port;
+    }
+    return config;
+}
+function summarizeConfig(config) {
+    const providers = Object.keys(config.providers).sort().join(', ') || '(none)';
+    return [
+        'StructFormatter config:',
+        `- server: ${config.server.host}:${config.server.port}`,
+        `- enforcement: max_attempts=${config.enforcement.max_attempts}, timeout_ms_per_attempt=${config.enforcement.timeout_ms_per_attempt}`,
+        `- providers: ${providers}`,
+    ].join('\n');
+}

package/dist/config/schema.d.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+export declare const ServerConfigSchema: z.ZodDefault<z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    request_body_limit_mb: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const EnforcementConfigSchema: z.ZodDefault<z.ZodObject<{
+    max_attempts: z.ZodDefault<z.ZodNumber>;
+    timeout_ms_per_attempt: z.ZodDefault<z.ZodNumber>;
+    enable_jsonrepair: z.ZodDefault<z.ZodBoolean>;
+    enable_deterministic_fix: z.ZodDefault<z.ZodBoolean>;
+    enable_type_coercion: z.ZodDefault<z.ZodBoolean>;
+    schema_max_bytes: z.ZodDefault<z.ZodNumber>;
+    validator_cache_size: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const RoutingConfigSchema: z.ZodDefault<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodLiteral<"provider_prefix">>;
+    model_aliases: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>>;
+export declare const ProviderCapabilitiesSchema: z.ZodDefault<z.ZodObject<{
+    json_object: z.ZodDefault<z.ZodBoolean>;
+    tools: z.ZodDefault<z.ZodBoolean>;
+    strict_tools: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>>;
+export declare const ProviderConfigSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"openai_compatible">>;
+    base_url: z.ZodString;
+    api_key_env: z.ZodOptional<z.ZodString>;
+    beta_base_url: z.ZodOptional<z.ZodString>;
+    default_headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    drop_params: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    capabilities: z.ZodDefault<z.ZodObject<{
+        json_object: z.ZodDefault<z.ZodBoolean>;
+        tools: z.ZodDefault<z.ZodBoolean>;
+        strict_tools: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const AppConfigSchema: z.ZodDefault<z.ZodObject<{
+    server: z.ZodDefault<z.ZodObject<{
+        host: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+        request_body_limit_mb: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    enforcement: z.ZodDefault<z.ZodObject<{
+        max_attempts: z.ZodDefault<z.ZodNumber>;
+        timeout_ms_per_attempt: z.ZodDefault<z.ZodNumber>;
+        enable_jsonrepair: z.ZodDefault<z.ZodBoolean>;
+        enable_deterministic_fix: z.ZodDefault<z.ZodBoolean>;
+        enable_type_coercion: z.ZodDefault<z.ZodBoolean>;
+        schema_max_bytes: z.ZodDefault<z.ZodNumber>;
+        validator_cache_size: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    routing: z.ZodDefault<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodLiteral<"provider_prefix">>;
+        model_aliases: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"openai_compatible">>;
+        base_url: z.ZodString;
+        api_key_env: z.ZodOptional<z.ZodString>;
+        beta_base_url: z.ZodOptional<z.ZodString>;
+        default_headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        drop_params: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        capabilities: z.ZodDefault<z.ZodObject<{
+            json_object: z.ZodDefault<z.ZodBoolean>;
+            tools: z.ZodDefault<z.ZodBoolean>;
+            strict_tools: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>>;
+export type AppConfig = z.infer<typeof AppConfigSchema>;
+export type ProviderConfig = z.infer<typeof ProviderConfigSchema>;

package/dist/config/schema.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppConfigSchema = exports.ProviderConfigSchema = exports.ProviderCapabilitiesSchema = exports.RoutingConfigSchema = exports.EnforcementConfigSchema = exports.ServerConfigSchema = void 0;
+const zod_1 = require("zod");
+exports.ServerConfigSchema = zod_1.z
+    .object({
+    host: zod_1.z.string().default('0.0.0.0'),
+    port: zod_1.z.number().int().min(1).max(65535).default(8080),
+    request_body_limit_mb: zod_1.z.number().int().min(1).max(100).default(2),
+})
+    .default({ host: '0.0.0.0', port: 8080, request_body_limit_mb: 2 });
+exports.EnforcementConfigSchema = zod_1.z
+    .object({
+    max_attempts: zod_1.z.number().int().min(1).max(10).default(3),
+    timeout_ms_per_attempt: zod_1.z.number().int().min(100).default(20_000),
+    enable_jsonrepair: zod_1.z.boolean().default(true),
+    enable_deterministic_fix: zod_1.z.boolean().default(true),
+    enable_type_coercion: zod_1.z.boolean().default(true),
+    schema_max_bytes: zod_1.z.number().int().min(1_000).default(200_000),
+    validator_cache_size: zod_1.z.number().int().min(1).max(10_000).default(128),
+})
+    .default({
+    max_attempts: 3,
+    timeout_ms_per_attempt: 20_000,
+    enable_jsonrepair: true,
+    enable_deterministic_fix: true,
+    enable_type_coercion: true,
+    schema_max_bytes: 200_000,
+    validator_cache_size: 128,
+});
+exports.RoutingConfigSchema = zod_1.z
+    .object({
+    mode: zod_1.z.literal('provider_prefix').default('provider_prefix'),
+    model_aliases: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).default({}),
+})
+    .default({ mode: 'provider_prefix', model_aliases: {} });
+exports.ProviderCapabilitiesSchema = zod_1.z
+    .object({
+    json_object: zod_1.z.boolean().default(false),
+    tools: zod_1.z.boolean().default(false),
+    strict_tools: zod_1.z.boolean().default(false),
+})
+    .default({ json_object: false, tools: false, strict_tools: false });
+exports.ProviderConfigSchema = zod_1.z.object({
+    type: zod_1.z.literal('openai_compatible').default('openai_compatible'),
+    base_url: zod_1.z.string().min(1),
+    api_key_env: zod_1.z.string().min(1).optional(),
+    beta_base_url: zod_1.z.string().min(1).optional(),
+    default_headers: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).default({}),
+    drop_params: zod_1.z.array(zod_1.z.string()).default([]),
+    capabilities: exports.ProviderCapabilitiesSchema,
+});
+exports.AppConfigSchema = zod_1.z
+    .object({
+    server: exports.ServerConfigSchema,
+    enforcement: exports.EnforcementConfigSchema,
+    routing: exports.RoutingConfigSchema,
+    providers: zod_1.z.record(zod_1.z.string(), exports.ProviderConfigSchema).default({}),
+})
+    .default({
+    server: { host: '0.0.0.0', port: 8080, request_body_limit_mb: 2 },
+    enforcement: {
+        max_attempts: 3,
+        timeout_ms_per_attempt: 20_000,
+        enable_jsonrepair: true,
+        enable_deterministic_fix: true,
+        enable_type_coercion: true,
+        schema_max_bytes: 200_000,
+        validator_cache_size: 128,
+    },
+    routing: { mode: 'provider_prefix', model_aliases: {} },
+    providers: {},
+});

package/dist/enforce/engine.d.ts

@@ -0,0 +1,15 @@
+import type { EnforcementPolicy, ProviderAdapter, StructuredError, StructuredResult } from '../types/internal';
+import type { OpenAIChatCompletionsRequest } from '../types/openai';
+import type { ValidatorCache } from '../validate/cache';
+export declare function enforceJsonSchema(args: {
+    requestId: string;
+    adapter: ProviderAdapter;
+    provider: string;
+    baseUrl: string;
+    upstreamModel: string;
+    originalRequest: OpenAIChatCompletionsRequest;
+    schema: Record<string, unknown>;
+    policy: EnforcementPolicy;
+    validatorCache: ValidatorCache;
+    debug: boolean;
+}): Promise<StructuredResult | StructuredError>;