@orion-agents/orion-code 0.1.9 → 0.2.2

package/dist/runtime/mcp/first-party-mcp-config.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirstPartyMcpConfigurationError = void 0;
+exports.loadFirstPartyMcpConfigurationV1 = loadFirstPartyMcpConfigurationV1;
+const fs_1 = require("fs");
+const paths_1 = require("../../product/paths");
+const MAX_MCP_CONFIG_BYTES = 1024 * 1024;
+/** A sanitized, fail-closed error for an invalid local MCP configuration. */
+class FirstPartyMcpConfigurationError extends Error {
+    constructor(code, message, configPath) {
+        super(message);
+        this.name = 'FirstPartyMcpConfigurationError';
+        this.code = code;
+        this.configPath = configPath;
+    }
+}
+exports.FirstPartyMcpConfigurationError = FirstPartyMcpConfigurationError;
+/**
+ * Read the legacy-compatible MCP envelope without starting a server or exposing
+ * command lines, headers, or environment values to diagnostics/model context.
+ */
+function loadFirstPartyMcpConfigurationV1(configPath = (0, paths_1.getMcpConfigPath)()) {
+    if (!(0, fs_1.existsSync)(configPath))
+        return Object.freeze({});
+    let stat;
+    try {
+        stat = (0, fs_1.statSync)(configPath);
+    }
+    catch {
+        throw invalid('ORION_MCP_CONFIG_UNREADABLE', 'MCP configuration cannot be read.', configPath);
+    }
+    if (!stat.isFile() || stat.size > MAX_MCP_CONFIG_BYTES) {
+        throw invalid('ORION_MCP_CONFIG_INVALID_FILE', `MCP configuration must be a regular file no larger than ${MAX_MCP_CONFIG_BYTES} bytes.`, configPath);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(configPath, 'utf8'));
+    }
+    catch {
+        throw invalid('ORION_MCP_CONFIG_INVALID_JSON', 'MCP configuration is not valid JSON.', configPath);
+    }
+    if (!isRecord(parsed)) {
+        throw invalid('ORION_MCP_CONFIG_INVALID_ROOT', 'MCP configuration root must be an object.', configPath);
+    }
+    const direct = parseServerEnvelope(parsed.mcpServers, 'mcpServers', configPath);
+    const compatible = parseServerEnvelope(parsed.servers, 'servers', configPath);
+    const orion = parsed.orion;
+    let nested;
+    if (orion !== undefined) {
+        if (!isRecord(orion)) {
+            throw invalid('ORION_MCP_CONFIG_INVALID_ROOT', 'MCP "orion" must be an object.', configPath);
+        }
+        if (orion.mcp !== undefined) {
+            if (!isRecord(orion.mcp)) {
+                throw invalid('ORION_MCP_CONFIG_INVALID_ROOT', 'MCP "orion.mcp" must be an object.', configPath);
+            }
+            nested = parseServerEnvelope(orion.mcp.servers, 'orion.mcp.servers', configPath);
+        }
+    }
+    return Object.freeze({
+        ...(direct ? { mcpServers: direct } : {}),
+        ...(compatible ? { servers: compatible } : {}),
+        ...(nested ? { orion: { mcp: { servers: nested } } } : {}),
+    });
+}
+function parseServerEnvelope(value, label, configPath) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw invalid('ORION_MCP_CONFIG_INVALID_SERVERS', `MCP "${label}" must be an object keyed by server id.`, configPath);
+    }
+    return Object.freeze(Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([serverId, server]) => [serverId, parseServer(server, serverId, configPath)])));
+}
+function parseServer(value, serverId, configPath) {
+    if (!serverId.trim() || !isRecord(value)) {
+        throw invalid('ORION_MCP_CONFIG_INVALID_SERVER', `MCP server "${serverId || '<empty>'}" must be an object.`, configPath);
+    }
+    const server = {
+        ...optionalText(value, 'type', serverId, configPath),
+        ...optionalText(value, 'command', serverId, configPath),
+        ...optionalText(value, 'cwd', serverId, configPath),
+        ...optionalText(value, 'url', serverId, configPath),
+        ...optionalText(value, 'name', serverId, configPath),
+        ...optionalText(value, 'description', serverId, configPath),
+        ...optionalBoolean(value, 'disabled', serverId, configPath),
+        ...optionalBoolean(value, 'enabled', serverId, configPath),
+        ...optionalStringArray(value, 'args', serverId, configPath),
+        ...optionalStringArray(value, 'tags', serverId, configPath),
+        ...optionalStringRecord(value, 'env', serverId, configPath),
+        ...optionalStringRecord(value, 'headers', serverId, configPath),
+    };
+    return Object.freeze(server);
+}
+function optionalText(source, key, serverId, configPath) {
+    const value = source[key];
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'string')
+        throw invalidField(serverId, key, 'a string', configPath);
+    return { [key]: value };
+}
+function optionalBoolean(source, key, serverId, configPath) {
+    const value = source[key];
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'boolean')
+        throw invalidField(serverId, key, 'a boolean', configPath);
+    return { [key]: value };
+}
+function optionalStringArray(source, key, serverId, configPath) {
+    const value = source[key];
+    if (value === undefined)
+        return {};
+    if (!Array.isArray(value) || !value.every(item => typeof item === 'string')) {
+        throw invalidField(serverId, key, 'an array of strings', configPath);
+    }
+    return { [key]: Object.freeze([...value]) };
+}
+function optionalStringRecord(source, key, serverId, configPath) {
+    const value = source[key];
+    if (value === undefined)
+        return {};
+    if (!isRecord(value) || !Object.values(value).every(item => typeof item === 'string')) {
+        throw invalidField(serverId, key, 'an object with string values', configPath);
+    }
+    return { [key]: Object.freeze({ ...value }) };
+}
+function invalidField(serverId, field, expected, configPath) {
+    return invalid('ORION_MCP_CONFIG_INVALID_FIELD', `MCP server "${serverId}" field "${field}" must be ${expected}.`, configPath);
+}
+function invalid(code, message, configPath) {
+    return new FirstPartyMcpConfigurationError(code, `${message} (${configPath})`, configPath);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=first-party-mcp-config.js.map

package/dist/runtime/mcp/first-party-mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-party-mcp-config.js","sourceRoot":"","sources":["../../../src/runtime/mcp/first-party-mcp-config.ts"],"names":[],"mappings":";;;AA4BA,4EA6DC;AAzFD,2BAAwD;AACxD,+CAAuD;AAMvD,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;AAIzC,6EAA6E;AAC7E,MAAa,+BAAgC,SAAQ,KAAK;IAIxD,YAAY,IAAY,EAAE,OAAe,EAAE,UAAkB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAVD,0EAUC;AAED;;;GAGG;AACH,SAAgB,gCAAgC,CAC9C,UAAU,GAAG,IAAA,wBAAgB,GAAE;IAE/B,IAAI,CAAC,IAAA,eAAU,EAAC,UAAU,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,IAAA,aAAQ,EAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,CAAC,6BAA6B,EAAE,mCAAmC,EAAE,UAAU,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,oBAAoB,EAAE,CAAC;QACvD,MAAM,OAAO,CACX,+BAA+B,EAC/B,2DAA2D,oBAAoB,SAAS,EACxF,UAAU,CACX,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,UAAU,EAAE,MAAM,CAAC,CAAY,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,CACX,+BAA+B,EAC/B,sCAAsC,EACtC,UAAU,CACX,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,OAAO,CACX,+BAA+B,EAC/B,2CAA2C,EAC3C,UAAU,CACX,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,MAAyE,CAAC;IAC9E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,OAAO,CAAC,+BAA+B,EAAE,gCAAgC,EAAE,UAAU,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,OAAO,CACX,+BAA+B,EAC/B,oCAAoC,EACpC,UAAU,CACX,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,EAAE,UAAU,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAc,EACd,KAAa,EACb,UAAkB;IAElB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,OAAO,CACX,kCAAkC,EAClC,QAAQ,KAAK,yCAAyC,EACtD,UAAU,CACX,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAClB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CACtF,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,KAAc,EACd,QAAgB,EAChB,UAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,CACX,iCAAiC,EACjC,eAAe,QAAQ,IAAI,SAAS,sBAAsB,EAC1D,UAAU,CACX,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAgC;QAC1C,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;QACpD,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;QACvD,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;QACnD,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;QACnD,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;QACpD,GAAG,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC3D,GAAG,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC3D,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC1D,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC3D,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC3D,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC3D,GAAG,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;KAChE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CACnB,MAAqB,EACrB,GAAW,EACX,QAAgB,EAChB,UAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACzF,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CACtB,MAAqB,EACrB,GAAW,EACX,QAAgB,EAChB,UAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAC3F,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAqB,EACrB,GAAW,EACX,QAAgB,EAChB,UAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5E,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,oBAAoB,CAC3B,MAAqB,EACrB,GAAW,EACX,QAAgB,EAChB,UAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QACtF,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,8BAA8B,EAAE,UAAU,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAqC,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,YAAY,CACnB,QAAgB,EAChB,KAAa,EACb,QAAgB,EAChB,UAAkB;IAElB,OAAO,OAAO,CACZ,gCAAgC,EAChC,eAAe,QAAQ,YAAY,KAAK,aAAa,QAAQ,GAAG,EAChE,UAAU,CACX,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CACd,IAAY,EACZ,OAAe,EACf,UAAkB;IAElB,OAAO,IAAI,+BAA+B,CAAC,IAAI,EAAE,GAAG,OAAO,KAAK,UAAU,GAAG,EAAE,UAAU,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/runtime/mcp/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './lazy-mcp-runtime';
+export * from './first-party-mcp-adapter';
+export * from './first-party-mcp-config';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

package/dist/{skills → runtime/mcp}/index.js

@@ -1,9 +1,4 @@
 "use strict";
-/**
- * orion code - Skills System
- *
- * 可扩展技能插件系统
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -20,8 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types"), exports);
-__exportStar(require("./loader"), exports);
-__exportStar(require("./registry"), exports);
-__exportStar(require("./discovery"), exports);
-__exportStar(require("./runtime"), exports);
+__exportStar(require("./lazy-mcp-runtime"), exports);
+__exportStar(require("./first-party-mcp-adapter"), exports);
+__exportStar(require("./first-party-mcp-config"), exports);
 //# sourceMappingURL=index.js.map

package/dist/runtime/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/mcp/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,qDAAmC;AACnC,4DAA0C;AAC1C,2DAAyC"}

package/dist/runtime/mcp/lazy-mcp-runtime.d.ts

@@ -0,0 +1,95 @@
+import { type LazyMcpRuntimeOptions, type LazyMcpRuntimeSnapshotV1, type McpCatalogSnapshotV1, type McpLeaseRequestV1, type McpRuntimeBindingSnapshotV1, type McpRuntimeToolBindingV1, type McpServerDescriptorInputV1, type McpServerLeaseV1 } from './types';
+export declare class LazyMcpRuntimeError extends Error {
+    readonly code: string;
+    constructor(message: string);
+}
+export declare class StaleMcpCatalogError extends LazyMcpRuntimeError {
+    readonly code = "ORION_STALE_MCP_CATALOG";
+    constructor(serverId?: string);
+}
+export declare class McpServerDrainingError extends LazyMcpRuntimeError {
+    readonly code = "ORION_MCP_SERVER_DRAINING";
+    constructor(serverId: string);
+}
+export declare class StaleMcpActivationError extends LazyMcpRuntimeError {
+    readonly code = "ORION_STALE_MCP_ACTIVATION";
+    constructor(serverId: string);
+}
+export declare class McpToolBindingUnavailableError extends LazyMcpRuntimeError {
+    readonly code = "ORION_MCP_TOOL_BINDING_UNAVAILABLE";
+    constructor(ownerId: string, toolName: string);
+}
+export declare class StaleMcpToolResultError extends LazyMcpRuntimeError {
+    readonly code = "ORION_STALE_MCP_TOOL_RESULT";
+    constructor(toolName: string);
+}
+/**
+ * Descriptor-first, owner-leased MCP lifecycle.
+ *
+ * The constructor performs only deterministic descriptor normalization. The
+ * injected connector is not touched until acquire() selects one exact server.
+ */
+export declare class LazyMcpRuntime {
+    readonly version: 1;
+    private readonly connector;
+    private readonly idleTimeoutMs;
+    private readonly maxServers;
+    private readonly maxToolsPerServer;
+    private readonly lifecycleController;
+    private readonly records;
+    private readonly operations;
+    private readonly detachParentSignal?;
+    private catalogValue;
+    private leaseSequence;
+    private disposed;
+    private disposeFlight?;
+    constructor(options: LazyMcpRuntimeOptions);
+    /** Safe, immutable server descriptors; this call performs no IO. */
+    getCatalog(): McpCatalogSnapshotV1;
+    /**
+     * Replace descriptor metadata and invalidate changed generations. Existing
+     * owners retain their frozen binding until release; new owners are rejected
+     * while the old transport drains.
+     */
+    replaceDescriptors(descriptors: readonly McpServerDescriptorInputV1[]): McpCatalogSnapshotV1;
+    /** Explicit or Capability-Compiler selection activates exactly one server. */
+    acquire(request: McpLeaseRequestV1): Promise<McpServerLeaseV1>;
+    /** Release every lease owned by a turn, step, or sub-agent scope. */
+    releaseOwner(ownerId: string): Promise<void>;
+    /**
+     * Serializable binding pinned to the owner's leases. Once the owner releases
+     * them, this becomes empty immediately even while a transport idles/drains.
+     */
+    bindingSnapshotForOwner(ownerId: string): McpRuntimeBindingSnapshotV1;
+    /** Executable owner bindings for a Step factory; no global connected-tool view exists. */
+    toolBindingsForOwner(ownerId: string): readonly McpRuntimeToolBindingV1[];
+    /** Execute only through an active owner lease. */
+    invoke(ownerId: string, qualifiedToolName: string, args: Readonly<Record<string, unknown>>, signal?: AbortSignal): Promise<unknown>;
+    /** Begin a generation-safe explicit drain. Active lease owners finish first. */
+    beginDrain(serverId: string, reason?: string): void;
+    snapshot(): LazyMcpRuntimeSnapshotV1;
+    dispose(reason?: unknown): Promise<void>;
+    private performDispose;
+    private ensureActivated;
+    private activate;
+    private activationSettled;
+    private watchConnection;
+    private handleUnexpectedClose;
+    private assertActivationCurrent;
+    private isActivationCurrent;
+    private requestDrain;
+    private maybeStartDrain;
+    private finishDrain;
+    private settleRecord;
+    private scheduleIdle;
+    private clearIdleTimer;
+    private releaseLease;
+    private ownerBindings;
+    private assertOwnerCatalog;
+    private findOwnerTool;
+    private ownerHasBinding;
+    private assertCatalogCurrent;
+    private track;
+    private assertActive;
+}
+//# sourceMappingURL=lazy-mcp-runtime.d.ts.map

package/dist/runtime/mcp/lazy-mcp-runtime.d.ts.map

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