@cuylabs/agent-core 4.9.0 → 4.10.0

package/dist/mcp/index.d.ts

@@ -1,179 +1,18 @@
-import { R as RemoteTransportConfig, e as MCPServerConfig, M as MCPConfig, a as MCPManager, g as StdioTransportConfig } from '../types-DMjoFKKv.js';
-export { H as HttpTransportConfig, b as MCPPromptInfo, c as MCPResourceInfo, d as MCPResourceTemplateInfo, f as MCPServerStatus, S as SseTransportConfig } from '../types-DMjoFKKv.js';
-import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
-import { OAuthClientMetadata, OAuthClientInformation, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
-import '@modelcontextprotocol/sdk/types.js';
-import 'ai';
-
 /**
- * Options for {@linkcode ClientCredentialsProvider}.
- */
-interface ClientCredentialsOptions {
-    /**
-     * OAuth `client_id`.
-     */
-    clientId: string;
-    /**
-     * OAuth `client_secret`.
-     */
-    clientSecret: string;
-    /**
-     * The token endpoint URL.
-     * Required because machine-to-machine flows don't go through OAuth discovery
-     * (there is no user redirect that would trigger `/.well-known` lookups).
-     *
-     * @example "https://auth.example.com/oauth/token"
-     * @example "https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token"
-     */
-    tokenUrl: string;
-    /**
-     * Space-separated OAuth scopes to request.
-     */
-    scope?: string;
-    /**
-     * Seconds before token expiry at which a proactive refresh is triggered.
-     * @default 60
-     */
-    expiryBufferSeconds?: number;
-    /**
-     * Fetch implementation for the token endpoint.
-     * Defaults to `globalThis.fetch`.
-     */
-    fetch?: typeof fetch;
-    /**
-     * Abort the token fetch if no response is received before this many
-     * milliseconds.
-     */
-    timeoutMs?: number;
-    /**
-     * Human-readable operation label used in token-fetch diagnostics.
-     * @default "ClientCredentialsProvider"
-     */
-    diagnosticsLabel?: string;
-    /**
-     * Extra values to redact from diagnostic text. `clientId` and `clientSecret`
-     * are always redacted automatically.
-     */
-    redactValues?: string[];
-}
-/**
- * OAuth `client_credentials` provider for machine-to-machine MCP authentication.
- *
- * Implements {@linkcode OAuthClientProvider} from the official MCP TypeScript
- * SDK so it can be passed directly to `httpServer()` / `sseServer()` as
- * `authProvider`.
- *
- * Unlike user-interactive OAuth flows, this provider proactively fetches a
- * bearer token via the `client_credentials` grant before any request is made,
- * so the MCP transport's `Authorization` header is always populated.
- * Token expiry is tracked and a new token is fetched automatically before the
- * old one expires (controlled by {@linkcode ClientCredentialsOptions.expiryBufferSeconds}).
- *
- * @example
- * ```ts
- * import { serviceAccountServer } from "@cuylabs/agent-core/mcp";
- *
- * const mcpManager = createMCPManager({
- *   myServer: serviceAccountServer("https://my-mcp.example.com", {
- *     clientId: "my-service-account",
- *     clientSecret: process.env.CLIENT_SECRET!,
- *     tokenUrl: "https://auth.example.com/oauth/token",
- *     scope: "mcp:read",
- *   }),
- * });
- * ```
- *
- * @example Static API key (no OAuth needed — use headers instead)
- * ```ts
- * httpServer("https://my-mcp.example.com", {
- *   headers: { Authorization: `Bearer ${process.env.API_KEY}` },
- * });
- * ```
- */
-declare class ClientCredentialsProvider implements OAuthClientProvider {
-    private _tokens?;
-    private _expiresAt?;
-    private readonly _options;
-    private readonly _tokenFetch;
-    private readonly _redactValues;
-    constructor(options: ClientCredentialsOptions);
-    get redirectUrl(): undefined;
-    get clientMetadata(): OAuthClientMetadata;
-    clientInformation(): OAuthClientInformation;
-    saveClientInformation(): void;
-    tokens(): Promise<OAuthTokens | undefined>;
-    saveTokens(tokens: OAuthTokens): Promise<void>;
-    redirectToAuthorization(_authorizationUrl: URL): never;
-    saveCodeVerifier(): void;
-    codeVerifier(): never;
-    prepareTokenRequest(scope?: string): URLSearchParams;
-    addClientAuthentication(headers: Headers): void;
-    invalidateCredentials(scope: "all" | "client" | "tokens" | "verifier"): void;
-    private _fetchTokens;
-}
-
-type ServiceAccountServerOptions = Omit<RemoteTransportConfig, "transport" | "url" | "authProvider"> & Pick<MCPServerConfig, "capabilities" | "enabled" | "name" | "onUncaughtError" | "timeout">;
-type ServiceAccountServerConfig = RemoteTransportConfig & Pick<MCPServerConfig, "capabilities" | "enabled" | "name" | "onUncaughtError" | "timeout">;
-/**
- * Create an MCP manager for connecting to multiple MCP servers.
- */
-declare function createMCPManager(config: MCPConfig): MCPManager;
-/**
- * Helper to create a stdio server config.
- */
-declare function stdioServer(command: string, args?: string[], options?: Omit<StdioTransportConfig, "transport" | "command" | "args">): StdioTransportConfig;
-/**
- * Helper to create an HTTP server config.
- */
-declare function httpServer(url: string, options?: Omit<RemoteTransportConfig, "transport" | "url">): RemoteTransportConfig;
-/**
- * Helper to create an SSE server config.
- */
-declare function sseServer(url: string, options?: Omit<RemoteTransportConfig, "transport" | "url">): RemoteTransportConfig;
-/**
- * Helper to create an HTTP server config authenticated with the OAuth
- * `client_credentials` grant (machine-to-machine / service account).
+ * MCP Module
  *
- * This uses agent-core's convenience `ClientCredentialsProvider`, which
- * proactively fetches a bearer token from an explicit token endpoint before
- * the first request. The official MCP SDK transport still owns the underlying
- * auth orchestration and transport behavior.
+ * Model Context Protocol integration lives in three layers:
+ * - `types` defines the stable contracts shared with the rest of agent-core
+ * - `manager` owns connection lifecycle and tool aggregation
+ * - `factories` provides the public helpers most consumers actually use
  *
- * @example
- * ```ts
- * createMCPManager({
- *   myServer: serviceAccountServer(
- *     "https://my-mcp.example.com",
- *     {
- *       clientId: "svc-account-id",
- *       clientSecret: process.env.CLIENT_SECRET!,
- *       tokenUrl: "https://auth.example.com/oauth/token",
- *       scope: "mcp:read",
- *     }
- *   ),
- * });
- * ```
+ * Import from `@cuylabs/agent-core/mcp` when you want MCP-specific APIs
+ * without pulling in the full root surface.
  */
-declare function serviceAccountServer(url: string, credentials: ClientCredentialsOptions, options?: ServiceAccountServerOptions): ServiceAccountServerConfig;
-
-interface DiagnosticFetchOptions {
-    /**
-     * Base fetch implementation. Defaults to `globalThis.fetch`.
-     */
-    fetch?: typeof fetch;
-    /**
-     * Human-readable operation label used in wrapped network errors.
-     */
-    label?: string;
-    /**
-     * Abort the fetch if no response is received before this many milliseconds.
-     */
-    timeoutMs?: number;
-    /**
-     * Values to redact from diagnostic text.
-     */
-    redactValues?: string[];
-}
-declare function createDiagnosticFetch(options?: DiagnosticFetchOptions): typeof fetch;
-
-export { type ClientCredentialsOptions, ClientCredentialsProvider, type DiagnosticFetchOptions, MCPConfig, MCPManager, MCPServerConfig, RemoteTransportConfig, type ServiceAccountServerConfig, type ServiceAccountServerOptions, StdioTransportConfig, createDiagnosticFetch, createMCPManager, httpServer, serviceAccountServer, sseServer, stdioServer };
+export type { HttpTransportConfig, MCPConfig, MCPManager, MCPPromptInfo, MCPResourceInfo, MCPResourceTemplateInfo, MCPServerConfig, MCPServerStatus, RemoteTransportConfig, SseTransportConfig, StdioTransportConfig, } from "./types.js";
+export { createMCPManager, httpServer, serviceAccountServer, sseServer, stdioServer, } from "./factories.js";
+export type { ClientCredentialsOptions, ServiceAccountServerConfig, ServiceAccountServerOptions, } from "./factories.js";
+export { ClientCredentialsProvider } from "./auth.js";
+export type { DiagnosticFetchOptions } from "./diagnostics.js";
+export { createDiagnosticFetch } from "./diagnostics.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,oBAAoB,EACpB,SAAS,EACT,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mcp/index.js

@@ -6,7 +6,7 @@ import {
   serviceAccountServer,
   sseServer,
   stdioServer
-} from "../chunk-UMIVJDEJ.js";
+} from "../chunk-SAWRDGBE.js";
 import "../chunk-S6AKEPAX.js";
 export {
   ClientCredentialsProvider,

package/dist/mcp/manager.d.ts

@@ -0,0 +1,45 @@
+import { type Tool as AITool } from "ai";
+import type { GetPromptResult, ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import type { MCPConfig, MCPManager, MCPPromptInfo, MCPResourceInfo, MCPResourceTemplateInfo, MCPServerStatus } from "./types.js";
+import type { Logger } from "../logger/types.js";
+/**
+ * Default MCP manager implementation.
+ *
+ * Uses the official MCP TypeScript SDK as the source of truth for transports,
+ * auth, prompts, resources, and tool calls, then adapts MCP tools into AI SDK
+ * dynamic tools for model execution.
+ */
+export declare class DefaultMCPManager implements MCPManager {
+    private readonly config;
+    private readonly connections;
+    private readonly log;
+    private toolCache;
+    private resourceCache;
+    private resourceTemplateCache;
+    private promptCache;
+    constructor(config: MCPConfig, logger?: Logger);
+    connect(): Promise<Map<string, MCPServerStatus>>;
+    getTools(): Promise<Record<string, AITool>>;
+    listResources(): Promise<MCPResourceInfo[]>;
+    listResourceTemplates(): Promise<MCPResourceTemplateInfo[]>;
+    readResource(serverName: string, uri: string): Promise<ReadResourceResult>;
+    listPrompts(): Promise<MCPPromptInfo[]>;
+    getPrompt(serverName: string, name: string, args?: Record<string, string>): Promise<GetPromptResult>;
+    getStatus(serverName: string): MCPServerStatus;
+    getAllStatus(): Map<string, MCPServerStatus>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+    private invalidateCaches;
+    private ensureInitialized;
+    private requestOptions;
+    private collectAcrossServers;
+    private getConnectedConnection;
+    private collectPaginated;
+    private listAllTools;
+    private listAllResources;
+    private listAllResourceTemplates;
+    private listAllPrompts;
+    private createClient;
+    private createTransport;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/mcp/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/mcp/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,IAAI,IAAI,MAAM,EACpB,MAAM,IAAI,CAAC;AACZ,OAAO,KAAK,EAEV,eAAe,EAKf,kBAAkB,EAInB,MAAM,oCAAoC,CAAC;AAQ5C,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,eAAe,EACf,uBAAuB,EAEvB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA8EjD;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,qBAAqB,CAAwC;IACrE,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;IAKxC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAqDhD,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyC3C,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAoB3C,qBAAqB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAoB3D,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,CAAC;IAQxB,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAiBvC,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC;IAQ3B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAK9C,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAQtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,WAAW,IAAI,OAAO;IAUtB,OAAO,CAAC,gBAAgB;YAOV,iBAAiB;IAM/B,OAAO,CAAC,cAAc;YAIR,oBAAoB;YAqCpB,sBAAsB;YAuBtB,gBAAgB;IAmB9B,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,cAAc;YAcR,YAAY;YA2CZ,eAAe;CAiC9B"}

package/dist/mcp/modules.d.ts

@@ -0,0 +1,6 @@
+export type MCPClient = import("@modelcontextprotocol/sdk/client/index.js").Client;
+export declare function getMcpClientModule(): Promise<typeof import("@modelcontextprotocol/sdk/client")>;
+export declare function getStdioClientModule(): Promise<typeof import("@modelcontextprotocol/sdk/client/stdio.js")>;
+export declare function getStreamableHttpClientModule(): Promise<typeof import("@modelcontextprotocol/sdk/client/streamableHttp.js")>;
+export declare function getSseClientModule(): Promise<typeof import("@modelcontextprotocol/sdk/client/sse.js")>;
+//# sourceMappingURL=modules.d.ts.map

package/dist/mcp/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/mcp/modules.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,SAAS,GACnB,OAAO,2CAA2C,EAAE,MAAM,CAAC;AAE7D,wBAAsB,kBAAkB,+DAavC;AAED,wBAAsB,oBAAoB,wEAYzC;AAED,wBAAsB,6BAA6B,iFAalD;AAED,wBAAsB,kBAAkB,sEAYvC"}

package/dist/{types-DMjoFKKv.d.ts → mcp/types.d.ts}

@@ -1,17 +1,17 @@
-import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
-import { Resource, ResourceTemplate, ReadResourceResult, Prompt, GetPromptResult, ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
-import { Tool } from 'ai';
-
+import type { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
+import type { ClientCapabilities, GetPromptResult, Prompt, ReadResourceResult, Resource, ResourceTemplate } from "@modelcontextprotocol/sdk/types.js";
+import type { Tool as AITool } from "ai";
 /**
  * MCP (Model Context Protocol) types for @cuylabs/agent-core.
  *
  * Keep these contracts separate from the manager implementation so the shared
  * type layer does not depend on connection logic or optional SDK imports.
  */
+export type MCPFetch = typeof fetch;
 /**
  * Stdio transport configuration for local MCP servers.
  */
-interface StdioTransportConfig {
+export interface StdioTransportConfig {
     transport: "stdio";
     /** Command to execute */
     command: string;
@@ -28,7 +28,7 @@ interface StdioTransportConfig {
  * Supports the official MCP TypeScript SDK client transport options so that
  * agents can leverage OAuth, custom fetch, and redirect control.
  */
-interface RemoteTransportConfig {
+export interface RemoteTransportConfig {
     transport: "http" | "sse";
     /** Server URL */
     url: string;
@@ -59,24 +59,24 @@ interface RemoteTransportConfig {
      * Custom fetch implementation (useful for runtimes with
      * request-scoped fetch or test doubles).
      */
-    fetch?: any;
+    fetch?: MCPFetch;
 }
 /**
  * @deprecated Use `RemoteTransportConfig` with `transport: "http"`.
  */
-type HttpTransportConfig = RemoteTransportConfig & {
+export type HttpTransportConfig = RemoteTransportConfig & {
     transport: "http";
 };
 /**
  * @deprecated Use `RemoteTransportConfig` with `transport: "sse"`.
  */
-type SseTransportConfig = RemoteTransportConfig & {
+export type SseTransportConfig = RemoteTransportConfig & {
     transport: "sse";
 };
 /**
  * MCP server configuration.
  */
-type MCPServerConfig = (StdioTransportConfig | RemoteTransportConfig) & {
+export type MCPServerConfig = (StdioTransportConfig | RemoteTransportConfig) & {
     /** Whether this server is enabled (default: true) */
     enabled?: boolean;
     /** Connection timeout in ms (default: 30000) */
@@ -96,11 +96,11 @@ type MCPServerConfig = (StdioTransportConfig | RemoteTransportConfig) & {
 /**
  * MCP manager configuration - map of server name to config.
  */
-type MCPConfig = Record<string, MCPServerConfig>;
+export type MCPConfig = Record<string, MCPServerConfig>;
 /**
  * Server connection status.
  */
-type MCPServerStatus = {
+export type MCPServerStatus = {
     status: "disconnected";
 } | {
     status: "connecting";
@@ -116,25 +116,25 @@ type MCPServerStatus = {
 /**
  * Aggregated resource metadata with the originating server name attached.
  */
-interface MCPResourceInfo extends Resource {
+export interface MCPResourceInfo extends Resource {
     server: string;
 }
 /**
  * Aggregated resource template metadata with the originating server name attached.
  */
-interface MCPResourceTemplateInfo extends ResourceTemplate {
+export interface MCPResourceTemplateInfo extends ResourceTemplate {
     server: string;
 }
 /**
  * Aggregated prompt metadata with the originating server name attached.
  */
-interface MCPPromptInfo extends Prompt {
+export interface MCPPromptInfo extends Prompt {
     server: string;
 }
 /**
  * MCP manager - handles connections to multiple MCP servers.
  */
-interface MCPManager {
+export interface MCPManager {
     /**
      * Connect to all configured servers.
      */
@@ -142,7 +142,7 @@ interface MCPManager {
     /**
      * Get all tools from connected servers, ready for AI SDK use.
      */
-    getTools(): Promise<Record<string, Tool>>;
+    getTools(): Promise<Record<string, AITool>>;
     /**
      * List resources from all connected servers.
      */
@@ -180,5 +180,4 @@ interface MCPManager {
      */
     isConnected(): boolean;
 }
-
-export type { HttpTransportConfig as H, MCPConfig as M, RemoteTransportConfig as R, SseTransportConfig as S, MCPManager as a, MCPPromptInfo as b, MCPResourceInfo as c, MCPResourceTemplateInfo as d, MCPServerConfig as e, MCPServerStatus as f, StdioTransportConfig as g };
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"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"}

package/dist/memory/config.d.ts

@@ -0,0 +1,4 @@
+import type { AgentMemoryInput, AgentMemoryTurnConfig, ResolvedAgentMemoryConfig } from "./types.js";
+export declare function resolveAgentMemoryConfig(input: AgentMemoryInput | undefined): ResolvedAgentMemoryConfig | undefined;
+export declare function resolveAgentMemoryTurnConfig(input: boolean | AgentMemoryTurnConfig | undefined): Required<AgentMemoryTurnConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/memory/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAMpB,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,yBAAyB,GAAG,SAAS,CA4BvC;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,GACjD,QAAQ,CAAC,qBAAqB,CAAC,CAQjC"}

package/dist/memory/format.d.ts

@@ -0,0 +1,8 @@
+import type { AgentMemoryRecallResponse, AgentMemoryRecord, AgentMemorySearchResult } from "./types.js";
+export declare function normalizeMemoryRecords(result: AgentMemoryRecallResponse | AgentMemorySearchResult): AgentMemoryRecord[];
+export declare function formatMemoryContextFragment(options: {
+    records: readonly AgentMemoryRecord[];
+    instructions?: string;
+    maxRecordChars: number;
+}): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/memory/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/memory/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,yBAAyB,GAAG,uBAAuB,GAC1D,iBAAiB,EAAE,CAIrB;AAkBD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAiBT"}

package/dist/memory/index.d.ts

@@ -0,0 +1,5 @@
+export { resolveAgentMemoryConfig, resolveAgentMemoryTurnConfig, } from "./config.js";
+export { formatMemoryContextFragment, normalizeMemoryRecords, } from "./format.js";
+export { createMemoryMiddleware, type MemoryMiddlewareOptions, } from "./middleware.js";
+export type { AgentMemoryCompactionInput, AgentMemoryCompactionResult, AgentMemoryConfig, AgentMemoryForgetInput, AgentMemoryForgetResult, AgentMemoryGetToolsInput, AgentMemoryInput, AgentMemoryListInput, AgentMemoryProvider, AgentMemoryRecallConfig, AgentMemoryRecallInput, AgentMemoryRecallResponse, AgentMemoryRecallResult, AgentMemoryRecord, AgentMemoryRememberInput, AgentMemoryScope, AgentMemorySearchInput, AgentMemorySearchResult, AgentMemoryTurnEndInput, AgentMemoryTurnConfig, AgentMemoryToolsConfig, AgentMemoryTurnStartInput, AgentMemoryWriteResult, ResolvedAgentMemoryConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,14 @@
+import {
+  createMemoryMiddleware,
+  formatMemoryContextFragment,
+  normalizeMemoryRecords,
+  resolveAgentMemoryConfig,
+  resolveAgentMemoryTurnConfig
+} from "../chunk-EEAGM5MS.js";
+export {
+  createMemoryMiddleware,
+  formatMemoryContextFragment,
+  normalizeMemoryRecords,
+  resolveAgentMemoryConfig,
+  resolveAgentMemoryTurnConfig
+};

package/dist/memory/middleware.d.ts

@@ -0,0 +1,14 @@
+import type { AgentMiddleware } from "../middleware/types.js";
+import type { AgentMemoryProvider, AgentMemoryRecallConfig, AgentMemoryRecallFrequency, AgentMemoryTurnConfig } from "./types.js";
+type ResolvedMemoryMiddlewareRecallConfig = Required<Omit<AgentMemoryRecallConfig, "frequency">> & {
+    frequency?: AgentMemoryRecallFrequency;
+};
+export interface MemoryMiddlewareOptions {
+    provider: AgentMemoryProvider;
+    recall: ResolvedMemoryMiddlewareRecallConfig;
+    turns?: boolean | AgentMemoryTurnConfig;
+    cwd?: string;
+}
+export declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): AgentMiddleware;
+export {};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/memory/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/memory/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,wBAAwB,CAAC;AAO/E,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAE1B,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,KAAK,oCAAoC,GAAG,QAAQ,CAClD,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAC3C,GAAG;IACF,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,oCAAoC,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgHD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,eAAe,CAyHjB"}