@clowder-ai/plugin-sdk 0.1.0-beta.10

package/dist/standalone-host.js

@@ -0,0 +1,249 @@
+import { readFile } from 'node:fs/promises';
+import { DEADLINE_EXPIRED_CODE, DEADLINE_EXPIRED_MESSAGE, DELIVERY_REJECTED_CODE, DELIVERY_REJECTED_MESSAGE, DELIVERY_REJECT_REASONS, METHOD_NOT_FOUND_CODE, METHOD_NOT_FOUND_MESSAGE, PARSE_ERROR_CODE, PARSE_ERROR_MESSAGE, validateManifest, } from '@clowder-ai/plugin-contract';
+import { createStdioChannel, startStdioRuntime, } from './stdio-runtime.js';
+import { classifyFrame } from './wire-dispatch.js';
+export class ManifestStartupError extends Error {
+    errors;
+    constructor(errors) {
+        super('plugin manifest failed contract validation');
+        this.name = 'ManifestStartupError';
+        this.errors = errors;
+    }
+}
+class StandaloneProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StandaloneProtocolError';
+    }
+}
+function requireValidManifest(value) {
+    const validation = validateManifest(value);
+    if (!validation.valid) {
+        throw new ManifestStartupError(validation.errors);
+    }
+    return validation.manifest;
+}
+function requireStdioManifest(value) {
+    const manifest = requireValidManifest(value);
+    if (manifest.runtime.transport !== 'stdio') {
+        throw new TypeError('standalone stdio host requires a manifest with runtime.transport "stdio"');
+    }
+    return manifest;
+}
+/**
+ * Loads and contract-validates a manifest file for a standalone plugin.
+ *
+ * File and JSON parsing errors deliberately propagate: callers have not yet
+ * started a transport, so no protocol peer can observe a partial startup.
+ */
+export async function loadStandaloneManifest(path) {
+    return requireValidManifest(JSON.parse(await readFile(path, 'utf8')));
+}
+function isObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requireRequest(value) {
+    const { id, method, params } = value;
+    if (typeof id !== 'string' || typeof method !== 'string' || !isObject(params) || !isObject(params.input)) {
+        throw new StandaloneProtocolError('classifier accepted a frame outside the standalone request boundary');
+    }
+    return { id, method, input: params.input };
+}
+function deadlineExpiredResponse(id) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: {
+            code: DEADLINE_EXPIRED_CODE,
+            message: DEADLINE_EXPIRED_MESSAGE,
+            data: {},
+        },
+    };
+}
+function methodNotFoundResponse(id) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: { code: METHOD_NOT_FOUND_CODE, message: METHOD_NOT_FOUND_MESSAGE },
+    };
+}
+function deliveryRejectedResponse(id, reason) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: {
+            code: DELIVERY_REJECTED_CODE,
+            message: DELIVERY_REJECTED_MESSAGE,
+            data: { reason },
+        },
+    };
+}
+const DELIVERY_REJECT_REASON_SET = new Set(DELIVERY_REJECT_REASONS);
+const HOST_BOUND_REQUEST_METHODS = new Set([
+    'broker.hello',
+    'broker.ready',
+    'events.publish',
+    'messaging.send',
+    'messaging.appendElements',
+    'messaging.subscribe',
+    'messaging.read',
+    'messaging.ack',
+    'messaging.snapshot',
+]);
+function isStandaloneMessageDisposition(value) {
+    if (!isObject(value) || typeof value.accepted !== 'boolean') {
+        return false;
+    }
+    if (value.accepted) {
+        return Object.keys(value).length === 1;
+    }
+    return Object.keys(value).length === 2
+        && typeof value.reason === 'string'
+        && DELIVERY_REJECT_REASON_SET.has(value.reason);
+}
+async function dispatchMessage(id, input, onMessage) {
+    if (onMessage === undefined) {
+        return deliveryRejectedResponse(id, 'NO_HANDLER');
+    }
+    let disposition;
+    try {
+        disposition = await onMessage(structuredClone(input));
+    }
+    catch {
+        return deliveryRejectedResponse(id, 'PLUGIN_INTERNAL');
+    }
+    if (!isStandaloneMessageDisposition(disposition)) {
+        return deliveryRejectedResponse(id, 'PLUGIN_INTERNAL');
+    }
+    if (!disposition.accepted) {
+        return deliveryRejectedResponse(id, disposition.reason);
+    }
+    return { jsonrpc: '2.0', id, result: { deliveryId: input.deliveryId } };
+}
+async function completesBeforeDrainDeadline(onDrain, deadlineUnixMs) {
+    if (Date.now() >= deadlineUnixMs) {
+        return false;
+    }
+    const cleanup = Promise.resolve().then(() => onDrain?.({ deadlineUnixMs }));
+    while (true) {
+        const remaining = deadlineUnixMs - Date.now();
+        if (remaining <= 0) {
+            return false;
+        }
+        let deadlineTimer;
+        try {
+            const completed = await Promise.race([
+                cleanup.then(() => true),
+                new Promise(resolve => {
+                    deadlineTimer = setTimeout(resolve, Math.min(remaining, 2 ** 31 - 1), false);
+                }),
+            ]);
+            if (completed) {
+                return Date.now() < deadlineUnixMs;
+            }
+        }
+        finally {
+            if (deadlineTimer !== undefined) {
+                clearTimeout(deadlineTimer);
+            }
+        }
+    }
+}
+function createFrameHandler(options) {
+    const inFlight = new Map();
+    return async (frame) => {
+        const dispatch = classifyFrame(frame, inFlight);
+        if (dispatch.outcome === 'respond') {
+            if (dispatch.response === undefined) {
+                throw new StandaloneProtocolError('classifier requested a response without an envelope');
+            }
+            return dispatch.response;
+        }
+        if (dispatch.outcome === 'close') {
+            throw new StandaloneProtocolError(`classifier rejected frame as ${dispatch.disposition ?? 'unknown'}`);
+        }
+        if (frame.value.method === 'host.grants.changed') {
+            // The notification is closed and legal, but S2 has no grant-gated
+            // behavior yet. Accepting it without fabricating a response preserves
+            // its notification semantics while keeping authorization fail-closed.
+            return undefined;
+        }
+        const request = requireRequest(frame.value);
+        if (HOST_BOUND_REQUEST_METHODS.has(request.method)) {
+            // The public contract makes these Host-bound inputs legal at T-M, but
+            // this standalone plugin has no Host Broker. Reply conservatively
+            // without storing ingress, session state, or activation.
+            return methodNotFoundResponse(request.id);
+        }
+        if (request.method === 'host.lifecycle.ping') {
+            const nonce = request.input.nonce;
+            if (typeof nonce !== 'string') {
+                throw new StandaloneProtocolError('classifier accepted ping without a nonce');
+            }
+            return { jsonrpc: '2.0', id: request.id, result: { nonce } };
+        }
+        if (request.method === 'host.messaging.deliver') {
+            return dispatchMessage(request.id, request.input, options.onMessage);
+        }
+        if (request.method === 'host.lifecycle.drain') {
+            const deadlineUnixMs = request.input.deadlineUnixMs;
+            if (typeof deadlineUnixMs !== 'number') {
+                throw new StandaloneProtocolError('classifier accepted drain without a deadline');
+            }
+            if (!(await completesBeforeDrainDeadline(options.onDrain, deadlineUnixMs))) {
+                return deadlineExpiredResponse(request.id);
+            }
+            return { jsonrpc: '2.0', id: request.id, result: null };
+        }
+        // No other unsupported method reaches this branch. Keep the assertion so
+        // a future ready row cannot silently create standalone-shell behavior.
+        throw new StandaloneProtocolError(`unsupported accepted method: ${request.method}`);
+    };
+}
+const respondToInvalidJson = error => error.code === 'INVALID_JSON'
+    ? {
+        jsonrpc: '2.0',
+        id: null,
+        error: { code: PARSE_ERROR_CODE, message: PARSE_ERROR_MESSAGE },
+    }
+    : undefined;
+function attachManifest(channel, manifest) {
+    return {
+        manifest,
+        send: frame => channel.send(frame),
+        close: () => channel.close(),
+        get failed() {
+            return channel.failed;
+        },
+    };
+}
+/**
+ * Starts the fail-closed plugin-side standalone shell.
+ *
+ * A manifest is validated by the published contract runtime before any stdio
+ * listener is attached. Lifecycle rows execute locally. beta.8 handshake
+ * requests reach the handler only to receive a conservative standard error;
+ * no Broker behavior is present in this shell.
+ */
+export function startStandaloneHost(options) {
+    const manifest = requireStdioManifest(options.manifest);
+    const hasInput = options.input !== undefined;
+    const hasOutput = options.output !== undefined;
+    if (hasInput !== hasOutput) {
+        throw new TypeError('standalone host requires both input and output streams');
+    }
+    const onFrame = createFrameHandler(options);
+    const channel = hasInput
+        ? createStdioChannel(options.input, options.output, {
+            onFrame,
+            onFrameError: respondToInvalidJson,
+            onFatal: options.onFatal,
+        })
+        : startStdioRuntime({
+            onFrame,
+            onFrameError: respondToInvalidJson,
+            onFatal: options.onFatal,
+        });
+    return attachManifest(channel, manifest);
+}
+//# sourceMappingURL=standalone-host.js.map

package/dist/standalone-host.js.map

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

package/dist/stdio-runtime.d.ts

@@ -0,0 +1,50 @@
+import type { Readable, Writable } from 'node:stream';
+import { NdjsonFrameError, type DecodedNdjsonFrame, type JsonObject } from '@clowder-ai/plugin-contract/conformance';
+export { NdjsonFrameError } from '@clowder-ai/plugin-contract/conformance';
+export type { DecodedNdjsonFrame as StdioFrame, JsonObject, NdjsonFrameErrorCode as StdioFrameErrorCode, } from '@clowder-ai/plugin-contract/conformance';
+export type StdioRuntimeFatalReason = 'FRAME_ERROR' | 'HANDLER_ERROR' | 'INPUT_ERROR' | 'OUTPUT_ERROR';
+export interface StdioRuntimeFatalErrorOptions {
+    readonly reason: StdioRuntimeFatalReason;
+    readonly cause: unknown;
+}
+/** A terminal channel failure. It deliberately never becomes a protocol frame. */
+export declare class StdioRuntimeFatalError extends Error {
+    readonly reason: StdioRuntimeFatalReason;
+    constructor(options: StdioRuntimeFatalErrorOptions);
+}
+export type StdioFrameHandler = (frame: DecodedNdjsonFrame) => JsonObject | undefined | Promise<JsonObject | undefined>;
+export type StdioFrameErrorHandler = (error: NdjsonFrameError) => JsonObject | undefined | Promise<JsonObject | undefined>;
+export interface StdioChannelOptions {
+    /** Defaults to the contract-owned hard cap; callers may only choose a stricter cap. */
+    readonly maxFrameBytes?: number;
+    readonly onFrame: StdioFrameHandler;
+    /**
+     * Lets a protocol shell map an otherwise terminal decoder error to its
+     * contract-defined response before this schema-neutral runtime closes.
+     */
+    readonly onFrameError?: StdioFrameErrorHandler;
+    readonly onFatal?: (error: StdioRuntimeFatalError) => void;
+}
+export interface StdioRuntimeOptions extends StdioChannelOptions {
+}
+export interface StdioChannel {
+    /** Encode and write exactly one object frame followed by LF. */
+    send(frame: JsonObject): Promise<void>;
+    /** Stop accepting input without closing a stream owned by the caller. */
+    close(): void;
+    readonly failed: boolean;
+}
+/**
+ * Connect a schema-neutral NDJSON channel to caller-owned streams.
+ *
+ * Frame processing is serialized, preserving request order without creating
+ * a production request/result vocabulary or a Host Broker substitute.
+ */
+export declare function createStdioChannel(input: Readable, output: Writable, options: StdioChannelOptions): StdioChannel;
+/**
+ * Start the public standalone SDK runtime on the process standard streams.
+ * Diagnostics remain out of stdout; callers may observe fatal errors through
+ * `onFatal` and choose to write their own stderr diagnostics.
+ */
+export declare function startStdioRuntime(options: StdioRuntimeOptions): StdioChannel;
+//# sourceMappingURL=stdio-runtime.d.ts.map

package/dist/stdio-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-runtime.d.ts","sourceRoot":"","sources":["../src/stdio-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAIL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAChB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,YAAY,EACV,kBAAkB,IAAI,UAAU,EAChC,UAAU,EACV,oBAAoB,IAAI,mBAAmB,GAC5C,MAAM,yCAAyC,CAAC;AAEjD,MAAM,MAAM,uBAAuB,GAC/B,aAAa,GACb,eAAe,GACf,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,kFAAkF;AAClF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;gBAE7B,OAAO,EAAE,6BAA6B;CAOnD;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,kBAAkB,KACtB,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;AAC9D,MAAM,MAAM,sBAAsB,GAAG,CACnC,KAAK,EAAE,gBAAgB,KACpB,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;AAC9D,MAAM,WAAW,mBAAmB;IAClC,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;CAAG;AACnE,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,yEAAyE;IACzE,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAaD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAsQd;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAY5E"}

package/dist/stdio-runtime.js

@@ -0,0 +1,294 @@
+import { encodeNdjsonFrame, MAX_NDJSON_FRAME_BYTES, NdjsonFrameDecoder, NdjsonFrameError, } from '@clowder-ai/plugin-contract/conformance';
+export { NdjsonFrameError } from '@clowder-ai/plugin-contract/conformance';
+/** A terminal channel failure. It deliberately never becomes a protocol frame. */
+export class StdioRuntimeFatalError extends Error {
+    reason;
+    constructor(options) {
+        super(`stdio runtime stopped after ${options.reason}`, {
+            cause: options.cause,
+        });
+        this.name = 'StdioRuntimeFatalError';
+        this.reason = options.reason;
+    }
+}
+// Scan a bounded source window at a time. Complete frames are coalesced only
+// once before reaching the contract decoder, so a near-cap partial frame is
+// neither repeatedly copied nor repeatedly scanned by that decoder.
+const MAX_INPUT_DECODE_SLICE_BYTES = 16 * 1024;
+function nextInputSliceEnd(chunk, offset) {
+    const boundedEnd = Math.min(offset + MAX_INPUT_DECODE_SLICE_BYTES, chunk.byteLength);
+    const newline = chunk.subarray(offset, boundedEnd).indexOf(0x0a);
+    return newline === -1 ? boundedEnd : offset + newline + 1;
+}
+/**
+ * Connect a schema-neutral NDJSON channel to caller-owned streams.
+ *
+ * Frame processing is serialized, preserving request order without creating
+ * a production request/result vocabulary or a Host Broker substitute.
+ */
+export function createStdioChannel(input, output, options) {
+    const readableEncoding = input.readableEncoding;
+    if (readableEncoding !== undefined && readableEncoding !== null) {
+        throw new RangeError('stdio input must remain in byte mode');
+    }
+    let decoder = new NdjsonFrameDecoder(options.maxFrameBytes);
+    const maxFrameBytes = options.maxFrameBytes ?? MAX_NDJSON_FRAME_BYTES;
+    let accepting = true;
+    let fatalError;
+    let detached = false;
+    let processing = false;
+    let inputEnded = false;
+    let decoderEnded = false;
+    let undecodedSegments = [];
+    let undecodedBytes = 0;
+    let activeWrites = 0;
+    let outputDetachmentRequested = false;
+    let outputErrorGracePending = false;
+    const discardUndecodedFrame = () => {
+        undecodedSegments = [];
+        undecodedBytes = 0;
+    };
+    const takeUndecodedFrame = () => {
+        if (undecodedSegments.length === 0) {
+            return undefined;
+        }
+        const frame = undecodedSegments.length === 1
+            ? undecodedSegments[0]
+            : Buffer.concat(undecodedSegments, undecodedBytes);
+        discardUndecodedFrame();
+        return frame;
+    };
+    const detachInput = () => {
+        input.off('data', onData);
+        input.off('end', onEnd);
+        input.off('error', onInputError);
+        input.off('close', onInputClose);
+    };
+    const detachOutputError = () => {
+        output.off('error', onOutputError);
+    };
+    const maybeDetachOutputError = () => {
+        if (outputDetachmentRequested &&
+            activeWrites === 0 &&
+            !outputErrorGracePending) {
+            detachOutputError();
+        }
+    };
+    const requestOutputDetachment = () => {
+        outputDetachmentRequested = true;
+        maybeDetachOutputError();
+    };
+    const write = (frame) => {
+        activeWrites += 1;
+        return new Promise((resolve, reject) => {
+            try {
+                output.write(frame, error => {
+                    if (error === null || error === undefined) {
+                        resolve();
+                    }
+                    else {
+                        reject(error);
+                    }
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        }).finally(() => {
+            activeWrites -= 1;
+            // A Writable may emit its matching error after invoking its write
+            // callback. Defer detachment by one turn so that event remains handled.
+            outputErrorGracePending = true;
+            setImmediate(() => {
+                outputErrorGracePending = false;
+                maybeDetachOutputError();
+            });
+        });
+    };
+    const detach = () => {
+        if (detached) {
+            return;
+        }
+        detached = true;
+        detachInput();
+        requestOutputDetachment();
+    };
+    const fail = (reason, cause) => {
+        if (fatalError !== undefined) {
+            return;
+        }
+        accepting = false;
+        fatalError = new StdioRuntimeFatalError({ reason, cause });
+        discardUndecodedFrame();
+        input.pause();
+        detach();
+        options.onFatal?.(fatalError);
+    };
+    const send = async (frame) => {
+        if (!accepting) {
+            throw new NdjsonFrameError('DECODER_CLOSED', 'stdio channel is closed');
+        }
+        const encoded = encodeNdjsonFrame(frame, options.maxFrameBytes);
+        try {
+            await write(encoded);
+        }
+        catch (error) {
+            fail('OUTPUT_ERROR', error);
+            throw error;
+        }
+    };
+    const finishDecoder = () => {
+        if (!accepting || decoderEnded) {
+            return;
+        }
+        decoderEnded = true;
+        try {
+            const pendingFrame = takeUndecodedFrame();
+            if (pendingFrame !== undefined) {
+                decoder.push(pendingFrame);
+            }
+            decoder.end();
+        }
+        catch (error) {
+            fail('FRAME_ERROR', error);
+        }
+    };
+    const onData = (chunk) => {
+        if (!accepting) {
+            return;
+        }
+        if (processing) {
+            fail('INPUT_ERROR', new Error('stdio input emitted data while processing was paused'));
+            return;
+        }
+        // A data listener puts Readable into flowing mode. Pause before decoding so
+        // a slow handler or output write cannot accumulate an unbounded Promise
+        // chain from later source chunks.
+        processing = true;
+        input.pause();
+        if (!(chunk instanceof Uint8Array)) {
+            fail('INPUT_ERROR', new TypeError('stdio input must emit Uint8Array chunks'));
+            return;
+        }
+        void processChunk(chunk);
+    };
+    const processChunk = async (chunk) => {
+        try {
+            let offset = 0;
+            while (offset < chunk.byteLength && accepting) {
+                const nextOffset = nextInputSliceEnd(chunk, offset);
+                const segment = chunk.subarray(offset, nextOffset);
+                undecodedSegments.push(segment);
+                undecodedBytes += segment.byteLength;
+                offset = nextOffset;
+                if (segment.at(-1) !== 0x0a && undecodedBytes <= maxFrameBytes) {
+                    continue;
+                }
+                let frames;
+                try {
+                    const frame = takeUndecodedFrame();
+                    if (frame === undefined) {
+                        continue;
+                    }
+                    frames = decoder.push(frame);
+                }
+                catch (error) {
+                    if (error instanceof NdjsonFrameError) {
+                        const response = options.onFrameError === undefined
+                            ? undefined
+                            : await options.onFrameError(error);
+                        if (response !== undefined && accepting) {
+                            await send(response);
+                            // The decoder deliberately fails closed after any bad frame.
+                            // A protocol shell that supplied a response has consumed that
+                            // complete frame, so it may explicitly resume at the next LF.
+                            decoder = new NdjsonFrameDecoder(options.maxFrameBytes);
+                            continue;
+                        }
+                    }
+                    fail('FRAME_ERROR', error);
+                    return;
+                }
+                for (const frame of frames) {
+                    if (!accepting) {
+                        return;
+                    }
+                    const response = await options.onFrame(frame);
+                    if (response !== undefined && accepting) {
+                        await send(response);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            fail('HANDLER_ERROR', error);
+        }
+        finally {
+            processing = false;
+            if (inputEnded) {
+                finishDecoder();
+            }
+            else if (accepting) {
+                input.resume();
+            }
+        }
+    };
+    const onEnd = () => {
+        inputEnded = true;
+        if (!processing) {
+            finishDecoder();
+        }
+    };
+    const onInputError = (error) => fail('INPUT_ERROR', error);
+    const onInputClose = () => {
+        if (!inputEnded) {
+            inputEnded = true;
+            if (!processing) {
+                finishDecoder();
+            }
+        }
+        if (fatalError === undefined) {
+            detachInput();
+        }
+    };
+    const onOutputError = (error) => fail('OUTPUT_ERROR', error);
+    input.on('data', onData);
+    input.once('end', onEnd);
+    input.once('error', onInputError);
+    input.once('close', onInputClose);
+    output.once('error', onOutputError);
+    return {
+        send,
+        close: () => {
+            if (detached) {
+                return;
+            }
+            accepting = false;
+            discardUndecodedFrame();
+            detach();
+            input.pause();
+        },
+        get failed() {
+            return fatalError !== undefined;
+        },
+    };
+}
+/**
+ * Start the public standalone SDK runtime on the process standard streams.
+ * Diagnostics remain out of stdout; callers may observe fatal errors through
+ * `onFatal` and choose to write their own stderr diagnostics.
+ */
+export function startStdioRuntime(options) {
+    return createStdioChannel(process.stdin, process.stdout, {
+        ...options,
+        onFatal: error => {
+            process.exitCode = 1;
+            // The standalone runtime owns process.stdin. A framing fatal closes that
+            // transport immediately, instead of remaining alive until a hostile or
+            // broken parent eventually sends EOF.
+            process.stdin.destroy();
+            options.onFatal?.(error);
+        },
+    });
+}
+//# sourceMappingURL=stdio-runtime.js.map

package/dist/stdio-runtime.js.map

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

package/dist/wire-dispatch.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Wire dispatch classifier — pre-dispatch frame classification per the
+ * disposition table (T-A through T-M, §3.8-1 plus beta.8 closure).
+ *
+ * This module classifies decoded NDJSON frames into one of the 13
+ * disposition classes. T-A (transport failure) and T-B (JSON parse error)
+ * are handled by the NDJSON frame decoder layer — this classifier covers
+ * T-C through T-M.
+ *
+ * A frame that passes all rejection checks returns disposition=null with
+ * outcome='accept', indicating a valid request that should be dispatched
+ * to a method handler.
+ *
+ * This module defines nothing new — every classification rule traces to
+ * the frozen disposition table in @clowder-ai/plugin-contract.
+ */
+import type { DecodedNdjsonFrame, JsonObject } from '@clowder-ai/plugin-contract/conformance';
+import { type DispositionClass, type RequestSnapshot, type WireMethodName } from '@clowder-ai/plugin-contract';
+export type { RequestSnapshot } from '@clowder-ai/plugin-contract';
+export interface InFlightEntry {
+    readonly method: WireMethodName;
+    readonly requestSnapshot?: RequestSnapshot;
+}
+export interface DispatchResult {
+    /** T-class from the disposition table, or null for valid requests. */
+    readonly disposition: DispositionClass | null;
+    /** Required transport action: close, respond (with error), or accept. */
+    readonly outcome: 'close' | 'respond' | 'accept';
+    /** For 'respond': the error envelope to write back as NDJSON. */
+    readonly response?: JsonObject;
+}
+/**
+ * Classify a decoded NDJSON frame into a disposition class.
+ *
+ * Covers T-C through T-M of the disposition table. T-A and T-B
+ * are handled by the NDJSON frame decoder layer.
+ *
+ * @param frame   Decoded frame with raw bytes and parsed value.
+ * @param inFlight Map of in-flight request IDs to their entry metadata.
+ * @returns The disposition result with class, outcome, and optional error response.
+ */
+export declare function classifyFrame(frame: DecodedNdjsonFrame, inFlight: ReadonlyMap<string, InFlightEntry>): DispatchResult;
+//# sourceMappingURL=wire-dispatch.d.ts.map