@contractspec/lib.ai-agent 1.44.0

package/dist/approval/workflow.d.ts

@@ -0,0 +1,156 @@
+import { ToolCallInfo } from "../types.js";
+
+//#region src/approval/workflow.d.ts
+type ApprovalStatus = 'pending' | 'approved' | 'rejected';
+/**
+ * Approval request for a tool execution.
+ *
+ * When a tool has `needsApproval: true` in AI SDK v6, the agent
+ * will pause and wait for approval before executing the tool.
+ */
+interface ApprovalRequest {
+  /** Unique request ID */
+  id: string;
+  /** Agent session ID */
+  sessionId: string;
+  /** Agent ID */
+  agentId: string;
+  /** Tenant ID for scoping */
+  tenantId?: string;
+  /** Tool name requiring approval */
+  toolName: string;
+  /** Tool call ID from AI SDK */
+  toolCallId: string;
+  /** Tool arguments */
+  toolArgs: unknown;
+  /** Human-readable reason for approval */
+  reason: string;
+  /** When the approval was requested */
+  requestedAt: Date;
+  /** Current status */
+  status: ApprovalStatus;
+  /** Additional context payload */
+  payload?: Record<string, unknown>;
+  /** Who resolved the approval */
+  reviewer?: string;
+  /** When the approval was resolved */
+  resolvedAt?: Date;
+  /** Reviewer notes */
+  notes?: string;
+}
+/**
+ * Storage interface for approval requests.
+ */
+interface ApprovalStore {
+  create(request: ApprovalRequest): Promise<void>;
+  get(id: string): Promise<ApprovalRequest | null>;
+  getByToolCallId(toolCallId: string): Promise<ApprovalRequest | null>;
+  update(id: string, updates: Partial<Omit<ApprovalRequest, 'id' | 'sessionId'>>): Promise<void>;
+  list(options?: {
+    status?: ApprovalStatus;
+    agentId?: string;
+    tenantId?: string;
+  }): Promise<ApprovalRequest[]>;
+}
+/**
+ * In-memory approval store for development and testing.
+ */
+declare class InMemoryApprovalStore implements ApprovalStore {
+  private readonly items;
+  create(request: ApprovalRequest): Promise<void>;
+  get(id: string): Promise<ApprovalRequest | null>;
+  getByToolCallId(toolCallId: string): Promise<ApprovalRequest | null>;
+  update(id: string, updates: Partial<Omit<ApprovalRequest, 'id' | 'sessionId'>>): Promise<void>;
+  list(options?: {
+    status?: ApprovalStatus;
+    agentId?: string;
+    tenantId?: string;
+  }): Promise<ApprovalRequest[]>;
+  clear(): void;
+}
+/**
+ * Approval workflow for managing tool execution approvals.
+ *
+ * Integrates with AI SDK v6's `needsApproval` feature on tools.
+ *
+ * @example
+ * ```typescript
+ * const workflow = new ApprovalWorkflow();
+ *
+ * // When a tool needs approval
+ * const request = await workflow.requestApproval({
+ *   sessionId: 'sess_123',
+ *   agentId: 'support.bot.v1',
+ *   toolName: 'delete_account',
+ *   toolCallId: 'call_abc',
+ *   toolArgs: { userId: 'user_123' },
+ *   reason: 'Account deletion requires human approval',
+ * });
+ *
+ * // When approval is granted
+ * await workflow.approve(request.id, 'admin@example.com', 'Verified identity');
+ *
+ * // Or rejected
+ * await workflow.reject(request.id, 'admin@example.com', 'Suspicious activity');
+ * ```
+ */
+declare class ApprovalWorkflow {
+  private readonly store;
+  constructor(store?: ApprovalStore);
+  /**
+   * Request approval for a tool execution.
+   */
+  requestApproval(params: {
+    sessionId: string;
+    agentId: string;
+    tenantId?: string;
+    toolName: string;
+    toolCallId: string;
+    toolArgs: unknown;
+    reason: string;
+    payload?: Record<string, unknown>;
+  }): Promise<ApprovalRequest>;
+  /**
+   * Request approval from an AI SDK tool call.
+   */
+  requestApprovalFromToolCall(toolCall: ToolCallInfo, context: {
+    sessionId: string;
+    agentId: string;
+    tenantId?: string;
+    reason?: string;
+  }): Promise<ApprovalRequest>;
+  /**
+   * Approve a pending request.
+   */
+  approve(id: string, reviewer: string, notes?: string): Promise<void>;
+  /**
+   * Reject a pending request.
+   */
+  reject(id: string, reviewer: string, notes?: string): Promise<void>;
+  /**
+   * Get approval status for a tool call.
+   */
+  getStatus(toolCallId: string): Promise<ApprovalStatus | null>;
+  /**
+   * Check if a tool call is approved.
+   */
+  isApproved(toolCallId: string): Promise<boolean>;
+  /**
+   * List pending approvals.
+   */
+  listPending(options?: {
+    agentId?: string;
+    tenantId?: string;
+  }): Promise<ApprovalRequest[]>;
+  /**
+   * Get approval request by ID.
+   */
+  get(id: string): Promise<ApprovalRequest | null>;
+}
+/**
+ * Create an approval workflow instance.
+ */
+declare function createApprovalWorkflow(store?: ApprovalStore): ApprovalWorkflow;
+//#endregion
+export { ApprovalRequest, ApprovalStatus, ApprovalStore, ApprovalWorkflow, InMemoryApprovalStore, createApprovalWorkflow };
+//# sourceMappingURL=workflow.d.ts.map

package/dist/approval/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","names":[],"sources":["../../src/approval/workflow.ts"],"sourcesContent":[],"mappings":";;;KAGY,cAAA;;AAAZ;AAQA;;;;AA0Be,UA1BE,eAAA,CA0BF;EAAI;EAQF,EAAA,EAAA,MAAA;EACC;EAAkB,SAAA,EAAA,MAAA;EACT;EAAR,OAAA,EAAA,MAAA;EAC4B;EAAR,QAAA,CAAA,EAAA,MAAA;EAGb;EAAL,QAAA,EAAA,MAAA;EAAR;EACR,UAAA,EAAA,MAAA;EAEQ;EAGC,QAAA,EAAA,OAAA;EAAR;EAAO,MAAA,EAAA,MAAA;EAMA;EAGW,WAAA,EArCT,IAqCS;EAAkB;EAIT,MAAA,EAvCvB,cAuCuB;EAAR;EAI4B,OAAA,CAAA,EAzCzC,MAyCyC,CAAA,MAAA,EAAA,OAAA,CAAA;EAAR;EAWnB,QAAA,CAAA,EAAA,MAAA;EAAL;EAAR,UAAA,CAAA,EAhDE,IAgDF;EACR;EAQQ,KAAA,CAAA,EAAA,MAAA;;;;;AAoDA,UArGI,aAAA,CAqGY;EAED,MAAA,CAAA,OAAA,EAtGV,eAsGU,CAAA,EAtGQ,OAsGR,CAAA,IAAA,CAAA;EAcd,GAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAnHK,OAmHL,CAnHa,eAmHb,GAAA,IAAA,CAAA;EACA,eAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAnHyB,OAmHzB,CAnHiC,eAmHjC,GAAA,IAAA,CAAA;EAAR,MAAA,CAAA,EAAA,EAAA,MAAA,EAAA,OAAA,EAhHO,OAgHP,CAhHe,IAgHf,CAhHoB,eAgHpB,EAAA,IAAA,GAAA,WAAA,CAAA,CAAA,CAAA,EA/GD,OA+GC,CAAA,IAAA,CAAA;EAuBQ,IAAA,CAAA,OAkCgD,CAlChD,EAAA;IAOD,MAAA,CAAA,EA3IA,cA2IA;IAAR,OAAA,CAAA,EAAA,MAAA;IAe0D,QAAA,CAAA,EAAA,MAAA;EAYD,CAAA,CAAA,EAnKxD,OAmKwD,CAnKhD,eAmKgD,EAAA,CAAA;;;;;AA+BxD,cA5LO,qBAAA,YAAiC,aA4LxC,CAAA;EAO2B,iBAAA,KAAA;EAAR,MAAA,CAAA,OAAA,EAhMD,eAgMC,CAAA,EAhMiB,OAgMjB,CAAA,IAAA,CAAA;EAAO,GAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EA5LP,OA4LO,CA5LC,eA4LD,GAAA,IAAA,CAAA;EAQhB,eAAA,CAAA,UAAsB,EAAA,MAAA,CAAA,EAhMO,OAiMnC,CAjM2C,eAkMlD,GAAA,IAAA,CAAA;8BAvLU,QAAQ,KAAK,wCACrB;;aAQQ;;;MAGP,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiDD,gBAAA;;sBAEe;;;;;;;;;;;;cAcd;MACR,QAAQ;;;;wCAuBA;;;;;MAOT,QAAQ;;;;yDAekD;;;;wDAYD;;;;iCAYvB,QAAQ;;;;kCAQP;;;;;;;MAWlC,QAAQ;;;;mBAOW,QAAQ;;;;;iBAQjB,sBAAA,SACN,gBACP"}

package/dist/approval/workflow.js

@@ -0,0 +1,160 @@
+import { randomUUID } from "node:crypto";
+
+//#region src/approval/workflow.ts
+/**
+* In-memory approval store for development and testing.
+*/
+var InMemoryApprovalStore = class {
+	items = /* @__PURE__ */ new Map();
+	async create(request) {
+		this.items.set(request.id, request);
+	}
+	async get(id) {
+		return this.items.get(id) ?? null;
+	}
+	async getByToolCallId(toolCallId) {
+		for (const request of this.items.values()) if (request.toolCallId === toolCallId) return request;
+		return null;
+	}
+	async update(id, updates) {
+		const existing = this.items.get(id);
+		if (existing) this.items.set(id, {
+			...existing,
+			...updates
+		});
+	}
+	async list(options) {
+		let results = [...this.items.values()];
+		if (options?.status) results = results.filter((r) => r.status === options.status);
+		if (options?.agentId) results = results.filter((r) => r.agentId === options.agentId);
+		if (options?.tenantId) results = results.filter((r) => r.tenantId === options.tenantId);
+		return results.sort((a, b) => b.requestedAt.getTime() - a.requestedAt.getTime());
+	}
+	clear() {
+		this.items.clear();
+	}
+};
+/**
+* Approval workflow for managing tool execution approvals.
+*
+* Integrates with AI SDK v6's `needsApproval` feature on tools.
+*
+* @example
+* ```typescript
+* const workflow = new ApprovalWorkflow();
+*
+* // When a tool needs approval
+* const request = await workflow.requestApproval({
+*   sessionId: 'sess_123',
+*   agentId: 'support.bot.v1',
+*   toolName: 'delete_account',
+*   toolCallId: 'call_abc',
+*   toolArgs: { userId: 'user_123' },
+*   reason: 'Account deletion requires human approval',
+* });
+*
+* // When approval is granted
+* await workflow.approve(request.id, 'admin@example.com', 'Verified identity');
+*
+* // Or rejected
+* await workflow.reject(request.id, 'admin@example.com', 'Suspicious activity');
+* ```
+*/
+var ApprovalWorkflow = class {
+	constructor(store = new InMemoryApprovalStore()) {
+		this.store = store;
+	}
+	/**
+	* Request approval for a tool execution.
+	*/
+	async requestApproval(params) {
+		const request = {
+			id: randomUUID(),
+			sessionId: params.sessionId,
+			agentId: params.agentId,
+			tenantId: params.tenantId,
+			toolName: params.toolName,
+			toolCallId: params.toolCallId,
+			toolArgs: params.toolArgs,
+			reason: params.reason,
+			requestedAt: /* @__PURE__ */ new Date(),
+			status: "pending",
+			payload: params.payload
+		};
+		await this.store.create(request);
+		return request;
+	}
+	/**
+	* Request approval from an AI SDK tool call.
+	*/
+	async requestApprovalFromToolCall(toolCall, context) {
+		return this.requestApproval({
+			sessionId: context.sessionId,
+			agentId: context.agentId,
+			tenantId: context.tenantId,
+			toolName: toolCall.toolName,
+			toolCallId: toolCall.toolCallId,
+			toolArgs: toolCall.args,
+			reason: context.reason ?? `Tool "${toolCall.toolName}" requires approval`
+		});
+	}
+	/**
+	* Approve a pending request.
+	*/
+	async approve(id, reviewer, notes) {
+		await this.store.update(id, {
+			status: "approved",
+			reviewer,
+			resolvedAt: /* @__PURE__ */ new Date(),
+			notes
+		});
+	}
+	/**
+	* Reject a pending request.
+	*/
+	async reject(id, reviewer, notes) {
+		await this.store.update(id, {
+			status: "rejected",
+			reviewer,
+			resolvedAt: /* @__PURE__ */ new Date(),
+			notes
+		});
+	}
+	/**
+	* Get approval status for a tool call.
+	*/
+	async getStatus(toolCallId) {
+		return (await this.store.getByToolCallId(toolCallId))?.status ?? null;
+	}
+	/**
+	* Check if a tool call is approved.
+	*/
+	async isApproved(toolCallId) {
+		return await this.getStatus(toolCallId) === "approved";
+	}
+	/**
+	* List pending approvals.
+	*/
+	async listPending(options) {
+		return this.store.list({
+			...options,
+			status: "pending"
+		});
+	}
+	/**
+	* Get approval request by ID.
+	*/
+	async get(id) {
+		return this.store.get(id);
+	}
+};
+/**
+* Create an approval workflow instance.
+*/
+function createApprovalWorkflow(store) {
+	return new ApprovalWorkflow(store);
+}
+
+//#endregion
+export { ApprovalWorkflow, InMemoryApprovalStore, createApprovalWorkflow };
+//# sourceMappingURL=workflow.js.map

package/dist/approval/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","names":["store: ApprovalStore","request: ApprovalRequest"],"sources":["../../src/approval/workflow.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { ToolCallInfo } from '../types';\n\nexport type ApprovalStatus = 'pending' | 'approved' | 'rejected';\n\n/**\n * Approval request for a tool execution.\n *\n * When a tool has `needsApproval: true` in AI SDK v6, the agent\n * will pause and wait for approval before executing the tool.\n */\nexport interface ApprovalRequest {\n  /** Unique request ID */\n  id: string;\n  /** Agent session ID */\n  sessionId: string;\n  /** Agent ID */\n  agentId: string;\n  /** Tenant ID for scoping */\n  tenantId?: string;\n  /** Tool name requiring approval */\n  toolName: string;\n  /** Tool call ID from AI SDK */\n  toolCallId: string;\n  /** Tool arguments */\n  toolArgs: unknown;\n  /** Human-readable reason for approval */\n  reason: string;\n  /** When the approval was requested */\n  requestedAt: Date;\n  /** Current status */\n  status: ApprovalStatus;\n  /** Additional context payload */\n  payload?: Record<string, unknown>;\n  /** Who resolved the approval */\n  reviewer?: string;\n  /** When the approval was resolved */\n  resolvedAt?: Date;\n  /** Reviewer notes */\n  notes?: string;\n}\n\n/**\n * Storage interface for approval requests.\n */\nexport interface ApprovalStore {\n  create(request: ApprovalRequest): Promise<void>;\n  get(id: string): Promise<ApprovalRequest | null>;\n  getByToolCallId(toolCallId: string): Promise<ApprovalRequest | null>;\n  update(\n    id: string,\n    updates: Partial<Omit<ApprovalRequest, 'id' | 'sessionId'>>\n  ): Promise<void>;\n  list(options?: {\n    status?: ApprovalStatus;\n    agentId?: string;\n    tenantId?: string;\n  }): Promise<ApprovalRequest[]>;\n}\n\n/**\n * In-memory approval store for development and testing.\n */\nexport class InMemoryApprovalStore implements ApprovalStore {\n  private readonly items = new Map<string, ApprovalRequest>();\n\n  async create(request: ApprovalRequest): Promise<void> {\n    this.items.set(request.id, request);\n  }\n\n  async get(id: string): Promise<ApprovalRequest | null> {\n    return this.items.get(id) ?? null;\n  }\n\n  async getByToolCallId(toolCallId: string): Promise<ApprovalRequest | null> {\n    for (const request of this.items.values()) {\n      if (request.toolCallId === toolCallId) {\n        return request;\n      }\n    }\n    return null;\n  }\n\n  async update(\n    id: string,\n    updates: Partial<Omit<ApprovalRequest, 'id' | 'sessionId'>>\n  ): Promise<void> {\n    const existing = this.items.get(id);\n    if (existing) {\n      this.items.set(id, { ...existing, ...updates });\n    }\n  }\n\n  async list(options?: {\n    status?: ApprovalStatus;\n    agentId?: string;\n    tenantId?: string;\n  }): Promise<ApprovalRequest[]> {\n    let results = [...this.items.values()];\n\n    if (options?.status) {\n      results = results.filter((r) => r.status === options.status);\n    }\n    if (options?.agentId) {\n      results = results.filter((r) => r.agentId === options.agentId);\n    }\n    if (options?.tenantId) {\n      results = results.filter((r) => r.tenantId === options.tenantId);\n    }\n\n    return results.sort(\n      (a, b) => b.requestedAt.getTime() - a.requestedAt.getTime()\n    );\n  }\n\n  clear(): void {\n    this.items.clear();\n  }\n}\n\n/**\n * Approval workflow for managing tool execution approvals.\n *\n * Integrates with AI SDK v6's `needsApproval` feature on tools.\n *\n * @example\n * ```typescript\n * const workflow = new ApprovalWorkflow();\n *\n * // When a tool needs approval\n * const request = await workflow.requestApproval({\n *   sessionId: 'sess_123',\n *   agentId: 'support.bot.v1',\n *   toolName: 'delete_account',\n *   toolCallId: 'call_abc',\n *   toolArgs: { userId: 'user_123' },\n *   reason: 'Account deletion requires human approval',\n * });\n *\n * // When approval is granted\n * await workflow.approve(request.id, 'admin@example.com', 'Verified identity');\n *\n * // Or rejected\n * await workflow.reject(request.id, 'admin@example.com', 'Suspicious activity');\n * ```\n */\nexport class ApprovalWorkflow {\n  constructor(\n    private readonly store: ApprovalStore = new InMemoryApprovalStore()\n  ) {}\n\n  /**\n   * Request approval for a tool execution.\n   */\n  async requestApproval(params: {\n    sessionId: string;\n    agentId: string;\n    tenantId?: string;\n    toolName: string;\n    toolCallId: string;\n    toolArgs: unknown;\n    reason: string;\n    payload?: Record<string, unknown>;\n  }): Promise<ApprovalRequest> {\n    const request: ApprovalRequest = {\n      id: randomUUID(),\n      sessionId: params.sessionId,\n      agentId: params.agentId,\n      tenantId: params.tenantId,\n      toolName: params.toolName,\n      toolCallId: params.toolCallId,\n      toolArgs: params.toolArgs,\n      reason: params.reason,\n      requestedAt: new Date(),\n      status: 'pending',\n      payload: params.payload,\n    };\n\n    await this.store.create(request);\n    return request;\n  }\n\n  /**\n   * Request approval from an AI SDK tool call.\n   */\n  async requestApprovalFromToolCall(\n    toolCall: ToolCallInfo,\n    context: {\n      sessionId: string;\n      agentId: string;\n      tenantId?: string;\n      reason?: string;\n    }\n  ): Promise<ApprovalRequest> {\n    return this.requestApproval({\n      sessionId: context.sessionId,\n      agentId: context.agentId,\n      tenantId: context.tenantId,\n      toolName: toolCall.toolName,\n      toolCallId: toolCall.toolCallId,\n      toolArgs: toolCall.args,\n      reason: context.reason ?? `Tool \"${toolCall.toolName}\" requires approval`,\n    });\n  }\n\n  /**\n   * Approve a pending request.\n   */\n  async approve(id: string, reviewer: string, notes?: string): Promise<void> {\n    await this.store.update(id, {\n      status: 'approved',\n      reviewer,\n      resolvedAt: new Date(),\n      notes,\n    });\n  }\n\n  /**\n   * Reject a pending request.\n   */\n  async reject(id: string, reviewer: string, notes?: string): Promise<void> {\n    await this.store.update(id, {\n      status: 'rejected',\n      reviewer,\n      resolvedAt: new Date(),\n      notes,\n    });\n  }\n\n  /**\n   * Get approval status for a tool call.\n   */\n  async getStatus(toolCallId: string): Promise<ApprovalStatus | null> {\n    const request = await this.store.getByToolCallId(toolCallId);\n    return request?.status ?? null;\n  }\n\n  /**\n   * Check if a tool call is approved.\n   */\n  async isApproved(toolCallId: string): Promise<boolean> {\n    const status = await this.getStatus(toolCallId);\n    return status === 'approved';\n  }\n\n  /**\n   * List pending approvals.\n   */\n  async listPending(options?: {\n    agentId?: string;\n    tenantId?: string;\n  }): Promise<ApprovalRequest[]> {\n    return this.store.list({ ...options, status: 'pending' });\n  }\n\n  /**\n   * Get approval request by ID.\n   */\n  async get(id: string): Promise<ApprovalRequest | null> {\n    return this.store.get(id);\n  }\n}\n\n/**\n * Create an approval workflow instance.\n */\nexport function createApprovalWorkflow(\n  store?: ApprovalStore\n): ApprovalWorkflow {\n  return new ApprovalWorkflow(store);\n}\n"],"mappings":";;;;;;AA+DA,IAAa,wBAAb,MAA4D;CAC1D,AAAiB,wBAAQ,IAAI,KAA8B;CAE3D,MAAM,OAAO,SAAyC;AACpD,OAAK,MAAM,IAAI,QAAQ,IAAI,QAAQ;;CAGrC,MAAM,IAAI,IAA6C;AACrD,SAAO,KAAK,MAAM,IAAI,GAAG,IAAI;;CAG/B,MAAM,gBAAgB,YAAqD;AACzE,OAAK,MAAM,WAAW,KAAK,MAAM,QAAQ,CACvC,KAAI,QAAQ,eAAe,WACzB,QAAO;AAGX,SAAO;;CAGT,MAAM,OACJ,IACA,SACe;EACf,MAAM,WAAW,KAAK,MAAM,IAAI,GAAG;AACnC,MAAI,SACF,MAAK,MAAM,IAAI,IAAI;GAAE,GAAG;GAAU,GAAG;GAAS,CAAC;;CAInD,MAAM,KAAK,SAIoB;EAC7B,IAAI,UAAU,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC;AAEtC,MAAI,SAAS,OACX,WAAU,QAAQ,QAAQ,MAAM,EAAE,WAAW,QAAQ,OAAO;AAE9D,MAAI,SAAS,QACX,WAAU,QAAQ,QAAQ,MAAM,EAAE,YAAY,QAAQ,QAAQ;AAEhE,MAAI,SAAS,SACX,WAAU,QAAQ,QAAQ,MAAM,EAAE,aAAa,QAAQ,SAAS;AAGlE,SAAO,QAAQ,MACZ,GAAG,MAAM,EAAE,YAAY,SAAS,GAAG,EAAE,YAAY,SAAS,CAC5D;;CAGH,QAAc;AACZ,OAAK,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BtB,IAAa,mBAAb,MAA8B;CAC5B,YACE,AAAiBA,QAAuB,IAAI,uBAAuB,EACnE;EADiB;;;;;CAMnB,MAAM,gBAAgB,QASO;EAC3B,MAAMC,UAA2B;GAC/B,IAAI,YAAY;GAChB,WAAW,OAAO;GAClB,SAAS,OAAO;GAChB,UAAU,OAAO;GACjB,UAAU,OAAO;GACjB,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,QAAQ,OAAO;GACf,6BAAa,IAAI,MAAM;GACvB,QAAQ;GACR,SAAS,OAAO;GACjB;AAED,QAAM,KAAK,MAAM,OAAO,QAAQ;AAChC,SAAO;;;;;CAMT,MAAM,4BACJ,UACA,SAM0B;AAC1B,SAAO,KAAK,gBAAgB;GAC1B,WAAW,QAAQ;GACnB,SAAS,QAAQ;GACjB,UAAU,QAAQ;GAClB,UAAU,SAAS;GACnB,YAAY,SAAS;GACrB,UAAU,SAAS;GACnB,QAAQ,QAAQ,UAAU,SAAS,SAAS,SAAS;GACtD,CAAC;;;;;CAMJ,MAAM,QAAQ,IAAY,UAAkB,OAA+B;AACzE,QAAM,KAAK,MAAM,OAAO,IAAI;GAC1B,QAAQ;GACR;GACA,4BAAY,IAAI,MAAM;GACtB;GACD,CAAC;;;;;CAMJ,MAAM,OAAO,IAAY,UAAkB,OAA+B;AACxE,QAAM,KAAK,MAAM,OAAO,IAAI;GAC1B,QAAQ;GACR;GACA,4BAAY,IAAI,MAAM;GACtB;GACD,CAAC;;;;;CAMJ,MAAM,UAAU,YAAoD;AAElE,UADgB,MAAM,KAAK,MAAM,gBAAgB,WAAW,GAC5C,UAAU;;;;;CAM5B,MAAM,WAAW,YAAsC;AAErD,SADe,MAAM,KAAK,UAAU,WAAW,KAC7B;;;;;CAMpB,MAAM,YAAY,SAGa;AAC7B,SAAO,KAAK,MAAM,KAAK;GAAE,GAAG;GAAS,QAAQ;GAAW,CAAC;;;;;CAM3D,MAAM,IAAI,IAA6C;AACrD,SAAO,KAAK,MAAM,IAAI,GAAG;;;;;;AAO7B,SAAgB,uBACd,OACkB;AAClB,QAAO,IAAI,iBAAiB,MAAM"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig, agentKey, defineAgent } from "./spec/spec.js";
+import { AgentRegistry, createAgentRegistry } from "./spec/registry.js";
+import { AgentCallOptions, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentFinishReason, AgentGenerateParams, AgentGenerateResult, AgentMessage, AgentSessionState, AgentStatus, AgentStepMetrics, AgentStreamParams, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolResultInfo } from "./types.js";
+import { AgentSessionStore, InMemorySessionStore, createInMemorySessionStore, generateSessionId } from "./session/store.js";
+import { InMemoryTelemetryCollector, OperationMetricSample, TelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep } from "./telemetry/adapter.js";
+import { ContractSpecAgent, ContractSpecAgentConfig } from "./agent/contract-spec-agent.js";
+import { AgentFactory, AgentFactoryConfig, CreateAgentOptions, createAgentFactory } from "./agent/agent-factory.js";
+import "./agent/index.js";
+import { ApprovalRequest, ApprovalStatus, ApprovalStore, ApprovalWorkflow, InMemoryApprovalStore, createApprovalWorkflow } from "./approval/workflow.js";
+import "./approval/index.js";
+import { buildToolHandlers, createToolHandler, specToolToAISDKTool, specToolsToAISDKTools } from "./tools/tool-adapter.js";
+import { createKnowledgeQueryTool } from "./tools/knowledge-tool.js";
+import { McpClientConfig, McpClientResult, createMcpToolsets, mcpServerToTools } from "./tools/mcp-client.js";
+import { AgentMcpServerConfig, agentToMcpServer, createAgentMcpServer } from "./tools/mcp-server.js";
+import "./tools/index.js";
+import { jsonSchemaToZod, jsonSchemaToZodSafe } from "./schema/json-schema-to-zod.js";
+import { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, textOutput, zodToOutput } from "./schema/schema-output.js";
+import "./schema/index.js";
+import { createKnowledgeInjector, injectStaticKnowledge } from "./knowledge/injector.js";
+import "./session/index.js";
+import "./telemetry/index.js";
+import { Experimental_Agent as ToolLoopAgent, LanguageModel, LanguageModelUsage, ModelMessage, StepResult, Tool, ToolSet } from "ai";
+export { AgentCallOptions, AgentConfidencePolicy, AgentEscalationPolicy, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentFactory, AgentFactoryConfig, AgentFinishReason, AgentGenerateParams, AgentGenerateResult, AgentKnowledgeRef, AgentMcpServerConfig, AgentMemoryConfig, AgentMessage, AgentMeta, AgentPolicy, AgentRegistry, AgentSessionState, AgentSessionStore, AgentSpec, AgentStatus, AgentStepMetrics, AgentStreamParams, AgentToolConfig, ApprovalRequest, ApprovalStatus, ApprovalStore, ApprovalWorkflow, ContractSpecAgent, ContractSpecAgentConfig, CreateAgentOptions, InMemoryApprovalStore, InMemorySessionStore, InMemoryTelemetryCollector, type LanguageModel, type LanguageModelUsage, McpClientConfig, McpClientResult, type ModelMessage, OperationMetricSample, SchemaOutput, type StepResult, TelemetryCollector, type Tool, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolLoopAgent, ToolResultInfo, type ToolSet, agentKey, agentToMcpServer, buildToolHandlers, createAgentFactory, createAgentMcpServer, createAgentRegistry, createApprovalWorkflow, createInMemorySessionStore, createInMemoryTelemetryCollector, createKnowledgeInjector, createKnowledgeQueryTool, createMcpToolsets, createToolHandler, defineAgent, enumToChoiceOutput, generateSessionId, injectStaticKnowledge, jsonSchemaToArrayOutput, jsonSchemaToOutput, jsonSchemaToZod, jsonSchemaToZodSafe, mcpServerToTools, noopTelemetryCollector, specToolToAISDKTool, specToolsToAISDKTools, textOutput, trackAgentStep, zodToOutput };

package/dist/index.js

@@ -0,0 +1,21 @@
+import { agentKey, defineAgent } from "./spec/spec.js";
+import { jsonSchemaToZod, jsonSchemaToZodSafe } from "./schema/json-schema-to-zod.js";
+import { buildToolHandlers, createToolHandler, specToolToAISDKTool, specToolsToAISDKTools } from "./tools/tool-adapter.js";
+import { createKnowledgeQueryTool } from "./tools/knowledge-tool.js";
+import { createKnowledgeInjector, injectStaticKnowledge } from "./knowledge/injector.js";
+import { InMemorySessionStore, createInMemorySessionStore, generateSessionId } from "./session/store.js";
+import { InMemoryTelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep } from "./telemetry/adapter.js";
+import { ContractSpecAgent } from "./agent/contract-spec-agent.js";
+import { AgentFactory, createAgentFactory } from "./agent/agent-factory.js";
+import "./agent/index.js";
+import { AgentRegistry, createAgentRegistry } from "./spec/registry.js";
+import { createMcpToolsets, mcpServerToTools } from "./tools/mcp-client.js";
+import { agentToMcpServer, createAgentMcpServer } from "./tools/mcp-server.js";
+import "./tools/index.js";
+import { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, textOutput, zodToOutput } from "./schema/schema-output.js";
+import "./schema/index.js";
+import { ApprovalWorkflow, InMemoryApprovalStore, createApprovalWorkflow } from "./approval/workflow.js";
+import "./approval/index.js";
+import { Experimental_Agent as ToolLoopAgent } from "ai";
+
+export { AgentFactory, AgentRegistry, ApprovalWorkflow, ContractSpecAgent, InMemoryApprovalStore, InMemorySessionStore, InMemoryTelemetryCollector, SchemaOutput, ToolLoopAgent, agentKey, agentToMcpServer, buildToolHandlers, createAgentFactory, createAgentMcpServer, createAgentRegistry, createApprovalWorkflow, createInMemorySessionStore, createInMemoryTelemetryCollector, createKnowledgeInjector, createKnowledgeQueryTool, createMcpToolsets, createToolHandler, defineAgent, enumToChoiceOutput, generateSessionId, injectStaticKnowledge, jsonSchemaToArrayOutput, jsonSchemaToOutput, jsonSchemaToZod, jsonSchemaToZodSafe, mcpServerToTools, noopTelemetryCollector, specToolToAISDKTool, specToolsToAISDKTools, textOutput, trackAgentStep, zodToOutput };

package/dist/knowledge/index.d.ts

@@ -0,0 +1,2 @@
+import { createKnowledgeInjector, injectStaticKnowledge } from "./injector.js";
+export { createKnowledgeInjector, injectStaticKnowledge };

package/dist/knowledge/index.js

@@ -0,0 +1,3 @@
+import { createKnowledgeInjector, injectStaticKnowledge } from "./injector.js";
+
+export { createKnowledgeInjector, injectStaticKnowledge };

package/dist/knowledge/injector.d.ts

@@ -0,0 +1,38 @@
+import { AgentKnowledgeRef } from "../spec/spec.js";
+import { KnowledgeRetriever } from "@contractspec/lib.knowledge/retriever";
+
+//#region src/knowledge/injector.d.ts
+
+/**
+ * Inject static knowledge into agent instructions.
+ *
+ * This function handles the "required" knowledge that should be
+ * injected into the system prompt at agent initialization time.
+ * Optional knowledge is handled by the knowledge query tool.
+ *
+ * @param instructions - Base agent instructions
+ * @param knowledgeRefs - Knowledge references from the agent spec
+ * @param retriever - Optional knowledge retriever
+ * @returns Instructions with injected knowledge
+ */
+declare function injectStaticKnowledge(instructions: string, knowledgeRefs: AgentKnowledgeRef[], retriever?: KnowledgeRetriever): Promise<string>;
+/**
+ * Create a knowledge injector instance for reuse.
+ */
+declare function createKnowledgeInjector(retriever?: KnowledgeRetriever): {
+  /**
+   * Inject static knowledge into instructions.
+   */
+  inject: (instructions: string, knowledgeRefs: AgentKnowledgeRef[]) => Promise<string>;
+  /**
+   * Check if a knowledge space is available.
+   */
+  hasSpace: (spaceKey: string) => boolean;
+  /**
+   * List available knowledge spaces.
+   */
+  listSpaces: () => string[];
+};
+//#endregion
+export { createKnowledgeInjector, injectStaticKnowledge };
+//# sourceMappingURL=injector.d.ts.map

package/dist/knowledge/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","names":[],"sources":["../../src/knowledge/injector.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;AA+CA;;;;;iBA/CsB,qBAAA,sCAEL,iCACH,qBACX;;;;iBA2Ca,uBAAA,aAAoC;;;;gDAKF,wBAAmB"}

package/dist/knowledge/injector.js

@@ -0,0 +1,58 @@
+//#region src/knowledge/injector.ts
+/**
+* Inject static knowledge into agent instructions.
+*
+* This function handles the "required" knowledge that should be
+* injected into the system prompt at agent initialization time.
+* Optional knowledge is handled by the knowledge query tool.
+*
+* @param instructions - Base agent instructions
+* @param knowledgeRefs - Knowledge references from the agent spec
+* @param retriever - Optional knowledge retriever
+* @returns Instructions with injected knowledge
+*/
+async function injectStaticKnowledge(instructions, knowledgeRefs, retriever) {
+	if (!retriever) return instructions;
+	const requiredRefs = knowledgeRefs.filter((ref) => ref.required);
+	if (requiredRefs.length === 0) return instructions;
+	const blocks = [];
+	for (const ref of requiredRefs) {
+		if (!retriever.supportsSpace(ref.key)) {
+			console.warn(`Required knowledge space "${ref.key}" is not available`);
+			continue;
+		}
+		try {
+			const content = await retriever.getStatic(ref.key);
+			if (content) {
+				const header = ref.instructions ? `## ${ref.key}\n${ref.instructions}` : `## ${ref.key}`;
+				blocks.push(`${header}\n\n${content}`);
+			}
+		} catch (error) {
+			console.warn(`Failed to load required knowledge "${ref.key}":`, error);
+		}
+	}
+	if (blocks.length === 0) return instructions;
+	return `${instructions}
+
+---
+
+# Reference Knowledge
+
+The following information is provided for your reference. Use it to inform your responses.
+
+${blocks.join("\n\n---\n\n")}`;
+}
+/**
+* Create a knowledge injector instance for reuse.
+*/
+function createKnowledgeInjector(retriever) {
+	return {
+		inject: (instructions, knowledgeRefs) => injectStaticKnowledge(instructions, knowledgeRefs, retriever),
+		hasSpace: (spaceKey) => retriever?.supportsSpace(spaceKey) ?? false,
+		listSpaces: () => retriever?.listSpaces() ?? []
+	};
+}
+
+//#endregion
+export { createKnowledgeInjector, injectStaticKnowledge };
+//# sourceMappingURL=injector.js.map

package/dist/knowledge/injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.js","names":["blocks: string[]"],"sources":["../../src/knowledge/injector.ts"],"sourcesContent":["import type { KnowledgeRetriever } from '@contractspec/lib.knowledge/retriever';\nimport type { AgentKnowledgeRef } from '../spec/spec';\n\n/**\n * Inject static knowledge into agent instructions.\n *\n * This function handles the \"required\" knowledge that should be\n * injected into the system prompt at agent initialization time.\n * Optional knowledge is handled by the knowledge query tool.\n *\n * @param instructions - Base agent instructions\n * @param knowledgeRefs - Knowledge references from the agent spec\n * @param retriever - Optional knowledge retriever\n * @returns Instructions with injected knowledge\n */\nexport async function injectStaticKnowledge(\n  instructions: string,\n  knowledgeRefs: AgentKnowledgeRef[],\n  retriever?: KnowledgeRetriever\n): Promise<string> {\n  if (!retriever) return instructions;\n\n  const requiredRefs = knowledgeRefs.filter((ref) => ref.required);\n  if (requiredRefs.length === 0) return instructions;\n\n  const blocks: string[] = [];\n\n  for (const ref of requiredRefs) {\n    if (!retriever.supportsSpace(ref.key)) {\n      console.warn(`Required knowledge space \"${ref.key}\" is not available`);\n      continue;\n    }\n\n    try {\n      const content = await retriever.getStatic(ref.key);\n      if (content) {\n        const header = ref.instructions\n          ? `## ${ref.key}\\n${ref.instructions}`\n          : `## ${ref.key}`;\n        blocks.push(`${header}\\n\\n${content}`);\n      }\n    } catch (error) {\n      console.warn(`Failed to load required knowledge \"${ref.key}\":`, error);\n    }\n  }\n\n  if (blocks.length === 0) return instructions;\n\n  return `${instructions}\n\n---\n\n# Reference Knowledge\n\nThe following information is provided for your reference. Use it to inform your responses.\n\n${blocks.join('\\n\\n---\\n\\n')}`;\n}\n\n/**\n * Create a knowledge injector instance for reuse.\n */\nexport function createKnowledgeInjector(retriever?: KnowledgeRetriever) {\n  return {\n    /**\n     * Inject static knowledge into instructions.\n     */\n    inject: (instructions: string, knowledgeRefs: AgentKnowledgeRef[]) =>\n      injectStaticKnowledge(instructions, knowledgeRefs, retriever),\n\n    /**\n     * Check if a knowledge space is available.\n     */\n    hasSpace: (spaceKey: string) => retriever?.supportsSpace(spaceKey) ?? false,\n\n    /**\n     * List available knowledge spaces.\n     */\n    listSpaces: () => retriever?.listSpaces() ?? [],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,eAAsB,sBACpB,cACA,eACA,WACiB;AACjB,KAAI,CAAC,UAAW,QAAO;CAEvB,MAAM,eAAe,cAAc,QAAQ,QAAQ,IAAI,SAAS;AAChE,KAAI,aAAa,WAAW,EAAG,QAAO;CAEtC,MAAMA,SAAmB,EAAE;AAE3B,MAAK,MAAM,OAAO,cAAc;AAC9B,MAAI,CAAC,UAAU,cAAc,IAAI,IAAI,EAAE;AACrC,WAAQ,KAAK,6BAA6B,IAAI,IAAI,oBAAoB;AACtE;;AAGF,MAAI;GACF,MAAM,UAAU,MAAM,UAAU,UAAU,IAAI,IAAI;AAClD,OAAI,SAAS;IACX,MAAM,SAAS,IAAI,eACf,MAAM,IAAI,IAAI,IAAI,IAAI,iBACtB,MAAM,IAAI;AACd,WAAO,KAAK,GAAG,OAAO,MAAM,UAAU;;WAEjC,OAAO;AACd,WAAQ,KAAK,sCAAsC,IAAI,IAAI,KAAK,MAAM;;;AAI1E,KAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,QAAO,GAAG,aAAa;;;;;;;;EAQvB,OAAO,KAAK,cAAc;;;;;AAM5B,SAAgB,wBAAwB,WAAgC;AACtE,QAAO;EAIL,SAAS,cAAsB,kBAC7B,sBAAsB,cAAc,eAAe,UAAU;EAK/D,WAAW,aAAqB,WAAW,cAAc,SAAS,IAAI;EAKtE,kBAAkB,WAAW,YAAY,IAAI,EAAE;EAChD"}

package/dist/memory/in-memory.d.ts

@@ -0,0 +1,22 @@
+import { AgentSessionState } from "../types.js";
+import { AgentMemorySnapshot, AgentSessionMemory, BaseAgentMemoryManager } from "./manager.js";
+
+//#region src/memory/in-memory.d.ts
+interface InMemoryAgentMemoryOptions {
+  ttlMinutes?: number;
+  maxEntries?: number;
+}
+declare class InMemoryAgentMemory extends BaseAgentMemoryManager {
+  private readonly ttlMs;
+  private readonly maxEntries;
+  private readonly store;
+  constructor(options?: InMemoryAgentMemoryOptions);
+  load(sessionId: string): Promise<AgentSessionMemory | null>;
+  save(snapshot: AgentSessionMemory): Promise<void>;
+  summarize(session: AgentSessionState): Promise<AgentMemorySnapshot>;
+  private trim;
+  private evictExpired;
+}
+//#endregion
+export { InMemoryAgentMemory, InMemoryAgentMemoryOptions };
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/memory/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","names":[],"sources":["../../src/memory/in-memory.ts"],"sourcesContent":[],"mappings":";;;;UAaiB,0BAAA;;EAAA,UAAA,CAAA,EAAA,MAAA;AAKjB;AAKwB,cALX,mBAAA,SAA4B,sBAAA,CAKjB;EAMiB,iBAAA,KAAA;EAAR,iBAAA,UAAA;EASV,iBAAA,KAAA;EAAqB,WAAA,CAAA,OAAA,CAAA,EAfpB,0BAeoB;EAQjB,IAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAjBM,OAiBN,CAjBc,kBAiBd,GAAA,IAAA,CAAA;EAA4B,IAAA,CAAA,QAAA,EARhC,kBAQgC,CAAA,EARX,OAQW,CAAA,IAAA,CAAA;EAAR,SAAA,CAAA,OAAA,EAApB,iBAAoB,CAAA,EAAA,OAAA,CAAQ,mBAAR,CAAA;EA5BN,QAAA,IAAA;EAAsB,QAAA,YAAA"}

package/dist/memory/in-memory.js

@@ -0,0 +1,48 @@
+import { BaseAgentMemoryManager } from "./manager.js";
+
+//#region src/memory/in-memory.ts
+var InMemoryAgentMemory = class extends BaseAgentMemoryManager {
+	ttlMs;
+	maxEntries;
+	store = /* @__PURE__ */ new Map();
+	constructor(options) {
+		super();
+		this.ttlMs = (options?.ttlMinutes ?? 60) * 60 * 1e3;
+		this.maxEntries = options?.maxEntries ?? 250;
+	}
+	async load(sessionId) {
+		this.evictExpired();
+		const stored = this.store.get(sessionId);
+		if (!stored) return null;
+		stored.data.session.updatedAt = /* @__PURE__ */ new Date();
+		stored.expiresAt = Date.now() + this.ttlMs;
+		return stored.data;
+	}
+	async save(snapshot) {
+		this.trim(snapshot.memory.entries);
+		this.store.set(snapshot.session.sessionId, {
+			data: snapshot,
+			expiresAt: Date.now() + this.ttlMs
+		});
+	}
+	async summarize(session) {
+		const current = await this.load(session.sessionId) ?? this.bootstrapMemory(session);
+		const content = current.memory.entries.slice(-10).map((entry) => `- ${entry.type}: ${entry.content}`).join("\n");
+		current.memory.summary = content;
+		current.memory.lastSummarizedAt = /* @__PURE__ */ new Date();
+		await this.save(current);
+		return current.memory;
+	}
+	trim(entries) {
+		if (entries.length <= this.maxEntries) return;
+		entries.splice(0, entries.length - this.maxEntries);
+	}
+	evictExpired() {
+		const now = Date.now();
+		for (const [sessionId, stored] of this.store.entries()) if (stored.expiresAt <= now) this.store.delete(sessionId);
+	}
+};
+
+//#endregion
+export { InMemoryAgentMemory };
+//# sourceMappingURL=in-memory.js.map

package/dist/memory/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","names":[],"sources":["../../src/memory/in-memory.ts"],"sourcesContent":["import type { AgentSessionState } from '../types';\nimport {\n  BaseAgentMemoryManager,\n  type AgentMemoryEntry,\n  type AgentMemorySnapshot,\n  type AgentSessionMemory,\n} from './manager';\n\ninterface StoredSession {\n  data: AgentSessionMemory;\n  expiresAt: number;\n}\n\nexport interface InMemoryAgentMemoryOptions {\n  ttlMinutes?: number;\n  maxEntries?: number;\n}\n\nexport class InMemoryAgentMemory extends BaseAgentMemoryManager {\n  private readonly ttlMs: number;\n  private readonly maxEntries: number;\n  private readonly store = new Map<string, StoredSession>();\n\n  constructor(options?: InMemoryAgentMemoryOptions) {\n    super();\n    this.ttlMs = (options?.ttlMinutes ?? 60) * 60 * 1000;\n    this.maxEntries = options?.maxEntries ?? 250;\n  }\n\n  async load(sessionId: string): Promise<AgentSessionMemory | null> {\n    this.evictExpired();\n    const stored = this.store.get(sessionId);\n    if (!stored) return null;\n    stored.data.session.updatedAt = new Date();\n    stored.expiresAt = Date.now() + this.ttlMs;\n    return stored.data;\n  }\n\n  async save(snapshot: AgentSessionMemory): Promise<void> {\n    this.trim(snapshot.memory.entries);\n    this.store.set(snapshot.session.sessionId, {\n      data: snapshot,\n      expiresAt: Date.now() + this.ttlMs,\n    });\n  }\n\n  async summarize(session: AgentSessionState): Promise<AgentMemorySnapshot> {\n    const current =\n      (await this.load(session.sessionId)) ?? this.bootstrapMemory(session);\n    const content = current.memory.entries\n      .slice(-10)\n      .map((entry) => `- ${entry.type}: ${entry.content}`)\n      .join('\\n');\n    current.memory.summary = content;\n    current.memory.lastSummarizedAt = new Date();\n    await this.save(current);\n    return current.memory;\n  }\n\n  private trim(entries: AgentMemoryEntry[]) {\n    if (entries.length <= this.maxEntries) return;\n    entries.splice(0, entries.length - this.maxEntries);\n  }\n\n  private evictExpired() {\n    const now = Date.now();\n    for (const [sessionId, stored] of this.store.entries()) {\n      if (stored.expiresAt <= now) {\n        this.store.delete(sessionId);\n      }\n    }\n  }\n}\n"],"mappings":";;;AAkBA,IAAa,sBAAb,cAAyC,uBAAuB;CAC9D,AAAiB;CACjB,AAAiB;CACjB,AAAiB,wBAAQ,IAAI,KAA4B;CAEzD,YAAY,SAAsC;AAChD,SAAO;AACP,OAAK,SAAS,SAAS,cAAc,MAAM,KAAK;AAChD,OAAK,aAAa,SAAS,cAAc;;CAG3C,MAAM,KAAK,WAAuD;AAChE,OAAK,cAAc;EACnB,MAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,KAAK,QAAQ,4BAAY,IAAI,MAAM;AAC1C,SAAO,YAAY,KAAK,KAAK,GAAG,KAAK;AACrC,SAAO,OAAO;;CAGhB,MAAM,KAAK,UAA6C;AACtD,OAAK,KAAK,SAAS,OAAO,QAAQ;AAClC,OAAK,MAAM,IAAI,SAAS,QAAQ,WAAW;GACzC,MAAM;GACN,WAAW,KAAK,KAAK,GAAG,KAAK;GAC9B,CAAC;;CAGJ,MAAM,UAAU,SAA0D;EACxE,MAAM,UACH,MAAM,KAAK,KAAK,QAAQ,UAAU,IAAK,KAAK,gBAAgB,QAAQ;EACvE,MAAM,UAAU,QAAQ,OAAO,QAC5B,MAAM,IAAI,CACV,KAAK,UAAU,KAAK,MAAM,KAAK,IAAI,MAAM,UAAU,CACnD,KAAK,KAAK;AACb,UAAQ,OAAO,UAAU;AACzB,UAAQ,OAAO,mCAAmB,IAAI,MAAM;AAC5C,QAAM,KAAK,KAAK,QAAQ;AACxB,SAAO,QAAQ;;CAGjB,AAAQ,KAAK,SAA6B;AACxC,MAAI,QAAQ,UAAU,KAAK,WAAY;AACvC,UAAQ,OAAO,GAAG,QAAQ,SAAS,KAAK,WAAW;;CAGrD,AAAQ,eAAe;EACrB,MAAM,MAAM,KAAK,KAAK;AACtB,OAAK,MAAM,CAAC,WAAW,WAAW,KAAK,MAAM,SAAS,CACpD,KAAI,OAAO,aAAa,IACtB,MAAK,MAAM,OAAO,UAAU"}

package/dist/memory/index.d.ts

@@ -0,0 +1,3 @@
+import { AgentMemoryEntry, AgentMemoryManager, AgentMemorySnapshot, AgentSessionMemory, BaseAgentMemoryManager, trackMessageInMemory } from "./manager.js";
+import { InMemoryAgentMemory, InMemoryAgentMemoryOptions } from "./in-memory.js";
+export { AgentMemoryEntry, AgentMemoryManager, AgentMemorySnapshot, AgentSessionMemory, BaseAgentMemoryManager, InMemoryAgentMemory, InMemoryAgentMemoryOptions, trackMessageInMemory };

package/dist/memory/index.js

@@ -0,0 +1,4 @@
+import { BaseAgentMemoryManager, trackMessageInMemory } from "./manager.js";
+import { InMemoryAgentMemory } from "./in-memory.js";
+
+export { BaseAgentMemoryManager, InMemoryAgentMemory, trackMessageInMemory };

package/dist/memory/manager.d.ts

@@ -0,0 +1,42 @@
+import { AgentMessage, AgentSessionState } from "../types.js";
+
+//#region src/memory/manager.d.ts
+interface AgentMemoryEntry {
+  id: string;
+  type: 'user' | 'assistant' | 'tool' | 'system';
+  content: string;
+  createdAt: Date;
+  metadata?: Record<string, string>;
+}
+interface AgentMemorySnapshot {
+  entries: AgentMemoryEntry[];
+  summary?: string;
+  lastSummarizedAt?: Date;
+}
+interface AgentSessionMemory {
+  session: AgentSessionState;
+  memory: AgentMemorySnapshot;
+}
+interface AgentMemoryManager {
+  load(sessionId: string): Promise<AgentSessionMemory | null>;
+  save(snapshot: AgentSessionMemory): Promise<void>;
+  append(session: AgentSessionState, entry: Omit<AgentMemoryEntry, 'id' | 'createdAt'> & {
+    createdAt?: Date;
+  }): Promise<AgentSessionMemory>;
+  summarize(session: AgentSessionState): Promise<AgentMemorySnapshot | undefined>;
+  prune(session: AgentSessionState): Promise<void>;
+}
+declare abstract class BaseAgentMemoryManager implements AgentMemoryManager {
+  abstract load(sessionId: string): Promise<AgentSessionMemory | null>;
+  abstract save(snapshot: AgentSessionMemory): Promise<void>;
+  append(session: AgentSessionState, entry: Omit<AgentMemoryEntry, 'id' | 'createdAt'> & {
+    createdAt?: Date;
+  }): Promise<AgentSessionMemory>;
+  summarize(_session: AgentSessionState): Promise<AgentMemorySnapshot | undefined>;
+  prune(_session: AgentSessionState): Promise<void>;
+  protected bootstrapMemory(session: AgentSessionState): AgentSessionMemory;
+}
+declare function trackMessageInMemory(manager: AgentMemoryManager | undefined, session: AgentSessionState, message: AgentMessage): void;
+//#endregion
+export { AgentMemoryEntry, AgentMemoryManager, AgentMemorySnapshot, AgentSessionMemory, BaseAgentMemoryManager, trackMessageInMemory };
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","names":[],"sources":["../../src/memory/manager.ts"],"sourcesContent":[],"mappings":";;;UAIiB,gBAAA;;EAAA,IAAA,EAAA,MAAA,GAAA,WAAgB,GAAA,MAIpB,GACA,QAAM;EAGF,OAAA,EAAA,MAAA;EAMA,SAAA,EAVJ,IAUI;EAKA,QAAA,CAAA,EAdJ,MAcI,CAAA,MAAkB,EAAA,MAAA,CAAA;;AACR,UAZV,mBAAA,CAYU;EACV,OAAA,EAZN,gBAYM,EAAA;EAAqB,OAAA,CAAA,EAAA,MAAA;EAEzB,gBAAA,CAAA,EAZQ,IAYR;;AACF,UAVM,kBAAA,CAUN;EAA2D,OAAA,EAT3D,iBAS2D;EACzD,MAAA,EATH,mBASG;;AAEA,UARI,kBAAA,CAQJ;EACA,IAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EARc,OAQd,CARsB,kBAQtB,GAAA,IAAA,CAAA;EAAR,IAAA,CAAA,QAAA,EAPY,kBAOZ,CAAA,EAPiC,OAOjC,CAAA,IAAA,CAAA;EACY,MAAA,CAAA,OAAA,EANJ,iBAMI,EAAA,KAAA,EALN,IAKM,CALD,gBAKC,EAAA,IAAA,GAAA,WAAA,CAAA,GAAA;IAAoB,SAAA,CAAA,EALiC,IAKjC;EAAO,CAAA,CAAA,EAJvC,OAIuC,CAJ/B,kBAI+B,CAAA;EAyEtB,SAAA,CAAA,OAAA,EA3ET,iBA2EgC,CAAA,EA1ExC,OA0EwC,CA1EhC,mBA0EgC,GAAA,SAAA,CAAA;EACD,KAAA,CAAA,OAAA,EA1E3B,iBA0E2B,CAAA,EA1EP,OA0EO,CAAA,IAAA,CAAA;;AAClB,uBAFJ,sBAAA,YAAkC,kBAE9B,CAAA;EAAqB,SAAA,IAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EADX,OACW,CADH,kBACG,GAAA,IAAA,CAAA;EAGlC,SAAA,IAAA,CAAA,QAAA,EAHa,kBAGb,CAAA,EAHkC,OAGlC,CAAA,IAAA,CAAA;EACG,MAAA,CAAA,OAAA,EADH,iBACG,EAAA,KAAA,EAAL,IAAK,CAAA,gBAAA,EAAA,IAAA,GAAA,WAAA,CAAA,GAAA;IAAL,SAAA,CAAA,EAA2D,IAA3D;EAA2D,CAAA,CAAA,EACjE,OADiE,CACzD,kBADyD,CAAA;EACzD,SAAA,CAAA,QAAA,EAcC,iBAdD,CAAA,EAeR,OAfQ,CAeA,mBAfA,GAAA,SAAA,CAAA;EAAR,KAAA,CAAA,QAAA,EAmBmB,iBAnBnB,CAAA,EAmBuC,OAnBvC,CAAA,IAAA,CAAA;EAcS,UAAA,eAAA,CAAA,OAAA,EASuB,iBATvB,CAAA,EAS2C,kBAT3C;;AACT,iBAuBW,oBAAA,CAvBX,OAAA,EAwBM,kBAxBN,GAAA,SAAA,EAAA,OAAA,EAyBM,iBAzBN,EAAA,OAAA,EA0BM,YA1BN,CAAA,EAAA,IAAA"}