@backendkit-labs/agent-core 0.14.0

package/dist/index.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cwdToProjectKey = exports.DEFAULT_CONFIG = exports.loadFrameworkConfig = exports.runGlobalSeed = exports.migrateFromLegacy = exports.deriveProjectName = exports.buildWorkspaceContext = exports.setActiveProject = exports.deleteWorkspace = exports.removeProject = exports.importProject = exports.addProject = exports.createWorkspace = exports.saveWorkspaces = exports.loadWorkspaces = exports.compactSessionContent = exports.compactSession = exports.extractSessionFromCheckpoint = exports.getLatestCheckpoints = exports.readCheckpoint = exports.listCheckpoints = exports.createCheckpoint = exports.registerBuiltinCommands = exports.SlashCommandRegistry = exports.ObsidianProvider = exports.SkillsShProvider = exports.LocalProvider = exports.GitHubProvider = exports.skillToMd = exports.parseMdSkill = exports.SkillActivator = exports.SkillRegistry = exports.createSkillManager = exports.SkillManager = exports.SkillLoader = exports.z = exports.defineTool = exports.CallbackTransport = exports.StdoutTransport = exports.SessionMemory = exports.DelegationBus = exports.GLOBAL_LIMIT = exports.DEFAULT_BATCH_SIZE = exports.DEFAULT_MAX_ITERATIONS = exports.IterationManager = exports.createBaseEngine = exports.ProviderRegistry = exports.ToolRegistry = exports.AgentRegistry = exports.AgentEngine = void 0;
+exports.QAService = exports.BUILTIN_DOMAINS = exports.DomainRegistry = exports.ReflectionEngine = exports.projectAgentsDir = exports.globalAgentsDir = exports.loadAgentsFromDir = exports.RemoteAgentRegistry = exports.discoverAgents = exports.JsonFileStore = exports.InMemoryStore = exports.buildMemoryTools = exports.ProceduralMemory = exports.SemanticMemory = exports.EpisodicMemory = exports.createMemorySystem = exports.MemorySystem = exports.MODEL_PRICING = exports.Tracer = exports.MetricsCollector = exports.CostTracker = exports.ObservabilityManager = exports.TriggerManager = exports.EventBus = exports.createAutonomousAgent = exports.WorkflowRunner = exports.WorkflowBuilder = exports.agent = exports.workflow = exports.MCPClientManager = exports.adaptProviderToLLMClient = exports.Orchestrator = exports.ResilientLLMClient = exports.atomicWriteSync = exports.atomicWrite = exports.getProjectDir = exports.getFrameworkDir = void 0;
+// ── Engine ─────────────────────────────────────────────────────────────────────
+var AgentEngine_1 = require("./engine/AgentEngine");
+Object.defineProperty(exports, "AgentEngine", { enumerable: true, get: function () { return AgentEngine_1.AgentEngine; } });
+var AgentRegistry_1 = require("./engine/AgentRegistry");
+Object.defineProperty(exports, "AgentRegistry", { enumerable: true, get: function () { return AgentRegistry_1.AgentRegistry; } });
+var ToolRegistry_1 = require("./engine/ToolRegistry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return ToolRegistry_1.ToolRegistry; } });
+var ProviderRegistry_1 = require("./engine/ProviderRegistry");
+Object.defineProperty(exports, "ProviderRegistry", { enumerable: true, get: function () { return ProviderRegistry_1.ProviderRegistry; } });
+var createBaseEngine_1 = require("./engine/createBaseEngine");
+Object.defineProperty(exports, "createBaseEngine", { enumerable: true, get: function () { return createBaseEngine_1.createBaseEngine; } });
+var IterationManager_1 = require("./engine/IterationManager");
+Object.defineProperty(exports, "IterationManager", { enumerable: true, get: function () { return IterationManager_1.IterationManager; } });
+Object.defineProperty(exports, "DEFAULT_MAX_ITERATIONS", { enumerable: true, get: function () { return IterationManager_1.DEFAULT_MAX_ITERATIONS; } });
+Object.defineProperty(exports, "DEFAULT_BATCH_SIZE", { enumerable: true, get: function () { return IterationManager_1.DEFAULT_BATCH_SIZE; } });
+Object.defineProperty(exports, "GLOBAL_LIMIT", { enumerable: true, get: function () { return IterationManager_1.GLOBAL_LIMIT; } });
+// ── Delegation ─────────────────────────────────────────────────────────────────
+var DelegationBus_1 = require("./delegation/DelegationBus");
+Object.defineProperty(exports, "DelegationBus", { enumerable: true, get: function () { return DelegationBus_1.DelegationBus; } });
+// ── Memory (session) ───────────────────────────────────────────────────────────
+var SessionMemory_1 = require("./memory/SessionMemory");
+Object.defineProperty(exports, "SessionMemory", { enumerable: true, get: function () { return SessionMemory_1.SessionMemory; } });
+var StdoutTransport_1 = require("./transport/StdoutTransport");
+Object.defineProperty(exports, "StdoutTransport", { enumerable: true, get: function () { return StdoutTransport_1.StdoutTransport; } });
+var CallbackTransport_1 = require("./transport/CallbackTransport");
+Object.defineProperty(exports, "CallbackTransport", { enumerable: true, get: function () { return CallbackTransport_1.CallbackTransport; } });
+// ── Typed tools ────────────────────────────────────────────────────────────────
+var defineTool_1 = require("./tools/defineTool");
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return defineTool_1.defineTool; } });
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return defineTool_1.z; } });
+// ── Skills ─────────────────────────────────────────────────────────────────────
+var loader_1 = require("./skills/loader");
+Object.defineProperty(exports, "SkillLoader", { enumerable: true, get: function () { return loader_1.SkillLoader; } });
+var manager_1 = require("./skills/manager");
+Object.defineProperty(exports, "SkillManager", { enumerable: true, get: function () { return manager_1.SkillManager; } });
+Object.defineProperty(exports, "createSkillManager", { enumerable: true, get: function () { return manager_1.createSkillManager; } });
+var registry_1 = require("./skills/registry");
+Object.defineProperty(exports, "SkillRegistry", { enumerable: true, get: function () { return registry_1.SkillRegistry; } });
+var activator_1 = require("./skills/activator");
+Object.defineProperty(exports, "SkillActivator", { enumerable: true, get: function () { return activator_1.SkillActivator; } });
+var parse_md_skill_1 = require("./skills/parse-md-skill");
+Object.defineProperty(exports, "parseMdSkill", { enumerable: true, get: function () { return parse_md_skill_1.parseMdSkill; } });
+Object.defineProperty(exports, "skillToMd", { enumerable: true, get: function () { return parse_md_skill_1.skillToMd; } });
+var providers_1 = require("./skills/providers");
+Object.defineProperty(exports, "GitHubProvider", { enumerable: true, get: function () { return providers_1.GitHubProvider; } });
+Object.defineProperty(exports, "LocalProvider", { enumerable: true, get: function () { return providers_1.LocalProvider; } });
+Object.defineProperty(exports, "SkillsShProvider", { enumerable: true, get: function () { return providers_1.SkillsShProvider; } });
+Object.defineProperty(exports, "ObsidianProvider", { enumerable: true, get: function () { return providers_1.ObsidianProvider; } });
+// ── Slash commands ─────────────────────────────────────────────────────────────
+var SlashCommandRegistry_1 = require("./commands/SlashCommandRegistry");
+Object.defineProperty(exports, "SlashCommandRegistry", { enumerable: true, get: function () { return SlashCommandRegistry_1.SlashCommandRegistry; } });
+var builtin_1 = require("./commands/builtin");
+Object.defineProperty(exports, "registerBuiltinCommands", { enumerable: true, get: function () { return builtin_1.registerBuiltinCommands; } });
+// ── Checkpoint ─────────────────────────────────────────────────────────────────
+var checkpoint_1 = require("./checkpoint");
+Object.defineProperty(exports, "createCheckpoint", { enumerable: true, get: function () { return checkpoint_1.createCheckpoint; } });
+Object.defineProperty(exports, "listCheckpoints", { enumerable: true, get: function () { return checkpoint_1.listCheckpoints; } });
+Object.defineProperty(exports, "readCheckpoint", { enumerable: true, get: function () { return checkpoint_1.readCheckpoint; } });
+Object.defineProperty(exports, "getLatestCheckpoints", { enumerable: true, get: function () { return checkpoint_1.getLatestCheckpoints; } });
+Object.defineProperty(exports, "extractSessionFromCheckpoint", { enumerable: true, get: function () { return checkpoint_1.extractSessionFromCheckpoint; } });
+Object.defineProperty(exports, "compactSession", { enumerable: true, get: function () { return checkpoint_1.compactSession; } });
+Object.defineProperty(exports, "compactSessionContent", { enumerable: true, get: function () { return checkpoint_1.compactSessionContent; } });
+// ── Workspace ──────────────────────────────────────────────────────────────────
+var workspace_1 = require("./workspace");
+Object.defineProperty(exports, "loadWorkspaces", { enumerable: true, get: function () { return workspace_1.loadWorkspaces; } });
+Object.defineProperty(exports, "saveWorkspaces", { enumerable: true, get: function () { return workspace_1.saveWorkspaces; } });
+Object.defineProperty(exports, "createWorkspace", { enumerable: true, get: function () { return workspace_1.createWorkspace; } });
+Object.defineProperty(exports, "addProject", { enumerable: true, get: function () { return workspace_1.addProject; } });
+Object.defineProperty(exports, "importProject", { enumerable: true, get: function () { return workspace_1.importProject; } });
+Object.defineProperty(exports, "removeProject", { enumerable: true, get: function () { return workspace_1.removeProject; } });
+Object.defineProperty(exports, "deleteWorkspace", { enumerable: true, get: function () { return workspace_1.deleteWorkspace; } });
+Object.defineProperty(exports, "setActiveProject", { enumerable: true, get: function () { return workspace_1.setActiveProject; } });
+Object.defineProperty(exports, "buildWorkspaceContext", { enumerable: true, get: function () { return workspace_1.buildWorkspaceContext; } });
+Object.defineProperty(exports, "deriveProjectName", { enumerable: true, get: function () { return workspace_1.deriveProjectName; } });
+Object.defineProperty(exports, "migrateFromLegacy", { enumerable: true, get: function () { return workspace_1.migrateFromLegacy; } });
+// ── Bootstrap ──────────────────────────────────────────────────────────────────
+var GlobalSeed_1 = require("./bootstrap/GlobalSeed");
+Object.defineProperty(exports, "runGlobalSeed", { enumerable: true, get: function () { return GlobalSeed_1.runGlobalSeed; } });
+var config_1 = require("./bootstrap/config");
+Object.defineProperty(exports, "loadFrameworkConfig", { enumerable: true, get: function () { return config_1.loadFrameworkConfig; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_1.DEFAULT_CONFIG; } });
+// ── Shared utils ───────────────────────────────────────────────────────────────
+var project_key_1 = require("./shared/utils/project-key");
+Object.defineProperty(exports, "cwdToProjectKey", { enumerable: true, get: function () { return project_key_1.cwdToProjectKey; } });
+Object.defineProperty(exports, "getFrameworkDir", { enumerable: true, get: function () { return project_key_1.getFrameworkDir; } });
+Object.defineProperty(exports, "getProjectDir", { enumerable: true, get: function () { return project_key_1.getProjectDir; } });
+var atomic_write_1 = require("./shared/utils/atomic-write");
+Object.defineProperty(exports, "atomicWrite", { enumerable: true, get: function () { return atomic_write_1.atomicWrite; } });
+Object.defineProperty(exports, "atomicWriteSync", { enumerable: true, get: function () { return atomic_write_1.atomicWriteSync; } });
+var resilient_client_1 = require("./shared/llm/resilient-client");
+Object.defineProperty(exports, "ResilientLLMClient", { enumerable: true, get: function () { return resilient_client_1.ResilientLLMClient; } });
+// ── Orchestration — public surface used by createBaseEngine / createCodingEngine ─
+var orchestrator_1 = require("./orchestration/orchestrator");
+Object.defineProperty(exports, "Orchestrator", { enumerable: true, get: function () { return orchestrator_1.Orchestrator; } });
+var llm_client_adapter_1 = require("./orchestration/llm-client-adapter");
+Object.defineProperty(exports, "adaptProviderToLLMClient", { enumerable: true, get: function () { return llm_client_adapter_1.adaptProviderToLLMClient; } });
+// ── MCP client — MCPClientManager in AgentEngineOptions, MCPServerConfig in coding config ─
+var MCPClientManager_1 = require("./mcp/MCPClientManager");
+Object.defineProperty(exports, "MCPClientManager", { enumerable: true, get: function () { return MCPClientManager_1.MCPClientManager; } });
+// ── Workflow — WorkflowBuilder/Def in AgentEngine.runWorkflow public API ────────
+var WorkflowBuilder_1 = require("./workflow/WorkflowBuilder");
+Object.defineProperty(exports, "workflow", { enumerable: true, get: function () { return WorkflowBuilder_1.workflow; } });
+Object.defineProperty(exports, "agent", { enumerable: true, get: function () { return WorkflowBuilder_1.agent; } });
+Object.defineProperty(exports, "WorkflowBuilder", { enumerable: true, get: function () { return WorkflowBuilder_1.WorkflowBuilder; } });
+var WorkflowRunner_1 = require("./workflow/WorkflowRunner");
+Object.defineProperty(exports, "WorkflowRunner", { enumerable: true, get: function () { return WorkflowRunner_1.WorkflowRunner; } });
+// ── Triggers — createAutonomousAgent is a standalone public utility ────────────
+var createAutonomousAgent_1 = require("./triggers/createAutonomousAgent");
+Object.defineProperty(exports, "createAutonomousAgent", { enumerable: true, get: function () { return createAutonomousAgent_1.createAutonomousAgent; } });
+var EventBus_1 = require("./triggers/EventBus");
+Object.defineProperty(exports, "EventBus", { enumerable: true, get: function () { return EventBus_1.EventBus; } });
+var TriggerManager_1 = require("./triggers/TriggerManager");
+Object.defineProperty(exports, "TriggerManager", { enumerable: true, get: function () { return TriggerManager_1.TriggerManager; } });
+// ── Observability — ObservabilityManager in AgentEngineOptions ─────────────────
+var ObservabilityManager_1 = require("./observability/ObservabilityManager");
+Object.defineProperty(exports, "ObservabilityManager", { enumerable: true, get: function () { return ObservabilityManager_1.ObservabilityManager; } });
+var CostTracker_1 = require("./observability/CostTracker");
+Object.defineProperty(exports, "CostTracker", { enumerable: true, get: function () { return CostTracker_1.CostTracker; } });
+var MetricsCollector_1 = require("./observability/MetricsCollector");
+Object.defineProperty(exports, "MetricsCollector", { enumerable: true, get: function () { return MetricsCollector_1.MetricsCollector; } });
+var Tracer_1 = require("./observability/Tracer");
+Object.defineProperty(exports, "Tracer", { enumerable: true, get: function () { return Tracer_1.Tracer; } });
+var types_1 = require("./observability/types");
+Object.defineProperty(exports, "MODEL_PRICING", { enumerable: true, get: function () { return types_1.MODEL_PRICING; } });
+// ── Advanced memory — MemorySystem in AgentEngineOptions, createMemorySystem in coding ─
+var MemorySystem_1 = require("./agent-memory/MemorySystem");
+Object.defineProperty(exports, "MemorySystem", { enumerable: true, get: function () { return MemorySystem_1.MemorySystem; } });
+Object.defineProperty(exports, "createMemorySystem", { enumerable: true, get: function () { return MemorySystem_1.createMemorySystem; } });
+var EpisodicMemory_1 = require("./agent-memory/EpisodicMemory");
+Object.defineProperty(exports, "EpisodicMemory", { enumerable: true, get: function () { return EpisodicMemory_1.EpisodicMemory; } });
+var SemanticMemory_1 = require("./agent-memory/SemanticMemory");
+Object.defineProperty(exports, "SemanticMemory", { enumerable: true, get: function () { return SemanticMemory_1.SemanticMemory; } });
+var ProceduralMemory_1 = require("./agent-memory/ProceduralMemory");
+Object.defineProperty(exports, "ProceduralMemory", { enumerable: true, get: function () { return ProceduralMemory_1.ProceduralMemory; } });
+var tools_1 = require("./agent-memory/tools");
+Object.defineProperty(exports, "buildMemoryTools", { enumerable: true, get: function () { return tools_1.buildMemoryTools; } });
+var InMemoryStore_1 = require("./agent-memory/stores/InMemoryStore");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return InMemoryStore_1.InMemoryStore; } });
+var JsonFileStore_1 = require("./agent-memory/stores/JsonFileStore");
+Object.defineProperty(exports, "JsonFileStore", { enumerable: true, get: function () { return JsonFileStore_1.JsonFileStore; } });
+// ── Agent discovery — loadAgents callback in AgentEngineOptions ────────────────
+var discoverAgents_1 = require("./agent-discovery/discoverAgents");
+Object.defineProperty(exports, "discoverAgents", { enumerable: true, get: function () { return discoverAgents_1.discoverAgents; } });
+var RemoteAgentRegistry_1 = require("./agent-discovery/RemoteAgentRegistry");
+Object.defineProperty(exports, "RemoteAgentRegistry", { enumerable: true, get: function () { return RemoteAgentRegistry_1.RemoteAgentRegistry; } });
+var AgentPackageLoader_1 = require("./agent-discovery/AgentPackageLoader");
+Object.defineProperty(exports, "loadAgentsFromDir", { enumerable: true, get: function () { return AgentPackageLoader_1.loadAgentsFromDir; } });
+Object.defineProperty(exports, "globalAgentsDir", { enumerable: true, get: function () { return AgentPackageLoader_1.globalAgentsDir; } });
+Object.defineProperty(exports, "projectAgentsDir", { enumerable: true, get: function () { return AgentPackageLoader_1.projectAgentsDir; } });
+// ── Reflection — ReflectionEngine used by createCodingEngine ──────────────────
+var reflection_engine_1 = require("./reflection/reflection-engine");
+Object.defineProperty(exports, "ReflectionEngine", { enumerable: true, get: function () { return reflection_engine_1.ReflectionEngine; } });
+var domain_registry_1 = require("./reflection/domain-registry");
+Object.defineProperty(exports, "DomainRegistry", { enumerable: true, get: function () { return domain_registry_1.DomainRegistry; } });
+Object.defineProperty(exports, "BUILTIN_DOMAINS", { enumerable: true, get: function () { return domain_registry_1.BUILTIN_DOMAINS; } });
+// ── QA — QAService used by createBaseEngine ────────────────────────────────────
+var qa_service_1 = require("./qa/qa-service");
+Object.defineProperty(exports, "QAService", { enumerable: true, get: function () { return qa_service_1.QAService; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/MCPClientManager.d.ts

@@ -0,0 +1,65 @@
+import type { ToolDefinition } from '../types';
+import type { MCPServerConfig } from './types';
+/**
+ * Manages connections to multiple MCP servers and exposes their tools as
+ * framework ToolDefinitions.
+ *
+ * Supports two connection modes:
+ * - **Stdio** — spawns a local subprocess (command + args)
+ * - **Remote** — connects over HTTP using StreamableHTTP with automatic SSE
+ *   fallback for legacy servers (url field)
+ *
+ * Per-server state is tracked independently so a failed server doesn't block
+ * others. Call reconnectFailed() to retry only the servers that are offline.
+ *
+ * Tool names are namespaced as `mcp__{safeName}__{originalToolName}` where
+ * safeName replaces non-alphanumeric/dash/underscore characters with `_`.
+ */
+export declare class MCPClientManager {
+    private readonly configs;
+    private servers;
+    private serverStates;
+    private initialized;
+    private initPromise;
+    constructor(configs: MCPServerConfig[]);
+    /**
+     * Establishes connections to all configured MCP servers.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     * Individual server failures do not block others.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Retries only servers that previously failed or never connected.
+     * Call this on subsequent engine.run() to reconnect offline agents.
+     */
+    reconnectFailed(): Promise<void>;
+    /** All tools from all connected servers. */
+    getTools(): ToolDefinition[];
+    /** Tools for a specific connected server (empty if not connected). */
+    getServerTools(serverName: string): ToolDefinition[];
+    /** Config for a server by name. */
+    getConfig(serverName: string): MCPServerConfig | undefined;
+    /** Names of all configured servers regardless of connection state. */
+    getConfiguredNames(): string[];
+    /** Whether a server is currently connected. */
+    isConnected(serverName: string): boolean;
+    /** Diagnostic summary of connected servers. */
+    getServerInfo(): Array<{
+        name: string;
+        transportUsed: string;
+        toolCount: number;
+    }>;
+    /** Disconnects all MCP servers. */
+    disconnect(): Promise<void>;
+    private connectAll;
+    private connectOne;
+    private connectStdio;
+    private connectRemote;
+    private connectStreamableHTTP;
+    private connectSSE;
+    private buildClient;
+    private discoverTools;
+    private isHTTP4xx;
+    private wrapTool;
+}
+//# sourceMappingURL=MCPClientManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MCPClientManager.d.ts","sourceRoot":"","sources":["../../src/mcp/MCPClientManager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAW/C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAMb,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8B;gBAEpB,OAAO,EAAE,eAAe,EAAE;IAMvD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAStC,4CAA4C;IAC5C,QAAQ,IAAI,cAAc,EAAE;IAI5B,sEAAsE;IACtE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAIpD,mCAAmC;IACnC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D,sEAAsE;IACtE,kBAAkB,IAAI,MAAM,EAAE;IAI9B,+CAA+C;IAC/C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC,+CAA+C;IAC/C,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAQlF,mCAAmC;IAC7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAcnB,UAAU;YAkBV,UAAU;YAYV,YAAY;YAYZ,aAAa;YAoBb,qBAAqB;YAYrB,UAAU;IAYxB,OAAO,CAAC,WAAW;YAOL,aAAa;IAQ3B,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,QAAQ;CAsCnB"}

package/dist/mcp/MCPClientManager.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPClientManager = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const sse_js_1 = require("@modelcontextprotocol/sdk/client/sse.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+/**
+ * Manages connections to multiple MCP servers and exposes their tools as
+ * framework ToolDefinitions.
+ *
+ * Supports two connection modes:
+ * - **Stdio** — spawns a local subprocess (command + args)
+ * - **Remote** — connects over HTTP using StreamableHTTP with automatic SSE
+ *   fallback for legacy servers (url field)
+ *
+ * Per-server state is tracked independently so a failed server doesn't block
+ * others. Call reconnectFailed() to retry only the servers that are offline.
+ *
+ * Tool names are namespaced as `mcp__{safeName}__{originalToolName}` where
+ * safeName replaces non-alphanumeric/dash/underscore characters with `_`.
+ */
+class MCPClientManager {
+    configs;
+    servers = [];
+    serverStates = new Map();
+    initialized = false;
+    initPromise = null;
+    constructor(configs) {
+        this.configs = configs;
+        for (const cfg of configs) {
+            this.serverStates.set(cfg.name, 'pending');
+        }
+    }
+    /**
+     * Establishes connections to all configured MCP servers.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     * Individual server failures do not block others.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this.connectAll(this.configs);
+        await this.initPromise;
+        this.initialized = true;
+    }
+    /**
+     * Retries only servers that previously failed or never connected.
+     * Call this on subsequent engine.run() to reconnect offline agents.
+     */
+    async reconnectFailed() {
+        const failedConfigs = this.configs.filter(c => this.serverStates.get(c.name) !== 'connected');
+        if (failedConfigs.length > 0) {
+            await this.connectAll(failedConfigs);
+        }
+    }
+    /** All tools from all connected servers. */
+    getTools() {
+        return this.servers.flatMap(s => s.tools);
+    }
+    /** Tools for a specific connected server (empty if not connected). */
+    getServerTools(serverName) {
+        return this.servers.find(s => s.config.name === serverName)?.tools ?? [];
+    }
+    /** Config for a server by name. */
+    getConfig(serverName) {
+        return this.configs.find(c => c.name === serverName);
+    }
+    /** Names of all configured servers regardless of connection state. */
+    getConfiguredNames() {
+        return this.configs.map(c => c.name);
+    }
+    /** Whether a server is currently connected. */
+    isConnected(serverName) {
+        return this.serverStates.get(serverName) === 'connected';
+    }
+    /** Diagnostic summary of connected servers. */
+    getServerInfo() {
+        return this.servers.map(s => ({
+            name: s.config.name,
+            transportUsed: s.transportUsed,
+            toolCount: s.tools.length,
+        }));
+    }
+    /** Disconnects all MCP servers. */
+    async disconnect() {
+        await Promise.allSettled(this.servers.map(s => s.client.close().catch(() => undefined)));
+        this.servers = [];
+        for (const name of this.serverStates.keys()) {
+            this.serverStates.set(name, 'pending');
+        }
+        this.initialized = false;
+        this.initPromise = null;
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    async connectAll(configs) {
+        const results = await Promise.allSettled(configs.map(cfg => this.connectOne(cfg)));
+        for (let i = 0; i < results.length; i++) {
+            const name = configs[i]?.name ?? `server-${i}`;
+            if (results[i].status === 'rejected') {
+                this.serverStates.set(name, 'failed');
+                console.warn(`[MCPClientManager] Failed to connect to "${name}": ` +
+                    `${results[i].reason}`);
+            }
+            else {
+                this.serverStates.set(name, 'connected');
+            }
+        }
+    }
+    async connectOne(config) {
+        if (config.url) {
+            await this.connectRemote(config);
+        }
+        else if (config.command) {
+            await this.connectStdio(config);
+        }
+        else {
+            throw new Error(`MCPServerConfig "${config.name}" requires either "url" (remote) or "command" (stdio)`);
+        }
+    }
+    async connectStdio(config) {
+        const transport = new stdio_js_1.StdioClientTransport({
+            command: config.command,
+            args: config.args ?? [],
+            env: { ...process.env, ...(config.env ?? {}) },
+        });
+        const client = this.buildClient();
+        await client.connect(transport);
+        const tools = await this.discoverTools(config, client);
+        this.servers.push({ config, client, tools, transportUsed: 'stdio' });
+    }
+    async connectRemote(config) {
+        const url = new URL(config.url);
+        const reqInit = config.headers ? { headers: config.headers } : undefined;
+        if (config.remoteTransport === 'sse') {
+            await this.connectSSE(config, url, reqInit);
+            return;
+        }
+        try {
+            await this.connectStreamableHTTP(config, url, reqInit);
+        }
+        catch (err) {
+            if (config.remoteTransport === 'streamable-http' || !this.isHTTP4xx(err))
+                throw err;
+            console.warn(`[MCPClientManager] "${config.name}": StreamableHTTP failed ` +
+                `(${err.message}), falling back to SSE`);
+            await this.connectSSE(config, url, reqInit);
+        }
+    }
+    async connectStreamableHTTP(config, url, reqInit) {
+        const transport = new streamableHttp_js_1.StreamableHTTPClientTransport(url, { requestInit: reqInit });
+        const client = this.buildClient();
+        await client.connect(transport);
+        const tools = await this.discoverTools(config, client);
+        this.servers.push({ config, client, tools, transportUsed: 'streamable-http' });
+    }
+    async connectSSE(config, url, reqInit) {
+        const transport = new sse_js_1.SSEClientTransport(url, { requestInit: reqInit });
+        const client = this.buildClient();
+        await client.connect(transport);
+        const tools = await this.discoverTools(config, client);
+        this.servers.push({ config, client, tools, transportUsed: 'sse' });
+    }
+    buildClient() {
+        return new index_js_1.Client({ name: 'bk-agent-framework', version: '1.0.0' }, { capabilities: {} });
+    }
+    async discoverTools(config, client) {
+        const listResult = await client.listTools();
+        return listResult.tools.map(t => this.wrapTool(config, client, t));
+    }
+    isHTTP4xx(err) {
+        if (!err || typeof err !== 'object')
+            return false;
+        const code = err.code;
+        if (typeof code === 'number' && code >= 400 && code < 500)
+            return true;
+        return /4\d{2}/.test(err.message ?? '');
+    }
+    wrapTool(config, client, mcpTool) {
+        // Function names must match ^[a-zA-Z0-9_-]+$ — replace ':' and use '__' as separator
+        const safeName = config.name.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const namespacedName = `mcp__${safeName}__${mcpTool.name}`;
+        const timeoutMs = config.timeoutMs ?? 30_000;
+        return {
+            name: namespacedName,
+            description: mcpTool.description
+                ? `[MCP:${config.name}] ${mcpTool.description}`
+                : `[MCP:${config.name}] ${mcpTool.name}`,
+            parameters: mcpTool.inputSchema ?? {
+                type: 'object',
+                properties: {},
+            },
+            execute: async (args) => {
+                const timer = new Promise((_, reject) => setTimeout(() => reject(new Error(`MCP tool "${namespacedName}" timed out after ${timeoutMs}ms`)), timeoutMs));
+                const call = client.callTool({
+                    name: mcpTool.name,
+                    arguments: args,
+                });
+                const result = await Promise.race([call, timer]);
+                const textParts = result.content
+                    .filter(b => b.type === 'text' && b.text)
+                    .map(b => b.text);
+                return textParts.length > 0 ? textParts.join('\n') : JSON.stringify(result.content);
+            },
+        };
+    }
+}
+exports.MCPClientManager = MCPClientManager;
+//# sourceMappingURL=MCPClientManager.js.map

package/dist/mcp/MCPClientManager.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+export { MCPClientManager } from './MCPClientManager';
+export type { MCPServerConfig } from './types';
+//# 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,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPClientManager = void 0;
+var MCPClientManager_1 = require("./MCPClientManager");
+Object.defineProperty(exports, "MCPClientManager", { enumerable: true, get: function () { return MCPClientManager_1.MCPClientManager; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;AAAA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Configuration for a single MCP server connection.
+ *
+ * Two modes are supported:
+ *
+ * **Stdio** — spawns a local subprocess:
+ * ```json
+ * { "name": "github", "command": "npx", "args": ["@modelcontextprotocol/server-github"],
+ *   "env": { "GITHUB_TOKEN": "ghp_..." } }
+ * ```
+ *
+ * **Remote** — connects over HTTP (StreamableHTTP with SSE fallback):
+ * ```json
+ * { "name": "my-service", "url": "https://mcp.myservice.com/v1",
+ *   "headers": { "Authorization": "Bearer tok_..." } }
+ * ```
+ *
+ * When both `url` and `command` are provided, `url` (remote) takes priority.
+ */
+export interface MCPServerConfig {
+    /** Human-readable identifier — used to namespace tool names: mcp__{safeName}__{tool} */
+    name: string;
+    /** Executable to spawn (e.g. 'node', 'npx', 'python'). Required for stdio mode. */
+    command?: string;
+    /** Arguments passed to the command. */
+    args?: string[];
+    /** Extra environment variables merged with process.env. */
+    env?: Record<string, string>;
+    /**
+     * HTTP endpoint of the remote MCP server.
+     * When set, the client connects via StreamableHTTP with automatic SSE fallback.
+     */
+    url?: string;
+    /**
+     * HTTP headers sent on every request (e.g. Authorization, API keys).
+     * Values are passed as-is — merge secrets from environment variables before
+     * building the config.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Force a specific remote transport instead of using auto-detection.
+     * - `'streamable-http'` — MCP Streamable HTTP (current spec, default)
+     * - `'sse'`             — legacy SSE transport (deprecated, pre-2025 servers)
+     *
+     * When omitted the client tries Streamable HTTP first and falls back to SSE
+     * automatically if the server returns 4xx on the initial request.
+     */
+    remoteTransport?: 'streamable-http' | 'sse';
+    /** Timeout for individual tool calls in ms. Default: 30 000 */
+    timeoutMs?: number;
+    /** Display name for the auto-generated agent entry. Default: title-cased server name. */
+    agentName?: string;
+    /** Description shown in the agent roster and used by the orchestrator to decide routing. */
+    agentDescription?: string;
+    /** Icon for the agent entry. Default: ◎ */
+    icon?: string;
+    /**
+     * How the MCP server is integrated into the agent system.
+     *
+     * **'tools'** (default) — The MCP tools are registered directly in the
+     * ToolRegistry and assigned to the agents listed in `assignTo`. No wrapper
+     * agent is created. The specialist that already has project context composes
+     * the external capability inline — one LLM hop, full project awareness.
+     * Use this for: APIs, databases, side-effect services (GitHub, Postgres, Slack).
+     *
+     * **'agent'** — A wrapper agent is created in the roster and the orchestrator
+     * can delegate to it via ask_agent. Use only when the remote service has its
+     * own reasoning layer (e.g. a deep-research service, a specialist from another
+     * org) or when the tool output is so large it needs its own summarization turn.
+     *
+     * @default 'tools'
+     */
+    mode?: 'tools' | 'agent';
+    /**
+     * When mode='tools': which local agent IDs receive these MCP tools in their
+     * allowedTools list. The tools become callable by those agents during execution.
+     *
+     * When omitted or empty: tools are assigned to ALL registered agents.
+     *
+     * Has no effect when mode='agent'.
+     *
+     * @example
+     * assignTo: ['backend', 'data']    // only backend and data can use these tools
+     * assignTo: ['*']                  // same as omitting — all agents
+     */
+    assignTo?: string[];
+    /**
+     * Shell binaries to block on agents in assignTo while this MCP server is
+     * connected. Forces those agents to use the MCP tools instead of equivalent
+     * shell commands. Automatically unblocked when the server disconnects or is
+     * removed — agents fall back to the shell commands transparently.
+     *
+     * Has no effect when mode='agent'.
+     *
+     * @example
+     * blocksCommands: ['docker', 'docker-compose']
+     * // data and backend cannot run docker directly — they must use pg_create
+     */
+    blocksCommands?: string[];
+    /**
+     * Keywords that trigger direct routing to this MCP server, bypassing the
+     * orchestrator entirely. In mode='agent' routes to the wrapper agent's LLM
+     * session. In mode='tools' has no effect (use toolTriggers for direct calls).
+     *
+     * @example
+     * triggers: ["deploy now", "rollback"]
+     */
+    triggers?: string[];
+    /**
+     * Maps keywords to specific tool names on this MCP server. When a keyword
+     * matches the user input, the corresponding tool is executed directly —
+     * zero LLM calls. Works in both modes.
+     *
+     * Tool name must match the short name (without the mcp__{server}__ prefix).
+     *
+     * @example
+     * toolTriggers: { "explicame": "explain", "review this": "review" }
+     */
+    toolTriggers?: Record<string, string>;
+}
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC5B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IAIb,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI7B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC;IAI5C,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAId;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAEzB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAI1B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC"}

package/dist/mcp/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":""}