@agentfield/sdk 0.1.91 → 0.1.92-rc.10

package/dist/index.d.ts

@@ -45,6 +45,7 @@ declare class AIClient {
     getModel(options?: AIRequestOptions): _ai_sdk_provider.LanguageModelV3;
     private buildModel;
     private buildEmbeddingModel;
+    private openRouterHeaders;
     private getRateLimiter;
     private withRateLimitRetry;
 }
@@ -869,6 +870,9 @@ interface AIConfig {
     embeddingModel?: string;
     apiKey?: string;
     baseUrl?: string;
+    openRouterSiteUrl?: string;
+    openRouterAppName?: string;
+    openRouterHeaders?: Record<string, string>;
     temperature?: number;
     maxTokens?: number;
     enableRateLimitRetry?: boolean;
@@ -1081,6 +1085,45 @@ declare class HarnessRunner {
     private sleep;
 }
 
+interface SessionDefinition {
+    name: string;
+    provider: string;
+    transport: string;
+    model?: string;
+    modalities: string[];
+    voice?: string;
+    tools: string[];
+    tags: string[];
+    proposed_tags: string[];
+    approved_tags: string[];
+    metadata: Record<string, unknown>;
+}
+interface SessionOptions {
+    provider: string;
+    transport: string;
+    model?: string;
+    modalities?: string[];
+    voice?: string;
+    tools?: string[];
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface SessionTurn {
+    text?: string;
+    transcript?: string;
+    audio?: unknown;
+    audioFormat?: string;
+    channel?: string;
+    metadata?: Record<string, unknown>;
+}
+declare class RealtimeSession {
+    readonly sessionId: string;
+    readonly definition: SessionDefinition;
+    constructor(sessionId: string, definition: SessionDefinition);
+    input(): Promise<SessionTurn>;
+}
+declare function buildSessionDefinition(name: string, options: SessionOptions): SessionDefinition;
+
 declare class Agent {
     readonly config: AgentConfig;
     readonly app: express.Express;
@@ -1097,6 +1140,7 @@ declare class Agent {
     private readonly memoryWatchers;
     private readonly localVerifier?;
     private readonly realtimeValidationFunctions;
+    private readonly sessions;
     private readonly processLogRing;
     private readonly executionLogger;
     /** Tracks an AbortController per in-flight execution_id so the
@@ -1108,6 +1152,8 @@ declare class Agent {
     reasoner<TInput = any, TOutput = any>(name: string, handler: ReasonerHandler<TInput, TOutput>, options?: ReasonerOptions): this;
     skill<TInput = any, TOutput = any>(name: string, handler: SkillHandler<TInput, TOutput>, options?: SkillOptions): this;
     includeRouter(router: AgentRouter): void;
+    session(name: string, options: SessionOptions, handler: (session: RealtimeSession) => Promise<unknown> | unknown): this;
+    sessionDefinitions(): SessionDefinition[];
     handler(adapter?: (event: any, context?: any) => ServerlessEvent): AgentHandler;
     watchMemory(pattern: string | string[], handler: MemoryWatchHandler, options?: {
         scope?: string;
@@ -1780,11 +1826,15 @@ declare class MediaRouter {
 interface OpenRouterMediaProviderOptions {
     apiKey?: string;
     baseUrl?: string;
+    openRouterSiteUrl?: string;
+    openRouterAppName?: string;
+    openRouterHeaders?: Record<string, string>;
 }
 declare class OpenRouterMediaProvider implements MediaProvider {
     readonly name = "openrouter";
     readonly supportedModalities: string[];
     private readonly baseUrl;
+    private readonly attributionHeaders;
     constructor(options?: OpenRouterMediaProviderOptions);
     /**
      * Seed the metadata cache for a model. Useful when running against test
@@ -1921,4 +1971,23 @@ declare class ApprovalClient {
     waitForApproval(executionId: string, opts?: WaitForApprovalOptions): Promise<ApprovalStatusResponse>;
 }
 
-export { ACTIVE_STATUSES, AIClient, type AIConfig, type AIEmbeddingOptions, type AIRequestOptions, type AIStream, type AIToolRequestOptions, Agent, type AgentCapability, type AgentConfig, type AgentHandler, AgentRouter, type AgentRouterOptions, type AgentState, ApprovalClient, type ApprovalRequestResponse, type ApprovalStatusResponse, Audio, type AudioOutput, type AudioRequest, type AuditTrailExport, type AuditTrailFilters, type Awaitable, CANONICAL_STATUSES, type CompactCapability, type CompactDiscoveryResponse, DIDAuthenticator, type DIDIdentity, type DIDIdentityPackage, type DIDRegistrationRequest, type DIDRegistrationResponse, type DeploymentType, DidClient, DidInterface, DidManager, type DiscoveryFormat, type DiscoveryOptions, type DiscoveryPagination, type DiscoveryResponse, type DiscoveryResult, ExecutionContext, type ExecutionCredential, type ExecutionLogAttributes, type ExecutionLogBatchPayload, type ExecutionLogContext, type ExecutionLogEmitOptions, type ExecutionLogEntry, type ExecutionLogLevel, type ExecutionLogTransport, type ExecutionLogTransportPayload, type ExecutionLogWireEntry, ExecutionLogger, type ExecutionLoggerOptions, type ExecutionMetadata, ExecutionStatus, type ExecutionStatusValue, File, type FileOutput, type GenerateCredentialOptions, type GenerateCredentialParams, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, type HarnessConfig, type HarnessOptions, type HarnessProvider, type HarnessResult, HarnessRunner, type HealthStatus, Image, type ImageOutput, type ImageRequest, type MediaProvider, MediaProviderError, type MediaResponse, MediaRouter, type MemoryChangeEvent, MemoryClient, MemoryClientBase, type MemoryConfig, MemoryEventClient, type MemoryEventHandler, type MemoryEventHistoryOptions, MemoryInterface, type MemoryRequestMetadata, type MemoryRequestOptions, type MemoryScope, type MemoryWatchHandler, type Metrics, type MultimodalContent, MultimodalResponse, OpenRouterMediaProvider, type OpenRouterMediaProviderOptions, RateLimitError, type RateLimiterOptions, type RawExecutionContext, type RawResult, type ReasonerCapability, ReasonerContext, type ReasonerDefinition, type ReasonerHandler, type ReasonerOptions, type RequestApprovalPayload, SUPPORTED_PROVIDERS, type ServerlessAdapter, type ServerlessEvent, type ServerlessResponse, type SkillCapability, SkillContext, type SkillDefinition, type SkillHandler, type SkillOptions, StatelessRateLimiter, TERMINAL_STATUSES, Text, type ToolCallConfig, type ToolCallRecord, type ToolCallTrace, type ToolsOption, type VectorSearchOptions, type VectorSearchResult, Video, type VideoFrameImage, type VideoInputReference, type VideoRequest, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, buildProvider, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, executeToolCallLoop, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, getCurrentContext, getCurrentSkillContext, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, isActive, isExecutionLogBatchPayload, isTerminal, normalizeExecutionLogEntry, normalizeStatus, serializeExecutionLogEntry, text, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
+declare const SUPPORTED_SESSION_TRANSPORTS: {
+    readonly openai: readonly ["webrtc", "websocket"];
+    readonly openrouter: readonly ["audio_turns"];
+};
+type SessionProvider = keyof typeof SUPPORTED_SESSION_TRANSPORTS;
+type SessionTransport = (typeof SUPPORTED_SESSION_TRANSPORTS)[SessionProvider][number];
+interface SessionTransportCapability {
+    provider: SessionProvider;
+    transport: SessionTransport;
+}
+declare class SessionTransportError extends Error {
+    readonly provider: string;
+    readonly transport: string;
+    readonly supported: readonly string[];
+    constructor(provider: string, transport: string, supported: readonly string[]);
+}
+declare function normalizeSessionTransportValue(value: string): string;
+declare function validateSessionTransport(provider: string, transport: string): SessionTransportCapability;
+
+export { ACTIVE_STATUSES, AIClient, type AIConfig, type AIEmbeddingOptions, type AIRequestOptions, type AIStream, type AIToolRequestOptions, Agent, type AgentCapability, type AgentConfig, type AgentHandler, AgentRouter, type AgentRouterOptions, type AgentState, ApprovalClient, type ApprovalRequestResponse, type ApprovalStatusResponse, Audio, type AudioOutput, type AudioRequest, type AuditTrailExport, type AuditTrailFilters, type Awaitable, CANONICAL_STATUSES, type CompactCapability, type CompactDiscoveryResponse, DIDAuthenticator, type DIDIdentity, type DIDIdentityPackage, type DIDRegistrationRequest, type DIDRegistrationResponse, type DeploymentType, DidClient, DidInterface, DidManager, type DiscoveryFormat, type DiscoveryOptions, type DiscoveryPagination, type DiscoveryResponse, type DiscoveryResult, ExecutionContext, type ExecutionCredential, type ExecutionLogAttributes, type ExecutionLogBatchPayload, type ExecutionLogContext, type ExecutionLogEmitOptions, type ExecutionLogEntry, type ExecutionLogLevel, type ExecutionLogTransport, type ExecutionLogTransportPayload, type ExecutionLogWireEntry, ExecutionLogger, type ExecutionLoggerOptions, type ExecutionMetadata, ExecutionStatus, type ExecutionStatusValue, File, type FileOutput, type GenerateCredentialOptions, type GenerateCredentialParams, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, type HarnessConfig, type HarnessOptions, type HarnessProvider, type HarnessResult, HarnessRunner, type HealthStatus, Image, type ImageOutput, type ImageRequest, type MediaProvider, MediaProviderError, type MediaResponse, MediaRouter, type MemoryChangeEvent, MemoryClient, MemoryClientBase, type MemoryConfig, MemoryEventClient, type MemoryEventHandler, type MemoryEventHistoryOptions, MemoryInterface, type MemoryRequestMetadata, type MemoryRequestOptions, type MemoryScope, type MemoryWatchHandler, type Metrics, type MultimodalContent, MultimodalResponse, OpenRouterMediaProvider, type OpenRouterMediaProviderOptions, RateLimitError, type RateLimiterOptions, type RawExecutionContext, type RawResult, RealtimeSession, type ReasonerCapability, ReasonerContext, type ReasonerDefinition, type ReasonerHandler, type ReasonerOptions, type RequestApprovalPayload, SUPPORTED_PROVIDERS, SUPPORTED_SESSION_TRANSPORTS, type ServerlessAdapter, type ServerlessEvent, type ServerlessResponse, type SessionDefinition, type SessionOptions, type SessionProvider, type SessionTransport, type SessionTransportCapability, SessionTransportError, type SessionTurn, type SkillCapability, SkillContext, type SkillDefinition, type SkillHandler, type SkillOptions, StatelessRateLimiter, TERMINAL_STATUSES, Text, type ToolCallConfig, type ToolCallRecord, type ToolCallTrace, type ToolsOption, type VectorSearchOptions, type VectorSearchResult, Video, type VideoFrameImage, type VideoInputReference, type VideoRequest, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, executeToolCallLoop, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, getCurrentContext, getCurrentSkillContext, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, isActive, isExecutionLogBatchPayload, isTerminal, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, serializeExecutionLogEntry, text, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };

package/dist/index.js

@@ -27,13 +27,119 @@ import { readFile } from 'fs/promises';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
+
+// src/ai/openrouterAttribution.ts
+function isOpenRouterRequest(options) {
+  const provider = clean(options.provider)?.toLowerCase();
+  if (provider === "openrouter") {
+    return true;
+  }
+  const model = clean(options.model)?.toLowerCase();
+  if (model?.startsWith("openrouter/")) {
+    return true;
+  }
+  const baseUrl = clean(options.baseUrl)?.toLowerCase();
+  return Boolean(baseUrl?.includes("openrouter.ai"));
+}
+function openRouterAttributionEnabled(env = process.env) {
+  const raw = clean(env.AGENTFIELD_OPENROUTER_ATTRIBUTION);
+  if (!raw) {
+    return true;
+  }
+  return !["0", "false", "no", "off"].includes(raw.toLowerCase());
+}
+function resolveOpenRouterAttribution(options = {}) {
+  const env = options.env ?? process.env;
+  if (!openRouterAttributionEnabled(env)) {
+    return void 0;
+  }
+  const siteUrl = clean(options.siteUrl) ?? clean(env.AGENTFIELD_OPENROUTER_SITE_URL) ?? clean(env.OR_SITE_URL) ?? DEFAULT_OPENROUTER_SITE_URL;
+  const appName = clean(options.appName) ?? clean(env.AGENTFIELD_OPENROUTER_APP_NAME) ?? clean(env.OR_APP_NAME) ?? DEFAULT_OPENROUTER_APP_NAME;
+  return { siteUrl, appName };
+}
+function openRouterAttributionHeaders(options = {}) {
+  const resolved = resolveOpenRouterAttribution(options);
+  if (!resolved) {
+    return {};
+  }
+  return {
+    "HTTP-Referer": resolved.siteUrl,
+    "X-OpenRouter-Title": resolved.appName,
+    "X-Title": resolved.appName
+  };
+}
+function mergeOpenRouterAttributionHeaders(existing = {}, options = {}) {
+  const merged = {};
+  const lowerKeys = /* @__PURE__ */ new Set();
+  for (const [key, value] of Object.entries(existing)) {
+    const cleaned = clean(value);
+    if (!cleaned) {
+      continue;
+    }
+    merged[key] = cleaned;
+    lowerKeys.add(key.toLowerCase());
+  }
+  for (const [key, value] of Object.entries(openRouterAttributionHeaders(options))) {
+    if (!lowerKeys.has(key.toLowerCase())) {
+      merged[key] = value;
+    }
+  }
+  return merged;
+}
+function openRouterAttributionEnv(env = process.env) {
+  const resolved = resolveOpenRouterAttribution({ env });
+  if (!resolved) {
+    return {};
+  }
+  return {
+    AGENTFIELD_OPENROUTER_SITE_URL: resolved.siteUrl,
+    AGENTFIELD_OPENROUTER_APP_NAME: resolved.appName,
+    OR_SITE_URL: resolved.siteUrl,
+    OR_APP_NAME: resolved.appName
+  };
+}
+function applyOpenRouterAttributionEnv(env) {
+  if (!openRouterAttributionEnabled(env)) {
+    for (const key of [
+      "AGENTFIELD_OPENROUTER_SITE_URL",
+      "AGENTFIELD_OPENROUTER_APP_NAME",
+      "OR_SITE_URL",
+      "OR_APP_NAME"
+    ]) {
+      delete env[key];
+    }
+    return;
+  }
+  const attribution = openRouterAttributionEnv(env);
+  for (const [key, value] of Object.entries(attribution)) {
+    if (clean(env[key]) == null) {
+      env[key] = value;
+    }
+  }
+}
+function clean(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : void 0;
+}
+var DEFAULT_OPENROUTER_SITE_URL, DEFAULT_OPENROUTER_APP_NAME;
+var init_openrouterAttribution = __esm({
+  "src/ai/openrouterAttribution.ts"() {
+    DEFAULT_OPENROUTER_SITE_URL = "https://agentfield.ai";
+    DEFAULT_OPENROUTER_APP_NAME = "AgentField AI";
+  }
+});
 function getZodConverter() {
   if (zodConverter !== void 0) {
     return zodConverter;
@@ -340,8 +446,10 @@ var init_claude = __esm({
 function runCli(cmd, options) {
   return new Promise((resolve2, reject) => {
     const [bin, ...args] = cmd;
+    const env = { ...process.env, ...options?.env };
+    applyOpenRouterAttributionEnv(env);
     const proc = spawn(bin, args, {
-      env: { ...process.env, ...options?.env },
+      env,
       cwd: options?.cwd,
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -414,6 +522,7 @@ function extractFinalText(events) {
 }
 var init_cli = __esm({
   "src/harness/cli.ts"() {
+    init_openrouterAttribution();
   }
 });
 
@@ -566,6 +675,7 @@ var init_opencode = __esm({
   "src/harness/providers/opencode.ts"() {
     init_types();
     init_cli();
+    init_openrouterAttribution();
     OpenCodeProvider = class {
       bin;
       constructor(binPath = "opencode") {
@@ -593,6 +703,22 @@ USER REQUEST:
 ${prompt}`;
         }
         cmd.push(effectivePrompt);
+        const explicitModel = typeof options.model === "string" ? options.model : void 0;
+        if (explicitModel && isOpenRouterRequest({ model: explicitModel }) && !env.OPENCODE_CONFIG_CONTENT && !process.env.OPENCODE_CONFIG_CONTENT) {
+          const modelSlug = explicitModel.slice("openrouter/".length);
+          const headers = openRouterAttributionHeaders({ env: { ...process.env, ...env } });
+          if (modelSlug && Object.keys(headers).length > 0) {
+            env.OPENCODE_CONFIG_CONTENT = JSON.stringify({
+              provider: {
+                openrouter: {
+                  models: {
+                    [modelSlug]: { headers }
+                  }
+                }
+              }
+            });
+          }
+        }
         const startApi = Date.now();
         try {
           const { stdout, stderr, exitCode } = await runCli(cmd, { env });
@@ -692,6 +818,7 @@ var init_runner = __esm({
       constructor(config) {
         this.config = config;
       }
+      config;
       async run(prompt, options = {}) {
         const { schema, ...rest } = options;
         const resolved = this.resolveOptions(this.config, rest);
@@ -1671,6 +1798,7 @@ function toError(error) {
 }
 
 // src/ai/AIClient.ts
+init_openrouterAttribution();
 function repairJsonText(text2) {
   let cleaned = text2.trim();
   const codeBlockMatch = cleaned.match(/```(?:json)?\s*([\s\S]*?)```/);
@@ -1772,6 +1900,7 @@ var AIClient = class {
   buildModel(options) {
     const provider = options.provider ?? this.config.provider ?? "openai";
     const modelName = options.model ?? this.config.model ?? "gpt-4o";
+    const openRouterHeaders = this.openRouterHeaders(provider, modelName);
     switch (provider) {
       case "anthropic": {
         const anthropic = createAnthropic({
@@ -1825,7 +1954,8 @@ var AIClient = class {
       case "openrouter": {
         const openrouter = createOpenAI({
           apiKey: this.config.apiKey,
-          baseURL: this.config.baseUrl ?? "https://openrouter.ai/api/v1"
+          baseURL: this.config.baseUrl ?? "https://openrouter.ai/api/v1",
+          headers: openRouterHeaders
         });
         return openrouter.chat(modelName);
       }
@@ -1841,7 +1971,8 @@ var AIClient = class {
       default: {
         const openai = createOpenAI({
           apiKey: this.config.apiKey,
-          baseURL: this.config.baseUrl
+          baseURL: this.config.baseUrl,
+          ...openRouterHeaders ? { headers: openRouterHeaders } : {}
         });
         return openai(modelName);
       }
@@ -1850,6 +1981,7 @@ var AIClient = class {
   buildEmbeddingModel(options) {
     const provider = options.provider ?? this.config.provider ?? "openai";
     const modelName = options.model ?? this.config.embeddingModel ?? "text-embedding-3-small";
+    const openRouterHeaders = this.openRouterHeaders(provider, modelName);
     const noEmbeddingProviders = ["anthropic", "xai", "deepseek", "groq"];
     if (noEmbeddingProviders.includes(provider)) {
       throw new Error(`Embedding generation is not supported for ${provider} provider`);
@@ -1882,12 +2014,22 @@ var AIClient = class {
       default: {
         const openai = createOpenAI({
           apiKey: this.config.apiKey ?? (provider === "ollama" ? "ollama" : void 0),
-          baseURL: this.config.baseUrl ?? (provider === "openrouter" ? "https://openrouter.ai/api/v1" : provider === "ollama" ? "http://localhost:11434/v1" : void 0)
+          baseURL: this.config.baseUrl ?? (provider === "openrouter" ? "https://openrouter.ai/api/v1" : provider === "ollama" ? "http://localhost:11434/v1" : void 0),
+          ...openRouterHeaders ? { headers: openRouterHeaders } : {}
         });
         return openai.embedding(modelName);
       }
     }
   }
+  openRouterHeaders(provider, model) {
+    if (!isOpenRouterRequest({ provider, model, baseUrl: this.config.baseUrl })) {
+      return void 0;
+    }
+    return mergeOpenRouterAttributionHeaders(this.config.openRouterHeaders, {
+      siteUrl: this.config.openRouterSiteUrl,
+      appName: this.config.openRouterAppName
+    });
+  }
   getRateLimiter() {
     if (!this.rateLimiter) {
       this.rateLimiter = new StatelessRateLimiter({
@@ -3669,6 +3811,83 @@ function registerAgentfieldLogsRoute(app, ring) {
   });
 }
 
+// src/sessionTransport.ts
+var SUPPORTED_SESSION_TRANSPORTS = {
+  openai: ["webrtc", "websocket"],
+  openrouter: ["audio_turns"]
+};
+var SessionTransportError = class extends Error {
+  provider;
+  transport;
+  supported;
+  constructor(provider, transport, supported) {
+    const supportedDisplay = supported.length > 0 ? supported.join(", ") : "none";
+    super(
+      `Unsupported session transport '${transport}' for provider '${provider}'. Supported transports: ${supportedDisplay}. AgentField does not infer or switch providers; set provider and transport explicitly.`
+    );
+    this.name = "SessionTransportError";
+    this.provider = provider;
+    this.transport = transport;
+    this.supported = supported;
+  }
+};
+function normalizeSessionTransportValue(value) {
+  return value.trim().toLowerCase().replace(/-/g, "_");
+}
+function validateSessionTransport(provider, transport) {
+  const normalizedProvider = normalizeSessionTransportValue(provider);
+  const normalizedTransport = normalizeSessionTransportValue(transport);
+  if (!normalizedProvider) {
+    throw new Error("Session provider is required; AgentField does not infer providers.");
+  }
+  if (!normalizedTransport) {
+    throw new Error("Session transport is required; AgentField does not infer transports.");
+  }
+  const supported = SUPPORTED_SESSION_TRANSPORTS[normalizedProvider];
+  if (!supported) {
+    const known = Object.keys(SUPPORTED_SESSION_TRANSPORTS).sort().join(", ");
+    throw new Error(
+      `Unknown session provider '${provider}'. Known providers: ${known}. Register provider capabilities before using a custom session provider.`
+    );
+  }
+  if (!supported.includes(normalizedTransport)) {
+    throw new SessionTransportError(normalizedProvider, normalizedTransport, supported);
+  }
+  return {
+    provider: normalizedProvider,
+    transport: normalizedTransport
+  };
+}
+
+// src/session.ts
+var RealtimeSession = class {
+  sessionId;
+  definition;
+  constructor(sessionId, definition) {
+    this.sessionId = sessionId;
+    this.definition = definition;
+  }
+  async input() {
+    throw new Error("session.input() is populated by the AgentField control plane transport adapter");
+  }
+};
+function buildSessionDefinition(name, options) {
+  const capability = validateSessionTransport(options.provider, options.transport);
+  return {
+    name,
+    provider: capability.provider,
+    transport: capability.transport,
+    model: options.model,
+    modalities: options.modalities ?? ["audio", "text"],
+    voice: options.voice,
+    tools: options.tools ?? [],
+    tags: options.tags ?? [],
+    proposed_tags: options.tags ?? [],
+    approved_tags: [],
+    metadata: options.metadata ?? {}
+  };
+}
+
 // src/agent/Agent.ts
 var TargetNotFoundError = class extends Error {
 };
@@ -3705,6 +3924,7 @@ var Agent = class {
   memoryWatchers = [];
   localVerifier;
   realtimeValidationFunctions = /* @__PURE__ */ new Set();
+  sessions = /* @__PURE__ */ new Map();
   processLogRing = new ProcessLogRing();
   executionLogger;
   /** Tracks an AbortController per in-flight execution_id so the
@@ -3769,6 +3989,13 @@ var Agent = class {
     this.reasoners.includeRouter(router);
     this.skills.includeRouter(router);
   }
+  session(name, options, handler) {
+    this.sessions.set(name, { definition: buildSessionDefinition(name, options), handler });
+    return this;
+  }
+  sessionDefinitions() {
+    return Array.from(this.sessions.values()).map((entry) => entry.definition);
+  }
   handler(adapter) {
     return async (event, res) => {
       if (res && typeof res === "object" && typeof res.setHeader === "function") {
@@ -4565,7 +4792,8 @@ var Agent = class {
       version: this.config.version,
       deployment_type: deploymentType,
       reasoners: this.reasonerDefinitions(),
-      skills: this.skillDefinitions()
+      skills: this.skillDefinitions(),
+      sessions: this.sessionDefinitions()
     };
   }
   async executeInvocation(params) {
@@ -4850,7 +5078,8 @@ var Agent = class {
             sdk: {
               language: "typescript",
               version: AGENTFIELD_TS_SDK_VERSION
-            }
+            },
+            sessions: this.sessionDefinitions()
           }
         }
       });
@@ -5644,6 +5873,7 @@ var MediaRouter = class {
 };
 
 // src/ai/OpenRouterMediaProvider.ts
+init_openrouterAttribution();
 var OPENROUTER_BASE = "https://openrouter.ai/api/v1";
 var DEFAULT_POLL_INTERVAL = 3e4;
 var DEFAULT_TIMEOUT = 6e5;
@@ -5735,9 +5965,14 @@ var OpenRouterMediaProvider = class {
   name = "openrouter";
   supportedModalities = ["image", "audio", "video"];
   baseUrl;
+  attributionHeaders;
   constructor(options = {}) {
     const key = options.apiKey ?? process.env.OPENROUTER_API_KEY ?? "";
     this.baseUrl = options.baseUrl ?? OPENROUTER_BASE;
+    this.attributionHeaders = mergeOpenRouterAttributionHeaders(options.openRouterHeaders, {
+      siteUrl: options.openRouterSiteUrl,
+      appName: options.openRouterAppName
+    });
     if (!key) {
       throw new MediaProviderError("OpenRouter API key required: pass apiKey or set OPENROUTER_API_KEY", {
         provider: "openrouter"
@@ -5897,7 +6132,10 @@ var OpenRouterMediaProvider = class {
       } catch {
       }
       const dlRes = await fetch(videoUrl, {
-        headers: downloadHeaders,
+        headers: mergeOpenRouterAttributionHeaders({
+          ...this.attributionHeaders,
+          ...downloadHeaders
+        }),
         signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT),
         redirect: "error"
       });
@@ -6189,10 +6427,11 @@ var OpenRouterMediaProvider = class {
     const key = apiKeyStore.get(this);
     return fetch(url, {
       method: "POST",
-      headers: {
+      headers: mergeOpenRouterAttributionHeaders({
+        ...this.attributionHeaders,
         "Content-Type": "application/json",
         Authorization: `Bearer ${key}`
-      },
+      }),
       body: JSON.stringify(body),
       signal: AbortSignal.timeout(API_TIMEOUT)
     });
@@ -6201,9 +6440,10 @@ var OpenRouterMediaProvider = class {
     const key = apiKeyStore.get(this);
     return fetch(url, {
       method: "GET",
-      headers: {
+      headers: mergeOpenRouterAttributionHeaders({
+        ...this.attributionHeaders,
         Authorization: `Bearer ${key}`
-      },
+      }),
       signal: AbortSignal.timeout(API_TIMEOUT)
     });
   }
@@ -6378,6 +6618,6 @@ function sleep2(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 
-export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, Audio, CANONICAL_STATUSES, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, Image, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, RateLimitError, ReasonerContext, SUPPORTED_PROVIDERS, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, Video, WorkflowReporter, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, buildProvider, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, executeToolCallLoop, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, getCurrentContext, getCurrentSkillContext, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, isActive, isExecutionLogBatchPayload, isTerminal, normalizeExecutionLogEntry, normalizeStatus, serializeExecutionLogEntry, text, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
+export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, Audio, CANONICAL_STATUSES, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, Image, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, RateLimitError, RealtimeSession, ReasonerContext, SUPPORTED_PROVIDERS, SUPPORTED_SESSION_TRANSPORTS, SessionTransportError, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, Video, WorkflowReporter, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, executeToolCallLoop, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, getCurrentContext, getCurrentSkillContext, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, isActive, isExecutionLogBatchPayload, isTerminal, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, serializeExecutionLogEntry, text, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map