@askdkc/kiokuko 0.2.6 → 0.2.8

package/dist/embedding/types.d.ts.map

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

package/dist/embedding/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/embedding/types.js.map

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

package/dist/embedding/vector.d.ts

@@ -0,0 +1,9 @@
+export declare const MIN_VECTOR_DIMENSIONS = 2;
+export declare const MAX_VECTOR_DIMENSIONS = 8192;
+export declare function normalizeVector(input: Float32Array | readonly number[], expectedDimensions?: number): Float32Array;
+export declare function encodeVector(input: Float32Array | readonly number[], expectedDimensions?: number): Uint8Array;
+export declare function decodeVector(blob: unknown, dimensions: number, expectedHash?: string): Float32Array;
+export declare function hashVectorBytes(bytes: Uint8Array): string;
+export declare function hashVector(input: Float32Array | readonly number[]): string;
+export declare function cosineDistance(left: Float32Array, right: Float32Array): number;
+//# sourceMappingURL=vector.d.ts.map

package/dist/embedding/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/embedding/vector.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAyB3C,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,YAAY,CAGlH;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,UAAU,CAQ7G;AASD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAWnG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,GAAG,MAAM,CAE1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAiB9E"}

package/dist/embedding/vector.js

@@ -0,0 +1,90 @@
+import { createHash } from 'node:crypto';
+import { KiokukoError } from '../errors.js';
+export const MIN_VECTOR_DIMENSIONS = 2;
+export const MAX_VECTOR_DIMENSIONS = 8_192;
+function invalid(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function dimensionsValue(dimensions) {
+    if (!Number.isSafeInteger(dimensions) || dimensions < MIN_VECTOR_DIMENSIONS || dimensions > MAX_VECTOR_DIMENSIONS) {
+        invalid('Vector dimensions are invalid');
+    }
+    return dimensions;
+}
+function validateFiniteVector(vector, expectedDimensions) {
+    const dimensions = dimensionsValue(expectedDimensions ?? vector.length);
+    if (vector.length !== dimensions)
+        invalid('Vector dimensions do not match');
+    let normSquared = 0;
+    for (const value of vector) {
+        if (!Number.isFinite(value))
+            invalid('Vector contains a non-finite value');
+        normSquared += value * value;
+    }
+    if (!Number.isFinite(normSquared) || normSquared === 0)
+        invalid('Vector norm must be non-zero');
+    return vector;
+}
+export function normalizeVector(input, expectedDimensions) {
+    const vector = input instanceof Float32Array ? new Float32Array(input) : new Float32Array(input);
+    return validateFiniteVector(vector, expectedDimensions);
+}
+export function encodeVector(input, expectedDimensions) {
+    const vector = normalizeVector(input, expectedDimensions);
+    const bytes = new Uint8Array(vector.byteLength);
+    const view = new DataView(bytes.buffer);
+    for (let index = 0; index < vector.length; index += 1) {
+        view.setFloat32(index * 4, vector[index], true);
+    }
+    return bytes;
+}
+function blobBytes(blob) {
+    if (blob instanceof Uint8Array)
+        return new Uint8Array(blob);
+    if (ArrayBuffer.isView(blob))
+        return new Uint8Array(blob.buffer.slice(blob.byteOffset, blob.byteOffset + blob.byteLength));
+    if (blob instanceof ArrayBuffer)
+        return new Uint8Array(blob.slice(0));
+    invalid('Vector BLOB is invalid');
+}
+export function decodeVector(blob, dimensions, expectedHash) {
+    const validDimensions = dimensionsValue(dimensions);
+    const bytes = blobBytes(blob);
+    if (bytes.byteLength !== validDimensions * 4)
+        invalid('Vector BLOB length does not match dimensions');
+    if (expectedHash !== undefined && hashVectorBytes(bytes) !== expectedHash) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Vector hash does not match its BLOB');
+    }
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const vector = new Float32Array(validDimensions);
+    for (let index = 0; index < validDimensions; index += 1)
+        vector[index] = view.getFloat32(index * 4, true);
+    return validateFiniteVector(vector, validDimensions);
+}
+export function hashVectorBytes(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+export function hashVector(input) {
+    return hashVectorBytes(encodeVector(input));
+}
+export function cosineDistance(left, right) {
+    if (left.length !== right.length)
+        invalid('Vectors must have matching dimensions');
+    const first = validateFiniteVector(left);
+    const second = validateFiniteVector(right, first.length);
+    let dot = 0;
+    let leftNorm = 0;
+    let rightNorm = 0;
+    for (let index = 0; index < first.length; index += 1) {
+        const leftValue = first[index];
+        const rightValue = second[index];
+        dot += leftValue * rightValue;
+        leftNorm += leftValue * leftValue;
+        rightNorm += rightValue * rightValue;
+    }
+    const similarity = dot / Math.sqrt(leftNorm * rightNorm);
+    if (!Number.isFinite(similarity))
+        invalid('Vector cosine distance is invalid');
+    return Math.min(2, Math.max(0, 1 - similarity));
+}
+//# sourceMappingURL=vector.js.map

package/dist/embedding/vector.js.map

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

package/dist/embedding/worker.d.ts

@@ -0,0 +1,23 @@
+import type { EmbeddingDrainResult, EmbeddingRuntime } from './types.js';
+export declare const DEFAULT_EMBEDDING_WORKER_INTERVAL_MS = 5000;
+export declare const DEFAULT_EMBEDDING_WORKER_MAX_JOBS = 64;
+export declare const DEFAULT_EMBEDDING_WORKER_DEADLINE_MS = 120000;
+export interface EmbeddingWorkerOptions {
+    readonly runtime: EmbeddingRuntime;
+    readonly intervalMs?: number;
+    readonly maxJobs?: number;
+    readonly deadlineMs?: number;
+    readonly setTimeout?: typeof setTimeout;
+    readonly clearTimeout?: typeof clearTimeout;
+    readonly onDrain?: (result: EmbeddingDrainResult) => void | PromiseLike<void>;
+    readonly onError?: (error: unknown) => void | PromiseLike<void>;
+}
+export interface EmbeddingWorker {
+    readonly running: boolean;
+    start(): void;
+    stop(): void;
+    close(): Promise<void>;
+}
+/** Run bounded embedding drains without overlapping provider calls or timers. */
+export declare function createEmbeddingWorker(options: EmbeddingWorkerOptions): EmbeddingWorker;
+//# sourceMappingURL=worker.d.ts.map

package/dist/embedding/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/embedding/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAC1D,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,oCAAoC,SAAU,CAAC;AAE5D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAOD,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAqEtF"}

package/dist/embedding/worker.js

@@ -0,0 +1,84 @@
+export const DEFAULT_EMBEDDING_WORKER_INTERVAL_MS = 5_000;
+export const DEFAULT_EMBEDDING_WORKER_MAX_JOBS = 64;
+export const DEFAULT_EMBEDDING_WORKER_DEADLINE_MS = 120_000;
+function positiveInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new TypeError(`${label} must be a positive integer`);
+    return value;
+}
+/** Run bounded embedding drains without overlapping provider calls or timers. */
+export function createEmbeddingWorker(options) {
+    const intervalMs = positiveInteger(options.intervalMs ?? DEFAULT_EMBEDDING_WORKER_INTERVAL_MS, 'intervalMs');
+    const maxJobs = positiveInteger(options.maxJobs ?? DEFAULT_EMBEDDING_WORKER_MAX_JOBS, 'maxJobs');
+    const deadlineMs = positiveInteger(options.deadlineMs ?? DEFAULT_EMBEDDING_WORKER_DEADLINE_MS, 'deadlineMs');
+    const setTimer = options.setTimeout ?? setTimeout;
+    const clearTimer = options.clearTimeout ?? clearTimeout;
+    let started = false;
+    let closing = false;
+    let timer;
+    let active;
+    const schedule = (delay) => {
+        if (!started || closing || timer !== undefined)
+            return;
+        timer = setTimer(() => {
+            timer = undefined;
+            void run();
+        }, delay);
+    };
+    const run = async () => {
+        if (!started || closing || active !== undefined)
+            return;
+        const operation = (async () => {
+            try {
+                const result = await options.runtime.drain({ maxJobs, deadlineMs });
+                await options.onDrain?.(result);
+            }
+            catch (error) {
+                try {
+                    await options.onError?.(error);
+                }
+                catch {
+                    // A background observer must not create an unhandled rejection.
+                }
+            }
+        })();
+        active = operation;
+        try {
+            await operation;
+        }
+        finally {
+            if (active === operation)
+                active = undefined;
+            schedule(intervalMs);
+        }
+    };
+    const stop = () => {
+        if (closing)
+            return;
+        closing = true;
+        started = false;
+        if (timer !== undefined) {
+            clearTimer(timer);
+            timer = undefined;
+        }
+    };
+    const worker = {
+        get running() {
+            return started && !closing;
+        },
+        start() {
+            if (started || closing)
+                return;
+            started = true;
+            schedule(0);
+        },
+        stop,
+        async close() {
+            stop();
+            await options.runtime.close();
+            await active;
+        },
+    };
+    return Object.freeze(worker);
+}
+//# sourceMappingURL=worker.js.map

package/dist/embedding/worker.js.map

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

package/dist/enno-oduno/schemas.d.ts

@@ -229,11 +229,11 @@ export declare const advisoryContributionSchemaPublic: z.ZodUnion<readonly [z.Zo
         failed: "failed";
     }>;
     reasonCode: z.ZodEnum<{
+        invalid_response: "invalid_response";
         unsafe_output: "unsafe_output";
         host_read_only_unavailable: "host_read_only_unavailable";
         host_execution_failed: "host_execution_failed";
         host_timeout: "host_timeout";
-        invalid_response: "invalid_response";
     }>;
 }, z.core.$strict>]>;
 export declare const adviceSubmissionSchema: z.ZodObject<{
@@ -373,11 +373,11 @@ export declare const adviceSubmissionSchema: z.ZodObject<{
             failed: "failed";
         }>;
         reasonCode: z.ZodEnum<{
+            invalid_response: "invalid_response";
             unsafe_output: "unsafe_output";
             host_read_only_unavailable: "host_read_only_unavailable";
             host_execution_failed: "host_execution_failed";
             host_timeout: "host_timeout";
-            invalid_response: "invalid_response";
         }>;
     }, z.core.$strict>]>>;
 }, z.core.$strict>;

package/dist/ledger/checkpoint-contract.d.ts

@@ -92,8 +92,8 @@ export declare const checkpointTestEvidenceSchema: z.ZodObject<{
 export declare const checkpointVerificationSchema: z.ZodObject<{
     outcome: z.ZodEnum<{
         unknown: "unknown";
-        stale: "stale";
         failed: "failed";
+        stale: "stale";
         fresh: "fresh";
     }>;
 }, z.core.$strict>;
@@ -124,8 +124,8 @@ export declare const checkpointEvidenceSchema: z.ZodObject<{
     verification: z.ZodOptional<z.ZodObject<{
         outcome: z.ZodEnum<{
             unknown: "unknown";
-            stale: "stale";
             failed: "failed";
+            stale: "stale";
             fresh: "fresh";
         }>;
     }, z.core.$strict>>;

package/dist/mcp/bounded-stdio-transport.d.ts

@@ -1,6 +1,7 @@
 import type { Readable, Writable } from 'node:stream';
 import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
 import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
+export { DEFAULT_MCP_REQUEST_TIMEOUT_MS, MAX_MCP_REQUEST_TIMEOUT_MS, MIN_MCP_REQUEST_TIMEOUT_MS, } from './request-deadline.js';
 export declare const MAX_STDIO_JSON_RPC_MESSAGE_BYTES: number;
 export declare class BoundedStdioServerTransport implements Transport {
     private readonly input;
@@ -12,9 +13,11 @@ export declare class BoundedStdioServerTransport implements Transport {
     private buffer;
     private discardingOversizedLine;
     private started;
+    private closed;
     constructor(input?: Readable, output?: Writable, maxMessageBytes?: number);
     private readonly onData;
     private readonly onInputError;
+    private readonly onInputEnd;
     private writeOversizedMessageError;
     start(): Promise<void>;
     close(): Promise<void>;

package/dist/mcp/bounded-stdio-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounded-stdio-transport.d.ts","sourceRoot":"","sources":["../../src/mcp/bounded-stdio-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAGrG,eAAO,MAAM,gCAAgC,QAAkB,CAAC;AAUhE,qBAAa,2BAA4B,YAAW,SAAS;IAUzD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAXlC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAE3D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,OAAO,CAAS;gBAGL,KAAK,GAAE,QAAwB,EAC/B,MAAM,GAAE,QAAyB,EACjC,eAAe,SAAmC;IAOrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAsCrB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IAEF,OAAO,CAAC,0BAA0B;IAM5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAU9E"}
+{"version":3,"file":"bounded-stdio-transport.d.ts","sourceRoot":"","sources":["../../src/mcp/bounded-stdio-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAErG,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,gCAAgC,QAAkB,CAAC;AAUhE,qBAAa,2BAA4B,YAAW,SAAS;IAWzD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAZlC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAE3D,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAGJ,KAAK,GAAE,QAAwB,EAC/B,MAAM,GAAE,QAAyB,EACjC,eAAe,SAAmC;IAOrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAuCrB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAEzB;IAEF,OAAO,CAAC,0BAA0B;IAM5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAU9E"}

package/dist/mcp/bounded-stdio-transport.js

@@ -1,5 +1,6 @@
 import process from 'node:process';
 import { deserializeMessage, serializeMessage } from '@modelcontextprotocol/sdk/shared/stdio.js';
+export { DEFAULT_MCP_REQUEST_TIMEOUT_MS, MAX_MCP_REQUEST_TIMEOUT_MS, MIN_MCP_REQUEST_TIMEOUT_MS, } from './request-deadline.js';
 export const MAX_STDIO_JSON_RPC_MESSAGE_BYTES = 8 * 1024 * 1024;
 const MESSAGE_TOO_LARGE = Object.freeze({
     jsonrpc: '2.0',
@@ -18,6 +19,7 @@ export class BoundedStdioServerTransport {
     buffer;
     discardingOversizedLine = false;
     started = false;
+    closed = false;
     constructor(input = process.stdin, output = process.stdout, maxMessageBytes = MAX_STDIO_JSON_RPC_MESSAGE_BYTES) {
         this.input = input;
         this.output = output;
@@ -59,7 +61,8 @@ export class BoundedStdioServerTransport {
                 this.buffer = undefined;
                 try {
                     const text = line.toString('utf8').replace(/\r$/u, '');
-                    this.onmessage?.(deserializeMessage(text));
+                    const message = deserializeMessage(text);
+                    this.onmessage?.(message);
                 }
                 catch (error) {
                     this.onerror?.(error instanceof Error ? error : new Error('Invalid JSON-RPC stdio message'));
@@ -71,21 +74,30 @@ export class BoundedStdioServerTransport {
     onInputError = (error) => {
         this.onerror?.(error);
     };
+    onInputEnd = () => {
+        void this.close();
+    };
     writeOversizedMessageError() {
         void this.send(MESSAGE_TOO_LARGE).catch((error) => {
             this.onerror?.(error instanceof Error ? error : new Error('Failed to write JSON-RPC transport error'));
         });
     }
     async start() {
-        if (this.started)
-            throw new Error('BoundedStdioServerTransport already started');
+        if (this.started || this.closed)
+            throw new Error('BoundedStdioServerTransport cannot be started again');
         this.started = true;
         this.input.on('data', this.onData);
         this.input.on('error', this.onInputError);
+        this.input.on('end', this.onInputEnd);
     }
     async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.started = false;
         this.input.off('data', this.onData);
         this.input.off('error', this.onInputError);
+        this.input.off('end', this.onInputEnd);
         if (this.input.listenerCount('data') === 0)
             this.input.pause();
         this.buffer = undefined;

package/dist/mcp/bounded-stdio-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"bounded-stdio-transport.js","sourceRoot":"","sources":["../../src/mcp/bounded-stdio-transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bounded-stdio-transport.js","sourceRoot":"","sources":["../../src/mcp/bounded-stdio-transport.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAInC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AACjG,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhE,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,KAAc;IACvB,KAAK,EAAE;QACL,IAAI,EAAE,CAAC,KAAK;QACZ,OAAO,EAAE,0DAA0D;KACpE;CACF,CAAC,CAAC;AAEH,MAAM,OAAO,2BAA2B;IAWnB;IACA;IACA;IAZnB,OAAO,CAAc;IACrB,OAAO,CAA0B;IACjC,SAAS,CAAkD;IAEnD,MAAM,CAAqB;IAC3B,uBAAuB,GAAG,KAAK,CAAC;IAChC,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,KAAK,CAAC;IAEvB,YACmB,QAAkB,OAAO,CAAC,KAAK,EAC/B,SAAmB,OAAO,CAAC,MAAM,EACjC,kBAAkB,gCAAgC;QAFlD,UAAK,GAAL,KAAK,CAA0B;QAC/B,WAAM,GAAN,MAAM,CAA2B;QACjC,oBAAe,GAAf,eAAe,CAAmC;QAEnE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAEgB,MAAM,GAAG,CAAC,KAAsB,EAAQ,EAAE;QACzD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC5C,IAAI,OAAO,KAAK,CAAC,CAAC;oBAAE,OAAO;gBAC3B,IAAI,CAAC,uBAAuB,GAAG,KAAK,CAAC;gBACrC,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACpD,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;YAC/C,IAAI,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1D,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBACxB,IAAI,CAAC,0BAA0B,EAAE,CAAC;gBAClC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;oBACnB,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;oBACpC,OAAO;gBACT,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBACvG,OAAO;YACT,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBACzF,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBACxB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACvD,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;oBACzC,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;gBAC/F,CAAC;YACH,CAAC;YACD,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;IAEe,YAAY,GAAG,CAAC,KAAY,EAAQ,EAAE;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC,CAAC;IAEe,UAAU,GAAG,GAAS,EAAE;QACvC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC,CAAC;IAEM,0BAA0B;QAChC,KAAK,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzD,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC;QACzG,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACxG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,uBAAuB,GAAG,KAAK,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,OAAuB,EAAE,QAA+B;QAC3D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBAAE,OAAO,EAAE,CAAC;;oBACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/mcp/request-deadline.d.ts

@@ -0,0 +1,51 @@
+export declare const DEFAULT_MCP_REQUEST_TIMEOUT_MS = 90000;
+export declare const MIN_MCP_REQUEST_TIMEOUT_MS = 10;
+export declare const MAX_MCP_REQUEST_TIMEOUT_MS = 90000;
+export declare const MCP_READ_TIMEOUT_MS = 30000;
+export declare const MCP_EXTERNAL_IO_TIMEOUT_MS = 10000;
+export declare const MCP_MUTATION_TIMEOUT_MS = 60000;
+export type McpToolOperation = 'task_prepare' | 'task_answer' | 'memory_checkpoint' | 'curator_check' | 'curator_globalize' | 'enno_advice_submit' | 'enno_ideal_submit' | 'enno_plan_submit' | 'enno_answer' | 'enno_work_report' | 'enno_verify_prepare' | 'enno_finish' | 'enno_meditation_submit';
+export type McpDeadlineClass = 'read' | 'external' | 'mutation';
+export interface McpDeadlinePolicy {
+    readMs: number;
+    externalMs: number;
+    mutationMs: number;
+    hardMaxMs: number;
+}
+export interface McpDeadlinePolicyOverrides {
+    readMs?: number;
+    externalMs?: number;
+    mutationMs?: number;
+    hardMaxMs?: number;
+}
+export interface McpDeadlineContext {
+    readonly operation: McpToolOperation;
+    readonly deadlineAt: number;
+    remainingMs(): number;
+    childTimeoutMs(requestedMs: number): number;
+}
+export interface RunWithMcpDeadlineOptions<T> {
+    operation: McpToolOperation;
+    timeoutMs?: number;
+    policy?: McpDeadlinePolicy;
+    signal?: AbortSignal;
+    operationFn: (signal: AbortSignal, context: McpDeadlineContext) => Promise<T> | T;
+}
+export declare class McpRequestTimeoutError extends Error {
+    readonly operation: McpToolOperation;
+    readonly code: "MCP_REQUEST_TIMEOUT";
+    readonly retryable: true;
+    constructor(operation: McpToolOperation);
+}
+export declare class McpRequestCancelledError extends Error {
+    readonly operation: McpToolOperation;
+    readonly code: "MCP_REQUEST_CANCELLED";
+    readonly retryable: false;
+    constructor(operation: McpToolOperation);
+}
+export declare const DEFAULT_MCP_DEADLINE_POLICY: Readonly<McpDeadlinePolicy>;
+export declare function createMcpDeadlinePolicy(overrides?: McpDeadlinePolicyOverrides): McpDeadlinePolicy;
+export declare function operationDeadlineClass(operation: McpToolOperation): McpDeadlineClass;
+export declare function timeoutForOperation(operation: McpToolOperation, policy?: McpDeadlinePolicy): number;
+export declare function runWithMcpDeadline<T>({ operation, timeoutMs, policy, signal, operationFn, }: RunWithMcpDeadlineOptions<T>): Promise<T>;
+//# sourceMappingURL=request-deadline.d.ts.map

package/dist/mcp/request-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-deadline.d.ts","sourceRoot":"","sources":["../../src/mcp/request-deadline.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,aAAa,GACb,mBAAmB,GACnB,eAAe,GACf,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,aAAa,GACb,kBAAkB,GAClB,qBAAqB,GACrB,aAAa,GACb,wBAAwB,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,WAAW,IAAI,MAAM,CAAC;IACtB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACnF;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAInC,QAAQ,CAAC,SAAS,EAAE,gBAAgB;IAHhD,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;IAC/C,QAAQ,CAAC,SAAS,EAAG,IAAI,CAAU;gBAEd,SAAS,EAAE,gBAAgB;CAIjD;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAIrC,QAAQ,CAAC,SAAS,EAAE,gBAAgB;IAHhD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;IACjD,QAAQ,CAAC,SAAS,EAAG,KAAK,CAAU;gBAEf,SAAS,EAAE,gBAAgB;CAIjD;AAED,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAKlE,CAAC;AAoCH,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,0BAA+B,GAAG,iBAAiB,CAuBrG;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,gBAAgB,CAIpF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,gBAAgB,EAC3B,MAAM,GAAE,iBAA+C,GACtD,MAAM,CAOR;AAMD,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,EAC1C,SAAS,EACT,SAAS,EACT,MAAoC,EACpC,MAAM,EACN,WAAW,GACZ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuD3C"}

package/dist/mcp/request-deadline.js

@@ -0,0 +1,155 @@
+import process from 'node:process';
+export const DEFAULT_MCP_REQUEST_TIMEOUT_MS = 90_000;
+export const MIN_MCP_REQUEST_TIMEOUT_MS = 10;
+export const MAX_MCP_REQUEST_TIMEOUT_MS = 90_000;
+export const MCP_READ_TIMEOUT_MS = 30_000;
+export const MCP_EXTERNAL_IO_TIMEOUT_MS = 10_000;
+export const MCP_MUTATION_TIMEOUT_MS = 60_000;
+export class McpRequestTimeoutError extends Error {
+    operation;
+    code = 'MCP_REQUEST_TIMEOUT';
+    retryable = true;
+    constructor(operation) {
+        super('MCP request timed out');
+        this.operation = operation;
+        this.name = 'McpRequestTimeoutError';
+    }
+}
+export class McpRequestCancelledError extends Error {
+    operation;
+    code = 'MCP_REQUEST_CANCELLED';
+    retryable = false;
+    constructor(operation) {
+        super('MCP request was cancelled');
+        this.operation = operation;
+        this.name = 'McpRequestCancelledError';
+    }
+}
+export const DEFAULT_MCP_DEADLINE_POLICY = Object.freeze({
+    readMs: MCP_READ_TIMEOUT_MS,
+    externalMs: MCP_EXTERNAL_IO_TIMEOUT_MS,
+    mutationMs: MCP_MUTATION_TIMEOUT_MS,
+    hardMaxMs: DEFAULT_MCP_REQUEST_TIMEOUT_MS,
+});
+const EXTERNAL_OPERATIONS = new Set([
+    'task_prepare',
+    'task_answer',
+]);
+const MUTATION_OPERATIONS = new Set([
+    'memory_checkpoint',
+    'curator_globalize',
+    'enno_advice_submit',
+    'enno_ideal_submit',
+    'enno_plan_submit',
+    'enno_answer',
+    'enno_work_report',
+    'enno_verify_prepare',
+    'enno_finish',
+    'enno_meditation_submit',
+]);
+function assertTimeoutMs(value, label) {
+    if (!Number.isSafeInteger(value)
+        || value < MIN_MCP_REQUEST_TIMEOUT_MS
+        || value > MAX_MCP_REQUEST_TIMEOUT_MS) {
+        throw new Error(`${label} must be an integer between ${MIN_MCP_REQUEST_TIMEOUT_MS} and ${MAX_MCP_REQUEST_TIMEOUT_MS} milliseconds`);
+    }
+    return value;
+}
+function positiveIntegerEnvironmentValue(name) {
+    const raw = process.env[name];
+    if (raw === undefined || raw.length === 0)
+        return undefined;
+    const value = Number(raw);
+    return Number.isSafeInteger(value) && value > 0 ? value : undefined;
+}
+export function createMcpDeadlinePolicy(overrides = {}) {
+    const policy = {
+        readMs: overrides.readMs
+            ?? positiveIntegerEnvironmentValue('KIOKUKO_MCP_READ_TIMEOUT_MS')
+            ?? DEFAULT_MCP_DEADLINE_POLICY.readMs,
+        externalMs: overrides.externalMs
+            ?? positiveIntegerEnvironmentValue('KIOKUKO_MCP_EXTERNAL_IO_TIMEOUT_MS')
+            ?? DEFAULT_MCP_DEADLINE_POLICY.externalMs,
+        mutationMs: overrides.mutationMs
+            ?? positiveIntegerEnvironmentValue('KIOKUKO_MCP_MUTATION_TIMEOUT_MS')
+            ?? DEFAULT_MCP_DEADLINE_POLICY.mutationMs,
+        hardMaxMs: overrides.hardMaxMs
+            ?? positiveIntegerEnvironmentValue('KIOKUKO_MCP_HARD_MAX_TIMEOUT_MS')
+            ?? DEFAULT_MCP_DEADLINE_POLICY.hardMaxMs,
+    };
+    assertTimeoutMs(policy.readMs, 'read timeout');
+    assertTimeoutMs(policy.externalMs, 'external I/O timeout');
+    assertTimeoutMs(policy.mutationMs, 'mutation timeout');
+    assertTimeoutMs(policy.hardMaxMs, 'hard maximum timeout');
+    if (policy.readMs > policy.hardMaxMs || policy.externalMs > policy.hardMaxMs || policy.mutationMs > policy.hardMaxMs) {
+        throw new Error('MCP operation timeout must not exceed the hard maximum timeout');
+    }
+    return policy;
+}
+export function operationDeadlineClass(operation) {
+    if (EXTERNAL_OPERATIONS.has(operation))
+        return 'external';
+    if (MUTATION_OPERATIONS.has(operation))
+        return 'mutation';
+    return 'read';
+}
+export function timeoutForOperation(operation, policy = DEFAULT_MCP_DEADLINE_POLICY) {
+    const validated = createMcpDeadlinePolicy(policy);
+    switch (operationDeadlineClass(operation)) {
+        case 'external': return validated.externalMs;
+        case 'mutation': return validated.mutationMs;
+        case 'read': return validated.readMs;
+    }
+}
+function abortReasonIsTimeout(reason) {
+    return reason instanceof McpRequestTimeoutError;
+}
+export async function runWithMcpDeadline({ operation, timeoutMs, policy = DEFAULT_MCP_DEADLINE_POLICY, signal, operationFn, }) {
+    const selectedTimeoutMs = assertTimeoutMs(timeoutMs ?? timeoutForOperation(operation, policy), 'MCP request timeout');
+    const deadlineAt = Date.now() + selectedTimeoutMs;
+    const controller = new AbortController();
+    const context = {
+        operation,
+        deadlineAt,
+        remainingMs: () => Math.max(0, deadlineAt - Date.now()),
+        childTimeoutMs: (requestedMs) => Math.min(assertTimeoutMs(requestedMs, 'child timeout'), Math.max(0, deadlineAt - Date.now())),
+    };
+    if (signal?.aborted)
+        throw new McpRequestCancelledError(operation);
+    return await new Promise((resolve, reject) => {
+        let settled = false;
+        let timer;
+        const cleanup = () => {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            signal?.removeEventListener('abort', onCallerAbort);
+        };
+        const settle = (settlement) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            settlement();
+        };
+        const onCallerAbort = () => {
+            const error = new McpRequestCancelledError(operation);
+            controller.abort(error);
+            settle(() => reject(error));
+        };
+        const onTimeout = () => {
+            const error = new McpRequestTimeoutError(operation);
+            controller.abort(error);
+            settle(() => reject(error));
+        };
+        signal?.addEventListener('abort', onCallerAbort, { once: true });
+        timer = setTimeout(onTimeout, selectedTimeoutMs);
+        void Promise.resolve()
+            .then(() => {
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            return operationFn(controller.signal, context);
+        })
+            .then((value) => settle(() => resolve(value)), (error) => settle(() => reject(abortReasonIsTimeout(controller.signal.reason) ? new McpRequestTimeoutError(operation) : error)));
+    });
+}
+//# sourceMappingURL=request-deadline.js.map

package/dist/mcp/request-deadline.js.map

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