@contractspec/lib.ai-agent 1.57.0 → 1.59.0

package/dist/telemetry/adapter.d.ts

@@ -1,18 +1,16 @@
-import { StepResult, ToolSet } from "ai";
-
-//#region src/telemetry/adapter.d.ts
+import type { StepResult, ToolSet } from 'ai';
 /**
  * Metric sample compatible with @contractspec/lib.evolution OperationMetricSample.
  */
-interface OperationMetricSample {
-  operation: {
-    name: string;
-    version: string;
-  };
-  durationMs: number;
-  success: boolean;
-  timestamp: Date;
-  metadata?: Record<string, unknown>;
+export interface OperationMetricSample {
+    operation: {
+        name: string;
+        version: string;
+    };
+    durationMs: number;
+    success: boolean;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Interface for collecting telemetry metrics.
@@ -22,11 +20,11 @@ interface OperationMetricSample {
  * - PostHog for analytics
  * - Custom monitoring systems
  */
-interface TelemetryCollector {
-  /**
-   * Collect a metric sample.
-   */
-  collect(sample: OperationMetricSample): Promise<void>;
+export interface TelemetryCollector {
+    /**
+     * Collect a metric sample.
+     */
+    collect(sample: OperationMetricSample): Promise<void>;
 }
 /**
  * Track an agent step for telemetry.
@@ -39,34 +37,32 @@ interface TelemetryCollector {
  * @param step - AI SDK step result
  * @param durationMs - Optional step duration in milliseconds
  */
-declare function trackAgentStep(collector: TelemetryCollector, agentId: string, step: StepResult<ToolSet>, durationMs?: number): Promise<void>;
+export declare function trackAgentStep(collector: TelemetryCollector, agentId: string, step: StepResult<ToolSet>, durationMs?: number): Promise<void>;
 /**
  * In-memory telemetry collector for testing.
  */
-declare class InMemoryTelemetryCollector implements TelemetryCollector {
-  private readonly samples;
-  collect(sample: OperationMetricSample): Promise<void>;
-  /**
-   * Get all collected samples.
-   */
-  getSamples(): OperationMetricSample[];
-  /**
-   * Get samples for a specific operation.
-   */
-  getSamplesForOperation(operationName: string): OperationMetricSample[];
-  /**
-   * Clear all samples.
-   */
-  clear(): void;
+export declare class InMemoryTelemetryCollector implements TelemetryCollector {
+    private readonly samples;
+    collect(sample: OperationMetricSample): Promise<void>;
+    /**
+     * Get all collected samples.
+     */
+    getSamples(): OperationMetricSample[];
+    /**
+     * Get samples for a specific operation.
+     */
+    getSamplesForOperation(operationName: string): OperationMetricSample[];
+    /**
+     * Clear all samples.
+     */
+    clear(): void;
 }
 /**
  * Create an in-memory telemetry collector.
  */
-declare function createInMemoryTelemetryCollector(): InMemoryTelemetryCollector;
+export declare function createInMemoryTelemetryCollector(): InMemoryTelemetryCollector;
 /**
  * No-op telemetry collector that discards all metrics.
  */
-declare const noopTelemetryCollector: TelemetryCollector;
-//#endregion
-export { InMemoryTelemetryCollector, OperationMetricSample, TelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep };
+export declare const noopTelemetryCollector: TelemetryCollector;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/telemetry/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../src/telemetry/adapter.ts"],"mappings":";;;;;AAKA;UAAiB,qBAAA;EACf,SAAA;IAAa,IAAA;IAAc,OAAA;EAAA;EAC3B,UAAA;EACA,OAAA;EACA,SAAA,EAAW,IAAA;EACX,QAAA,GAAW,MAAA;AAAA;;;;;AAWb;;;;UAAiB,kBAAA;EAIC;;;EAAhB,OAAA,CAAQ,MAAA,EAAQ,qBAAA,GAAwB,OAAA;AAAA;AA0B1C;;;;;;;;;;;AAAA,iBAAsB,cAAA,CACpB,SAAA,EAAW,kBAAA,EACX,OAAA,UACA,IAAA,EAAM,UAAA,CAAW,OAAA,GACjB,UAAA,YACC,OAAA;;;;cAyCU,0BAAA,YAAsC,kBAAA;EAAA,iBAChC,OAAA;EAEX,OAAA,CAAQ,MAAA,EAAQ,qBAAA,GAAwB,OAAA;EA5CtC;AAyCV;;EAUE,UAAA,CAAA,GAAc,qBAAA;EAPQ;;;EActB,sBAAA,CAAuB,aAAA,WAAwB,qBAAA;EAjBE;;;EAwBjD,KAAA,CAAA;AAAA;;;;iBAQc,gCAAA,CAAA,GAAoC,0BAAA;;;;cAOvC,sBAAA,EAAwB,kBAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/telemetry/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAcD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;GAEG;AACH,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEjD,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;OAEG;IACH,UAAU,IAAI,qBAAqB,EAAE;IAIrC;;OAEG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAItE;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,0BAA0B,CAE7E;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,kBAIpC,CAAC"}

package/dist/telemetry/adapter.js

@@ -1,103 +1,85 @@
-//#region src/telemetry/adapter.ts
-/**
-* Parse agent ID into name and version.
-*/
+// @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/telemetry/adapter.ts
 function parseAgentId(agentId) {
-	const match = agentId.match(/^(.+)\.v(\s+)$/);
-	if (match) return {
-		name: match[1],
-		version: match[2]
-	};
-	return {
-		name: agentId,
-		version: "1.0.0"
-	};
+  const match = agentId.match(/^(.+)\.v(\s+)$/);
+  if (match) {
+    return { name: match[1], version: match[2] };
+  }
+  return { name: agentId, version: "1.0.0" };
 }
-/**
-* Track an agent step for telemetry.
-*
-* Called from ContractSpecAgent.onStepFinish to feed metrics
-* to the evolution engine.
-*
-* @param collector - Telemetry collector
-* @param agentId - Agent identifier (e.g., "support.bot.v1")
-* @param step - AI SDK step result
-* @param durationMs - Optional step duration in milliseconds
-*/
 async function trackAgentStep(collector, agentId, step, durationMs) {
-	const { name, version } = parseAgentId(agentId);
-	for (const toolCall of step.toolCalls ?? []) {
-		const toolSample = {
-			operation: {
-				name: `${name}.${toolCall.toolName}`,
-				version
-			},
-			durationMs: durationMs ?? 0,
-			success: step.toolResults?.some((r) => r.toolCallId === toolCall.toolCallId && r.output !== void 0) ?? false,
-			timestamp: /* @__PURE__ */ new Date(),
-			metadata: {
-				agentId,
-				toolName: toolCall.toolName,
-				finishReason: step.finishReason
-			}
-		};
-		await collector.collect(toolSample);
-	}
-	const stepSample = {
-		operation: {
-			name,
-			version
-		},
-		durationMs: durationMs ?? 0,
-		success: step.finishReason !== "error",
-		timestamp: /* @__PURE__ */ new Date(),
-		metadata: {
-			agentId,
-			finishReason: step.finishReason,
-			tokenUsage: step.usage,
-			toolCallCount: step.toolCalls?.length ?? 0
-		}
-	};
-	await collector.collect(stepSample);
+  const { name, version } = parseAgentId(agentId);
+  for (const toolCall of step.toolCalls ?? []) {
+    const toolSample = {
+      operation: { name: `${name}.${toolCall.toolName}`, version },
+      durationMs: durationMs ?? 0,
+      success: step.toolResults?.some((r) => r.toolCallId === toolCall.toolCallId && r.output !== undefined) ?? false,
+      timestamp: new Date,
+      metadata: {
+        agentId,
+        toolName: toolCall.toolName,
+        finishReason: step.finishReason
+      }
+    };
+    await collector.collect(toolSample);
+  }
+  const stepSample = {
+    operation: { name, version },
+    durationMs: durationMs ?? 0,
+    success: step.finishReason !== "error",
+    timestamp: new Date,
+    metadata: {
+      agentId,
+      finishReason: step.finishReason,
+      tokenUsage: step.usage,
+      toolCallCount: step.toolCalls?.length ?? 0
+    }
+  };
+  await collector.collect(stepSample);
+}
+
+class InMemoryTelemetryCollector {
+  samples = [];
+  async collect(sample) {
+    this.samples.push(sample);
+  }
+  getSamples() {
+    return [...this.samples];
+  }
+  getSamplesForOperation(operationName) {
+    return this.samples.filter((s) => s.operation.name === operationName);
+  }
+  clear() {
+    this.samples.length = 0;
+  }
 }
-/**
-* In-memory telemetry collector for testing.
-*/
-var InMemoryTelemetryCollector = class {
-	samples = [];
-	async collect(sample) {
-		this.samples.push(sample);
-	}
-	/**
-	* Get all collected samples.
-	*/
-	getSamples() {
-		return [...this.samples];
-	}
-	/**
-	* Get samples for a specific operation.
-	*/
-	getSamplesForOperation(operationName) {
-		return this.samples.filter((s) => s.operation.name === operationName);
-	}
-	/**
-	* Clear all samples.
-	*/
-	clear() {
-		this.samples.length = 0;
-	}
-};
-/**
-* Create an in-memory telemetry collector.
-*/
 function createInMemoryTelemetryCollector() {
-	return new InMemoryTelemetryCollector();
+  return new InMemoryTelemetryCollector;
 }
-/**
-* No-op telemetry collector that discards all metrics.
-*/
-const noopTelemetryCollector = { collect: async () => {} };
+var noopTelemetryCollector;
+var init_adapter = __esm(() => {
+  noopTelemetryCollector = {
+    collect: async () => {}
+  };
+});
+init_adapter();
 
-//#endregion
-export { InMemoryTelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep };
-//# sourceMappingURL=adapter.js.map
+export {
+  trackAgentStep,
+  noopTelemetryCollector,
+  createInMemoryTelemetryCollector,
+  InMemoryTelemetryCollector
+};

package/dist/telemetry/index.d.ts

@@ -1,2 +1,2 @@
-import { InMemoryTelemetryCollector, OperationMetricSample, TelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep } from "./adapter.js";
-export { InMemoryTelemetryCollector, OperationMetricSample, TelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep };
+export * from './adapter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/telemetry/index.js

@@ -1,3 +1,86 @@
-import { InMemoryTelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep } from "./adapter.js";
+// @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
 
-export { InMemoryTelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep };
+// src/telemetry/adapter.ts
+function parseAgentId(agentId) {
+  const match = agentId.match(/^(.+)\.v(\s+)$/);
+  if (match) {
+    return { name: match[1], version: match[2] };
+  }
+  return { name: agentId, version: "1.0.0" };
+}
+async function trackAgentStep(collector, agentId, step, durationMs) {
+  const { name, version } = parseAgentId(agentId);
+  for (const toolCall of step.toolCalls ?? []) {
+    const toolSample = {
+      operation: { name: `${name}.${toolCall.toolName}`, version },
+      durationMs: durationMs ?? 0,
+      success: step.toolResults?.some((r) => r.toolCallId === toolCall.toolCallId && r.output !== undefined) ?? false,
+      timestamp: new Date,
+      metadata: {
+        agentId,
+        toolName: toolCall.toolName,
+        finishReason: step.finishReason
+      }
+    };
+    await collector.collect(toolSample);
+  }
+  const stepSample = {
+    operation: { name, version },
+    durationMs: durationMs ?? 0,
+    success: step.finishReason !== "error",
+    timestamp: new Date,
+    metadata: {
+      agentId,
+      finishReason: step.finishReason,
+      tokenUsage: step.usage,
+      toolCallCount: step.toolCalls?.length ?? 0
+    }
+  };
+  await collector.collect(stepSample);
+}
+
+class InMemoryTelemetryCollector {
+  samples = [];
+  async collect(sample) {
+    this.samples.push(sample);
+  }
+  getSamples() {
+    return [...this.samples];
+  }
+  getSamplesForOperation(operationName) {
+    return this.samples.filter((s) => s.operation.name === operationName);
+  }
+  clear() {
+    this.samples.length = 0;
+  }
+}
+function createInMemoryTelemetryCollector() {
+  return new InMemoryTelemetryCollector;
+}
+var noopTelemetryCollector;
+var init_adapter = __esm(() => {
+  noopTelemetryCollector = {
+    collect: async () => {}
+  };
+});
+
+// src/telemetry/index.ts
+init_adapter();
+export {
+  trackAgentStep,
+  noopTelemetryCollector,
+  createInMemoryTelemetryCollector,
+  InMemoryTelemetryCollector
+};

package/dist/tools/index.d.ts

@@ -1,5 +1,5 @@
-import { McpClientConfig, McpClientResult, createMcpToolsets, mcpServerToTools } from "./mcp-client.js";
-import { buildToolHandlers, createToolHandler, specToolToAISDKTool, specToolsToAISDKTools } from "./tool-adapter.js";
-import { createKnowledgeQueryTool } from "./knowledge-tool.js";
-import { AgentMcpServerConfig, agentToMcpServer, createAgentMcpServer } from "./mcp-server.js";
-export { AgentMcpServerConfig, McpClientConfig, McpClientResult, agentToMcpServer, buildToolHandlers, createAgentMcpServer, createKnowledgeQueryTool, createMcpToolsets, createToolHandler, mcpServerToTools, specToolToAISDKTool, specToolsToAISDKTools };
+export * from './tool-adapter';
+export * from './knowledge-tool';
+export * from './mcp-client';
+export * from './mcp-server';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}