@mochabug/adapt-sdk 0.4.6 → 0.4.9

package/dist/gemini/index.d.ts

@@ -1,5 +1,5 @@
 import type { JTDSchemaJson, SignalDescriptorJson } from '../api';
-import { type ConvertSuccessJson, type ConvertSuccessBinary, type ConvertSuccessSignals, type ConvertFailure, type ConvertSuccess } from '../schema-utils';
+import { type ConvertFailure, type ConvertSuccess, type ConvertSuccessBinary, type ConvertSuccessJson, type ConvertSuccessSignals } from '../schema-utils';
 /**
  * JSON Schema subset accepted by the Gemini structured-output API.
  *
@@ -11,6 +11,7 @@ import { type ConvertSuccessJson, type ConvertSuccessBinary, type ConvertSuccess
  */
 export interface GeminiSchema {
     type?: string | string[];
+    nullable?: boolean;
     title?: string;
     description?: string;
     properties?: Record<string, GeminiSchema>;
@@ -21,8 +22,38 @@ export interface GeminiSchema {
     items?: GeminiSchema;
     minimum?: number;
     maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    anyOf?: GeminiSchema[];
 }
-export type { ConvertSuccessJson, ConvertSuccessBinary, ConvertSuccessSignals, ConvertFailure, ConvertSuccess, ConvertResult } from '../schema-utils';
+/**
+ * Schema subset matching the Gemini v1beta Schema protobuf message.
+ * Used for function calling `parameters` field in `FunctionDeclaration`.
+ *
+ * Key differences from {@link GeminiSchema}:
+ * - `type` is always a single string (no type arrays)
+ * - Uses `nullable: true` instead of `["type", "null"]` type arrays
+ * - Does NOT include `additionalProperties`
+ * - Supports `anyOf` for discriminator unions
+ * - Supports `minItems`/`maxItems` for array bounds
+ */
+export interface GeminiFCSchema {
+    type?: string;
+    nullable?: boolean;
+    title?: string;
+    description?: string;
+    properties?: Record<string, GeminiFCSchema>;
+    required?: string[];
+    enum?: string[];
+    format?: string;
+    items?: GeminiFCSchema;
+    minimum?: number;
+    maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    anyOf?: GeminiFCSchema[];
+}
+export type { ConvertFailure, ConvertResult, ConvertSuccess, ConvertSuccessBinary, ConvertSuccessJson, ConvertSuccessSignals } from '../schema-utils';
 /**
  * Converts JTD schemas or Adapt signal descriptors into Gemini-compatible
  * JSON Schema, and converts raw LLM output back into validated data.
@@ -55,16 +86,16 @@ export type { ConvertSuccessJson, ConvertSuccessBinary, ConvertSuccessSignals, C
  * serialized form (string or parsed object).
  *
  * ```ts
- * const conv = GeminiConversion.fromJTD(jtdSchema);
+ * const conv = GeminiStructuredOutputConversion.fromJTD(jtdSchema);
  * conv.schema;           // Gemini JSON Schema to pass to the LLM
  * conv.convert(output);  // coerce + validate -> ConvertResult
  *
  * // Serialize & restore
  * const cached = JSON.stringify(conv);
- * const restored = GeminiConversion.fromJSON(cached);
+ * const restored = GeminiStructuredOutputConversion.fromJSON(cached);
  * ```
  */
-export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess> {
+export declare class GeminiStructuredOutputConversion<T extends ConvertSuccess = ConvertSuccess> {
     /** The Gemini-specific JSON Schema to pass to the Gemini API as the response schema. */
     readonly schema: GeminiSchema;
     /**
@@ -90,11 +121,11 @@ export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess>
      * Gemini does not support `$ref`.
      *
      * @param jtdSchema - A valid JTD schema (RFC 8927).
-     * @returns A new {@link GeminiConversion} with `jtdSchema` set.
+     * @returns A new {@link GeminiStructuredOutputConversion} with `jtdSchema` set.
      * @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<ConvertSuccessJson>;
+    static fromJTD(jtdSchema: JTDSchemaJson): GeminiStructuredOutputConversion<ConvertSuccessJson>;
     /**
      * Build a conversion from an Adapt signal descriptor.
      *
@@ -104,11 +135,11 @@ export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess>
      * populate exactly one. MIME formats become base64 string schemas.
      *
      * @param descriptor - An Adapt signal descriptor with one or more formats.
-     * @returns A new {@link GeminiConversion} with `descriptor` set.
+     * @returns A new {@link GeminiStructuredOutputConversion} with `descriptor` set.
      * @throws If the descriptor has no formats, or a format has neither
      *         `jtdSchema` nor `mimeType`.
      */
-    static fromSignal(descriptor: SignalDescriptorJson): GeminiConversion<ConvertSuccessJson | ConvertSuccessBinary>;
+    static fromSignal(descriptor: SignalDescriptorJson): GeminiStructuredOutputConversion<ConvertSuccessJson | ConvertSuccessBinary>;
     /**
      * Build a conversion from multiple signal descriptors.
      *
@@ -121,7 +152,7 @@ export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess>
      *
      * Receiver/transceiver compatible:
      * ```ts
-     * const conv = GeminiConversion.fromSignals(
+     * const conv = GeminiStructuredOutputConversion.fromSignals(
      *   receiver.signals!,
      *   receiver.description,
      *   receiver.name
@@ -131,12 +162,12 @@ export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess>
      * @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.
+     * @returns A new {@link GeminiStructuredOutputConversion} with `descriptors` set.
      * @throws If any signal has no formats or an invalid format.
      */
-    static fromSignals(signals: SignalDescriptorJson[], description?: string, label?: string): GeminiConversion<ConvertSuccessSignals>;
+    static fromSignals(signals: SignalDescriptorJson[], description?: string, label?: string): GeminiStructuredOutputConversion<ConvertSuccessSignals>;
     /**
-     * Restore a {@link GeminiConversion} from its serialized form.
+     * Restore a {@link GeminiStructuredOutputConversion} 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
@@ -144,10 +175,10 @@ export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess>
      * is fully functional.
      *
      * @param data - A JSON string or parsed object previously produced by {@link toJSON}.
-     * @returns A fully reconstructed {@link GeminiConversion}.
+     * @returns A fully reconstructed {@link GeminiStructuredOutputConversion}.
      * @throws If the serialized data contains neither `jtdSchema` nor `descriptor`.
      */
-    static fromJSON(data: string | Record<string, unknown>): GeminiConversion;
+    static fromJSON(data: string | Record<string, unknown>): GeminiStructuredOutputConversion;
     private constructor();
     /**
      * Convert raw LLM output into a validated result.
@@ -180,17 +211,191 @@ export declare class GeminiConversion<T extends ConvertSuccess = ConvertSuccess>
     toJSON(): Record<string, unknown>;
 }
 /**
- * Convenience alias for {@link GeminiConversion.fromJTD}.
+ * Converts JTD schemas or Adapt signal descriptors into Gemini v1beta Schema
+ * protobuf-compatible schemas for use with function calling `parameters`.
+ *
+ * ### Differences from {@link GeminiStructuredOutputConversion}
+ * - Uses `nullable: true` instead of `["type", "null"]` type arrays
+ * - Does NOT emit `additionalProperties`
+ * - Uses `anyOf` for discriminator unions instead of wrapper objects
+ * - Uses key-value array pattern for `values` form (maps/dictionaries)
+ * - Unstructured/empty schemas are encoded as JSON strings
+ *
+ * ### JTD form mapping
+ * - **type** -- mapped to the corresponding JSON Schema `type` with
+ *   `minimum`/`maximum` for integers, `format: "date-time"` for timestamps.
+ * - **enum** -- mapped to `type: "string"` with an `enum` array.
+ * - **elements** -- mapped to `type: "array"` with `items`.
+ * - **properties / optionalProperties** -- mapped to `type: "object"` with
+ * - **values** -- mapped to `type: "array"` with items of
+ *   `{key: string, value: ...}` objects (key-value array pattern).
+ * - **discriminator** -- mapped to `anyOf` with single-value `enum` for the
+ *   discriminator tag on each variant.
+ * - **empty / unstructured** -- mapped to `type: "string"` with a description
+ *   requesting JSON-encoded content.
+ *
+ * ### MIME formats
+ * MIME signal formats become `type: "object"` with `data` and `filename`
+ * properties (same as structured output). On {@link convert}, the base64
+ * string is decoded into a {@link ConvertSuccessBinary} result.
+ *
+ * ### Serialization
+ * `JSON.stringify(conv)` produces a JSON-safe object via {@link toJSON}.
+ * The serialized form includes `mode: 'fc'` to distinguish it from
+ * {@link GeminiStructuredOutputConversion} during deserialization.
+ *
+ * ```ts
+ * const conv = GeminiFunctionCallingConversion.fromJTD(jtdSchema);
+ * conv.schema;           // FC-compatible schema for FunctionDeclaration.parameters
+ * conv.convert(output);  // coerce + validate -> ConvertResult
+ *
+ * // Serialize & restore
+ * const cached = JSON.stringify(conv);
+ * const restored = GeminiFunctionCallingConversion.fromJSON(cached);
+ * ```
+ */
+export declare class GeminiFunctionCallingConversion<T extends ConvertSuccess = ConvertSuccess> {
+    /** The FC-specific schema to pass as `parameters` in a `FunctionDeclaration`. */
+    readonly schema: GeminiFCSchema;
+    /**
+     * The original JTD schema used to build this conversion.
+     * Set when created via {@link fromJTD}; `undefined` when created via {@link fromSignal}.
+     */
+    readonly jtdSchema?: JTDSchemaJson;
+    /**
+     * The original signal descriptor used to build this conversion.
+     * 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.
+     *
+     * Recursively converts every JTD form into the equivalent Gemini FC schema
+     * node. Definitions (`jtdSchema.definitions`) are resolved inline because
+     * the FC protobuf schema does not support `$ref`.
+     *
+     * @param jtdSchema - A valid JTD schema (RFC 8927).
+     * @returns A new {@link GeminiFunctionCallingConversion} with `jtdSchema` set.
+     * @throws If the schema contains an unknown JTD type, an unresolved `ref`,
+     *         or circular / excessively deep refs (exceeding 32 levels).
+     */
+    static fromJTD(jtdSchema: JTDSchemaJson): GeminiFunctionCallingConversion<ConvertSuccessJson>;
+    /**
+     * Build a conversion from an Adapt signal descriptor.
+     *
+     * If the descriptor has a single format, its schema is used directly
+     * (unwrapped). If it has multiple formats, a wrapper object schema is
+     * produced with `format_0`, `format_1`, ... properties -- the LLM must
+     * populate exactly one. MIME formats become base64 string schemas.
+     *
+     * @param descriptor - An Adapt signal descriptor with one or more formats.
+     * @returns A new {@link GeminiFunctionCallingConversion} with `descriptor` set.
+     * @throws If the descriptor has no formats, or a format has neither
+     *         `jtdSchema` nor `mimeType`.
+     */
+    static fromSignal(descriptor: SignalDescriptorJson): GeminiFunctionCallingConversion<ConvertSuccessJson | ConvertSuccessBinary>;
+    /**
+     * Build a conversion from multiple signal descriptors.
+     *
+     * Produces an object schema with one property per signal, suitable for
+     * use as function calling parameters. Each signal's schema is built via
+     * {@link fromSignal} internally.
+     *
+     * Optional signals are omitted from `required`.
+     *
+     * Receiver/transceiver compatible:
+     * ```ts
+     * const conv = GeminiFunctionCallingConversion.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 GeminiFunctionCallingConversion} with `descriptors` set.
+     * @throws If any signal has no formats or an invalid format.
+     */
+    static fromSignals(signals: SignalDescriptorJson[], description?: string, label?: string): GeminiFunctionCallingConversion<ConvertSuccessSignals>;
+    /**
+     * Restore a {@link GeminiFunctionCallingConversion} 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.
+     *
+     * @param data - A JSON string or parsed object previously produced by {@link toJSON}.
+     * @returns A fully reconstructed {@link GeminiFunctionCallingConversion}.
+     * @throws If the serialized data contains neither `jtdSchema` nor `descriptor`,
+     *         or if `mode` is not `'fc'`.
+     */
+    static fromJSON(data: string | Record<string, unknown>): GeminiFunctionCallingConversion;
+    private constructor();
+    /**
+     * Convert raw LLM output into a validated result.
+     *
+     * For JTD-based conversions, the value is coerced to conform to the original
+     * JTD schema:
+     * - Non-integer numbers are rounded for integer types.
+     * - `{key, value}` arrays from the values form are reassembled into Records.
+     * - Unstructured/empty schemas parse the raw JSON string via `JSON.parse`.
+     * - Discriminator variants are coerced from flat objects.
+     *
+     * The coerced value is then validated against the JTD schema. Returns
+     * {@link ConvertSuccessJson} on success.
+     *
+     * For MIME-based conversions, the value is expected to be a base64 string
+     * which is decoded into raw bytes. Returns {@link ConvertSuccessBinary} on
+     * success.
+     *
+     * For multi-format signals, the first non-null `format_N` property is
+     * selected and converted individually.
+     *
+     * @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) => T | ConvertFailure;
+    /**
+     * Produce a JSON-serializable representation of this conversion.
+     *
+     * The output includes the FC `schema`, `mode: 'fc'`, and either the
+     * original `jtdSchema` or `descriptor` (whichever was used to create this
+     * instance), which is sufficient to fully restore the conversion via
+     * {@link fromJSON}.
+     *
+     * Called automatically by `JSON.stringify(conv)`.
+     */
+    toJSON(): Record<string, unknown>;
+}
+/** @deprecated Use {@link GeminiStructuredOutputConversion} instead. */
+export { GeminiStructuredOutputConversion as GeminiConversion };
+/**
+ * Convenience alias for {@link GeminiStructuredOutputConversion.fromJTD}.
  *
  * @param jtdSchema - A valid JTD schema (RFC 8927).
- * @returns A new {@link GeminiConversion}.
+ * @returns A new {@link GeminiStructuredOutputConversion}.
  */
-export declare function convertToGeminiSchema(jtdSchema: JTDSchemaJson): GeminiConversion<ConvertSuccessJson>;
+export declare function convertToGeminiSchema(jtdSchema: JTDSchemaJson): GeminiStructuredOutputConversion<ConvertSuccessJson>;
 /**
- * Convenience alias for {@link GeminiConversion.fromSignal}.
+ * Convenience alias for {@link GeminiStructuredOutputConversion.fromSignal}.
  *
  * @param descriptor - An Adapt signal descriptor.
- * @returns A new {@link GeminiConversion}.
+ * @returns A new {@link GeminiStructuredOutputConversion}.
+ */
+export declare function convertSignalToGeminiSchema(descriptor: SignalDescriptorJson): GeminiStructuredOutputConversion<ConvertSuccessJson | ConvertSuccessBinary>;
+/**
+ * Convenience alias for {@link GeminiFunctionCallingConversion.fromJTD}.
+ *
+ * @param jtdSchema - A valid JTD schema (RFC 8927).
+ * @returns A new {@link GeminiFunctionCallingConversion}.
  */
-export declare function convertSignalToGeminiSchema(descriptor: SignalDescriptorJson): GeminiConversion<ConvertSuccessJson | ConvertSuccessBinary>;
+export declare function convertToGeminiFCSchema(jtdSchema: JTDSchemaJson): GeminiFunctionCallingConversion<ConvertSuccessJson>;
 //# 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;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,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,aAAa,EACd,MAAM,iBAAiB,CAAC;AAiUzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,CAiB3C;IAIF;;;;;;;;OAQG;IACH,MAAM;CAeP;AA0ED;;;;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gemini/index.ts"],"names":[],"mappings":"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"}

package/dist/schema-utils.d.ts

@@ -76,5 +76,11 @@ export declare function poolSignalDefinitions(signals: SignalDescriptorJson[]):
     mergedDefs: Record<string, JTDSchemaJson>;
     signalsCopy: SignalDescriptorJson[];
 };
+/**
+ * Build a human-readable description of a JTD definition for use as a
+ * fallback at recursive ref break points. Used by both Anthropic and Gemini
+ * converters when a cycle is detected.
+ */
+export declare function describeDefinitionForCycle(defName: string, def: JTDSchemaJson): string;
 export {};
 //# sourceMappingURL=schema-utils.d.ts.map

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

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

package/package.json

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