@agentfield/sdk 0.1.45-rc.1 → 0.1.45-rc.2

package/dist/index.d.ts

@@ -526,6 +526,74 @@ interface SkillOptions {
     requireRealtimeValidation?: boolean;
 }
 
+interface HarnessConfig {
+    provider: 'claude-code' | 'codex' | 'gemini' | 'opencode';
+    model?: string;
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    tools?: string[];
+    permissionMode?: string;
+    systemPrompt?: string;
+    env?: Record<string, string>;
+    cwd?: string;
+    codexBin?: string;
+    geminiBin?: string;
+    opencodeBin?: string;
+}
+interface HarnessOptions {
+    provider?: string;
+    model?: string;
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    tools?: string[];
+    permissionMode?: string;
+    systemPrompt?: string;
+    env?: Record<string, string>;
+    cwd?: string;
+    codexBin?: string;
+    geminiBin?: string;
+    opencodeBin?: string;
+    schema?: unknown;
+}
+interface Metrics {
+    durationMs: number;
+    durationApiMs: number;
+    numTurns: number;
+    totalCostUsd?: number;
+    usage?: Record<string, unknown>;
+    sessionId: string;
+}
+interface RawResult {
+    result?: string;
+    messages: Array<Record<string, unknown>>;
+    metrics: Metrics;
+    isError: boolean;
+    errorMessage?: string;
+}
+interface HarnessResult {
+    result?: string;
+    parsed?: unknown;
+    isError: boolean;
+    errorMessage?: string;
+    costUsd?: number;
+    numTurns: number;
+    durationMs: number;
+    sessionId: string;
+    messages: Array<Record<string, unknown>>;
+    readonly text: string;
+}
+declare function createHarnessResult(partial?: Partial<Omit<HarnessResult, 'text'>>): HarnessResult;
+declare function createMetrics(partial?: Partial<Metrics>): Metrics;
+declare function createRawResult(partial?: Partial<RawResult>): RawResult;
+
 type DeploymentType = 'long_running' | 'serverless';
 interface AgentConfig {
     nodeId: string;
@@ -536,6 +604,7 @@ interface AgentConfig {
     host?: string;
     publicUrl?: string;
     aiConfig?: AIConfig;
+    harnessConfig?: HarnessConfig;
     memoryConfig?: MemoryConfig;
     didEnabled?: boolean;
     devMode?: boolean;
@@ -734,6 +803,32 @@ declare class SkillRegistry {
     all(): SkillDefinition<any, any>[];
 }
 
+interface HarnessProvider {
+    execute(prompt: string, options: Record<string, unknown>): Promise<RawResult>;
+}
+
+type RunnerOptions = Omit<HarnessOptions, 'schema'> & {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    codexBin?: string;
+    geminiBin?: string;
+    opencodeBin?: string;
+};
+declare class HarnessRunner {
+    private readonly config?;
+    constructor(config?: HarnessConfig | undefined);
+    run(prompt: string, options?: HarnessOptions): Promise<HarnessResult>;
+    resolveOptions(config: Partial<HarnessConfig> | undefined, overrides: RunnerOptions): RunnerOptions;
+    isTransient(errorStr: string): boolean;
+    executeWithRetry(provider: HarnessProvider, prompt: string, options: RunnerOptions): Promise<RawResult>;
+    handleSchemaOutput(raw: RawResult, schema: unknown, cwd: string, startTime: number): HarnessResult;
+    private buildProvider;
+    private computeBackoffDelay;
+    private sleep;
+}
+
 interface MCPTool {
     name: string;
     description?: string;
@@ -789,6 +884,8 @@ declare class Agent {
         registered: MCPToolRegistration[];
     }>;
     getAIClient(): AIClient;
+    getHarnessRunner(): Promise<HarnessRunner>;
+    harness(prompt: string, options?: HarnessOptions): Promise<HarnessResult>;
     getMemoryInterface(metadata?: ExecutionMetadata): MemoryInterface;
     getWorkflowReporter(metadata: ExecutionMetadata): WorkflowReporter;
     getDidInterface(metadata: ExecutionMetadata, defaultInput?: any, targetName?: string): DidInterface;
@@ -982,6 +1079,9 @@ declare class StatelessRateLimiter {
     executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
 }
 
+declare const SUPPORTED_PROVIDERS: Set<string>;
+declare function buildProvider(config: HarnessConfig): Promise<HarnessProvider>;
+
 /**
  * Canonical execution status utilities for the AgentField TypeScript SDK.
  *
@@ -1086,4 +1186,4 @@ declare class ApprovalClient {
     waitForApproval(executionId: string, opts?: WaitForApprovalOptions): Promise<ApprovalStatusResponse>;
 }
 
-export { ACTIVE_STATUSES, AIClient, type AIConfig, type AIEmbeddingOptions, type AIRequestOptions, type AIStream, Agent, type AgentCapability, type AgentConfig, type AgentHandler, AgentRouter, type AgentRouterOptions, type AgentState, ApprovalClient, type ApprovalRequestResponse, type ApprovalStatusResponse, 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 ExecutionMetadata, ExecutionStatus, type ExecutionStatusValue, type GenerateCredentialOptions, type GenerateCredentialParams, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, type HealthStatus, MCPClient, MCPClientRegistry, type MCPConfig, type MCPHealthSummary, type MCPServerConfig, type MCPTool, MCPToolRegistrar, type MCPToolRegistrarOptions, type MCPToolRegistration, type MemoryChangeEvent, MemoryClient, type MemoryConfig, MemoryEventClient, type MemoryEventHandler, MemoryInterface, type MemoryRequestMetadata, type MemoryRequestOptions, type MemoryScope, type MemoryWatchHandler, RateLimitError, type RateLimiterOptions, type ReasonerCapability, ReasonerContext, type ReasonerDefinition, type ReasonerHandler, type ReasonerOptions, type RequestApprovalPayload, type ServerlessAdapter, type ServerlessEvent, type ServerlessResponse, type SkillCapability, SkillContext, type SkillDefinition, type SkillHandler, type SkillOptions, StatelessRateLimiter, TERMINAL_STATUSES, type VectorSearchOptions, type VectorSearchResult, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, getCurrentContext, getCurrentSkillContext, isActive, isTerminal, normalizeStatus };
+export { ACTIVE_STATUSES, AIClient, type AIConfig, type AIEmbeddingOptions, type AIRequestOptions, type AIStream, Agent, type AgentCapability, type AgentConfig, type AgentHandler, AgentRouter, type AgentRouterOptions, type AgentState, ApprovalClient, type ApprovalRequestResponse, type ApprovalStatusResponse, 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 ExecutionMetadata, ExecutionStatus, type ExecutionStatusValue, 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, MCPClient, MCPClientRegistry, type MCPConfig, type MCPHealthSummary, type MCPServerConfig, type MCPTool, MCPToolRegistrar, type MCPToolRegistrarOptions, type MCPToolRegistration, type MemoryChangeEvent, MemoryClient, type MemoryConfig, MemoryEventClient, type MemoryEventHandler, MemoryInterface, type MemoryRequestMetadata, type MemoryRequestOptions, type MemoryScope, type MemoryWatchHandler, type Metrics, RateLimitError, type RateLimiterOptions, 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, type VectorSearchOptions, type VectorSearchResult, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, buildProvider, createHarnessResult, createMetrics, createRawResult, getCurrentContext, getCurrentSkillContext, isActive, isTerminal, normalizeStatus };