@agentfield/sdk 0.1.60 → 0.1.61-rc.1

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import express from 'express';
 import http from 'node:http';
 import * as _ai_sdk_provider from '@ai-sdk/provider';
 import { z } from 'zod';
+import { AxiosInstance } from 'axios';
 import { ToolSet } from 'ai';
 
 type ZodSchema<T> = z.Schema<T, z.ZodTypeDef, any>;
@@ -76,9 +77,18 @@ interface VectorSearchResult {
     score: number;
     metadata?: Record<string, any>;
 }
-declare class MemoryClient {
-    private readonly http;
+declare class MemoryClientBase {
+    protected readonly http: AxiosInstance;
     private readonly defaultHeaders;
+    constructor(baseUrl: string, defaultHeaders?: Record<string, string | number | boolean | undefined>);
+    protected buildHeaders(options?: MemoryRequestOptions): {
+        [x: string]: string;
+    };
+    private scopeToHeader;
+    private resolveScopeId;
+    private sanitizeHeaders;
+}
+declare class MemoryClient extends MemoryClientBase {
     constructor(baseUrl: string, defaultHeaders?: Record<string, string | number | boolean | undefined>);
     set(key: string, data: any, options?: MemoryRequestOptions): Promise<void>;
     get<T = any>(key: string, options?: MemoryRequestOptions): Promise<T | undefined>;
@@ -88,14 +98,15 @@ declare class MemoryClient {
     setVector(key: string, embedding: number[], metadata?: any, options?: MemoryRequestOptions): Promise<void>;
     deleteVector(key: string, options?: MemoryRequestOptions): Promise<void>;
     searchVector(queryEmbedding: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
-    private buildHeaders;
-    private scopeToHeader;
-    private resolveScopeId;
-    private sanitizeHeaders;
 }
 
 type MemoryEventHandler = (event: MemoryChangeEvent) => Promise<void> | void;
-declare class MemoryEventClient {
+interface MemoryEventHistoryOptions extends MemoryRequestOptions {
+    patterns?: string[];
+    since?: Date;
+    limit?: number;
+}
+declare class MemoryEventClient extends MemoryClientBase {
     private readonly url;
     private ws?;
     private handlers;
@@ -104,7 +115,8 @@ declare class MemoryEventClient {
     private reconnectPending;
     private reconnectTimer?;
     private readonly headers;
-    constructor(baseUrl: string, headers?: Record<string, string | number | boolean | undefined>);
+    private readonly apiKey?;
+    constructor(baseUrl: string, headers?: Record<string, string | number | boolean | undefined>, apiKey?: string);
     start(): void;
     onEvent(handler: MemoryEventHandler): void;
     stop(): void;
@@ -112,6 +124,7 @@ declare class MemoryEventClient {
     private connect;
     private scheduleReconnect;
     private buildForwardHeaders;
+    history(options?: MemoryEventHistoryOptions): Promise<MemoryChangeEvent[]>;
 }
 
 interface MemoryChangeEvent {
@@ -1288,4 +1301,4 @@ 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, 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 ToolCallConfig, type ToolCallRecord, type ToolCallTrace, type ToolsOption, type VectorSearchOptions, type VectorSearchResult, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, buildProvider, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createHarnessResult, createMetrics, createRawResult, executeToolCallLoop, getCurrentContext, getCurrentSkillContext, isActive, isTerminal, normalizeStatus };
+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, 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, MemoryClientBase, type MemoryConfig, MemoryEventClient, type MemoryEventHandler, type MemoryEventHistoryOptions, 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 ToolCallConfig, type ToolCallRecord, type ToolCallTrace, type ToolsOption, type VectorSearchOptions, type VectorSearchResult, type WaitForApprovalOptions, type WorkflowCredential, type WorkflowMetadata, type WorkflowProgressOptions, WorkflowReporter, type ZodSchema, buildProvider, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createHarnessResult, createMetrics, createRawResult, executeToolCallLoop, getCurrentContext, getCurrentSkillContext, isActive, isTerminal, normalizeStatus };

package/dist/index.js

@@ -2145,7 +2145,7 @@ var AgentFieldClient = class {
     });
   }
 };
-var MemoryClient = class {
+var MemoryClientBase = class {
   http;
   defaultHeaders;
   constructor(baseUrl, defaultHeaders) {
@@ -2157,6 +2157,67 @@ var MemoryClient = class {
     });
     this.defaultHeaders = this.sanitizeHeaders(defaultHeaders ?? {});
   }
+  buildHeaders(options = {}) {
+    const { scope, scopeId, metadata } = options;
+    const headers = { ...this.defaultHeaders };
+    const workflowId = metadata?.workflowId ?? metadata?.runId;
+    if (workflowId) headers["X-Workflow-ID"] = workflowId;
+    if (metadata?.sessionId) headers["X-Session-ID"] = metadata.sessionId;
+    if (metadata?.actorId) headers["X-Actor-ID"] = metadata.actorId;
+    if (metadata?.runId) headers["X-Run-ID"] = metadata.runId;
+    if (metadata?.executionId) headers["X-Execution-ID"] = metadata.executionId;
+    if (metadata?.parentExecutionId) headers["X-Parent-Execution-ID"] = metadata.parentExecutionId;
+    if (metadata?.callerDid) headers["X-Caller-DID"] = metadata.callerDid;
+    if (metadata?.targetDid) headers["X-Target-DID"] = metadata.targetDid;
+    if (metadata?.agentNodeDid) headers["X-Agent-Node-DID"] = metadata.agentNodeDid;
+    if (metadata?.agentNodeId) headers["X-Agent-Node-ID"] = metadata.agentNodeId;
+    const headerName = this.scopeToHeader(scope);
+    const resolvedScopeId = this.resolveScopeId(scope, scopeId, metadata);
+    if (headerName && resolvedScopeId) {
+      headers[headerName] = resolvedScopeId;
+    }
+    return { ...headers, ...this.sanitizeHeaders(options.headers ?? {}) };
+  }
+  scopeToHeader(scope) {
+    switch (scope) {
+      case "workflow":
+        return "X-Workflow-ID";
+      case "session":
+        return "X-Session-ID";
+      case "actor":
+        return "X-Actor-ID";
+      default:
+        return void 0;
+    }
+  }
+  resolveScopeId(scope, scopeId, metadata) {
+    if (scopeId) return scopeId;
+    switch (scope) {
+      case "workflow":
+        return metadata?.workflowId ?? metadata?.runId;
+      case "session":
+        return metadata?.sessionId;
+      case "actor":
+        return metadata?.actorId;
+      case "global":
+        return "global";
+      default:
+        return void 0;
+    }
+  }
+  sanitizeHeaders(headers) {
+    const sanitized = {};
+    Object.entries(headers).forEach(([key, value]) => {
+      if (value === void 0 || value === null) return;
+      sanitized[key] = typeof value === "string" ? value : String(value);
+    });
+    return sanitized;
+  }
+};
+var MemoryClient = class extends MemoryClientBase {
+  constructor(baseUrl, defaultHeaders) {
+    super(baseUrl, defaultHeaders);
+  }
   async set(key, data, options = {}) {
     const payload = { key, data };
     if (options.scope) payload.scope = options.scope;
@@ -2227,64 +2288,8 @@ var MemoryClient = class {
     });
     return res.data ?? [];
   }
-  buildHeaders(options = {}) {
-    const { scope, scopeId, metadata } = options;
-    const headers = { ...this.defaultHeaders };
-    const workflowId = metadata?.workflowId ?? metadata?.runId;
-    if (workflowId) headers["X-Workflow-ID"] = workflowId;
-    if (metadata?.sessionId) headers["X-Session-ID"] = metadata.sessionId;
-    if (metadata?.actorId) headers["X-Actor-ID"] = metadata.actorId;
-    if (metadata?.runId) headers["X-Run-ID"] = metadata.runId;
-    if (metadata?.executionId) headers["X-Execution-ID"] = metadata.executionId;
-    if (metadata?.parentExecutionId) headers["X-Parent-Execution-ID"] = metadata.parentExecutionId;
-    if (metadata?.callerDid) headers["X-Caller-DID"] = metadata.callerDid;
-    if (metadata?.targetDid) headers["X-Target-DID"] = metadata.targetDid;
-    if (metadata?.agentNodeDid) headers["X-Agent-Node-DID"] = metadata.agentNodeDid;
-    if (metadata?.agentNodeId) headers["X-Agent-Node-ID"] = metadata.agentNodeId;
-    const headerName = this.scopeToHeader(scope);
-    const resolvedScopeId = this.resolveScopeId(scope, scopeId, metadata);
-    if (headerName && resolvedScopeId) {
-      headers[headerName] = resolvedScopeId;
-    }
-    return { ...headers, ...this.sanitizeHeaders(options.headers ?? {}) };
-  }
-  scopeToHeader(scope) {
-    switch (scope) {
-      case "workflow":
-        return "X-Workflow-ID";
-      case "session":
-        return "X-Session-ID";
-      case "actor":
-        return "X-Actor-ID";
-      default:
-        return void 0;
-    }
-  }
-  resolveScopeId(scope, scopeId, metadata) {
-    if (scopeId) return scopeId;
-    switch (scope) {
-      case "workflow":
-        return metadata?.workflowId ?? metadata?.runId;
-      case "session":
-        return metadata?.sessionId;
-      case "actor":
-        return metadata?.actorId;
-      case "global":
-        return "global";
-      default:
-        return void 0;
-    }
-  }
-  sanitizeHeaders(headers) {
-    const sanitized = {};
-    Object.entries(headers).forEach(([key, value]) => {
-      if (value === void 0 || value === null) return;
-      sanitized[key] = typeof value === "string" ? value : String(value);
-    });
-    return sanitized;
-  }
 };
-var MemoryEventClient = class {
+var MemoryEventClient = class extends MemoryClientBase {
   url;
   ws;
   handlers = [];
@@ -2293,9 +2298,12 @@ var MemoryEventClient = class {
   reconnectPending = false;
   reconnectTimer;
   headers;
-  constructor(baseUrl, headers) {
+  apiKey;
+  constructor(baseUrl, headers, apiKey) {
+    super(baseUrl, headers);
     this.url = `${baseUrl.replace(/^http/, "ws")}/api/v1/memory/events/ws`;
     this.headers = this.buildForwardHeaders(headers ?? {});
+    this.apiKey = apiKey;
   }
   start() {
     if (this.ws) return;
@@ -2362,6 +2370,44 @@ var MemoryEventClient = class {
     });
     return sanitized;
   }
+  async history(options = {}) {
+    const {
+      patterns,
+      since,
+      limit = 100,
+      scope,
+      scopeId
+    } = options;
+    try {
+      const headers = this.buildHeaders(options);
+      if (this.apiKey) {
+        headers["X-API-Key"] = this.apiKey;
+      }
+      const params = {
+        limit
+      };
+      if (patterns && patterns.length > 0) {
+        params.patterns = patterns.join(",");
+      }
+      if (since) {
+        params.since = since.toISOString();
+      }
+      if (scope) {
+        params.scope = scope;
+      }
+      if (scopeId) {
+        params.scope_id = scopeId;
+      }
+      const res = await this.http.get("/api/v1/memory/events/history", {
+        params,
+        headers
+      });
+      return res.data ?? [];
+    } catch (e) {
+      console.error(`Failed to get event history: ${e}`);
+      return [];
+    }
+  }
 };
 
 // src/memory/MemoryInterface.ts
@@ -4531,6 +4577,6 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, CANONICAL_STATUSES, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionStatus, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, MCPClient, MCPClientRegistry, MCPToolRegistrar, MemoryClient, MemoryEventClient, MemoryInterface, RateLimitError, ReasonerContext, SUPPORTED_PROVIDERS, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, WorkflowReporter, buildProvider, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createHarnessResult, createMetrics, createRawResult, executeToolCallLoop, getCurrentContext, getCurrentSkillContext, isActive, isTerminal, normalizeStatus };
+export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, CANONICAL_STATUSES, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionStatus, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, MCPClient, MCPClientRegistry, MCPToolRegistrar, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, RateLimitError, ReasonerContext, SUPPORTED_PROVIDERS, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, WorkflowReporter, buildProvider, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createHarnessResult, createMetrics, createRawResult, executeToolCallLoop, getCurrentContext, getCurrentSkillContext, isActive, isTerminal, normalizeStatus };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map