qlogicagent 2.7.0 → 2.9.0

package/dist/types/skills/tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * Tool Registry 鈥?CC-aligned getAllBaseTools() pattern.
+ * Tool RegistryCC-aligned getAllBaseTools() pattern.
  *
  * CC reference: claude-code-haha/src/tools.ts
  *
@@ -52,7 +52,7 @@ export declare function getToolCount(): number;
  */
 export declare function executeTool(name: string, toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<import("./portable-tool.js").PortableToolResult>;
 /**
- * CC: getTools() 鈥?return all enabled tools.
+ * CC: getTools()return all enabled tools.
  * Filters the pool by isEnabled() gate; disabled tools are invisible to callers.
  * CC reference: claude-code-haha/src/tools.ts getTools()
  */
@@ -73,7 +73,7 @@ export declare function isToolActivated(name: string): boolean;
 export declare function clearActivatedTools(): void;
 /**
  * Generate ToolDefinition[] manifest for LLM tool_use.
- * Filters by isEnabled() 鈥?disabled tools never reach the model.
+ * Filters by isEnabled()disabled tools never reach the model.
  * Deferred tools are excluded UNLESS they have been activated via tool_search.
  * CC: getTools() + manifest generation combined.
  */

package/dist/types/transport/acp-event-emitter.d.ts

@@ -1,5 +1,5 @@
 /**
- * ACP Event Emitter 鈥?translates internal qlogicagent notifications to ACP
+ * ACP Event Emittertranslates internal qlogicagent notifications to ACP
  * session/update notifications.
  *
  * Maps the 47+ internal notification methods (turn.delta, turn.tool_call, etc.)

package/dist/types/transport/acp-server.d.ts

@@ -1,5 +1,5 @@
 /**
- * ACP Server 鈥?Agent-Client Protocol server layer for qlogicagent.
+ * ACP ServerAgent-Client Protocol server layer for qlogicagent.
  *
  * This module implements qlogicagent as an ACP Server, allowing any ACP-compliant
  * host (AionUI, Cursor, openclaw, etc.) to connect and interact with the agent.
@@ -78,7 +78,7 @@ export interface AcpServerConfig {
     verbose?: boolean;
 }
 /**
- * AcpServer 鈥?manages the ACP protocol state machine.
+ * AcpServermanages the ACP protocol state machine.
  *
  * Lifecycle:
  * 1. Host connects (stdio)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -62,6 +62,7 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
+    "@qlogic/provider-core": "workspace:*",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "nanoid": "^5.1.5",

package/dist/types/llm/adapters/aliyun-oss-file-upload-adapter.d.ts

@@ -1,44 +0,0 @@
-/**
- * Aliyun OSS File Upload Adapter — direct upload to Alibaba Cloud OSS.
- *
- * Uploads files directly to OSS bucket using V1 signature (HMAC-SHA1).
- * No external dependencies — uses Node.js crypto + fetch.
- *
- * This is the **universal fallback adapter** for providers without a native
- * File Upload API (e.g. Anthropic). Ensures ALL file handling goes through
- * upload — never base64 inline.
- *
- * Environment variables:
- *   OSS_ACCESS_KEY_ID       — Aliyun AccessKey ID
- *   OSS_ACCESS_KEY_SECRET   — Aliyun AccessKey Secret
- *   OSS_BUCKET              — Bucket name (default: "qlogicagent")
- *   OSS_REGION              — Region (default: "cn-beijing")
- *   OSS_ENDPOINT            — Custom endpoint (default: derived from region)
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface AliyunOSSFileUploadConfig {
-    /** Aliyun AccessKey ID. Required. */
-    accessKeyId: string;
-    /** Aliyun AccessKey Secret. Required. */
-    accessKeySecret: string;
-    /** OSS Bucket name. Default: "qlogicagent". */
-    bucket?: string;
-    /** OSS Region. Default: "cn-beijing". */
-    region?: string;
-    /** Custom OSS endpoint. Default: "{bucket}.oss-{region}.aliyuncs.com". */
-    endpoint?: string;
-    /** Upload path prefix. Default: "media". */
-    pathPrefix?: string;
-    /** Timeout ms. Default: 120_000. */
-    timeoutMs?: number;
-}
-/**
- * Create an AliyunOSSFileUploadAdapter from environment variables.
- * Returns undefined if required env vars (OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET) are missing.
- */
-export declare function createAliyunOSSAdapterFromEnv(): AliyunOSSFileUploadAdapter | undefined;
-export declare class AliyunOSSFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: AliyunOSSFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, _apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/adapters/gemini-file-upload-adapter.d.ts

@@ -1,26 +0,0 @@
-/**
- * Gemini File Upload Adapter.
- *
- * Implements the Google Gemini 2-step resumable upload protocol
- * into the unified FileUploadAdapter interface.
- *
- * Protocol:
- *   1. POST /upload/v1beta/files — initiate, get upload URL
- *   2. PUT {uploadUrl} — send bytes, finalize
- *
- * Returns a file URI (e.g. "files/abc123") that can be used in
- * generateContent requests as a file reference.
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface GeminiFileUploadConfig {
-    /** Base URL (e.g. "https://generativelanguage.googleapis.com/v1beta") */
-    baseUrl: string;
-    /** Timeout ms. Default: 180_000. */
-    timeoutMs?: number;
-}
-export declare class GeminiFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: GeminiFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-    private waitForProcessing;
-}

package/dist/types/llm/adapters/hub-oss-file-upload-adapter.d.ts

@@ -1,29 +0,0 @@
-/**
- * Hub OSS File Upload Adapter — for providers without native File API (e.g. Anthropic).
- *
- * Uploads local files to the Hub's OSS relay endpoint, which stores them in
- * cloud object storage (Aliyun OSS / Tencent COS) and returns a public URL.
- * The LLM provider can then access the file via this public URL.
- *
- * This enables Anthropic (which only supports base64 inline or public URL)
- * to handle large files that exceed the base64 size limit (20MB).
- *
- * Endpoint: POST {hubBaseUrl}/api/v1/files/upload
- * Returns: { url: "https://oss-bucket.oss-cn-xxx.aliyuncs.com/..." }
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface HubOSSFileUploadConfig {
-    /** Hub API base URL (e.g. "https://hub.xiaozhiclaw.com" or from env). */
-    hubBaseUrl: string;
-    /** Hub API key for authentication. */
-    hubApiKey?: string;
-    /** Timeout ms. Default: 120_000. */
-    timeoutMs?: number;
-    /** Provider name for result metadata. Default: "hub-oss". */
-    provider?: string;
-}
-export declare class HubOSSFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: HubOSSFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, _apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/adapters/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * File Upload Adapters — barrel export.
- *
- * Provider-specific implementations of the FileUploadAdapter interface.
- */
-export { OpenAIFileUploadAdapter, type OpenAIFileUploadConfig } from "./openai-file-upload-adapter.js";
-export { VolcengineFileUploadAdapter, type VolcengineFileUploadConfig } from "./volcengine-file-upload-adapter.js";
-export { GeminiFileUploadAdapter, type GeminiFileUploadConfig } from "./gemini-file-upload-adapter.js";
-export { HubOSSFileUploadAdapter, type HubOSSFileUploadConfig } from "./hub-oss-file-upload-adapter.js";
-export { AliyunOSSFileUploadAdapter, type AliyunOSSFileUploadConfig, createAliyunOSSAdapterFromEnv } from "./aliyun-oss-file-upload-adapter.js";

package/dist/types/llm/adapters/openai-file-upload-adapter.d.ts

@@ -1,38 +0,0 @@
-/**
- * OpenAI-compatible File Upload Adapter.
- *
- * Implements FileUploadAdapter for providers using the standard
- * POST /v1/files multipart upload endpoint:
- *   - OpenAI
- *   - Kimi (Moonshot)
- *   - Minimax
- *   - Qwen (via DashScope compatible endpoint)
- *   - GLM (Zhipu)
- *   - Any OpenAI-API-compatible provider
- *
- * The uploaded file gets a file_id which can be referenced in messages.
- * Some providers also return a direct download URL.
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface OpenAIFileUploadConfig {
-    /** Base URL (e.g. "https://api.openai.com/v1" or "https://api.moonshot.cn/v1") */
-    baseUrl: string;
-    /** Provider name for result metadata. */
-    provider: string;
-    /** Extra headers to include (e.g. for Minimax group_id). */
-    extraHeaders?: Record<string, string>;
-    /** Upload purpose (default: "file-extract" for document understanding). */
-    defaultPurpose?: string;
-    /**
-     * Whether the provider returns a download URL in the upload response.
-     * If false, constructs URL from file_id (provider-specific).
-     */
-    returnsUrl?: boolean;
-    /** Timeout for upload request (ms). Default: 120_000. */
-    timeoutMs?: number;
-}
-export declare class OpenAIFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: OpenAIFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/adapters/volcengine-file-upload-adapter.d.ts

@@ -1,24 +0,0 @@
-/**
- * Volcengine File Upload Adapter.
- *
- * Wraps the Volcengine /v3/files endpoint into the unified
- * FileUploadAdapter interface.
- *
- * Volcengine returns a file_id that can be used in API messages
- * as a file reference. Files uploaded this way can be referenced in
- * multimodal inputs via the file_id field.
- */
-import type { FileUploadAdapter, FileUploadResult } from "../file-upload-service.js";
-export interface VolcengineFileUploadConfig {
-    /** Base URL (e.g. "https://ark.cn-beijing.volces.com/api") */
-    baseUrl: string;
-    /** Upload purpose. Default: "user_data". */
-    defaultPurpose?: string;
-    /** Timeout ms. Default: 120_000. */
-    timeoutMs?: number;
-}
-export declare class VolcengineFileUploadAdapter implements FileUploadAdapter {
-    private readonly config;
-    constructor(config: VolcengineFileUploadConfig);
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}

package/dist/types/llm/builtin-providers.d.ts

@@ -1,10 +0,0 @@
-/**
- * Builtin provider definitions — hardcoded fallback list (~30 providers).
- *
- * This is Layer 1 (lowest priority) of the three-layer merge strategy.
- * Used when remote model catalog is unavailable.
- *
- * Aligned with Hermes hermes_cli/models.py hardcoded fallback.
- */
-import type { ProviderDef } from "./provider-def.js";
-export declare const BUILTIN_PROVIDERS: ProviderDef[];

package/dist/types/llm/debug-transport.d.ts

@@ -1,12 +0,0 @@
-import type { LLMTransport } from "./transport.js";
-/**
- * Check whether debug transport should be enabled.
- */
-export declare function isDebugTransportEnabled(): boolean;
-/**
- * Create a DebugTransport decorator that wraps a base LLMTransport,
- * logging request metadata + timing + usage to JSONL.
- *
- * CC parity: createDumpPromptsFetch — but vendor-agnostic via transport abstraction.
- */
-export declare function createDebugTransport(base: LLMTransport, sessionId: string): LLMTransport;

package/dist/types/llm/file-upload-service.d.ts

@@ -1,68 +0,0 @@
-/**
- * FileUploadService — Unified file upload abstraction for all LLM providers.
- *
- * Replaces the base64 approach in media-resolve.ts. When a local URL is
- * encountered, this service uploads the file to the current provider's
- * File API and returns a public URL or file_id.
- *
- * Supported providers:
- *   - OpenAI-compatible (OpenAI, Kimi, Minimax, Qwen, GLM) — POST /v1/files
- *   - Volcengine — POST /v3/files
- *   - Google Gemini — Resumable upload protocol
- *
- * Architecture:
- *   Transport layer calls resolveLocalMedia() before sending messages.
- *   resolveLocalMedia() fetches local content and uploads to provider,
- *   returning a public URL the LLM can access.
- */
-export interface FileUploadResult {
-    /** Public URL accessible by the LLM provider. */
-    url: string;
-    /** Provider-specific file identifier (for reference/deletion). */
-    fileId: string;
-    /** Original filename. */
-    filename: string;
-    /** File size in bytes. */
-    bytes: number;
-    /** MIME type of the uploaded file. */
-    mimeType: string;
-    /** Provider that stored the file. */
-    provider: string;
-}
-/**
- * Provider-specific upload adapter.
- * Each transport implements this to upload files to its own File API.
- */
-export interface FileUploadAdapter {
-    /**
-     * Upload a file buffer and return a publicly accessible URL.
-     * @param buffer - File content
-     * @param filename - Original filename (used for MIME detection)
-     * @param mimeType - MIME type of the file
-     * @param apiKey - Provider API key
-     * @param signal - Abort signal
-     */
-    uploadFile(buffer: Buffer, filename: string, mimeType: string, apiKey: string, signal?: AbortSignal): Promise<FileUploadResult>;
-}
-/** Guess MIME type from filename extension. */
-export declare function guessMimeType(filename: string): string;
-/** Check if a URL points to a local/private address that cloud APIs cannot reach. */
-export declare function isLocalUrl(url: string): boolean;
-/**
- * Resolve a local URL by uploading its content to the provider's File API.
- * Public URLs are returned as-is (the LLM API can fetch them directly).
- *
- * @param url - The URL to resolve (may be local or public)
- * @param adapter - Provider-specific upload adapter
- * @param apiKey - API key for the upload
- * @param signal - Optional abort signal
- * @returns Public URL accessible by the LLM
- */
-export declare function resolveLocalMedia(url: string, adapter: FileUploadAdapter, apiKey: string, signal?: AbortSignal): Promise<string>;
-/**
- * Batch-resolve multiple URLs concurrently. Returns array in same order.
- * Local URLs are uploaded; public URLs pass through unchanged.
- * Supports concurrent uploads (up to `concurrency` limit, default 3).
- * Failures throw (caller should handle).
- */
-export declare function resolveLocalMediaBatch(urls: string[], adapter: FileUploadAdapter, apiKey: string, signal?: AbortSignal, concurrency?: number): Promise<string[]>;

package/dist/types/llm/gemini-schema-utils.d.ts

@@ -1,17 +0,0 @@
-/**
- * Gemini JSON Schema cleaning utilities.
- *
- * Gemini's generateContent API rejects several standard JSON Schema keywords.
- * This module provides a shared recursive cleaner used by:
- *   - GeminiGenerateContentTransport (tool declarations in request body)
- *   - tool-schema.ts (provider-aware schema normalization at orchestration level)
- *
- * Keeping a single source of truth avoids drift between the two consumers.
- */
-/** Keywords that Gemini's generateContent API does not accept in tool schemas. */
-export declare const GEMINI_UNSUPPORTED_SCHEMA_KEYWORDS: Set<string>;
-/**
- * Recursively strip unsupported JSON Schema keywords from a schema object.
- * Safe to call multiple times (idempotent).
- */
-export declare function cleanSchemaForGemini(schema: unknown): unknown;

package/dist/types/llm/llm-client.d.ts

@@ -1,43 +0,0 @@
-/**
- * LLM Client factory — resolves ProviderDef → creates LLMTransport instance.
- *
- * Replaces the old createAdminInferProxyClient() call chain.
- * User API key + ProviderDef → direct provider connection.
- */
-import type { ProviderDef } from "./provider-def.js";
-import type { LLMTransport } from "./transport.js";
-import { ProviderRegistry } from "./provider-registry.js";
-export interface LLMClientConfig {
-    /** Provider id, e.g. "deepseek" */
-    provider: string;
-    /** Model id, e.g. "deepseek-v4-flash" */
-    model: string;
-    /** User API key */
-    apiKey: string;
-    /** Optional base URL override */
-    baseUrl?: string;
-}
-export interface LLMClient {
-    transport: LLMTransport;
-    apiKey: string;
-    resolvedModel: string;
-    providerDef: ProviderDef;
-}
-/**
- * Create an LLM client from config + registry.
- *
- * 1. Look up provider in registry
- * 2. Apply baseUrl override if provided
- * 3. Instantiate the correct transport
- */
-export declare function createLLMClient(config: LLMClientConfig, registry: ProviderRegistry): LLMClient;
-/**
- * Auto-detect provider from API key environment variables.
- * Scans registry for providers whose env vars are set.
- * Returns the first match.
- */
-export declare function autoDetectProvider(registry: ProviderRegistry): {
-    providerId: string;
-    apiKey: string;
-    defaultModel: string;
-} | undefined;

package/dist/types/llm/media-client.d.ts

@@ -1,42 +0,0 @@
-/**
- * Media Client factory — resolves ProviderDef → creates MediaTransport instances.
- *
- * Parallel to createLLMClient() but for generation models (image/video/music/3D).
- * Uses the same ProviderRegistry to look up provider config, then instantiates
- * the correct media transport adapter.
- *
- * The MediaClient holds a provider-keyed transport cache so that repeated
- * generation calls reuse the same adapter instance.
- */
-import type { MediaTransport } from "./media-transport.js";
-import type { ProviderDef, MediaCapability, ModelInfo } from "./provider-def.js";
-import type { ProviderRegistry } from "./provider-registry.js";
-export interface MediaClientConfig {
-    registry: ProviderRegistry;
-}
-export interface ResolvedMediaModel {
-    providerId: string;
-    providerDef: ProviderDef;
-    modelInfo: ModelInfo;
-    mediaType: MediaCapability;
-}
-export declare class MediaClient {
-    private registry;
-    private transports;
-    constructor(config: MediaClientConfig);
-    /**
-     * Find a specific model by provider + model id for a given media type.
-     * Used by the user-designated model routing (no failover).
-     */
-    resolveModelById(providerId: string, modelId: string, mediaType: MediaCapability): ResolvedMediaModel | undefined;
-    /**
-     * Get a MediaTransport for a specific provider.
-     * Creates and caches the adapter on first access.
-     */
-    getTransport(providerId: string): MediaTransport | undefined;
-    /**
-     * List all available generation models across all providers.
-     */
-    listMediaModels(mediaType?: MediaCapability): ResolvedMediaModel[];
-    private findModelInProvider;
-}

package/dist/types/llm/media-transport.d.ts

@@ -1,176 +0,0 @@
-/**
- * MediaTransport — transport interface for generation APIs (image, video, music, 3D).
- *
- * Parallel to LLMTransport (chat/reasoning), MediaTransport handles
- * non-chat generation endpoints that each vendor exposes differently:
- *   - Sync (OpenAI images, Volcengine Seedream, Gemini generateContent)
- *   - Async job (Volcengine Seedance/3D, MiniMax music) — submit → poll → result
- *
- * Each provider adapter implements this interface and hides vendor-specific
- * auth, endpoint paths, request shapes, and polling logic.
- */
-export type MediaType = "image" | "video" | "music" | "music_realtime" | "tts" | "3d" | "stt" | "embedding" | "video_understanding" | "image_understanding" | "voice_clone" | "rerank" | "document_parsing" | "realtime_audio";
-export interface MediaRequest {
-    /** Generation model id, e.g. "doubao-seedream-5-0-260128", "gpt-image-2" */
-    model: string;
-    /** What kind of media to generate */
-    mediaType: MediaType;
-    /** Text prompt for generation */
-    prompt: string;
-    /** Optional reference image URL (img2img, i2v, img-to-3d) */
-    imageUrl?: string;
-    /** Desired dimensions, e.g. "1024x1024" */
-    size?: string;
-    /** Aspect ratio for video, e.g. "16:9" */
-    aspectRatio?: string;
-    /** Duration in seconds (video, music) */
-    duration?: number;
-    /** Number of outputs (image) */
-    n?: number;
-    /** Visual/musical style */
-    style?: string;
-    /** Intended use / purpose */
-    purpose?: string;
-    /** Lyrics for music generation */
-    lyrics?: string;
-    /** Text for TTS */
-    text?: string;
-    /** TTS channel hint */
-    channel?: string;
-    /** Source video URLs for edit/merge operations */
-    sourceVideos?: string[];
-    /** Reference images (no role / first_frame / last_frame) */
-    referenceImages?: string[];
-    /** Reference image roles — parallel array with referenceImages. */
-    imageRoles?: Array<"first_frame" | "last_frame" | "reference_image">;
-    /** Reference video URLs for multimodal reference generation (Seedance 2.0) */
-    referenceVideos?: string[];
-    /** Reference audio URLs for multimodal reference generation (Seedance 2.0) */
-    referenceAudios?: string[];
-    /** Generate synchronized audio track (Seedance 2.0 / 1.5 pro) */
-    generateAudio?: boolean;
-    /** Output resolution for upscale, e.g. "1080p" */
-    resolution?: string;
-    /** Operation variant: generate (default), edit, merge, upscale, multimodal_reference, extend */
-    operation?: "generate" | "edit" | "merge" | "upscale" | "multimodal_reference" | "extend";
-    /** Image/video quality, e.g. "auto", "high", "low", "hd" */
-    quality?: string;
-    /** Seed for reproducible generation */
-    seed?: number;
-    /** TTS voice, e.g. "alloy", "nova", "shimmer" */
-    voice?: string;
-    /** TTS speech speed multiplier */
-    speed?: number;
-    /** Pure instrumental mode (MiniMax music) */
-    isInstrumental?: boolean;
-    /** Source audio URL for cover/remix (MiniMax music) */
-    audioUrl?: string;
-    /** Output audio format, e.g. "mp3", "wav", "flac" */
-    audioFormat?: string;
-    /** Video frames per second */
-    fps?: number;
-    /** Whether to add AI watermark */
-    watermark?: boolean;
-    /** img2img guidance/control strength (0-1), e.g. Volcengine */
-    guidanceScale?: number;
-    /** Auto-generate lyrics when none provided (MiniMax) */
-    lyricsOptimizer?: boolean;
-    /** 3D output format, e.g. "glb", "obj", "usd", "usdz" */
-    outputFormat?: string;
-    /** Image background mode (OpenAI gpt-image-2): "transparent", "opaque", "auto" */
-    background?: string;
-    /** Provider-specific request metadata (e.g. rerank documents, parsing options) */
-    metadata?: Record<string, unknown>;
-    /** Ask the provider to optimize/enhance the prompt before generation */
-    enhancePrompt?: boolean;
-    /**
-     * Progress callback for async polling operations (video gen, 3D gen, etc.).
-     * Called periodically with estimated progress percentage, status text, and
-     * the provider-specific task ID (available once the task is submitted).
-     */
-    onProgress?: (percent: number, status: string, taskId?: string) => void;
-    /** Enable progressive/streaming image generation (Volcengine Seedream stream:true) */
-    streamImage?: boolean;
-    /** Lock camera position (Seedance 1.0/1.5, not Seedance 2.0) */
-    cameraFixed?: boolean;
-    /** Return last frame URL for chaining continuous video segments */
-    returnLastFrame?: boolean;
-    /** Service tier: 'default' (online) or 'flex' (offline, ~50% cost) — not all models support flex */
-    serviceTier?: "default" | "flex";
-    /** Task expiration in seconds (for flex/offline scheduling) */
-    executionExpiresAfterSeconds?: number;
-    /** Draft mode — low-cost preview (Seedance 1.5 pro only) */
-    draft?: boolean;
-    /** Draft task ID to promote to final video */
-    draftTaskId?: string;
-    /** Video-level builtin tools, e.g. ["web_search"] (Seedance 2.0) */
-    videoTools?: string[];
-    /** End-user safety identifier for content moderation */
-    safetyIdentifier?: string;
-    /** Callback URL for async task status push notifications */
-    callbackUrl?: string;
-    /** Image detail level control: 'auto' | 'low' | 'high' */
-    detail?: "auto" | "low" | "high";
-    /** Max image pixels budget (Volcengine image_pixel_limit) */
-    imagePixelLimit?: number;
-}
-export interface MediaResult {
-    /** URLs of generated media files */
-    mediaUrls: string[];
-    /** Model actually used */
-    model?: string;
-    /** Output dimensions / format info */
-    size?: string;
-    /** Total generation time in ms */
-    durationMs?: number;
-    /** Billing unit type for non-token models */
-    billingUnit?: "per_call" | "per_second" | "per_character" | "per_pixel" | "per_token";
-    /** Quantity consumed (seconds, characters, pixels, etc.) */
-    billingQuantity?: number;
-    /** Provider-specific metadata */
-    metadata?: Record<string, unknown>;
-    /** Last frame image URL for chaining continuous video generation */
-    lastFrameUrl?: string;
-    /** Task ID (for continuing draft→final or querying) */
-    taskId?: string;
-}
-export interface MediaTransport {
-    /**
-     * Generate media content.
-     * Handles sync APIs directly and async job APIs (submit + poll) internally.
-     *
-     * @param request - Generation parameters
-     * @param apiKey  - User API key (passed explicitly, not from env)
-     * @param signal  - Optional abort signal
-     */
-    generate(request: MediaRequest, apiKey: string, signal?: AbortSignal): Promise<MediaResult>;
-    /**
-     * Which media types this transport supports.
-     * Used by the media client factory to route requests.
-     */
-    readonly supportedTypes: readonly MediaType[];
-}
-/**
- * Extended transport for providers that support async task management
- * (submit → poll → cancel/query). Volcengine Seedance, MiniMax async, etc.
- */
-export interface AsyncMediaTransport extends MediaTransport {
-    /** Cancel / delete an async task. */
-    deleteVideoTask(taskId: string, apiKey: string, signal?: AbortSignal): Promise<void>;
-    /** List recent tasks for status queries. */
-    listVideoTasks(apiKey: string, options?: {
-        after?: string;
-        limit?: number;
-        status?: string;
-    }, signal?: AbortSignal): Promise<Record<string, unknown>>;
-    /**
-     * Query a single task by ID — preferred over listVideoTasks for direct lookups.
-     * Not all providers support listing; all async providers support single-task queries.
-     */
-    getTaskStatus?(taskId: string, apiKey: string, signal?: AbortSignal): Promise<{
-        status: string;
-        task: Record<string, unknown>;
-    }>;
-}
-/** Type guard for transports that support async task management. */
-export declare function isAsyncMediaTransport(t: MediaTransport): t is AsyncMediaTransport;