pyric 0.0.1 → 0.1.0-alpha.10

package/dist/ai/response-helpers.js

@@ -0,0 +1,204 @@
+/**
+ * Response helpers for `pyric/ai` — `EnhancedGenerateContentResponse`
+ * decoration ported from the installed `@firebase/ai@2.12.0`
+ * response-helpers (dist/index.node.mjs):
+ *
+ *   - `text()` / `thoughtSummary()` / `inlineDataParts()` / `functionCalls()`
+ *     helpers attached to the plain envelope; data keys stay exactly the
+ *     wire's (`dataKeys` fact of `ai-generate-minimal-envelope`).
+ *   - `badFinishReasons` throw semantics with upstream's EXACT messages:
+ *     "Response error: <blockErrorMessage>. Response body stored in
+ *     error.response" and "Text not available. <blockErrorMessage>".
+ *   - The denied hybrid `inferenceSource` property is NEVER added (surface
+ *     inventory: client-side SDK addition, absent from the mirrored plane).
+ *
+ * Aggregation of streamed chunks follows the installed `aggregateResponses`
+ * candidate/part merge (empty text parts skipped, latest metadata wins),
+ * with the registry-pinned delta that the FINAL chunk's `usageMetadata`,
+ * `modelVersion`, and `responseId` ride the aggregate (rows
+ * ai#stream-aggregate-final-meta / ai#chat-sendmessagestream).
+ */
+import { AIError, AIErrorCode } from './errors.js';
+import { FinishReason } from './enums.js';
+const badFinishReasons = [
+    FinishReason.RECITATION,
+    FinishReason.SAFETY,
+    FinishReason.BLOCKLIST,
+    FinishReason.PROHIBITED_CONTENT,
+    FinishReason.SPII,
+    FinishReason.MALFORMED_FUNCTION_CALL,
+    FinishReason.IMAGE_SAFETY,
+    FinishReason.IMAGE_PROHIBITED_CONTENT,
+    FinishReason.IMAGE_OTHER,
+    FinishReason.NO_IMAGE,
+    FinishReason.IMAGE_RECITATION,
+    FinishReason.LANGUAGE,
+    FinishReason.UNEXPECTED_TOOL_CALL,
+    FinishReason.TOO_MANY_TOOL_CALLS,
+    FinishReason.MISSING_THOUGHT_SIGNATURE,
+    FinishReason.MALFORMED_RESPONSE,
+];
+function hadBadFinishReason(candidate) {
+    return !!candidate.finishReason && badFinishReasons.some((r) => r === candidate.finishReason);
+}
+export function formatBlockErrorMessage(response) {
+    let message = '';
+    if ((!response.candidates || response.candidates.length === 0) && response.promptFeedback) {
+        message += 'Response was blocked';
+        if (response.promptFeedback?.blockReason) {
+            message += ` due to ${response.promptFeedback.blockReason}`;
+        }
+    }
+    else if (response.candidates?.[0]) {
+        const firstCandidate = response.candidates[0];
+        if (hadBadFinishReason(firstCandidate)) {
+            message += `Candidate was blocked due to ${firstCandidate.finishReason}`;
+            if (firstCandidate.finishMessage) {
+                message += `: ${firstCandidate.finishMessage}`;
+            }
+        }
+    }
+    return message;
+}
+/** At least one candidate exists and the first has no bad finish reason. */
+function hasValidCandidates(response) {
+    if (response.candidates && response.candidates.length > 0) {
+        if (hadBadFinishReason(response.candidates[0])) {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Response error: ${formatBlockErrorMessage(response)}. Response body stored in error.response`, { response });
+        }
+        return true;
+    }
+    return false;
+}
+function getText(response, partFilter) {
+    const textStrings = [];
+    for (const part of response.candidates?.[0]?.content?.parts ?? []) {
+        if (part.text && partFilter(part)) {
+            textStrings.push(part.text);
+        }
+    }
+    return textStrings.length > 0 ? textStrings.join('') : '';
+}
+function getFunctionCalls(response) {
+    const functionCalls = [];
+    for (const part of response.candidates?.[0]?.content?.parts ?? []) {
+        if (part.functionCall) {
+            functionCalls.push(part.functionCall);
+        }
+    }
+    return functionCalls.length > 0 ? functionCalls : undefined;
+}
+function getInlineDataParts(response) {
+    const data = [];
+    for (const part of response.candidates?.[0]?.content?.parts ?? []) {
+        if (part.inlineData) {
+            data.push(part);
+        }
+    }
+    return data.length > 0 ? data : undefined;
+}
+/**
+ * Attach the helper methods to a (mutable, broker-owned) envelope. Mirrors
+ * upstream `createEnhancedContentResponse`/`addHelpers` minus the denied
+ * `inferenceSource` stamp.
+ */
+export function createEnhancedContentResponse(response) {
+    if (response.candidates && response.candidates.length > 0 && response.candidates[0].index === undefined) {
+        response.candidates[0].index = 0;
+    }
+    const enhanced = response;
+    enhanced.text = () => {
+        if (hasValidCandidates(enhanced)) {
+            return getText(enhanced, (part) => !part.thought);
+        }
+        else if (enhanced.promptFeedback) {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Text not available. ${formatBlockErrorMessage(enhanced)}`, { response: enhanced });
+        }
+        return '';
+    };
+    enhanced.thoughtSummary = () => {
+        if (hasValidCandidates(enhanced)) {
+            const result = getText(enhanced, (part) => !!part.thought);
+            return result === '' ? undefined : result;
+        }
+        else if (enhanced.promptFeedback) {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Thought summary not available. ${formatBlockErrorMessage(enhanced)}`, { response: enhanced });
+        }
+        return undefined;
+    };
+    enhanced.inlineDataParts = () => {
+        if (hasValidCandidates(enhanced)) {
+            return getInlineDataParts(enhanced);
+        }
+        else if (enhanced.promptFeedback) {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Data not available. ${formatBlockErrorMessage(enhanced)}`, { response: enhanced });
+        }
+        return undefined;
+    };
+    enhanced.functionCalls = () => {
+        if (hasValidCandidates(enhanced)) {
+            return getFunctionCalls(enhanced);
+        }
+        else if (enhanced.promptFeedback) {
+            throw new AIError(AIErrorCode.RESPONSE_ERROR, `Function call not available. ${formatBlockErrorMessage(enhanced)}`, { response: enhanced });
+        }
+        return undefined;
+    };
+    return enhanced;
+}
+/**
+ * Aggregate streamed chunk envelopes into one response: upstream 2.12.0's
+ * candidate/part merge, plus the pinned final-chunk metadata carry.
+ */
+export function aggregateResponses(responses) {
+    const lastResponse = responses[responses.length - 1];
+    const aggregated = {};
+    if (lastResponse?.promptFeedback) {
+        aggregated.promptFeedback = lastResponse.promptFeedback;
+    }
+    for (const response of responses) {
+        if (!response.candidates)
+            continue;
+        for (const candidate of response.candidates) {
+            const i = candidate.index || 0;
+            aggregated.candidates ??= [];
+            let slot = aggregated.candidates[i];
+            if (!slot) {
+                slot = { index: candidate.index ?? i };
+                aggregated.candidates[i] = slot;
+            }
+            if (candidate.finishReason !== undefined)
+                slot.finishReason = candidate.finishReason;
+            if (candidate.finishMessage !== undefined)
+                slot.finishMessage = candidate.finishMessage;
+            if (candidate.safetyRatings !== undefined)
+                slot.safetyRatings = candidate.safetyRatings;
+            if (candidate.content) {
+                if (!candidate.content.parts)
+                    continue;
+                if (!slot.content) {
+                    slot.content = { role: candidate.content.role || 'model', parts: [] };
+                }
+                for (const part of candidate.content.parts) {
+                    const newPart = { ...part };
+                    // The backend can send empty text parts; replaying them errors.
+                    if (part.text === '')
+                        continue;
+                    if (Object.keys(newPart).length > 0) {
+                        slot.content.parts.push(newPart);
+                    }
+                }
+            }
+        }
+    }
+    // Pinned delta vs installed 2.12.0 (which drops usage on the aggregate):
+    // the final chunk's usageMetadata / modelVersion / responseId ride along.
+    if (lastResponse?.usageMetadata)
+        aggregated.usageMetadata = structuredClone(lastResponse.usageMetadata);
+    if (lastResponse?.modelVersion !== undefined)
+        aggregated.modelVersion = lastResponse.modelVersion;
+    if (lastResponse?.responseId !== undefined)
+        aggregated.responseId = lastResponse.responseId;
+    return aggregated;
+}
+//# sourceMappingURL=response-helpers.js.map

package/dist/ai/response-helpers.js.map

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

package/dist/ai/sandbox-plane.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The sandbox model plane for `pyric/ai` — everything between the public
+ * `GenerativeModel`/`ChatSession` classes and the {@link AiBroker}:
+ *
+ *   - production-shaped MODEL validation before any engine runs: a
+ *     `gemini-1.5-*` name answers the captured retired-model 404
+ *     (`ai-error-retired-model`, ErrorInfo detail verbatim); anything
+ *     outside the `gemini-*` family answers the captured unknown-model 404
+ *     (`ai-error-unknown-model`);
+ *   - request NORMALIZATION: one JSON round-trip drops undefined keys, runs
+ *     `Schema.toJSON()` (so `responseSchema` rides the request in wire
+ *     form), and decouples the broker's view from caller-held references;
+ *   - pre-aborted `SingleRequestOptions.signal` rejection (AbortError,
+ *     matching upstream's pre-fetch check);
+ *   - broker error envelopes translated to SDK `AIError`s at this ONE seam;
+ *   - streaming: the broker stream is pumped eagerly (upstream tees), the
+ *     consumer iterates enhanced chunks, and `response` resolves with the
+ *     2.12.0-style aggregate.
+ */
+import { type CountTokensResponse, type WireErrorEnvelope } from './broker/index.js';
+import { type EnhancedResponse } from './response-helpers.js';
+import type { AITarget } from './types.js';
+export interface SingleRequestOptions {
+    timeout?: number;
+    baseUrl?: string;
+    maxSequentialFunctionCalls?: number;
+    signal?: AbortSignal;
+}
+export interface GenerateContentResult {
+    response: EnhancedResponse;
+}
+export interface GenerateContentStreamResult {
+    stream: AsyncGenerator<EnhancedResponse>;
+    response: Promise<EnhancedResponse>;
+}
+/** `ai-error-retired-model`: captured message + ErrorInfo detail, verbatim. */
+export declare function retiredModel(): WireErrorEnvelope;
+export declare function planeGenerateContent(target: AITarget, modelResource: string, request: Record<string, unknown>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentResult>;
+export declare function planeGenerateContentStream(target: AITarget, modelResource: string, request: Record<string, unknown>, singleRequestOptions?: SingleRequestOptions): Promise<GenerateContentStreamResult>;
+export declare function planeCountTokens(target: AITarget, modelResource: string, request: Record<string, unknown>, singleRequestOptions?: SingleRequestOptions): Promise<CountTokensResponse>;
+//# sourceMappingURL=sandbox-plane.d.ts.map

package/dist/ai/sandbox-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-plane.d.ts","sourceRoot":"","sources":["../../src/ai/sandbox-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAIL,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACzC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACrC;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,IAAI,iBAAiB,CAchD;AAsCD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,QAAQ,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CAYhC;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,QAAQ,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,2BAA2B,CAAC,CAoEtC;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,QAAQ,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,mBAAmB,CAAC,CAa9B"}

package/dist/ai/sandbox-plane.js

@@ -0,0 +1,159 @@
+/**
+ * The sandbox model plane for `pyric/ai` — everything between the public
+ * `GenerativeModel`/`ChatSession` classes and the {@link AiBroker}:
+ *
+ *   - production-shaped MODEL validation before any engine runs: a
+ *     `gemini-1.5-*` name answers the captured retired-model 404
+ *     (`ai-error-retired-model`, ErrorInfo detail verbatim); anything
+ *     outside the `gemini-*` family answers the captured unknown-model 404
+ *     (`ai-error-unknown-model`);
+ *   - request NORMALIZATION: one JSON round-trip drops undefined keys, runs
+ *     `Schema.toJSON()` (so `responseSchema` rides the request in wire
+ *     form), and decouples the broker's view from caller-held references;
+ *   - pre-aborted `SingleRequestOptions.signal` rejection (AbortError,
+ *     matching upstream's pre-fetch check);
+ *   - broker error envelopes translated to SDK `AIError`s at this ONE seam;
+ *   - streaming: the broker stream is pumped eagerly (upstream tees), the
+ *     consumer iterates enhanced chunks, and `response` resolves with the
+ *     2.12.0-style aggregate.
+ */
+import { AiBrokerError, errorEnvelope, unknownModel, } from './broker/index.js';
+import { toAIError } from './errors.js';
+import { aggregateResponses, createEnhancedContentResponse, } from './response-helpers.js';
+/** `ai-error-retired-model`: captured message + ErrorInfo detail, verbatim. */
+export function retiredModel() {
+    const envelope = errorEnvelope(404, 'Gemini 1.5 models are retired as of September 24, 2025. Update to a newer model version. [Learn more.](https://firebase.google.com/docs/ai-logic/faq-and-troubleshooting#discontinued-models)', 'NOT_FOUND');
+    envelope.error.details = [
+        {
+            '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
+            reason: 'RETIRED_MODEL',
+            domain: 'firebasevertexai.googleapis.com',
+        },
+    ];
+    return envelope;
+}
+/**
+ * Production-shaped model routing. The sandbox serves the `gemini-*` family
+ * (aliases resolve in the synthesizer); retired 1.5 models and unknown
+ * names answer the captured 404 envelopes.
+ */
+function validateModel(modelResource) {
+    const bare = modelResource.startsWith('models/')
+        ? modelResource.slice('models/'.length)
+        : modelResource;
+    if (/^gemini-1\.5/.test(bare)) {
+        throw new AiBrokerError(retiredModel());
+    }
+    if (!/^gemini-/.test(bare)) {
+        throw new AiBrokerError(unknownModel(bare));
+    }
+}
+/** Upstream rejects a pre-aborted signal before any fetch; so do we. */
+function checkSignal(singleRequestOptions) {
+    const signal = singleRequestOptions?.signal;
+    if (signal?.aborted) {
+        throw new DOMException(signal.reason ?? 'Aborted externally before fetch', 'AbortError');
+    }
+}
+/**
+ * One JSON round-trip: runs `toJSON()` on Schema instances, drops undefined
+ * values, and clones so later caller mutations never reach the broker.
+ */
+function normalizeRequest(request) {
+    return JSON.parse(JSON.stringify(request));
+}
+export async function planeGenerateContent(target, modelResource, request, singleRequestOptions) {
+    target.assertAlive?.();
+    checkSignal(singleRequestOptions);
+    try {
+        validateModel(modelResource);
+        const normalized = normalizeRequest(request);
+        const response = await (target.kind === 'transport' ? target.transport : target.broker)
+            .generateContent(normalized, modelResource);
+        return { response: createEnhancedContentResponse(response) };
+    }
+    catch (err) {
+        throw toAIError(err, modelResource, 'generateContent');
+    }
+}
+export async function planeGenerateContentStream(target, modelResource, request, singleRequestOptions) {
+    target.assertAlive?.();
+    checkSignal(singleRequestOptions);
+    let inner;
+    try {
+        validateModel(modelResource);
+        const normalized = normalizeRequest(request);
+        // Broker validation runs eagerly here — a bad request throws before
+        // iteration, the way production answers HTTP errors instead of a stream.
+        inner = (target.kind === 'transport' ? target.transport : target.broker)
+            .streamGenerateContent(normalized, modelResource);
+    }
+    catch (err) {
+        throw toAIError(err, modelResource, 'streamGenerateContent');
+    }
+    // Pump eagerly (upstream tees the body stream): the aggregate resolves
+    // even if the consumer never drains `stream`.
+    const buffered = [];
+    let done = false;
+    let failure;
+    let notify;
+    const wake = () => {
+        notify?.();
+        notify = undefined;
+    };
+    const pumped = (async () => {
+        try {
+            for await (const chunk of inner) {
+                buffered.push(chunk);
+                wake();
+            }
+        }
+        catch (err) {
+            failure = toAIError(err, modelResource, 'streamGenerateContent');
+            wake();
+            throw failure;
+        }
+        finally {
+            done = true;
+            wake();
+        }
+        return aggregateResponses(buffered);
+    })();
+    const response = pumped.then((aggregate) => createEnhancedContentResponse(aggregate));
+    // Consumers may only iterate `stream` — never let an un-awaited aggregate
+    // rejection surface as an unhandled rejection (the error still reaches
+    // whoever DOES await `response`).
+    void response.catch(() => undefined);
+    async function* stream() {
+        let next = 0;
+        for (;;) {
+            if (next < buffered.length) {
+                // Chunks are broker-owned fresh objects; enhance in place.
+                yield createEnhancedContentResponse(structuredClone(buffered[next++]));
+                continue;
+            }
+            if (failure !== undefined)
+                throw failure;
+            if (done)
+                return;
+            await new Promise((resolve) => {
+                notify = resolve;
+            });
+        }
+    }
+    return { stream: stream(), response };
+}
+export async function planeCountTokens(target, modelResource, request, singleRequestOptions) {
+    target.assertAlive?.();
+    checkSignal(singleRequestOptions);
+    try {
+        validateModel(modelResource);
+        const dispatch = target.kind === 'transport' ? target.transport : target.broker;
+        const normalized = normalizeRequest(request);
+        return await dispatch.countTokens(normalized, modelResource);
+    }
+    catch (err) {
+        throw toAIError(err, modelResource, 'countTokens');
+    }
+}
+//# sourceMappingURL=sandbox-plane.js.map

package/dist/ai/sandbox-plane.js.map

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

package/dist/ai/schema.d.ts

@@ -0,0 +1,105 @@
+/**
+ * `Schema` builder classes for `pyric/ai` — a faithful port of the installed
+ * `@firebase/ai@2.12.0` schema-builder (dist/index.node.mjs), including the
+ * `toJSON()` serialization the SDK relies on when the request body is
+ * JSON.stringify'd: `required` derived from `optionalProperties`, nested
+ * schemas serialized recursively, `anyOf` with no top-level type.
+ *
+ * ONE deliberate delta from the installed 2.12.0, pinned by the registry row
+ * ai#schema-string-enum: `Schema.enumString` sets `format: 'enum'` (GoogleAI
+ * accepts only `enum` and `date-time` formats; the installed builder omits
+ * it and produces requests GoogleAI rejects).
+ */
+import { SchemaType } from './enums.js';
+/** Params accepted by the static builders (upstream `SchemaParams` shape). */
+export interface SchemaParams {
+    type?: SchemaType;
+    format?: string;
+    description?: string;
+    title?: string;
+    items?: Schema;
+    minItems?: number;
+    maxItems?: number;
+    properties?: Record<string, Schema>;
+    optionalProperties?: string[];
+    propertyOrdering?: string[];
+    enum?: string[];
+    example?: unknown;
+    nullable?: boolean;
+    minimum?: number;
+    maximum?: number;
+    anyOf?: TypedSchema[];
+    [key: string]: unknown;
+}
+/** Union of all concrete schema classes. */
+export type TypedSchema = IntegerSchema | NumberSchema | StringSchema | BooleanSchema | ObjectSchema | ArraySchema | AnyOfSchema;
+/**
+ * Parent class encompassing all Schema types. Converts with
+ * `JSON.stringify()` into the JSON string the REST endpoints accept.
+ */
+export declare abstract class Schema {
+    type?: SchemaType;
+    format?: string;
+    nullable: boolean;
+    [key: string]: unknown;
+    constructor(schemaParams: SchemaParams);
+    /** Serialization the request body applies via `JSON.stringify`. */
+    toJSON(): Record<string, unknown>;
+    static array(arrayParams: SchemaParams & {
+        items: TypedSchema;
+    }): ArraySchema;
+    static object(objectParams: SchemaParams & {
+        properties: Record<string, TypedSchema>;
+        optionalProperties?: string[];
+    }): ObjectSchema;
+    static string(stringParams?: SchemaParams): StringSchema;
+    static enumString(stringParams: SchemaParams & {
+        enum: string[];
+    }): StringSchema;
+    static integer(integerParams?: SchemaParams): IntegerSchema;
+    static number(numberParams?: SchemaParams): NumberSchema;
+    static boolean(booleanParams?: SchemaParams): BooleanSchema;
+    static anyOf(anyOfParams: SchemaParams & {
+        anyOf: TypedSchema[];
+    }): AnyOfSchema;
+}
+/** Schema class for "integer" types. */
+export declare class IntegerSchema extends Schema {
+    constructor(schemaParams?: SchemaParams);
+}
+/** Schema class for "number" types. */
+export declare class NumberSchema extends Schema {
+    constructor(schemaParams?: SchemaParams);
+}
+/** Schema class for "boolean" types. */
+export declare class BooleanSchema extends Schema {
+    constructor(schemaParams?: SchemaParams);
+}
+/** Schema class for "string" types, with or without enum values. */
+export declare class StringSchema extends Schema {
+    enum?: string[];
+    constructor(schemaParams?: SchemaParams, enumValues?: string[]);
+    toJSON(): Record<string, unknown>;
+}
+/** Schema class for "array" types; `items` is the member schema. */
+export declare class ArraySchema extends Schema {
+    items: TypedSchema;
+    constructor(schemaParams: SchemaParams, items: TypedSchema);
+    toJSON(): Record<string, unknown>;
+}
+/** Schema class for "object" types; `properties` maps names to Schemas. */
+export declare class ObjectSchema extends Schema {
+    properties: Record<string, TypedSchema>;
+    optionalProperties: string[];
+    constructor(schemaParams: SchemaParams, properties: Record<string, TypedSchema>, optionalProperties?: string[]);
+    toJSON(): Record<string, unknown>;
+}
+/** Schema for a value conforming to ANY of the provided sub-schemas. */
+export declare class AnyOfSchema extends Schema {
+    anyOf: TypedSchema[];
+    constructor(schemaParams: SchemaParams & {
+        anyOf: TypedSchema[];
+    });
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=schema.d.ts.map

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

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