@lssm/lib.ai-agent 1.41.0 → 1.42.1

package/dist/tools/tool-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.js","names":["tools: Record<string, Tool<any, any>>"],"sources":["../../src/tools/tool-adapter.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { tool, type Tool } from 'ai';\nimport type { AgentToolConfig } from '../spec/spec';\nimport type { ToolExecutionContext, ToolHandler } from '../types';\nimport { jsonSchemaToZodSafe } from '../schema/json-schema-to-zod';\n\n/**\n * Convert ContractSpec AgentToolConfig to AI SDK CoreTool.\n *\n * @param specTool - The tool configuration from AgentSpec\n * @param handler - The handler function for the tool\n * @param context - Partial context to inject into handler calls\n * @returns AI SDK CoreTool\n */\nexport function specToolToAISDKTool(\n  specTool: AgentToolConfig,\n  handler: ToolHandler,\n  context: Partial<ToolExecutionContext> = {}\n): Tool<any, any> {\n  return tool({\n    description: specTool.description ?? specTool.name,\n    // AI SDK v6 uses inputSchema instead of parameters\n    inputSchema: jsonSchemaToZodSafe(specTool.schema),\n    // AI SDK v6 native approval support\n    needsApproval: specTool.requiresApproval ?? !specTool.automationSafe,\n    execute: async (input) => {\n      const result = await handler(input, {\n        agentId: context.agentId ?? 'unknown',\n        sessionId: context.sessionId ?? 'unknown',\n        tenantId: context.tenantId,\n        actorId: context.actorId,\n        metadata: context.metadata,\n        signal: context.signal,\n      });\n      return typeof result === 'string' ? result : JSON.stringify(result);\n    },\n  });\n}\n\n/**\n * Convert multiple ContractSpec tool configs to AI SDK tools.\n *\n * @param specTools - Array of tool configurations\n * @param handlers - Map of tool name to handler function\n * @param context - Partial context to inject into handler calls\n * @returns Record of AI SDK tools keyed by name\n */\nexport function specToolsToAISDKTools(\n  specTools: AgentToolConfig[],\n  handlers: Map<string, ToolHandler>,\n  context: Partial<ToolExecutionContext> = {}\n): Record<string, Tool<any, any>> {\n  const tools: Record<string, Tool<any, any>> = {};\n\n  for (const specTool of specTools) {\n    const handler = handlers.get(specTool.name);\n    if (!handler) {\n      throw new Error(`Missing handler for tool: ${specTool.name}`);\n    }\n\n    tools[specTool.name] = specToolToAISDKTool(specTool, handler, context);\n  }\n\n  return tools;\n}\n\n/**\n * Type-safe tool handler builder.\n *\n * @example\n * ```typescript\n * const handler = createToolHandler<{ query: string }>((input, ctx) => {\n *   return `Searched for: ${input.query}`;\n * });\n * ```\n */\nexport function createToolHandler<TInput = unknown, TOutput = string>(\n  handler: (\n    input: TInput,\n    context: ToolExecutionContext\n  ) => Promise<TOutput> | TOutput\n): ToolHandler<TInput, TOutput> {\n  return async (input, context) => {\n    return handler(input as TInput, context);\n  };\n}\n\n/**\n * Build a tool handlers map from an object.\n *\n * @example\n * ```typescript\n * const handlers = buildToolHandlers({\n *   search: async (input: { query: string }) => `Found: ${input.query}`,\n *   calculate: async (input: { a: number, b: number }) => `${input.a + input.b}`,\n * });\n * ```\n */\nexport function buildToolHandlers(\n  handlersObj: Record<string, ToolHandler>\n): Map<string, ToolHandler> {\n  return new Map(Object.entries(handlersObj));\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,oBACd,UACA,SACA,UAAyC,EAAE,EAC3B;AAChB,QAAO,KAAK;EACV,aAAa,SAAS,eAAe,SAAS;EAE9C,aAAa,oBAAoB,SAAS,OAAO;EAEjD,eAAe,SAAS,oBAAoB,CAAC,SAAS;EACtD,SAAS,OAAO,UAAU;GACxB,MAAM,SAAS,MAAM,QAAQ,OAAO;IAClC,SAAS,QAAQ,WAAW;IAC5B,WAAW,QAAQ,aAAa;IAChC,UAAU,QAAQ;IAClB,SAAS,QAAQ;IACjB,UAAU,QAAQ;IAClB,QAAQ,QAAQ;IACjB,CAAC;AACF,UAAO,OAAO,WAAW,WAAW,SAAS,KAAK,UAAU,OAAO;;EAEtE,CAAC;;;;;;;;;;AAWJ,SAAgB,sBACd,WACA,UACA,UAAyC,EAAE,EACX;CAChC,MAAMA,QAAwC,EAAE;AAEhD,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,UAAU,SAAS,IAAI,SAAS,KAAK;AAC3C,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,6BAA6B,SAAS,OAAO;AAG/D,QAAM,SAAS,QAAQ,oBAAoB,UAAU,SAAS,QAAQ;;AAGxE,QAAO;;;;;;;;;;;;AAaT,SAAgB,kBACd,SAI8B;AAC9B,QAAO,OAAO,OAAO,YAAY;AAC/B,SAAO,QAAQ,OAAiB,QAAQ;;;;;;;;;;;;;;AAe5C,SAAgB,kBACd,aAC0B;AAC1B,QAAO,IAAI,IAAI,OAAO,QAAQ,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,146 @@
+import { LanguageModelUsage, ModelMessage, StepResult, ToolSet } from "ai";
+
+//#region src/types.d.ts
+
+/**
+ * Simplified tool call type for ContractSpec usage.
+ * Compatible with AI SDK v6 TypedToolCall.
+ */
+interface ToolCallInfo {
+  type: 'tool-call';
+  toolCallId: string;
+  toolName: string;
+  args: unknown;
+}
+/**
+ * Simplified tool result type for ContractSpec usage.
+ * Compatible with AI SDK v6 TypedToolResult.
+ */
+interface ToolResultInfo {
+  type: 'tool-result';
+  toolCallId: string;
+  toolName: string;
+  output: unknown;
+}
+/**
+ * Extended message type that adds metadata support to ModelMessage.
+ * Used for session memory tracking.
+ */
+interface AgentMessage {
+  role: 'user' | 'assistant' | 'system' | 'tool';
+  content: string | {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+  }[];
+  metadata?: Record<string, string>;
+}
+type AgentStatus = 'idle' | 'running' | 'waiting' | 'completed' | 'failed' | 'escalated';
+type AgentEventName = 'agent.session.created' | 'agent.session.updated' | 'agent.step.started' | 'agent.step.completed' | 'agent.tool.called' | 'agent.tool.completed' | 'agent.tool.failed' | 'agent.tool.approval_requested' | 'agent.escalated' | 'agent.completed' | 'agent.failed';
+type AgentFinishReason = 'stop' | 'tool-calls' | 'length' | 'content-filter' | 'error' | 'other' | 'unknown';
+interface AgentEventPayload {
+  sessionId: string;
+  agentId: string;
+  tenantId?: string;
+  stepIndex?: number;
+  toolName?: string;
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Runtime context passed to agent calls via AI SDK v6 callOptionsSchema.
+ * Maps to ContractSpec's tenant/actor system.
+ */
+interface AgentCallOptions {
+  /** Tenant scoping for guardrails and data isolation */
+  tenantId?: string;
+  /** Unique end-user identifier (for personalization) */
+  actorId?: string;
+  /** Session to resume; new session created when omitted */
+  sessionId?: string;
+  /** Arbitrary metadata forwarded to events and tool handlers */
+  metadata?: Record<string, string>;
+}
+interface AgentSessionState {
+  sessionId: string;
+  agentId: string;
+  tenantId?: string;
+  actorId?: string;
+  status: AgentStatus;
+  messages: ModelMessage[];
+  steps: StepResult<ToolSet>[];
+  createdAt: Date;
+  updatedAt: Date;
+  metadata?: Record<string, string>;
+}
+interface AgentGenerateParams {
+  /** User prompt or message */
+  prompt: string;
+  /** System prompt override (appended to agent instructions) */
+  systemOverride?: string;
+  /** Runtime context options */
+  options?: AgentCallOptions;
+  /** Maximum number of steps/iterations */
+  maxSteps?: number;
+  /** Abort signal for cancellation */
+  signal?: AbortSignal;
+}
+interface AgentStreamParams extends AgentGenerateParams {
+  /** Called when a step completes */
+  onStepFinish?: (step: StepResult<ToolSet>) => void | Promise<void>;
+}
+interface AgentGenerateResult<TOutput = string> {
+  /** The final text response */
+  text: string;
+  /** Structured output if configured */
+  output?: TOutput;
+  /** All steps taken during generation */
+  steps: StepResult<ToolSet>[];
+  /** All tool calls made during generation */
+  toolCalls: ToolCallInfo[];
+  /** All tool results */
+  toolResults: ToolResultInfo[];
+  /** Reason generation finished */
+  finishReason: AgentFinishReason;
+  /** Token usage statistics */
+  usage?: LanguageModelUsage;
+  /** Updated session state */
+  session?: AgentSessionState;
+  /** Whether approval is pending for a tool call */
+  pendingApproval?: {
+    toolName: string;
+    toolCallId: string;
+    args: unknown;
+  };
+}
+/**
+ * Context provided to tool handlers during execution.
+ */
+interface ToolExecutionContext {
+  agentId: string;
+  sessionId: string;
+  tenantId?: string;
+  actorId?: string;
+  metadata?: Record<string, string>;
+  signal?: AbortSignal;
+}
+/**
+ * Handler function for a tool.
+ */
+type ToolHandler<TInput = unknown, TOutput = string> = (input: TInput, context: ToolExecutionContext) => Promise<TOutput>;
+interface AgentStepMetrics {
+  agentId: string;
+  stepIndex: number;
+  toolCalls: {
+    toolName: string;
+    durationMs?: number;
+    success: boolean;
+    error?: string;
+  }[];
+  finishReason: string;
+  usage?: LanguageModelUsage;
+  timestamp: Date;
+}
+type AgentEventEmitter = (event: AgentEventName, payload: AgentEventPayload) => void | Promise<void>;
+//#endregion
+export { AgentCallOptions, AgentEventEmitter, AgentEventName, AgentEventPayload, AgentFinishReason, AgentGenerateParams, AgentGenerateResult, AgentMessage, AgentSessionState, AgentStatus, AgentStepMetrics, AgentStreamParams, ToolCallInfo, ToolExecutionContext, ToolHandler, ToolResultInfo };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAUA;AAWA;AAeiB,UA1BA,YAAA,CA6BJ;EAOD,IAAA,EAAA,WAAW;EAQX,UAAA,EAAA,MAAc;EAad,QAAA,EAAA,MAAA;EASK,IAAA,EAAA,OAAA;AAiBjB;AAeA;;;;AAOS,UA9FQ,cAAA,CA8FR;EACI,IAAA,EAAA,aAAA;EACA,UAAA,EAAA,MAAA;EACA,QAAA,EAAA,MAAA;EAAM,MAAA,EAAA,OAAA;AAOnB;AAaA;;;;AAA2C,UAtG1B,YAAA,CAsG0B;EAAmB,IAAA,EAAA,MAAA,GAAA,WAAA,GAAA,QAAA,GAAA,MAAA;EAS7C,OAAA,EAAA,MAAA,GAAA;IAIN,IAAA,EAAA,MAAA;IAES,IAAA,CAAA,EAAA,MAAA;IAAX,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;EAEI,CAAA,EAAA;EAEE,QAAA,CAAA,EAtHF,MAsHE,CAAA,MAAA,EAAA,MAAA,CAAA;;AAIL,KAnHE,WAAA,GAmHF,MAAA,GAAA,SAAA,GAAA,SAAA,GAAA,WAAA,GAAA,QAAA,GAAA,WAAA;AAEE,KA7GA,cAAA,GA6GA,uBAAA,GAAA,uBAAA,GAAA,oBAAA,GAAA,sBAAA,GAAA,mBAAA,GAAA,sBAAA,GAAA,mBAAA,GAAA,+BAAA,GAAA,iBAAA,GAAA,iBAAA,GAAA,cAAA;AAAiB,KAhGjB,iBAAA,GAgGiB,MAAA,GAAA,YAAA,GAAA,QAAA,GAAA,gBAAA,GAAA,OAAA,GAAA,OAAA,GAAA,SAAA;AAgBZ,UAvGA,iBAAA,CAuGoB;EAYzB,SAAA,EAAA,MAAW;EACd,OAAA,EAAA,MAAA;EACE,QAAA,CAAA,EAAA,MAAA;EACE,SAAA,CAAA,EAAA,MAAA;EAAR,QAAA,CAAA,EAAA,MAAA;EAAO,QAAA,CAAA,EAhHC,MAgHD,CAAA,MAAA,EAAA,OAAA,CAAA;AAMZ;AAkBA;;;;AAGmB,UAhIF,gBAAA,CAgIE;;;;;;;;aAxHN;;UAOI,iBAAA;;;;;UAKP;YACE;SACH,WAAW;aACP;aACA;aACA;;UAOI,mBAAA;;;;;;YAML;;;;WAID;;UAGM,iBAAA,SAA0B;;wBAEnB,WAAW,oBAAoB;;UAOtC;;;;WAIN;;SAEF,WAAW;;aAEP;;eAEE;;gBAEC;;UAEN;;YAEE;;;;;;;;;;;UAgBK,oBAAA;;;;;aAKJ;WACF;;;;;KAMC,0DACH,iBACE,yBACN,QAAQ;UAMI,gBAAA;;;;;;;;;;UAUP;aACG;;KAOD,iBAAA,WACH,yBACE,6BACC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.ai-agent",
-  "version": "1.41.0",
+  "version": "1.42.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -11,7 +11,8 @@
   ],
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
-    "build": "bun build:bundle && bun build:types",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -22,50 +23,51 @@
     "test": "bun test"
   },
   "dependencies": {
-    "ai": "beta",
-    "@ai-sdk/mcp": "beta",
-    "@ai-sdk/mistral": "beta",
-    "@ai-sdk/openai": "beta",
-    "@ai-sdk/anthropic": "beta",
+    "ai": "6.0.3",
+    "@ai-sdk/mcp": "1.0.1",
+    "@ai-sdk/anthropic": "3.0.1",
+    "@ai-sdk/google": "3.0.1",
+    "@ai-sdk/mistral": "3.0.1",
+    "@ai-sdk/openai": "3.0.1",
     "@modelcontextprotocol/sdk": "^1.24.3",
-    "@lssm/lib.contracts": "workspace:*",
-    "@lssm/lib.knowledge": "workspace:*",
+    "@lssm/lib.contracts": "1.42.1",
+    "@lssm/lib.knowledge": "1.42.1",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "workspace:*",
-    "@lssm/tool.typescript": "workspace:*",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "1.42.1",
+    "@lssm/tool.typescript": "1.42.1",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./agent": "./src/agent/index.ts",
-    "./agent/agent-factory": "./src/agent/agent-factory.ts",
-    "./agent/contract-spec-agent": "./src/agent/contract-spec-agent.ts",
-    "./approval": "./src/approval/index.ts",
-    "./approval/workflow": "./src/approval/workflow.ts",
-    "./knowledge": "./src/knowledge/index.ts",
-    "./knowledge/injector": "./src/knowledge/injector.ts",
-    "./memory": "./src/memory/index.ts",
-    "./memory/in-memory": "./src/memory/in-memory.ts",
-    "./memory/manager": "./src/memory/manager.ts",
-    "./schema": "./src/schema/index.ts",
-    "./schema/json-schema-to-zod": "./src/schema/json-schema-to-zod.ts",
-    "./schema/schema-output": "./src/schema/schema-output.ts",
-    "./session": "./src/session/index.ts",
-    "./session/store": "./src/session/store.ts",
-    "./spec": "./src/spec/index.ts",
-    "./spec/registry": "./src/spec/registry.ts",
-    "./spec/spec": "./src/spec/spec.ts",
-    "./telemetry": "./src/telemetry/index.ts",
-    "./telemetry/adapter": "./src/telemetry/adapter.ts",
-    "./tools": "./src/tools/index.ts",
-    "./tools/knowledge-tool": "./src/tools/knowledge-tool.ts",
-    "./tools/mcp-client": "./src/tools/mcp-client.ts",
-    "./tools/mcp-server": "./src/tools/mcp-server.ts",
-    "./tools/tool-adapter": "./src/tools/tool-adapter.ts",
-    "./types": "./src/types.ts",
+    ".": "./dist/index.js",
+    "./agent": "./dist/agent/index.js",
+    "./agent/agent-factory": "./dist/agent/agent-factory.js",
+    "./agent/contract-spec-agent": "./dist/agent/contract-spec-agent.js",
+    "./approval": "./dist/approval/index.js",
+    "./approval/workflow": "./dist/approval/workflow.js",
+    "./knowledge": "./dist/knowledge/index.js",
+    "./knowledge/injector": "./dist/knowledge/injector.js",
+    "./memory": "./dist/memory/index.js",
+    "./memory/in-memory": "./dist/memory/in-memory.js",
+    "./memory/manager": "./dist/memory/manager.js",
+    "./schema": "./dist/schema/index.js",
+    "./schema/json-schema-to-zod": "./dist/schema/json-schema-to-zod.js",
+    "./schema/schema-output": "./dist/schema/schema-output.js",
+    "./session": "./dist/session/index.js",
+    "./session/store": "./dist/session/store.js",
+    "./spec": "./dist/spec/index.js",
+    "./spec/registry": "./dist/spec/registry.js",
+    "./spec/spec": "./dist/spec/spec.js",
+    "./telemetry": "./dist/telemetry/index.js",
+    "./telemetry/adapter": "./dist/telemetry/adapter.js",
+    "./tools": "./dist/tools/index.js",
+    "./tools/knowledge-tool": "./dist/tools/knowledge-tool.js",
+    "./tools/mcp-client": "./dist/tools/mcp-client.js",
+    "./tools/mcp-server": "./dist/tools/mcp-server.js",
+    "./tools/tool-adapter": "./dist/tools/tool-adapter.js",
+    "./types": "./dist/types.js",
     "./*": "./*"
   },
   "publishConfig": {
@@ -99,6 +101,13 @@
       "./tools/tool-adapter": "./dist/tools/tool-adapter.js",
       "./types": "./dist/types.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/ai-agent"
   }
 }