@cuylabs/agent-core 0.4.0 → 0.5.0

package/dist/types-VQgymC1N.d.ts

@@ -0,0 +1,156 @@
+import { Tool } 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.
+ */
+/**
+ * Stdio transport configuration for local MCP servers.
+ */
+interface StdioTransportConfig {
+    transport: "stdio";
+    /** Command to execute */
+    command: string;
+    /** Command arguments */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * HTTP transport configuration for remote MCP servers.
+ */
+interface HttpTransportConfig {
+    transport: "http";
+    /** Server URL */
+    url: string;
+    /** HTTP headers (e.g. Authorization) */
+    headers?: Record<string, string>;
+}
+/**
+ * SSE transport configuration for remote MCP servers.
+ */
+interface SseTransportConfig {
+    transport: "sse";
+    /** Server URL */
+    url: string;
+    /** HTTP headers (e.g. Authorization) */
+    headers?: Record<string, string>;
+}
+/**
+ * MCP server configuration.
+ */
+type MCPServerConfig = (StdioTransportConfig | HttpTransportConfig | SseTransportConfig) & {
+    /** Whether this server is enabled (default: true) */
+    enabled?: boolean;
+    /** Connection timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Human-readable name for the server */
+    name?: string;
+};
+/**
+ * MCP manager configuration - map of server name to config.
+ */
+type MCPConfig = Record<string, MCPServerConfig>;
+/**
+ * Server connection status.
+ */
+type MCPServerStatus = {
+    status: "disconnected";
+} | {
+    status: "connecting";
+} | {
+    status: "connected";
+    toolCount: number;
+} | {
+    status: "error";
+    error: string;
+} | {
+    status: "disabled";
+};
+/**
+ * MCP resource descriptor.
+ */
+interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    server: string;
+}
+/**
+ * MCP prompt descriptor.
+ */
+interface MCPPrompt {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+    server: string;
+}
+/**
+ * MCP manager - handles connections to multiple MCP servers.
+ */
+interface MCPManager {
+    /**
+     * Connect to all configured servers.
+     */
+    connect(): Promise<Map<string, MCPServerStatus>>;
+    /**
+     * Get all tools from connected servers, ready for AI SDK use.
+     */
+    getTools(): Promise<Record<string, Tool>>;
+    /**
+     * Get status of a specific server.
+     */
+    getStatus(serverName: string): MCPServerStatus;
+    /**
+     * Get status of all servers.
+     */
+    getAllStatus(): Map<string, MCPServerStatus>;
+    /**
+     * List available resources from all connected servers.
+     */
+    listResources(): Promise<MCPResource[]>;
+    /**
+     * Read a resource by URI.
+     */
+    readResource(uri: string): Promise<{
+        contents: Array<{
+            uri: string;
+            text?: string;
+            blob?: string;
+            mimeType?: string;
+        }>;
+    }>;
+    /**
+     * List available prompts from all connected servers.
+     */
+    listPrompts(): Promise<MCPPrompt[]>;
+    /**
+     * Get a prompt with optional arguments.
+     */
+    getPrompt(serverName: string, promptName: string, args?: Record<string, unknown>): Promise<{
+        description?: string;
+        messages: Array<{
+            role: string;
+            content: unknown;
+        }>;
+    }>;
+    /**
+     * Close all connections.
+     */
+    close(): Promise<void>;
+    /**
+     * Check whether any configured server is connected.
+     */
+    isConnected(): boolean;
+}
+
+export type { HttpTransportConfig as H, MCPConfig as M, SseTransportConfig as S, MCPManager as a, MCPPrompt as b, MCPResource as c, MCPServerConfig as d, MCPServerStatus as e, StdioTransportConfig as f };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cuylabs/agent-core",
-  "version": "0.4.0",
-  "description": "Embeddable AI agent infrastructure - streaming, sessions, resilience, capabilities",
+  "version": "0.5.0",
+  "description": "Embeddable AI agent infrastructure — execution, sessions, tools, skills, sub-agents, tracing",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,6 +15,66 @@
       "types": "./dist/tool/index.d.ts",
       "import": "./dist/tool/index.js",
       "default": "./dist/tool/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    },
+    "./tracking": {
+      "types": "./dist/tracking/index.d.ts",
+      "import": "./dist/tracking/index.js",
+      "default": "./dist/tracking/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js",
+      "default": "./dist/middleware/index.js"
+    },
+    "./prompt": {
+      "types": "./dist/prompt/index.d.ts",
+      "import": "./dist/prompt/index.js",
+      "default": "./dist/prompt/index.js"
+    },
+    "./skill": {
+      "types": "./dist/skill/index.d.ts",
+      "import": "./dist/skill/index.js",
+      "default": "./dist/skill/index.js"
+    },
+    "./sub-agent": {
+      "types": "./dist/sub-agent/index.d.ts",
+      "import": "./dist/sub-agent/index.js",
+      "default": "./dist/sub-agent/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js",
+      "default": "./dist/storage/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.js",
+      "default": "./dist/context/index.js"
+    },
+    "./reasoning": {
+      "types": "./dist/reasoning/index.d.ts",
+      "import": "./dist/reasoning/index.js",
+      "default": "./dist/reasoning/index.js"
+    },
+    "./capabilities": {
+      "types": "./dist/capabilities/index.d.ts",
+      "import": "./dist/capabilities/index.js",
+      "default": "./dist/capabilities/index.js"
+    },
+    "./models": {
+      "types": "./dist/models/index.d.ts",
+      "import": "./dist/models/index.js",
+      "default": "./dist/models/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js",
+      "default": "./dist/mcp/index.js"
     }
   },
   "files": [
@@ -33,6 +93,10 @@
     "@ai-sdk/openai": "^3.0.0",
     "@ai-sdk/openai-compatible": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/resources": "^2.0.0",
+    "@opentelemetry/sdk-trace-node": "^2.0.0",
+    "@opentelemetry/semantic-conventions": "^1.30.0",
     "dockerode": "^4.0.9"
   },
   "peerDependenciesMeta": {
@@ -56,16 +120,36 @@
     },
     "dockerode": {
       "optional": true
+    },
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "@opentelemetry/resources": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-trace-node": {
+      "optional": true
+    },
+    "@opentelemetry/semantic-conventions": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.35",
+    "@ai-sdk/google": "^3.0.30",
     "@ai-sdk/mcp": "^1.0.19",
     "@ai-sdk/openai": "^3.0.25",
-    "@ai-sdk/google": "^3.0.30",
     "@ai-sdk/openai-compatible": "^2.0.30",
     "@ai-sdk/provider-utils": "^4.0.15",
+    "@arizeai/openinference-vercel": "^2.7.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.213.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
+    "@opentelemetry/exporter-zipkin": "^2.6.0",
+    "@opentelemetry/resources": "^2.6.0",
+    "@opentelemetry/sdk-trace-node": "^2.6.0",
+    "@opentelemetry/semantic-conventions": "^1.40.0",
     "@types/dockerode": "^3.3.47",
     "@types/node": "^22.0.0",
     "dotenv": "^17.2.3",
@@ -95,8 +179,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/tool/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts src/tool/index.ts --format esm --dts --watch",
+    "build": "tsup src/index.ts src/tool/index.ts src/runtime/index.ts src/tracking/index.ts src/middleware/index.ts src/prompt/index.ts src/skill/index.ts src/sub-agent/index.ts src/storage/index.ts src/context/index.ts src/reasoning/index.ts src/capabilities/index.ts src/models/index.ts src/mcp/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/tool/index.ts src/runtime/index.ts src/tracking/index.ts src/middleware/index.ts src/prompt/index.ts src/skill/index.ts src/sub-agent/index.ts src/storage/index.ts src/context/index.ts src/reasoning/index.ts src/capabilities/index.ts src/models/index.ts src/mcp/index.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",