pyric 0.0.1 → 0.1.0-alpha.10

package/dist/ai/broker/types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Wire types for the AI broker — minimal STRUCTURAL types matching the
+ * Gemini v1beta wire (GoogleAI backend), as captured by the ai-* oracle
+ * observations in `packages/conformance/observations/`. Deliberately NOT imported
+ * from `firebase/ai`: the broker speaks the wire, and the `pyric/ai` mirror
+ * layer (next stage) owns public SDK-facing types.
+ *
+ * Load-bearing wire facts these types encode (see the observations):
+ *   - `ai-generate-minimal-envelope`: top-level keys `candidates` /
+ *     `modelVersion` / `responseId` / `usageMetadata`; usage carries
+ *     `serviceTier` (undeclared by SDK typings) and `promptTokensDetails`;
+ *     candidate `index` IS on the wire.
+ *   - `ai-function-call-shape`: functionCall keys are `args`/`id`/`name`,
+ *     and `args` is a parsed OBJECT, never a JSON string.
+ *   - `ai-thinking-thought-parts` / `ai-error-fncall-missing-thought-signature`:
+ *     `thoughtSignature` rides on parts (even trivial text parts) and is
+ *     REQUIRED on functionCall model turns threaded back in.
+ */
+export interface WirePart {
+    text?: string;
+    /** `args` is an object on the wire (`argsIsObjectNotString` fact). */
+    functionCall?: {
+        name: string;
+        args: Record<string, unknown>;
+        id?: string;
+    };
+    functionResponse?: {
+        name: string;
+        response: Record<string, unknown>;
+        id?: string;
+    };
+    inlineData?: {
+        mimeType: string;
+        data: string;
+    };
+    /** Thought-summary flag (`includeThoughts`); thought parts never replay upstream. */
+    thought?: boolean;
+    /** Opaque signature production mints on parts — including trivial text parts. */
+    thoughtSignature?: string;
+}
+export interface WireContent {
+    role: string;
+    parts: WirePart[];
+}
+export interface GenerateContentRequest {
+    contents: WireContent[];
+    systemInstruction?: {
+        role?: string;
+        parts: WirePart[];
+    };
+    tools?: Array<{
+        functionDeclarations?: Array<{
+            name: string;
+            description?: string;
+            parameters?: Record<string, unknown>;
+        }>;
+    }>;
+    toolConfig?: {
+        functionCallingConfig?: {
+            mode?: 'AUTO' | 'ANY' | 'NONE';
+            allowedFunctionNames?: string[];
+        };
+    };
+    generationConfig?: {
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        maxOutputTokens?: number;
+        stopSequences?: string[];
+        responseMimeType?: string;
+        responseSchema?: Record<string, unknown>;
+        frequencyPenalty?: number;
+        presencePenalty?: number;
+    };
+}
+export interface CountTokensRequest {
+    contents: WireContent[];
+    systemInstruction?: {
+        role?: string;
+        parts: WirePart[];
+    };
+}
+export interface WireCandidate {
+    content: {
+        parts: WirePart[];
+        role: 'model';
+    };
+    finishReason?: string;
+    /** Present on the wire (`candidateHasIndexOnWire: true`). */
+    index: number;
+    /** Production adds this on function-call candidates (`ai-function-call-shape` raw). */
+    finishMessage?: string;
+    safetyRatings?: unknown[];
+}
+export interface WireUsageMetadata {
+    promptTokenCount: number;
+    candidatesTokenCount: number;
+    totalTokenCount: number;
+    /** Always present on the captured wire; optional here only because the pure
+     *  OpenAI translation step produces usage before the synthesizer's decorate
+     *  pass fills the synthesized fields in. */
+    promptTokensDetails?: Array<{
+        modality: string;
+        tokenCount: number;
+    }>;
+    /** Undeclared by the SDK typings but always on the captured wire. */
+    serviceTier?: string;
+}
+/** A complete GenerateContentResponse envelope as production frames it. */
+export interface WireResponse {
+    candidates?: WireCandidate[];
+    usageMetadata?: WireUsageMetadata;
+    modelVersion?: string;
+    responseId?: string;
+    promptFeedback?: {
+        blockReason?: string;
+        safetyRatings?: unknown[];
+    };
+}
+/**
+ * One streamed chunk. Every SSE event's `data:` payload is a COMPLETE
+ * GenerateContentResponse (`ai-generate-stream-framing`): usageMetadata on
+ * every chunk, finishReason only on the last. These are chunk OBJECTS —
+ * SSE encoding (`data: ` prefix, CRLF CRLF separator) is the transport's
+ * job elsewhere, not the broker's.
+ */
+export type WireChunk = WireResponse;
+/** countTokens envelope — exactly these keys (`ai-counttokens-envelope`). */
+export interface CountTokensResponse {
+    totalTokens: number;
+    promptTokensDetails: Array<{
+        modality: string;
+        tokenCount: number;
+    }>;
+}
+/** Gemini error envelope: `{ error: { code, message, status } }` on every ai-error-* capture. */
+export interface WireErrorEnvelope {
+    error: {
+        code: number;
+        message: string;
+        status: string;
+        details?: Array<Record<string, unknown>>;
+    };
+}
+export interface AnswerEngine {
+    generateContent(req: GenerateContentRequest, model: string): Promise<WireResponse>;
+    streamGenerateContent(req: GenerateContentRequest, model: string): AsyncIterable<WireChunk>;
+    countTokens(req: CountTokensRequest, model: string): Promise<CountTokensResponse>;
+}
+/**
+ * Shorthand responses. One synthesizer (synthesizer.ts) expands these into
+ * wire-true envelopes and owns the shape facts.
+ */
+export type ScriptShorthand = {
+    text: string;
+} | {
+    json: unknown;
+} | {
+    functionCall: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+} | {
+    chunks: string[];
+}
+/** Keys mirror the wire error envelope: numeric `code`, string `status`,
+ *  optional `details` (the captured `@type`d detail objects ride through). */
+ | {
+    error: {
+        code: number;
+        message: string;
+        status: string;
+        details?: Array<Record<string, unknown>>;
+    };
+};
+/**
+ * A raw Gemini envelope — an observation's `behavior.raw` pastes in
+ * directly (captures are the corpus). Discriminated from shorthands
+ * structurally by the presence of `candidates` OR `promptFeedback`:
+ * a blocked-prompt capture is a valid wire envelope that carries
+ * `promptFeedback` and no candidates at all.
+ */
+export type RawEnvelope = WireResponse & ({
+    candidates: WireCandidate[];
+} | {
+    promptFeedback: NonNullable<WireResponse['promptFeedback']>;
+});
+export type ScriptRespond = ScriptShorthand | RawEnvelope;
+/** Matcher: substring / regex against the last user turn text, or a predicate on the request. */
+export type ScriptMatcher = string | RegExp | ((req: GenerateContentRequest) => boolean);
+export interface ScriptEntry {
+    /** Absent ⇒ unconditional next-in-queue. */
+    match?: ScriptMatcher;
+    respond: ScriptRespond;
+}
+export type EngineConfig = {
+    kind: 'scripted';
+    script?: ScriptEntry[];
+} | {
+    kind: 'openai';
+    /** OpenAI-compatible base URL, e.g. `http://localhost:11434/v1` or serve's `/__pyric/ai-proxy`. */
+    baseUrl: string;
+    /** Catch-all upstream model when `modelMap` has no entry. */
+    model?: string;
+    /** Explicit Gemini-model-id → upstream-model mapping. */
+    modelMap?: Record<string, string>;
+    /** Injectable fetch for tests; defaults to globalThis.fetch. */
+    fetch?: typeof fetch;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/broker/types.d.ts.map

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

package/dist/ai/broker/types.js

@@ -0,0 +1,20 @@
+/**
+ * Wire types for the AI broker — minimal STRUCTURAL types matching the
+ * Gemini v1beta wire (GoogleAI backend), as captured by the ai-* oracle
+ * observations in `packages/conformance/observations/`. Deliberately NOT imported
+ * from `firebase/ai`: the broker speaks the wire, and the `pyric/ai` mirror
+ * layer (next stage) owns public SDK-facing types.
+ *
+ * Load-bearing wire facts these types encode (see the observations):
+ *   - `ai-generate-minimal-envelope`: top-level keys `candidates` /
+ *     `modelVersion` / `responseId` / `usageMetadata`; usage carries
+ *     `serviceTier` (undeclared by SDK typings) and `promptTokensDetails`;
+ *     candidate `index` IS on the wire.
+ *   - `ai-function-call-shape`: functionCall keys are `args`/`id`/`name`,
+ *     and `args` is a parsed OBJECT, never a JSON string.
+ *   - `ai-thinking-thought-parts` / `ai-error-fncall-missing-thought-signature`:
+ *     `thoughtSignature` rides on parts (even trivial text parts) and is
+ *     REQUIRED on functionCall model turns threaded back in.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/broker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ai/broker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/ai/enums.d.ts

@@ -0,0 +1,174 @@
+/**
+ * `pyric/ai` const/type enum pairs — value sets copied VERBATIM from the
+ * installed `@firebase/ai@2.12.0` runtime bundle (the census universe; see
+ * packages/conformance/surfaces/ai.json). Each name is exported both as a
+ * const object and a type, matching the upstream `const X = {...} as const;
+ * type X = (typeof X)[keyof typeof X]` pattern.
+ */
+/** Possible roles (upstream `POSSIBLE_ROLES`). */
+export declare const POSSIBLE_ROLES: readonly ["user", "model", "function", "system"];
+/** The producer of the content. */
+export type Role = (typeof POSSIBLE_ROLES)[number];
+/** Harm categories that would cause prompts or candidates to be blocked. */
+export declare const HarmCategory: {
+    readonly HARM_CATEGORY_HATE_SPEECH: "HARM_CATEGORY_HATE_SPEECH";
+    readonly HARM_CATEGORY_SEXUALLY_EXPLICIT: "HARM_CATEGORY_SEXUALLY_EXPLICIT";
+    readonly HARM_CATEGORY_HARASSMENT: "HARM_CATEGORY_HARASSMENT";
+    readonly HARM_CATEGORY_DANGEROUS_CONTENT: "HARM_CATEGORY_DANGEROUS_CONTENT";
+};
+export type HarmCategory = (typeof HarmCategory)[keyof typeof HarmCategory];
+/** Threshold above which a prompt or candidate will be blocked. */
+export declare const HarmBlockThreshold: {
+    readonly BLOCK_LOW_AND_ABOVE: "BLOCK_LOW_AND_ABOVE";
+    readonly BLOCK_MEDIUM_AND_ABOVE: "BLOCK_MEDIUM_AND_ABOVE";
+    readonly BLOCK_ONLY_HIGH: "BLOCK_ONLY_HIGH";
+    readonly BLOCK_NONE: "BLOCK_NONE";
+    readonly OFF: "OFF";
+};
+export type HarmBlockThreshold = (typeof HarmBlockThreshold)[keyof typeof HarmBlockThreshold];
+/** Probability-vs-severity blocking method (Vertex AI only). */
+export declare const HarmBlockMethod: {
+    readonly SEVERITY: "SEVERITY";
+    readonly PROBABILITY: "PROBABILITY";
+};
+export type HarmBlockMethod = (typeof HarmBlockMethod)[keyof typeof HarmBlockMethod];
+/** Probability that a prompt or candidate matches a harm category. */
+export declare const HarmProbability: {
+    readonly NEGLIGIBLE: "NEGLIGIBLE";
+    readonly LOW: "LOW";
+    readonly MEDIUM: "MEDIUM";
+    readonly HIGH: "HIGH";
+};
+export type HarmProbability = (typeof HarmProbability)[keyof typeof HarmProbability];
+/** Harm severity levels (`UNSUPPORTED` is the GoogleAI fallback). */
+export declare const HarmSeverity: {
+    readonly HARM_SEVERITY_NEGLIGIBLE: "HARM_SEVERITY_NEGLIGIBLE";
+    readonly HARM_SEVERITY_LOW: "HARM_SEVERITY_LOW";
+    readonly HARM_SEVERITY_MEDIUM: "HARM_SEVERITY_MEDIUM";
+    readonly HARM_SEVERITY_HIGH: "HARM_SEVERITY_HIGH";
+    readonly HARM_SEVERITY_UNSUPPORTED: "HARM_SEVERITY_UNSUPPORTED";
+};
+export type HarmSeverity = (typeof HarmSeverity)[keyof typeof HarmSeverity];
+/** Reason that a prompt was blocked. */
+export declare const BlockReason: {
+    readonly SAFETY: "SAFETY";
+    readonly OTHER: "OTHER";
+    readonly BLOCKLIST: "BLOCKLIST";
+    readonly PROHIBITED_CONTENT: "PROHIBITED_CONTENT";
+};
+export type BlockReason = (typeof BlockReason)[keyof typeof BlockReason];
+/** Reason that a candidate run stopped generating tokens (19 values in 2.12.0). */
+export declare const FinishReason: {
+    readonly STOP: "STOP";
+    readonly MAX_TOKENS: "MAX_TOKENS";
+    readonly SAFETY: "SAFETY";
+    readonly RECITATION: "RECITATION";
+    readonly OTHER: "OTHER";
+    readonly BLOCKLIST: "BLOCKLIST";
+    readonly PROHIBITED_CONTENT: "PROHIBITED_CONTENT";
+    readonly SPII: "SPII";
+    readonly MALFORMED_FUNCTION_CALL: "MALFORMED_FUNCTION_CALL";
+    readonly IMAGE_SAFETY: "IMAGE_SAFETY";
+    readonly IMAGE_PROHIBITED_CONTENT: "IMAGE_PROHIBITED_CONTENT";
+    readonly IMAGE_OTHER: "IMAGE_OTHER";
+    readonly NO_IMAGE: "NO_IMAGE";
+    readonly IMAGE_RECITATION: "IMAGE_RECITATION";
+    readonly LANGUAGE: "LANGUAGE";
+    readonly UNEXPECTED_TOOL_CALL: "UNEXPECTED_TOOL_CALL";
+    readonly TOO_MANY_TOOL_CALLS: "TOO_MANY_TOOL_CALLS";
+    readonly MISSING_THOUGHT_SIGNATURE: "MISSING_THOUGHT_SIGNATURE";
+    readonly MALFORMED_RESPONSE: "MALFORMED_RESPONSE";
+};
+export type FinishReason = (typeof FinishReason)[keyof typeof FinishReason];
+/** How the model may call functions: default, forced call, or no calls. */
+export declare const FunctionCallingMode: {
+    readonly AUTO: "AUTO";
+    readonly ANY: "ANY";
+    readonly NONE: "NONE";
+};
+export type FunctionCallingMode = (typeof FunctionCallingMode)[keyof typeof FunctionCallingMode];
+/** Content part modality. */
+export declare const Modality: {
+    readonly MODALITY_UNSPECIFIED: "MODALITY_UNSPECIFIED";
+    readonly TEXT: "TEXT";
+    readonly IMAGE: "IMAGE";
+    readonly VIDEO: "VIDEO";
+    readonly AUDIO: "AUDIO";
+    readonly DOCUMENT: "DOCUMENT";
+};
+export type Modality = (typeof Modality)[keyof typeof Modality];
+/** Generation modalities in responses. */
+export declare const ResponseModality: {
+    readonly TEXT: "TEXT";
+    readonly IMAGE: "IMAGE";
+    readonly AUDIO: "AUDIO";
+};
+export type ResponseModality = (typeof ResponseModality)[keyof typeof ResponseModality];
+/** OpenAPI data types for `Schema`. */
+export declare const SchemaType: {
+    readonly STRING: "string";
+    readonly NUMBER: "number";
+    readonly INTEGER: "integer";
+    readonly BOOLEAN: "boolean";
+    readonly ARRAY: "array";
+    readonly OBJECT: "object";
+};
+export type SchemaType = (typeof SchemaType)[keyof typeof SchemaType];
+/** Preset controlling the thinking process of compatible models. */
+export declare const ThinkingLevel: {
+    readonly MINIMAL: "MINIMAL";
+    readonly LOW: "LOW";
+    readonly MEDIUM: "MEDIUM";
+    readonly HIGH: "HIGH";
+};
+export type ThinkingLevel = (typeof ThinkingLevel)[keyof typeof ThinkingLevel];
+/** Programming language of code the model executed. */
+export declare const Language: {
+    readonly UNSPECIFIED: "LANGUAGE_UNSPECIFIED";
+    readonly PYTHON: "PYTHON";
+};
+export type Language = (typeof Language)[keyof typeof Language];
+/** Result of code the model ran. */
+export declare const Outcome: {
+    readonly UNSPECIFIED: "OUTCOME_UNSPECIFIED";
+    readonly OK: "OUTCOME_OK";
+    readonly FAILED: "OUTCOME_FAILED";
+    readonly DEADLINE_EXCEEDED: "OUTCOME_DEADLINE_EXCEEDED";
+};
+export type Outcome = (typeof Outcome)[keyof typeof Outcome];
+/** Status of a URL retrieval. */
+export declare const URLRetrievalStatus: {
+    readonly URL_RETRIEVAL_STATUS_UNSPECIFIED: "URL_RETRIEVAL_STATUS_UNSPECIFIED";
+    readonly URL_RETRIEVAL_STATUS_SUCCESS: "URL_RETRIEVAL_STATUS_SUCCESS";
+    readonly URL_RETRIEVAL_STATUS_ERROR: "URL_RETRIEVAL_STATUS_ERROR";
+    readonly URL_RETRIEVAL_STATUS_PAYWALL: "URL_RETRIEVAL_STATUS_PAYWALL";
+    readonly URL_RETRIEVAL_STATUS_UNSAFE: "URL_RETRIEVAL_STATUS_UNSAFE";
+};
+export type URLRetrievalStatus = (typeof URLRetrievalStatus)[keyof typeof URLRetrievalStatus];
+/** Aspect ratios for Gemini image generation (`ImageConfig.aspectRatio`). */
+export declare const ImageConfigAspectRatio: {
+    readonly SQUARE_1x1: "1:1";
+    readonly PORTRAIT_9x16: "9:16";
+    readonly LANDSCAPE_16x9: "16:9";
+    readonly PORTRAIT_3x4: "3:4";
+    readonly LANDSCAPE_4x3: "4:3";
+    readonly PORTRAIT_2x3: "2:3";
+    readonly LANDSCAPE_3x2: "3:2";
+    readonly PORTRAIT_4x5: "4:5";
+    readonly LANDSCAPE_5x4: "5:4";
+    readonly PORTRAIT_1x4: "1:4";
+    readonly LANDSCAPE_4x1: "4:1";
+    readonly PORTRAIT_1x8: "1:8";
+    readonly LANDSCAPE_8x1: "8:1";
+    readonly ULTRAWIDE_21x9: "21:9";
+};
+export type ImageConfigAspectRatio = (typeof ImageConfigAspectRatio)[keyof typeof ImageConfigAspectRatio];
+/** Sizes for Gemini generated images (`ImageConfig.imageSize`). */
+export declare const ImageConfigImageSize: {
+    readonly SIZE_512: "512";
+    readonly SIZE_1K: "1K";
+    readonly SIZE_2K: "2K";
+    readonly SIZE_4K: "4K";
+};
+export type ImageConfigImageSize = (typeof ImageConfigImageSize)[keyof typeof ImageConfigImageSize];
+//# sourceMappingURL=enums.d.ts.map

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

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

package/dist/ai/enums.js

@@ -0,0 +1,155 @@
+/**
+ * `pyric/ai` const/type enum pairs — value sets copied VERBATIM from the
+ * installed `@firebase/ai@2.12.0` runtime bundle (the census universe; see
+ * packages/conformance/surfaces/ai.json). Each name is exported both as a
+ * const object and a type, matching the upstream `const X = {...} as const;
+ * type X = (typeof X)[keyof typeof X]` pattern.
+ */
+/** Possible roles (upstream `POSSIBLE_ROLES`). */
+export const POSSIBLE_ROLES = ['user', 'model', 'function', 'system'];
+/** Harm categories that would cause prompts or candidates to be blocked. */
+export const HarmCategory = {
+    HARM_CATEGORY_HATE_SPEECH: 'HARM_CATEGORY_HATE_SPEECH',
+    HARM_CATEGORY_SEXUALLY_EXPLICIT: 'HARM_CATEGORY_SEXUALLY_EXPLICIT',
+    HARM_CATEGORY_HARASSMENT: 'HARM_CATEGORY_HARASSMENT',
+    HARM_CATEGORY_DANGEROUS_CONTENT: 'HARM_CATEGORY_DANGEROUS_CONTENT',
+};
+/** Threshold above which a prompt or candidate will be blocked. */
+export const HarmBlockThreshold = {
+    BLOCK_LOW_AND_ABOVE: 'BLOCK_LOW_AND_ABOVE',
+    BLOCK_MEDIUM_AND_ABOVE: 'BLOCK_MEDIUM_AND_ABOVE',
+    BLOCK_ONLY_HIGH: 'BLOCK_ONLY_HIGH',
+    BLOCK_NONE: 'BLOCK_NONE',
+    OFF: 'OFF',
+};
+/** Probability-vs-severity blocking method (Vertex AI only). */
+export const HarmBlockMethod = {
+    SEVERITY: 'SEVERITY',
+    PROBABILITY: 'PROBABILITY',
+};
+/** Probability that a prompt or candidate matches a harm category. */
+export const HarmProbability = {
+    NEGLIGIBLE: 'NEGLIGIBLE',
+    LOW: 'LOW',
+    MEDIUM: 'MEDIUM',
+    HIGH: 'HIGH',
+};
+/** Harm severity levels (`UNSUPPORTED` is the GoogleAI fallback). */
+export const HarmSeverity = {
+    HARM_SEVERITY_NEGLIGIBLE: 'HARM_SEVERITY_NEGLIGIBLE',
+    HARM_SEVERITY_LOW: 'HARM_SEVERITY_LOW',
+    HARM_SEVERITY_MEDIUM: 'HARM_SEVERITY_MEDIUM',
+    HARM_SEVERITY_HIGH: 'HARM_SEVERITY_HIGH',
+    HARM_SEVERITY_UNSUPPORTED: 'HARM_SEVERITY_UNSUPPORTED',
+};
+/** Reason that a prompt was blocked. */
+export const BlockReason = {
+    SAFETY: 'SAFETY',
+    OTHER: 'OTHER',
+    BLOCKLIST: 'BLOCKLIST',
+    PROHIBITED_CONTENT: 'PROHIBITED_CONTENT',
+};
+/** Reason that a candidate run stopped generating tokens (19 values in 2.12.0). */
+export const FinishReason = {
+    STOP: 'STOP',
+    MAX_TOKENS: 'MAX_TOKENS',
+    SAFETY: 'SAFETY',
+    RECITATION: 'RECITATION',
+    OTHER: 'OTHER',
+    BLOCKLIST: 'BLOCKLIST',
+    PROHIBITED_CONTENT: 'PROHIBITED_CONTENT',
+    SPII: 'SPII',
+    MALFORMED_FUNCTION_CALL: 'MALFORMED_FUNCTION_CALL',
+    IMAGE_SAFETY: 'IMAGE_SAFETY',
+    IMAGE_PROHIBITED_CONTENT: 'IMAGE_PROHIBITED_CONTENT',
+    IMAGE_OTHER: 'IMAGE_OTHER',
+    NO_IMAGE: 'NO_IMAGE',
+    IMAGE_RECITATION: 'IMAGE_RECITATION',
+    LANGUAGE: 'LANGUAGE',
+    UNEXPECTED_TOOL_CALL: 'UNEXPECTED_TOOL_CALL',
+    TOO_MANY_TOOL_CALLS: 'TOO_MANY_TOOL_CALLS',
+    MISSING_THOUGHT_SIGNATURE: 'MISSING_THOUGHT_SIGNATURE',
+    MALFORMED_RESPONSE: 'MALFORMED_RESPONSE',
+};
+/** How the model may call functions: default, forced call, or no calls. */
+export const FunctionCallingMode = {
+    AUTO: 'AUTO',
+    ANY: 'ANY',
+    NONE: 'NONE',
+};
+/** Content part modality. */
+export const Modality = {
+    MODALITY_UNSPECIFIED: 'MODALITY_UNSPECIFIED',
+    TEXT: 'TEXT',
+    IMAGE: 'IMAGE',
+    VIDEO: 'VIDEO',
+    AUDIO: 'AUDIO',
+    DOCUMENT: 'DOCUMENT',
+};
+/** Generation modalities in responses. */
+export const ResponseModality = {
+    TEXT: 'TEXT',
+    IMAGE: 'IMAGE',
+    AUDIO: 'AUDIO',
+};
+/** OpenAPI data types for `Schema`. */
+export const SchemaType = {
+    STRING: 'string',
+    NUMBER: 'number',
+    INTEGER: 'integer',
+    BOOLEAN: 'boolean',
+    ARRAY: 'array',
+    OBJECT: 'object',
+};
+/** Preset controlling the thinking process of compatible models. */
+export const ThinkingLevel = {
+    MINIMAL: 'MINIMAL',
+    LOW: 'LOW',
+    MEDIUM: 'MEDIUM',
+    HIGH: 'HIGH',
+};
+/** Programming language of code the model executed. */
+export const Language = {
+    UNSPECIFIED: 'LANGUAGE_UNSPECIFIED',
+    PYTHON: 'PYTHON',
+};
+/** Result of code the model ran. */
+export const Outcome = {
+    UNSPECIFIED: 'OUTCOME_UNSPECIFIED',
+    OK: 'OUTCOME_OK',
+    FAILED: 'OUTCOME_FAILED',
+    DEADLINE_EXCEEDED: 'OUTCOME_DEADLINE_EXCEEDED',
+};
+/** Status of a URL retrieval. */
+export const URLRetrievalStatus = {
+    URL_RETRIEVAL_STATUS_UNSPECIFIED: 'URL_RETRIEVAL_STATUS_UNSPECIFIED',
+    URL_RETRIEVAL_STATUS_SUCCESS: 'URL_RETRIEVAL_STATUS_SUCCESS',
+    URL_RETRIEVAL_STATUS_ERROR: 'URL_RETRIEVAL_STATUS_ERROR',
+    URL_RETRIEVAL_STATUS_PAYWALL: 'URL_RETRIEVAL_STATUS_PAYWALL',
+    URL_RETRIEVAL_STATUS_UNSAFE: 'URL_RETRIEVAL_STATUS_UNSAFE',
+};
+/** Aspect ratios for Gemini image generation (`ImageConfig.aspectRatio`). */
+export const ImageConfigAspectRatio = {
+    SQUARE_1x1: '1:1',
+    PORTRAIT_9x16: '9:16',
+    LANDSCAPE_16x9: '16:9',
+    PORTRAIT_3x4: '3:4',
+    LANDSCAPE_4x3: '4:3',
+    PORTRAIT_2x3: '2:3',
+    LANDSCAPE_3x2: '3:2',
+    PORTRAIT_4x5: '4:5',
+    LANDSCAPE_5x4: '5:4',
+    PORTRAIT_1x4: '1:4',
+    LANDSCAPE_4x1: '4:1',
+    PORTRAIT_1x8: '1:8',
+    LANDSCAPE_8x1: '8:1',
+    ULTRAWIDE_21x9: '21:9',
+};
+/** Sizes for Gemini generated images (`ImageConfig.imageSize`). */
+export const ImageConfigImageSize = {
+    SIZE_512: '512',
+    SIZE_1K: '1K',
+    SIZE_2K: '2K',
+    SIZE_4K: '4K',
+};
+//# sourceMappingURL=enums.js.map

package/dist/ai/enums.js.map

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

package/dist/ai/errors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `pyric/ai` error surface — `AIError` / `AIErrorCode` mirroring the
+ * installed `@firebase/ai@2.12.0` shapes exactly, plus the ONE translation
+ * point from the broker's captured wire error envelopes
+ * ({@link AiBrokerError}) to the SDK-equivalent `AIError`.
+ *
+ * The installed SDK turns a non-ok HTTP response into
+ *   `AIError('fetch-error', 'Error fetching from <url>: [<status> <statusText>] <message>', { status, statusText, errorDetails })`
+ * with `message` growing ` ${JSON.stringify(details)}` when the envelope
+ * carries details (dist/index.node.mjs `makeRequest`). The sandbox mints the
+ * same error from the wire envelope, with a production-shaped URL.
+ */
+import { FirebaseError } from '../sandbox/internal/firebase-error.js';
+import { type WireErrorEnvelope } from './broker/index.js';
+/** Standardized error codes the SDK can throw — 14 codes in 2.12.0. */
+export declare const AIErrorCode: {
+    readonly ERROR: "error";
+    readonly REQUEST_ERROR: "request-error";
+    readonly RESPONSE_ERROR: "response-error";
+    readonly FETCH_ERROR: "fetch-error";
+    readonly SESSION_CLOSED: "session-closed";
+    readonly INVALID_CONTENT: "invalid-content";
+    readonly API_NOT_ENABLED: "api-not-enabled";
+    readonly INVALID_SCHEMA: "invalid-schema";
+    readonly NO_API_KEY: "no-api-key";
+    readonly NO_APP_ID: "no-app-id";
+    readonly NO_MODEL: "no-model";
+    readonly NO_PROJECT_ID: "no-project-id";
+    readonly PARSE_FAILED: "parse-failed";
+    readonly UNSUPPORTED: "unsupported";
+};
+export type AIErrorCode = (typeof AIErrorCode)[keyof typeof AIErrorCode];
+/** Data from a bad HTTP response (upstream `CustomErrorData` shape). */
+export interface CustomErrorData {
+    status?: number;
+    statusText?: string;
+    response?: unknown;
+    errorDetails?: Array<Record<string, unknown>>;
+}
+/**
+ * Error class for the AI mirror — constructor and message format copied
+ * from the installed SDK: `AI: <message> (AI/<code>)`, `code` set to the
+ * short code, `customErrorData` carried through.
+ */
+export declare class AIError extends FirebaseError {
+    readonly code: AIErrorCode;
+    readonly customErrorData?: CustomErrorData;
+    constructor(code: AIErrorCode, message: string, customErrorData?: CustomErrorData);
+}
+/** Minimal HTTP status text table for the statuses the sandbox mints. */
+export declare function statusTextOf(status: number): string;
+/**
+ * Production-shaped request URL for sandbox-minted fetch errors. There is no
+ * real project behind the sandbox; the path is deterministic and mirrors the
+ * GoogleAI backend's `/v1beta/projects/<project>/models/<model>:<op>` shape.
+ */
+export declare function sandboxRequestUrl(modelResource: string, op: string): string;
+/**
+ * Translate a broker wire error envelope into the SDK-equivalent
+ * `AIError('fetch-error', ...)` — the exact decoration `makeRequest` applies
+ * to a non-ok response in the installed 2.12.0.
+ */
+export declare function aiErrorFromEnvelope(envelope: WireErrorEnvelope, modelResource: string, op: string): AIError;
+/** Rethrow broker errors as SDK errors; pass anything else through. */
+export declare function toAIError(err: unknown, modelResource: string, op: string): unknown;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ai/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI1E,uEAAuE;AACvE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;CAed,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,qBAAa,OAAQ,SAAQ,aAAa;IACxC,SAAkB,IAAI,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;gBAE/B,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,eAAe;CAYlF;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAeT;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAKlF"}