toolhome 0.6.6 → 0.6.8

package/dist/server/data-plane/compact-protocol.js

@@ -0,0 +1,416 @@
+/**
+ * Wire contract for the compact discovery surface: the two fixed tools
+ * (`search`/`exec`), argument validation, budgets and the shared machine
+ * readable error shape. Everything here is deterministic and makes no network
+ * or subprocess calls.
+ */
+export const COMPACT_PROTOCOL_VERSION = '1';
+export const DEFAULT_RANK_ALGORITHM = 'field-score';
+export const RANK_ALGORITHM = DEFAULT_RANK_ALGORITHM;
+/** Output budgets, measured on the complete MCP result package. */
+export const COMPACT_BUDGETS = {
+    /** Fixed search+exec description and schema, estimated tokens. */
+    fixedSchemaTokens: 2_000,
+    serversBytes: 8 * 1_024,
+    findSummaryBytes: 8 * 1_024,
+    findDefinitionBytes: 16 * 1_024,
+    describeBytes: 16 * 1_024,
+    /** Error results fit the smallest discovery budget even with oversized input. */
+    errorBytes: 8 * 1_024,
+};
+function defaultCallEffect(code) {
+    // Discovery-side failures reject before any upstream invocation is submitted.
+    // Continuation/upstream failures cannot prove the original call did not run.
+    return code === 'continuation_rejected' || code === 'upstream_failure'
+        ? 'may_have_run'
+        : 'not_started';
+}
+function defaultNextStep(code) {
+    switch (code) {
+        case 'invalid_arguments':
+            return { action: 'fix_arguments', guidance: 'Correct the arguments and retry.' };
+        case 'unknown_server':
+            return { action: 'retry_search', arguments: { action: 'servers' } };
+        case 'unknown_tool':
+            return { action: 'retry_search', arguments: { action: 'find' } };
+        case 'invalid_cursor':
+            return { action: 'retry_search', arguments: { action: 'servers' } };
+        case 'catalog_unavailable':
+            return { action: 'refresh_catalog' };
+        case 'definition_changed':
+            return { action: 'describe', guidance: 'Re-fetch the current definition before executing.' };
+        case 'definition_too_large':
+            return {
+                action: 'use_full',
+                guidance: 'Use the original full or individual endpoint for this tool.',
+            };
+        case 'individual_endpoint_required':
+            return {
+                action: 'use_individual',
+                guidance: 'Use the individual /mcp/{server} endpoint for exact upstream semantics.',
+            };
+        case 'upstream_failure':
+            return { action: 'check_status', guidance: 'Check the call status before retrying.' };
+        case 'continuation_rejected':
+            return { action: 'check_status' };
+    }
+}
+function compactData(code, message, options) {
+    const data = {
+        kind: 'error',
+        code,
+        message,
+        source: options.source ?? 'gateway',
+        callEffect: options.callEffect ?? defaultCallEffect(code),
+        nextStep: options.nextStep ?? defaultNextStep(code),
+    };
+    if (options.retryable !== undefined)
+        data.retryable = options.retryable;
+    if (options.details !== undefined)
+        data.details = options.details;
+    return data;
+}
+export class CompactError extends Error {
+    options;
+    code;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.options = options;
+        this.name = 'CompactError';
+        this.code = code;
+    }
+    get source() {
+        return this.options.source ?? 'gateway';
+    }
+    get callEffect() {
+        return this.options.callEffect ?? defaultCallEffect(this.code);
+    }
+    get nextStep() {
+        return this.options.nextStep ?? defaultNextStep(this.code);
+    }
+    toData() {
+        return compactData(this.code, this.message, this.options);
+    }
+    static isInstance(value) {
+        return value instanceof CompactError;
+    }
+}
+export function invalidArguments(message, details) {
+    return new CompactError('invalid_arguments', message, { details });
+}
+export function unknownServerError(server) {
+    return new CompactError('unknown_server', `Unknown server: ${server}`, {
+        details: { server },
+    });
+}
+export function unknownToolError(tool) {
+    // Never leak whether a hidden/disabled/foreign tool exists.
+    return new CompactError('unknown_tool', `Unknown tool: ${tool}`, { details: { tool } });
+}
+export function invalidCursorError() {
+    return new CompactError('invalid_cursor', 'The catalog cursor is invalid or stale');
+}
+export function definitionTooLargeError(details) {
+    return new CompactError('definition_too_large', 'Tool definition exceeds the response budget', {
+        details,
+    });
+}
+// ── Results ───────────────────────────────────────────────────────────────
+export function jsonToolResult(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload) }],
+        structuredContent: payload,
+    };
+}
+function errorResult(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data) }],
+        structuredContent: data,
+        isError: true,
+    };
+}
+function clampText(value, limit) {
+    const points = Array.from(value);
+    return points.length <= limit ? value : points.slice(0, limit).join('');
+}
+function leanNextStep(step) {
+    return {
+        action: step.action,
+        ...(step.guidance === undefined ? {} : { guidance: clampText(step.guidance, 200) }),
+    };
+}
+/**
+ * Errors share the discovery budgets: oversized tool ids, messages or details
+ * are dropped/clamped so the complete package stays inside `errorBytes`.
+ */
+export function compactErrorResult(error) {
+    const data = error.toData();
+    const full = errorResult(data);
+    if (resultByteLength(full) <= COMPACT_BUDGETS.errorBytes)
+        return full;
+    const lean = {
+        kind: 'error',
+        code: data.code,
+        message: clampText(data.message, 300),
+        source: data.source,
+        callEffect: data.callEffect,
+        nextStep: leanNextStep(data.nextStep),
+        ...(data.retryable === undefined ? {} : { retryable: data.retryable }),
+    };
+    const leanResult = errorResult(lean);
+    if (resultByteLength(leanResult) <= COMPACT_BUDGETS.errorBytes)
+        return leanResult;
+    return errorResult({
+        kind: 'error',
+        code: data.code,
+        message: clampText(data.message, 120),
+        source: data.source,
+        callEffect: data.callEffect,
+        nextStep: { action: data.nextStep.action },
+    });
+}
+/** Byte length of the complete MCP result package (text + structuredContent). */
+export function resultByteLength(result) {
+    return Buffer.byteLength(JSON.stringify(result), 'utf8');
+}
+/** Deterministic token estimate used for the fixed-schema budget gate. */
+export function estimateTokens(value) {
+    return Math.ceil(Buffer.byteLength(JSON.stringify(value), 'utf8') / 4);
+}
+// ── Tool schemas ──────────────────────────────────────────────────────────
+export const SEARCH_TOOL_NAME = 'search';
+export const EXEC_TOOL_NAME = 'exec';
+export const SEARCH_ACTIONS = ['servers', 'find', 'describe'];
+export const SEARCH_DETAILS = ['summary', 'definition'];
+const parameterSchema = { type: 'object', additionalProperties: true };
+/**
+ * Fixed `search` schema. `additionalProperties: false` keeps per-action
+ * combinations strict; the handler validates which fields each action accepts.
+ */
+export const searchInputSchema = {
+    type: 'object',
+    properties: {
+        action: {
+            type: 'string',
+            enum: [...SEARCH_ACTIONS],
+            description: 'servers: inspect this gateway; find: rank tools for a task; describe: full contract.',
+        },
+        query: {
+            type: 'string',
+            minLength: 1,
+            maxLength: 512,
+            description: 'find: task description. English action/object keywords improve matching.',
+        },
+        server: {
+            type: 'string',
+            description: 'find: exact server slug returned by action=servers.',
+        },
+        tool: {
+            type: 'string',
+            description: 'describe: exact tool identifier returned by find.',
+        },
+        limit: {
+            type: 'integer',
+            minimum: 1,
+            maximum: 50,
+            description: 'servers default 20/max 50; find default 5/max 10 (definition max 3).',
+        },
+        cursor: {
+            type: 'string',
+            description: 'servers: pagination cursor from a previous directory response.',
+        },
+        detail: {
+            type: 'string',
+            enum: [...SEARCH_DETAILS],
+            description: 'find: summary (default) or definition for up to 3 complete contracts.',
+        },
+    },
+    required: ['action'],
+    additionalProperties: false,
+};
+export const execInputSchema = {
+    type: 'object',
+    properties: {
+        tool: {
+            type: 'string',
+            description: 'Exact tool identifier returned by find/describe.',
+        },
+        arguments: {
+            ...parameterSchema,
+            description: 'Arguments matching the describe-returned inputSchema.',
+        },
+        definition: {
+            type: 'string',
+            description: 'Optional describe-returned definition fingerprint.',
+        },
+    },
+    required: ['tool', 'arguments'],
+    additionalProperties: false,
+};
+export const searchTool = {
+    name: SEARCH_TOOL_NAME,
+    title: 'Search tools',
+    description: 'Find upstream MCP tools by task without knowing server names. Use action=servers to inspect this gateway, action=find for ranked summaries (optionally detail=definition), and action=describe for a selected tool\u2019s complete arguments schema. For Chinese tasks, include English action/object keywords. Execute the exact returned identifier with exec. Cached entries do not guarantee live availability.',
+    inputSchema: searchInputSchema,
+    annotations: { readOnlyHint: true },
+};
+export const execTool = {
+    name: EXEC_TOOL_NAME,
+    title: 'Execute tool',
+    description: 'Execute one discovered MCP tool with arguments matching its complete inputSchema. Use the definition fingerprint to detect changes. This tool may perform reads or writes depending on its target; upstream annotations appear in discovery results.',
+    inputSchema: execInputSchema,
+    annotations: { openWorldHint: true },
+};
+/** The two fixed compact tools; the list is constant even with an empty catalog. */
+export function compactTools() {
+    return [searchTool, execTool];
+}
+export function estimateCompactToolsTokens() {
+    return estimateTokens(compactTools());
+}
+// ── Apps execution boundary ───────────────────────────────────────────────
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** MCP App tools are launched through the individual endpoint, not a generic exec. */
+export function appResourceUri(tool) {
+    const meta = tool._meta;
+    if (!isRecord(meta))
+        return null;
+    if (typeof meta['ui/resourceUri'] === 'string')
+        return meta['ui/resourceUri'];
+    const ui = meta.ui;
+    if (isRecord(ui) && typeof ui.resourceUri === 'string')
+        return ui.resourceUri;
+    return null;
+}
+export function executionBoundaryForTool(tool) {
+    return appResourceUri(tool) === null ? 'exec' : 'individualEndpoint';
+}
+function readString(value) {
+    return typeof value === 'string' ? value : null;
+}
+function readInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) ? value : null;
+}
+const allowedKeysByAction = {
+    servers: new Set(['action', 'limit', 'cursor']),
+    find: new Set(['action', 'query', 'server', 'limit', 'detail']),
+    describe: new Set(['action', 'tool']),
+};
+function assertNoUnknownKeys(input, allowed, action) {
+    for (const key of Object.keys(input)) {
+        if (!allowed.has(key)) {
+            throw invalidArguments(`Argument "${key}" is not valid for action "${action}"`);
+        }
+    }
+}
+export function parseSearchArgs(input) {
+    if (!isRecord(input)) {
+        throw invalidArguments('search arguments must be an object');
+    }
+    const actionValue = input.action;
+    const action = readString(actionValue);
+    if (action === null || !SEARCH_ACTIONS.includes(action)) {
+        throw invalidArguments(`action must be one of ${SEARCH_ACTIONS.join(', ')}`, {
+            action: actionValue,
+        });
+    }
+    const typedAction = action;
+    assertNoUnknownKeys(input, allowedKeysByAction[typedAction], typedAction);
+    if (typedAction === 'servers') {
+        const limit = parseLimit(input.limit, 20, 50);
+        const cursorValue = input.cursor;
+        if (cursorValue !== undefined) {
+            const cursor = readString(cursorValue);
+            if (cursor === null || cursor.length === 0) {
+                throw invalidArguments('cursor must be a non-empty string');
+            }
+        }
+        return {
+            action: 'servers',
+            limit,
+            ...(cursorValue === undefined ? {} : { cursor: cursorValue }),
+            detail: 'summary',
+        };
+    }
+    if (typedAction === 'find') {
+        const query = readString(input.query);
+        if (query === null || query.trim().length === 0) {
+            throw invalidArguments('query is required for action=find');
+        }
+        if (query.length > 512) {
+            throw invalidArguments('query must be at most 512 characters', { length: query.length });
+        }
+        const serverValue = input.server;
+        if (serverValue !== undefined) {
+            const server = readString(serverValue);
+            if (server === null || server.length === 0) {
+                throw invalidArguments('server must be a non-empty string');
+            }
+        }
+        const detailValue = input.detail;
+        let detail = 'summary';
+        if (detailValue !== undefined) {
+            const parsedDetail = readString(detailValue);
+            if (parsedDetail === null || !SEARCH_DETAILS.includes(parsedDetail)) {
+                throw invalidArguments(`detail must be one of ${SEARCH_DETAILS.join(', ')}`);
+            }
+            detail = parsedDetail;
+        }
+        const maxLimit = detail === 'definition' ? 3 : 10;
+        const defaultLimit = detail === 'definition' ? 3 : 5;
+        const limit = parseLimit(input.limit, defaultLimit, maxLimit);
+        return {
+            action: 'find',
+            query,
+            limit,
+            detail,
+            ...(serverValue === undefined ? {} : { server: serverValue }),
+        };
+    }
+    const tool = readString(input.tool);
+    if (tool === null || tool.length === 0) {
+        throw invalidArguments('tool is required for action=describe');
+    }
+    return { action: 'describe', tool, limit: 1, detail: 'summary' };
+}
+function parseLimit(value, defaultValue, max) {
+    if (value === undefined)
+        return defaultValue;
+    const limit = readInteger(value);
+    if (limit === null || limit < 1 || limit > max) {
+        throw invalidArguments(`limit must be an integer between 1 and ${max}`, { limit: value });
+    }
+    return limit;
+}
+export function parseExecArgs(input) {
+    if (!isRecord(input)) {
+        throw invalidArguments('exec arguments must be an object');
+    }
+    for (const key of Object.keys(input)) {
+        if (key !== 'tool' && key !== 'arguments' && key !== 'definition') {
+            throw invalidArguments(`Argument "${key}" is not valid for exec`);
+        }
+    }
+    const tool = readString(input.tool);
+    if (tool === null || tool.length === 0) {
+        throw invalidArguments('tool is required for exec');
+    }
+    // The schema marks arguments as required; a missing field must not silently
+    // become `{}` and pass an unintended no-op invocation.
+    if (input.arguments === undefined || !isRecord(input.arguments)) {
+        throw invalidArguments('arguments object is required for exec');
+    }
+    const args = input.arguments;
+    let definition;
+    if (input.definition !== undefined) {
+        const parsed = readString(input.definition);
+        if (parsed === null || parsed.length === 0) {
+            throw invalidArguments('definition must be a non-empty string');
+        }
+        definition = parsed;
+    }
+    return { tool, arguments: args, ...(definition === undefined ? {} : { definition }) };
+}
+//# sourceMappingURL=compact-protocol.js.map

package/dist/server/data-plane/compact-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-protocol.js","sourceRoot":"","sources":["../../../src/data-plane/compact-protocol.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAI5C,MAAM,CAAC,MAAM,sBAAsB,GAAkB,aAAa,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAkB,sBAAsB,CAAC;AAEpE,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,kEAAkE;IAClE,iBAAiB,EAAE,KAAK;IACxB,YAAY,EAAE,CAAC,GAAG,KAAK;IACvB,gBAAgB,EAAE,CAAC,GAAG,KAAK;IAC3B,mBAAmB,EAAE,EAAE,GAAG,KAAK;IAC/B,aAAa,EAAE,EAAE,GAAG,KAAK;IACzB,iFAAiF;IACjF,UAAU,EAAE,CAAC,GAAG,KAAK;CACb,CAAC;AAuDX,SAAS,iBAAiB,CAAC,IAAsB;IAC/C,8EAA8E;IAC9E,6EAA6E;IAC7E,OAAO,IAAI,KAAK,uBAAuB,IAAI,IAAI,KAAK,kBAAkB;QACpE,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,aAAa,CAAC;AACpB,CAAC;AAED,SAAS,eAAe,CAAC,IAAsB;IAC7C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,mBAAmB;YACtB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,kCAAkC,EAAE,CAAC;QACnF,KAAK,gBAAgB;YACnB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QACtE,KAAK,cAAc;YACjB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QACnE,KAAK,gBAAgB;YACnB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QACtE,KAAK,qBAAqB;YACxB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QACvC,KAAK,oBAAoB;YACvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,mDAAmD,EAAE,CAAC;QAC/F,KAAK,sBAAsB;YACzB,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,QAAQ,EAAE,6DAA6D;aACxE,CAAC;QACJ,KAAK,8BAA8B;YACjC,OAAO;gBACL,MAAM,EAAE,gBAAgB;gBACxB,QAAQ,EAAE,yEAAyE;aACpF,CAAC;QACJ,KAAK,kBAAkB;YACrB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,wCAAwC,EAAE,CAAC;QACxF,KAAK,uBAAuB;YAC1B,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAClB,IAAsB,EACtB,OAAe,EACf,OAA4B;IAE5B,MAAM,IAAI,GAAqB;QAC7B,IAAI,EAAE,OAAO;QACb,IAAI;QACJ,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;QACnC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,IAAI,CAAC;QACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC;KACpD,CAAC;IACF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACxE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,YAAa,SAAQ,KAAK;IAM1B,OAAO;IALT,IAAI,CAAmB;IAEhC,YACE,IAAsB,EACtB,OAAe,EACN,OAAO,GAAwB,EAAE;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;uBAFN,OAAO;QAGhB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;IAC1C,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM;QACJ,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,KAAc;QAC9B,OAAO,KAAK,YAAY,YAAY,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAiC;IACjF,OAAO,IAAI,YAAY,CAAC,mBAAmB,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,IAAI,YAAY,CAAC,gBAAgB,EAAE,mBAAmB,MAAM,EAAE,EAAE;QACrE,OAAO,EAAE,EAAE,MAAM,EAAE;KACpB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,4DAA4D;IAC5D,OAAO,IAAI,YAAY,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,YAAY,CAAC,gBAAgB,EAAE,wCAAwC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgC;IACtE,OAAO,IAAI,YAAY,CAAC,sBAAsB,EAAE,6CAA6C,EAAE;QAC7F,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,6EAA6E;AAE7E,MAAM,UAAU,cAAc,CAAC,OAAgC;IAC7D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAsB;IACzC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,iBAAiB,EAAE,IAAI;QACvB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,KAAa;IAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,YAAY,CAAC,IAAqB;IACzC,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;KACpF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEtE,MAAM,IAAI,GAAqB;QAC7B,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACvE,CAAC;IACF,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,gBAAgB,CAAC,UAAU,CAAC,IAAI,eAAe,CAAC,UAAU;QAAE,OAAO,UAAU,CAAC;IAElF,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;KAC3C,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,6EAA6E;AAE7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAGvE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,YAAY,CAAU,CAAC;AAGjE,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,QAAiB,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwB;IACpD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,GAAG,cAAc,CAAC;YACzB,WAAW,EACT,sFAAsF;SACzF;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,0EAA0E;SACxF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qDAAqD;SACnE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;SACjE;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,sEAAsE;SACpF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gEAAgE;SAC9E;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,GAAG,cAAc,CAAC;YACzB,WAAW,EAAE,uEAAuE;SACrF;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAwB;IAClD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kDAAkD;SAChE;QACD,SAAS,EAAE;YACT,GAAG,eAAe;YAClB,WAAW,EAAE,uDAAuD;SACrE;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oDAAoD;SAClE;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,cAAc;IACrB,WAAW,EACT,qZAAqZ;IACvZ,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,cAAc;IACrB,WAAW,EACT,sPAAsP;IACxP,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;CACrC,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,6EAA6E;AAE7E,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;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;IACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9E,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACnB,IAAI,QAAQ,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,WAAW,CAAC;IAC9E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAU;IACjD,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC;AACvE,CAAC;AAoBD,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7E,CAAC;AAED,MAAM,mBAAmB,GAA8C;IACrE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,SAAS,mBAAmB,CAC1B,KAA8B,EAC9B,OAA4B,EAC5B,MAAoB;IAEpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,gBAAgB,CAAC,aAAa,GAAG,8BAA8B,MAAM,GAAG,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,gBAAgB,CAAC,oCAAoC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAE,cAAoC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,MAAM,gBAAgB,CAAC,yBAAyB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;YAC3E,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,WAAW,GAAG,MAAsB,CAAC;IAC3C,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;IAE1E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;QACjC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,gBAAgB,CAAC,mCAAmC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK;YACL,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAqB,EAAE,CAAC;YACvE,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,gBAAgB,CAAC,mCAAmC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACvB,MAAM,gBAAgB,CAAC,sCAAsC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;QACjC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,gBAAgB,CAAC,mCAAmC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;QACjC,IAAI,MAAM,GAAiB,SAAS,CAAC;QACrC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,YAAY,KAAK,IAAI,IAAI,CAAE,cAAoC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC3F,MAAM,gBAAgB,CAAC,yBAAyB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,GAAG,YAA4B,CAAC;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC9D,OAAO;YACL,MAAM,EAAE,MAAM;YACd,KAAK;YACL,KAAK;YACL,MAAM;YACN,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAqB,EAAE,CAAC;SACxE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,gBAAgB,CAAC,sCAAsC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,YAAoB,EAAE,GAAW;IACnE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC/C,MAAM,gBAAgB,CAAC,0CAA0C,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,gBAAgB,CAAC,kCAAkC,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAClE,MAAM,gBAAgB,CAAC,aAAa,GAAG,yBAAyB,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,gBAAgB,CAAC,2BAA2B,CAAC,CAAC;IACtD,CAAC;IACD,4EAA4E;IAC5E,uDAAuD;IACvD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,MAAM,gBAAgB,CAAC,uCAAuC,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,IAAI,GAA4B,KAAK,CAAC,SAAS,CAAC;IACtD,IAAI,UAA8B,CAAC;IACnC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,gBAAgB,CAAC,uCAAuC,CAAC,CAAC;QAClE,CAAC;QACD,UAAU,GAAG,MAAM,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AACxF,CAAC"}

package/dist/server/data-plane/compact-state.d.ts

@@ -0,0 +1,28 @@
+import type { Tool } from '@modelcontextprotocol/server';
+export interface CompactInvocation {
+    id: string;
+    key: string;
+    serverId: string;
+    exposedTool: string;
+    tool: Tool;
+    arguments: Record<string, unknown>;
+    definition: string;
+    revision: string;
+    upstreamRequestState?: string;
+    expiresAt: number;
+    bytes: number;
+    busy: boolean;
+    timer: ReturnType<typeof setTimeout>;
+}
+/** Process-local contracts and pending invocations never enter the global snapshot. */
+export declare class CompactState {
+    #private;
+    observe(key: string, serverId: string, revision: string, tool: Tool): boolean;
+    observed(key: string, revision: string): Tool | undefined;
+    retain(input: Omit<CompactInvocation, 'id' | 'expiresAt' | 'bytes' | 'busy' | 'timer'>, timeoutMs: number, terminate: (invocation: CompactInvocation) => Promise<void>): CompactInvocation | null;
+    invocation(id: string): CompactInvocation | undefined;
+    release(id: string): void;
+    revoke(keep: (invocation: CompactInvocation) => boolean, terminate: (invocation: CompactInvocation) => Promise<void>): Promise<void>;
+}
+export declare function compactContractFingerprint(tool: Tool, instructions?: string): string;
+//# sourceMappingURL=compact-state.d.ts.map

package/dist/server/data-plane/compact-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-state.d.ts","sourceRoot":"","sources":["../../../src/data-plane/compact-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAWzD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACtC;AAMD,uFAAuF;AACvF,qBAAa,YAAY;;IAIvB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAwB5E;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAUxD;IAED,MAAM,CACJ,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,EAC/E,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1D,iBAAiB,GAAG,IAAI,CAyB1B;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEpD;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIxB;IAEK,MAAM,CACV,IAAI,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,OAAO,EAChD,SAAS,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1D,OAAO,CAAC,IAAI,CAAC,CAMf;CAKF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpF"}

package/dist/server/data-plane/compact-state.js

@@ -0,0 +1,97 @@
+import { randomUUID } from 'node:crypto';
+import { fingerprint } from '../upstream/stable-json.js';
+const observationTtl = 15 * 60_000;
+const maxBytes = 8 * 1024 * 1024;
+const maxContractBytes = 256 * 1024;
+/** Process-local contracts and pending invocations never enter the global snapshot. */
+export class CompactState {
+    #observations = new Map();
+    #invocations = new Map();
+    observe(key, serverId, revision, tool) {
+        const bytes = Buffer.byteLength(JSON.stringify(tool));
+        if (bytes > maxContractBytes)
+            return false;
+        this.#observations.delete(key);
+        for (const [id, value] of this.#observations) {
+            if (value.expiresAt <= Date.now())
+                this.#observations.delete(id);
+        }
+        const serverEntries = [...this.#observations].filter(([, value]) => value.serverId === serverId);
+        while (serverEntries.length >= 32)
+            this.#observations.delete(serverEntries.shift()[0]);
+        while (this.#observationBytes() + bytes > maxBytes) {
+            const first = this.#observations.keys().next().value;
+            if (first === undefined)
+                break;
+            this.#observations.delete(first);
+        }
+        this.#observations.set(key, {
+            tool: structuredClone(tool),
+            revision,
+            bytes,
+            serverId,
+            expiresAt: Date.now() + observationTtl,
+        });
+        return true;
+    }
+    observed(key, revision) {
+        const value = this.#observations.get(key);
+        if (!value)
+            return undefined;
+        if (value.expiresAt <= Date.now() || value.revision !== revision) {
+            this.#observations.delete(key);
+            return undefined;
+        }
+        this.#observations.delete(key);
+        this.#observations.set(key, value);
+        return structuredClone(value.tool);
+    }
+    retain(input, timeoutMs, terminate) {
+        const bytes = Buffer.byteLength(JSON.stringify(input));
+        if (bytes > maxContractBytes ||
+            this.#invocations.size >= 256 ||
+            [...this.#invocations.values()].reduce((total, item) => total + item.bytes, 0) + bytes >
+                maxBytes) {
+            return null;
+        }
+        const id = randomUUID();
+        const invocation = {
+            ...structuredClone(input),
+            id,
+            bytes,
+            busy: false,
+            expiresAt: Date.now() + timeoutMs,
+            timer: setTimeout(() => {
+                this.release(id);
+                void terminate(invocation).catch(() => undefined);
+            }, timeoutMs),
+        };
+        invocation.timer.unref();
+        this.#invocations.set(id, invocation);
+        return invocation;
+    }
+    invocation(id) {
+        return this.#invocations.get(id);
+    }
+    release(id) {
+        const value = this.#invocations.get(id);
+        if (value)
+            clearTimeout(value.timer);
+        this.#invocations.delete(id);
+    }
+    async revoke(keep, terminate) {
+        for (const value of [...this.#invocations.values()]) {
+            if (keep(value))
+                continue;
+            this.release(value.id);
+            await terminate(value);
+        }
+    }
+    #observationBytes() {
+        return [...this.#observations.values()].reduce((total, value) => total + value.bytes, 0);
+    }
+}
+export function compactContractFingerprint(tool, instructions) {
+    return fingerprint({ tool, instructions: instructions ?? '' });
+}
+//# sourceMappingURL=compact-state.js.map

package/dist/server/data-plane/compact-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-state.js","sourceRoot":"","sources":["../../../src/data-plane/compact-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AA0BzD,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,CAAC;AACnC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACjC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEpC,uFAAuF;AACvF,MAAM,OAAO,YAAY;IACd,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE7D,OAAO,CAAC,GAAW,EAAE,QAAgB,EAAE,QAAgB,EAAE,IAAU;QACjE,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,KAAK,GAAG,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAC3C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7C,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;gBAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAC3C,CAAC;QACF,OAAO,aAAa,CAAC,MAAM,IAAI,EAAE;YAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,EAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC,iBAAiB,EAAE,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM;YAC/B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE;YAC1B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;YAC3B,QAAQ;YACR,KAAK;YACL,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc;SACvC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,GAAW,EAAE,QAAgB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CACJ,KAA+E,EAC/E,SAAiB,EACjB,SAA2D;QAE3D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,IACE,KAAK,GAAG,gBAAgB;YACxB,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,GAAG;YAC7B,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,KAAK;gBACpF,QAAQ,EACV,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,UAAU,GAAsB;YACpC,GAAG,eAAe,CAAC,KAAK,CAAC;YACzB,EAAE;YACF,KAAK;YACL,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACjC,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE;gBACrB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjB,KAAK,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACpD,CAAC,EAAE,SAAS,CAAC;SACd,CAAC;QACF,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACtC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAAgD,EAChD,SAA2D;QAE3D,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvB,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,iBAAiB;QACf,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC;CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAU,EAAE,YAAqB;IAC1E,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/server/data-plane/data-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-plane.d.ts","sourceRoot":"","sources":["../../../src/data-plane/data-plane.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAaxD,qBAAa,SAAS;;IAYpB,YACE,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EAWf;IAED,SAAS,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,6FA0C3E;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxC;IAED,eAAe,IAAI,IAAI,CAOtB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAO3B;CAiPF"}
+{"version":3,"file":"data-plane.d.ts","sourceRoot":"","sources":["../../../src/data-plane/data-plane.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAaxD,qBAAa,SAAS;;IAYpB,YACE,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EAWf;IAED,SAAS,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,6FA0C3E;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxC;IAED,eAAe,IAAI,IAAI,CAYtB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;CAiPF"}

package/dist/server/data-plane/data-plane.js

@@ -72,6 +72,9 @@ export class DataPlane {
         this.registryChanged();
     }
     registryChanged() {
+        void this.#factory
+            .catalogChanged()
+            .catch((error) => this.#logger.warn('Pending invocation cleanup failed', { error: String(error) }));
         this.#aggregate.modern.notify.toolsChanged();
         this.#aggregate.modern.notify.promptsChanged();
         this.#aggregate.modern.notify.resourcesChanged();
@@ -81,6 +84,7 @@ export class DataPlane {
     }
     async close() {
         this.#unsubscribe();
+        await this.#factory.close();
         await Promise.allSettled([
             this.#closeEndpoint(this.#aggregate),
             ...[...this.#individual.values()].map((handler) => this.#closeEndpoint(handler)),