@cavi-ai/api-client 0.1.0

package/dist/core/gateway/providers/factory.d.ts

@@ -0,0 +1,18 @@
+import { GatewayAgentConfigApiClient } from "../agent/config.js";
+import { GatewayApiClient } from "../client/client.js";
+import { GatewayMediaApiClient } from "../resources/media.js";
+import { GatewaySseRunEventProvider } from "../run/sse-run-event-provider.js";
+import { GatewayWikiApiClient } from "../resources/wiki.js";
+import { GatewayWebSocketClient } from "../../ws/index.js";
+import type { HttpApiClientOptions } from "../../http/types.js";
+import type { CreateGatewaySseRunEventProviderOptions, GatewayProviderKind, ResolveGatewayProviderOptions } from "./types.js";
+import type { GatewayWebSocketClientOptions } from "../../ws/index.js";
+export declare function resolveGatewayProviderKind(options?: ResolveGatewayProviderOptions): GatewayProviderKind;
+export declare function createGatewayApiClient(clientOptions: HttpApiClientOptions, providerOptions?: ResolveGatewayProviderOptions): GatewayApiClient;
+export declare function createGatewayWebSocketClient(wsUrl: string, authToken: string | null, clientOptions?: GatewayWebSocketClientOptions, providerOptions?: ResolveGatewayProviderOptions): GatewayWebSocketClient;
+export declare const createGatewayRpcClient: typeof createGatewayWebSocketClient;
+export declare function createGatewaySseRunEventProvider(options: CreateGatewaySseRunEventProviderOptions, providerOptions?: ResolveGatewayProviderOptions): GatewaySseRunEventProvider;
+export declare function createGatewayMediaClient(clientOptions: HttpApiClientOptions, providerOptions?: ResolveGatewayProviderOptions): GatewayMediaApiClient;
+export declare function createGatewayWikiClient(clientOptions: HttpApiClientOptions, providerOptions?: ResolveGatewayProviderOptions): GatewayWikiApiClient;
+export declare function createGatewayAgentConfigClient(clientOptions: HttpApiClientOptions, providerOptions?: ResolveGatewayProviderOptions): GatewayAgentConfigApiClient;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/gateway/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/providers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EACV,uCAAuC,EACvC,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvE,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,6BAAkC,GAC1C,mBAAmB,CAErB;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,oBAAoB,EACnC,eAAe,GAAE,6BAAkC,GAClD,gBAAgB,CAGlB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,GAAE,6BAAkC,EACjD,eAAe,GAAE,6BAAkC,GAClD,sBAAsB,CAIxB;AAED,eAAO,MAAM,sBAAsB,qCAA+B,CAAC;AAEnE,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,uCAAuC,EAChD,eAAe,GAAE,6BAAkC,GAClD,0BAA0B,CAI5B;AAED,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,oBAAoB,EACnC,eAAe,GAAE,6BAAkC,GAClD,qBAAqB,CAIvB;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,oBAAoB,EACnC,eAAe,GAAE,6BAAkC,GAClD,oBAAoB,CAItB;AAED,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,oBAAoB,EACnC,eAAe,GAAE,6BAAkC,GAClD,2BAA2B,CAI7B"}

package/dist/core/gateway/providers/factory.js

@@ -0,0 +1,40 @@
+import { GatewayAgentConfigApiClient } from "../agent/config.js";
+import { GatewayApiClient } from "../client/client.js";
+import { GatewayMediaApiClient } from "../resources/media.js";
+import { GatewaySseRunEventProvider } from "../run/sse-run-event-provider.js";
+import { GatewayWikiApiClient } from "../resources/wiki.js";
+import { GatewayWebSocketClient } from "../../ws/index.js";
+import { resolveGatewayProviderModule } from "./registry.js";
+export function resolveGatewayProviderKind(options = {}) {
+    return resolveGatewayProviderModule(options)?.kind ?? "gateway";
+}
+export function createGatewayApiClient(clientOptions, providerOptions = {}) {
+    const provider = resolveGatewayProviderModule(providerOptions);
+    return provider?.createApiClient?.(clientOptions) ?? new GatewayApiClient(clientOptions);
+}
+export function createGatewayWebSocketClient(wsUrl, authToken, clientOptions = {}, providerOptions = {}) {
+    const provider = resolveGatewayProviderModule(providerOptions);
+    return provider?.createWebSocketClient?.(wsUrl, authToken, clientOptions) ??
+        new GatewayWebSocketClient(wsUrl, authToken, clientOptions);
+}
+export const createGatewayRpcClient = createGatewayWebSocketClient;
+export function createGatewaySseRunEventProvider(options, providerOptions = {}) {
+    const provider = resolveGatewayProviderModule(providerOptions);
+    return provider?.createSseRunEventProvider?.(options) ??
+        new GatewaySseRunEventProvider(options);
+}
+export function createGatewayMediaClient(clientOptions, providerOptions = {}) {
+    const provider = resolveGatewayProviderModule(providerOptions);
+    return provider?.createMediaClient?.(clientOptions) ??
+        new GatewayMediaApiClient(clientOptions);
+}
+export function createGatewayWikiClient(clientOptions, providerOptions = {}) {
+    const provider = resolveGatewayProviderModule(providerOptions);
+    return provider?.createWikiClient?.(clientOptions) ??
+        new GatewayWikiApiClient(clientOptions);
+}
+export function createGatewayAgentConfigClient(clientOptions, providerOptions = {}) {
+    const provider = resolveGatewayProviderModule(providerOptions);
+    return provider?.createAgentConfigClient?.(clientOptions) ??
+        new GatewayAgentConfigApiClient(clientOptions);
+}

package/dist/core/gateway/providers/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./factory.js";
+export * from "./normalize.js";
+export * from "./registry.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/gateway/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/core/gateway/providers/index.js

@@ -0,0 +1,4 @@
+export * from "./factory.js";
+export * from "./normalize.js";
+export * from "./registry.js";
+export * from "./types.js";

package/dist/core/gateway/providers/normalize.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeGatewayProviderToken(value: string | null | undefined): string | null;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/core/gateway/providers/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/providers/normalize.ts"],"names":[],"mappings":"AAAA,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI,CAIf"}

package/dist/core/gateway/providers/normalize.js

@@ -0,0 +1,6 @@
+export function normalizeGatewayProviderToken(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    return normalized === "generic" ? "gateway" : normalized;
+}

package/dist/core/gateway/providers/registry.d.ts

@@ -0,0 +1,5 @@
+import { type CreateGatewayProviderRegistryOptions, type GatewayProviderModule, type GatewayProviderRegistry, type ResolveGatewayProviderOptions } from "./types.js";
+export declare function createGatewayProviderRegistry(options?: CreateGatewayProviderRegistryOptions): GatewayProviderRegistry;
+export declare function requestedGatewayProvider(options: ResolveGatewayProviderOptions): string | null;
+export declare function resolveGatewayProviderModule(options?: ResolveGatewayProviderOptions): GatewayProviderModule | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/gateway/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/providers/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oCAAoC,EACzC,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EACnC,MAAM,YAAY,CAAC;AAapB,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,oCAAyC,GACjD,uBAAuB,CAoBzB;AAqBD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,6BAA6B,GACrC,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,qBAAqB,GAAG,IAAI,CAW9B"}

package/dist/core/gateway/providers/registry.js

@@ -0,0 +1,76 @@
+import { normalizeGatewayProviderToken } from "./normalize.js";
+import { GATEWAY_PROVIDER_ENV_KEYS, } from "./types.js";
+function providerModuleKeys(module) {
+    const keys = new Set();
+    for (const key of [module.kind, ...(module.aliases ?? [])]) {
+        const normalized = normalizeGatewayProviderToken(key);
+        if (normalized) {
+            keys.add(normalized);
+        }
+    }
+    return [...keys];
+}
+export function createGatewayProviderRegistry(options = {}) {
+    const modules = [...(options.modules ?? [])];
+    const byKey = new Map();
+    for (const module of modules) {
+        for (const key of providerModuleKeys(module)) {
+            if (byKey.has(key) && options.allowOverrides !== true) {
+                throw new Error(`Duplicate gateway provider key "${key}"`);
+            }
+            byKey.set(key, module);
+        }
+    }
+    return {
+        resolveProvider(provider) {
+            const normalized = normalizeGatewayProviderToken(provider);
+            return normalized ? (byKey.get(normalized) ?? null) : null;
+        },
+        listProviders() {
+            return [...modules];
+        },
+    };
+}
+function gatewayProviderRegistryFromOptions(options) {
+    const providerModules = options.providerModules ?? [];
+    if (options.registry && providerModules.length === 0) {
+        return options.registry;
+    }
+    if (options.registry) {
+        return createGatewayProviderRegistry({
+            modules: [...options.registry.listProviders(), ...providerModules],
+            allowOverrides: options.allowProviderOverrides,
+        });
+    }
+    return createGatewayProviderRegistry({
+        modules: providerModules,
+        allowOverrides: options.allowProviderOverrides,
+    });
+}
+export function requestedGatewayProvider(options) {
+    const explicit = options.provider?.trim();
+    if (explicit)
+        return explicit;
+    for (const key of GATEWAY_PROVIDER_ENV_KEYS) {
+        const fromEnv = options.env?.[key]?.trim();
+        if (fromEnv)
+            return fromEnv;
+    }
+    return options.defaultProvider?.trim() || null;
+}
+export function resolveGatewayProviderModule(options = {}) {
+    const requested = requestedGatewayProvider(options);
+    if (!requested || isGenericGatewayProviderToken(requested)) {
+        return null;
+    }
+    const registry = gatewayProviderRegistryFromOptions(options);
+    const provider = registry.resolveProvider(requested);
+    if (!provider) {
+        throw new Error(`Unknown gateway provider "${requested}"`);
+    }
+    return provider;
+}
+function isGenericGatewayProviderToken(provider) {
+    const normalized = normalizeGatewayProviderToken(provider);
+    return normalized === "gateway" || normalized === "generic" || normalized === "core";
+}

package/dist/core/gateway/providers/types.d.ts

@@ -0,0 +1,42 @@
+import type { GatewayAgentConfigApiClient } from "../agent/config.js";
+import type { GatewayApiClient } from "../client/client.js";
+import type { GatewayMediaApiClient } from "../resources/media.js";
+import type { GatewaySseRunEventProvider, GatewaySseRunEventProviderOptions } from "../run/sse-run-event-provider.js";
+import type { GatewayWikiApiClient } from "../resources/wiki.js";
+import type { HttpApiClientOptions } from "../../http/types.js";
+import type { GatewayWebSocketClient, GatewayWebSocketClientOptions } from "../../ws/index.js";
+export type GatewayProviderKind = "hermes" | "openclaw" | (string & {});
+export declare const GATEWAY_PROVIDER_ENV_KEYS: readonly ["CAVI_GATEWAY_PROVIDER", "GATEWAY_PROVIDER"];
+export type GatewayProviderEnv = Record<string, string | undefined>;
+export type CreateGatewaySseRunEventProviderOptions = GatewaySseRunEventProviderOptions & {
+    sessionKey?: string;
+};
+export interface GatewayProviderFactories {
+    createApiClient?: (clientOptions: HttpApiClientOptions) => GatewayApiClient;
+    createWebSocketClient?: (wsUrl: string, authToken: string | null, clientOptions: GatewayWebSocketClientOptions) => GatewayWebSocketClient;
+    createSseRunEventProvider?: (options: CreateGatewaySseRunEventProviderOptions) => GatewaySseRunEventProvider;
+    createMediaClient?: (clientOptions: HttpApiClientOptions) => GatewayMediaApiClient;
+    createWikiClient?: (clientOptions: HttpApiClientOptions) => GatewayWikiApiClient;
+    createAgentConfigClient?: (clientOptions: HttpApiClientOptions) => GatewayAgentConfigApiClient;
+}
+export interface GatewayProviderModule extends GatewayProviderFactories {
+    kind: GatewayProviderKind;
+    aliases?: readonly string[];
+}
+export interface GatewayProviderRegistry {
+    resolveProvider(provider: string | null | undefined): GatewayProviderModule | null;
+    listProviders(): readonly GatewayProviderModule[];
+}
+export type CreateGatewayProviderRegistryOptions = {
+    modules?: readonly GatewayProviderModule[] | null;
+    allowOverrides?: boolean;
+};
+export type ResolveGatewayProviderOptions = {
+    provider?: GatewayProviderKind | string | null;
+    env?: GatewayProviderEnv;
+    defaultProvider?: GatewayProviderKind | string | null;
+    registry?: GatewayProviderRegistry | null;
+    providerModules?: readonly GatewayProviderModule[] | null;
+    allowProviderOverrides?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/gateway/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,0BAA0B,EAC1B,iCAAiC,EAClC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EACV,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,eAAO,MAAM,yBAAyB,wDAG5B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpE,MAAM,MAAM,uCAAuC,GACjD,iCAAiC,GAAG;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEJ,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,EAAE,CAAC,aAAa,EAAE,oBAAoB,KAAK,gBAAgB,CAAC;IAC5E,qBAAqB,CAAC,EAAE,CACtB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,EAAE,6BAA6B,KACzC,sBAAsB,CAAC;IAC5B,yBAAyB,CAAC,EAAE,CAC1B,OAAO,EAAE,uCAAuC,KAC7C,0BAA0B,CAAC;IAChC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,oBAAoB,KAAK,qBAAqB,CAAC;IACnF,gBAAgB,CAAC,EAAE,CAAC,aAAa,EAAE,oBAAoB,KAAK,oBAAoB,CAAC;IACjF,uBAAuB,CAAC,EAAE,CACxB,aAAa,EAAE,oBAAoB,KAChC,2BAA2B,CAAC;CAClC;AAED,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACrE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,CACb,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,qBAAqB,GAAG,IAAI,CAAC;IAChC,aAAa,IAAI,SAAS,qBAAqB,EAAE,CAAC;CACnD;AAED,MAAM,MAAM,oCAAoC,GAAG;IACjD,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAClD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/C,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,eAAe,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1C,eAAe,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAC1D,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC"}

package/dist/core/gateway/providers/types.js

@@ -0,0 +1,4 @@
+export const GATEWAY_PROVIDER_ENV_KEYS = [
+    "CAVI_GATEWAY_PROVIDER",
+    "GATEWAY_PROVIDER",
+];

package/dist/core/gateway/resources/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./media.js";
+export * from "./wiki.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/gateway/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/core/gateway/resources/index.js

@@ -0,0 +1,2 @@
+export * from "./media.js";
+export * from "./wiki.js";

package/dist/core/gateway/resources/media.d.ts

@@ -0,0 +1,165 @@
+import { BaseHttpApiClient } from "../../http/client.js";
+import type { HttpApiClientOptions, HttpApiRequestInit } from "../../http/types.js";
+import { type GatewayJobWaitOptions } from "../jobs.js";
+export declare const GATEWAY_MEDIA_KINDS: readonly ["audio", "image", "video", "music"];
+export type GatewayMediaKind = (typeof GATEWAY_MEDIA_KINDS)[number];
+export declare const GATEWAY_MEDIA_ACCEPT_HEADERS: {
+    readonly audio: "audio/*";
+    readonly image: "image/*";
+    readonly video: "video/*";
+    readonly music: "audio/*";
+};
+export type GatewayMediaJsonValue = string | number | boolean | null | readonly GatewayMediaJsonValue[] | {
+    readonly [key: string]: GatewayMediaJsonValue;
+};
+export type GatewayMediaEndpointMap = {
+    providers: (kind?: GatewayMediaKind | null) => string;
+    generate: (kind: GatewayMediaKind) => string;
+    job: (kind: GatewayMediaKind, jobId: string) => string;
+    assets: (query?: GatewayMediaAssetListOptions | null) => string;
+    asset: (assetId: string) => string;
+};
+export type GatewayMediaProvider = {
+    id: string;
+    kind?: GatewayMediaKind | string;
+    label?: string;
+    name?: string;
+    configured?: boolean;
+    models?: readonly string[];
+    voices?: readonly (string | {
+        id: string;
+        name?: string;
+    })[];
+    metadata?: Record<string, unknown>;
+};
+export type GatewayMediaProviderList = {
+    object?: string;
+    kind?: GatewayMediaKind | string;
+    providers: readonly GatewayMediaProvider[];
+};
+export type GatewayMediaGenerateRequest = {
+    kind: GatewayMediaKind;
+    input: string;
+    instructions?: string;
+    providerId?: string;
+    model?: string;
+    voiceId?: string;
+    format?: string;
+    durationSeconds?: number;
+    teamId?: string;
+    memberId?: string;
+    actionId?: string;
+    options?: Record<string, GatewayMediaJsonValue>;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayMediaGenerateInput = Omit<GatewayMediaGenerateRequest, "kind">;
+export type GatewayTextToSpeechRequest = Omit<GatewayMediaGenerateInput, "input"> & {
+    text: string;
+};
+export type GatewayMediaAsset = {
+    id?: string;
+    kind?: GatewayMediaKind | string;
+    contentType?: string;
+    filename?: string;
+    path?: string;
+    url?: string;
+    size?: number;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayMediaAssetListOptions = {
+    kind?: GatewayMediaKind | string | null;
+    cursor?: string | null;
+    limit?: number | null;
+};
+export type GatewayMediaAssetList = {
+    object?: string;
+    kind?: GatewayMediaKind | string;
+    assets: readonly GatewayMediaAsset[];
+    nextCursor?: string | null;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayMediaAssetUploadRequest = {
+    kind: GatewayMediaKind | string;
+    input?: string;
+    filename?: string;
+    contentType?: string;
+    dataBase64?: string;
+    url?: string;
+    size?: number;
+    options?: Record<string, GatewayMediaJsonValue>;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayMediaAssetDeleteResult = {
+    object?: string;
+    id?: string;
+    assetId?: string;
+    deleted?: boolean;
+    status: string;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayMediaGenerationResult = {
+    object?: string;
+    id?: string;
+    jobId?: string;
+    runId?: string;
+    kind?: GatewayMediaKind | string;
+    status: "queued" | "running" | "completed" | "failed" | "cancelled" | string;
+    asset?: GatewayMediaAsset;
+    artifacts?: readonly GatewayMediaAsset[];
+    output?: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+};
+export type GatewayMediaJobWaitOptions = Omit<GatewayJobWaitOptions<GatewayMediaGenerationResult>, "fetchJob">;
+export type GatewayMediaAssetRequest = Pick<HttpApiRequestInit, "cache" | "credentials" | "headers" | "signal" | "timeoutMs"> & {
+    accept?: string;
+};
+export type GatewayMediaApiClientOptions = {
+    endpoints?: GatewayMediaEndpointMap;
+    surface?: string;
+};
+export interface GatewayMediaClient {
+    listMediaProviders(kind?: GatewayMediaKind | null): Promise<GatewayMediaProviderList>;
+    generateMedia(body: GatewayMediaGenerateRequest, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateAudio(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateImage(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateVideo(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateMusic(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateTextToSpeech(body: GatewayTextToSpeechRequest, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    getMediaJob(kind: GatewayMediaKind, jobId: string): Promise<GatewayMediaGenerationResult>;
+    waitForMediaJob(kind: GatewayMediaKind, jobId: string, options?: GatewayMediaJobWaitOptions): Promise<GatewayMediaGenerationResult>;
+    listMediaAssets(options?: GatewayMediaAssetListOptions): Promise<GatewayMediaAssetList>;
+    getMediaAssetMetadata(assetId: string): Promise<GatewayMediaAsset>;
+    createMediaAsset(body: GatewayMediaAssetUploadRequest, idempotencyKey?: string): Promise<GatewayMediaAsset>;
+    uploadMediaAsset(body: GatewayMediaAssetUploadRequest, idempotencyKey?: string): Promise<GatewayMediaAsset>;
+    deleteMediaAsset(assetId: string): Promise<GatewayMediaAssetDeleteResult>;
+    getMediaAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getAudioAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getImageAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getVideoAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getMusicAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+}
+export declare class GatewayMediaApiClient extends BaseHttpApiClient implements GatewayMediaClient {
+    readonly endpoints: GatewayMediaEndpointMap;
+    constructor(options: HttpApiClientOptions, mediaOptions?: GatewayMediaApiClientOptions);
+    listMediaProviders(kind?: GatewayMediaKind | null): Promise<GatewayMediaProviderList>;
+    generateMedia(body: GatewayMediaGenerateRequest, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateAudio(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateImage(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateVideo(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateMusic(body: GatewayMediaGenerateInput, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    generateTextToSpeech(body: GatewayTextToSpeechRequest, idempotencyKey?: string): Promise<GatewayMediaGenerationResult>;
+    getMediaJob(kind: GatewayMediaKind, jobId: string): Promise<GatewayMediaGenerationResult>;
+    waitForMediaJob(kind: GatewayMediaKind, jobId: string, options?: GatewayMediaJobWaitOptions): Promise<GatewayMediaGenerationResult>;
+    listMediaAssets(options?: GatewayMediaAssetListOptions): Promise<GatewayMediaAssetList>;
+    getMediaAssetMetadata(assetId: string): Promise<GatewayMediaAsset>;
+    createMediaAsset(body: GatewayMediaAssetUploadRequest, idempotencyKey?: string): Promise<GatewayMediaAsset>;
+    uploadMediaAsset(body: GatewayMediaAssetUploadRequest, idempotencyKey?: string): Promise<GatewayMediaAsset>;
+    deleteMediaAsset(assetId: string): Promise<GatewayMediaAssetDeleteResult>;
+    getMediaAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getAudioAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getImageAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getVideoAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+    getMusicAsset(assetId: string, init?: GatewayMediaAssetRequest): Promise<Blob>;
+}
+//# sourceMappingURL=media.d.ts.map

package/dist/core/gateway/resources/media.d.ts.map

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

package/dist/core/gateway/resources/media.js

@@ -0,0 +1,170 @@
+import { GATEWAY_MEDIA_API_ENDPOINTS } from "../../../contracts/paths.js";
+import { BaseHttpApiClient } from "../../http/client.js";
+import { waitForGatewayJob, } from "../jobs.js";
+export const GATEWAY_MEDIA_KINDS = ["audio", "image", "video", "music"];
+export const GATEWAY_MEDIA_ACCEPT_HEADERS = {
+    audio: "audio/*",
+    image: "image/*",
+    video: "video/*",
+    music: "audio/*",
+};
+function normalizeMediaKind(kind) {
+    const normalized = kind.trim().toLowerCase();
+    if (GATEWAY_MEDIA_KINDS.includes(normalized)) {
+        return normalized;
+    }
+    throw new Error(`gateway media: unsupported media kind "${kind}"`);
+}
+function requiredText(value, label) {
+    const normalized = value?.trim();
+    if (!normalized) {
+        throw new Error(`gateway media: missing ${label}`);
+    }
+    return normalized;
+}
+function optionalText(value) {
+    const normalized = value?.trim();
+    return normalized || undefined;
+}
+function normalizeListOptions(options = {}) {
+    const kind = options.kind == null ? undefined : normalizeMediaKind(options.kind);
+    const cursor = optionalText(options.cursor);
+    const limit = options.limit ?? undefined;
+    if (limit !== undefined &&
+        (!Number.isFinite(limit) || limit <= 0 || Math.floor(limit) !== limit)) {
+        throw new Error("gateway media: asset list limit must be a positive integer");
+    }
+    return {
+        ...(kind ? { kind } : {}),
+        ...(cursor ? { cursor } : {}),
+        ...(limit !== undefined ? { limit } : {}),
+    };
+}
+function normalizeAssetUploadRequest(body) {
+    const kind = normalizeMediaKind(body.kind);
+    const input = optionalText(body.input);
+    const dataBase64 = optionalText(body.dataBase64);
+    const url = optionalText(body.url);
+    const { contentType, dataBase64: _dataBase64, filename, input: _input, url: _url, ...rest } = body;
+    if (!input && !dataBase64 && !url) {
+        throw new Error("gateway media: missing media asset source");
+    }
+    return {
+        ...rest,
+        kind,
+        ...(input ? { input } : {}),
+        ...(dataBase64 ? { dataBase64 } : {}),
+        ...(url ? { url } : {}),
+        ...(filename !== undefined
+            ? { filename: requiredText(filename, "media asset filename") }
+            : {}),
+        ...(contentType !== undefined
+            ? { contentType: requiredText(contentType, "media asset content type") }
+            : {}),
+    };
+}
+export class GatewayMediaApiClient extends BaseHttpApiClient {
+    endpoints;
+    constructor(options, mediaOptions = {}) {
+        super(mediaOptions.surface ?? "gateway-media-api", options);
+        this.endpoints = mediaOptions.endpoints ?? GATEWAY_MEDIA_API_ENDPOINTS;
+    }
+    listMediaProviders(kind) {
+        return this.requestJson(this.endpoints.providers(kind ? normalizeMediaKind(kind) : null));
+    }
+    generateMedia(body, idempotencyKey) {
+        const kind = normalizeMediaKind(body.kind);
+        return this.requestJson(this.endpoints.generate(kind), {
+            method: "POST",
+            body: {
+                ...body,
+                kind,
+                input: requiredText(body.input, "media input"),
+            },
+            idempotencyKey,
+        });
+    }
+    generateAudio(body, idempotencyKey) {
+        return this.generateMedia({ ...body, kind: "audio" }, idempotencyKey);
+    }
+    generateImage(body, idempotencyKey) {
+        return this.generateMedia({ ...body, kind: "image" }, idempotencyKey);
+    }
+    generateVideo(body, idempotencyKey) {
+        return this.generateMedia({ ...body, kind: "video" }, idempotencyKey);
+    }
+    generateMusic(body, idempotencyKey) {
+        return this.generateMedia({ ...body, kind: "music" }, idempotencyKey);
+    }
+    generateTextToSpeech(body, idempotencyKey) {
+        const { text, ...mediaBody } = body;
+        return this.generateAudio({
+            ...mediaBody,
+            input: requiredText(text, "text-to-speech text"),
+        }, idempotencyKey);
+    }
+    getMediaJob(kind, jobId) {
+        return this.requestJson(this.endpoints.job(normalizeMediaKind(kind), requiredText(jobId, "media job id")));
+    }
+    waitForMediaJob(kind, jobId, options = {}) {
+        return waitForGatewayJob({
+            ...options,
+            fetchJob: () => this.getMediaJob(kind, jobId),
+        });
+    }
+    listMediaAssets(options = {}) {
+        return this.requestJson(this.endpoints.assets(normalizeListOptions(options)));
+    }
+    getMediaAssetMetadata(assetId) {
+        return this.requestJson(this.endpoints.asset(requiredText(assetId, "media asset id")), {
+            headers: { Accept: "application/json" },
+        });
+    }
+    createMediaAsset(body, idempotencyKey) {
+        const normalized = normalizeAssetUploadRequest(body);
+        return this.requestJson(this.endpoints.assets({ kind: normalized.kind }), {
+            method: "POST",
+            body: normalized,
+            idempotencyKey,
+        });
+    }
+    uploadMediaAsset(body, idempotencyKey) {
+        return this.createMediaAsset(body, idempotencyKey);
+    }
+    deleteMediaAsset(assetId) {
+        return this.requestJson(this.endpoints.asset(requiredText(assetId, "media asset id")), { method: "DELETE" });
+    }
+    getMediaAsset(assetId, init = {}) {
+        return this.requestBlob(this.endpoints.asset(requiredText(assetId, "media asset id")), {
+            ...init,
+            headers: {
+                Accept: init.accept ?? "application/octet-stream",
+                ...(init.headers ?? {}),
+            },
+        });
+    }
+    getAudioAsset(assetId, init = {}) {
+        return this.getMediaAsset(assetId, {
+            ...init,
+            accept: init.accept ?? GATEWAY_MEDIA_ACCEPT_HEADERS.audio,
+        });
+    }
+    getImageAsset(assetId, init = {}) {
+        return this.getMediaAsset(assetId, {
+            ...init,
+            accept: init.accept ?? GATEWAY_MEDIA_ACCEPT_HEADERS.image,
+        });
+    }
+    getVideoAsset(assetId, init = {}) {
+        return this.getMediaAsset(assetId, {
+            ...init,
+            accept: init.accept ?? GATEWAY_MEDIA_ACCEPT_HEADERS.video,
+        });
+    }
+    getMusicAsset(assetId, init = {}) {
+        return this.getMediaAsset(assetId, {
+            ...init,
+            accept: init.accept ?? GATEWAY_MEDIA_ACCEPT_HEADERS.music,
+        });
+    }
+}