@puppetry.com/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1105 @@
+import { A as ApiErrorResponse, P as PuppetryVideoJob, U as UsageVideoGenerationReadiness, V as VideoEvent, a as AudioUploadUrlResponse, b as PuppetryVoiceList, c as Usage, C as CreateTextVideoParams, d as CreateAudioVideoParams, W as WaitForCompletionOptions, e as CreateAudioUploadUrlParams, f as Puppetry } from './mcp-ChYQVbVe.js';
+export { g as ApiUploadLimits, h as AudioUploadBody, i as CreatePuppetParams, j as CreatePuppetryTtsParams, J as JsonRpcErrorResponse, k as JsonRpcId, l as JsonRpcRequest, m as JsonRpcResponse, n as JsonRpcSuccessResponse, L as ListPuppetsParams, o as ListVoicesParams, p as PaginatedResponse, q as Puppet, r as PuppetryConfig, s as PuppetryMcpServerInfo, t as PuppetryRequestRetryEvent, u as PuppetryTtsResponse, v as PuppetryVoice, w as UploadAudioParams, x as VideoEventType, y as VideoJob, z as VideoJobHelpers, B as VideoJobSource, D as VideoStatus, E as Voice, F as handlePuppetryMcpRequest } from './mcp-ChYQVbVe.js';
+
+type PuppetryErrorOptions = {
+    object?: string;
+    retryAfter?: number;
+    retryable?: boolean;
+    credits?: VideoStatusCredits;
+    creation_credits?: VideoCreationCredits;
+    creationCredits?: VideoCreationCredits;
+    retry_blocked_reason?: string;
+    retryBlockedReason?: string;
+    retry_block_code?: string;
+    retryBlockCode?: string;
+    id?: string;
+    job_id?: string;
+    jobId?: string;
+    operation_id?: string;
+    operationId?: string;
+    task_id?: string;
+    taskId?: string;
+    status_url?: string;
+    statusUrl?: string;
+    content_location?: string;
+    contentLocation?: string;
+    created_at?: string;
+    createdAt?: string;
+    expires_at?: string;
+    expiresAt?: string;
+    next_poll_at?: string;
+    nextPollAt?: string;
+    source?: string;
+    request_source?: string;
+    requestSource?: string;
+    request_id?: string;
+    requestId?: string;
+    required_credits?: number;
+    requiredCredits?: number;
+    credits_remaining?: number;
+    creditsRemaining?: number;
+    remaining_credits?: number;
+    remainingCredits?: number;
+};
+type VideoStatusCredits = {
+    charged: number;
+    remaining: number | null;
+};
+type VideoCreationCredits = {
+    charged: number;
+    remaining_after_debit: number | null;
+    remainingAfterDebit: number | null;
+};
+declare class PuppetryError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    readonly object?: string;
+    readonly retryAfter?: number;
+    readonly retryable?: boolean;
+    readonly credits?: VideoStatusCredits;
+    readonly creation_credits?: VideoCreationCredits;
+    readonly creationCredits?: VideoCreationCredits;
+    readonly retry_blocked_reason?: string;
+    readonly retryBlockedReason?: string;
+    readonly retry_block_code?: string;
+    readonly retryBlockCode?: string;
+    readonly id?: string;
+    readonly job_id?: string;
+    readonly jobId?: string;
+    readonly operation_id?: string;
+    readonly operationId?: string;
+    readonly task_id?: string;
+    readonly taskId?: string;
+    readonly status_url?: string;
+    readonly statusUrl?: string;
+    readonly content_location?: string;
+    readonly contentLocation?: string;
+    readonly created_at?: string;
+    readonly createdAt?: string;
+    readonly expires_at?: string;
+    readonly expiresAt?: string;
+    readonly next_poll_at?: string;
+    readonly nextPollAt?: string;
+    readonly source?: string;
+    readonly request_source?: string;
+    readonly requestSource?: string;
+    readonly request_id?: string;
+    readonly requestId?: string;
+    readonly required_credits?: number;
+    readonly requiredCredits?: number;
+    readonly credits_remaining?: number;
+    readonly creditsRemaining?: number;
+    readonly remaining_credits?: number;
+    readonly remainingCredits?: number;
+    constructor(status: number, code: string, message: string, details?: Record<string, unknown>, options?: PuppetryErrorOptions);
+    static fromResponse(status: number, body: ApiErrorResponse, options?: PuppetryErrorOptions): PuppetryError;
+}
+declare class PuppetryTimeoutError extends PuppetryError {
+    constructor(timeoutMs: number);
+}
+declare class PuppetryAuthError extends PuppetryError {
+    constructor(message?: string);
+}
+declare class PuppetryRateLimitError extends PuppetryError {
+    constructor(retryAfter?: number, message?: string, details?: Record<string, unknown>, code?: string, options?: PuppetryErrorOptions);
+    static fromRateLimitResponse(body: ApiErrorResponse, options?: PuppetryErrorOptions): PuppetryRateLimitError;
+}
+declare class PuppetryNetworkError extends PuppetryError {
+    constructor(message?: string);
+}
+type SerializedPuppetryError = Record<string, unknown> & {
+    status: number;
+    statusCode: number;
+    code: string;
+    message: string;
+};
+declare function puppetryErrorData(err: PuppetryError): SerializedPuppetryError;
+
+type JobStatusInput = {
+    jobId: string;
+    job_id?: string;
+    task_id?: string;
+    taskId?: string;
+    id?: string;
+} | {
+    jobId?: string;
+    job_id: string;
+    task_id?: string;
+    taskId?: string;
+    id?: string;
+} | {
+    jobId?: string;
+    job_id?: string;
+    task_id: string;
+    taskId?: string;
+    id?: string;
+} | {
+    jobId?: string;
+    job_id?: string;
+    task_id?: string;
+    taskId: string;
+    id?: string;
+} | {
+    jobId?: string;
+    job_id?: string;
+    task_id?: string;
+    taskId?: string;
+    id: string;
+};
+type JobWaitInput = JobStatusInput & Pick<WaitForCompletionOptions, "intervalMs" | "timeoutMs" | "initialDelayMs">;
+type WaitOptionInput = Pick<WaitForCompletionOptions, "intervalMs" | "timeoutMs" | "initialDelayMs">;
+type VideoReadinessPreflightInput = {
+    preflightReadiness?: boolean;
+    preflight_readiness?: boolean;
+};
+type TextVideoCreateInput = CreateTextVideoParams & VideoReadinessPreflightInput;
+type AudioVideoCreateInput = CreateAudioVideoParams & VideoReadinessPreflightInput;
+type TextVideoCreateAndWaitInput = CreateTextVideoParams & WaitOptionInput & VideoReadinessPreflightInput;
+type AudioVideoCreateAndWaitInput = CreateAudioVideoParams & WaitOptionInput & VideoReadinessPreflightInput;
+type VideoCreditEvidence = NonNullable<PuppetryVideoJob["credits"]>;
+type VideoCreationCreditEvidence = {
+    charged: number;
+    remaining_after_debit: number | null;
+    remainingAfterDebit: number | null;
+};
+interface PuppetryVideoCreateAndWaitResult {
+    object: "video_flow";
+    accepted_job: PuppetryVideoJob;
+    acceptedJob: PuppetryVideoJob;
+    final_job: PuppetryVideoJob;
+    finalJob: PuppetryVideoJob;
+    accepted_credits?: VideoCreditEvidence;
+    acceptedCredits?: VideoCreditEvidence;
+    final_credits?: VideoCreditEvidence;
+    finalCredits?: VideoCreditEvidence;
+    credits?: VideoCreditEvidence;
+    creation_credits?: VideoCreationCreditEvidence;
+    creationCredits?: VideoCreationCreditEvidence;
+    job_id: string;
+    jobId: string;
+    operation_id: string;
+    operationId: string;
+    request_id?: string;
+    requestId?: string;
+    status: PuppetryVideoJob["status"];
+    completed: boolean;
+    readiness?: UsageVideoGenerationReadiness;
+    readiness_checked: boolean;
+    readinessChecked: boolean;
+    poll_count: number;
+    pollCount: number;
+    retry_count: number;
+    retryCount: number;
+    latest_retrying_event?: VideoEvent;
+    latestRetryingEvent?: VideoEvent;
+    duration_ms: number;
+    durationMs: number;
+    video_url?: string | null;
+    videoUrl?: string | null;
+}
+type PuppetryVideoCreateResult = PuppetryVideoJob & {
+    readiness?: UsageVideoGenerationReadiness;
+    readiness_checked: boolean;
+    readinessChecked: boolean;
+};
+declare const PUPPETRY_AGENT_TOOLS: readonly [{
+    readonly name: "puppetry_create_video_from_text";
+    readonly resource: "videos.createFromText";
+    readonly description: "Create a talking-head video from a portrait image and text.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly [];
+        readonly allOf: readonly [{
+            readonly anyOf: readonly [{
+                readonly required: readonly ["text"];
+            }, {
+                readonly required: readonly ["script"];
+            }, {
+                readonly required: readonly ["prompt"];
+            }];
+        }, {
+            readonly anyOf: readonly [{
+                readonly required: readonly ["image_url"];
+            }, {
+                readonly required: readonly ["imageUrl"];
+            }, {
+                readonly required: readonly ["image"];
+            }, {
+                readonly required: readonly ["portrait"];
+            }, {
+                readonly required: readonly ["portrait_url"];
+            }, {
+                readonly required: readonly ["portraitUrl"];
+            }, {
+                readonly required: readonly ["avatar"];
+            }, {
+                readonly required: readonly ["avatarUrl"];
+            }, {
+                readonly required: readonly ["avatar_url"];
+            }, {
+                readonly required: readonly ["photo"];
+            }, {
+                readonly required: readonly ["photoUrl"];
+            }, {
+                readonly required: readonly ["photo_url"];
+            }];
+        }];
+        readonly properties: {
+            readonly preflightReadiness: {
+                readonly type: "boolean";
+                readonly description: "Check video credits and active slots before queueing. Defaults to false on create-only tools and true on create-and-wait tools.";
+            };
+            readonly preflight_readiness: {
+                readonly type: "boolean";
+                readonly description: "Snake_case alias for preflightReadiness.";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Script to synthesize and animate.";
+            };
+            readonly script: {
+                readonly type: "string";
+                readonly description: "Alias for text script to synthesize and animate.";
+            };
+            readonly prompt: {
+                readonly type: "string";
+                readonly description: "Alias for text script, useful for prompt-oriented agents.";
+            };
+            readonly image_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL.";
+            };
+            readonly imageUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly image: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias for agents.";
+            };
+            readonly portrait: {
+                readonly type: "string";
+                readonly description: "Deprecated hosted portrait image URL alias.";
+            };
+            readonly portrait_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL snake_case alias.";
+            };
+            readonly portraitUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly avatar: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatarUrl: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatar_url: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL snake_case alias.";
+            };
+            readonly photo: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photoUrl: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photo_url: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL snake_case alias.";
+            };
+            readonly voice_id: {
+                readonly type: "string";
+                readonly description: "Optional Puppetry voice ID from voices.listPuppetry().";
+            };
+            readonly voiceId: {
+                readonly type: "string";
+                readonly description: "Optional Puppetry voice ID alias.";
+            };
+            readonly voice: {
+                readonly type: "string";
+                readonly description: "Optional Puppetry voice ID alias for SDK examples.";
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly description: "Optional language code, such as en.";
+            };
+            readonly expressiveness: {
+                readonly type: "number";
+                readonly description: "Optional animation expressiveness from 0 to 2.";
+            };
+            readonly idempotencyKey: {
+                readonly type: "string";
+                readonly description: "Optional retry key sent as Idempotency-Key.";
+            };
+            readonly idempotency_key: {
+                readonly type: "string";
+                readonly description: "Optional retry key alias sent as Idempotency-Key.";
+            };
+        };
+    };
+}, {
+    readonly name: "puppetry_create_video_from_audio";
+    readonly resource: "videos.createFromAudio";
+    readonly description: "Create a talking-head video from a portrait image and audio.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly [];
+        readonly allOf: readonly [{
+            readonly anyOf: readonly [{
+                readonly required: readonly ["image_url"];
+            }, {
+                readonly required: readonly ["imageUrl"];
+            }, {
+                readonly required: readonly ["image"];
+            }, {
+                readonly required: readonly ["portrait"];
+            }, {
+                readonly required: readonly ["portrait_url"];
+            }, {
+                readonly required: readonly ["portraitUrl"];
+            }, {
+                readonly required: readonly ["avatar"];
+            }, {
+                readonly required: readonly ["avatarUrl"];
+            }, {
+                readonly required: readonly ["avatar_url"];
+            }, {
+                readonly required: readonly ["photo"];
+            }, {
+                readonly required: readonly ["photoUrl"];
+            }, {
+                readonly required: readonly ["photo_url"];
+            }];
+        }, {
+            readonly anyOf: readonly [{
+                readonly required: readonly ["audio_url"];
+            }, {
+                readonly required: readonly ["audioUrl"];
+            }, {
+                readonly required: readonly ["audio"];
+            }];
+        }];
+        readonly properties: {
+            readonly preflightReadiness: {
+                readonly type: "boolean";
+                readonly description: "Check video credits and active slots before queueing. Defaults to false on create-only tools and true on create-and-wait tools.";
+            };
+            readonly preflight_readiness: {
+                readonly type: "boolean";
+                readonly description: "Snake_case alias for preflightReadiness.";
+            };
+            readonly audio_url: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL.";
+            };
+            readonly audioUrl: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL alias.";
+            };
+            readonly audio: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL alias for agents.";
+            };
+            readonly image_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL.";
+            };
+            readonly imageUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly image: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias for agents.";
+            };
+            readonly portrait: {
+                readonly type: "string";
+                readonly description: "Deprecated hosted portrait image URL alias.";
+            };
+            readonly portrait_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL snake_case alias.";
+            };
+            readonly portraitUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly avatar: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatarUrl: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatar_url: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL snake_case alias.";
+            };
+            readonly photo: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photoUrl: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photo_url: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL snake_case alias.";
+            };
+            readonly expressiveness: {
+                readonly type: "number";
+                readonly description: "Optional animation expressiveness from 0 to 2.";
+            };
+            readonly idempotencyKey: {
+                readonly type: "string";
+                readonly description: "Optional retry key sent as Idempotency-Key.";
+            };
+            readonly idempotency_key: {
+                readonly type: "string";
+                readonly description: "Optional retry key alias sent as Idempotency-Key.";
+            };
+        };
+    };
+}, {
+    readonly name: "puppetry_create_video_from_text_and_wait";
+    readonly resource: "videos.createFromText.waitForCompletion";
+    readonly description: "Create a talking-head video from text and wait for completed or failed status.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly [];
+        readonly allOf: readonly [{
+            readonly anyOf: readonly [{
+                readonly required: readonly ["text"];
+            }, {
+                readonly required: readonly ["script"];
+            }, {
+                readonly required: readonly ["prompt"];
+            }];
+        }, {
+            readonly anyOf: readonly [{
+                readonly required: readonly ["image_url"];
+            }, {
+                readonly required: readonly ["imageUrl"];
+            }, {
+                readonly required: readonly ["image"];
+            }, {
+                readonly required: readonly ["portrait"];
+            }, {
+                readonly required: readonly ["portrait_url"];
+            }, {
+                readonly required: readonly ["portraitUrl"];
+            }, {
+                readonly required: readonly ["avatar"];
+            }, {
+                readonly required: readonly ["avatarUrl"];
+            }, {
+                readonly required: readonly ["avatar_url"];
+            }, {
+                readonly required: readonly ["photo"];
+            }, {
+                readonly required: readonly ["photoUrl"];
+            }, {
+                readonly required: readonly ["photo_url"];
+            }];
+        }];
+        readonly properties: {
+            readonly intervalMs: {
+                readonly type: "number";
+                readonly description: "Polling interval in milliseconds. Defaults to 2000.";
+            };
+            readonly timeoutMs: {
+                readonly type: "number";
+                readonly description: "Maximum wait time in milliseconds. Defaults to 300000.";
+            };
+            readonly initialDelayMs: {
+                readonly type: "number";
+                readonly description: "Optional delay before the first status request, useful with Retry-After.";
+            };
+            readonly preflightReadiness: {
+                readonly type: "boolean";
+                readonly description: "Check video credits and active slots before queueing. Defaults to false on create-only tools and true on create-and-wait tools.";
+            };
+            readonly preflight_readiness: {
+                readonly type: "boolean";
+                readonly description: "Snake_case alias for preflightReadiness.";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly description: "Script to synthesize and animate.";
+            };
+            readonly script: {
+                readonly type: "string";
+                readonly description: "Alias for text script to synthesize and animate.";
+            };
+            readonly prompt: {
+                readonly type: "string";
+                readonly description: "Alias for text script, useful for prompt-oriented agents.";
+            };
+            readonly image_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL.";
+            };
+            readonly imageUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly image: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias for agents.";
+            };
+            readonly portrait: {
+                readonly type: "string";
+                readonly description: "Deprecated hosted portrait image URL alias.";
+            };
+            readonly portrait_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL snake_case alias.";
+            };
+            readonly portraitUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly avatar: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatarUrl: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatar_url: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL snake_case alias.";
+            };
+            readonly photo: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photoUrl: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photo_url: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL snake_case alias.";
+            };
+            readonly voice_id: {
+                readonly type: "string";
+                readonly description: "Optional Puppetry voice ID from voices.listPuppetry().";
+            };
+            readonly voiceId: {
+                readonly type: "string";
+                readonly description: "Optional Puppetry voice ID alias.";
+            };
+            readonly voice: {
+                readonly type: "string";
+                readonly description: "Optional Puppetry voice ID alias for SDK examples.";
+            };
+            readonly language: {
+                readonly type: "string";
+                readonly description: "Optional language code, such as en.";
+            };
+            readonly expressiveness: {
+                readonly type: "number";
+                readonly description: "Optional animation expressiveness from 0 to 2.";
+            };
+            readonly idempotencyKey: {
+                readonly type: "string";
+                readonly description: "Optional retry key sent as Idempotency-Key.";
+            };
+            readonly idempotency_key: {
+                readonly type: "string";
+                readonly description: "Optional retry key alias sent as Idempotency-Key.";
+            };
+        };
+    };
+}, {
+    readonly name: "puppetry_create_video_from_audio_and_wait";
+    readonly resource: "videos.createFromAudio.waitForCompletion";
+    readonly description: "Create a talking-head video from audio and wait for completed or failed status.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly [];
+        readonly allOf: readonly [{
+            readonly anyOf: readonly [{
+                readonly required: readonly ["image_url"];
+            }, {
+                readonly required: readonly ["imageUrl"];
+            }, {
+                readonly required: readonly ["image"];
+            }, {
+                readonly required: readonly ["portrait"];
+            }, {
+                readonly required: readonly ["portrait_url"];
+            }, {
+                readonly required: readonly ["portraitUrl"];
+            }, {
+                readonly required: readonly ["avatar"];
+            }, {
+                readonly required: readonly ["avatarUrl"];
+            }, {
+                readonly required: readonly ["avatar_url"];
+            }, {
+                readonly required: readonly ["photo"];
+            }, {
+                readonly required: readonly ["photoUrl"];
+            }, {
+                readonly required: readonly ["photo_url"];
+            }];
+        }, {
+            readonly anyOf: readonly [{
+                readonly required: readonly ["audio_url"];
+            }, {
+                readonly required: readonly ["audioUrl"];
+            }, {
+                readonly required: readonly ["audio"];
+            }];
+        }];
+        readonly properties: {
+            readonly intervalMs: {
+                readonly type: "number";
+                readonly description: "Polling interval in milliseconds. Defaults to 2000.";
+            };
+            readonly timeoutMs: {
+                readonly type: "number";
+                readonly description: "Maximum wait time in milliseconds. Defaults to 300000.";
+            };
+            readonly initialDelayMs: {
+                readonly type: "number";
+                readonly description: "Optional delay before the first status request, useful with Retry-After.";
+            };
+            readonly preflightReadiness: {
+                readonly type: "boolean";
+                readonly description: "Check video credits and active slots before queueing. Defaults to false on create-only tools and true on create-and-wait tools.";
+            };
+            readonly preflight_readiness: {
+                readonly type: "boolean";
+                readonly description: "Snake_case alias for preflightReadiness.";
+            };
+            readonly audio_url: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL.";
+            };
+            readonly audioUrl: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL alias.";
+            };
+            readonly audio: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL alias for agents.";
+            };
+            readonly image_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL.";
+            };
+            readonly imageUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly image: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias for agents.";
+            };
+            readonly portrait: {
+                readonly type: "string";
+                readonly description: "Deprecated hosted portrait image URL alias.";
+            };
+            readonly portrait_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL snake_case alias.";
+            };
+            readonly portraitUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly avatar: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatarUrl: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatar_url: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL snake_case alias.";
+            };
+            readonly photo: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photoUrl: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photo_url: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL snake_case alias.";
+            };
+            readonly expressiveness: {
+                readonly type: "number";
+                readonly description: "Optional animation expressiveness from 0 to 2.";
+            };
+            readonly idempotencyKey: {
+                readonly type: "string";
+                readonly description: "Optional retry key sent as Idempotency-Key.";
+            };
+            readonly idempotency_key: {
+                readonly type: "string";
+                readonly description: "Optional retry key alias sent as Idempotency-Key.";
+            };
+        };
+    };
+}, {
+    readonly name: "puppetry_create_audio_upload_url";
+    readonly resource: "uploads.createAudioUrl";
+    readonly description: "Reserve a Puppetry-hosted signed audio upload URL for audio-to-video workflows.";
+    readonly inputSchema: {
+        readonly properties: {
+            readonly mime_type: {
+                readonly type: "string";
+                readonly description: "Audio MIME type, such as audio/wav, audio/mpeg, or audio/mp4.";
+            };
+            readonly mimeType: {
+                readonly type: "string";
+                readonly description: "Audio MIME type alias.";
+            };
+            readonly contentType: {
+                readonly type: "string";
+                readonly description: "Audio MIME type alias for signed-upload callers.";
+            };
+            readonly content_length: {
+                readonly type: "number";
+                readonly description: "Exact byte length of the audio file to upload.";
+            };
+            readonly contentLength: {
+                readonly type: "number";
+                readonly description: "Exact byte length alias.";
+            };
+            readonly sizeBytes: {
+                readonly type: "number";
+                readonly description: "Exact byte length alias for agent/runtime callers.";
+            };
+            readonly file_size: {
+                readonly type: "number";
+                readonly description: "Exact byte length alias for upload metadata callers.";
+            };
+            readonly fileSize: {
+                readonly type: "number";
+                readonly description: "Exact byte length alias for upload metadata callers.";
+            };
+            readonly idempotencyKey: {
+                readonly type: "string";
+                readonly description: "Optional retry key sent as Idempotency-Key.";
+            };
+            readonly idempotency_key: {
+                readonly type: "string";
+                readonly description: "Optional retry key alias sent as Idempotency-Key.";
+            };
+        };
+        readonly allOf: readonly [{
+            readonly anyOf: readonly [{
+                readonly required: readonly ["mime_type"];
+            }, {
+                readonly required: readonly ["mimeType"];
+            }, {
+                readonly required: readonly ["contentType"];
+            }];
+        }, {
+            readonly anyOf: readonly [{
+                readonly required: readonly ["content_length"];
+            }, {
+                readonly required: readonly ["contentLength"];
+            }, {
+                readonly required: readonly ["sizeBytes"];
+            }, {
+                readonly required: readonly ["file_size"];
+            }, {
+                readonly required: readonly ["fileSize"];
+            }];
+        }];
+        readonly type: "object";
+        readonly required: readonly [];
+    };
+}, {
+    readonly name: "puppetry_lipsync";
+    readonly resource: "videos.createFromAudio";
+    readonly description: "Lip sync a portrait or puppet with an existing audio URL.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly [];
+        readonly allOf: readonly [{
+            readonly anyOf: readonly [{
+                readonly required: readonly ["image_url"];
+            }, {
+                readonly required: readonly ["imageUrl"];
+            }, {
+                readonly required: readonly ["image"];
+            }, {
+                readonly required: readonly ["portrait"];
+            }, {
+                readonly required: readonly ["portrait_url"];
+            }, {
+                readonly required: readonly ["portraitUrl"];
+            }, {
+                readonly required: readonly ["avatar"];
+            }, {
+                readonly required: readonly ["avatarUrl"];
+            }, {
+                readonly required: readonly ["avatar_url"];
+            }, {
+                readonly required: readonly ["photo"];
+            }, {
+                readonly required: readonly ["photoUrl"];
+            }, {
+                readonly required: readonly ["photo_url"];
+            }];
+        }, {
+            readonly anyOf: readonly [{
+                readonly required: readonly ["audio_url"];
+            }, {
+                readonly required: readonly ["audioUrl"];
+            }, {
+                readonly required: readonly ["audio"];
+            }];
+        }];
+        readonly properties: {
+            readonly audio_url: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL.";
+            };
+            readonly audioUrl: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL alias.";
+            };
+            readonly audio: {
+                readonly type: "string";
+                readonly description: "Hosted audio URL alias for agents.";
+            };
+            readonly image_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL.";
+            };
+            readonly imageUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly image: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias for agents.";
+            };
+            readonly portrait: {
+                readonly type: "string";
+                readonly description: "Deprecated hosted portrait image URL alias.";
+            };
+            readonly portrait_url: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL snake_case alias.";
+            };
+            readonly portraitUrl: {
+                readonly type: "string";
+                readonly description: "Hosted portrait image URL alias.";
+            };
+            readonly avatar: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatarUrl: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL alias.";
+            };
+            readonly avatar_url: {
+                readonly type: "string";
+                readonly description: "Hosted avatar image URL snake_case alias.";
+            };
+            readonly photo: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photoUrl: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL alias.";
+            };
+            readonly photo_url: {
+                readonly type: "string";
+                readonly description: "Hosted photo image URL snake_case alias.";
+            };
+            readonly idempotencyKey: {
+                readonly type: "string";
+                readonly description: "Optional retry key sent as Idempotency-Key.";
+            };
+            readonly idempotency_key: {
+                readonly type: "string";
+                readonly description: "Optional retry key alias sent as Idempotency-Key.";
+            };
+        };
+    };
+}, {
+    readonly name: "puppetry_list_voices";
+    readonly resource: "voices.listPuppetry";
+    readonly description: "List Puppetry-hosted voices with preview text and audio.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "puppetry_get_job_status";
+    readonly resource: "jobs.get";
+    readonly description: "Fetch a generated video job by ID.";
+    readonly inputSchema: {
+        readonly properties: {
+            readonly jobId: {
+                readonly type: "string";
+                readonly description: "Generated video job ID.";
+            };
+            readonly job_id: {
+                readonly type: "string";
+                readonly description: "Generated video job ID alias.";
+            };
+            readonly task_id: {
+                readonly type: "string";
+                readonly description: "Generated video task ID alias.";
+            };
+            readonly taskId: {
+                readonly type: "string";
+                readonly description: "Generated video task ID camelCase alias.";
+            };
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Generated video ID alias.";
+            };
+        };
+        readonly anyOf: readonly [{
+            readonly required: readonly ["jobId"];
+        }, {
+            readonly required: readonly ["job_id"];
+        }, {
+            readonly required: readonly ["task_id"];
+        }, {
+            readonly required: readonly ["taskId"];
+        }, {
+            readonly required: readonly ["id"];
+        }];
+        readonly type: "object";
+        readonly required: readonly [];
+    };
+}, {
+    readonly name: "puppetry_wait_for_video";
+    readonly resource: "videos.waitForCompletion";
+    readonly description: "Poll a generated video job until it reaches completed or failed.";
+    readonly inputSchema: {
+        readonly properties: {
+            readonly jobId: {
+                readonly type: "string";
+                readonly description: "Generated video job ID.";
+            };
+            readonly job_id: {
+                readonly type: "string";
+                readonly description: "Generated video job ID alias.";
+            };
+            readonly task_id: {
+                readonly type: "string";
+                readonly description: "Generated video task ID alias.";
+            };
+            readonly taskId: {
+                readonly type: "string";
+                readonly description: "Generated video task ID camelCase alias.";
+            };
+            readonly id: {
+                readonly type: "string";
+                readonly description: "Generated video ID alias.";
+            };
+            readonly intervalMs: {
+                readonly type: "number";
+                readonly description: "Polling interval in milliseconds. Defaults to 2000.";
+            };
+            readonly timeoutMs: {
+                readonly type: "number";
+                readonly description: "Maximum wait time in milliseconds. Defaults to 300000.";
+            };
+            readonly initialDelayMs: {
+                readonly type: "number";
+                readonly description: "Optional delay before the first status request, useful with Retry-After.";
+            };
+        };
+        readonly anyOf: readonly [{
+            readonly required: readonly ["jobId"];
+        }, {
+            readonly required: readonly ["job_id"];
+        }, {
+            readonly required: readonly ["task_id"];
+        }, {
+            readonly required: readonly ["taskId"];
+        }, {
+            readonly required: readonly ["id"];
+        }];
+        readonly type: "object";
+        readonly required: readonly [];
+    };
+}, {
+    readonly name: "puppetry_get_video_readiness";
+    readonly resource: "videos.getReadiness";
+    readonly description: "Check whether credit-backed video creation can run now, including credit and active-slot blockers.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "puppetry_get_quota";
+    readonly resource: "quota.get";
+    readonly description: "Check current plan, credit usage, and remaining credits.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}];
+type PuppetryAgentTool = (typeof PUPPETRY_AGENT_TOOLS)[number];
+type PuppetryAgentToolName = PuppetryAgentTool["name"];
+interface PuppetryAgentToolInputMap {
+    puppetry_create_video_from_text: TextVideoCreateInput;
+    puppetry_create_video_from_audio: AudioVideoCreateInput;
+    puppetry_create_video_from_text_and_wait: TextVideoCreateAndWaitInput;
+    puppetry_create_video_from_audio_and_wait: AudioVideoCreateAndWaitInput;
+    puppetry_create_audio_upload_url: CreateAudioUploadUrlParams;
+    puppetry_lipsync: CreateAudioVideoParams;
+    puppetry_list_voices: Record<string, never>;
+    puppetry_get_job_status: JobStatusInput;
+    puppetry_wait_for_video: JobWaitInput;
+    puppetry_get_video_readiness: Record<string, never>;
+    puppetry_get_quota: Record<string, never>;
+}
+interface PuppetryAgentToolResultMap {
+    puppetry_create_video_from_text: PuppetryVideoCreateResult;
+    puppetry_create_video_from_audio: PuppetryVideoCreateResult;
+    puppetry_create_video_from_text_and_wait: PuppetryVideoCreateAndWaitResult;
+    puppetry_create_video_from_audio_and_wait: PuppetryVideoCreateAndWaitResult;
+    puppetry_create_audio_upload_url: AudioUploadUrlResponse;
+    puppetry_lipsync: PuppetryVideoJob;
+    puppetry_list_voices: PuppetryVoiceList;
+    puppetry_get_job_status: PuppetryVideoJob;
+    puppetry_wait_for_video: PuppetryVideoJob;
+    puppetry_get_video_readiness: NonNullable<Usage["video_generation"]>;
+    puppetry_get_quota: Usage;
+}
+type PuppetryAgentToolSuccess<Name extends PuppetryAgentToolName> = {
+    ok: true;
+    data: PuppetryAgentToolResultMap[Name];
+};
+type PuppetryAgentToolFailure = {
+    ok: false;
+    error: SerializedPuppetryError;
+};
+type PuppetryAgentToolCallResult<Name extends PuppetryAgentToolName> = PuppetryAgentToolSuccess<Name> | PuppetryAgentToolFailure;
+declare function callPuppetryAgentTool<Name extends PuppetryAgentToolName>(client: Puppetry, name: Name, input: PuppetryAgentToolInputMap[Name]): Promise<PuppetryAgentToolResultMap[Name]>;
+declare function safeCallPuppetryAgentTool<Name extends PuppetryAgentToolName>(client: Puppetry, name: Name, input: PuppetryAgentToolInputMap[Name]): Promise<PuppetryAgentToolCallResult<Name>>;
+
+export { AudioUploadUrlResponse, CreateAudioUploadUrlParams, CreateAudioVideoParams, CreateTextVideoParams, PUPPETRY_AGENT_TOOLS, Puppetry, type PuppetryAgentTool, type PuppetryAgentToolCallResult, type PuppetryAgentToolFailure, type PuppetryAgentToolInputMap, type PuppetryAgentToolName, type PuppetryAgentToolResultMap, type PuppetryAgentToolSuccess, PuppetryAuthError, PuppetryError, PuppetryNetworkError, PuppetryRateLimitError, PuppetryTimeoutError, type PuppetryVideoCreateAndWaitResult, type PuppetryVideoCreateResult, PuppetryVideoJob, PuppetryVoiceList, type SerializedPuppetryError, Usage, VideoEvent, WaitForCompletionOptions, callPuppetryAgentTool, puppetryErrorData, safeCallPuppetryAgentTool };