@zmdb/ai 1.0.0-beta.1

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAmC,MAAM,gBAAgB,CAAC;AAE1E,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAA0B,EAAE,IAAkB;IACzF,OAAO,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAQD,MAAM,UAAU,YAAY,CAAc,IAAY,EAAE,MAA0B;IAChF,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,IAAI;SAClB,IAAI,EAAE;SACN,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,IAAI,EAAE,CAAC;IACV,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC;IAC3F,CAAC;IACD,6EAA6E;IAC7E,sEAAsE;IACtE,8EAA8E;IAC9E,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAW,EAAE,CAAC;IACzD,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,85 @@
+import { type CoreSchema } from '@zmdb/schema';
+import { type JsonSchemaObject, type ShapeIR } from '@zmdb/schema/ir';
+import { ToolSpecRefusalError, type ToolProvider, type ToolSpecRefusal } from './http/types.js';
+export type { ToolProvider, ToolSpecRefusal };
+export { ToolSpecRefusalError };
+export interface ToolOptions {
+    readonly description?: string;
+}
+export type ToolSchema = CoreSchema<string>;
+export interface ToolSpec {
+    readonly name: string;
+    readonly description?: string;
+    readonly parameters: JsonSchemaObject;
+}
+export interface StrictJsonSchemaObject extends JsonSchemaObject {
+    readonly additionalProperties: false;
+}
+export interface GeminiSchemaObject extends JsonSchemaObject {
+}
+export interface ToolSpecFor {
+    readonly openai: {
+        readonly type: 'function';
+        readonly function: {
+            readonly name: string;
+            readonly description?: string;
+            readonly parameters: JsonSchemaObject;
+        };
+    };
+    readonly 'openai-strict': {
+        readonly type: 'function';
+        readonly function: {
+            readonly name: string;
+            readonly description?: string;
+            readonly strict: true;
+            readonly parameters: StrictJsonSchemaObject;
+        };
+    };
+    readonly anthropic: {
+        readonly name: string;
+        readonly description?: string;
+        readonly input_schema: JsonSchemaObject;
+    };
+    readonly gemini: {
+        readonly name: string;
+        readonly description?: string;
+        readonly parameters: GeminiSchemaObject;
+    };
+    readonly 'json-schema': ToolSpec;
+}
+export interface ToolDialect {
+    readonly allowedKeywords: ReadonlySet<string>;
+    readonly maxProperties?: number;
+    readonly source: string;
+    readonly verifiedOn: '2026-09-04';
+}
+/**
+ * Provider constraints are data rather than branches scattered through the emitter.
+ *
+ * The cap is deliberately below every provider's moving request-size ceiling. It is a
+ * build-time guard against producing a tool definition large enough to be rejected after
+ * deployment, not a promise that a provider will accept every document below it.
+ */
+export declare const TOOL_DIALECTS: Readonly<Record<ToolProvider, ToolDialect>>;
+type AnyToolSpec = ToolSpecFor[ToolProvider];
+/**
+ * The provider's parameter document, directly from the declaration IR.
+ *
+ * This is exported for the AOT emitter. Applications should call {@link toolFor}; exposing
+ * the pure step keeps runtime and build-time output byte-identical without a second walker.
+ */
+export declare function toolSchemaForProvider(provider: ToolProvider, shape: ShapeIR): JsonSchemaObject;
+export declare function frameTool(provider: ToolProvider, name: string, parameters: JsonSchemaObject, options?: ToolOptions): AnyToolSpec;
+export declare function toolFor<_T>(provider: 'openai', name: string, options?: ToolOptions): ToolSpecFor['openai'];
+export declare function toolFor<_T>(provider: 'openai-strict', name: string, options?: ToolOptions): ToolSpecFor['openai-strict'];
+export declare function toolFor<_T>(provider: 'anthropic', name: string, options?: ToolOptions): ToolSpecFor['anthropic'];
+export declare function toolFor<_T>(provider: 'gemini', name: string, options?: ToolOptions): ToolSpecFor['gemini'];
+export declare function toolFor<_T>(provider: 'json-schema', name: string, options?: ToolOptions): ToolSpecFor['json-schema'];
+export declare function toolFor<_T, P extends ToolProvider>(provider: P, name: string, options?: ToolOptions): ToolSpecFor[P];
+export declare function toolFor(provider: 'openai', name: string, schema: ToolSchema, options?: ToolOptions): ToolSpecFor['openai'];
+export declare function toolFor(provider: 'openai-strict', name: string, schema: ToolSchema, options?: ToolOptions): ToolSpecFor['openai-strict'];
+export declare function toolFor(provider: 'anthropic', name: string, schema: ToolSchema, options?: ToolOptions): ToolSpecFor['anthropic'];
+export declare function toolFor(provider: 'gemini', name: string, schema: ToolSchema, options?: ToolOptions): ToolSpecFor['gemini'];
+export declare function toolFor(provider: 'json-schema', name: string, schema: ToolSchema, options?: ToolOptions): ToolSpecFor['json-schema'];
+export declare function toolFor<P extends ToolProvider>(provider: P, name: string, schema: ToolSchema, options?: ToolOptions): ToolSpecFor[P];
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

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

package/dist/providers.js

@@ -0,0 +1,252 @@
+import {} from '@zmdb/schema';
+import { jsonSchemaForColumn, jsonSchemaFromShape, shapeOfVariant, } from '@zmdb/schema/ir';
+import { ToolSpecRefusalError } from './http/types.js';
+export { ToolSpecRefusalError };
+const COMMON_KEYWORDS = [
+    'type',
+    'format',
+    'enum',
+    'const',
+    'minimum',
+    'maximum',
+    'minLength',
+    'maxLength',
+    'pattern',
+    'items',
+    'minItems',
+    'maxItems',
+    'properties',
+    'required',
+    'anyOf',
+    'additionalProperties',
+];
+/**
+ * Provider constraints are data rather than branches scattered through the emitter.
+ *
+ * The cap is deliberately below every provider's moving request-size ceiling. It is a
+ * build-time guard against producing a tool definition large enough to be rejected after
+ * deployment, not a promise that a provider will accept every document below it.
+ */
+export const TOOL_DIALECTS = {
+    openai: {
+        allowedKeywords: new Set(COMMON_KEYWORDS),
+        maxProperties: 1_024,
+        source: 'https://platform.openai.com/docs/guides/structured-outputs',
+        verifiedOn: '2026-09-04',
+    },
+    'openai-strict': {
+        allowedKeywords: new Set(COMMON_KEYWORDS),
+        maxProperties: 1_024,
+        source: 'https://platform.openai.com/docs/guides/structured-outputs',
+        verifiedOn: '2026-09-04',
+    },
+    anthropic: {
+        allowedKeywords: new Set(COMMON_KEYWORDS),
+        maxProperties: 1_024,
+        source: 'https://platform.claude.com/docs/en/agents-and-tools/tool-use/implement-tool-use',
+        verifiedOn: '2026-09-04',
+    },
+    gemini: {
+        allowedKeywords: new Set([...COMMON_KEYWORDS, 'nullable']),
+        maxProperties: 1_024,
+        source: 'https://ai.google.dev/api/caching#Schema',
+        verifiedOn: '2026-09-04',
+    },
+    'json-schema': {
+        allowedKeywords: new Set(COMMON_KEYWORDS),
+        source: 'https://json-schema.org/draft/2020-12/json-schema-core.html',
+        verifiedOn: '2026-09-04',
+    },
+};
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isToolSchema(value) {
+    if (!isRecord(value))
+        return false;
+    const ir = value['ir'];
+    return isRecord(ir) && Array.isArray(ir['columns']);
+}
+function descriptionPart(description) {
+    return description ? { description } : {};
+}
+function refusal(provider, path, construct, reason, suggestion) {
+    throw new ToolSpecRefusalError({ provider, path, construct, reason, suggestion });
+}
+function joinPath(parent, child) {
+    return parent.length === 0 ? child : `${parent}.${child}`;
+}
+function nullableType(value) {
+    if (typeof value === 'string')
+        return value === 'null' ? value : [value, 'null'];
+    if (!Array.isArray(value))
+        return value;
+    return value.includes('null') ? [...value] : [...value, 'null'];
+}
+function requiredNames(value) {
+    const required = value['required'];
+    if (!Array.isArray(required))
+        return new Set();
+    return new Set(required.filter(name => typeof name === 'string'));
+}
+function propertiesOf(value) {
+    const properties = value['properties'];
+    return isRecord(properties) ? properties : undefined;
+}
+function translateNode(provider, value, path, optional) {
+    if (Object.keys(value).length === 0) {
+        refusal(provider, path, 'untyped json', 'the provider requires a type for every tool property, but this column emits no type', 'declare the payload with WireAs<W>, or omit the column from the tool');
+    }
+    const dialect = TOOL_DIALECTS[provider];
+    for (const keyword of Object.keys(value)) {
+        if (!dialect.allowedKeywords.has(keyword)) {
+            refusal(provider, path, `unsupported keyword ${keyword}`, `${provider} cannot express the emitted ${keyword} keyword without changing its meaning`, 'declare a provider-compatible wire shape, or omit the column from the tool');
+        }
+    }
+    const result = {};
+    const nested = propertiesOf(value);
+    const nestedRequired = requiredNames(value);
+    for (const [keyword, raw] of Object.entries(value)) {
+        if (provider === 'openai-strict' && keyword === 'format' && raw === 'int64')
+            continue;
+        if (keyword === 'properties' && nested !== undefined) {
+            const properties = {};
+            for (const name of Object.keys(nested).toSorted()) {
+                const child = nested[name];
+                if (!isRecord(child)) {
+                    refusal(provider, joinPath(path, name), 'non-object property schema', 'the emitted property schema is not an object', 'declare the property with a JSON-Schema-compatible wire type');
+                }
+                properties[name] = translateNode(provider, child, joinPath(path, name), !nestedRequired.has(name));
+            }
+            result[keyword] = properties;
+            continue;
+        }
+        if (keyword === 'items' && isRecord(raw)) {
+            result[keyword] = translateNode(provider, raw, `${path}[]`, false);
+            continue;
+        }
+        if (keyword === 'anyOf' && Array.isArray(raw)) {
+            result[keyword] = raw.map((member, index) => {
+                if (!isRecord(member)) {
+                    refusal(provider, `${path}|${String(index)}`, 'non-object union member', 'the emitted union member is not a schema object', 'declare every union member with a provider-compatible wire type');
+                }
+                return translateNode(provider, member, `${path}|${String(index)}`, false);
+            });
+            continue;
+        }
+        if (keyword === 'required' && nested !== undefined && provider === 'openai-strict') {
+            result[keyword] = Object.keys(nested).toSorted();
+            continue;
+        }
+        if (keyword === 'type' && provider === 'gemini' && Array.isArray(raw)) {
+            const nonNull = raw.filter(item => item !== 'null');
+            if (nonNull.length !== 1 || !raw.includes('null')) {
+                refusal(provider, path, 'type union', 'Gemini cannot express this type array without changing the accepted values', 'declare a single nullable wire type, or omit the column from the tool');
+            }
+            result[keyword] = nonNull[0];
+            result['nullable'] = true;
+            continue;
+        }
+        result[keyword] = raw;
+    }
+    if (provider === 'openai-strict') {
+        if (optional)
+            result['type'] = nullableType(result['type']);
+        if (nested !== undefined)
+            result['additionalProperties'] = false;
+    }
+    return result;
+}
+function visibleShape(shape) {
+    return shape
+        .filter(entry => !entry.column.sensitive)
+        .toSorted((left, right) => left.column.name.localeCompare(right.column.name));
+}
+function propertyCount(value) {
+    if (Array.isArray(value))
+        return value.reduce((total, item) => total + propertyCount(item), 0);
+    if (!isRecord(value))
+        return 0;
+    const properties = propertiesOf(value);
+    let count = properties === undefined ? 0 : Object.keys(properties).length;
+    for (const item of Object.values(value))
+        count += propertyCount(item);
+    return count;
+}
+function enforceShape(provider, shape, document) {
+    if (shape.length === 0 && provider !== 'json-schema') {
+        refusal(provider, '', 'empty create schema', 'the create variant has no visible properties', 'drop the tool, or unmark a Sensitive column that the model is allowed to supply');
+    }
+    const maximum = TOOL_DIALECTS[provider].maxProperties;
+    const count = propertyCount(document);
+    if (maximum !== undefined && count > maximum) {
+        refusal(provider, '', `property limit ${String(maximum)}`, `the tool contains ${String(count)} properties, above the provider cap of ${String(maximum)}`, 'split the operation into smaller tools');
+    }
+}
+/**
+ * The provider's parameter document, directly from the declaration IR.
+ *
+ * This is exported for the AOT emitter. Applications should call {@link toolFor}; exposing
+ * the pure step keeps runtime and build-time output byte-identical without a second walker.
+ */
+export function toolSchemaForProvider(provider, shape) {
+    const visible = visibleShape(shape);
+    const generic = jsonSchemaFromShape(visible);
+    enforceShape(provider, visible, generic);
+    if (provider !== 'openai-strict' && provider !== 'gemini')
+        return generic;
+    const properties = {};
+    for (const { column, optional } of visible) {
+        properties[column.name] = translateNode(provider, jsonSchemaForColumn(column), column.name, optional);
+    }
+    if (provider === 'openai-strict') {
+        const strict = {
+            type: 'object',
+            properties,
+            required: visible.map(entry => entry.column.name),
+            additionalProperties: false,
+        };
+        return strict;
+    }
+    return {
+        type: 'object',
+        properties,
+        required: generic.required,
+    };
+}
+export function frameTool(provider, name, parameters, options = {}) {
+    const described = descriptionPart(options.description);
+    switch (provider) {
+        case 'openai':
+            return { type: 'function', function: { name, ...described, parameters } };
+        case 'openai-strict':
+            return {
+                type: 'function',
+                function: {
+                    name,
+                    ...described,
+                    strict: true,
+                    parameters: {
+                        ...parameters,
+                        additionalProperties: false,
+                    },
+                },
+            };
+        case 'anthropic':
+            return { name, ...described, input_schema: parameters };
+        case 'gemini':
+            return { name, ...described, parameters };
+        case 'json-schema':
+            return { name, ...described, parameters };
+    }
+}
+export function toolFor(provider, name, schemaOrOptions, options = {}) {
+    if (!isToolSchema(schemaOrOptions)) {
+        throw new Error('toolFor<T>() was not replaced at build time. It is compiled away by @zmdb/compiler ' +
+            '(the unplugin, Metro adapter, or project compiler), which did not run over this file — a type argument cannot ' +
+            'be read at runtime, so there is nothing to fall back to.');
+    }
+    const parameters = toolSchemaForProvider(provider, shapeOfVariant(schemaOrOptions.ir, 'create'));
+    return frameTool(provider, name, parameters, options);
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/tool-runtime.d.ts

@@ -0,0 +1,36 @@
+export interface InvocableTool<T> {
+    readonly validate: (args: unknown) => T;
+    readonly handler: (input: T, identity?: unknown) => unknown | PromiseLike<unknown>;
+}
+export type ToolInvocation = {
+    readonly kind: 'success';
+    readonly content: string;
+} | {
+    readonly kind: 'validation-error';
+    readonly error: unknown;
+    readonly content?: string;
+} | {
+    readonly kind: 'handler-error';
+    readonly error: unknown;
+};
+export interface ToolAdapterOptions<T, Output = unknown> {
+    readonly description: string;
+    /**
+     * Validate the model-shaped value and return the decoded application value.
+     *
+     * This function belongs at the call site so an AOT validator can be inlined
+     * there. Custom wire codecs can decode in the same function before the
+     * handler receives the value.
+     */
+    readonly validate: (value: unknown) => T;
+    readonly execute: (input: T) => Output | PromiseLike<Output>;
+}
+export declare const serialiseToolResult: (result: unknown) => string;
+export declare function invokeTool<T>(entry: InvocableTool<T>, args: unknown, identity?: unknown): Promise<ToolInvocation>;
+/**
+ * A malformed model call is returned to the model so it can correct the next
+ * turn. Errors without a valid issue list, including handler failures, are
+ * application failures and remain thrown.
+ */
+export declare function executeToolAdapter<T, Output>(name: string, value: unknown, options: ToolAdapterOptions<T, Output>): Promise<Awaited<Output> | string>;
+//# sourceMappingURL=tool-runtime.d.ts.map

package/dist/tool-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-runtime.d.ts","sourceRoot":"","sources":["../src/tool-runtime.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CACpF;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED,eAAO,MAAM,mBAAmB,WAAY,OAAO,KAAG,MAIrD,CAAC;AAcF,wBAAsB,UAAU,CAAC,CAAC,EAChC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,cAAc,CAAC,CAczB;AAUD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAChD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAUnC"}

package/dist/tool-runtime.js

@@ -0,0 +1,55 @@
+import { validationIssuesOf } from '@zmdb/validator';
+export const serialiseToolResult = (result) => {
+    if (typeof result === 'string')
+        return result;
+    const serialised = JSON.stringify(result);
+    return serialised ?? 'undefined';
+};
+const validationErrorContent = (error) => {
+    const issues = validationIssuesOf(error);
+    if (issues === undefined)
+        return undefined;
+    return JSON.stringify(issues.map(issue => issue.expected === undefined
+        ? { path: issue.path, message: issue.message }
+        : { path: issue.path, message: issue.message, expected: issue.expected }));
+};
+export async function invokeTool(entry, args, identity) {
+    let input;
+    try {
+        input = entry.validate(args);
+    }
+    catch (error) {
+        const content = validationErrorContent(error);
+        return content === undefined ? { kind: 'validation-error', error } : { kind: 'validation-error', error, content };
+    }
+    try {
+        return { kind: 'success', content: serialiseToolResult(await entry.handler(input, identity)) };
+    }
+    catch (error) {
+        return { kind: 'handler-error', error };
+    }
+}
+const validationLine = (issue) => issue.expected === undefined ? `${issue.path}: ${issue.message}` : `${issue.path}: expected ${issue.expected}`;
+const validationFailure = (name, issues) => {
+    const details = issues.length === 0 ? 'validation failed without details' : issues.map(validationLine).join('\n');
+    return `Tool "${name}" rejected its arguments:\n${details}`;
+};
+/**
+ * A malformed model call is returned to the model so it can correct the next
+ * turn. Errors without a valid issue list, including handler failures, are
+ * application failures and remain thrown.
+ */
+export async function executeToolAdapter(name, value, options) {
+    let input;
+    try {
+        input = options.validate(value);
+    }
+    catch (error) {
+        const issues = validationIssuesOf(error);
+        if (issues === undefined)
+            throw error;
+        return validationFailure(name, issues);
+    }
+    return await options.execute(input);
+}
+//# sourceMappingURL=tool-runtime.js.map

package/dist/tool-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-runtime.js","sourceRoot":"","sources":["../src/tool-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAwB,MAAM,iBAAiB,CAAC;AAyB3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAe,EAAU,EAAE;IAC7D,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,UAAU,IAAI,WAAW,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAsB,EAAE;IACpE,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,IAAI,CAAC,SAAS,CACnB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CACjB,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;QAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAC3E,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAuB,EACvB,IAAa,EACb,QAAkB;IAElB,IAAI,KAAQ,CAAC;IACb,IAAI,CAAC;QACH,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACpH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;IACjG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,KAAsB,EAAU,EAAE,CACxD,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,QAAQ,EAAE,CAAC;AAEjH,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,MAAkC,EAAU,EAAE;IACrF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClH,OAAO,SAAS,IAAI,8BAA8B,OAAO,EAAE,CAAC;AAC9D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,KAAc,EACd,OAAsC;IAEtC,IAAI,KAAQ,CAAC;IACb,IAAI,CAAC;QACH,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,KAAK,CAAC;QACtC,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@zmdb/ai",
+  "version": "1.0.0-beta.1",
+  "description": "Provider-neutral AI tool documents, bounded chat orchestration, shared tool invocation, and OpenAPI-derived tools for zmdb.",
+  "keywords": [
+    "ai",
+    "function-calling",
+    "json-schema",
+    "llm",
+    "openapi",
+    "typescript",
+    "zmdb"
+  ],
+  "homepage": "https://github.com/ambasta/zmdb#readme",
+  "bugs": {
+    "url": "https://github.com/ambasta/zmdb/issues"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "zmdb contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambasta/zmdb.git",
+    "directory": "packages/ai"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./chat": {
+      "types": "./dist/chat/index.d.ts",
+      "import": "./dist/chat/index.js"
+    },
+    "./compiler": {
+      "types": "./dist/compiler.d.ts",
+      "import": "./dist/compiler.js"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "import": "./dist/http/index.js"
+    },
+    "./tool-runtime": {
+      "types": "./dist/tool-runtime.d.ts",
+      "import": "./dist/tool-runtime.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "@zmdb/schema": "1.0.0-beta.1",
+    "@zmdb/validator": "1.0.0-beta.1"
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}