@agentfield/sdk 0.1.20-rc.2 → 0.1.20

package/dist/index.d.ts

@@ -246,6 +246,37 @@ declare class ExecutionContext {
     static getCurrent(): ExecutionContext | undefined;
 }
 
+interface DIDIdentity {
+    did: string;
+    privateKeyJwk: string;
+    publicKeyJwk: string;
+    derivationPath: string;
+    componentType: string;
+    functionName?: string;
+}
+interface DIDIdentityPackage {
+    agentDid: DIDIdentity;
+    reasonerDids: Record<string, DIDIdentity>;
+    skillDids: Record<string, DIDIdentity>;
+    agentfieldServerId: string;
+}
+interface DIDRegistrationRequest {
+    agentNodeId: string;
+    reasoners: Array<{
+        id: string;
+        [key: string]: any;
+    }>;
+    skills: Array<{
+        id: string;
+        [key: string]: any;
+    }>;
+}
+interface DIDRegistrationResponse {
+    success: boolean;
+    identityPackage?: DIDIdentityPackage;
+    message?: string;
+    error?: string;
+}
 interface ExecutionCredential {
     vcId: string;
     executionId: string;
@@ -317,6 +348,12 @@ declare class DidClient {
     private readonly http;
     private readonly defaultHeaders;
     constructor(baseUrl: string, defaultHeaders?: Record<string, string | number | boolean | undefined>);
+    /**
+     * Register an agent with the DID system and obtain an identity package.
+     * This must be called before generating VCs to get the caller/target DIDs.
+     */
+    registerAgent(request: DIDRegistrationRequest): Promise<DIDRegistrationResponse>;
+    private parseIdentityPackage;
     generateCredential(params: GenerateCredentialParams): Promise<ExecutionCredential>;
     exportAuditTrail(filters?: AuditTrailFilters): Promise<AuditTrailExport>;
     private serializeDataForJson;
@@ -696,6 +733,7 @@ declare class Agent {
     private readonly memoryClient;
     private readonly memoryEventClient;
     private readonly didClient;
+    private readonly didManager;
     private readonly memoryWatchers;
     private readonly mcpClientRegistry?;
     private readonly mcpToolRegistrar?;
@@ -715,7 +753,7 @@ declare class Agent {
     getAIClient(): AIClient;
     getMemoryInterface(metadata?: ExecutionMetadata): MemoryInterface;
     getWorkflowReporter(metadata: ExecutionMetadata): WorkflowReporter;
-    getDidInterface(metadata: ExecutionMetadata, defaultInput?: any): DidInterface;
+    getDidInterface(metadata: ExecutionMetadata, defaultInput?: any, targetName?: string): DidInterface;
     serve(): Promise<void>;
     shutdown(): Promise<void>;
     call(target: string, input: any): Promise<any>;
@@ -748,6 +786,60 @@ declare class Agent {
     private parseTarget;
 }
 
+/**
+ * Manages DID registration and identity package storage for an agent.
+ *
+ * This class handles:
+ * - Registering the agent with the DID system
+ * - Storing the identity package (agent DID, reasoner DIDs, skill DIDs)
+ * - Resolving DIDs for specific functions (reasoners/skills)
+ */
+declare class DidManager {
+    private readonly client;
+    private readonly agentNodeId;
+    private identityPackage?;
+    private _enabled;
+    constructor(client: DidClient, agentNodeId: string);
+    /**
+     * Register agent with the DID system and obtain identity package.
+     *
+     * @param reasoners - List of reasoner definitions
+     * @param skills - List of skill definitions
+     * @returns true if registration succeeded
+     */
+    registerAgent(reasoners: Array<{
+        id: string;
+        [key: string]: any;
+    }>, skills: Array<{
+        id: string;
+        [key: string]: any;
+    }>): Promise<boolean>;
+    /**
+     * Check if DID system is enabled and identity package is available.
+     */
+    get enabled(): boolean;
+    /**
+     * Get the agent node DID.
+     */
+    getAgentDid(): string | undefined;
+    /**
+     * Get DID for a specific function (reasoner or skill).
+     * Falls back to agent DID if function not found.
+     *
+     * @param functionName - Name of the reasoner or skill
+     * @returns DID string or undefined if not registered
+     */
+    getFunctionDid(functionName: string): string | undefined;
+    /**
+     * Get the full identity package (for debugging/inspection).
+     */
+    getIdentityPackage(): DIDIdentityPackage | undefined;
+    /**
+     * Get a summary of the identity for debugging/monitoring.
+     */
+    getIdentitySummary(): Record<string, any>;
+}
+
 declare class MCPClient {
     readonly alias: string;
     readonly baseUrl: string;
@@ -835,4 +927,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 DeploymentType, DidClient, DidInterface, 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 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, 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 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 };

package/dist/index.js

@@ -1183,6 +1183,60 @@ var DidClient = class {
     this.http = axios.create({ baseURL: baseUrl.replace(/\/$/, "") });
     this.defaultHeaders = this.sanitizeHeaders(defaultHeaders ?? {});
   }
+  /**
+   * Register an agent with the DID system and obtain an identity package.
+   * This must be called before generating VCs to get the caller/target DIDs.
+   */
+  async registerAgent(request) {
+    const payload = {
+      agent_node_id: request.agentNodeId,
+      reasoners: request.reasoners,
+      skills: request.skills
+    };
+    const res = await this.http.post("/api/v1/did/register", payload, {
+      headers: this.mergeHeaders()
+    });
+    const data = res.data ?? {};
+    if (!data.success) {
+      return {
+        success: false,
+        error: data.error ?? "DID registration failed"
+      };
+    }
+    return {
+      success: true,
+      identityPackage: this.parseIdentityPackage(data.identity_package),
+      message: data.message
+    };
+  }
+  parseIdentityPackage(pkg) {
+    const parseIdentity = (data) => ({
+      did: data?.did ?? "",
+      privateKeyJwk: data?.private_key_jwk ?? "",
+      publicKeyJwk: data?.public_key_jwk ?? "",
+      derivationPath: data?.derivation_path ?? "",
+      componentType: data?.component_type ?? "",
+      functionName: data?.function_name
+    });
+    const reasonerDids = {};
+    if (pkg?.reasoner_dids) {
+      for (const [name, data] of Object.entries(pkg.reasoner_dids)) {
+        reasonerDids[name] = parseIdentity(data);
+      }
+    }
+    const skillDids = {};
+    if (pkg?.skill_dids) {
+      for (const [name, data] of Object.entries(pkg.skill_dids)) {
+        skillDids[name] = parseIdentity(data);
+      }
+    }
+    return {
+      agentDid: parseIdentity(pkg?.agent_did),
+      reasonerDids,
+      skillDids,
+      agentfieldServerId: pkg?.agentfield_server_id ?? ""
+    };
+  }
   async generateCredential(params) {
     const ctx = params.executionContext;
     const timestamp = ctx.timestamp instanceof Date ? ctx.timestamp.toISOString() : ctx.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
@@ -1344,6 +1398,100 @@ var DidInterface = class {
   }
 };
 
+// src/did/DidManager.ts
+var DidManager = class {
+  client;
+  agentNodeId;
+  identityPackage;
+  _enabled = false;
+  constructor(client, agentNodeId) {
+    this.client = client;
+    this.agentNodeId = agentNodeId;
+  }
+  /**
+   * Register agent with the DID system and obtain identity package.
+   *
+   * @param reasoners - List of reasoner definitions
+   * @param skills - List of skill definitions
+   * @returns true if registration succeeded
+   */
+  async registerAgent(reasoners, skills) {
+    const request = {
+      agentNodeId: this.agentNodeId,
+      reasoners,
+      skills
+    };
+    const response = await this.client.registerAgent(request);
+    if (response.success && response.identityPackage) {
+      this.identityPackage = response.identityPackage;
+      this._enabled = true;
+      return true;
+    }
+    console.warn(`[DID] Registration failed: ${response.error ?? "Unknown error"}`);
+    return false;
+  }
+  /**
+   * Check if DID system is enabled and identity package is available.
+   */
+  get enabled() {
+    return this._enabled && this.identityPackage !== void 0;
+  }
+  /**
+   * Get the agent node DID.
+   */
+  getAgentDid() {
+    return this.identityPackage?.agentDid.did;
+  }
+  /**
+   * Get DID for a specific function (reasoner or skill).
+   * Falls back to agent DID if function not found.
+   *
+   * @param functionName - Name of the reasoner or skill
+   * @returns DID string or undefined if not registered
+   */
+  getFunctionDid(functionName) {
+    if (!this.identityPackage) {
+      return void 0;
+    }
+    const reasonerDid = this.identityPackage.reasonerDids[functionName];
+    if (reasonerDid) {
+      return reasonerDid.did;
+    }
+    const skillDid = this.identityPackage.skillDids[functionName];
+    if (skillDid) {
+      return skillDid.did;
+    }
+    return this.identityPackage.agentDid.did;
+  }
+  /**
+   * Get the full identity package (for debugging/inspection).
+   */
+  getIdentityPackage() {
+    return this.identityPackage;
+  }
+  /**
+   * Get a summary of the identity for debugging/monitoring.
+   */
+  getIdentitySummary() {
+    if (!this.identityPackage) {
+      return { enabled: false, message: "No identity package available" };
+    }
+    return {
+      enabled: true,
+      agentDid: this.identityPackage.agentDid.did,
+      agentfieldServerId: this.identityPackage.agentfieldServerId,
+      reasonerCount: Object.keys(this.identityPackage.reasonerDids).length,
+      skillCount: Object.keys(this.identityPackage.skillDids).length,
+      reasonerDids: Object.fromEntries(
+        Object.entries(this.identityPackage.reasonerDids).map(([name, identity]) => [name, identity.did])
+      ),
+      skillDids: Object.fromEntries(
+        Object.entries(this.identityPackage.skillDids).map(([name, identity]) => [name, identity.did])
+      )
+    };
+  }
+};
+
 // src/utils/pattern.ts
 function matchesPattern(pattern, value) {
   const escaped = pattern.replace(/[-/\\^$+?.()|[\]{}]/g, "\\$&").replace(/\*/g, ".*");
@@ -1614,6 +1762,7 @@ var Agent = class {
   memoryClient;
   memoryEventClient;
   didClient;
+  didManager;
   memoryWatchers = [];
   mcpClientRegistry;
   mcpToolRegistrar;
@@ -1638,6 +1787,7 @@ var Agent = class {
     this.memoryClient = new MemoryClient(this.config.agentFieldUrl, this.config.defaultHeaders);
     this.memoryEventClient = new MemoryEventClient(this.config.agentFieldUrl, this.config.defaultHeaders);
     this.didClient = new DidClient(this.config.agentFieldUrl, this.config.defaultHeaders);
+    this.didManager = new DidManager(this.didClient, this.config.nodeId);
     this.memoryEventClient.onEvent((event) => this.dispatchMemoryEvent(event));
     if (this.config.mcp?.servers?.length) {
       this.mcpClientRegistry = new MCPClientRegistry(this.config.devMode);
@@ -1718,12 +1868,17 @@ var Agent = class {
       agentNodeId: this.config.nodeId
     });
   }
-  getDidInterface(metadata, defaultInput) {
+  getDidInterface(metadata, defaultInput, targetName) {
+    const agentNodeDid = metadata.agentNodeDid ?? this.didManager.getAgentDid() ?? this.config.defaultHeaders?.["X-Agent-Node-DID"]?.toString();
+    const callerDid = metadata.callerDid ?? this.didManager.getAgentDid();
+    const targetDid = metadata.targetDid ?? (targetName ? this.didManager.getFunctionDid(targetName) : void 0) ?? this.didManager.getAgentDid();
     return new DidInterface({
       client: this.didClient,
       metadata: {
         ...metadata,
-        agentNodeDid: metadata.agentNodeDid ?? this.config.defaultHeaders?.["X-Agent-Node-DID"]?.toString()
+        agentNodeDid,
+        callerDid,
+        targetDid
       },
       enabled: Boolean(this.config.didEnabled),
       defaultInput
@@ -1825,7 +1980,7 @@ var Agent = class {
               aiClient: this.aiClient,
               memory: this.getMemoryInterface(execCtx.metadata),
               workflow: this.getWorkflowReporter(execCtx.metadata),
-              did: this.getDidInterface(execCtx.metadata, input)
+              did: this.getDidInterface(execCtx.metadata, input, name)
             })
           );
           await emitEvent("succeeded", result);
@@ -2221,7 +2376,7 @@ var Agent = class {
           aiClient: this.aiClient,
           memory: this.getMemoryInterface(params.metadata),
           workflow: this.getWorkflowReporter(params.metadata),
-          did: this.getDidInterface(params.metadata, params.input)
+          did: this.getDidInterface(params.metadata, params.input, params.targetName)
         });
         const result = await reasoner.handler(ctx);
         if (params.respond && params.res) {
@@ -2260,7 +2415,7 @@ var Agent = class {
           agent: this,
           memory: this.getMemoryInterface(params.metadata),
           workflow: this.getWorkflowReporter(params.metadata),
-          did: this.getDidInterface(params.metadata, params.input)
+          did: this.getDidInterface(params.metadata, params.input, params.targetName)
         });
         const result = await skill.handler(ctx);
         if (params.respond && params.res) {
@@ -2293,6 +2448,20 @@ var Agent = class {
         reasoners,
         skills
       });
+      if (this.config.didEnabled) {
+        try {
+          const didRegistered = await this.didManager.registerAgent(reasoners, skills);
+          if (didRegistered) {
+            const summary = this.didManager.getIdentitySummary();
+            console.log(`[DID] Agent registered with DID: ${summary.agentDid}`);
+            console.log(`[DID] Reasoner DIDs: ${summary.reasonerCount}, Skill DIDs: ${summary.skillCount}`);
+          }
+        } catch (didErr) {
+          if (!this.config.devMode) {
+            console.warn("[DID] DID registration failed:", didErr);
+          }
+        }
+      }
     } catch (err) {
       if (!this.config.devMode) {
         throw err;
@@ -2378,6 +2547,6 @@ function sanitize(value) {
   return value.replace(/[^0-9a-zA-Z]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
 }
 
-export { AIClient, Agent, AgentRouter, DidClient, DidInterface, ExecutionContext, MCPClient, MCPClientRegistry, MCPToolRegistrar, MemoryClient, MemoryEventClient, MemoryInterface, RateLimitError, ReasonerContext, SkillContext, StatelessRateLimiter, WorkflowReporter, getCurrentContext, getCurrentSkillContext };
+export { AIClient, Agent, AgentRouter, DidClient, DidInterface, DidManager, ExecutionContext, MCPClient, MCPClientRegistry, MCPToolRegistrar, MemoryClient, MemoryEventClient, MemoryInterface, RateLimitError, ReasonerContext, SkillContext, StatelessRateLimiter, WorkflowReporter, getCurrentContext, getCurrentSkillContext };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map