@brotu/ai 0.1.0

package/dist/adapters/google.adapter.d.ts

@@ -0,0 +1,52 @@
+import { type Job, type JobSnapshot } from "../lib/jobs";
+import { type AudioGenerationParams, type ContentGeneratorPort, type CostEstimate, type GenerationOutput, type GenerationParams, type GenerationResult, type GenerationType, type ImageGenerationParams, type TextGenerationParams, type VideoGenerationParams } from "../ports/content-generator.port";
+export interface GoogleAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    maxPollAttempts?: number;
+}
+/**
+ * Google, through the Gemini Developer API.
+ *
+ * The host runs two conventions side by side and they cannot share a
+ * serializer: images use the Interactions API with snake_case `input` /
+ * `response_format`, while Veo uses the older `instances` / `parameters`
+ * envelope in camelCase. Each has its own builder below for that reason.
+ */
+export declare class GoogleAdapter implements ContentGeneratorPort {
+    readonly providerName = "google";
+    readonly supportedTypes: GenerationType[];
+    private readonly opts;
+    constructor(opts: GoogleAdapterOptions);
+    private get baseUrl();
+    private get headers();
+    private request;
+    generateImage(params: ImageGenerationParams): Promise<GenerationResult>;
+    private veoBody;
+    /**
+     * Omni speaks the Interactions API, so it gets its own builder — snake_case
+     * `input`/`response_format`, against Veo's camelCase predict envelope.
+     */
+    private omniBody;
+    /** Generate or refine a video conversationally. Returns the interaction. */
+    omniVideo(params: VideoGenerationParams & {
+        previousInteractionId?: string;
+    }): Promise<{
+        interactionId?: string;
+        outputs: GenerationOutput[];
+    }>;
+    private runVideo;
+    /** Resume a Veo operation submitted earlier, possibly by another process. */
+    completeJob(job: Job): Promise<JobSnapshot>;
+    generateVideo(params: VideoGenerationParams): Promise<GenerationResult>;
+    generateAudio(_params: AudioGenerationParams): Promise<GenerationResult>;
+    generateText(_params: TextGenerationParams): Promise<GenerationResult>;
+    estimateCost(type: GenerationType, params: GenerationParams): Promise<CostEstimate>;
+    supportsModel(model: string): boolean;
+    getAvailableModels(): {
+        id: string;
+        name: string;
+        type: GenerationType;
+    }[];
+}
+//# sourceMappingURL=google.adapter.d.ts.map

package/dist/adapters/google.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/google.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,GAAG,EACR,KAAK,WAAW,EAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,iCAAiC,CAAC;AAOzC,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAiCD;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,oBAAoB;IACzD,QAAQ,CAAC,YAAY,YAAY;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,EAAE,CAAsB;IAE/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAE5C,YAAY,IAAI,EAAE,oBAAoB,EAErC;IAED,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,KAAK,OAAO,GAKlB;YAEa,OAAO;IAwBf,aAAa,CAClB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAyF3B;IAID,OAAO,CAAC,OAAO;IAoCf;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAoDhB,4EAA4E;IACtE,SAAS,CACd,MAAM,EAAE,qBAAqB,GAAG;QAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC,CAkClE;YAEa,QAAQ;IA4FtB,6EAA6E;IACvE,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CA+ChD;IAED,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtE;IAED,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEvE;IAED,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAErE;IAEK,YAAY,CACjB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAEvB;IAED,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,kBAAkB;;;cAKE,cAAc;QAQjC;CACD"}

package/dist/adapters/kling.adapter.d.ts

@@ -0,0 +1,57 @@
+import { type Job, type JobSnapshot } from "../lib/jobs";
+import { type AudioGenerationParams, type ContentGeneratorPort, type CostEstimate, type GenerationParams, type GenerationResult, type GenerationType, type ImageGenerationParams, type TextGenerationParams, type VideoGenerationParams } from "../ports/content-generator.port";
+import { type KlingCapability } from "../providers/kling.models";
+export interface KlingAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    /** Guards a job that never settles. Defaults to twenty minutes of polling. */
+    maxPollAttempts?: number;
+}
+export declare class KlingAdapter implements ContentGeneratorPort {
+    readonly providerName = "kling";
+    readonly supportedTypes: GenerationType[];
+    private readonly opts;
+    constructor(opts: KlingAdapterOptions);
+    private get baseUrl();
+    private request;
+    private binding;
+    private submitPath;
+    private legacyBody;
+    private nextBody;
+    private submitTask;
+    private queryTask;
+    private outputsFrom;
+    /** A capability job carries `kling:<name>:<resultField>` in its model slot. */
+    private resultFieldOf;
+    private snapshot;
+    private run;
+    /**
+     * Submit any declared capability and hand back a job.
+     *
+     * The three axes that differ between them — API family, body, result field —
+     * all come from the capability itself, so this runs every one of them.
+     */
+    submitCapability<TInput>(name: string, capability: KlingCapability<TInput>, input: TInput): Promise<Job>;
+    /** Resume a job submitted earlier, possibly by another process. */
+    completeJob(job: Job): Promise<JobSnapshot>;
+    generateImage(params: ImageGenerationParams): Promise<GenerationResult>;
+    generateVideo(params: VideoGenerationParams): Promise<GenerationResult>;
+    /** Your own cloned voices. Presets are in KLING_VOICES. */
+    listVoices(): Promise<Array<{
+        voiceId: string;
+        name?: string;
+    }>>;
+    /**
+     * Speech. Synchronous, and snake_case — unlike both video APIs on this host.
+     */
+    generateAudio(params: AudioGenerationParams): Promise<GenerationResult>;
+    generateText(_params: TextGenerationParams): Promise<GenerationResult>;
+    estimateCost(type: GenerationType, params: GenerationParams): Promise<CostEstimate>;
+    supportsModel(model: string): boolean;
+    getAvailableModels(): {
+        id: string;
+        name: string;
+        type: GenerationType;
+    }[];
+}
+//# sourceMappingURL=kling.adapter.d.ts.map

package/dist/adapters/kling.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kling.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/kling.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,GAAG,EACR,KAAK,WAAW,EAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAGjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIN,KAAK,eAAe,EAGpB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AA2CD,qBAAa,YAAa,YAAW,oBAAoB;IACxD,QAAQ,CAAC,YAAY,WAAW;IAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,EAAE,CAAsB;IAE/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAE3C,YAAY,IAAI,EAAE,mBAAmB,EAEpC;IAED,OAAO,KAAK,OAAO,GAElB;YAEa,OAAO;IAyBrB,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,QAAQ;YAkCF,UAAU;YAkDV,SAAS;IAiBvB,OAAO,CAAC,WAAW;IA4BnB,+EAA+E;IAC/E,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,QAAQ;YA4BF,GAAG;IAyDjB;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,EACnC,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,GAAG,CAAC,CAwBd;IAED,mEAAmE;IAC7D,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAahD;IAED,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtE;IAED,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtE;IAED,2DAA2D;IACrD,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAUrE;IAED;;OAEG;IACG,aAAa,CAClB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA4D3B;IAED,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAErE;IAEK,YAAY,CACjB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAEvB;IAED,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,kBAAkB;;;cAIM,cAAc;QAErC;CACD"}

package/dist/adapters/openai.adapter.d.ts

@@ -0,0 +1,40 @@
+import type { Job, JobSnapshot } from "../lib/jobs";
+import type { AudioGenerationParams, ContentGeneratorPort, CostEstimate, GenerationParams, GenerationResult, GenerationType, ImageGenerationParams, TextGenerationParams, VideoGenerationParams } from "../ports/content-generator.port";
+export interface OpenAIAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    /** Sent as OpenAI-Organization when set. */
+    organization?: string;
+}
+/**
+ * OpenAI image generation.
+ *
+ * Two things shape this adapter. It is synchronous — there is no job to poll,
+ * so `submit()` hands back an already-settled one. And the gpt-image models
+ * return **base64 only**, never a URL, so outputs come back as data URIs. Give
+ * the client a `storage` bucket and they are copied into it; `fetch` reads a
+ * data URI directly, so nothing special is needed for that.
+ */
+export declare class OpenAIAdapter implements ContentGeneratorPort {
+    readonly providerName = "openai";
+    readonly supportedTypes: GenerationType[];
+    private readonly opts;
+    constructor(opts: OpenAIAdapterOptions);
+    private get baseUrl();
+    private binding;
+    private buildBody;
+    generateImage(params: ImageGenerationParams): Promise<GenerationResult>;
+    generateVideo(_params: VideoGenerationParams): Promise<GenerationResult>;
+    generateAudio(_params: AudioGenerationParams): Promise<GenerationResult>;
+    generateText(_params: TextGenerationParams): Promise<GenerationResult>;
+    /** Synchronous provider: there is never a queued job to come back to. */
+    completeJob(job: Job): Promise<JobSnapshot>;
+    estimateCost(type: GenerationType, params: GenerationParams): Promise<CostEstimate>;
+    supportsModel(model: string): boolean;
+    getAvailableModels(): {
+        id: string;
+        name: string;
+        type: GenerationType;
+    }[];
+}
+//# sourceMappingURL=openai.adapter.d.ts.map

package/dist/adapters/openai.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EACX,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EAEZ,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,iCAAiC,CAAC;AAOzC,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,oBAAoB;IACzD,QAAQ,CAAC,YAAY,YAAY;IAEjC,QAAQ,CAAC,cAAc,EAAE,cAAc,EAAE,CAAa;IAEtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAE5C,YAAY,IAAI,EAAE,oBAAoB,EAErC;IAED,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,SAAS;IA6CX,aAAa,CAClB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAmE3B;IAED,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIvE;IAED,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEvE;IAED,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAErE;IAED,yEAAyE;IACnE,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAKhD;IAEK,YAAY,CACjB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAgBvB;IAED,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,kBAAkB;;;cAIC,cAAc;QAEhC;CACD"}

package/dist/adapters/qwen.adapter.d.ts

@@ -0,0 +1,53 @@
+import { type Job, type JobSnapshot } from "../lib/jobs";
+import { type AudioGenerationParams, type ContentGeneratorPort, type CostEstimate, type GenerationParams, type GenerationResult, type GenerationType, type ImageGenerationParams, type TextGenerationParams, type VideoGenerationParams } from "../ports/content-generator.port";
+export interface QwenAdapterOptions {
+    apiKey: string;
+    baseUrl?: string;
+    maxPollAttempts?: number;
+}
+/**
+ * Qwen Cloud / DashScope International.
+ *
+ * Verified end to end against the live API: this adapter's request shape queued
+ * a real task and the poll returned a playable video, which is why the field
+ * names here are transcribed rather than inferred.
+ */
+export declare class QwenAdapter implements ContentGeneratorPort {
+    readonly providerName = "qwen";
+    readonly supportedTypes: GenerationType[];
+    private readonly opts;
+    constructor(opts: QwenAdapterOptions);
+    private get baseUrl();
+    private request;
+    private binding;
+    private videoBody;
+    private outputsFrom;
+    private snapshot;
+    private run;
+    /** Resume a job submitted earlier, possibly by another process. */
+    completeJob(job: Job): Promise<JobSnapshot>;
+    generateVideo(params: VideoGenerationParams): Promise<GenerationResult>;
+    /**
+     * Every image model wired up here answers inline, so this makes no task.
+     *
+     * That is not a style choice: sending `X-DashScope-Async: enable` to a
+     * sync-only model returns 429, which reads as rate limiting and never clears
+     * on retry. The header is gated on the model's own flag for that reason.
+     */
+    generateImage(params: ImageGenerationParams): Promise<GenerationResult>;
+    /**
+     * Speech. Synchronous: the audio URL comes back on the same response, with a
+     * real expiry attached rather than one we guess at.
+     */
+    generateAudio(params: AudioGenerationParams): Promise<GenerationResult>;
+    /** Text, through the OpenAI-compatible surface. Synchronous. */
+    generateText(params: TextGenerationParams): Promise<GenerationResult>;
+    estimateCost(type: GenerationType, params: GenerationParams): Promise<CostEstimate>;
+    supportsModel(model: string): boolean;
+    getAvailableModels(): {
+        id: string;
+        name: string;
+        type: GenerationType;
+    }[];
+}
+//# sourceMappingURL=qwen.adapter.d.ts.map

package/dist/adapters/qwen.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/qwen.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,GAAG,EACR,KAAK,WAAW,EAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAGjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,iCAAiC,CAAC;AAYzC,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AA4CD;;;;;;GAMG;AACH,qBAAa,WAAY,YAAW,oBAAoB;IACvD,QAAQ,CAAC,YAAY,UAAU;IAC/B,QAAQ,CAAC,cAAc,EAAE,cAAc,EAAE,CAAsB;IAE/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAE1C,YAAY,IAAI,EAAE,kBAAkB,EAEnC;IAED,OAAO,KAAK,OAAO,GAElB;YAEa,OAAO;IA0BrB,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,SAAS;IA4FjB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,QAAQ;YAmCF,GAAG;IA8EjB,mEAAmE;IAC7D,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAYhD;IAED,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtE;IAED;;;;;;OAMG;IACG,aAAa,CAClB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA0E3B;IAED;;;OAGG;IACG,aAAa,CAClB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAsE3B;IAED,gEAAgE;IAC1D,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0E1E;IAEK,YAAY,CACjB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAEvB;IAED,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOpC;IAED,kBAAkB;;;cAKE,cAAc;QAQjC;CACD"}