@pella-labs/pinakes 0.1.0

package/dist/sandbox/pool.js

@@ -0,0 +1,98 @@
+export class SandboxPool {
+    wasmModule;
+    available = [];
+    maxSize;
+    memoryLimitBytes;
+    stats = {
+        warmHits: 0,
+        coldHits: 0,
+        crashes: 0,
+        currentSize: 0,
+    };
+    nextId = 0;
+    disposed = false;
+    constructor(wasmModule, opts) {
+        this.wasmModule = wasmModule;
+        this.maxSize = opts?.poolSize ?? 2;
+        this.memoryLimitBytes = opts?.memoryLimitBytes ?? 64 * 1024 * 1024;
+        // Pre-create warm runtimes.
+        for (let i = 0; i < this.maxSize; i++) {
+            this.available.push(this.spawnRuntime(true));
+        }
+        this.stats.currentSize = this.maxSize;
+    }
+    /**
+     * Acquire a runtime from the pool. If the pool has warm runtimes available,
+     * returns one immediately. Otherwise spawns a cold overflow runtime.
+     * Never blocks.
+     */
+    acquire() {
+        if (this.disposed)
+            throw new Error('SandboxPool is disposed');
+        const warm = this.available.pop();
+        if (warm) {
+            this.stats.warmHits++;
+            return warm;
+        }
+        // Overflow — spawn cold runtime, don't grow the pool.
+        this.stats.coldHits++;
+        return this.spawnRuntime(false);
+    }
+    /**
+     * Release a runtime back to the pool. If `crashed` is true, the runtime
+     * is disposed and replaced with a fresh one. Overflow runtimes (not from
+     * the warm pool) are always disposed on release.
+     */
+    release(pr, crashed) {
+        if (this.disposed) {
+            // Pool is shutting down — just dispose.
+            try {
+                pr.runtime.dispose();
+            }
+            catch { /* best effort */ }
+            return;
+        }
+        if (crashed) {
+            this.stats.crashes++;
+            try {
+                pr.runtime.dispose();
+            }
+            catch { /* already dead */ }
+            // Replace with a fresh runtime if this was a warm slot.
+            if (pr.isWarm && this.available.length < this.maxSize) {
+                this.available.push(this.spawnRuntime(true));
+            }
+            return;
+        }
+        // Return warm runtimes to pool; dispose overflow runtimes.
+        if (pr.isWarm && this.available.length < this.maxSize) {
+            this.available.push(pr);
+        }
+        else {
+            try {
+                pr.runtime.dispose();
+            }
+            catch { /* best effort */ }
+        }
+    }
+    getStats() {
+        return { ...this.stats, currentSize: this.available.length };
+    }
+    dispose() {
+        this.disposed = true;
+        for (const pr of this.available) {
+            try {
+                pr.runtime.dispose();
+            }
+            catch { /* best effort */ }
+        }
+        this.available.length = 0;
+    }
+    // --------------------------------------------------------------------------
+    spawnRuntime(isWarm) {
+        const runtime = this.wasmModule.newRuntime();
+        runtime.setMemoryLimit(this.memoryLimitBytes);
+        return { runtime, id: this.nextId++, isWarm };
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/sandbox/pool.js.map

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

package/dist/sandbox/vendored-codemode.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Vendored utilities from @cloudflare/codemode v0.3.4
+ *
+ * Source: https://github.com/cloudflare/agents/tree/main/packages/codemode
+ * License: MIT (Cloudflare, Inc.)
+ *
+ * Why vendored, not imported:
+ *   The main entry of @cloudflare/codemode imports `RpcTarget` from
+ *   `cloudflare:workers`, which is a Workers-runtime-only module. The package
+ *   is therefore unusable from a plain Node.js process (like our MCP stdio
+ *   server). The four utility functions in this file are pure JS with no
+ *   Workers dependency, so we copy them here instead of deep-importing from
+ *   the package's internal chunk files (whose hashed names are not part of
+ *   any public API and can change on any upstream rebuild).
+ *
+ *   See `dev-docs/prior-art.md` §5 and `dev-docs/presearch.md` D30 for the
+ *   full audit and decision.
+ *
+ * Exports:
+ *   - normalizeCode(code)                 — strip markdown fences + AST-wrap
+ *                                            LLM code into an async IIFE
+ *   - sanitizeToolName(name)              — tool name → valid JS identifier
+ *   - jsonSchemaToType(schema, typeName)  — JSON Schema → TS type alias
+ *   - generateTypesFromJsonSchema(tools)  — tool set → TS `declare const`
+ *                                            block for LLM prompts
+ *
+ * Modifications from upstream:
+ *   - Added explicit TypeScript types (upstream ships types via a separate
+ *     `.d.ts` chunk).
+ *   - Combined into a single file instead of upstream's two-chunk layout.
+ *   - Reformatted to match our Prettier config (single quotes, semicolons).
+ *   - No behavioral changes.
+ *
+ * Upstream copyright:
+ *   MIT License
+ *   Copyright (c) Cloudflare, Inc.
+ *   https://github.com/cloudflare/agents/blob/main/LICENSE
+ */
+import type { JSONSchema7 } from 'json-schema';
+/**
+ * Normalize LLM-generated code into an async IIFE suitable for sandbox
+ * execution. Strips markdown fences, parses with acorn, and wraps the
+ * code so the final expression is returned from an `async () => { ... }`.
+ *
+ * Graceful fallback: if acorn fails to parse, wraps the raw source as-is.
+ */
+export declare function normalizeCode(code: string): string;
+/**
+ * Sanitize a tool name into a valid JavaScript identifier.
+ * Replaces hyphens, dots, and spaces with `_`, strips other invalid chars,
+ * prefixes digit-leading names with `_`, and appends `_` to JS reserved words.
+ */
+export declare function sanitizeToolName(name: string): string;
+/**
+ * Convert a JSON Schema to a TypeScript type declaration.
+ */
+export declare function jsonSchemaToType(schema: JSONSchema7, typeName: string): string;
+/**
+ * A tool descriptor using plain JSON Schema (no Zod or AI SDK dependency).
+ */
+export interface JsonSchemaToolDescriptor {
+    description?: string;
+    inputSchema: JSONSchema7;
+    outputSchema?: JSONSchema7;
+}
+export type JsonSchemaToolDescriptors = Record<string, JsonSchemaToolDescriptor>;
+/**
+ * Generate TypeScript type definitions from tool descriptors with JSON Schema.
+ * These types can be included in tool descriptions to help LLMs write correct
+ * code against our `kg.*` bindings.
+ *
+ * This function has NO dependency on the AI SDK or Zod — it works purely with
+ * JSON Schema objects.
+ */
+export declare function generateTypesFromJsonSchema(tools: JsonSchemaToolDescriptors): string;
+export interface ExecuteResult {
+    result: unknown;
+    error?: string;
+    logs?: string[];
+}
+export interface ResolvedProvider {
+    name: string;
+    fns: Record<string, (...args: unknown[]) => Promise<unknown>>;
+    positionalArgs?: boolean;
+}
+/**
+ * An executor runs LLM-generated code in a sandbox, making the provided
+ * tool functions callable under their namespace inside the sandbox.
+ *
+ * Implementations should never throw — errors are returned in
+ * `ExecuteResult.error`.
+ *
+ * Our Phase 1+ implementation will be a QuickJS-backed class in
+ * `src/sandbox/executor.ts`.
+ */
+export interface Executor {
+    execute(code: string, providersOrFns: ResolvedProvider[] | Record<string, (...args: unknown[]) => Promise<unknown>>): Promise<ExecuteResult>;
+}
+//# sourceMappingURL=vendored-codemode.d.ts.map

package/dist/sandbox/vendored-codemode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendored-codemode.d.ts","sourceRoot":"","sources":["../../src/sandbox/vendored-codemode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AAiBtE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoDlD;AAkBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD;AAoRD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO9E;AAqBD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;AAEjF;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CA+CpF;AAOD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,cAAc,EACV,gBAAgB,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAC3D,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B"}

package/dist/sandbox/vendored-codemode.js

@@ -0,0 +1,471 @@
+/**
+ * Vendored utilities from @cloudflare/codemode v0.3.4
+ *
+ * Source: https://github.com/cloudflare/agents/tree/main/packages/codemode
+ * License: MIT (Cloudflare, Inc.)
+ *
+ * Why vendored, not imported:
+ *   The main entry of @cloudflare/codemode imports `RpcTarget` from
+ *   `cloudflare:workers`, which is a Workers-runtime-only module. The package
+ *   is therefore unusable from a plain Node.js process (like our MCP stdio
+ *   server). The four utility functions in this file are pure JS with no
+ *   Workers dependency, so we copy them here instead of deep-importing from
+ *   the package's internal chunk files (whose hashed names are not part of
+ *   any public API and can change on any upstream rebuild).
+ *
+ *   See `dev-docs/prior-art.md` §5 and `dev-docs/presearch.md` D30 for the
+ *   full audit and decision.
+ *
+ * Exports:
+ *   - normalizeCode(code)                 — strip markdown fences + AST-wrap
+ *                                            LLM code into an async IIFE
+ *   - sanitizeToolName(name)              — tool name → valid JS identifier
+ *   - jsonSchemaToType(schema, typeName)  — JSON Schema → TS type alias
+ *   - generateTypesFromJsonSchema(tools)  — tool set → TS `declare const`
+ *                                            block for LLM prompts
+ *
+ * Modifications from upstream:
+ *   - Added explicit TypeScript types (upstream ships types via a separate
+ *     `.d.ts` chunk).
+ *   - Combined into a single file instead of upstream's two-chunk layout.
+ *   - Reformatted to match our Prettier config (single quotes, semicolons).
+ *   - No behavioral changes.
+ *
+ * Upstream copyright:
+ *   MIT License
+ *   Copyright (c) Cloudflare, Inc.
+ *   https://github.com/cloudflare/agents/blob/main/LICENSE
+ */
+import * as acorn from 'acorn';
+// ============================================================================
+// normalize.ts — strip markdown fences + AST-wrap LLM code
+// ============================================================================
+/**
+ * Strip markdown code fences that LLMs commonly wrap code in.
+ * Handles ```js, ```javascript, ```typescript, ```ts, or bare ```.
+ */
+function stripCodeFences(code) {
+    const match = code.match(/^```(?:js|javascript|typescript|ts|tsx|jsx)?\s*\n([\s\S]*?)```\s*$/);
+    return match ? match[1] : code;
+}
+/**
+ * Normalize LLM-generated code into an async IIFE suitable for sandbox
+ * execution. Strips markdown fences, parses with acorn, and wraps the
+ * code so the final expression is returned from an `async () => { ... }`.
+ *
+ * Graceful fallback: if acorn fails to parse, wraps the raw source as-is.
+ */
+export function normalizeCode(code) {
+    const trimmed = stripCodeFences(code.trim());
+    if (!trimmed.trim())
+        return 'async () => {}';
+    const source = trimmed.trim();
+    try {
+        const ast = acorn.parse(source, {
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+        });
+        if (ast.body.length === 1 && ast.body[0].type === 'ExpressionStatement') {
+            if (ast.body[0].expression.type === 'ArrowFunctionExpression')
+                return source;
+        }
+        if (ast.body.length === 1 && ast.body[0].type === 'ExportDefaultDeclaration') {
+            const decl = ast.body[0].declaration;
+            const inner = source.slice(decl.start, decl.end);
+            if (decl.type === 'FunctionDeclaration' && !decl.id) {
+                return `async () => {\nreturn (${inner})();\n}`;
+            }
+            if (decl.type === 'ClassDeclaration' && !decl.id) {
+                return `async () => {\nreturn (${inner});\n}`;
+            }
+            return normalizeCode(inner);
+        }
+        if (ast.body.length === 1 && ast.body[0].type === 'FunctionDeclaration') {
+            return `async () => {\n${source}\nreturn ${ast.body[0].id?.name ?? 'fn'}();\n}`;
+        }
+        const last = ast.body[ast.body.length - 1];
+        if (last?.type === 'ExpressionStatement') {
+            const exprStmt = last;
+            return `async () => {\n${source.slice(0, last.start)}return (${source.slice(exprStmt.expression.start, exprStmt.expression.end)})\n}`;
+        }
+        return `async () => {\n${source}\n}`;
+    }
+    catch {
+        return `async () => {\n${source}\n}`;
+    }
+}
+// ============================================================================
+// utils.ts — identifier sanitization + string escaping helpers
+// ============================================================================
+const JS_RESERVED = new Set([
+    'abstract', 'arguments', 'await', 'boolean', 'break', 'byte', 'case',
+    'catch', 'char', 'class', 'const', 'continue', 'debugger', 'default',
+    'delete', 'do', 'double', 'else', 'enum', 'eval', 'export', 'extends',
+    'false', 'final', 'finally', 'float', 'for', 'function', 'goto', 'if',
+    'implements', 'import', 'in', 'instanceof', 'int', 'interface', 'let',
+    'long', 'native', 'new', 'null', 'package', 'private', 'protected',
+    'public', 'return', 'short', 'static', 'super', 'switch', 'synchronized',
+    'this', 'throw', 'throws', 'transient', 'true', 'try', 'typeof',
+    'undefined', 'var', 'void', 'volatile', 'while', 'with', 'yield',
+]);
+/**
+ * Sanitize a tool name into a valid JavaScript identifier.
+ * Replaces hyphens, dots, and spaces with `_`, strips other invalid chars,
+ * prefixes digit-leading names with `_`, and appends `_` to JS reserved words.
+ */
+export function sanitizeToolName(name) {
+    if (!name)
+        return '_';
+    let sanitized = name.replace(/[-.\s]/g, '_');
+    sanitized = sanitized.replace(/[^a-zA-Z0-9_$]/g, '');
+    if (!sanitized)
+        return '_';
+    if (/^[0-9]/.test(sanitized))
+        sanitized = '_' + sanitized;
+    if (JS_RESERVED.has(sanitized))
+        sanitized = sanitized + '_';
+    return sanitized;
+}
+function toPascalCase(str) {
+    return str
+        .replace(/_([a-z])/g, (_, letter) => letter.toUpperCase())
+        .replace(/^[a-z]/, (letter) => letter.toUpperCase());
+}
+/**
+ * Escape a character as a unicode escape sequence if it is a control character.
+ */
+function escapeControlChar(ch) {
+    const code = ch.charCodeAt(0);
+    if (code <= 31 || code === 127)
+        return '\\u' + code.toString(16).padStart(4, '0');
+    return ch;
+}
+/**
+ * Quote a property name if needed.
+ * Escapes backslashes, quotes, and control characters.
+ */
+function quoteProp(name) {
+    if (!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)) {
+        let escaped = '';
+        for (const ch of name) {
+            if (ch === '\\')
+                escaped += '\\\\';
+            else if (ch === '"')
+                escaped += '\\"';
+            else if (ch === '\n')
+                escaped += '\\n';
+            else if (ch === '\r')
+                escaped += '\\r';
+            else if (ch === '\t')
+                escaped += '\\t';
+            else if (ch === '\u2028')
+                escaped += '\\u2028';
+            else if (ch === '\u2029')
+                escaped += '\\u2029';
+            else
+                escaped += escapeControlChar(ch);
+        }
+        return `"${escaped}"`;
+    }
+    return name;
+}
+/**
+ * Escape a string for use inside a double-quoted TypeScript string literal.
+ */
+function escapeStringLiteral(s) {
+    let out = '';
+    for (const ch of s) {
+        if (ch === '\\')
+            out += '\\\\';
+        else if (ch === '"')
+            out += '\\"';
+        else if (ch === '\n')
+            out += '\\n';
+        else if (ch === '\r')
+            out += '\\r';
+        else if (ch === '\t')
+            out += '\\t';
+        else if (ch === '\u2028')
+            out += '\\u2028';
+        else if (ch === '\u2029')
+            out += '\\u2029';
+        else
+            out += escapeControlChar(ch);
+    }
+    return out;
+}
+/**
+ * Escape a string for use inside a JSDoc comment.
+ * Prevents premature comment closure from star-slash sequences.
+ */
+function escapeJsDoc(text) {
+    return text.replace(/\*\//g, '*\\/');
+}
+/**
+ * Resolve an internal JSON Pointer $ref (e.g. #/definitions/Foo) against the
+ * root schema. Returns null for external URLs or unresolvable paths.
+ */
+function resolveRef(ref, root) {
+    if (ref === '#')
+        return root;
+    if (!ref.startsWith('#/'))
+        return null;
+    const segments = ref
+        .slice(2)
+        .split('/')
+        .map((s) => s.replace(/~1/g, '/').replace(/~0/g, '~'));
+    let current = root;
+    for (const seg of segments) {
+        if (current === null || typeof current !== 'object')
+            return null;
+        current = current[seg];
+        if (current === undefined)
+            return null;
+    }
+    if (typeof current === 'boolean')
+        return current;
+    if (current === null || typeof current !== 'object')
+        return null;
+    return current;
+}
+/**
+ * Apply OpenAPI 3.0 `nullable: true` to a type result.
+ */
+function applyNullable(result, schema) {
+    if (result !== 'unknown' && result !== 'never' && schema?.nullable === true) {
+        return `${result} | null`;
+    }
+    return result;
+}
+/**
+ * Convert a JSON Schema to a TypeScript type string.
+ * This is a direct conversion without going through Zod.
+ */
+function jsonSchemaToTypeString(schema, indent, ctx) {
+    if (typeof schema === 'boolean')
+        return schema ? 'unknown' : 'never';
+    if (ctx.depth >= ctx.maxDepth)
+        return 'unknown';
+    if (ctx.seen.has(schema))
+        return 'unknown';
+    ctx.seen.add(schema);
+    const nextCtx = { ...ctx, depth: ctx.depth + 1 };
+    try {
+        const s = schema;
+        if (s.$ref) {
+            const resolved = resolveRef(s.$ref, ctx.root);
+            if (!resolved)
+                return 'unknown';
+            return applyNullable(jsonSchemaToTypeString(resolved, indent, nextCtx), s);
+        }
+        if (s.anyOf) {
+            return applyNullable(s.anyOf.map((sub) => jsonSchemaToTypeString(sub, indent, nextCtx)).join(' | '), s);
+        }
+        if (s.oneOf) {
+            return applyNullable(s.oneOf.map((sub) => jsonSchemaToTypeString(sub, indent, nextCtx)).join(' | '), s);
+        }
+        if (s.allOf) {
+            return applyNullable(s.allOf.map((sub) => jsonSchemaToTypeString(sub, indent, nextCtx)).join(' & '), s);
+        }
+        if (s.enum) {
+            if (s.enum.length === 0)
+                return 'never';
+            return applyNullable(s.enum
+                .map((v) => {
+                if (v === null)
+                    return 'null';
+                if (typeof v === 'string')
+                    return '"' + escapeStringLiteral(v) + '"';
+                if (typeof v === 'object')
+                    return JSON.stringify(v) ?? 'unknown';
+                return String(v);
+            })
+                .join(' | '), s);
+        }
+        if (s.const !== undefined) {
+            return applyNullable(s.const === null
+                ? 'null'
+                : typeof s.const === 'string'
+                    ? '"' + escapeStringLiteral(s.const) + '"'
+                    : typeof s.const === 'object'
+                        ? (JSON.stringify(s.const) ?? 'unknown')
+                        : String(s.const), s);
+        }
+        const type = s.type;
+        if (type === 'string')
+            return applyNullable('string', s);
+        if (type === 'number' || type === 'integer')
+            return applyNullable('number', s);
+        if (type === 'boolean')
+            return applyNullable('boolean', s);
+        if (type === 'null')
+            return 'null';
+        if (type === 'array') {
+            const prefixItems = s.prefixItems;
+            if (Array.isArray(prefixItems)) {
+                return applyNullable(`[${prefixItems.map((sub) => jsonSchemaToTypeString(sub, indent, nextCtx)).join(', ')}]`, s);
+            }
+            if (Array.isArray(s.items)) {
+                return applyNullable(`[${s.items.map((sub) => jsonSchemaToTypeString(sub, indent, nextCtx)).join(', ')}]`, s);
+            }
+            if (s.items) {
+                return applyNullable(`${jsonSchemaToTypeString(s.items, indent, nextCtx)}[]`, s);
+            }
+            return applyNullable('unknown[]', s);
+        }
+        if (type === 'object' || s.properties) {
+            const props = s.properties || {};
+            const required = new Set(s.required || []);
+            const lines = [];
+            for (const [propName, propSchema] of Object.entries(props)) {
+                if (typeof propSchema === 'boolean') {
+                    const boolType = propSchema ? 'unknown' : 'never';
+                    const optionalMark = required.has(propName) ? '' : '?';
+                    lines.push(`${indent}    ${quoteProp(propName)}${optionalMark}: ${boolType};`);
+                    continue;
+                }
+                const isRequired = required.has(propName);
+                const propType = jsonSchemaToTypeString(propSchema, indent + '    ', nextCtx);
+                const desc = propSchema.description;
+                const format = propSchema.format;
+                if (desc || format) {
+                    const descText = desc ? escapeJsDoc(desc.replace(/\r?\n/g, ' ')) : undefined;
+                    const formatTag = format ? `@format ${escapeJsDoc(format)}` : undefined;
+                    if (descText && formatTag) {
+                        lines.push(`${indent}    /**`);
+                        lines.push(`${indent}     * ${descText}`);
+                        lines.push(`${indent}     * ${formatTag}`);
+                        lines.push(`${indent}     */`);
+                    }
+                    else {
+                        lines.push(`${indent}    /** ${descText ?? formatTag} */`);
+                    }
+                }
+                const quotedName = quoteProp(propName);
+                const optionalMark = isRequired ? '' : '?';
+                lines.push(`${indent}    ${quotedName}${optionalMark}: ${propType};`);
+            }
+            if (s.additionalProperties) {
+                const valueType = s.additionalProperties === true
+                    ? 'unknown'
+                    : jsonSchemaToTypeString(s.additionalProperties, indent + '    ', nextCtx);
+                lines.push(`${indent}    [key: string]: ${valueType};`);
+            }
+            if (lines.length === 0) {
+                if (s.additionalProperties === false)
+                    return applyNullable('{}', s);
+                return applyNullable('Record<string, unknown>', s);
+            }
+            return applyNullable(`{\n${lines.join('\n')}\n${indent}}`, s);
+        }
+        if (Array.isArray(type)) {
+            return applyNullable(type
+                .map((t) => {
+                if (t === 'string')
+                    return 'string';
+                if (t === 'number' || t === 'integer')
+                    return 'number';
+                if (t === 'boolean')
+                    return 'boolean';
+                if (t === 'null')
+                    return 'null';
+                if (t === 'array')
+                    return 'unknown[]';
+                if (t === 'object')
+                    return 'Record<string, unknown>';
+                return 'unknown';
+            })
+                .join(' | '), s);
+        }
+        return 'unknown';
+    }
+    finally {
+        ctx.seen.delete(schema);
+    }
+}
+/**
+ * Convert a JSON Schema to a TypeScript type declaration.
+ */
+export function jsonSchemaToType(schema, typeName) {
+    return `type ${typeName} = ${jsonSchemaToTypeString(schema, '', {
+        root: schema,
+        depth: 0,
+        seen: new Set(),
+        maxDepth: 20,
+    })}`;
+}
+/**
+ * Extract field descriptions from a JSON Schema's properties.
+ */
+function extractJsonSchemaDescriptions(schema) {
+    const descriptions = {};
+    if (schema.properties) {
+        for (const [fieldName, propSchema] of Object.entries(schema.properties)) {
+            if (propSchema &&
+                typeof propSchema === 'object' &&
+                propSchema.description) {
+                descriptions[fieldName] = propSchema.description;
+            }
+        }
+    }
+    return descriptions;
+}
+/**
+ * Generate TypeScript type definitions from tool descriptors with JSON Schema.
+ * These types can be included in tool descriptions to help LLMs write correct
+ * code against our `kg.*` bindings.
+ *
+ * This function has NO dependency on the AI SDK or Zod — it works purely with
+ * JSON Schema objects.
+ */
+export function generateTypesFromJsonSchema(tools) {
+    let availableTools = '';
+    let availableTypes = '';
+    for (const [toolName, tool] of Object.entries(tools)) {
+        const safeName = sanitizeToolName(toolName);
+        const typeName = toPascalCase(safeName);
+        try {
+            const inputType = jsonSchemaToType(tool.inputSchema, `${typeName}Input`);
+            const outputType = tool.outputSchema
+                ? jsonSchemaToType(tool.outputSchema, `${typeName}Output`)
+                : `type ${typeName}Output = unknown`;
+            availableTypes += `\n${inputType.trim()}`;
+            availableTypes += `\n${outputType.trim()}`;
+            const paramLines = (() => {
+                try {
+                    const paramDescs = extractJsonSchemaDescriptions(tool.inputSchema);
+                    return Object.entries(paramDescs).map(([fieldName, desc]) => `@param input.${fieldName} - ${desc}`);
+                }
+                catch {
+                    return [];
+                }
+            })();
+            const jsdocLines = [];
+            if (tool.description?.trim()) {
+                jsdocLines.push(escapeJsDoc(tool.description.trim().replace(/\r?\n/g, ' ')));
+            }
+            else {
+                jsdocLines.push(escapeJsDoc(toolName));
+            }
+            for (const pd of paramLines)
+                jsdocLines.push(escapeJsDoc(pd.replace(/\r?\n/g, ' ')));
+            const jsdocBody = jsdocLines.map((l) => `\t * ${l}`).join('\n');
+            availableTools += `\n\t/**\n${jsdocBody}\n\t */`;
+            availableTools += `\n\t${safeName}: (input: ${typeName}Input) => Promise<${typeName}Output>;`;
+            availableTools += '\n';
+        }
+        catch {
+            availableTypes += `\ntype ${typeName}Input = unknown`;
+            availableTypes += `\ntype ${typeName}Output = unknown`;
+            availableTools += `\n\t/**\n\t * ${escapeJsDoc(toolName)}\n\t */`;
+            availableTools += `\n\t${safeName}: (input: ${typeName}Input) => Promise<${typeName}Output>;`;
+            availableTools += '\n';
+        }
+    }
+    availableTools = `\ndeclare const codemode: {${availableTools}}`;
+    return `
+${availableTypes}
+${availableTools}
+  `.trim();
+}
+//# sourceMappingURL=vendored-codemode.js.map