blazen 0.1.97 → 0.1.99

package/README.md

@@ -130,22 +130,55 @@ console.log(result.data); // { status: "done" }
 
 ## LLM Integration
 
-`CompletionModel` provides a unified interface to 15 LLM providers. Create a model instance with a static factory method and call `complete()` or `completeWithOptions()`.
+`CompletionModel` provides a unified interface to 15 LLM providers. Create a model instance with a static factory method and call `complete()` or `completeWithOptions()`. All messages and responses are fully typed.
+
+### ChatMessage and Role
+
+Build messages with the `ChatMessage` class and `Role` enum:
 
 ```typescript
-import { CompletionModel } from "blazen";
+import { CompletionModel, ChatMessage, Role } from "blazen";
+import type { CompletionResponse, ToolCall, TokenUsage } from "blazen";
 
 const model = CompletionModel.openrouter(process.env.OPENROUTER_API_KEY!);
 
-const response = await model.complete([
-  { role: "system", content: "You are helpful." },
-  { role: "user", content: "What is 2+2?" },
+// Using static factory methods (recommended)
+const response: CompletionResponse = await model.complete([
+  ChatMessage.system("You are helpful."),
+  ChatMessage.user("What is 2+2?"),
 ]);
 
-console.log(response.content);    // "4"
-console.log(response.model);      // model name used
-console.log(response.usage);      // { promptTokens, completionTokens, totalTokens }
-console.log(response.finishReason);
+console.log(response.content);      // "4"
+console.log(response.model);        // model name used
+console.log(response.usage);        // TokenUsage: { promptTokens, completionTokens, totalTokens }
+console.log(response.finishReason);  // "stop", "tool_calls", etc.
+console.log(response.toolCalls);     // ToolCall[] | undefined
+```
+
+You can also construct messages with the `ChatMessage` constructor:
+
+```typescript
+const msg = new ChatMessage({ role: Role.User, content: "Hello" });
+```
+
+### Multimodal Messages
+
+Send images alongside text using multimodal factory methods:
+
+```typescript
+// Image from URL
+const msg = ChatMessage.userImageUrl("https://example.com/photo.jpg", "What's in this image?");
+
+// Image from base64
+const msg = ChatMessage.userImageBase64(base64Data, "image/png", "Describe this.");
+
+// Multiple content parts
+import type { ContentPart } from "blazen";
+const msg = ChatMessage.userParts([
+  { type: "text", text: "Compare these two images:" },
+  { type: "image_url", imageUrl: { url: "https://example.com/a.jpg" } },
+  { type: "image_url", imageUrl: { url: "https://example.com/b.jpg" } },
+]);
 ```
 
 ### Advanced Options
@@ -153,18 +186,22 @@ console.log(response.finishReason);
 Use `completeWithOptions` to control temperature, token limits, model selection, and tool definitions:
 
 ```typescript
+import type { CompletionOptions } from "blazen";
+
+const options: CompletionOptions = {
+  temperature: 0.9,
+  maxTokens: 256,
+  topP: 0.95,
+  model: "anthropic/claude-sonnet-4-20250514",
+  tools: [/* tool definitions */],
+};
+
 const response = await model.completeWithOptions(
   [
-    { role: "system", content: "You are a creative writer." },
-    { role: "user", content: "Write a haiku about Rust." },
+    ChatMessage.system("You are a creative writer."),
+    ChatMessage.user("Write a haiku about Rust."),
   ],
-  {
-    temperature: 0.9,
-    maxTokens: 256,
-    topP: 0.95,
-    model: "anthropic/claude-sonnet-4-20250514",
-    tools: [/* tool definitions */],
-  }
+  options,
 );
 ```
 
@@ -191,7 +228,7 @@ const response = await model.completeWithOptions(
 ### Using LLMs Inside Workflows
 
 ```typescript
-import { Workflow, CompletionModel } from "blazen";
+import { Workflow, CompletionModel, ChatMessage } from "blazen";
 
 const model = CompletionModel.openai(process.env.OPENAI_API_KEY!);
 
@@ -199,8 +236,8 @@ const wf = new Workflow("llm-workflow");
 
 wf.addStep("ask", ["blazen::StartEvent"], async (event, ctx) => {
   const response = await model.complete([
-    { role: "system", content: "You are a helpful assistant." },
-    { role: "user", content: event.question },
+    ChatMessage.system("You are a helpful assistant."),
+    ChatMessage.user(event.question),
   ]);
   return { type: "blazen::StopEvent", result: { answer: response.content } };
 });
@@ -353,6 +390,12 @@ await ctx.set("key", { any: "value" });
 // Retrieve a stored value (returns null if not found)
 const value = await ctx.get("key");
 
+// Store raw binary data (no serialization requirement)
+await ctx.setBytes("model-weights", buffer);
+
+// Retrieve raw binary data (returns null if not found)
+const data: Buffer | null = await ctx.getBytes("model-weights");
+
 // Send an event through the internal step registry
 await ctx.sendEvent({ type: "MyEvent", data: "..." });
 
@@ -363,6 +406,19 @@ await ctx.writeEventToStream({ type: "Progress", percent: 50 });
 const runId = await ctx.runId();
 ```
 
+### Binary Storage
+
+`setBytes` / `getBytes` let you store raw binary data in the context with no serialization requirement. Store any type by converting to bytes yourself (e.g., MessagePack, protobuf, or raw buffers). Binary data persists through pause/resume/checkpoint.
+
+```typescript
+// Store a raw buffer
+const pixels = Buffer.from([0xff, 0x00, 0x00, 0xff]);
+await ctx.setBytes("image-pixels", pixels);
+
+// Retrieve it later in another step
+const restored = await ctx.getBytes("image-pixels");
+```
+
 ---
 
 ## Timeout
@@ -381,8 +437,14 @@ wf.setTimeout(60); // 60 second timeout
 Full TypeScript type definitions ship with the package -- no `@types` needed. All classes and interfaces are exported.
 
 ```typescript
-import { Workflow, WorkflowHandler, Context, CompletionModel, version } from "blazen";
-import type { JsWorkflowResult } from "blazen";
+import {
+  Workflow, WorkflowHandler, Context, CompletionModel,
+  ChatMessage, Role, version,
+} from "blazen";
+import type {
+  JsWorkflowResult, CompletionResponse, CompletionOptions,
+  ToolCall, TokenUsage, ContentPart, ImageContent, ImageSource,
+} from "blazen";
 ```
 
 ---
@@ -403,15 +465,24 @@ import type { JsWorkflowResult } from "blazen";
 | `WorkflowHandler.pause()` | Pause and get a serialized snapshot string |
 | `WorkflowHandler.streamEvents(callback)` | Subscribe to intermediate stream events |
 | `Context` | Per-run shared state, event routing, and stream output |
-| `Context.set(key, value)` | Store a value (async) |
+| `Context.set(key, value)` | Store a JSON-serializable value (async) |
 | `Context.get(key)` | Retrieve a value (async, returns null if missing) |
+| `Context.setBytes(key, buffer)` | Store raw binary data (async) |
+| `Context.getBytes(key)` | Retrieve raw binary data (async, returns null if missing) |
 | `Context.sendEvent(event)` | Route an event to matching steps (async) |
 | `Context.writeEventToStream(event)` | Publish to external stream consumers (async) |
 | `Context.runId()` | Get the workflow run ID (async) |
 | `CompletionModel` | Unified LLM client with 15 provider factory methods |
-| `CompletionModel.complete(messages)` | Chat completion (async) |
-| `CompletionModel.completeWithOptions(messages, opts)` | Chat completion with temperature, maxTokens, model, tools (async) |
+| `CompletionModel.complete(messages)` | Chat completion with typed `ChatMessage[]` input, returns `CompletionResponse` (async) |
+| `CompletionModel.completeWithOptions(messages, opts)` | Chat completion with `CompletionOptions` (async) |
 | `CompletionModel.modelId` | Getter for the current model ID |
+| `ChatMessage` | Chat message class with static factories: `.system()`, `.user()`, `.assistant()`, `.tool()`, `.userImageUrl()`, `.userImageBase64()`, `.userParts()` |
+| `Role` | String enum: `Role.System`, `Role.User`, `Role.Assistant`, `Role.Tool` |
+| `CompletionResponse` | Interface: `{ content, toolCalls, usage, model, finishReason }` |
+| `ToolCall` | Interface: `{ id, name, arguments }` |
+| `TokenUsage` | Interface: `{ promptTokens, completionTokens, totalTokens }` |
+| `CompletionOptions` | Interface: `{ temperature?, maxTokens?, topP?, model?, tools? }` |
+| `ContentPart` / `ImageContent` / `ImageSource` | Types for multimodal message content |
 | `JsWorkflowResult` | Interface: `{ type: string, data: any }` |
 | `version()` | Returns the blazen library version string |
 

package/index.d.ts

@@ -1,5 +1,35 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/** A single message in a chat conversation. */
+export declare class ChatMessage {
+  /**
+   * Create a new chat message from an options object.
+   *
+   * `role` defaults to `"user"` if not provided.
+   * Supply either `content` (text) or `parts` (multimodal).
+   */
+  constructor(options: ChatMessageOptions)
+  /** Create a system message. */
+  static system(content: string): ChatMessage
+  /** Create a user message. */
+  static user(content: string): ChatMessage
+  /** Create an assistant message. */
+  static assistant(content: string): ChatMessage
+  /** Create a tool result message. */
+  static tool(content: string): ChatMessage
+  /** Create a user message containing text and an image from a URL. */
+  static userImageUrl(text: string, url: string, mediaType?: string | undefined | null): ChatMessage
+  /** Create a user message containing text and a base64-encoded image. */
+  static userImageBase64(text: string, data: string, mediaType: string): ChatMessage
+  /** Create a user message from an explicit list of content parts. */
+  static userParts(parts: Array<JsContentPart>): ChatMessage
+  /** The role of the message author. */
+  get role(): string
+  /** The text content of the message, if any. */
+  get content(): string | null
+}
+export type JsChatMessage = ChatMessage
+
 /**
  * A chat completion model.
  *
@@ -8,52 +38,52 @@
  * ```javascript
  * const model = CompletionModel.openai("sk-...");
  * const response = await model.complete([
- *   { role: "user", content: "What is 2 + 2?" }
+ *   ChatMessage.user("What is 2 + 2?")
  * ]);
  * ```
  */
 export declare class CompletionModel {
   /** Create an `OpenAI` completion model. */
-  static openai(apiKey: string): CompletionModel
+  static openai(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create an Anthropic completion model. */
-  static anthropic(apiKey: string): CompletionModel
+  static anthropic(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a Google Gemini completion model. */
-  static gemini(apiKey: string): CompletionModel
+  static gemini(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create an Azure `OpenAI` completion model. */
   static azure(apiKey: string, resourceName: string, deploymentName: string): CompletionModel
   /** Create a fal.ai completion model. */
-  static fal(apiKey: string): CompletionModel
+  static fal(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create an `OpenRouter` completion model. */
-  static openrouter(apiKey: string): CompletionModel
+  static openrouter(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a Groq completion model. */
-  static groq(apiKey: string): CompletionModel
+  static groq(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a Together AI completion model. */
-  static together(apiKey: string): CompletionModel
+  static together(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a Mistral AI completion model. */
-  static mistral(apiKey: string): CompletionModel
+  static mistral(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a `DeepSeek` completion model. */
-  static deepseek(apiKey: string): CompletionModel
+  static deepseek(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a Fireworks AI completion model. */
-  static fireworks(apiKey: string): CompletionModel
+  static fireworks(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a Perplexity completion model. */
-  static perplexity(apiKey: string): CompletionModel
+  static perplexity(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create an xAI (Grok) completion model. */
-  static xai(apiKey: string): CompletionModel
+  static xai(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create a Cohere completion model. */
-  static cohere(apiKey: string): CompletionModel
+  static cohere(apiKey: string, model?: string | undefined | null): CompletionModel
   /** Create an AWS Bedrock completion model. */
-  static bedrock(apiKey: string, region: string): CompletionModel
+  static bedrock(apiKey: string, region: string, model?: string | undefined | null): CompletionModel
   /** Get the model ID. */
   get modelId(): string
   /**
    * Perform a chat completion.
    *
-   * Messages should be an array of `{ role: string, content: string }` objects.
+   * Messages should be an array of `ChatMessage` instances.
    *
-   * Returns the response as a JSON object with `content`, `toolCalls`,
-   * `usage`, `model`, and `finishReason` fields.
+   * Returns a typed response with `content`, `toolCalls`, `usage`, `model`,
+   * and `finishReason` fields.
    */
-  complete(messages: Array<any>): Promise<any>
+  complete(messages: Array<JsChatMessage>): Promise<JsCompletionResponse>
   /**
    * Perform a chat completion with additional options.
    *
@@ -64,7 +94,32 @@ export declare class CompletionModel {
    * - `model` (string): Override the default model
    * - `tools` (array): Tool definitions for function calling
    */
-  completeWithOptions(messages: Array<any>, options: any): Promise<any>
+  completeWithOptions(messages: Array<JsChatMessage>, options: JsCompletionOptions): Promise<JsCompletionResponse>
+  /**
+   * Stream a chat completion.
+   *
+   * The `onChunk` callback receives each chunk as it arrives, with keys:
+   * `delta`, `finishReason`, `toolCalls`.
+   *
+   * ```javascript
+   * await model.stream(
+   *   [ChatMessage.user("Tell me a story")],
+   *   (chunk) => { if (chunk.delta) process.stdout.write(chunk.delta); }
+   * );
+   * ```
+   */
+  stream(messages: Array<JsChatMessage>, onChunk: StreamChunkCallbackTsfn): Promise<void>
+  /**
+   * Stream a chat completion with additional options.
+   *
+   * Options object may include:
+   * - `temperature` (number): Sampling temperature (0.0 - 2.0)
+   * - `maxTokens` (number): Maximum tokens to generate
+   * - `topP` (number): Nucleus sampling parameter
+   * - `model` (string): Override the default model
+   * - `tools` (array): Tool definitions for function calling
+   */
+  streamWithOptions(messages: Array<JsChatMessage>, onChunk: StreamChunkCallbackTsfn, options: JsCompletionOptions): Promise<void>
 }
 export type JsCompletionModel = CompletionModel
 
@@ -102,11 +157,74 @@ export declare class Context {
    * internal step registry.
    */
   writeEventToStream(event: any): Promise<void>
+  /**
+   * Store raw binary data under the given key.
+   *
+   * Useful for storing files, images, serialized objects, or any binary
+   * data that should not be JSON-serialized. The data persists through
+   * pause/resume snapshots.
+   */
+  setBytes(key: string, data: Buffer): Promise<void>
+  /**
+   * Retrieve raw binary data previously stored under the given key.
+   *
+   * Returns `null` if the key does not exist or the stored value is
+   * not binary data.
+   */
+  getBytes(key: string): Promise<Buffer | null>
   /** Get the workflow run ID. */
   runId(): Promise<string>
 }
 export type JsContext = Context
 
+/**
+ * A fal.ai compute platform provider with image, video, audio, transcription,
+ * and LLM capabilities.
+ *
+ * ```typescript
+ * const fal = FalProvider.create("fal-key-...");
+ * const result = await fal.generateImage({ prompt: "a sunset" });
+ * const response = await fal.complete([ChatMessage.user("Hi")]);
+ * ```
+ */
+export declare class FalProvider {
+  /**
+   * Create a new fal.ai provider.
+   *
+   * `model` optionally overrides the default fal.ai model endpoint.
+   */
+  static create(apiKey: string, model?: string | undefined | null): FalProvider
+  /** Get the model ID. */
+  get modelId(): string
+  /** Generate images from a text prompt. */
+  generateImage(request: JsImageRequest): Promise<any>
+  /** Upscale an image. */
+  upscaleImage(request: JsUpscaleRequest): Promise<any>
+  /** Generate a video from a text prompt. */
+  textToVideo(request: JsVideoRequest): Promise<any>
+  /** Generate a video from a source image and prompt. */
+  imageToVideo(request: JsVideoRequest): Promise<any>
+  /** Synthesize speech from text. */
+  textToSpeech(request: JsSpeechRequest): Promise<any>
+  /** Generate music from a prompt. */
+  generateMusic(request: JsMusicRequest): Promise<any>
+  /** Generate sound effects from a prompt. */
+  generateSfx(request: JsMusicRequest): Promise<any>
+  /** Transcribe audio to text. */
+  transcribe(request: JsTranscriptionRequest): Promise<any>
+  /** Run a model synchronously (submit + wait for result). */
+  run(model: string, input: any): Promise<any>
+  /** Submit a job to the queue and return a job handle. */
+  submit(model: string, input: any): Promise<any>
+  /** Get the status of a submitted job. */
+  status(jobId: string, model: string): Promise<any>
+  /** Cancel a submitted job. */
+  cancel(jobId: string, model: string): Promise<void>
+  /** Perform a chat completion via fal.ai's `any-llm` proxy. */
+  complete(messages: Array<JsChatMessage>): Promise<JsCompletionResponse>
+}
+export type JsFalProvider = FalProvider
+
 /**
  * A workflow builder and runner.
  *
@@ -255,6 +373,482 @@ export declare class WorkflowHandler {
 }
 export type JsWorkflowHandler = WorkflowHandler
 
+/** Options for creating a `ChatMessage`. */
+export interface ChatMessageOptions {
+  /** Role: "system", "user", "assistant", or "tool". Defaults to "user". */
+  role?: string
+  /** Text content. */
+  content?: string
+  /** Multimodal content parts (alternative to content). */
+  parts?: Array<JsContentPart>
+}
+
+/** The result of an agent run. */
+export interface JsAgentResult {
+  /** The final completion response from the model. */
+  response: JsCompletionResponse
+  /** Full message history including all tool calls and results. */
+  messages: Array<any>
+  /** Number of tool-calling iterations that occurred. */
+  iterations: number
+  /** Aggregated cost across all iterations, if available. */
+  totalCost?: number
+}
+
+/** Options for configuring an agent run. */
+export interface JsAgentRunOptions {
+  /**
+   * Maximum number of tool-calling iterations before forcing a final answer.
+   * Defaults to 10.
+   */
+  maxIterations?: number
+  /** Optional system prompt prepended to the conversation. */
+  systemPrompt?: string
+  /** Sampling temperature (0.0 - 2.0). */
+  temperature?: number
+  /** Maximum tokens per completion call. */
+  maxTokens?: number
+  /**
+   * Whether to add a built-in "finish" tool that the model can call to
+   * signal it has a final answer.
+   */
+  addFinishTool?: boolean
+}
+
+/** Result of an audio generation or TTS operation. */
+export interface JsAudioResult {
+  /** The generated audio clips. */
+  audio: Array<JsGeneratedAudio>
+  /** Request timing breakdown. */
+  timing?: JsComputeTiming
+  /** Cost in USD, if reported by the provider. */
+  cost?: number
+  /** Arbitrary provider-specific metadata. */
+  metadata: any
+}
+
+/** Options for a chat completion request. */
+export interface JsCompletionOptions {
+  temperature?: number
+  maxTokens?: number
+  topP?: number
+  model?: string
+  tools?: Array<JsToolDefinition>
+  /** JSON Schema for structured output / response format. */
+  responseFormat?: any
+}
+
+/** The result of a chat completion. */
+export interface JsCompletionResponse {
+  content?: string
+  toolCalls: Array<JsToolCall>
+  usage?: JsTokenUsage
+  model: string
+  finishReason?: string
+  cost?: number
+  timing?: JsRequestTiming
+  images: Array<any>
+  audio: Array<any>
+  videos: Array<any>
+  metadata: any
+}
+
+/** Input for a generic compute job. */
+export interface JsComputeRequest {
+  /** The model/endpoint to run (e.g., "fal-ai/flux/dev"). */
+  model: string
+  /** Input parameters as JSON (model-specific). */
+  input: any
+  /** Optional webhook URL for async completion notification. */
+  webhook?: string
+}
+
+/** Result of a completed compute job. */
+export interface JsComputeResult {
+  /** The job handle that produced this result, if available. */
+  job?: JsJobHandle
+  /** Output data (model-specific JSON). */
+  output: any
+  /** Request timing breakdown. */
+  timing?: JsComputeTiming
+  /** Cost in USD, if reported by the provider. */
+  cost?: number
+  /** Raw provider-specific metadata. */
+  metadata: any
+}
+
+/** Timing breakdown for a compute request. */
+export interface JsComputeTiming {
+  /** Time spent waiting in queue, in milliseconds. */
+  queueMs?: number
+  /** Time spent executing, in milliseconds. */
+  executionMs?: number
+  /** Total wall-clock time, in milliseconds. */
+  totalMs?: number
+}
+
+/** A single part in a multi-part message. */
+export interface JsContentPart {
+  partType: string
+  text?: string
+  image?: JsImageContent
+}
+
+/** A single generated 3D model with optional mesh metadata. */
+export interface JsGenerated3DModel {
+  /** The 3D model media output. */
+  media: JsMediaOutput
+  /** Total vertex count, if known. */
+  vertexCount?: number
+  /** Total face/triangle count, if known. */
+  faceCount?: number
+  /** Whether the model includes texture data. */
+  hasTextures: boolean
+  /** Whether the model includes animation data. */
+  hasAnimations: boolean
+}
+
+/** A single generated audio clip with optional metadata. */
+export interface JsGeneratedAudio {
+  /** The audio media output. */
+  media: JsMediaOutput
+  /** Duration in seconds, if known. */
+  durationSeconds?: number
+  /** Sample rate in Hz, if known. */
+  sampleRate?: number
+  /** Number of audio channels, if known. */
+  channels?: number
+}
+
+/** A single generated image with optional dimension metadata. */
+export interface JsGeneratedImage {
+  /** The image media output. */
+  media: JsMediaOutput
+  /** Image width in pixels, if known. */
+  width?: number
+  /** Image height in pixels, if known. */
+  height?: number
+}
+
+/** A single generated video with optional metadata. */
+export interface JsGeneratedVideo {
+  /** The video media output. */
+  media: JsMediaOutput
+  /** Video width in pixels, if known. */
+  width?: number
+  /** Video height in pixels, if known. */
+  height?: number
+  /** Duration in seconds, if known. */
+  durationSeconds?: number
+  /** Frames per second, if known. */
+  fps?: number
+}
+
+/** Image content for multimodal messages. */
+export interface JsImageContent {
+  source: JsImageSource
+  mediaType?: string
+}
+
+/** Request to generate images from a text prompt. */
+export interface JsImageRequest {
+  /** The text prompt describing the desired image. */
+  prompt: string
+  /** Negative prompt (things to avoid in the image). */
+  negativePrompt?: string
+  /** Desired image width in pixels. */
+  width?: number
+  /** Desired image height in pixels. */
+  height?: number
+  /** Number of images to generate. */
+  numImages?: number
+  /** Model override (provider-specific model identifier). */
+  model?: string
+  /** Additional provider-specific parameters. */
+  parameters?: any
+}
+
+/** Result of an image generation or upscale operation. */
+export interface JsImageResult {
+  /** The generated or upscaled images. */
+  images: Array<JsGeneratedImage>
+  /** Request timing breakdown. */
+  timing?: JsComputeTiming
+  /** Cost in USD, if reported by the provider. */
+  cost?: number
+  /** Arbitrary provider-specific metadata. */
+  metadata: any
+}
+
+/** How an image is provided (URL or base64). */
+export interface JsImageSource {
+  sourceType: string
+  url?: string
+  data?: string
+}
+
+/** A handle to a submitted compute job. */
+export interface JsJobHandle {
+  /** Provider-assigned job/request identifier. */
+  id: string
+  /** Provider name (e.g., "fal", "replicate", "runpod"). */
+  provider: string
+  /** The model/endpoint that was invoked. */
+  model: string
+  /** When the job was submitted (ISO 8601). */
+  submittedAt: string
+}
+
+/** Status of a compute job. */
+export declare const enum JsJobStatus {
+  /** Job is waiting in the provider's queue. */
+  Queued = 'queued',
+  /** Job is currently executing. */
+  Running = 'running',
+  /** Job completed successfully. */
+  Completed = 'completed',
+  /** Job failed with an error. */
+  Failed = 'failed',
+  /** Job was cancelled. */
+  Cancelled = 'cancelled'
+}
+
+/** A single piece of generated media content. */
+export interface JsMediaOutput {
+  /** URL where the media can be downloaded. */
+  url?: string
+  /** Base64-encoded media data. */
+  base64?: string
+  /** Raw text content for text-based formats (SVG, OBJ, GLTF JSON). */
+  rawContent?: string
+  /** The MIME type of the media (e.g. "image/png", "video/mp4"). */
+  mediaType: string
+  /** File size in bytes, if known. */
+  fileSize?: number
+  /** Arbitrary provider-specific metadata. */
+  metadata: any
+}
+
+/** Map of friendly format names to their MIME type strings. */
+export interface JsMediaTypeMap {
+  png: string
+  jpeg: string
+  webp: string
+  gif: string
+  svg: string
+  bmp: string
+  tiff: string
+  avif: string
+  ico: string
+  mp4: string
+  webm: string
+  mov: string
+  avi: string
+  mkv: string
+  mp3: string
+  wav: string
+  ogg: string
+  flac: string
+  aac: string
+  m4A: string
+  glb: string
+  gltf: string
+  obj: string
+  fbx: string
+  usdz: string
+  stl: string
+  ply: string
+  pdf: string
+}
+
+/** Request to generate music or sound effects. */
+export interface JsMusicRequest {
+  /** Text prompt describing the desired audio. */
+  prompt: string
+  /** Desired duration in seconds. */
+  durationSeconds?: number
+  /** Model override. */
+  model?: string
+  /** Additional provider-specific parameters. */
+  parameters?: any
+}
+
+/** Timing metadata for a completion request. */
+export interface JsRequestTiming {
+  queueMs?: number
+  executionMs?: number
+  totalMs?: number
+}
+
+/** The role of a participant in a chat conversation. */
+export declare const enum JsRole {
+  System = 'system',
+  User = 'user',
+  Assistant = 'assistant',
+  Tool = 'tool'
+}
+
+/** Request to generate speech from text (TTS). */
+export interface JsSpeechRequest {
+  /** The text to synthesize into speech. */
+  text: string
+  /** Voice identifier (provider-specific). */
+  voice?: string
+  /** URL to a reference voice sample for voice cloning. */
+  voiceUrl?: string
+  /** Language code (e.g. "en", "fr", "ja"). */
+  language?: string
+  /** Speech speed multiplier (1.0 = normal). */
+  speed?: number
+  /** Model override. */
+  model?: string
+  /** Additional provider-specific parameters. */
+  parameters?: any
+}
+
+/** Request to generate a 3D model. */
+export interface JsThreeDRequest {
+  /** Text prompt describing the desired 3D model. */
+  prompt?: string
+  /** Source image URL for image-to-3D generation. */
+  imageUrl?: string
+  /** Desired output format (e.g. "glb", "obj", "usdz"). */
+  format?: string
+  /** Model override. */
+  model?: string
+  /** Additional provider-specific parameters. */
+  parameters?: any
+}
+
+/** Result of a 3D model generation operation. */
+export interface JsThreeDResult {
+  /** The generated 3D models. */
+  models: Array<JsGenerated3DModel>
+  /** Request timing breakdown. */
+  timing?: JsComputeTiming
+  /** Cost in USD, if reported by the provider. */
+  cost?: number
+  /** Arbitrary provider-specific metadata. */
+  metadata: any
+}
+
+/** Token usage statistics for a completion request. */
+export interface JsTokenUsage {
+  promptTokens: number
+  completionTokens: number
+  totalTokens: number
+}
+
+/** A tool invocation requested by the model. */
+export interface JsToolCall {
+  id: string
+  name: string
+  arguments: any
+}
+
+/** Describes a tool that the agent may invoke during its execution loop. */
+export interface JsToolDef {
+  /** The unique name of the tool. */
+  name: string
+  /** A human-readable description of what the tool does. */
+  description: string
+  /** JSON Schema describing the tool's parameters. */
+  parameters: any
+}
+
+/** Describes a tool that the model may invoke during a conversation. */
+export interface JsToolDefinition {
+  name: string
+  description: string
+  parameters: any
+}
+
+/** Request to transcribe audio to text. */
+export interface JsTranscriptionRequest {
+  /** URL of the audio file to transcribe. */
+  audioUrl: string
+  /** Language hint (e.g. "en", "fr"). */
+  language?: string
+  /** Whether to perform speaker diarization. */
+  diarize?: boolean
+  /** Model override. */
+  model?: string
+  /** Additional provider-specific parameters. */
+  parameters?: any
+}
+
+/** Result of a transcription operation. */
+export interface JsTranscriptionResult {
+  /** The full transcribed text. */
+  text: string
+  /** Time-aligned segments, if available. */
+  segments: Array<JsTranscriptionSegment>
+  /** Detected or specified language code (e.g. "en", "fr"). */
+  language?: string
+  /** Request timing breakdown. */
+  timing?: JsComputeTiming
+  /** Cost in USD, if reported by the provider. */
+  cost?: number
+  /** Arbitrary provider-specific metadata. */
+  metadata: any
+}
+
+/** A single segment within a transcription. */
+export interface JsTranscriptionSegment {
+  /** The transcribed text for this segment. */
+  text: string
+  /** Start time in seconds. */
+  start: number
+  /** End time in seconds. */
+  end: number
+  /** Speaker label, if diarization was enabled. */
+  speaker?: string
+}
+
+/** Request to upscale an image. */
+export interface JsUpscaleRequest {
+  /** URL of the image to upscale. */
+  imageUrl: string
+  /** Scale factor (e.g., 2.0 for 2x, 4.0 for 4x). */
+  scale: number
+  /** Model override. */
+  model?: string
+  /** Additional provider-specific parameters. */
+  parameters?: any
+}
+
+/** Request to generate a video. */
+export interface JsVideoRequest {
+  /** Text prompt describing the desired video. */
+  prompt: string
+  /** Source image URL for image-to-video generation. */
+  imageUrl?: string
+  /** Desired duration in seconds. */
+  durationSeconds?: number
+  /** Negative prompt (things to avoid). */
+  negativePrompt?: string
+  /** Desired video width in pixels. */
+  width?: number
+  /** Desired video height in pixels. */
+  height?: number
+  /** Model override. */
+  model?: string
+  /** Additional provider-specific parameters. */
+  parameters?: any
+}
+
+/** Result of a video generation operation. */
+export interface JsVideoResult {
+  /** The generated videos. */
+  videos: Array<JsGeneratedVideo>
+  /** Request timing breakdown. */
+  timing?: JsComputeTiming
+  /** Cost in USD, if reported by the provider. */
+  cost?: number
+  /** Arbitrary provider-specific metadata. */
+  metadata: any
+}
+
 /** The result of a workflow run. */
 export interface JsWorkflowResult {
   /** The event type of the final result (typically "`blazen::StopEvent`"). */
@@ -263,5 +857,48 @@ export interface JsWorkflowResult {
   data: any
 }
 
+/**
+ * Returns an object mapping friendly names to MIME type strings.
+ *
+ * ```typescript
+ * import { mediaTypes } from 'blazen';
+ *
+ * const types = mediaTypes();
+ * console.log(types.png);  // "image/png"
+ * console.log(types.mp4);  // "video/mp4"
+ * ```
+ */
+export declare function mediaTypes(): JsMediaTypeMap
+
+/**
+ * Run an agentic tool execution loop.
+ *
+ * The agent repeatedly calls the model, executes any tool calls via the
+ * `toolHandler` callback, feeds results back, and repeats until the model
+ * stops calling tools or `maxIterations` is reached.
+ *
+ * The `toolHandler` callback receives `(toolName: string, arguments: object)`
+ * and must return the tool result as a JSON-serializable value (or a Promise
+ * that resolves to one).
+ *
+ * ```typescript
+ * import { CompletionModel, ChatMessage, runAgent } from 'blazen';
+ *
+ * const model = CompletionModel.openai("sk-...");
+ *
+ * const result = await runAgent(
+ *   model,
+ *   [ChatMessage.user("What is the weather in NYC?")],
+ *   [{ name: "getWeather", description: "Get weather", parameters: { type: "object", properties: { city: { type: "string" } }, required: ["city"] } }],
+ *   async (toolName, args) => {
+ *     if (toolName === "getWeather") return { temp: 72, condition: "sunny" };
+ *     throw new Error(`Unknown tool: ${toolName}`);
+ *   },
+ *   { maxIterations: 5 }
+ * );
+ * ```
+ */
+export declare function runAgent(model: JsCompletionModel, messages: Array<JsChatMessage>, tools: Array<JsToolDef>, toolHandler: ToolHandlerTsfn, options?: JsAgentRunOptions | undefined | null): Promise<JsAgentResult>
+
 /** Returns the version of the blazen library. */
 export declare function version(): string

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('blazen-android-arm64')
         const bindingPackageVersion = require('blazen-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('blazen-android-arm-eabi')
         const bindingPackageVersion = require('blazen-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('blazen-win32-x64-gnu')
         const bindingPackageVersion = require('blazen-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('blazen-win32-x64-msvc')
         const bindingPackageVersion = require('blazen-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('blazen-win32-ia32-msvc')
         const bindingPackageVersion = require('blazen-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('blazen-win32-arm64-msvc')
         const bindingPackageVersion = require('blazen-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('blazen-darwin-universal')
       const bindingPackageVersion = require('blazen-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('blazen-darwin-x64')
         const bindingPackageVersion = require('blazen-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('blazen-darwin-arm64')
         const bindingPackageVersion = require('blazen-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('blazen-freebsd-x64')
         const bindingPackageVersion = require('blazen-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('blazen-freebsd-arm64')
         const bindingPackageVersion = require('blazen-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-x64-musl')
           const bindingPackageVersion = require('blazen-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-x64-gnu')
           const bindingPackageVersion = require('blazen-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-arm64-musl')
           const bindingPackageVersion = require('blazen-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-arm64-gnu')
           const bindingPackageVersion = require('blazen-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-arm-musleabihf')
           const bindingPackageVersion = require('blazen-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-arm-gnueabihf')
           const bindingPackageVersion = require('blazen-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-loong64-musl')
           const bindingPackageVersion = require('blazen-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-loong64-gnu')
           const bindingPackageVersion = require('blazen-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-riscv64-musl')
           const bindingPackageVersion = require('blazen-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('blazen-linux-riscv64-gnu')
           const bindingPackageVersion = require('blazen-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('blazen-linux-ppc64-gnu')
         const bindingPackageVersion = require('blazen-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('blazen-linux-s390x-gnu')
         const bindingPackageVersion = require('blazen-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('blazen-openharmony-arm64')
         const bindingPackageVersion = require('blazen-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('blazen-openharmony-x64')
         const bindingPackageVersion = require('blazen-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('blazen-openharmony-arm')
         const bindingPackageVersion = require('blazen-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.97' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.97 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.99' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.99 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -576,12 +576,20 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.ChatMessage = nativeBinding.ChatMessage
+module.exports.JsChatMessage = nativeBinding.JsChatMessage
 module.exports.CompletionModel = nativeBinding.CompletionModel
 module.exports.JsCompletionModel = nativeBinding.JsCompletionModel
 module.exports.Context = nativeBinding.Context
 module.exports.JsContext = nativeBinding.JsContext
+module.exports.FalProvider = nativeBinding.FalProvider
+module.exports.JsFalProvider = nativeBinding.JsFalProvider
 module.exports.Workflow = nativeBinding.Workflow
 module.exports.JsWorkflow = nativeBinding.JsWorkflow
 module.exports.WorkflowHandler = nativeBinding.WorkflowHandler
 module.exports.JsWorkflowHandler = nativeBinding.JsWorkflowHandler
+module.exports.JsJobStatus = nativeBinding.JsJobStatus
+module.exports.JsRole = nativeBinding.JsRole
+module.exports.mediaTypes = nativeBinding.mediaTypes
+module.exports.runAgent = nativeBinding.runAgent
 module.exports.version = nativeBinding.version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blazen",
-  "version": "0.1.97",
+  "version": "0.1.99",
   "description": "Blazen - Event-driven AI workflow framework for Node.js/TypeScript",
   "main": "index.js",
   "types": "index.d.ts",
@@ -34,7 +34,8 @@
     "index.d.ts"
   ],
   "devDependencies": {
-    "@napi-rs/cli": "^3.0.0"
+    "@napi-rs/cli": "^3.0.0",
+    "@biomejs/biome": "^2"
   },
   "engines": {
     "node": ">= 18"