@agentfield/sdk 0.1.136 → 0.1.137-rc.10

package/README.md

@@ -1,5 +1,9 @@
 # AgentField TypeScript SDK
 
+## Graceful shutdown
+
+`serve()` installs SIGTERM and SIGINT handlers that notify the control plane and drain detached executions. Host processes that own signal handling can use `serve({ handleSignals: false })` and call the idempotent `shutdown()` method themselves. `AGENTFIELD_SHUTDOWN_TIMEOUT` accepts bare seconds (`30`) or durations (`30s`, `5m`) and defaults to 30 seconds. In Kubernetes, set `terminationGracePeriodSeconds` higher than this timeout.
+
 The TypeScript SDK provides an idiomatic Node.js interface for building and running AgentField agents. It mirrors the Python SDK APIs, including AI, memory, discovery, and MCP tooling.
 
 ## Installing

package/dist/index.d.ts

@@ -113,6 +113,200 @@ declare class PauseManager {
  */
 declare function installApprovalWebhookRoute(app: express.Express, manager: PauseManager, logger?: PauseLogger): void;
 
+/**
+ * Multimodal content helpers for AI prompts.
+ * Provides Image, Audio, and File classes with factory methods for creating
+ * multimodal content from various sources (files, URLs, buffers, base64).
+ */
+/**
+ * Represents text content in a multimodal prompt.
+ */
+declare class Text {
+    readonly type: 'text';
+    readonly text: string;
+    constructor(text: string);
+}
+/**
+ * Represents image content in a multimodal prompt.
+ */
+declare class Image {
+    readonly type: 'image_url';
+    readonly imageUrl: {
+        url: string;
+        detail?: 'low' | 'high' | 'auto';
+    };
+    private constructor();
+    /**
+     * Create Image from a local file by converting to base64 data URL.
+     */
+    static fromFile(filePath: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
+    /**
+     * Create Image from a URL.
+     */
+    static fromUrl(url: string, detail?: 'low' | 'high' | 'auto'): Image;
+    /**
+     * Create Image from a buffer.
+     */
+    static fromBuffer(buffer: Buffer | Uint8Array, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
+    /**
+     * Create Image from a base64 string.
+     */
+    static fromBase64(base64Data: string, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
+}
+/**
+ * Represents audio content in a multimodal prompt.
+ */
+declare class Audio {
+    readonly type: 'input_audio';
+    readonly audio: {
+        data: string;
+        format: string;
+    };
+    private constructor();
+    /**
+     * Create Audio from a local file by converting to base64.
+     */
+    static fromFile(filePath: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+    /**
+     * Create Audio from a URL (downloads and converts to base64).
+     */
+    static fromUrl(url: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+    /**
+     * Create Audio from a buffer.
+     */
+    static fromBuffer(buffer: Buffer | Uint8Array, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+    /**
+     * Create Audio from a base64 string.
+     */
+    static fromBase64(base64Data: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+}
+/**
+ * Represents video content in a multimodal prompt.
+ */
+declare class Video {
+    readonly type: 'video_url';
+    readonly videoUrl: {
+        url: string;
+    };
+    private constructor();
+    /**
+     * Create Video from a local file by converting to a base64 data URL.
+     */
+    static fromFile(filePath: string): Promise<Video>;
+    /**
+     * Create Video from a URL.
+     */
+    static fromUrl(url: string): Video;
+    /**
+     * Create Video from a buffer.
+     */
+    static fromBuffer(buffer: Buffer | Uint8Array, mimeType?: string): Promise<Video>;
+    /**
+     * Create Video from a base64 string.
+     */
+    static fromBase64(base64Data: string, mimeType?: string): Promise<Video>;
+}
+/**
+ * Represents a generic file content in a multimodal prompt.
+ */
+declare class File {
+    readonly type: 'file';
+    readonly file: {
+        url: string;
+        mimeType?: string;
+    };
+    private constructor();
+    /**
+     * Create File from a local file path.
+     */
+    static fromFile(filePath: string, mimeType?: string): Promise<File>;
+    /**
+     * Create File from a URL.
+     */
+    static fromUrl(url: string, mimeType?: string): File;
+    /**
+     * Create File from a buffer.
+     */
+    static fromBuffer(buffer: Buffer | Uint8Array, mimeType: string): Promise<File>;
+    /**
+     * Create File from a base64 string.
+     */
+    static fromBase64(base64Data: string, mimeType: string): Promise<File>;
+}
+/** Infer a MIME type from a URL's data prefix or pathname extension. */
+declare function guessUrlMimeType(url: string): string | null;
+/** Canonical IANA media type for an audio format (e.g. 'mp3' -> 'audio/mpeg'). */
+declare function audioMediaType(format: string): string;
+/**
+ * Create text content.
+ */
+declare function text(content: string): Text;
+/**
+ * Create image content from a local file.
+ */
+declare function imageFromFile(filePath: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
+/**
+ * Create image content from a URL.
+ */
+declare function imageFromUrl(url: string, detail?: 'low' | 'high' | 'auto'): Image;
+/**
+ * Create image content from a buffer.
+ */
+declare function imageFromBuffer(buffer: Buffer | Uint8Array, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
+/**
+ * Create image content from a base64 string.
+ */
+declare function imageFromBase64(base64Data: string, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
+/**
+ * Create audio content from a local file.
+ */
+declare function audioFromFile(filePath: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+/**
+ * Create audio content from a URL.
+ */
+declare function audioFromUrl(url: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+/**
+ * Create audio content from a buffer.
+ */
+declare function audioFromBuffer(buffer: Buffer | Uint8Array, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+/**
+ * Create audio content from a base64 string.
+ */
+declare function audioFromBase64(base64Data: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
+/**
+ * Create video content from a local file.
+ */
+declare function videoFromFile(filePath: string): Promise<Video>;
+/**
+ * Create video content from a URL.
+ */
+declare function videoFromUrl(url: string): Video;
+/**
+ * Create video content from a buffer.
+ */
+declare function videoFromBuffer(buffer: Buffer | Uint8Array, mimeType?: string): Promise<Video>;
+/**
+ * Create video content from a base64 string.
+ */
+declare function videoFromBase64(base64Data: string, mimeType?: string): Promise<Video>;
+/**
+ * Create file content from a local file.
+ */
+declare function fileFromPath(filePath: string, mimeType?: string): Promise<File>;
+/**
+ * Create file content from a URL.
+ */
+declare function fileFromUrl(url: string, mimeType?: string): File;
+/**
+ * Create file content from a buffer.
+ */
+declare function fileFromBuffer(buffer: Buffer | Uint8Array, mimeType: string): Promise<File>;
+/**
+ * Create file content from a base64 string.
+ */
+declare function fileFromBase64(base64Data: string, mimeType: string): Promise<File>;
+type MultimodalContent = Text | Image | Audio | Video | File;
+
 type ZodSchema<T> = z.Schema<T, z.ZodTypeDef, any>;
 interface AIRequestOptions {
     system?: string;
@@ -128,6 +322,8 @@ interface AIRequestOptions {
      * - 'tool': Force tool calling mode
      */
     mode?: 'auto' | 'json' | 'tool';
+    /** Additional image, audio, video, or file parts for the user message. */
+    content?: MultimodalContent[];
 }
 type AIStream = AsyncIterable<string>;
 interface AIEmbeddingOptions {
@@ -160,6 +356,7 @@ declare class AIClient {
         modelName: string;
     };
     private buildModel;
+    private buildPrompt;
     private buildEmbeddingModel;
     private openRouterHeaders;
     private getRateLimiter;
@@ -595,6 +792,7 @@ declare class AgentFieldClient {
     constructor(config: AgentConfig);
     register(payload: any): Promise<any>;
     getNode(nodeId: string): Promise<any>;
+    shutdown(nodeId: string): Promise<any>;
     heartbeat(status?: 'starting' | 'ready' | 'degraded' | 'offline'): Promise<HealthStatus>;
     execute<T = any>(target: string, input: any, metadata?: {
         runId?: string;
@@ -1327,7 +1525,7 @@ interface HarnessConfig {
      * When unset, `AGENTFIELD_HARNESS_PROVIDER` is consulted before the default.
      * An explicit value always wins.
      */
-    provider?: 'aforge' | 'claude-code' | 'codex' | 'gemini' | 'opencode';
+    provider?: 'aforge' | 'claude-code' | 'codex' | 'gemini' | 'opencode' | 'pi' | 'omp';
     /** Model identifier. Empty means the provider's own default. */
     model?: string;
     /**
@@ -1351,6 +1549,8 @@ interface HarnessConfig {
     codexBin?: string;
     geminiBin?: string;
     opencodeBin?: string;
+    piBin?: string;
+    ompBin?: string;
 }
 interface HarnessOptions {
     /**
@@ -1382,6 +1582,10 @@ interface HarnessOptions {
     codexBin?: string;
     geminiBin?: string;
     opencodeBin?: string;
+    piBin?: string;
+    ompBin?: string;
+    resumeSessionId?: string;
+    timeout?: number;
     schema?: unknown;
 }
 interface Metrics {
@@ -1691,6 +1895,8 @@ type RunnerOptions = Omit<HarnessOptions, 'schema'> & {
     codexBin?: string;
     geminiBin?: string;
     opencodeBin?: string;
+    piBin?: string;
+    ompBin?: string;
 };
 declare class HarnessRunner {
     private readonly config?;
@@ -1744,6 +1950,10 @@ declare class RealtimeSession {
 }
 declare function buildSessionDefinition(name: string, options: SessionOptions): SessionDefinition;
 
+interface ServeOptions {
+    handleSignals?: boolean;
+}
+
 declare class Agent {
     readonly config: AgentConfig;
     readonly app: express.Express;
@@ -1751,6 +1961,10 @@ declare class Agent {
     readonly skills: SkillRegistry;
     private server?;
     private heartbeatTimer?;
+    private shutdownPromise?;
+    private readonly inFlightExecutions;
+    private shuttingDown;
+    private signalHandlers?;
     private readonly aiClient;
     private readonly agentFieldClient;
     private readonly memoryClient;
@@ -1869,8 +2083,10 @@ declare class Agent {
         executionId?: string;
     }): Promise<ApprovalResult>;
     private buildExecutionLogContext;
-    serve(): Promise<void>;
+    serve(options?: ServeOptions): Promise<void>;
     shutdown(): Promise<void>;
+    private performShutdown;
+    private installSignalHandlers;
     call(target: string, input: any): Promise<any>;
     /**
      * Remote call variant that submits the execution asynchronously and polls for
@@ -2126,196 +2342,6 @@ declare class StatelessRateLimiter {
     executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
 }
 
-/**
- * Multimodal content helpers for AI prompts.
- * Provides Image, Audio, and File classes with factory methods for creating
- * multimodal content from various sources (files, URLs, buffers, base64).
- */
-/**
- * Represents text content in a multimodal prompt.
- */
-declare class Text {
-    readonly type: 'text';
-    readonly text: string;
-    constructor(text: string);
-}
-/**
- * Represents image content in a multimodal prompt.
- */
-declare class Image {
-    readonly type: 'image_url';
-    readonly imageUrl: {
-        url: string;
-        detail?: 'low' | 'high' | 'auto';
-    };
-    private constructor();
-    /**
-     * Create Image from a local file by converting to base64 data URL.
-     */
-    static fromFile(filePath: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
-    /**
-     * Create Image from a URL.
-     */
-    static fromUrl(url: string, detail?: 'low' | 'high' | 'auto'): Image;
-    /**
-     * Create Image from a buffer.
-     */
-    static fromBuffer(buffer: Buffer | Uint8Array, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
-    /**
-     * Create Image from a base64 string.
-     */
-    static fromBase64(base64Data: string, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
-}
-/**
- * Represents audio content in a multimodal prompt.
- */
-declare class Audio {
-    readonly type: 'input_audio';
-    readonly audio: {
-        data: string;
-        format: string;
-    };
-    private constructor();
-    /**
-     * Create Audio from a local file by converting to base64.
-     */
-    static fromFile(filePath: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-    /**
-     * Create Audio from a URL (downloads and converts to base64).
-     */
-    static fromUrl(url: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-    /**
-     * Create Audio from a buffer.
-     */
-    static fromBuffer(buffer: Buffer | Uint8Array, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-    /**
-     * Create Audio from a base64 string.
-     */
-    static fromBase64(base64Data: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-}
-/**
- * Represents video content in a multimodal prompt.
- */
-declare class Video {
-    readonly type: 'video_url';
-    readonly videoUrl: {
-        url: string;
-    };
-    private constructor();
-    /**
-     * Create Video from a local file by converting to a base64 data URL.
-     */
-    static fromFile(filePath: string): Promise<Video>;
-    /**
-     * Create Video from a URL.
-     */
-    static fromUrl(url: string): Video;
-    /**
-     * Create Video from a buffer.
-     */
-    static fromBuffer(buffer: Buffer | Uint8Array, mimeType?: string): Promise<Video>;
-    /**
-     * Create Video from a base64 string.
-     */
-    static fromBase64(base64Data: string, mimeType?: string): Promise<Video>;
-}
-/**
- * Represents a generic file content in a multimodal prompt.
- */
-declare class File {
-    readonly type: 'file';
-    readonly file: {
-        url: string;
-        mimeType?: string;
-    };
-    private constructor();
-    /**
-     * Create File from a local file path.
-     */
-    static fromFile(filePath: string, mimeType?: string): Promise<File>;
-    /**
-     * Create File from a URL.
-     */
-    static fromUrl(url: string, mimeType?: string): File;
-    /**
-     * Create File from a buffer.
-     */
-    static fromBuffer(buffer: Buffer | Uint8Array, mimeType: string): Promise<File>;
-    /**
-     * Create File from a base64 string.
-     */
-    static fromBase64(base64Data: string, mimeType: string): Promise<File>;
-}
-/**
- * Create text content.
- */
-declare function text(content: string): Text;
-/**
- * Create image content from a local file.
- */
-declare function imageFromFile(filePath: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
-/**
- * Create image content from a URL.
- */
-declare function imageFromUrl(url: string, detail?: 'low' | 'high' | 'auto'): Image;
-/**
- * Create image content from a buffer.
- */
-declare function imageFromBuffer(buffer: Buffer | Uint8Array, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
-/**
- * Create image content from a base64 string.
- */
-declare function imageFromBase64(base64Data: string, mimeType?: string, detail?: 'low' | 'high' | 'auto'): Promise<Image>;
-/**
- * Create audio content from a local file.
- */
-declare function audioFromFile(filePath: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-/**
- * Create audio content from a URL.
- */
-declare function audioFromUrl(url: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-/**
- * Create audio content from a buffer.
- */
-declare function audioFromBuffer(buffer: Buffer | Uint8Array, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-/**
- * Create audio content from a base64 string.
- */
-declare function audioFromBase64(base64Data: string, format?: 'wav' | 'mp3' | 'flac' | 'ogg'): Promise<Audio>;
-/**
- * Create video content from a local file.
- */
-declare function videoFromFile(filePath: string): Promise<Video>;
-/**
- * Create video content from a URL.
- */
-declare function videoFromUrl(url: string): Video;
-/**
- * Create video content from a buffer.
- */
-declare function videoFromBuffer(buffer: Buffer | Uint8Array, mimeType?: string): Promise<Video>;
-/**
- * Create video content from a base64 string.
- */
-declare function videoFromBase64(base64Data: string, mimeType?: string): Promise<Video>;
-/**
- * Create file content from a local file.
- */
-declare function fileFromPath(filePath: string, mimeType?: string): Promise<File>;
-/**
- * Create file content from a URL.
- */
-declare function fileFromUrl(url: string, mimeType?: string): File;
-/**
- * Create file content from a buffer.
- */
-declare function fileFromBuffer(buffer: Buffer | Uint8Array, mimeType: string): Promise<File>;
-/**
- * Create file content from a base64 string.
- */
-declare function fileFromBase64(base64Data: string, mimeType: string): Promise<File>;
-type MultimodalContent = Text | Image | Audio | Video | File;
-
 /**
  * Multimodal response classes for handling LLM multimodal outputs.
  * Provides seamless integration with audio, image, and file outputs while maintaining backward compatibility.
@@ -2698,6 +2724,14 @@ declare function splitModelVariant(model: unknown): ModelVariant;
 declare function resolveModelAndVariant(options: Record<string, unknown>): ModelVariant;
 
 declare const SUPPORTED_PROVIDERS: Set<string>;
+declare const DEFAULT_HARNESS_PROVIDER = "aforge";
+declare const HARNESS_PROVIDER_ENV_VAR = "AGENTFIELD_HARNESS_PROVIDER";
+/**
+ * Applies harness provider precedence: an explicit name wins, then
+ * AGENTFIELD_HARNESS_PROVIDER, then DEFAULT_HARNESS_PROVIDER ("aforge").
+ * Blank / whitespace-only values are treated as unset.
+ */
+declare function resolveProviderName(explicit?: string): string;
 declare function buildProvider(config: HarnessConfig): Promise<HarnessProvider>;
 
 /**
@@ -3036,4 +3070,4 @@ declare function simulateSchedule<R>(handler: (ctx: SimulatedContext) => R | Pro
  */
 declare function loadFixture(source: string): Record<string, unknown>;
 
-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 ApprovalDecision, type ApprovalRequestResponse, ApprovalResult, type ApprovalStatusResponse, Audio, type AudioOutput, type AudioRequest, type AuditTrailExport, type AuditTrailFilters, type Awaitable, CANONICAL_STATUSES, type CompactCapability, type CompactDiscoveryResponse, type CostEntry, type CostEntryInit, CostTracker, DIDAuthenticator, type DIDIdentity, type DIDIdentityPackage, type DIDRegistrationRequest, type DIDRegistrationResponse, type DeploymentType, DidClient, DidInterface, DidManager, type DidResolver, type DiscoveryFormat, type DiscoveryOptions, type DiscoveryPagination, type DiscoveryResponse, type DiscoveryResult, type EventTriggerBinding, type EventTriggerSpec, 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, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MODEL_VARIANT_SEP, type MediaProvider, MediaProviderError, type MediaResponse, MediaRouter, type MemoryChangeEvent, MemoryClient, MemoryClientBase, type MemoryConfig, MemoryEventClient, type MemoryEventHandler, type MemoryEventHistoryOptions, type MemoryEventSubscriptionOptions, MemoryInterface, type MemoryRequestMetadata, type MemoryRequestOptions, type MemoryScope, type MemoryWatchHandler, type Metrics, type ModelVariant, type MultimodalContent, MultimodalResponse, OpenRouterMediaProvider, type OpenRouterMediaProviderOptions, PauseClock, PauseManager, type Payload, PayloadEncryptionError, 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 ScheduleTriggerBinding, type ScheduleTriggerSpec, type ServerlessAdapter, type ServerlessEvent, type ServerlessResponse, type SessionDefinition, type SessionOptions, type SessionProvider, type SessionTransport, type SessionTransportCapability, SessionTransportError, type SessionTurn, type SimulateScheduleOptions, type SimulateTriggerOptions, type SimulatedContext, type SkillCapability, SkillContext, type SkillDefinition, type SkillHandler, type SkillOptions, StatelessRateLimiter, TERMINAL_STATUSES, Text, type ToolCallConfig, type ToolCallRecord, type ToolCallTrace, type ToolsOption, type TriggerBinding, type TriggerContext, type TriggerEnvelope, USAGE_ENVELOPE_KEY, type UnwrapResult, type UsageEntryWire, type UsageSummaryWire, type VectorSearchOptions, type VectorSearchResult, Video, type VideoFrameImage, type VideoInputReference, type VideoRequest, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, 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, type AIConfig, type AIEmbeddingOptions, type AIRequestOptions, type AIStream, type AIToolRequestOptions, Agent, type AgentCapability, type AgentConfig, type AgentHandler, AgentRouter, type AgentRouterOptions, type AgentState, ApprovalClient, type ApprovalDecision, type ApprovalRequestResponse, ApprovalResult, type ApprovalStatusResponse, Audio, type AudioOutput, type AudioRequest, type AuditTrailExport, type AuditTrailFilters, type Awaitable, CANONICAL_STATUSES, type CompactCapability, type CompactDiscoveryResponse, type CostEntry, type CostEntryInit, CostTracker, DEFAULT_HARNESS_PROVIDER, DIDAuthenticator, type DIDIdentity, type DIDIdentityPackage, type DIDRegistrationRequest, type DIDRegistrationResponse, type DeploymentType, DidClient, DidInterface, DidManager, type DidResolver, type DiscoveryFormat, type DiscoveryOptions, type DiscoveryPagination, type DiscoveryResponse, type DiscoveryResult, type EventTriggerBinding, type EventTriggerSpec, 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, HARNESS_PROVIDER_ENV_VAR, 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, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MODEL_VARIANT_SEP, type MediaProvider, MediaProviderError, type MediaResponse, MediaRouter, type MemoryChangeEvent, MemoryClient, MemoryClientBase, type MemoryConfig, MemoryEventClient, type MemoryEventHandler, type MemoryEventHistoryOptions, type MemoryEventSubscriptionOptions, MemoryInterface, type MemoryRequestMetadata, type MemoryRequestOptions, type MemoryScope, type MemoryWatchHandler, type Metrics, type ModelVariant, type MultimodalContent, MultimodalResponse, OpenRouterMediaProvider, type OpenRouterMediaProviderOptions, PauseClock, PauseManager, type Payload, PayloadEncryptionError, 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 ScheduleTriggerBinding, type ScheduleTriggerSpec, type ServerlessAdapter, type ServerlessEvent, type ServerlessResponse, type SessionDefinition, type SessionOptions, type SessionProvider, type SessionTransport, type SessionTransportCapability, SessionTransportError, type SessionTurn, type SimulateScheduleOptions, type SimulateTriggerOptions, type SimulatedContext, type SkillCapability, SkillContext, type SkillDefinition, type SkillHandler, type SkillOptions, StatelessRateLimiter, TERMINAL_STATUSES, Text, type ToolCallConfig, type ToolCallRecord, type ToolCallTrace, type ToolsOption, type TriggerBinding, type TriggerContext, type TriggerEnvelope, USAGE_ENVELOPE_KEY, type UnwrapResult, type UsageEntryWire, type UsageSummaryWire, type VectorSearchOptions, type VectorSearchResult, Video, type VideoFrameImage, type VideoInputReference, type VideoRequest, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, 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, resolveProviderName, scheduleTrigger, serializeExecutionLogEntry, simulateSchedule, simulateTrigger, splitModelVariant, text, triggerToPayload, unwrapEnvelope, usageSummaryOrNull, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };