@mux/ai 0.14.0 → 0.16.0

package/dist/{index-yn3fUDgv.d.ts → index-CXC5gAHs.d.ts}

@@ -38,6 +38,8 @@ interface EmbeddingModelIdByProvider {
 interface Question {
     /** The question text */
     question: string;
+    /** Allowed answers for this question (defaults to ["yes", "no"]). */
+    answerOptions?: string[];
 }
 /** A single answer to a question. */
 interface QuestionAnswer {
@@ -60,8 +62,6 @@ interface AskQuestionsOptions extends MuxAIOptions {
     model?: ModelIdByProvider[SupportedProvider];
     /** BCP 47 language code of the caption track to use (e.g. "en", "fr"). When omitted, prefers English if available. */
     languageCode?: string;
-    /** Allowed answers for each question (defaults to ["yes", "no"]). */
-    answerOptions?: string[];
     /** Fetch transcript alongside storyboard (defaults to true, required for audio-only assets). */
     includeTranscript?: boolean;
     /** Strip timestamps/markup from transcripts (defaults to true). */

package/dist/index.d.ts

@@ -2,14 +2,51 @@ import { W as WorkflowCredentials, S as StoragePutObjectInput, a as StoragePresi
 export { A as AssetTextTrack, C as ChunkEmbedding, b as ChunkingStrategy, E as Encrypted, c as EncryptedPayload, I as ImageSubmissionMode, M as MuxAIOptions, d as MuxAsset, P as PlaybackAsset, e as PlaybackPolicy, f as StorageAdapter, T as TextChunk, g as TokenChunkingConfig, h as TokenUsage, i as ToneType, U as UsageMetadata, V as VTTChunkingConfig, j as VideoEmbeddingsResult, k as WorkflowCredentialsInput, l as WorkflowMuxClient, m as decryptFromWorkflow, n as encryptForWorkflow } from './shots-BFYOfBgN.js';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 export { i as primitives } from './index-CuBu_u5-.js';
-export { i as workflows } from './index-yn3fUDgv.js';
+export { i as workflows } from './index-CXC5gAHs.js';
 import '@mux/mux-node';
 import 'zod';
 import '@ai-sdk/anthropic';
 import '@ai-sdk/google';
 import '@ai-sdk/openai';
 
-var version = "0.14.0";
+var version = "0.16.0";
+
+type MuxAiErrorType = "validation_error" | "processing_error" | "timeout_error";
+/**
+ * An error whose message is safe to surface verbatim to the customer.
+ *
+ * Uses a structural brand (`__robots_error = true`) so that downstream
+ * consumers can identify customer-safe errors via duck typing — no
+ * shared dependency required. Errors from @mux/ai that DON'T carry
+ * this brand (unexpected SDK failures, upstream provider errors, etc.)
+ * should be treated as internal and obfuscated.
+ *
+ * Own properties (`publicMessage`, `publicType`, `retryable`) survive
+ * JSON serialization across workflow step boundaries, unlike inherited
+ * `Error.message`.
+ */
+declare class MuxAiError extends Error {
+    /** Structural brand for duck-type identification. */
+    readonly __robots_error = true;
+    /** Error category shown in the API response. */
+    readonly publicType: MuxAiErrorType;
+    /** Customer-facing message. Must be safe to show verbatim. */
+    readonly publicMessage: string;
+    /** Whether the customer should retry the job. */
+    readonly retryable: boolean;
+    constructor(message: string, opts?: {
+        type?: MuxAiErrorType;
+        retryable?: boolean;
+    });
+}
+/**
+ * Re-throws {@link MuxAiError} instances to preserve the structural brand,
+ * wraps everything else in a plain `Error` with a contextual message.
+ *
+ * Use this in catch blocks that re-throw so a customer-safe error from a
+ * callee isn't accidentally converted into an internal error.
+ */
+declare function wrapError(error: unknown, message: string): never;
 
 /**
  * A function that returns workflow credentials, either synchronously or asynchronously.
@@ -45,4 +82,4 @@ declare class WorkflowStorageClient {
 }
 declare function createWorkflowStorageClient(options?: WorkflowStorageClientOptions): WorkflowStorageClient;
 
-export { StoragePresignGetObjectInput, StoragePutObjectInput, WorkflowCredentials, type WorkflowCredentialsProvider, WorkflowStorageClient, createWorkflowStorageClient, setWorkflowCredentialsProvider, version };
+export { MuxAiError, type MuxAiErrorType, StoragePresignGetObjectInput, StoragePutObjectInput, WorkflowCredentials, type WorkflowCredentialsProvider, WorkflowStorageClient, createWorkflowStorageClient, setWorkflowCredentialsProvider, version, wrapError };