@agentfield/sdk 0.1.136 → 0.1.137-rc.1

package/dist/index.js

@@ -20,11 +20,11 @@ import { createXai } from '@ai-sdk/xai';
 import { createDeepSeek } from '@ai-sdk/deepseek';
 import { createCohere } from '@ai-sdk/cohere';
 import os from 'os';
+import { readFile } from 'fs/promises';
 import WebSocket from 'ws';
 import { Buffer as Buffer$1 } from 'buffer';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 import { generateKeyPair, exportJWK, importJWK, CompactEncrypt, compactDecrypt } from 'jose';
-import { readFile } from 'fs/promises';
 import { fileURLToPath } from 'url';
 
 var __defProp = Object.defineProperty;
@@ -2987,150 +2987,439 @@ function withOpenRouterUsageInclude(baseFetch) {
     return impl(input, init);
   };
 }
-
-// src/ai/AIClient.ts
-function repairJsonText(text2) {
-  let cleaned = text2.trim();
-  const codeBlockMatch = cleaned.match(/```(?:json)?\s*([\s\S]*?)```/);
-  if (codeBlockMatch) {
-    cleaned = codeBlockMatch[1].trim();
+var IMAGE_MIME_TYPES = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".bmp": "image/bmp"
+};
+var AUDIO_MIME_TYPES = {
+  ".wav": "audio/wav",
+  ".mp3": "audio/mpeg",
+  ".flac": "audio/flac",
+  ".ogg": "audio/ogg"
+};
+var VIDEO_MIME_TYPES = {
+  ".mp4": "video/mp4",
+  ".mpeg": "video/mpeg",
+  ".mpg": "video/mpeg",
+  ".mov": "video/quicktime",
+  ".webm": "video/webm"
+};
+var Text = class {
+  type = "text";
+  text;
+  constructor(text2) {
+    this.text = text2;
   }
-  const jsonMatch = cleaned.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
-  if (jsonMatch) {
-    cleaned = jsonMatch[1];
+};
+var Image = class _Image {
+  type = "image_url";
+  imageUrl;
+  constructor(imageUrl) {
+    this.imageUrl = imageUrl;
   }
-  cleaned = cleaned.replace(/,(\s*[}\]])/g, "$1");
-  try {
-    JSON.parse(cleaned);
-    return cleaned;
-  } catch {
-    return null;
+  /**
+   * Create Image from a local file by converting to base64 data URL.
+   */
+  static async fromFile(filePath, detail = "high") {
+    const absolutePath = resolve(filePath);
+    const buffer = await readFile(absolutePath);
+    const base64Data = buffer.toString("base64");
+    const ext = getExtension(absolutePath).toLowerCase();
+    const mimeType = IMAGE_MIME_TYPES[ext] || "image/jpeg";
+    const dataUrl = `data:${mimeType};base64,${base64Data}`;
+    return new _Image({ url: dataUrl, detail });
   }
-}
-var AIClient = class {
-  config;
-  rateLimiter;
-  constructor(config = {}) {
-    this.config = {
-      enableRateLimitRetry: true,
-      rateLimitMaxRetries: 20,
-      rateLimitBaseDelay: 1,
-      rateLimitMaxDelay: 300,
-      rateLimitJitterFactor: 0.25,
-      rateLimitCircuitBreakerThreshold: 10,
-      rateLimitCircuitBreakerTimeout: 300,
-      ...config
-    };
+  /**
+   * Create Image from a URL.
+   */
+  static fromUrl(url, detail = "high") {
+    return new _Image({ url, detail });
   }
-  async generate(prompt, options = {}) {
-    const { provider, modelName } = this.resolveModelChoice(options);
-    const model = this.buildModel(options);
-    if (options.schema) {
-      const schema = options.schema;
-      const call2 = async () => generateObject({
-        model,
-        prompt,
-        output: "object",
-        system: options.system,
-        temperature: options.temperature ?? this.config.temperature,
-        maxOutputTokens: options.maxTokens ?? this.config.maxTokens,
-        schema,
-        experimental_repairText: async ({ text: text2 }) => repairJsonText(text2)
-      });
-      const response2 = await this.withRateLimitRetry(call2);
-      recordAiSdkUsage({ source: response2, model: modelName, provider });
-      return response2.object;
+  /**
+   * Create Image from a buffer.
+   */
+  static async fromBuffer(buffer, mimeType = "image/jpeg", detail = "high") {
+    const base64Data = Buffer.from(buffer).toString("base64");
+    const dataUrl = `data:${mimeType};base64,${base64Data}`;
+    return new _Image({ url: dataUrl, detail });
+  }
+  /**
+   * Create Image from a base64 string.
+   */
+  static async fromBase64(base64Data, mimeType = "image/jpeg", detail = "high") {
+    const dataUrl = `data:${mimeType};base64,${base64Data}`;
+    return new _Image({ url: dataUrl, detail });
+  }
+};
+var Audio = class _Audio {
+  type = "input_audio";
+  audio;
+  constructor(audio) {
+    this.audio = audio;
+  }
+  /**
+   * Create Audio from a local file by converting to base64.
+   */
+  static async fromFile(filePath, format) {
+    const absolutePath = resolve(filePath);
+    const ext = getExtension(absolutePath).toLowerCase().replace(".", "");
+    const audioFormat = format || (["wav", "mp3", "flac", "ogg"].includes(ext) ? ext : "wav");
+    const buffer = await readFile(absolutePath);
+    const base64Data = buffer.toString("base64");
+    return new _Audio({ data: base64Data, format: audioFormat });
+  }
+  /**
+   * Create Audio from a URL (downloads and converts to base64).
+   */
+  static async fromUrl(url, format = "wav") {
+    try {
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch audio from URL: ${response.status} ${response.statusText}`);
+      }
+      const arrayBuffer = await response.arrayBuffer();
+      const base64Data = Buffer.from(arrayBuffer).toString("base64");
+      return new _Audio({ data: base64Data, format });
+    } catch (error) {
+      if (error instanceof TypeError && error.message.includes("fetch")) {
+        throw new Error("URL download requires a fetch-compatible environment");
+      }
+      throw error;
     }
-    const call = async () => generateText({
-      model,
-      prompt,
-      system: options.system,
-      temperature: options.temperature ?? this.config.temperature,
-      maxOutputTokens: options.maxTokens ?? this.config.maxTokens
-    });
-    const response = await this.withRateLimitRetry(call);
-    recordAiSdkUsage({ source: response, model: modelName, provider });
-    return response.text;
   }
-  // NOTE: stream() usage is deliberately NOT captured. The AI SDK's
-  // streamResult.usage/.totalUsage promises "automatically consume the
-  // stream": attaching to them would force full background consumption of a
-  // stream the caller may abandon early, changing stream semantics.
-  async stream(prompt, options = {}) {
-    const model = this.buildModel(options);
-    const streamResult = streamText({
-      model,
-      prompt,
-      system: options.system,
-      temperature: options.temperature ?? this.config.temperature,
-      maxOutputTokens: options.maxTokens ?? this.config.maxTokens
-    });
-    return streamResult.textStream;
+  /**
+   * Create Audio from a buffer.
+   */
+  static async fromBuffer(buffer, format = "wav") {
+    const base64Data = Buffer.from(buffer).toString("base64");
+    return new _Audio({ data: base64Data, format });
   }
-  async embed(value, options = {}) {
-    const model = this.buildEmbeddingModel(options);
-    const result = await this.withRateLimitRetry(
-      () => embed({
-        model,
-        value
-      })
-    );
-    return result.embedding;
+  /**
+   * Create Audio from a base64 string.
+   */
+  static async fromBase64(base64Data, format = "wav") {
+    return new _Audio({ data: base64Data, format });
   }
-  async embedMany(values, options = {}) {
-    const model = this.buildEmbeddingModel(options);
-    const result = await this.withRateLimitRetry(
-      () => embedMany({
-        model,
-        values
-      })
-    );
-    return result.embeddings;
+};
+var Video = class _Video {
+  type = "video_url";
+  videoUrl;
+  constructor(videoUrl) {
+    this.videoUrl = videoUrl;
   }
   /**
-   * Build and return the AI model instance for a given set of options.
-   * Exposed for use by the tool-calling loop.
+   * Create Video from a local file by converting to a base64 data URL.
    */
-  getModel(options = {}) {
-    return this.buildModel(options);
+  static async fromFile(filePath) {
+    const absolutePath = resolve(filePath);
+    const buffer = await readFile(absolutePath);
+    const base64Data = buffer.toString("base64");
+    const ext = getExtension(absolutePath).toLowerCase();
+    const mimeType = VIDEO_MIME_TYPES[ext] || "video/mp4";
+    return new _Video({ url: `data:${mimeType};base64,${base64Data}` });
   }
   /**
-   * Resolve the effective provider/model pair for a request without building
-   * the model. Used by usage tracking to attribute token/cost entries to the
-   * model actually called.
+   * Create Video from a URL.
    */
-  resolveModelChoice(options = {}) {
-    return {
-      provider: options.provider ?? this.config.provider ?? "openai",
-      modelName: options.model ?? this.config.model ?? "gpt-4o"
-    };
+  static fromUrl(url) {
+    return new _Video({ url });
   }
-  buildModel(options) {
-    const { provider, modelName } = this.resolveModelChoice(options);
-    const openRouterHeaders = this.openRouterHeaders(provider, modelName);
-    switch (provider) {
-      case "anthropic": {
-        const anthropic = createAnthropic({
-          apiKey: this.config.apiKey,
-          baseURL: this.config.baseUrl
-        });
-        return anthropic(modelName);
-      }
-      case "google": {
-        const google = createGoogleGenerativeAI({
-          apiKey: this.config.apiKey,
-          baseURL: this.config.baseUrl
-        });
-        return google(modelName);
-      }
-      case "mistral": {
-        const mistral = createMistral({
-          apiKey: this.config.apiKey,
-          baseURL: this.config.baseUrl
-        });
-        return mistral(modelName);
-      }
-      case "groq": {
+  /**
+   * Create Video from a buffer.
+   */
+  static async fromBuffer(buffer, mimeType = "video/mp4") {
+    const base64Data = Buffer.from(buffer).toString("base64");
+    return new _Video({ url: `data:${mimeType};base64,${base64Data}` });
+  }
+  /**
+   * Create Video from a base64 string.
+   */
+  static async fromBase64(base64Data, mimeType = "video/mp4") {
+    return new _Video({ url: `data:${mimeType};base64,${base64Data}` });
+  }
+};
+var File = class _File {
+  type = "file";
+  file;
+  constructor(file) {
+    this.file = file;
+  }
+  /**
+   * Create File from a local file path.
+   */
+  static async fromFile(filePath, mimeType) {
+    const absolutePath = resolve(filePath);
+    const detectedMimeType = mimeType || guessMimeType(absolutePath) || "application/octet-stream";
+    const buffer = await readFile(absolutePath);
+    const base64Data = buffer.toString("base64");
+    const dataUrl = `data:${detectedMimeType};base64,${base64Data}`;
+    return new _File({ url: dataUrl, mimeType: detectedMimeType });
+  }
+  /**
+   * Create File from a URL.
+   */
+  static fromUrl(url, mimeType) {
+    return new _File({ url, mimeType });
+  }
+  /**
+   * Create File from a buffer.
+   */
+  static async fromBuffer(buffer, mimeType) {
+    const base64Data = Buffer.from(buffer).toString("base64");
+    const dataUrl = `data:${mimeType};base64,${base64Data}`;
+    return new _File({ url: dataUrl, mimeType });
+  }
+  /**
+   * Create File from a base64 string.
+   */
+  static async fromBase64(base64Data, mimeType) {
+    const dataUrl = `data:${mimeType};base64,${base64Data}`;
+    return new _File({ url: dataUrl, mimeType });
+  }
+};
+function getExtension(filePath) {
+  const lastDot = filePath.lastIndexOf(".");
+  if (lastDot === -1) {
+    return "";
+  }
+  return filePath.slice(lastDot);
+}
+function guessMimeType(filePath) {
+  const ext = getExtension(filePath).toLowerCase();
+  if (ext in IMAGE_MIME_TYPES) {
+    return IMAGE_MIME_TYPES[ext];
+  }
+  if (ext in AUDIO_MIME_TYPES) {
+    return AUDIO_MIME_TYPES[ext];
+  }
+  if (ext in VIDEO_MIME_TYPES) {
+    return VIDEO_MIME_TYPES[ext];
+  }
+  const documentMimeTypes = {
+    ".pdf": "application/pdf",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".txt": "text/plain",
+    ".csv": "text/csv",
+    ".html": "text/html",
+    ".json": "application/json",
+    ".xml": "application/xml",
+    ".zip": "application/zip"
+  };
+  return documentMimeTypes[ext] || null;
+}
+function getDataUrlMimeType(url) {
+  const match = /^data:([^;,]+)(?:;[^,]*)?,/i.exec(url);
+  return match?.[1] || null;
+}
+function guessUrlMimeType(url) {
+  return getDataUrlMimeType(url) ?? guessMimeType(url.split(/[?#]/, 1)[0]);
+}
+function audioMediaType(format) {
+  return AUDIO_MIME_TYPES[`.${format.toLowerCase()}`] ?? `audio/${format}`;
+}
+function text(content) {
+  return new Text(content);
+}
+async function imageFromFile(filePath, detail = "high") {
+  return Image.fromFile(filePath, detail);
+}
+function imageFromUrl(url, detail = "high") {
+  return Image.fromUrl(url, detail);
+}
+async function imageFromBuffer(buffer, mimeType = "image/jpeg", detail = "high") {
+  return Image.fromBuffer(buffer, mimeType, detail);
+}
+async function imageFromBase64(base64Data, mimeType, detail = "high") {
+  return Image.fromBase64(base64Data, mimeType, detail);
+}
+async function audioFromFile(filePath, format) {
+  return Audio.fromFile(filePath, format);
+}
+async function audioFromUrl(url, format = "wav") {
+  return Audio.fromUrl(url, format);
+}
+async function audioFromBuffer(buffer, format = "wav") {
+  return Audio.fromBuffer(buffer, format);
+}
+async function audioFromBase64(base64Data, format = "wav") {
+  return Audio.fromBase64(base64Data, format);
+}
+async function videoFromFile(filePath) {
+  return Video.fromFile(filePath);
+}
+function videoFromUrl(url) {
+  return Video.fromUrl(url);
+}
+async function videoFromBuffer(buffer, mimeType = "video/mp4") {
+  return Video.fromBuffer(buffer, mimeType);
+}
+async function videoFromBase64(base64Data, mimeType = "video/mp4") {
+  return Video.fromBase64(base64Data, mimeType);
+}
+async function fileFromPath(filePath, mimeType) {
+  return File.fromFile(filePath, mimeType);
+}
+function fileFromUrl(url, mimeType) {
+  return File.fromUrl(url, mimeType);
+}
+async function fileFromBuffer(buffer, mimeType) {
+  return File.fromBuffer(buffer, mimeType);
+}
+async function fileFromBase64(base64Data, mimeType) {
+  return File.fromBase64(base64Data, mimeType);
+}
+
+// src/ai/AIClient.ts
+function repairJsonText(text2) {
+  let cleaned = text2.trim();
+  const codeBlockMatch = cleaned.match(/```(?:json)?\s*([\s\S]*?)```/);
+  if (codeBlockMatch) {
+    cleaned = codeBlockMatch[1].trim();
+  }
+  const jsonMatch = cleaned.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
+  if (jsonMatch) {
+    cleaned = jsonMatch[1];
+  }
+  cleaned = cleaned.replace(/,(\s*[}\]])/g, "$1");
+  try {
+    JSON.parse(cleaned);
+    return cleaned;
+  } catch {
+    return null;
+  }
+}
+var AIClient = class {
+  config;
+  rateLimiter;
+  constructor(config = {}) {
+    this.config = {
+      enableRateLimitRetry: true,
+      rateLimitMaxRetries: 20,
+      rateLimitBaseDelay: 1,
+      rateLimitMaxDelay: 300,
+      rateLimitJitterFactor: 0.25,
+      rateLimitCircuitBreakerThreshold: 10,
+      rateLimitCircuitBreakerTimeout: 300,
+      ...config
+    };
+  }
+  async generate(prompt, options = {}) {
+    const { provider, modelName } = this.resolveModelChoice(options);
+    const model = this.buildModel(options);
+    const requestPrompt = this.buildPrompt(prompt, options.content);
+    if (options.schema) {
+      const schema = options.schema;
+      const call2 = async () => generateObject({
+        model,
+        prompt: requestPrompt,
+        output: "object",
+        system: options.system,
+        temperature: options.temperature ?? this.config.temperature,
+        maxOutputTokens: options.maxTokens ?? this.config.maxTokens,
+        schema,
+        experimental_repairText: async ({ text: text2 }) => repairJsonText(text2)
+      });
+      const response2 = await this.withRateLimitRetry(call2);
+      recordAiSdkUsage({ source: response2, model: modelName, provider });
+      return response2.object;
+    }
+    const call = async () => generateText({
+      model,
+      prompt: requestPrompt,
+      system: options.system,
+      temperature: options.temperature ?? this.config.temperature,
+      maxOutputTokens: options.maxTokens ?? this.config.maxTokens
+    });
+    const response = await this.withRateLimitRetry(call);
+    recordAiSdkUsage({ source: response, model: modelName, provider });
+    return response.text;
+  }
+  // NOTE: stream() usage is deliberately NOT captured. The AI SDK's
+  // streamResult.usage/.totalUsage promises "automatically consume the
+  // stream": attaching to them would force full background consumption of a
+  // stream the caller may abandon early, changing stream semantics.
+  async stream(prompt, options = {}) {
+    const model = this.buildModel(options);
+    const streamResult = streamText({
+      model,
+      prompt: this.buildPrompt(prompt, options.content),
+      system: options.system,
+      temperature: options.temperature ?? this.config.temperature,
+      maxOutputTokens: options.maxTokens ?? this.config.maxTokens
+    });
+    return streamResult.textStream;
+  }
+  async embed(value, options = {}) {
+    const model = this.buildEmbeddingModel(options);
+    const result = await this.withRateLimitRetry(
+      () => embed({
+        model,
+        value
+      })
+    );
+    return result.embedding;
+  }
+  async embedMany(values, options = {}) {
+    const model = this.buildEmbeddingModel(options);
+    const result = await this.withRateLimitRetry(
+      () => embedMany({
+        model,
+        values
+      })
+    );
+    return result.embeddings;
+  }
+  /**
+   * Build and return the AI model instance for a given set of options.
+   * Exposed for use by the tool-calling loop.
+   */
+  getModel(options = {}) {
+    return this.buildModel(options);
+  }
+  /**
+   * Resolve the effective provider/model pair for a request without building
+   * the model. Used by usage tracking to attribute token/cost entries to the
+   * model actually called.
+   */
+  resolveModelChoice(options = {}) {
+    return {
+      provider: options.provider ?? this.config.provider ?? "openai",
+      modelName: options.model ?? this.config.model ?? "gpt-4o"
+    };
+  }
+  buildModel(options) {
+    const { provider, modelName } = this.resolveModelChoice(options);
+    const openRouterHeaders = this.openRouterHeaders(provider, modelName);
+    switch (provider) {
+      case "anthropic": {
+        const anthropic = createAnthropic({
+          apiKey: this.config.apiKey,
+          baseURL: this.config.baseUrl
+        });
+        return anthropic(modelName);
+      }
+      case "google": {
+        const google = createGoogleGenerativeAI({
+          apiKey: this.config.apiKey,
+          baseURL: this.config.baseUrl
+        });
+        return google(modelName);
+      }
+      case "mistral": {
+        const mistral = createMistral({
+          apiKey: this.config.apiKey,
+          baseURL: this.config.baseUrl
+        });
+        return mistral(modelName);
+      }
+      case "groq": {
         const groq = createGroq({
           apiKey: this.config.apiKey,
           baseURL: this.config.baseUrl
@@ -3186,6 +3475,40 @@ var AIClient = class {
       }
     }
   }
+  buildPrompt(prompt, content) {
+    if (!content?.length) return prompt;
+    const messageContent = [
+      { type: "text", text: prompt },
+      ...content.map((part) => {
+        if (part.type === "text") return { type: "text", text: part.text };
+        if (part.type === "image_url") return { type: "image", image: part.imageUrl.url };
+        if (part.type === "video_url") {
+          return {
+            type: "file",
+            data: part.videoUrl.url,
+            mediaType: guessUrlMimeType(part.videoUrl.url) ?? "video/mp4"
+          };
+        }
+        if (part.type === "input_audio") {
+          return {
+            type: "file",
+            data: part.audio.data,
+            mediaType: audioMediaType(part.audio.format)
+          };
+        }
+        return {
+          type: "file",
+          data: part.file.url,
+          mediaType: part.file.mimeType ?? guessUrlMimeType(part.file.url) ?? "application/octet-stream"
+        };
+      })
+    ];
+    const messages = [{
+      role: "user",
+      content: messageContent
+    }];
+    return messages;
+  }
   buildEmbeddingModel(options) {
     const provider = options.provider ?? this.config.provider ?? "openai";
     const modelName = options.model ?? this.config.embeddingModel ?? "text-embedding-3-small";
@@ -7141,416 +7464,138 @@ var Agent = class {
       }
     });
   }
-  parseTarget(target) {
-    if (!target.includes(".")) {
-      return { name: target };
-    }
-    const [agentId, remainder] = target.split(".", 2);
-    const name = remainder.replace(":", "/");
-    return { agentId, name };
-  }
-};
-
-// src/router/AgentRouter.ts
-var AgentRouter = class {
-  prefix;
-  tags;
-  reasoners = [];
-  skills = [];
-  constructor(options = {}) {
-    this.prefix = options.prefix;
-    this.tags = options.tags;
-  }
-  reasoner(name, handler, options) {
-    const fullName = this.prefix ? `${sanitize(this.prefix)}_${name}` : name;
-    this.reasoners.push({ name: fullName, handler, options });
-    return this;
-  }
-  skill(name, handler, options) {
-    const fullName = this.prefix ? `${sanitize(this.prefix)}_${name}` : name;
-    this.skills.push({ name: fullName, handler, options });
-    return this;
-  }
-};
-function sanitize(value) {
-  return value.replace(/[^0-9a-zA-Z]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
-}
-var JWE_ALG = "ECDH-ES";
-var JWE_ENC = "A256GCM";
-var KEY_AGREEMENT_TYPE = "X25519KeyAgreementKey2020";
-var PayloadEncryptionError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "PayloadEncryptionError";
-  }
-};
-var encoder = new TextEncoder();
-function payloadToBytes(payload) {
-  if (payload instanceof Uint8Array) return payload;
-  if (typeof payload === "string") return encoder.encode(payload);
-  return encoder.encode(JSON.stringify(payload));
-}
-async function generateX25519KeyPair() {
-  const { privateKey, publicKey } = await generateKeyPair("ECDH-ES", {
-    crv: "X25519",
-    extractable: true
-  });
-  const privateJwk = await exportJWK(privateKey);
-  const publicJwk = await exportJWK(publicKey);
-  return { privateJwk, publicJwk };
-}
-function extractKeyAgreementJwk(didDocument) {
-  if (typeof didDocument !== "object" || didDocument === null) {
-    throw new PayloadEncryptionError("DID document must be an object");
-  }
-  const doc = didDocument["did_document"] ?? didDocument;
-  const flat = doc["key_agreement"];
-  if (flat && typeof flat === "object" && flat.crv === "X25519") {
-    return flat;
-  }
-  const keyAgreement = doc["keyAgreement"];
-  if (!keyAgreement || Array.isArray(keyAgreement) && keyAgreement.length === 0) {
-    throw new PayloadEncryptionError(
-      "DID document has no keyAgreement key; the agent has not published an X25519 encryption key"
-    );
-  }
-  const verificationMethods = /* @__PURE__ */ new Map();
-  for (const vm2 of doc["verificationMethod"] ?? []) {
-    if (vm2 && typeof vm2 === "object" && typeof vm2["id"] === "string") {
-      verificationMethods.set(vm2["id"], vm2);
-    }
-  }
-  const entry = Array.isArray(keyAgreement) ? keyAgreement[0] : keyAgreement;
-  let vm;
-  if (typeof entry === "string") {
-    vm = verificationMethods.get(entry);
-    if (!vm) {
-      throw new PayloadEncryptionError(
-        `keyAgreement references unknown verification method ${entry}`
-      );
-    }
-  } else if (entry && typeof entry === "object") {
-    vm = entry;
-  } else {
-    throw new PayloadEncryptionError("unsupported keyAgreement entry shape");
-  }
-  const jwk = vm["publicKeyJwk"];
-  if (!jwk || jwk.crv !== "X25519") {
-    throw new PayloadEncryptionError(
-      "keyAgreement verification method does not carry an X25519 publicKeyJwk"
-    );
-  }
-  return jwk;
-}
-async function encryptToJwk(publicJwk, payload) {
-  if (!publicJwk || publicJwk.crv !== "X25519") {
-    throw new PayloadEncryptionError("publicJwk must be an X25519 OKP JWK");
-  }
-  try {
-    const key = await importJWK(publicJwk, JWE_ALG);
-    return await new CompactEncrypt(payloadToBytes(payload)).setProtectedHeader({ alg: JWE_ALG, enc: JWE_ENC }).encrypt(key);
-  } catch (err) {
-    if (err instanceof PayloadEncryptionError) throw err;
-    throw new PayloadEncryptionError(`encryption failed: ${err.message}`);
-  }
-}
-async function encryptForDid(did, payload, resolver) {
-  const document = await resolver(did);
-  if (!document) {
-    throw new PayloadEncryptionError(`could not resolve DID ${did}`);
-  }
-  const publicJwk = extractKeyAgreementJwk(document);
-  return encryptToJwk(publicJwk, payload);
-}
-async function decrypt(token, privateJwk) {
-  try {
-    const key = await importJWK(privateJwk, JWE_ALG);
-    const { plaintext } = await compactDecrypt(token, key);
-    return Uint8Array.from(plaintext);
-  } catch (err) {
-    throw new PayloadEncryptionError(`decryption failed: ${err.message}`);
-  }
-}
-async function decryptToString(token, privateJwk) {
-  return new TextDecoder().decode(await decrypt(token, privateJwk));
-}
-var IMAGE_MIME_TYPES = {
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".png": "image/png",
-  ".gif": "image/gif",
-  ".webp": "image/webp",
-  ".bmp": "image/bmp"
-};
-var AUDIO_MIME_TYPES = {
-  ".wav": "audio/wav",
-  ".mp3": "audio/mpeg",
-  ".flac": "audio/flac",
-  ".ogg": "audio/ogg"
-};
-var VIDEO_MIME_TYPES = {
-  ".mp4": "video/mp4",
-  ".mpeg": "video/mpeg",
-  ".mpg": "video/mpeg",
-  ".mov": "video/quicktime",
-  ".webm": "video/webm"
-};
-var Text = class {
-  type = "text";
-  text;
-  constructor(text2) {
-    this.text = text2;
-  }
-};
-var Image = class _Image {
-  type = "image_url";
-  imageUrl;
-  constructor(imageUrl) {
-    this.imageUrl = imageUrl;
-  }
-  /**
-   * Create Image from a local file by converting to base64 data URL.
-   */
-  static async fromFile(filePath, detail = "high") {
-    const absolutePath = resolve(filePath);
-    const buffer = await readFile(absolutePath);
-    const base64Data = buffer.toString("base64");
-    const ext = getExtension(absolutePath).toLowerCase();
-    const mimeType = IMAGE_MIME_TYPES[ext] || "image/jpeg";
-    const dataUrl = `data:${mimeType};base64,${base64Data}`;
-    return new _Image({ url: dataUrl, detail });
-  }
-  /**
-   * Create Image from a URL.
-   */
-  static fromUrl(url, detail = "high") {
-    return new _Image({ url, detail });
-  }
-  /**
-   * Create Image from a buffer.
-   */
-  static async fromBuffer(buffer, mimeType = "image/jpeg", detail = "high") {
-    const base64Data = Buffer.from(buffer).toString("base64");
-    const dataUrl = `data:${mimeType};base64,${base64Data}`;
-    return new _Image({ url: dataUrl, detail });
-  }
-  /**
-   * Create Image from a base64 string.
-   */
-  static async fromBase64(base64Data, mimeType = "image/jpeg", detail = "high") {
-    const dataUrl = `data:${mimeType};base64,${base64Data}`;
-    return new _Image({ url: dataUrl, detail });
-  }
-};
-var Audio = class _Audio {
-  type = "input_audio";
-  audio;
-  constructor(audio) {
-    this.audio = audio;
-  }
-  /**
-   * Create Audio from a local file by converting to base64.
-   */
-  static async fromFile(filePath, format) {
-    const absolutePath = resolve(filePath);
-    const ext = getExtension(absolutePath).toLowerCase().replace(".", "");
-    const audioFormat = format || (["wav", "mp3", "flac", "ogg"].includes(ext) ? ext : "wav");
-    const buffer = await readFile(absolutePath);
-    const base64Data = buffer.toString("base64");
-    return new _Audio({ data: base64Data, format: audioFormat });
-  }
-  /**
-   * Create Audio from a URL (downloads and converts to base64).
-   */
-  static async fromUrl(url, format = "wav") {
-    try {
-      const response = await fetch(url);
-      if (!response.ok) {
-        throw new Error(`Failed to fetch audio from URL: ${response.status} ${response.statusText}`);
-      }
-      const arrayBuffer = await response.arrayBuffer();
-      const base64Data = Buffer.from(arrayBuffer).toString("base64");
-      return new _Audio({ data: base64Data, format });
-    } catch (error) {
-      if (error instanceof TypeError && error.message.includes("fetch")) {
-        throw new Error("URL download requires a fetch-compatible environment");
-      }
-      throw error;
-    }
-  }
-  /**
-   * Create Audio from a buffer.
-   */
-  static async fromBuffer(buffer, format = "wav") {
-    const base64Data = Buffer.from(buffer).toString("base64");
-    return new _Audio({ data: base64Data, format });
-  }
-  /**
-   * Create Audio from a base64 string.
-   */
-  static async fromBase64(base64Data, format = "wav") {
-    return new _Audio({ data: base64Data, format });
-  }
-};
-var Video = class _Video {
-  type = "video_url";
-  videoUrl;
-  constructor(videoUrl) {
-    this.videoUrl = videoUrl;
+  parseTarget(target) {
+    if (!target.includes(".")) {
+      return { name: target };
+    }
+    const [agentId, remainder] = target.split(".", 2);
+    const name = remainder.replace(":", "/");
+    return { agentId, name };
   }
-  /**
-   * Create Video from a local file by converting to a base64 data URL.
-   */
-  static async fromFile(filePath) {
-    const absolutePath = resolve(filePath);
-    const buffer = await readFile(absolutePath);
-    const base64Data = buffer.toString("base64");
-    const ext = getExtension(absolutePath).toLowerCase();
-    const mimeType = VIDEO_MIME_TYPES[ext] || "video/mp4";
-    return new _Video({ url: `data:${mimeType};base64,${base64Data}` });
+};
+
+// src/router/AgentRouter.ts
+var AgentRouter = class {
+  prefix;
+  tags;
+  reasoners = [];
+  skills = [];
+  constructor(options = {}) {
+    this.prefix = options.prefix;
+    this.tags = options.tags;
   }
-  /**
-   * Create Video from a URL.
-   */
-  static fromUrl(url) {
-    return new _Video({ url });
+  reasoner(name, handler, options) {
+    const fullName = this.prefix ? `${sanitize(this.prefix)}_${name}` : name;
+    this.reasoners.push({ name: fullName, handler, options });
+    return this;
   }
-  /**
-   * Create Video from a buffer.
-   */
-  static async fromBuffer(buffer, mimeType = "video/mp4") {
-    const base64Data = Buffer.from(buffer).toString("base64");
-    return new _Video({ url: `data:${mimeType};base64,${base64Data}` });
+  skill(name, handler, options) {
+    const fullName = this.prefix ? `${sanitize(this.prefix)}_${name}` : name;
+    this.skills.push({ name: fullName, handler, options });
+    return this;
   }
-  /**
-   * Create Video from a base64 string.
-   */
-  static async fromBase64(base64Data, mimeType = "video/mp4") {
-    return new _Video({ url: `data:${mimeType};base64,${base64Data}` });
+};
+function sanitize(value) {
+  return value.replace(/[^0-9a-zA-Z]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+}
+var JWE_ALG = "ECDH-ES";
+var JWE_ENC = "A256GCM";
+var KEY_AGREEMENT_TYPE = "X25519KeyAgreementKey2020";
+var PayloadEncryptionError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PayloadEncryptionError";
   }
 };
-var File = class _File {
-  type = "file";
-  file;
-  constructor(file) {
-    this.file = file;
+var encoder = new TextEncoder();
+function payloadToBytes(payload) {
+  if (payload instanceof Uint8Array) return payload;
+  if (typeof payload === "string") return encoder.encode(payload);
+  return encoder.encode(JSON.stringify(payload));
+}
+async function generateX25519KeyPair() {
+  const { privateKey, publicKey } = await generateKeyPair("ECDH-ES", {
+    crv: "X25519",
+    extractable: true
+  });
+  const privateJwk = await exportJWK(privateKey);
+  const publicJwk = await exportJWK(publicKey);
+  return { privateJwk, publicJwk };
+}
+function extractKeyAgreementJwk(didDocument) {
+  if (typeof didDocument !== "object" || didDocument === null) {
+    throw new PayloadEncryptionError("DID document must be an object");
   }
-  /**
-   * Create File from a local file path.
-   */
-  static async fromFile(filePath, mimeType) {
-    const absolutePath = resolve(filePath);
-    const detectedMimeType = mimeType || guessMimeType(absolutePath) || "application/octet-stream";
-    const buffer = await readFile(absolutePath);
-    const base64Data = buffer.toString("base64");
-    const dataUrl = `data:${detectedMimeType};base64,${base64Data}`;
-    return new _File({ url: dataUrl, mimeType: detectedMimeType });
+  const doc = didDocument["did_document"] ?? didDocument;
+  const flat = doc["key_agreement"];
+  if (flat && typeof flat === "object" && flat.crv === "X25519") {
+    return flat;
   }
-  /**
-   * Create File from a URL.
-   */
-  static fromUrl(url, mimeType) {
-    return new _File({ url, mimeType });
+  const keyAgreement = doc["keyAgreement"];
+  if (!keyAgreement || Array.isArray(keyAgreement) && keyAgreement.length === 0) {
+    throw new PayloadEncryptionError(
+      "DID document has no keyAgreement key; the agent has not published an X25519 encryption key"
+    );
   }
-  /**
-   * Create File from a buffer.
-   */
-  static async fromBuffer(buffer, mimeType) {
-    const base64Data = Buffer.from(buffer).toString("base64");
-    const dataUrl = `data:${mimeType};base64,${base64Data}`;
-    return new _File({ url: dataUrl, mimeType });
+  const verificationMethods = /* @__PURE__ */ new Map();
+  for (const vm2 of doc["verificationMethod"] ?? []) {
+    if (vm2 && typeof vm2 === "object" && typeof vm2["id"] === "string") {
+      verificationMethods.set(vm2["id"], vm2);
+    }
   }
-  /**
-   * Create File from a base64 string.
-   */
-  static async fromBase64(base64Data, mimeType) {
-    const dataUrl = `data:${mimeType};base64,${base64Data}`;
-    return new _File({ url: dataUrl, mimeType });
+  const entry = Array.isArray(keyAgreement) ? keyAgreement[0] : keyAgreement;
+  let vm;
+  if (typeof entry === "string") {
+    vm = verificationMethods.get(entry);
+    if (!vm) {
+      throw new PayloadEncryptionError(
+        `keyAgreement references unknown verification method ${entry}`
+      );
+    }
+  } else if (entry && typeof entry === "object") {
+    vm = entry;
+  } else {
+    throw new PayloadEncryptionError("unsupported keyAgreement entry shape");
   }
-};
-function getExtension(filePath) {
-  const lastDot = filePath.lastIndexOf(".");
-  if (lastDot === -1) {
-    return "";
+  const jwk = vm["publicKeyJwk"];
+  if (!jwk || jwk.crv !== "X25519") {
+    throw new PayloadEncryptionError(
+      "keyAgreement verification method does not carry an X25519 publicKeyJwk"
+    );
   }
-  return filePath.slice(lastDot);
+  return jwk;
 }
-function guessMimeType(filePath) {
-  const ext = getExtension(filePath).toLowerCase();
-  if (ext in IMAGE_MIME_TYPES) {
-    return IMAGE_MIME_TYPES[ext];
-  }
-  if (ext in AUDIO_MIME_TYPES) {
-    return AUDIO_MIME_TYPES[ext];
+async function encryptToJwk(publicJwk, payload) {
+  if (!publicJwk || publicJwk.crv !== "X25519") {
+    throw new PayloadEncryptionError("publicJwk must be an X25519 OKP JWK");
   }
-  if (ext in VIDEO_MIME_TYPES) {
-    return VIDEO_MIME_TYPES[ext];
+  try {
+    const key = await importJWK(publicJwk, JWE_ALG);
+    return await new CompactEncrypt(payloadToBytes(payload)).setProtectedHeader({ alg: JWE_ALG, enc: JWE_ENC }).encrypt(key);
+  } catch (err) {
+    if (err instanceof PayloadEncryptionError) throw err;
+    throw new PayloadEncryptionError(`encryption failed: ${err.message}`);
   }
-  const documentMimeTypes = {
-    ".pdf": "application/pdf",
-    ".doc": "application/msword",
-    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-    ".xls": "application/vnd.ms-excel",
-    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-    ".txt": "text/plain",
-    ".csv": "text/csv",
-    ".html": "text/html",
-    ".json": "application/json",
-    ".xml": "application/xml",
-    ".zip": "application/zip"
-  };
-  return documentMimeTypes[ext] || null;
-}
-function text(content) {
-  return new Text(content);
-}
-async function imageFromFile(filePath, detail = "high") {
-  return Image.fromFile(filePath, detail);
-}
-function imageFromUrl(url, detail = "high") {
-  return Image.fromUrl(url, detail);
-}
-async function imageFromBuffer(buffer, mimeType = "image/jpeg", detail = "high") {
-  return Image.fromBuffer(buffer, mimeType, detail);
-}
-async function imageFromBase64(base64Data, mimeType, detail = "high") {
-  return Image.fromBase64(base64Data, mimeType, detail);
-}
-async function audioFromFile(filePath, format) {
-  return Audio.fromFile(filePath, format);
-}
-async function audioFromUrl(url, format = "wav") {
-  return Audio.fromUrl(url, format);
-}
-async function audioFromBuffer(buffer, format = "wav") {
-  return Audio.fromBuffer(buffer, format);
-}
-async function audioFromBase64(base64Data, format = "wav") {
-  return Audio.fromBase64(base64Data, format);
-}
-async function videoFromFile(filePath) {
-  return Video.fromFile(filePath);
-}
-function videoFromUrl(url) {
-  return Video.fromUrl(url);
 }
-async function videoFromBuffer(buffer, mimeType = "video/mp4") {
-  return Video.fromBuffer(buffer, mimeType);
-}
-async function videoFromBase64(base64Data, mimeType = "video/mp4") {
-  return Video.fromBase64(base64Data, mimeType);
-}
-async function fileFromPath(filePath, mimeType) {
-  return File.fromFile(filePath, mimeType);
-}
-function fileFromUrl(url, mimeType) {
-  return File.fromUrl(url, mimeType);
+async function encryptForDid(did, payload, resolver) {
+  const document = await resolver(did);
+  if (!document) {
+    throw new PayloadEncryptionError(`could not resolve DID ${did}`);
+  }
+  const publicJwk = extractKeyAgreementJwk(document);
+  return encryptToJwk(publicJwk, payload);
 }
-async function fileFromBuffer(buffer, mimeType) {
-  return File.fromBuffer(buffer, mimeType);
+async function decrypt(token, privateJwk) {
+  try {
+    const key = await importJWK(privateJwk, JWE_ALG);
+    const { plaintext } = await compactDecrypt(token, key);
+    return Uint8Array.from(plaintext);
+  } catch (err) {
+    throw new PayloadEncryptionError(`decryption failed: ${err.message}`);
+  }
 }
-async function fileFromBase64(base64Data, mimeType) {
-  return File.fromBase64(base64Data, mimeType);
+async function decryptToString(token, privateJwk) {
+  return new TextDecoder().decode(await decrypt(token, privateJwk));
 }
 var MultimodalResponse = class {
   _text;
@@ -8589,6 +8634,6 @@ function loadFixture(source) {
   );
 }
 
-export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, ApprovalResult, Audio, CANONICAL_STATUSES, CostTracker, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, Image, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MODEL_VARIANT_SEP, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, PauseClock, PauseManager, PayloadEncryptionError, RateLimitError, RealtimeSession, ReasonerContext, SUPPORTED_PROVIDERS, SUPPORTED_SESSION_TRANSPORTS, SessionTransportError, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, USAGE_ENVELOPE_KEY, Video, WorkflowReporter, applyTriggerTransform, attachUsageToSyncResult, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, decrypt, decryptToString, deriveProvider, encryptForDid, encryptToJwk, eventTrigger, executeToolCallLoop, extractKeyAgreementJwk, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, generateX25519KeyPair, getCurrentContext, getCurrentSkillContext, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, installApprovalWebhookRoute, isActive, isExecutionLogBatchPayload, isTerminal, isTriggerEnvelope, loadFixture, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, resolveModelAndVariant, scheduleTrigger, serializeExecutionLogEntry, simulateSchedule, simulateTrigger, splitModelVariant, text, triggerToPayload, unwrapEnvelope, usageSummaryOrNull, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
+export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, ApprovalResult, Audio, CANONICAL_STATUSES, CostTracker, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, Image, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MODEL_VARIANT_SEP, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, PauseClock, PauseManager, PayloadEncryptionError, RateLimitError, RealtimeSession, ReasonerContext, SUPPORTED_PROVIDERS, SUPPORTED_SESSION_TRANSPORTS, SessionTransportError, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, USAGE_ENVELOPE_KEY, Video, WorkflowReporter, applyTriggerTransform, attachUsageToSyncResult, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, audioMediaType, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, decrypt, decryptToString, deriveProvider, encryptForDid, encryptToJwk, eventTrigger, executeToolCallLoop, extractKeyAgreementJwk, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, generateX25519KeyPair, getCurrentContext, getCurrentSkillContext, guessUrlMimeType, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, installApprovalWebhookRoute, isActive, isExecutionLogBatchPayload, isTerminal, isTriggerEnvelope, loadFixture, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, resolveModelAndVariant, scheduleTrigger, serializeExecutionLogEntry, simulateSchedule, simulateTrigger, splitModelVariant, text, triggerToPayload, unwrapEnvelope, usageSummaryOrNull, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map