@animalabs/agent-framework 0.22.2 → 0.23.0

package/dist/src/mcpl/inference-router.js

@@ -32,6 +32,93 @@ function wildcardMatch(pattern, name) {
     return true;
 }
 // ============================================================================
+// Results
+// ============================================================================
+/**
+ * The inference/request result for a completed inference, the same for both
+ * modes: the response's text, the model that served it, why it stopped, and
+ * its usage.
+ *
+ * A response MCPL can't report as a completion throws, and is answered with
+ * the error: one the provider ended with an error, one where the model wrote a
+ * tool call, since inference/request offers the model none, and one with a
+ * stop reason FinishReason has no value for (see finishReasonFor).
+ */
+function resultFrom(response, routedModel) {
+    // A provider can end an inference with finish_reason 'error' and no error
+    // object. membrane 0.5.87's OpenAI-style adapters fail a stream on a frame
+    // that carries one, as OpenRouter's mid-stream error does, but pass the token
+    // alone through, and membrane, having no stop reason for it, normalizes it
+    // to end_turn and keeps it as providerReason.
+    if (response.details.stop.providerReason === 'error') {
+        throw new Error("The provider ended the inference with an error (finish_reason 'error')");
+    }
+    // membrane's yielding stream lists a native tool call in toolCalls only
+    // when the stop was tool_use, so a tool_use block cut off by another stop is
+    // only in the content. membrane's complete() lists every tool_use block in
+    // toolCalls, whatever the stop.
+    const toolUses = response.content.filter((b) => b.type === 'tool_use');
+    if (response.toolCalls.length > 0 || toolUses.length > 0) {
+        throw toolCallError(response.toolCalls.length > 0 ? response.toolCalls : toolUses);
+    }
+    // In XML tool mode membrane reads tool calls out of the text. Markup it
+    // reads no call from still shows in how the output ended: with a tool-call
+    // block still open (a call cut off at max_tokens, or an opening tag written
+    // in prose), or at `</function_calls>`, the stop sequence XML tool mode adds
+    // so that it can run calls (inference/request asks for no stop sequence of
+    // its own). Either way the markup is in the text.
+    if (response.details.stop.unclosedToolBlock) {
+        throw new Error("The model's output ended with a tool-call block still open, and inference/request offers no tools");
+    }
+    if (response.details.stop.triggeredSequence === '</function_calls>') {
+        throw new Error('The model wrote tool-call markup, and inference/request offers no tools');
+    }
+    return {
+        content: response.content
+            .filter((b) => b.type === 'text')
+            .map((b) => b.text)
+            .join(''),
+        // Spec §11.3: the actual model used, which can differ from the routed one
+        // where routing or fallback applies. When membrane names none, the routed
+        // model is the only one there is to report.
+        model: actualModelOf(response) ?? routedModel,
+        finishReason: finishReasonFor(response.stopReason),
+        usage: {
+            inputTokens: response.usage.inputTokens,
+            outputTokens: response.usage.outputTokens,
+        },
+    };
+}
+/**
+ * The model membrane says served the response, or undefined when it names
+ * none. membrane's type says it always names one, but some of its adapters
+ * pass the provider's own value through as it is, which can be empty.
+ */
+function actualModelOf(response) {
+    return response.details.model.actual || undefined;
+}
+/**
+ * MCPL's finishReason for membrane's stop reason. Spec §11.3 closes
+ * FinishReason at these three, so any other stop throws: `end_turn` for a
+ * refusal, or for a turn membrane's resumption guard ended (`no_progress`,
+ * `round_limit`), would tell the server the model had finished.
+ */
+function finishReasonFor(stopReason) {
+    switch (stopReason) {
+        case 'end_turn':
+        case 'max_tokens':
+        case 'stop_sequence':
+            return stopReason;
+        default:
+            throw new Error(`The inference ended with stop reason '${stopReason}', for which inference/request has no finishReason`);
+    }
+}
+/** The error for a model that called a tool, which inference/request doesn't offer. */
+function toolCallError(calls) {
+    const names = calls.map((call) => call.name).join(', ');
+    return new Error(`The model called a tool (${names}), and inference/request offers none`);
+}
+// ============================================================================
 // Constants
 // ============================================================================
 /** Default max tokens when not specified in preferences. */
@@ -45,14 +132,12 @@ export class InferenceRouter {
     featureSetManager;
     routingPolicy;
     emitTraceFn;
-    sendChunkFn;
-    constructor(membrane, hookOrchestrator, featureSetManager, routingPolicy, emitTraceFn, sendChunkFn) {
+    constructor(membrane, hookOrchestrator, featureSetManager, routingPolicy, emitTraceFn) {
         this.membrane = membrane;
         this.hookOrchestrator = hookOrchestrator;
         this.featureSetManager = featureSetManager;
         this.routingPolicy = routingPolicy;
         this.emitTraceFn = emitTraceFn;
-        this.sendChunkFn = sendChunkFn;
     }
     /**
      * Handle an inference/request from an MCPL server.
@@ -60,9 +145,10 @@ export class InferenceRouter {
      * 1. Validate feature set
      * 2. Check loop prevention (reject if inside a hook)
      * 3. Resolve model from routing policy
-     * 4. Build membrane request and run inference
-     * 5. Optionally stream chunks
-     * 6. Return result via responder
+     * 4. Build membrane request
+     * 5. Run inference, streaming its visible text as chunks when asked
+     * 6. Answer with the result, or with the error for any ending that isn't
+     *    a completion
      */
     async handleInferenceRequest(serverId, params, responder) {
         // 1. Validate feature set
@@ -105,47 +191,44 @@ export class InferenceRouter {
                 temperature: params.preferences?.temperature,
             },
         };
+        // Streaming needs a way to send chunks and an id to tag them with;
+        // without either, the request is answered whole.
+        const sendChunk = params.stream ? responder.sendChunk?.bind(responder) : undefined;
+        const chunkRequestId = sendChunk ? responder.requestId : undefined;
+        const streamed = chunkRequestId != null;
         try {
-            // 5. Run inference
-            if (params.stream && this.sendChunkFn && responder.requestId != null) {
-                // Streaming mode
-                await this.handleStreaming(serverId, model, request, responder);
-            }
-            else {
-                // Non-streaming mode
-                const response = await this.membrane.complete(request);
-                // Extract text content from response
-                const contentText = response.content
-                    .filter((b) => b.type === 'text')
-                    .map((b) => b.text)
-                    .join('');
-                const result = {
-                    content: contentText,
-                    model,
-                    finishReason: this.mapStopReason(response.stopReason),
-                    usage: {
-                        inputTokens: response.usage.inputTokens,
-                        outputTokens: response.usage.outputTokens,
-                    },
-                };
-                // Emit trace: inference complete
-                this.emitTraceFn({
-                    type: 'mcpl:inference_complete',
-                    serverId,
-                    model,
-                    inputTokens: result.usage.inputTokens,
-                    outputTokens: result.usage.outputTokens,
-                });
-                responder.respond(result);
-            }
+            // 5. Run inference. Both modes end in membrane's response, and one
+            // builder makes the result from it.
+            const response = chunkRequestId != null
+                ? await this.streamResponse(request, chunkRequestId, sendChunk)
+                : await this.membrane.complete(request);
+            // 6. Answer
+            const result = resultFrom(response, model);
+            const actualModel = actualModelOf(response);
+            this.emitTraceFn({
+                type: 'mcpl:inference_complete',
+                serverId,
+                // The routed model, as inference_start has it. actualModel is the one
+                // the result reports, left out when membrane named none.
+                model,
+                ...(actualModel !== undefined ? { actualModel } : {}),
+                inputTokens: result.usage.inputTokens,
+                outputTokens: result.usage.outputTokens,
+                streamed,
+            });
+            responder.respond(result);
         }
         catch (err) {
-            // Emit trace: inference failed
+            // Every ending that isn't a completion lands here, in either mode:
+            // membrane's error, a stream that stopped early, a tool call, or a
+            // stop FinishReason can't name. The answer is the JSON-RPC error, never
+            // a result carrying what arrived.
             this.emitTraceFn({
                 type: 'mcpl:inference_fail',
                 serverId,
                 model,
                 error: err instanceof Error ? err.message : String(err),
+                streamed,
             });
             responder.respondError(-32603, err instanceof Error ? err.message : 'Inference failed');
         }
@@ -190,60 +273,45 @@ export class InferenceRouter {
     // Private: Streaming
     // ==========================================================================
     /**
-     * Handle streaming inference by sending chunks back to the server.
+     * Run the inference as a stream, sending each visible text delta to the
+     * server as an inference/chunk, and return membrane's response once the
+     * stream completes.
      *
-     * Uses membrane.streamYielding when available; falls back to non-streaming
-     * membrane.complete otherwise.
+     * Every other ending throws, so the request is answered with the error
+     * rather than with the text that arrived: membrane's `error`, an `aborted`
+     * stream, a stream that ends with no terminal event, and `tool-calls`. A
+     * stream that has yielded tool calls waits for their results until it is
+     * cancelled, and inference/request offers the model no tools. Leaving the
+     * loop by return or throw calls the stream's return(), which cancels it,
+     * so nothing keeps running once the request is answered.
      */
-    async handleStreaming(serverId, model, request, responder) {
-        const requestId = responder.requestId;
-        // Check if streamYielding is available on the membrane instance.
-        // We use streamYielding to iterate events and forward text deltas as chunks.
+    async streamResponse(request, requestId, sendChunk) {
         const stream = this.membrane.streamYielding(request);
-        let chunkIndex = 0;
-        let fullContent = '';
+        let index = 0;
         for await (const event of stream) {
-            if (event.type === 'tokens' && 'content' in event) {
-                const delta = event.content;
-                fullContent += delta;
-                this.sendChunkFn(serverId, {
-                    requestId,
-                    index: chunkIndex++,
-                    delta,
-                });
+            switch (event.type) {
+                case 'tokens':
+                    // Only text membrane marks visible is sent, which leaves out
+                    // thinking and tool-call markup. The result's content is the
+                    // response's text blocks, which membrane parses on its own, so in
+                    // XML tool mode the chunks can miss text the content holds: prose
+                    // naming a tag the stream parser opens a block for, or a thinking
+                    // block cut off before its close tag.
+                    if (event.meta.visible) {
+                        sendChunk({ requestId, index: index++, delta: event.content });
+                    }
+                    break;
+                case 'tool-calls':
+                    throw toolCallError(event.calls);
+                case 'complete':
+                    return event.response;
+                case 'error':
+                    throw event.error;
+                case 'aborted':
+                    throw new Error(`The inference stopped before it finished (${event.reason})`);
             }
         }
-        // After streaming completes, send the final result
-        const result = {
-            content: fullContent,
-            model,
-            finishReason: 'end_turn',
-            usage: { inputTokens: 0, outputTokens: 0 },
-        };
-        this.emitTraceFn({
-            type: 'mcpl:inference_complete',
-            serverId,
-            model,
-            streamed: true,
-        });
-        responder.respond(result);
-    }
-    // ==========================================================================
-    // Private: Helpers
-    // ==========================================================================
-    /**
-     * Map membrane's stopReason string to MCPL's finishReason enum.
-     */
-    mapStopReason(stopReason) {
-        switch (stopReason) {
-            case 'max_tokens':
-                return 'max_tokens';
-            case 'stop_sequence':
-                return 'stop_sequence';
-            case 'end_turn':
-            default:
-                return 'end_turn';
-        }
+        throw new Error('The inference stream ended without a result');
     }
 }
 //# sourceMappingURL=inference-router.js.map

package/dist/src/mcpl/inference-router.js.map

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

package/dist/src/mcpl/log-value.d.ts

@@ -42,6 +42,13 @@
  * of those can read (a revoked Proxy) as `[unprintable]`.
  */
 export declare function logValue(value: unknown): string;
+/**
+ * `logValue` of a value a server chose whose text may hold a credential:
+ * its text, as logValue reads it (a JSON value as its JSON text), with
+ * `redact` applied, then printed as logValue prints a field. A value whose
+ * text holds nothing `redact` replaces prints exactly as logValue prints it.
+ */
+export declare function logValueRedacted(value: unknown, redact: (text: string) => string): string;
 /**
  * The host's own message, as the free text that ends a log line after its
  * fields: `reason=coalesce-invalid field=payload.content: "content must be an

package/dist/src/mcpl/log-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-value.d.ts","sourceRoot":"","sources":["../../../src/mcpl/log-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"log-value.d.ts","sourceRoot":"","sources":["../../../src/mcpl/log-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAEzF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD"}

package/dist/src/mcpl/log-value.js

@@ -44,6 +44,15 @@
 export function logValue(value) {
     return printed(textOf(value), FIELD);
 }
+/**
+ * `logValue` of a value a server chose whose text may hold a credential:
+ * its text, as logValue reads it (a JSON value as its JSON text), with
+ * `redact` applied, then printed as logValue prints a field. A value whose
+ * text holds nothing `redact` replaces prints exactly as logValue prints it.
+ */
+export function logValueRedacted(value, redact) {
+    return printed(redact(textOf(value)), FIELD);
+}
 /**
  * The host's own message, as the free text that ends a log line after its
  * fields: `reason=coalesce-invalid field=payload.content: "content must be an

package/dist/src/mcpl/log-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-value.js","sourceRoot":"","sources":["../../../src/mcpl/log-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAQD,MAAM,KAAK,GAAS;IAClB,KAAK,EAAE,6DAA6D;IACpE,OAAO,EAAE,uDAAuD;CACjE,CAAC;AAEF,MAAM,MAAM,GAAS;IACnB,KAAK,EAAE,4DAA4D;IACnE,OAAO,EAAE,2DAA2D;CACrE,CAAC;AAEF,iEAAiE;AACjE,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,SAAS,OAAO,CAAC,IAAY,EAAE,IAAU;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzF,IAAI,GAAG,GAAG,WAAW,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;QAAE,GAAG,EAAE,CAAC;IAC5C,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;AAChE,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,IAAU;IACtC,0EAA0E;IAC1E,yEAAyE;IACzE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,2EAA2E;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;QAC5C,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;QACnB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;KAC5C,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACxG,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"log-value.js","sourceRoot":"","sources":["../../../src/mcpl/log-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,MAAgC;IAC/E,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAQD,MAAM,KAAK,GAAS;IAClB,KAAK,EAAE,6DAA6D;IACpE,OAAO,EAAE,uDAAuD;CACjE,CAAC;AAEF,MAAM,MAAM,GAAS;IACnB,KAAK,EAAE,4DAA4D;IACnE,OAAO,EAAE,2DAA2D;CACrE,CAAC;AAEF,iEAAiE;AACjE,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,SAAS,OAAO,CAAC,IAAY,EAAE,IAAU;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzF,IAAI,GAAG,GAAG,WAAW,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;QAAE,GAAG,EAAE,CAAC;IAC5C,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;AAChE,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,IAAU;IACtC,0EAA0E;IAC1E,yEAAyE;IACzE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,2EAA2E;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;QAC5C,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;QACnB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;KAC5C,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACxG,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/mcpl/modern-connection.d.ts

@@ -0,0 +1,227 @@
+import { EventEmitter } from 'node:events';
+import { type CallToolResult } from '@modelcontextprotocol/client';
+import type { McplServerConfig, McpToolDefinition } from './types.js';
+/** A modern tool result as the framework consumes it. `structuredContent` is
+ *  kept by presence: `false`, `0` and `null` are values, not absence. */
+export interface ModernToolCallResult {
+    content: CallToolResult['content'];
+    isError?: boolean;
+    structuredContent?: unknown;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * The diagnostic for a line that is JSON but not a JSON-RPC message: the
+ * line's first 200 characters, after the configuration's credentials are
+ * replaced, so a credential across the cut can't leave its first part.
+ */
+export declare function malformedLineDiagnostic(config: McplServerConfig, text: string, error: unknown, recorded?: (text: unknown) => string): string;
+export declare class ModernMcpConnection extends EventEmitter {
+    private readonly config;
+    readonly id: string;
+    readonly family: 'modern';
+    readonly transportKind: 'stdio' | 'http';
+    /** The pinned revision, once a connect has established it; null before. */
+    protocolVersion: string | null;
+    private session;
+    /** A connect in flight, owned so `close()` can end it. */
+    private opening;
+    private generation;
+    private closedByHost;
+    private reconnectEnabled;
+    private readonly reconnectIntervalMs;
+    private readonly reconnectMaxIntervalMs;
+    private reconnectTimer;
+    private reconnectAttempts;
+    /** At most one pending reopen, and only ever for the current generation. */
+    private relisten;
+    private relistenAttempts;
+    /**
+     * Generations whose cleanup could not confirm their child exited. While any
+     * is held, no replacement is started: launching another would orphan the
+     * first. close() retries them and reports what still fails.
+     */
+    private unreaped;
+    /** A lost session's reap in flight: the reconnect follows it, and
+     *  close() waits for it. */
+    private losing;
+    /** Child stderr from before anyone listens (the caller attaches only once
+     *  connect() returns), delivered to the first listener. Bounded: the
+     *  newest lines are kept. */
+    private stderrBacklog;
+    private constructor();
+    private deliverStderr;
+    /** The per-call deadline: `requestTimeoutMs`, validated positive. */
+    get requestTimeoutMs(): number;
+    get isConnected(): boolean;
+    /** Whether a lost connection will be re-established in the background. */
+    get willReconnect(): boolean;
+    /** Whether close() has been called: closed for good, or closing. A
+     *  connection lost on its own is not closed in this sense. */
+    get isClosed(): boolean;
+    /** Whether a child this connection launched couldn't be confirmed exited.
+     *  While it's true the connection owns that child, so whatever registered
+     *  it keeps its id held; close() retries the reap. It's settled only once
+     *  a reap has finished: while a lost session's reap or a close runs, it
+     *  reads false, so read it once lossReaped() or close() has settled. */
+    get holdsUnreapedChild(): boolean;
+    /** The reap of a session lost on its own, settled once it's done, whether
+     *  or not it confirmed the child exited (holdsUnreapedChild says which);
+     *  settled at once when no such reap is running. */
+    lossReaped(): Promise<void>;
+    /** A failed generation's cleanup couldn't reap its child: keep owning it,
+     *  and halt reconnecting until close() settles it. */
+    private holdUnreaped;
+    /** The halt, as a permanent failure for the reconnect events. */
+    private unreapedFailure;
+    /**
+     * A connection that hasn't started: configuration is validated (and
+     * throws), nothing is launched or dialed. An owner can register it, and
+     * wire its events, before {@link start}, so a connect in flight is
+     * already the owner's to close.
+     */
+    static create(config: McplServerConfig): ModernMcpConnection;
+    /** The first connect, shared by every call to start(). */
+    private starting;
+    /**
+     * The first connect. Without `reconnect` a failure throws. With it, the
+     * connection keeps retrying in the background, as the legacy engine's
+     * stub does, and reports `connect-failed`, unless the failed launch
+     * couldn't be reaped: no retry can come then, so it throws too. A
+     * connection closed before or during its first connect resolves
+     * unconnected. A connection starts once:
+     * later calls return the first call's promise, so a second session never
+     * opens beside the first.
+     */
+    start(): Promise<void>;
+    private firstConnect;
+    /**
+     * {@link create} and {@link start} in one step. A first connect that fails
+     * and whose cleanup couldn't confirm its child exited throws
+     * {@link McplUnreapedLaunchError}, whose connection owns that launch, as
+     * the legacy engine's connect does: its close() retries the reap.
+     */
+    static connect(config: McplServerConfig): Promise<ModernMcpConnection>;
+    private isCurrent;
+    /** One connect generation: a fresh client over a fresh transport. */
+    private open;
+    /** Connect one generation's client, and adopt it if it's still current. */
+    private establish;
+    /**
+     * The server refused the pinned revision (no common one in its
+     * `server/discover` answer, or an unsupported-version error): a
+     * configuration verdict, as for the legacy engine, in the same type, so
+     * every reader treats both engines alike. Retrying can't change it.
+     */
+    private versionVerdict;
+    /**
+     * Keep list-change awareness while this generation lives. The SDK opens the
+     * subscription at connect when the server advertises tool list changes. If
+     * that open failed (the SDK reports it through `onerror` and connects
+     * anyway), or the subscription later ends without our asking, it is
+     * reopened with backoff. Once it's back the inventory is refreshed, since
+     * changes may have been missed. A lost transport is the reconnect path's
+     * job, not this one's.
+     */
+    private keepListening;
+    private cancelRelisten;
+    private scheduleRelisten;
+    private reopenSubscription;
+    /** The transport went away (child exit, or a closed HTTP client). */
+    private handleLost;
+    /** The legacy engine's backoff: doubling from the base interval, capped,
+     *  with ±25% jitter, and never past the timer limit (a longer delay would
+     *  fire at once, turning the backoff into a tight loop). */
+    private backoffDelay;
+    private scheduleReconnect;
+    private attemptReconnect;
+    /**
+     * The server's complete tool inventory. The SDK follows every page; one
+     * budget, {@link LIST_TIMEOUT_MS}, bounds the whole walk, not each page.
+     * Its failures use the request-outcome contract with `tools/list` as the
+     * observed method. A relist the SDK makes inside a tool call is auxiliary
+     * to that call, and leaves the call's evidence alone.
+     */
+    listTools(): Promise<McpToolDefinition[]>;
+    /**
+     * Call a tool within the configured deadline. One budget covers the whole
+     * logical call: the SDK's per-leg timer and its `maxTotalTimeout` across
+     * continuation rounds, and an abort signal around any retry the SDK makes
+     * before dispatch (an auth refresh, or a header-mismatch relist).
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<ModernToolCallResult>;
+    /** Run one logical request in a wire scope, and classify its failure by
+     *  what that scope saw. `what` names the request in the host's log: its
+     *  method, and a tool call's tool as a log field. */
+    private request;
+    /**
+     * Close one generation: the transport first (during discovery the SDK
+     * hasn't attached it yet, so only closing it ends the probe), then the
+     * client. The transport's close is the reaping verdict, and its failure is
+     * returned, never swallowed. It never rejects, which lossReaped() and the
+     * framework's unguarded wait on it rely on.
+     */
+    private static closeSession;
+    /** The close in flight, which later calls wait behind. */
+    private closing;
+    /** Set when the host closes a live session; cleared, with the one
+     *  'close', by the close that confirms its teardown. */
+    private closeIncomplete;
+    /**
+     * Close for good: no reconnect, no reopened subscription, no connect left
+     * in flight. Awaits the in-flight connect's end, and rejects while a child
+     * can't be confirmed exited: with that failure itself, the transport's
+     * own error, or an AggregateError when there are several, as the MCPL
+     * engine does. Calls queue behind the one in flight, so none resolves
+     * while teardown is still pending. A call after a failed close re-checks
+     * what wasn't reaped. 'close' is emitted once, when the teardown of a
+     * session the host closed while live completes, not on a failed close.
+     */
+    close(): Promise<void>;
+    private closeStep;
+    /** What works from here after a request that didn't run, by whether this
+     *  host is reconnecting to the server, in the legacy engine's words. */
+    private retryText;
+    /**
+     * Map a failure onto the request-outcome contract by what crossed the
+     * transport boundary for this request, claiming no more than that shows.
+     * The rules apply in this order. The call's answer is the server's final
+     * one: an error or a `complete` result.
+     * - nothing handed to the transport: `not-sent`, whatever was raised (a
+     *   pre-dispatch validation, a signal already aborted, no transport, a send
+     *   Connectome's stdio line refused before writing, an HTTP refusal before
+     *   any request went out);
+     * - the most recent leg answered with a JSON-RPC error: `error-response`
+     *   with that error's data;
+     * - the most recent leg answered with a complete result: the server
+     *   finished, but what it returned can't be used (output validation).
+     *   That's a plain error, not a request outcome;
+     * - the most recent leg answered without finishing the call: `no-response`,
+     *   since the server may have acted on what it received. An
+     *   `input_required` answer asks for another round, and the call can end
+     *   before that round is sent: at the deadline, when the connection is
+     *   gone, or when this client can't go on (input it can't supply, the
+     *   rounds cap). Nothing is in flight then, so nothing is cancelled. A
+     *   result of a type this client doesn't recognize ends the call where it
+     *   is;
+     * - an HTTP 401/403 refusal of the current leg: `error-response`, the
+     *   status in `data.httpStatus` (the server answered at the HTTP layer,
+     *   outside the JSON-RPC code space). After an earlier leg
+     *   asked for another round it is `no-response` instead: the server may
+     *   already have acted on the call;
+     * - handed off and unanswered: `no-response`. At the deadline, cancellation
+     *   was requested and the outcome is unknown.
+     *
+     * The message is the agent's, in the legacy engine's words where it has
+     * words for the same outcome (#506), and in their shape where it hasn't:
+     * what happened, whether anything took effect, and what works from there.
+     * A request this host's close cut off, and one whose connection closed
+     * under it (`lost`), read as the legacy engine's do. The method, the tool,
+     * the JSON-RPC code, the HTTP status, the deadline in milliseconds and the
+     * SDK's or transport's words are the operator's, so they go to one log
+     * line, the server's text redacted. Where the effect is in doubt, a tool
+     * call's message says to check it before trying again, and a listing's that
+     * listing changes nothing on the server, so trying again is safe.
+     */
+    private requestFailure;
+}
+//# sourceMappingURL=modern-connection.d.ts.map

package/dist/src/mcpl/modern-connection.d.ts.map

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