@animalabs/agent-framework 0.1.0

package/dist/src/mcpl/hook-orchestrator.js

@@ -0,0 +1,217 @@
+/**
+ * HookOrchestrator — manages before/after inference fan-out to MCPL servers.
+ *
+ * This is the bridge between the MCPL protocol and the agent-framework inference
+ * pipeline. It collects ContextInjection[] from MCPL servers via beforeInference
+ * and feeds them into context-manager's compile(). After inference, it notifies
+ * servers of the result via afterInference.
+ *
+ * Design principles:
+ * - Fail-open: timeouts and errors never block inference
+ * - Parallel fan-out with per-server timeouts
+ * - Loop prevention: rejects inference/request while inside a hook
+ */
+/** Timeout for beforeInference per server (fail-open). */
+const BEFORE_INFERENCE_TIMEOUT_MS = 5_000;
+/** Timeout for blocking afterInference per server. */
+const AFTER_INFERENCE_BLOCKING_TIMEOUT_MS = 10_000;
+/**
+ * Races a promise against a timeout. Rejects with a descriptive error on timeout.
+ */
+function withTimeout(promise, ms, label) {
+    return Promise.race([
+        promise,
+        new Promise((_resolve, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms)),
+    ]);
+}
+// ============================================================================
+// Content conversion: McplContentBlock / McplContextInjection → membrane types
+// ============================================================================
+/**
+ * Convert a single MCPL wire-format content block to a membrane ContentBlock.
+ */
+function convertBlock(block) {
+    switch (block.type) {
+        case 'text':
+            return { type: 'text', text: block.text };
+        case 'image':
+            if (block.data && block.mimeType) {
+                return {
+                    type: 'image',
+                    source: { type: 'base64', data: block.data, mediaType: block.mimeType },
+                };
+            }
+            if (block.uri) {
+                return {
+                    type: 'image',
+                    source: { type: 'url', url: block.uri },
+                };
+            }
+            // Malformed image block — degrade to text
+            return { type: 'text', text: '[Image: missing data]' };
+        case 'audio':
+            if (block.data && block.mimeType) {
+                return {
+                    type: 'audio',
+                    source: { type: 'base64', data: block.data, mediaType: block.mimeType },
+                };
+            }
+            // Audio without inline data — degrade to text
+            return { type: 'text', text: `[Audio: ${block.uri ?? 'missing data'}]` };
+        case 'resource':
+            // Resources don't have a direct membrane equivalent — degrade to text
+            return { type: 'text', text: `[Resource: ${block.uri}]` };
+    }
+}
+/**
+ * Convert MCPL injection content (string shorthand or block array) to membrane ContentBlock[].
+ */
+function convertContent(content) {
+    if (typeof content === 'string') {
+        return [{ type: 'text', text: content }];
+    }
+    return content.map(convertBlock);
+}
+/**
+ * Convert an MCPL wire-format context injection to a context-manager ContextInjection.
+ */
+function convertMcplInjection(mcplInj) {
+    return {
+        namespace: mcplInj.namespace,
+        position: mcplInj.position,
+        content: convertContent(mcplInj.content),
+        metadata: mcplInj.metadata,
+    };
+}
+// ============================================================================
+// HookOrchestrator
+// ============================================================================
+export class HookOrchestrator {
+    registry;
+    featureSetManager;
+    _isInHook = false;
+    constructor(registry, featureSetManager) {
+        this.registry = registry;
+        this.featureSetManager = featureSetManager;
+    }
+    /**
+     * Whether a hook is currently executing.
+     * Used for loop prevention: inference/request from servers should be rejected
+     * while this is true (enforced by Step 6's InferenceRouter).
+     */
+    get isInHook() {
+        return this._isInHook;
+    }
+    /**
+     * Fan out `context/beforeInference` to all capable MCPL servers in parallel.
+     *
+     * Returns aggregated ContextInjection[] ready for context-manager's compile().
+     * Fail-open: servers that time out or error are silently skipped.
+     */
+    async beforeInference(params) {
+        const servers = this.registry.getServersWithCapability('contextHooks.beforeInference');
+        if (servers.length === 0) {
+            return [];
+        }
+        this._isInHook = true;
+        try {
+            return await this.fanOutBeforeInference(servers, params);
+        }
+        finally {
+            this._isInHook = false;
+        }
+    }
+    /**
+     * Fan out `context/afterInference` to all capable MCPL servers.
+     *
+     * Non-blocking servers receive a notification (fire-and-forget).
+     * Blocking servers receive a request with a 10s timeout.
+     * Returns the first valid AfterInferenceResult from a blocking server, or null.
+     */
+    async afterInference(params) {
+        const servers = this.registry.getServersWithCapability('contextHooks.afterInference');
+        if (servers.length === 0) {
+            return null;
+        }
+        this._isInHook = true;
+        try {
+            return await this.fanOutAfterInference(servers, params);
+        }
+        finally {
+            this._isInHook = false;
+        }
+    }
+    // ==========================================================================
+    // Private: beforeInference fan-out
+    // ==========================================================================
+    async fanOutBeforeInference(servers, params) {
+        const results = await Promise.allSettled(servers.map((server) => withTimeout(server.sendBeforeInference(params), BEFORE_INFERENCE_TIMEOUT_MS, `beforeInference to "${server.id}"`).then((result) => ({ server, result }))));
+        const injections = [];
+        for (const settled of results) {
+            if (settled.status === 'rejected') {
+                // Fail-open: timeout or transport error — skip this server
+                continue;
+            }
+            const { server, result } = settled.value;
+            // Validate feature set
+            try {
+                this.featureSetManager.validateInbound(server.id, result.featureSet);
+            }
+            catch {
+                // Feature set not enabled or unknown — skip injections from this server
+                continue;
+            }
+            // Convert wire-format injections to context-manager format
+            if (result.contextInjections && result.contextInjections.length > 0) {
+                for (const mcplInj of result.contextInjections) {
+                    injections.push(convertMcplInjection(mcplInj));
+                }
+            }
+        }
+        return injections;
+    }
+    // ==========================================================================
+    // Private: afterInference fan-out
+    // ==========================================================================
+    async fanOutAfterInference(servers, params) {
+        const blockingPromises = [];
+        for (const server of servers) {
+            const isBlocking = this.isBlockingAfterInference(server);
+            if (isBlocking) {
+                // Send as request, await response with timeout
+                const promise = withTimeout(server.sendAfterInference(params, true), AFTER_INFERENCE_BLOCKING_TIMEOUT_MS, `afterInference (blocking) to "${server.id}"`).catch(() => {
+                    // Fail-open: timeout or error — treat as no modification
+                    return null;
+                });
+                blockingPromises.push(promise);
+            }
+            else {
+                // Send as notification (fire-and-forget)
+                server.sendAfterInference(params, false);
+            }
+        }
+        if (blockingPromises.length === 0) {
+            return null;
+        }
+        // Await all blocking responses and return the first valid result
+        const results = await Promise.all(blockingPromises);
+        for (const result of results) {
+            if (result && result.modifiedResponse) {
+                return result;
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if a server's afterInference capability is blocking.
+     */
+    isBlockingAfterInference(server) {
+        const caps = server.capabilities;
+        if (!caps?.contextHooks?.afterInference) {
+            return false;
+        }
+        const afterCap = caps.contextHooks.afterInference;
+        return typeof afterCap === 'object' && afterCap !== null && 'blocking' in afterCap && afterCap.blocking === true;
+    }
+}
+//# sourceMappingURL=hook-orchestrator.js.map

package/dist/src/mcpl/hook-orchestrator.js.map

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

package/dist/src/mcpl/index.d.ts

@@ -0,0 +1,14 @@
+export type { JsonRpcRequest, JsonRpcResponse, JsonRpcError, McplContentBlock, McplTextContent, McplImageContent, McplAudioContent, McplResourceContent, McplCapabilities, McplHostCapabilities, McplChannelCapabilities, McplServerConfig, FeatureSetUse, FeatureSetDeclaration, FeatureSetsUpdateParams, FeatureSetsChangedParams, ScopeConfig, ScopeLabel, ScopeElevateParams, ScopeElevateResult, StateCheckpoint, JsonPatchOperation, StateRollbackParams, StateRollbackResult, PushEventParams, PushEventResult, McplModelInfo, BeforeInferenceParams, McplContextInjection, BeforeInferenceResult, AfterInferenceParams, AfterInferenceResult, McplMessage, McplInferenceRequestParams, McplInferencePreferences, McplInferenceRequestResult, InferenceChunkParams, ChannelDescriptor, ChannelContext, ChannelsRegisterParams, ChannelsRegisterResult, ChannelsChangedParams, ChannelsListResult, ChannelsOpenParams, ChannelsOpenResult, ChannelsCloseParams, ChannelsCloseResult, ChannelsOutgoingChunkParams, ChannelsOutgoingCompleteParams, ChannelsPublishParams, ChannelsPublishResult, ChannelIncomingMessage, ChannelsIncomingParams, ChannelsIncomingResult, ChannelIncomingMessageResult, InferenceRoutingPolicy, McplMethodName, McpToolDefinition, McpToolCallResult, McpToolResultContent, } from './types.js';
+export { McplMethod } from './types.js';
+export { FEATURE_SET_NOT_ENABLED, UNKNOWN_FEATURE_SET, CHECKPOINT_NOT_FOUND, CHANNEL_NOT_PERMITTED, UNKNOWN_CHANNEL, CHANNEL_OPEN_FAILED, featureSetNotEnabled, unknownFeatureSet, checkpointNotFound, channelNotPermitted, unknownChannel, channelOpenFailed, } from './errors.js';
+export { McplServerConnection } from './server-connection.js';
+export { McplServerRegistry, type McplCapabilityQuery } from './server-registry.js';
+export { FeatureSetManager, McplFeatureSetError } from './feature-set-manager.js';
+export { ScopeManager, type ElevationHandler } from './scope-manager.js';
+export { HookOrchestrator } from './hook-orchestrator.js';
+export { PushHandler } from './push-handler.js';
+export type { McplPushEvent } from './push-handler.js';
+export { InferenceRouter } from './inference-router.js';
+export { ChannelRegistry } from './channel-registry.js';
+export { CheckpointManager, applyJsonPatch } from './checkpoint-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/mcpl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcpl/index.ts"],"names":[],"mappings":"AACA,YAAY,EAEV,cAAc,EACd,eAAe,EACf,YAAY,EAGZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EAGnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EAGvB,gBAAgB,EAGhB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EAGxB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAGlB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EAGnB,eAAe,EACf,eAAe,EAGf,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EAGpB,WAAW,EACX,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EAGpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAG5B,sBAAsB,EAGtB,cAAc,EAGd,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGpF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/mcpl/index.js

@@ -0,0 +1,21 @@
+export { McplMethod } from './types.js';
+// Error codes and factories
+export { FEATURE_SET_NOT_ENABLED, UNKNOWN_FEATURE_SET, CHECKPOINT_NOT_FOUND, CHANNEL_NOT_PERMITTED, UNKNOWN_CHANNEL, CHANNEL_OPEN_FAILED, featureSetNotEnabled, unknownFeatureSet, checkpointNotFound, channelNotPermitted, unknownChannel, channelOpenFailed, } from './errors.js';
+// Server connection and registry
+export { McplServerConnection } from './server-connection.js';
+export { McplServerRegistry } from './server-registry.js';
+// Feature set management (permission layer)
+export { FeatureSetManager, McplFeatureSetError } from './feature-set-manager.js';
+// Scope management (whitelist/blacklist enforcement)
+export { ScopeManager } from './scope-manager.js';
+// Hook orchestration (beforeInference/afterInference fan-out)
+export { HookOrchestrator } from './hook-orchestrator.js';
+// Push events (Section 9)
+export { PushHandler } from './push-handler.js';
+// Server-initiated inference (Section 11)
+export { InferenceRouter } from './inference-router.js';
+// Channel registry (channel lifecycle, incoming messages, synthesized tools)
+export { ChannelRegistry } from './channel-registry.js';
+// State management (Section 8, checkpoint trees + JSON Patch)
+export { CheckpointManager, applyJsonPatch } from './checkpoint-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/src/mcpl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcpl/index.ts"],"names":[],"mappings":"AA2FA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,4BAA4B;AAC5B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,iCAAiC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAA4B,MAAM,sBAAsB,CAAC;AAEpF,4CAA4C;AAC5C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAElF,qDAAqD;AACrD,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAEzE,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,6EAA6E;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,8DAA8D;AAC9D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/mcpl/inference-router.d.ts

@@ -0,0 +1,67 @@
+/**
+ * InferenceRouter — handles inference/request from MCPL servers.
+ *
+ * Servers can ask the host to run inference on their behalf. This router
+ * validates permissions, resolves the target model via routing policy,
+ * runs inference through membrane, and optionally streams chunks back.
+ *
+ * Spec reference: Section 11 (Server-Initiated Inference).
+ */
+import type { Membrane } from '@animalabs/membrane';
+import type { McplInferenceRequestParams, McplInferenceRequestResult, InferenceChunkParams, InferenceRoutingPolicy } from './types.js';
+import type { FeatureSetManager } from './feature-set-manager.js';
+import type { HookOrchestrator } from './hook-orchestrator.js';
+/** Minimal responder interface for sending JSON-RPC results back. */
+interface Responder {
+    respond(result: McplInferenceRequestResult): void;
+    respondError(code: number, message: string, data?: unknown): void;
+    /** The JSON-RPC request ID, used for streaming chunk correlation. */
+    requestId?: string | number;
+}
+export declare class InferenceRouter {
+    private membrane;
+    private hookOrchestrator;
+    private featureSetManager;
+    private routingPolicy;
+    private emitTraceFn;
+    private sendChunkFn?;
+    constructor(membrane: Membrane, hookOrchestrator: HookOrchestrator, featureSetManager: FeatureSetManager, routingPolicy: InferenceRoutingPolicy | null, emitTraceFn: (event: {
+        type: string;
+        [key: string]: unknown;
+    }) => void, sendChunkFn?: (serverId: string, params: InferenceChunkParams) => void);
+    /**
+     * Handle an inference/request from an MCPL server.
+     *
+     * 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
+     */
+    handleInferenceRequest(serverId: string, params: McplInferenceRequestParams, responder: Responder): Promise<void>;
+    /**
+     * Resolve the model to use for an inference request based on routing policy.
+     *
+     * Priority:
+     * 1. Per-conversation override
+     * 2. Exact feature set match
+     * 3. Wildcard pattern match (first match wins)
+     * 4. Default from policy
+     * 5. Fallback string 'default'
+     */
+    private resolveModel;
+    /**
+     * Handle streaming inference by sending chunks back to the server.
+     *
+     * Uses membrane.streamYielding when available; falls back to non-streaming
+     * membrane.complete otherwise.
+     */
+    private handleStreaming;
+    /**
+     * Map membrane's stopReason string to MCPL's finishReason enum.
+     */
+    private mapStopReason;
+}
+export {};
+//# sourceMappingURL=inference-router.d.ts.map

package/dist/src/mcpl/inference-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference-router.d.ts","sourceRoot":"","sources":["../../../src/mcpl/inference-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAmC,MAAM,qBAAqB,CAAC;AAErF,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,qEAAqE;AACrE,UAAU,SAAS;IACjB,OAAO,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAClD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClE,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAyCD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,WAAW,CAA4D;IAC/E,OAAO,CAAC,WAAW,CAAC,CAA2D;gBAG7E,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,EAClC,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,sBAAsB,GAAG,IAAI,EAC5C,WAAW,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,EACtE,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,KAAK,IAAI;IAUxE;;;;;;;;;OASG;IACG,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,0BAA0B,EAClC,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC;IA4GhB;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IAmCpB;;;;;OAKG;YACW,eAAe;IAgD7B;;OAEG;IACH,OAAO,CAAC,aAAa;CAatB"}

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

@@ -0,0 +1,249 @@
+/**
+ * InferenceRouter — handles inference/request from MCPL servers.
+ *
+ * Servers can ask the host to run inference on their behalf. This router
+ * validates permissions, resolves the target model via routing policy,
+ * runs inference through membrane, and optionally streams chunks back.
+ *
+ * Spec reference: Section 11 (Server-Initiated Inference).
+ */
+import { McplFeatureSetError } from './feature-set-manager.js';
+// ============================================================================
+// Wildcard matching (same logic as feature-set-manager)
+// ============================================================================
+/**
+ * Simple glob match: split on `.`, `*` matches any single segment.
+ */
+function wildcardMatch(pattern, name) {
+    const patternParts = pattern.split('.');
+    const nameParts = name.split('.');
+    if (patternParts.length !== nameParts.length) {
+        return false;
+    }
+    for (let i = 0; i < patternParts.length; i++) {
+        const p = patternParts[i];
+        if (p === '*') {
+            continue;
+        }
+        if (p !== nameParts[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default max tokens when not specified in preferences. */
+const DEFAULT_MAX_TOKENS = 4096;
+// ============================================================================
+// InferenceRouter
+// ============================================================================
+export class InferenceRouter {
+    membrane;
+    hookOrchestrator;
+    featureSetManager;
+    routingPolicy;
+    emitTraceFn;
+    sendChunkFn;
+    constructor(membrane, hookOrchestrator, featureSetManager, routingPolicy, emitTraceFn, sendChunkFn) {
+        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.
+     *
+     * 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
+     */
+    async handleInferenceRequest(serverId, params, responder) {
+        // 1. Validate feature set
+        try {
+            this.featureSetManager.validateInbound(serverId, params.featureSet);
+        }
+        catch (err) {
+            const message = err instanceof McplFeatureSetError
+                ? err.message
+                : 'Feature set validation failed';
+            const code = err instanceof McplFeatureSetError ? err.code : -32600;
+            responder.respondError(code, message);
+            return;
+        }
+        // 2. Loop prevention: reject if inside a hook
+        if (this.hookOrchestrator.isInHook) {
+            responder.respondError(-32600, 'Cannot process inference request during hook execution');
+            return;
+        }
+        // 3. Resolve model
+        const model = this.resolveModel(params.featureSet, params.conversationId);
+        // Emit trace: inference start
+        this.emitTraceFn({
+            type: 'mcpl:inference_start',
+            serverId,
+            featureSet: params.featureSet,
+            model,
+            stream: params.stream ?? false,
+        });
+        // 4. Build membrane-compatible request
+        const messages = params.messages.map((msg) => ({
+            participant: msg.role === 'assistant' ? 'assistant' : 'user',
+            content: [{ type: 'text', text: msg.content }],
+        }));
+        const request = {
+            messages,
+            config: {
+                model,
+                maxTokens: params.preferences?.maxTokens ?? DEFAULT_MAX_TOKENS,
+                temperature: params.preferences?.temperature,
+            },
+        };
+        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);
+            }
+        }
+        catch (err) {
+            // Emit trace: inference failed
+            this.emitTraceFn({
+                type: 'mcpl:inference_fail',
+                serverId,
+                model,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            responder.respondError(-32603, err instanceof Error ? err.message : 'Inference failed');
+        }
+    }
+    // ==========================================================================
+    // Private: Model resolution
+    // ==========================================================================
+    /**
+     * Resolve the model to use for an inference request based on routing policy.
+     *
+     * Priority:
+     * 1. Per-conversation override
+     * 2. Exact feature set match
+     * 3. Wildcard pattern match (first match wins)
+     * 4. Default from policy
+     * 5. Fallback string 'default'
+     */
+    resolveModel(featureSet, conversationId) {
+        if (!this.routingPolicy) {
+            return 'default';
+        }
+        // Check per-conversation override
+        if (conversationId && this.routingPolicy.overrides?.[conversationId]) {
+            return this.routingPolicy.overrides[conversationId];
+        }
+        // Check exact feature set match
+        if (this.routingPolicy.byFeature?.[featureSet]) {
+            return this.routingPolicy.byFeature[featureSet];
+        }
+        // Check wildcard patterns
+        if (this.routingPolicy.wildcards) {
+            for (const [pattern, matchedModel] of Object.entries(this.routingPolicy.wildcards)) {
+                if (wildcardMatch(pattern, featureSet)) {
+                    return matchedModel;
+                }
+            }
+        }
+        // Default
+        return this.routingPolicy.default;
+    }
+    // ==========================================================================
+    // Private: Streaming
+    // ==========================================================================
+    /**
+     * Handle streaming inference by sending chunks back to the server.
+     *
+     * Uses membrane.streamYielding when available; falls back to non-streaming
+     * membrane.complete otherwise.
+     */
+    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.
+        const stream = this.membrane.streamYielding(request);
+        let chunkIndex = 0;
+        let fullContent = '';
+        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,
+                });
+            }
+        }
+        // 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';
+        }
+    }
+}
+//# sourceMappingURL=inference-router.js.map

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

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