@agentfield/sdk 0.1.92-rc.6 → 0.1.92-rc.8

package/dist/index.d.ts

@@ -1085,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;
@@ -1101,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
@@ -1112,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;
@@ -1929,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

@@ -3811,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 {
 };
@@ -3847,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
@@ -3911,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") {
@@ -4707,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) {
@@ -4992,7 +5078,8 @@ var Agent = class {
             sdk: {
               language: "typescript",
               version: AGENTFIELD_TS_SDK_VERSION
-            }
+            },
+            sessions: this.sessionDefinitions()
           }
         }
       });
@@ -6531,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