@mochabug/adapt-sdk 0.4.2 → 0.4.5

package/dist/gemini/index.d.ts

@@ -1,4 +1,5 @@
 import type { JTDSchemaJson, SignalDescriptorJson } from '../api';
+import { type ConvertSuccessJson, type ConvertSuccessBinary, type ConvertSuccessSignals, type ConvertFailure, type ConvertSuccess } from '../schema-utils';
 /**
  * JSON Schema subset accepted by the Gemini structured-output API.
  *
@@ -21,54 +22,7 @@ export interface GeminiSchema {
     minimum?: number;
     maximum?: number;
 }
-/**
- * Successful conversion result for a JTD format.
- *
- * Returned when the raw LLM output has been coerced to match the JTD schema
- * and passes JTD validation. `data` contains the deserialized, coerced, and
- * JTD-validated JSON value.
- */
-export interface ConvertSuccessJson {
-    success: true;
-    kind: 'json';
-    /** The deserialized, coerced, and JTD-validated JSON value. */
-    data: unknown;
-}
-/**
- * Successful conversion result for a MIME (binary) format.
- *
- * Returned when the raw LLM output matches a MIME format. The base64 string
- * produced by the model is decoded into raw binary bytes.
- */
-export interface ConvertSuccessBinary {
-    success: true;
-    kind: 'binary';
-    /** The concrete MIME type of the binary content (e.g. `"image/png"`). */
-    mimeType: string;
-    /** The raw binary data decoded from the base64 string returned by the LLM. */
-    data: Uint8Array;
-    /** Optional filename, provided by the caller if available. */
-    filename?: string;
-}
-/**
- * Failed conversion result.
- *
- * `errors` contains one or more human-readable strings describing validation
- * or coercion failures. Each entry uses a JSON Pointer path prefix
- * (e.g. `"/foo/bar: ..."`) to locate the problem within the data.
- */
-export interface ConvertFailure {
-    success: false;
-    /** Array of human-readable error messages with JSON Pointer path prefixes. */
-    errors: string[];
-}
-/**
- * Discriminated union of conversion outcomes.
- *
- * Check `success` first, then narrow on `kind` (`'json'` or `'binary'`)
- * for successful results.
- */
-export type ConvertResult = ConvertSuccessJson | ConvertSuccessBinary | ConvertFailure;
+export type { ConvertSuccessJson, ConvertSuccessBinary, ConvertSuccessSignals, ConvertFailure, ConvertSuccess, ConvertResult } from '../schema-utils';
 /**
  * Converts JTD schemas or Adapt signal descriptors into Gemini-compatible
  * JSON Schema, and converts raw LLM output back into validated data.
@@ -110,7 +64,7 @@ export type ConvertResult = ConvertSuccessJson | ConvertSuccessBinary | ConvertF
  * const restored = GeminiConversion.fromJSON(cached);
  * ```
  */
-export declare class GeminiConversion {
+export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess> {
     /** The Gemini-specific JSON Schema to pass to the Gemini API as the response schema. */
     readonly schema: GeminiSchema;
     /**
@@ -123,6 +77,11 @@ export declare class GeminiConversion {
      * Set when created via {@link fromSignal}; `undefined` when created via {@link fromJTD}.
      */
     readonly descriptor?: SignalDescriptorJson;
+    /**
+     * The original signal descriptors used to build this conversion.
+     * Set when created via {@link fromSignals}; `undefined` otherwise.
+     */
+    readonly descriptors?: SignalDescriptorJson[];
     /**
      * Build a conversion from a JTD schema.
      *
@@ -135,7 +94,7 @@ export declare class GeminiConversion {
      * @throws If the schema contains an unknown JTD type, an unresolved `ref`,
      *         or circular / excessively deep refs (exceeding 32 levels).
      */
-    static fromJTD(jtdSchema: JTDSchemaJson): GeminiConversion;
+    static fromJTD(jtdSchema: JTDSchemaJson): GeminiConversion<ConvertSuccessJson>;
     /**
      * Build a conversion from an Adapt signal descriptor.
      *
@@ -149,7 +108,33 @@ export declare class GeminiConversion {
      * @throws If the descriptor has no formats, or a format has neither
      *         `jtdSchema` nor `mimeType`.
      */
-    static fromSignal(descriptor: SignalDescriptorJson): GeminiConversion;
+    static fromSignal(descriptor: SignalDescriptorJson): GeminiConversion<ConvertSuccessJson | ConvertSuccessBinary>;
+    /**
+     * Build a conversion from multiple signal descriptors.
+     *
+     * Produces an object schema with one property per signal, suitable for
+     * use as structured output parameters. Each signal's schema is built via
+     * {@link fromSignal} internally.
+     *
+     * Optional signals are omitted from `required` (Gemini does not use the
+     * required+nullable pattern).
+     *
+     * Receiver/transceiver compatible:
+     * ```ts
+     * const conv = GeminiConversion.fromSignals(
+     *   receiver.signals!,
+     *   receiver.description,
+     *   receiver.name
+     * );
+     * ```
+     *
+     * @param signals - Array of signal descriptors.
+     * @param description - Optional description for the compound schema.
+     * @param label - Optional label (mapped to `title` on the schema).
+     * @returns A new {@link GeminiConversion} with `descriptors` set.
+     * @throws If any signal has no formats or an invalid format.
+     */
+    static fromSignals(signals: SignalDescriptorJson[], description?: string, label?: string): GeminiConversion<ConvertSuccessSignals>;
     /**
      * Restore a {@link GeminiConversion} from its serialized form.
      *
@@ -182,7 +167,7 @@ export declare class GeminiConversion {
      * @param json - The raw value returned by the Gemini API (typically parsed JSON).
      * @returns A {@link ConvertResult} indicating success or failure with errors.
      */
-    convert: (json: unknown) => ConvertResult;
+    convert: (json: unknown) => T | ConvertFailure;
     /**
      * Produce a JSON-serializable representation of this conversion.
      *
@@ -192,15 +177,7 @@ export declare class GeminiConversion {
      *
      * Called automatically by `JSON.stringify(conv)`.
      */
-    toJSON(): {
-        schema: GeminiSchema;
-        descriptor: SignalDescriptorJson;
-        jtdSchema?: undefined;
-    } | {
-        schema: GeminiSchema;
-        jtdSchema: JTDSchemaJson | undefined;
-        descriptor?: undefined;
-    };
+    toJSON(): Record<string, unknown>;
 }
 /**
  * Convenience alias for {@link GeminiConversion.fromJTD}.
@@ -208,12 +185,12 @@ export declare class GeminiConversion {
  * @param jtdSchema - A valid JTD schema (RFC 8927).
  * @returns A new {@link GeminiConversion}.
  */
-export declare function convertToGeminiSchema(jtdSchema: JTDSchemaJson): GeminiConversion;
+export declare function convertToGeminiSchema(jtdSchema: JTDSchemaJson): GeminiConversion<ConvertSuccessJson>;
 /**
  * Convenience alias for {@link GeminiConversion.fromSignal}.
  *
  * @param descriptor - An Adapt signal descriptor.
  * @returns A new {@link GeminiConversion}.
  */
-export declare function convertSignalToGeminiSchema(descriptor: SignalDescriptorJson): GeminiConversion;
+export declare function convertSignalToGeminiSchema(descriptor: SignalDescriptorJson): GeminiConversion<ConvertSuccessJson | ConvertSuccessBinary>;
 //# sourceMappingURL=index.d.ts.map

package/dist/gemini/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gemini/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAErB,MAAM,QAAQ,CAAC;AAOhB;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,IAAI,EAAE,UAAU,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,CAAC;AA0TnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,gBAAgB;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAI3C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,gBAAgB;IAK1D;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,oBAAoB,GAAG,gBAAgB;IAKrE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAezE,OAAO;IAYP;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,GAAI,MAAM,OAAO,KAAG,aAAa,CAQtC;IAIF;;;;;;;;OAQG;IACH,MAAM;;;;;;;;;CAMP;AA4KD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,GACvB,gBAAgB,CAElB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,oBAAoB,GAC/B,gBAAgB,CAElB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gemini/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAErB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAMzB;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAsStJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IACrE,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAI9C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CACZ,SAAS,EAAE,aAAa,GACvB,gBAAgB,CAAC,kBAAkB,CAAC;IAKvC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAU,CACf,UAAU,EAAE,oBAAoB,GAC/B,gBAAgB,CAAC,kBAAkB,GAAG,oBAAoB,CAAC;IAK9D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,oBAAoB,EAAE,EAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,gBAAgB,CAAC,qBAAqB,CAAC;IAuB1C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAwBzE,OAAO;IAcP;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,GAAI,MAAM,OAAO,KAAG,CAAC,GAAG,cAAc,CAW3C;IAIF;;;;;;;;OAQG;IACH,MAAM;CAeP;AA2ED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,GACvB,gBAAgB,CAAC,kBAAkB,CAAC,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,oBAAoB,GAC/B,gBAAgB,CAAC,kBAAkB,GAAG,oBAAoB,CAAC,CAE7D"}

package/dist/multi-format-regression.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=multi-format-regression.test.d.ts.map

package/dist/multi-format-regression.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-format-regression.test.d.ts","sourceRoot":"","sources":["../src/multi-format-regression.test.ts"],"names":[],"mappings":""}

package/dist/openai/index.d.ts

@@ -1,4 +1,5 @@
 import type { JTDSchemaJson, SignalDescriptorJson } from '../api';
+import { type ConvertSuccessJson, type ConvertSuccessBinary, type ConvertSuccessSignals, type ConvertFailure, type ConvertSuccess } from '../schema-utils';
 /**
  * JSON Schema subset accepted by the OpenAI structured-output API (strict mode).
  *
@@ -23,54 +24,7 @@ export interface OpenAISchema {
     $defs?: Record<string, OpenAISchema>;
     $ref?: string;
 }
-/**
- * Successful conversion result for a JTD format.
- *
- * Returned when the raw LLM output has been coerced to match the JTD schema
- * and passes JTD validation. `data` contains the deserialized, coerced, and
- * JTD-validated JSON value.
- */
-export interface ConvertSuccessJson {
-    success: true;
-    kind: 'json';
-    /** The deserialized, coerced, and JTD-validated JSON value. */
-    data: unknown;
-}
-/**
- * Successful conversion result for a MIME (binary) format.
- *
- * Returned when the raw LLM output matches a MIME format. The base64 string
- * produced by the model is decoded into raw binary bytes.
- */
-export interface ConvertSuccessBinary {
-    success: true;
-    kind: 'binary';
-    /** The concrete MIME type of the binary content (e.g. `"image/png"`). */
-    mimeType: string;
-    /** The raw binary data decoded from the base64 string returned by the LLM. */
-    data: Uint8Array;
-    /** Optional filename, provided by the caller if available. */
-    filename?: string;
-}
-/**
- * Failed conversion result.
- *
- * `errors` contains one or more human-readable strings describing validation
- * or coercion failures. Each entry uses a JSON Pointer path prefix
- * (e.g. `"/foo/bar: ..."`) to locate the problem within the data.
- */
-export interface ConvertFailure {
-    success: false;
-    /** Array of human-readable error messages with JSON Pointer path prefixes. */
-    errors: string[];
-}
-/**
- * Discriminated union of conversion outcomes.
- *
- * Check `success` first, then narrow on `kind` (`'json'` or `'binary'`)
- * for successful results.
- */
-export type ConvertResult = ConvertSuccessJson | ConvertSuccessBinary | ConvertFailure;
+export type { ConvertSuccessJson, ConvertSuccessBinary, ConvertSuccessSignals, ConvertFailure, ConvertSuccess, ConvertResult, } from '../schema-utils';
 /**
  * Converts JTD schemas or Adapt signal descriptors into OpenAI-compatible
  * JSON Schema (strict mode), and converts raw LLM output back into
@@ -123,7 +77,7 @@ export type ConvertResult = ConvertSuccessJson | ConvertSuccessBinary | ConvertF
  * const restored = OpenAIConversion.fromJSON(cached);
  * ```
  */
-export declare class OpenAIConversion {
+export declare class OpenAIConversion<T extends ConvertSuccess = ConvertSuccess> {
     /** The OpenAI-specific JSON Schema to pass to the OpenAI API as the response format. */
     readonly schema: OpenAISchema;
     /**
@@ -145,6 +99,11 @@ export declare class OpenAIConversion {
      * Set when created via {@link fromSignal}; `undefined` when created via {@link fromJTD}.
      */
     readonly descriptor?: SignalDescriptorJson;
+    /**
+     * The original signal descriptors used to build this conversion.
+     * Set when created via {@link fromSignals}; `undefined` otherwise.
+     */
+    readonly descriptors?: SignalDescriptorJson[];
     /**
      * Build a conversion from a JTD schema.
      *
@@ -160,7 +119,7 @@ export declare class OpenAIConversion {
      * @throws If the schema contains an unknown JTD type, an unresolved `ref`,
      *         or nesting exceeding 32 levels.
      */
-    static fromJTD(jtdSchema: JTDSchemaJson): OpenAIConversion;
+    static fromJTD(jtdSchema: JTDSchemaJson): OpenAIConversion<ConvertSuccessJson>;
     /**
      * Build a conversion from an Adapt signal descriptor.
      *
@@ -175,18 +134,48 @@ export declare class OpenAIConversion {
      * @throws If the descriptor has no formats, or a format has neither
      *         `jtdSchema` nor `mimeType`.
      */
-    static fromSignal(descriptor: SignalDescriptorJson): OpenAIConversion;
+    static fromSignal(descriptor: SignalDescriptorJson, sharedDefs?: Record<string, JTDSchemaJson>): OpenAIConversion<ConvertSuccessJson | ConvertSuccessBinary>;
+    /**
+     * Build a conversion from multiple signal descriptors.
+     *
+     * Produces an object schema with one property per signal, suitable for
+     * use as structured output parameters. Each signal's schema is built via
+     * {@link fromSignal} internally.
+     *
+     * For OpenAI strict mode, optional signals are made nullable and all
+     * properties are added to `required`.
+     *
+     * If there is only one signal with a single format, the schema is
+     * unwrapped to avoid unnecessary nesting — the signal's format schema
+     * is used directly as the object property value.
+     *
+     * Receiver/transceiver compatible:
+     * ```ts
+     * const conv = OpenAIConversion.fromSignals(
+     *   receiver.signals!,
+     *   receiver.description,
+     *   receiver.name
+     * );
+     * ```
+     *
+     * @param signals - Array of signal descriptors.
+     * @param description - Optional description for the compound schema.
+     * @param label - Optional label (not used by OpenAI, reserved for other providers).
+     * @returns A new {@link OpenAIConversion} with `descriptors` set.
+     * @throws If any signal has no formats or an invalid format.
+     */
+    static fromSignals(signals: SignalDescriptorJson[], description?: string, label?: string): OpenAIConversion<ConvertSuccessSignals>;
     /**
      * Restore an {@link OpenAIConversion} from its serialized form.
      *
      * Accepts either the JSON string produced by `JSON.stringify(conv)` or the
-     * already-parsed plain object. The original `jtdSchema` or `descriptor` is
-     * re-processed through the corresponding factory, so the restored instance
-     * is fully functional.
+     * already-parsed plain object. The original `jtdSchema`, `descriptor`, or
+     * `descriptors` is re-processed through the corresponding factory, so the
+     * restored instance is fully functional.
      *
      * @param data - A JSON string or parsed object previously produced by {@link toJSON}.
      * @returns A fully reconstructed {@link OpenAIConversion}.
-     * @throws If the serialized data contains neither `jtdSchema` nor `descriptor`.
+     * @throws If the serialized data contains neither `jtdSchema`, `descriptor`, nor `descriptors`.
      */
     static fromJSON(data: string | Record<string, unknown>): OpenAIConversion;
     private constructor();
@@ -213,7 +202,7 @@ export declare class OpenAIConversion {
      * @param json - The raw value returned by the OpenAI API (typically parsed JSON).
      * @returns A {@link ConvertResult} indicating success or failure with errors.
      */
-    convert: (json: unknown) => ConvertResult;
+    convert: (json: unknown) => T | ConvertFailure;
     /**
      * Produce a JSON-serializable representation of this conversion.
      *
@@ -224,17 +213,7 @@ export declare class OpenAIConversion {
      *
      * Called automatically by `JSON.stringify(conv)`.
      */
-    toJSON(): {
-        schema: OpenAISchema;
-        strict: boolean;
-        descriptor: SignalDescriptorJson;
-        jtdSchema?: undefined;
-    } | {
-        schema: OpenAISchema;
-        strict: boolean;
-        jtdSchema: JTDSchemaJson | undefined;
-        descriptor?: undefined;
-    };
+    toJSON(): Record<string, unknown>;
 }
 /**
  * Convenience alias for {@link OpenAIConversion.fromJTD}.

package/dist/openai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openai/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAErB,MAAM,QAAQ,CAAC;AAOhB;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,KAAK,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,IAAI,EAAE,UAAU,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,CAAC;AA0jBnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,gBAAgB;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAI3C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,gBAAgB;IAyB1D;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,oBAAoB,GAAG,gBAAgB;IAKrE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAezE,OAAO;IAcP;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,GAAI,MAAM,OAAO,KAAG,aAAa,CAQtC;IAIF;;;;;;;;;OASG;IACH,MAAM;;;;;;;;;;;CAcP;AAqMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,GACvB,gBAAgB,CAElB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,oBAAoB,GAC/B,gBAAgB,CAElB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openai/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAErB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAcL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAOzB;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,KAAK,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+dzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IACrE,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAI9C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CACZ,SAAS,EAAE,aAAa,GACvB,gBAAgB,CAAC,kBAAkB,CAAC;IAyBvC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,UAAU,CACf,UAAU,EAAE,oBAAoB,EAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACzC,gBAAgB,CAAC,kBAAkB,GAAG,oBAAoB,CAAC;IAK9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,oBAAoB,EAAE,EAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,gBAAgB,CAAC,qBAAqB,CAAC;IAyD1C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAwBzE,OAAO;IAgBP;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,GAAI,MAAM,OAAO,KAAG,CAAC,GAAG,cAAc,CAW3C;IAIF;;;;;;;;;OASG;IACH,MAAM;CAuBP;AAsHD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,GACvB,gBAAgB,CAElB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,oBAAoB,GAC/B,gBAAgB,CAElB"}

package/dist/openai/openai-roundtrip.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openai-roundtrip.test.d.ts.map

package/dist/openai/openai-roundtrip.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-roundtrip.test.d.ts","sourceRoot":"","sources":["../../src/openai/openai-roundtrip.test.ts"],"names":[],"mappings":""}

package/dist/openai/openai.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openai.test.d.ts.map

package/dist/openai/openai.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.test.d.ts","sourceRoot":"","sources":["../../src/openai/openai.test.ts"],"names":[],"mappings":""}

package/dist/router/router.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=router.spec.d.ts.map

package/dist/router/router.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.spec.d.ts","sourceRoot":"","sources":["../../src/router/router.spec.ts"],"names":[],"mappings":""}

package/dist/schema-utils.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared utilities for JSON Schema providers (OpenAI, Anthropic, Gemini).
+ *
+ * Contains constants, types, convert output pipeline, definition pooling,
+ * and schema inspection helpers used identically across providers.
+ */
+import type { JTDSchemaJson, SignalDescriptorJson, SignalFormatJson } from './api';
+export declare const MAX_REF_DEPTH = 32;
+export declare const INTEGER_BOUNDS: Record<string, {
+    minimum: number;
+    maximum: number;
+}>;
+export declare const FLOAT32_BOUNDS: {
+    minimum: number;
+    maximum: number;
+};
+export declare const UNSTRUCTURED_DESC: string;
+export declare const UNSTRUCTURED_VARIANT_DESC: string;
+export declare const VALUES_ARRAY_DESC: string;
+export declare function nullableType(baseType: string, nullable: boolean): string | string[];
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+export declare function isUnstructuredSchema(schema: JTDSchemaJson): boolean;
+export declare function isRootUnstructured(schema: JTDSchemaJson, defs: Record<string, JTDSchemaJson> | undefined): boolean;
+export interface ConvertSuccessJson {
+    success: true;
+    kind: 'json';
+    data: unknown;
+}
+export interface ConvertSuccessBinary {
+    success: true;
+    kind: 'binary';
+    mimeType: string;
+    data: Uint8Array;
+    filename?: string;
+}
+export interface ConvertSuccessSignals {
+    success: true;
+    kind: 'signals';
+    signals: Record<string, unknown>;
+}
+export interface ConvertFailure {
+    success: false;
+    errors: string[];
+}
+export type ConvertSuccess = ConvertSuccessJson | ConvertSuccessBinary | ConvertSuccessSignals;
+export type ConvertResult = ConvertSuccess | ConvertFailure;
+export declare function convertJTDOutput(jtdSchema: JTDSchemaJson, json: unknown, coerce: (value: unknown, schema: JTDSchemaJson, defs: Record<string, JTDSchemaJson> | undefined, depth: number) => unknown): ConvertResult;
+export declare function convertMimeOutput(mimeType: string, json: unknown): ConvertResult;
+export declare function convertSingleFormatOutput(fmt: SignalFormatJson, json: unknown, coerce: (value: unknown, schema: JTDSchemaJson, defs: Record<string, JTDSchemaJson> | undefined, depth: number) => unknown): ConvertResult;
+export declare function convertSignalOutput(descriptor: SignalDescriptorJson, json: unknown, coerce: (value: unknown, schema: JTDSchemaJson, defs: Record<string, JTDSchemaJson> | undefined, depth: number) => unknown): ConvertResult;
+export declare function convertSignalsOutput(descriptors: SignalDescriptorJson[], json: unknown, coerce: (value: unknown, schema: JTDSchemaJson, defs: Record<string, JTDSchemaJson> | undefined, depth: number) => unknown): ConvertResult;
+/** Minimal shape for $ref-bearing schemas (satisfied by OpenAISchema and AnthropicSchema). */
+interface RefNode {
+    properties?: Record<string, RefNode>;
+    items?: RefNode;
+    anyOf?: RefNode[];
+    $defs?: Record<string, RefNode>;
+    $ref?: string;
+}
+export declare function walkSchema<T extends RefNode>(schema: T, fn: (node: T) => void): void;
+/**
+ * Pre-scan all signal descriptors, pool their JTD definitions.
+ * Deduplicates identical definition SETS; renames conflicts with `_N` suffix.
+ *
+ * Equivalence is checked per-format: all definitions within a single format's
+ * `definitions` block are treated as a unit. Two formats with the same set of
+ * definition names and identical schemas (deep-equal) share their defs.
+ * If ANY definition name conflicts (same name, different schema), ALL defs
+ * from that format get their own namespace to preserve internal cross-references.
+ *
+ * Returns the merged JTD definitions and signal copies with:
+ * - refs rewritten to match merged names
+ * - definitions stripped (they live in the merged pool now)
+ */
+export declare function poolSignalDefinitions(signals: SignalDescriptorJson[]): {
+    mergedDefs: Record<string, JTDSchemaJson>;
+    signalsCopy: SignalDescriptorJson[];
+};
+export {};
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/schema-utils.d.ts.map

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

package/dist/schema-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-utils.test.d.ts.map

package/dist/schema-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.test.d.ts","sourceRoot":"","sources":["../src/schema-utils.test.ts"],"names":[],"mappings":""}

package/dist/signals/signals.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signals.test.d.ts.map

package/dist/signals/signals.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.test.d.ts","sourceRoot":"","sources":["../../src/signals/signals.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mochabug/adapt-sdk",
-  "version": "0.4.2",
+  "version": "0.4.5",
   "description": "The API toolkit to facilitate mochabug adapt plugin development",
   "publishConfig": {
     "access": "public"