apcore-toolkit 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## [0.3.0] - 2026-03-19
+
+### Added
+
+- `deepResolveRefs()` — recursive `$ref` resolution for nested OpenAPI schemas,
+  handling `allOf`/`anyOf`/`oneOf`, `items`, and `properties`. Depth-limited to 16
+  levels to prevent infinite recursion on circular references. Exported from
+  package index for downstream use.
+- `Enhancer` interface — pluggable contract for metadata enhancement, allowing
+  custom enhancers beyond the built-in `AIEnhancer`.
+
+### Fixed
+
+- `extractOutputSchema()` — now recursively resolves all nested `$ref` pointers
+  via `deepResolveRefs` (previously only handled the shallow case of array items
+  with `$ref`).
+- `extractInputSchema()` — now recursively resolves `$ref` inside individual
+  properties after assembly (was missing entirely).
+- `WriteError.cause` — explicit typed `override readonly cause: Error` property,
+  narrowing from the base `unknown` type.
+
+### Tests
+
+- 182 tests (up from 171), all passing
+- Added `deepResolveRefs` test suite (8 tests): top-level ref, nested properties,
+  allOf/anyOf, array items, deeply nested refs, circular ref depth limit,
+  immutability guarantee
+- Added nested `$ref` tests for `extractInputSchema` and `extractOutputSchema`
+- Shared `OPENAPI_DOC` fixture with rich schema graph for all openapi tests
+
+---
+
+## [0.2.0] - 2026-03-12
+
+### Added
+
+- `AIEnhancer` class — SLM-based metadata enhancement using OpenAI-compatible
+  APIs (Ollama, vLLM, LM Studio). Fills missing descriptions, infers behavioral
+  annotations (all 11 fields: `readonly`, `destructive`, `idempotent`,
+  `requires_approval`, `open_world`, `streaming`, `cacheable`, `cache_ttl`,
+  `cache_key_fields`, `paginated`, `pagination_style`), and generates input
+  schemas. AI-generated fields tagged with `x-generated-by: slm` for auditability.
+- `createWriteResult()` factory and `runVerifierChain()` helper for writer operations.
+  `verify: true` runs the built-in verifier (`YAMLVerifier`, `SyntaxVerifier`,
+  `RegistryVerifier`) even when no custom `verifiers` are provided.
+- `allowedPrefixes` parameter on `resolveTarget()` for path restriction security
+
+### Fixed
+
+- `inferAnnotationsFromMethod()` — `GET` now infers `cacheable: true` in addition
+  to `readonly: true`, matching Python parity
+- `filterModules()` — use `safeRegExp()` that tries regex first and falls back
+  to escaped literal on invalid patterns (balances spec compliance with safety)
+- `YAMLWriter._buildBinding()` — use `structuredClone()` for deep cloning nested
+  schemas instead of shallow spread
+- `WriteError` — use native ES2022 `Error.cause` instead of shadowing the property
+- `JSONVerifier` — restored `schema` constructor parameter for cross-language
+  API parity with Python SDK
+
+### Tests
+
+- 171 tests across 14 files, all passing
+- Added `RegistryVerifier` test coverage (pass, fail, missing method)
+- Added `resolveTarget` allowedPrefixes tests
+- Full AIEnhancer test suite (15 tests)
+
+---
+
 ## [0.1.0] - 2026-03-07
 
 ### Added

package/README.md

@@ -12,6 +12,15 @@ Shared scanner, schema extraction, and output toolkit for apcore framework adapt
 npm install apcore-toolkit
 ```
 
+## Features
+
+- Abstract `BaseScanner` for framework-specific endpoint scanning
+- OpenAPI schema extraction (`extractInputSchema`, `extractOutputSchema`)
+- Multi-format output writers (YAML, TypeScript, Registry) with pluggable verification
+- Markdown formatting with depth control and table heuristics
+- Module serialization utilities
+- `flattenParams` for Zod-based parameter flattening
+
 ## Usage
 
 ### ScannedModule
@@ -120,15 +129,34 @@ const dicts = modulesToDicts(modules); // batch conversion
 | `extractInputSchema()` | Extract input schema from OpenAPI operation |
 | `extractOutputSchema()` | Extract output schema from OpenAPI operation |
 | `resolveRef()` | Resolve `$ref` in OpenAPI documents |
-| `resolveSchema()` | Resolve schema with `$ref` support |
+| `resolveSchema()` | Resolve schema with single-level `$ref` support |
+| `deepResolveRefs()` | Recursively resolve all nested `$ref` pointers in a schema |
 | `enrichSchemaDescriptions()` | Merge parameter descriptions into schema |
 | `toMarkdown()` | Convert dict to formatted Markdown |
 | `moduleToDict()` | Serialize module to snake_case dict |
 | `modulesToDicts()` | Batch serialize modules |
 | `annotationsToDict()` | Convert annotations to plain dict |
 | `resolveTarget()` | Dynamic import + named export resolution |
+| `flattenParams()` | Flatten Zod schema params into keyword args |
+| `WriteResult` | Structured result type for writer operations |
+| `Verifier` | Interface for pluggable output verification |
+| `VerifyResult` | Result type for verification operations |
+| `WriteError` | Error class for I/O failures during write |
+| `YAMLVerifier` | Verifies YAML binding file structure |
+| `SyntaxVerifier` | Verifies file is non-empty and readable |
+| `RegistryVerifier` | Verifies module registered in registry |
+| `MagicBytesVerifier` | Verifies file header matches expected bytes |
+| `JSONVerifier` | Verifies valid JSON, optional schema check |
+| `createWriteResult()` | Factory for WriteResult with defaults |
+| `runVerifierChain()` | Run verifier chain, short-circuit on first failure |
+| `Enhancer` | Pluggable interface for metadata enhancement |
+| `AIEnhancer` | SLM-based metadata enhancement for scanned modules |
 | `VERSION` | Package version string |
 
+## Documentation
+
+See the [apcore-toolkit documentation](https://github.com/aipartnerup/apcore-toolkit) for full API reference and guides.
+
 ## License
 
 Apache-2.0

package/dist/ai-enhancer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AI-driven metadata enhancement using local SLMs.
+ *
+ * Uses an OpenAI-compatible local API (e.g., Ollama, vLLM, LM Studio) to fill
+ * metadata gaps that static analysis cannot resolve: missing descriptions,
+ * behavioral annotation inference, and schema inference for untyped functions.
+ *
+ * All AI-generated fields are tagged with `x-generated-by: slm` in the module's
+ * metadata dict for auditability.
+ */
+import type { ScannedModule } from './types.js';
+/**
+ * Protocol for pluggable metadata enhancement.
+ *
+ * Any class implementing this interface can be used to fill metadata gaps
+ * in scanned modules. See the AI Enhancement Guide for details.
+ */
+export interface Enhancer {
+    enhance(modules: ScannedModule[]): Promise<ScannedModule[]>;
+}
+export interface AIEnhancerOptions {
+    endpoint?: string;
+    model?: string;
+    threshold?: number;
+    batchSize?: number;
+    timeout?: number;
+}
+export declare class AIEnhancer {
+    readonly endpoint: string;
+    readonly model: string;
+    readonly threshold: number;
+    readonly batchSize: number;
+    readonly timeout: number;
+    constructor(options?: AIEnhancerOptions);
+    static isEnabled(): boolean;
+    enhance(modules: ScannedModule[]): Promise<ScannedModule[]>;
+    private _identifyGaps;
+    private _enhanceModule;
+    private _buildPrompt;
+    private _callLLM;
+    static _parseResponse(response: string): Record<string, unknown>;
+}
+//# sourceMappingURL=ai-enhancer.d.ts.map

package/dist/ai-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-enhancer.d.ts","sourceRoot":"","sources":["../src/ai-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyBhD;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,CAAC,EAAE,iBAAiB;IAkBvC,MAAM,CAAC,SAAS,IAAI,OAAO;IAKrB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA0BjE,OAAO,CAAC,aAAa;YAkBP,cAAc;IAkH5B,OAAO,CAAC,YAAY;YAkDN,QAAQ;IAuCtB,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAcjE"}

package/dist/ai-enhancer.js

@@ -0,0 +1,313 @@
+/**
+ * AI-driven metadata enhancement using local SLMs.
+ *
+ * Uses an OpenAI-compatible local API (e.g., Ollama, vLLM, LM Studio) to fill
+ * metadata gaps that static analysis cannot resolve: missing descriptions,
+ * behavioral annotation inference, and schema inference for untyped functions.
+ *
+ * All AI-generated fields are tagged with `x-generated-by: slm` in the module's
+ * metadata dict for auditability.
+ */
+import { DEFAULT_ANNOTATIONS } from 'apcore-js';
+import { cloneModule } from './types.js';
+const _DEFAULT_ENDPOINT = 'http://localhost:11434/v1';
+const _DEFAULT_MODEL = 'qwen:0.6b';
+const _DEFAULT_THRESHOLD = 0.7;
+const _DEFAULT_BATCH_SIZE = 5;
+const _DEFAULT_TIMEOUT = 30;
+function parseFloatEnv(name, fallback) {
+    const raw = process.env[name];
+    if (raw == null)
+        return fallback;
+    const val = Number(raw);
+    if (Number.isNaN(val))
+        throw new Error(`${name} must be a valid number, got "${raw}"`);
+    return val;
+}
+function parseIntEnv(name, fallback) {
+    const raw = process.env[name];
+    if (raw == null)
+        return fallback;
+    const val = parseInt(raw, 10);
+    if (Number.isNaN(val))
+        throw new Error(`${name} must be a valid integer, got "${raw}"`);
+    return val;
+}
+export class AIEnhancer {
+    endpoint;
+    model;
+    threshold;
+    batchSize;
+    timeout;
+    constructor(options) {
+        this.endpoint = options?.endpoint ?? process.env.APCORE_AI_ENDPOINT ?? _DEFAULT_ENDPOINT;
+        this.model = options?.model ?? process.env.APCORE_AI_MODEL ?? _DEFAULT_MODEL;
+        this.threshold = options?.threshold ?? parseFloatEnv('APCORE_AI_THRESHOLD', _DEFAULT_THRESHOLD);
+        this.batchSize = options?.batchSize ?? parseIntEnv('APCORE_AI_BATCH_SIZE', _DEFAULT_BATCH_SIZE);
+        this.timeout = options?.timeout ?? parseIntEnv('APCORE_AI_TIMEOUT', _DEFAULT_TIMEOUT);
+        if (this.threshold < 0 || this.threshold > 1) {
+            throw new Error('APCORE_AI_THRESHOLD must be a number between 0.0 and 1.0');
+        }
+        if (this.batchSize <= 0) {
+            throw new Error('APCORE_AI_BATCH_SIZE must be a positive integer');
+        }
+        if (this.timeout <= 0) {
+            throw new Error('APCORE_AI_TIMEOUT must be a positive integer');
+        }
+    }
+    static isEnabled() {
+        const val = (process.env.APCORE_AI_ENABLED ?? 'false').toLowerCase();
+        return val === 'true' || val === '1' || val === 'yes';
+    }
+    async enhance(modules) {
+        const results = [...modules];
+        const pending = [];
+        for (let i = 0; i < modules.length; i++) {
+            const gaps = this._identifyGaps(modules[i]);
+            if (gaps.length > 0) {
+                pending.push({ idx: i, module: modules[i], gaps });
+            }
+        }
+        for (let batchStart = 0; batchStart < pending.length; batchStart += this.batchSize) {
+            const batch = pending.slice(batchStart, batchStart + this.batchSize);
+            for (const { idx, module, gaps } of batch) {
+                try {
+                    const enhanced = await this._enhanceModule(module, gaps);
+                    results[idx] = enhanced;
+                }
+                catch {
+                    // AI enhancement failed — keep original
+                }
+            }
+        }
+        return results;
+    }
+    _identifyGaps(module) {
+        const gaps = [];
+        if (!module.description || module.description === module.moduleId) {
+            gaps.push('description');
+        }
+        if (!module.documentation) {
+            gaps.push('documentation');
+        }
+        if (module.annotations == null || JSON.stringify(module.annotations) === JSON.stringify(DEFAULT_ANNOTATIONS)) {
+            gaps.push('annotations');
+        }
+        const props = module.inputSchema.properties;
+        if (!props || (typeof props === 'object' && Object.keys(props).length === 0)) {
+            gaps.push('input_schema');
+        }
+        return gaps;
+    }
+    async _enhanceModule(module, gaps) {
+        const prompt = this._buildPrompt(module, gaps);
+        const response = await this._callLLM(prompt);
+        const parsed = AIEnhancer._parseResponse(response);
+        const updates = {};
+        const parsedConf = (parsed.confidence ?? {});
+        const confidence = {};
+        const warnings = [...module.warnings];
+        if (gaps.includes('description') && parsed.description) {
+            const conf = parsedConf.description ?? 0;
+            confidence.description = conf;
+            if (conf >= this.threshold) {
+                updates.description = parsed.description;
+            }
+            else {
+                warnings.push(`Low confidence (${conf.toFixed(2)}) for description — skipped. Review manually.`);
+            }
+        }
+        if (gaps.includes('documentation') && parsed.documentation) {
+            const conf = parsedConf.documentation ?? 0;
+            confidence.documentation = conf;
+            if (conf >= this.threshold) {
+                updates.documentation = parsed.documentation;
+            }
+            else {
+                warnings.push(`Low confidence (${conf.toFixed(2)}) for documentation — skipped. Review manually.`);
+            }
+        }
+        if (gaps.includes('annotations') && parsed.annotations && typeof parsed.annotations === 'object') {
+            const annData = parsed.annotations;
+            const accepted = {};
+            const boolFields = [
+                'readonly', 'destructive', 'idempotent', 'requires_approval',
+                'open_world', 'streaming', 'cacheable', 'paginated',
+            ];
+            for (const field of boolFields) {
+                if (typeof annData[field] === 'boolean') {
+                    const fieldConf = parsedConf[`annotations.${field}`] ?? parsedConf[field] ?? 0;
+                    confidence[`annotations.${field}`] = fieldConf;
+                    if (fieldConf >= this.threshold) {
+                        accepted[field] = annData[field];
+                    }
+                    else {
+                        warnings.push(`Low confidence (${fieldConf.toFixed(2)}) for annotations.${field} — skipped. Review manually.`);
+                    }
+                }
+            }
+            // Handle integer annotation fields
+            const intFields = ['cache_ttl'];
+            for (const field of intFields) {
+                if (typeof annData[field] === 'number') {
+                    const fieldConf = parsedConf[`annotations.${field}`] ?? parsedConf[field] ?? 0;
+                    confidence[`annotations.${field}`] = fieldConf;
+                    if (fieldConf >= this.threshold) {
+                        accepted[field] = annData[field];
+                    }
+                    else {
+                        warnings.push(`Low confidence (${fieldConf.toFixed(2)}) for annotations.${field} — skipped. Review manually.`);
+                    }
+                }
+            }
+            // Handle string annotation fields
+            const strFields = ['pagination_style'];
+            for (const field of strFields) {
+                if (typeof annData[field] === 'string') {
+                    const fieldConf = parsedConf[`annotations.${field}`] ?? parsedConf[field] ?? 0;
+                    confidence[`annotations.${field}`] = fieldConf;
+                    if (fieldConf >= this.threshold) {
+                        accepted[field] = annData[field];
+                    }
+                    else {
+                        warnings.push(`Low confidence (${fieldConf.toFixed(2)}) for annotations.${field} — skipped. Review manually.`);
+                    }
+                }
+            }
+            // Handle list annotation fields
+            if (Array.isArray(annData['cache_key_fields'])) {
+                const fieldConf = parsedConf['annotations.cache_key_fields'] ?? parsedConf['cache_key_fields'] ?? 0;
+                confidence['annotations.cache_key_fields'] = fieldConf;
+                if (fieldConf >= this.threshold) {
+                    accepted['cache_key_fields'] = annData['cache_key_fields'];
+                }
+                else {
+                    warnings.push(`Low confidence (${fieldConf.toFixed(2)}) for annotations.cache_key_fields — skipped. Review manually.`);
+                }
+            }
+            if (Object.keys(accepted).length > 0) {
+                const base = module.annotations ?? { ...DEFAULT_ANNOTATIONS };
+                updates.annotations = { ...base, ...accepted };
+            }
+        }
+        if (gaps.includes('input_schema') && parsed.input_schema) {
+            const conf = parsedConf.input_schema ?? 0;
+            confidence.input_schema = conf;
+            if (conf >= this.threshold) {
+                updates.inputSchema = parsed.input_schema;
+            }
+            else {
+                warnings.push(`Low confidence (${conf.toFixed(2)}) for input_schema — skipped. Review manually.`);
+            }
+        }
+        if (Object.keys(updates).length === 0) {
+            if (warnings.length !== module.warnings.length) {
+                return cloneModule(module, { warnings });
+            }
+            return module;
+        }
+        const metadata = { ...module.metadata };
+        metadata['x-generated-by'] = 'slm';
+        metadata['x-ai-confidence'] = confidence;
+        return cloneModule(module, { ...updates, metadata, warnings });
+    }
+    _buildPrompt(module, gaps) {
+        const parts = [
+            'You are analyzing a function to generate metadata for an AI-perceivable module system.',
+            '',
+            `Module ID: ${module.moduleId}`,
+            `Target: ${module.target}`,
+        ];
+        if (module.description) {
+            parts.push(`Current description: ${module.description}`);
+        }
+        parts.push('');
+        parts.push('Please provide the following missing metadata as JSON:');
+        parts.push('{');
+        if (gaps.includes('description')) {
+            parts.push('  "description": "<≤200 chars, what this function does>",');
+        }
+        if (gaps.includes('documentation')) {
+            parts.push('  "documentation": "<detailed Markdown explanation>",');
+        }
+        if (gaps.includes('annotations')) {
+            parts.push('  "annotations": {');
+            parts.push('    "readonly": <true if no side effects>,');
+            parts.push('    "destructive": <true if deletes/overwrites data>,');
+            parts.push('    "idempotent": <true if safe to retry>,');
+            parts.push('    "requires_approval": <true if dangerous operation>,');
+            parts.push('    "open_world": <true if calls external systems>,');
+            parts.push('    "streaming": <true if yields results incrementally>,');
+            parts.push('    "cacheable": <true if results can be cached>,');
+            parts.push('    "cache_ttl": <seconds, 0 for no expiry>,');
+            parts.push('    "cache_key_fields": <list of input field names for cache key, or null for all>,');
+            parts.push('    "paginated": <true if supports pagination>,');
+            parts.push('    "pagination_style": <"cursor" or "offset" or "page">');
+            parts.push('  },');
+        }
+        if (gaps.includes('input_schema')) {
+            parts.push('  "input_schema": <JSON Schema object for function parameters>,');
+        }
+        parts.push('  "confidence": {');
+        parts.push('    "description": 0.0, "documentation": 0.0');
+        parts.push('  }');
+        parts.push('}');
+        parts.push('');
+        parts.push('Respond with ONLY valid JSON, no markdown fences or explanation.');
+        return parts.join('\n');
+    }
+    async _callLLM(prompt) {
+        const url = `${this.endpoint.replace(/\/+$/, '')}/chat/completions`;
+        const payload = JSON.stringify({
+            model: this.model,
+            messages: [{ role: 'user', content: prompt }],
+            temperature: 0.1,
+        });
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout * 1000);
+        try {
+            const resp = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: payload,
+                signal: controller.signal,
+            });
+            if (!resp.ok) {
+                throw new Error(`SLM API returned ${resp.status}: ${resp.statusText}`);
+            }
+            const data = (await resp.json());
+            const choices = data.choices;
+            if (!choices?.[0]?.message?.content) {
+                throw new Error('Unexpected API response structure');
+            }
+            return choices[0].message.content;
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === 'AbortError') {
+                throw new Error(`SLM request timed out after ${this.timeout}s`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    static _parseResponse(response) {
+        let text = response.trim();
+        if (text.startsWith('```')) {
+            const lines = text.split('\n');
+            if (lines[0].startsWith('```'))
+                lines.shift();
+            if (lines.length > 0 && lines[lines.length - 1].trim() === '```')
+                lines.pop();
+            text = lines.join('\n');
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (err) {
+            throw new Error(`SLM returned invalid JSON: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=ai-enhancer.js.map

package/dist/ai-enhancer.js.map

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

package/dist/flatten-params.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Wraps a function, converting Zod schema parameters into flat keyword arguments.
+ *
+ * This is the TypeScript equivalent of Python's `flatten_pydantic_params()`.
+ * It takes a function whose first parameter is a Zod-validated object and returns
+ * a new function that accepts the object's fields as individual keyword arguments.
+ *
+ * @param func - The original function accepting a single object parameter
+ * @param zodSchema - A Zod schema describing the object's shape
+ * @returns A new function that accepts flattened parameters
+ */
+export declare function flattenParams<T extends Record<string, unknown>>(func: (input: T) => unknown, zodSchema: {
+    parse(data: unknown): T;
+    shape?: Record<string, unknown>;
+}): (args: Record<string, unknown>) => unknown;
+//# sourceMappingURL=flatten-params.d.ts.map

package/dist/flatten-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-params.d.ts","sourceRoot":"","sources":["../src/flatten-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAC3B,SAAS,EAAE;IAAE,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAK5C"}

package/dist/flatten-params.js

@@ -0,0 +1,18 @@
+/**
+ * Wraps a function, converting Zod schema parameters into flat keyword arguments.
+ *
+ * This is the TypeScript equivalent of Python's `flatten_pydantic_params()`.
+ * It takes a function whose first parameter is a Zod-validated object and returns
+ * a new function that accepts the object's fields as individual keyword arguments.
+ *
+ * @param func - The original function accepting a single object parameter
+ * @param zodSchema - A Zod schema describing the object's shape
+ * @returns A new function that accepts flattened parameters
+ */
+export function flattenParams(func, zodSchema) {
+    return (args) => {
+        const parsed = zodSchema.parse(args);
+        return func(parsed);
+    };
+}
+//# sourceMappingURL=flatten-params.js.map

package/dist/flatten-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-params.js","sourceRoot":"","sources":["../src/flatten-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA2B,EAC3B,SAAuE;IAEvE,OAAO,CAAC,IAA6B,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -2,13 +2,20 @@ export type { ScannedModule } from './types.js';
 export { createScannedModule, cloneModule } from './types.js';
 export { BaseScanner } from './scanner.js';
 export { enrichSchemaDescriptions } from './schema-utils.js';
-export { resolveRef, resolveSchema, extractInputSchema, extractOutputSchema, } from './openapi.js';
+export { resolveRef, resolveSchema, deepResolveRefs, extractInputSchema, extractOutputSchema, } from './openapi.js';
 export { annotationsToDict, moduleToDict, modulesToDicts, } from './serializers.js';
 export { resolveTarget } from './resolve-target.js';
 export { toMarkdown } from './formatting/index.js';
+export { flattenParams } from './flatten-params.js';
+export { AIEnhancer } from './ai-enhancer.js';
+export type { AIEnhancerOptions, Enhancer } from './ai-enhancer.js';
 export { YAMLWriter } from './output/yaml-writer.js';
 export { TypeScriptWriter } from './output/typescript-writer.js';
 export { RegistryWriter } from './output/registry-writer.js';
 export { getWriter } from './output/factory.js';
+export type { WriteResult, VerifyResult, Verifier } from './output/types.js';
+export { createWriteResult } from './output/types.js';
+export { WriteError } from './output/errors.js';
+export { YAMLVerifier, SyntaxVerifier, RegistryVerifier, MagicBytesVerifier, JSONVerifier, runVerifierChain, } from './output/verifiers.js';
 export declare const VERSION: string;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKhD,eAAO,MAAM,OAAO,EAAE,MAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,OAAO,EAAE,MAAqB,CAAC"}

package/dist/index.js

@@ -1,14 +1,19 @@
 export { createScannedModule, cloneModule } from './types.js';
 export { BaseScanner } from './scanner.js';
 export { enrichSchemaDescriptions } from './schema-utils.js';
-export { resolveRef, resolveSchema, extractInputSchema, extractOutputSchema, } from './openapi.js';
+export { resolveRef, resolveSchema, deepResolveRefs, extractInputSchema, extractOutputSchema, } from './openapi.js';
 export { annotationsToDict, moduleToDict, modulesToDicts, } from './serializers.js';
 export { resolveTarget } from './resolve-target.js';
 export { toMarkdown } from './formatting/index.js';
+export { flattenParams } from './flatten-params.js';
+export { AIEnhancer } from './ai-enhancer.js';
 export { YAMLWriter } from './output/yaml-writer.js';
 export { TypeScriptWriter } from './output/typescript-writer.js';
 export { RegistryWriter } from './output/registry-writer.js';
 export { getWriter } from './output/factory.js';
+export { createWriteResult } from './output/types.js';
+export { WriteError } from './output/errors.js';
+export { YAMLVerifier, SyntaxVerifier, RegistryVerifier, MagicBytesVerifier, JSONVerifier, runVerifierChain, } from './output/verifiers.js';
 import { createRequire } from 'node:module';
 const _require = createRequire(import.meta.url);
 const _pkg = _require('../package.json');

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAwB,CAAC;AAChE,MAAM,CAAC,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAwB,CAAC;AAChE,MAAM,CAAC,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC"}

package/dist/openapi.d.ts

@@ -1,5 +1,12 @@
 export declare function resolveRef(refString: string, openapiDoc: Record<string, unknown>): Record<string, unknown>;
 export declare function resolveSchema(schema: Record<string, unknown>, openapiDoc: Record<string, unknown> | null): Record<string, unknown>;
+/**
+ * Recursively resolve all `$ref` pointers in a schema.
+ *
+ * Handles nested `$ref`, `allOf`, `anyOf`, `oneOf`, and `items`.
+ * Depth-limited to 16 levels to prevent infinite recursion.
+ */
+export declare function deepResolveRefs(schema: Record<string, unknown>, openapiDoc: Record<string, unknown>, depth?: number): Record<string, unknown>;
 export declare function extractInputSchema(operation: Record<string, unknown>, openapiDoc?: Record<string, unknown> | null): Record<string, unknown>;
 export declare function extractOutputSchema(operation: Record<string, unknown>, openapiDoc?: Record<string, unknown> | null): Record<string, unknown>;
 //# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB"}
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,SAAI,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiDzB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4CzB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB"}