@agentfield/sdk 0.1.42 → 0.1.43

package/dist/index.d.ts

@@ -165,8 +165,10 @@ declare class AgentFieldClient {
     private readonly http;
     private readonly config;
     private readonly defaultHeaders;
+    private didAuthenticator;
     constructor(config: AgentConfig);
-    register(payload: any): Promise<void>;
+    register(payload: any): Promise<any>;
+    getNode(nodeId: string): Promise<any>;
     heartbeat(status?: 'starting' | 'ready' | 'degraded' | 'offline'): Promise<HealthStatus>;
     execute<T = any>(target: string, input: any, metadata?: {
         runId?: string;
@@ -200,6 +202,9 @@ declare class AgentFieldClient {
     private sanitizeHeaders;
     private mergeHeaders;
     private buildExecutionHeaders;
+    setDIDCredentials(did: string, privateKeyJwk: string): void;
+    get didAuthConfigured(): boolean;
+    getDID(): string | undefined;
     sendNote(message: string, tags: string[], agentNodeId: string, metadata: {
         runId?: string;
         executionId?: string;
@@ -263,7 +268,7 @@ declare class ExecutionContext {
 
 interface DIDIdentity {
     did: string;
-    privateKeyJwk: string;
+    privateKeyJwk?: string;
     publicKeyJwk: string;
     derivationPath: string;
     componentType: string;
@@ -469,6 +474,8 @@ interface ReasonerOptions {
     outputSchema?: any;
     trackWorkflow?: boolean;
     memoryConfig?: any;
+    /** Force control-plane verification instead of local verification for this reasoner. */
+    requireRealtimeValidation?: boolean;
 }
 
 declare class SkillContext<TInput = any> {
@@ -513,6 +520,8 @@ interface SkillOptions {
     description?: string;
     inputSchema?: any;
     outputSchema?: any;
+    /** Force control-plane verification instead of local verification for this skill. */
+    requireRealtimeValidation?: boolean;
 }
 
 type DeploymentType = 'long_running' | 'serverless';
@@ -531,8 +540,16 @@ interface AgentConfig {
     heartbeatIntervalMs?: number;
     defaultHeaders?: Record<string, string | number | boolean | undefined>;
     apiKey?: string;
+    did?: string;
+    privateKeyJwk?: string;
     mcp?: MCPConfig;
     deploymentType?: DeploymentType;
+    /** Enable decentralized local verification of incoming DID signatures. */
+    localVerification?: boolean;
+    /** Cache refresh interval for local verification in seconds (default: 300). */
+    verificationRefreshInterval?: number;
+    /** Agent-level tags for tag-based authorization policies. */
+    tags?: string[];
 }
 interface AIConfig {
     provider?: 'openai' | 'anthropic' | 'google' | 'mistral' | 'groq' | 'xai' | 'deepseek' | 'cohere' | 'openrouter' | 'ollama';
@@ -754,6 +771,8 @@ declare class Agent {
     private readonly memoryWatchers;
     private readonly mcpClientRegistry?;
     private readonly mcpToolRegistrar?;
+    private readonly localVerifier?;
+    private readonly realtimeValidationFunctions;
     constructor(config: AgentConfig);
     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;
@@ -797,6 +816,7 @@ declare class Agent {
     private runReasoner;
     private runSkill;
     private registerWithControlPlane;
+    private waitForApproval;
     private startHeartbeat;
     private health;
     private mcpStatus;
@@ -804,6 +824,20 @@ declare class Agent {
     private parseTarget;
 }
 
+declare const HEADER_CALLER_DID = "X-Caller-DID";
+declare const HEADER_DID_SIGNATURE = "X-DID-Signature";
+declare const HEADER_DID_TIMESTAMP = "X-DID-Timestamp";
+declare const HEADER_DID_NONCE = "X-DID-Nonce";
+declare class DIDAuthenticator {
+    private _did?;
+    private _privateKey?;
+    constructor(did?: string, privateKeyJwk?: string);
+    get isConfigured(): boolean;
+    get did(): string | undefined;
+    signRequest(body: Buffer | Uint8Array): Record<string, string>;
+    setCredentials(did: string, privateKeyJwk: string): void;
+}
+
 /**
  * Manages DID registration and identity package storage for an agent.
  *
@@ -946,4 +980,4 @@ declare class StatelessRateLimiter {
     executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
 }
 
-export { AIClient, type AIConfig, type AIEmbeddingOptions, type AIRequestOptions, type AIStream, Agent, type AgentCapability, type AgentConfig, type AgentHandler, AgentRouter, type AgentRouterOptions, type AgentState, type AuditTrailExport, type AuditTrailFilters, type Awaitable, type CompactCapability, type CompactDiscoveryResponse, 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, type GenerateCredentialOptions, type GenerateCredentialParams, 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 ServerlessAdapter, type ServerlessEvent, type ServerlessResponse, type SkillCapability, SkillContext, type SkillDefinition, type SkillHandler, type SkillOptions, StatelessRateLimiter, type VectorSearchOptions, type VectorSearchResult, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, getCurrentContext, getCurrentSkillContext };
+export { AIClient, type AIConfig, type AIEmbeddingOptions, type AIRequestOptions, type AIStream, Agent, type AgentCapability, type AgentConfig, type AgentHandler, AgentRouter, type AgentRouterOptions, type AgentState, type AuditTrailExport, type AuditTrailFilters, type Awaitable, 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, 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 ServerlessAdapter, type ServerlessEvent, type ServerlessResponse, type SkillCapability, SkillContext, type SkillDefinition, type SkillHandler, type SkillOptions, StatelessRateLimiter, type VectorSearchOptions, type VectorSearchResult, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, getCurrentContext, getCurrentSkillContext };