@animalabs/agent-framework 0.22.2 → 0.23.0

package/dist/src/mcpl/tool-result-normalize.js

@@ -0,0 +1,232 @@
+/** What a result whose content is present but isn't a list of blocks reads
+ *  as, on the model's path and a script's alike. */
+export const MALFORMED_CONTENT_NOTICE = '[malformed result: its content is not a list of blocks; the tool may already have completed]';
+/** Stub fields are bounded independently of anything the server sends. */
+const STUB_FIELD_POINTS = 200;
+/** A URI is the reference itself, so it's bounded far more loosely than a
+ *  stub field: a real one survives, and a pathological one can't flood the
+ *  model's view. */
+const URI_POINTS = 2048;
+/** The image types providers take inline. Any other image is saved. */
+const NATIVE_IMAGE_TYPES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
+/** The decoded size providers take per inline image: the same 5 MB ceiling
+ *  the framework's read_image tool guards. A larger image is saved. */
+const NATIVE_IMAGE_MAX_BYTES = 5 * 1024 * 1024;
+/** Why a payload isn't shown inline, unless said otherwise. */
+const UNSUPPORTED = "the model can't take this type";
+/** The first `max` code points of `text`, never splitting a surrogate pair,
+ *  and how many code points were left out. */
+function headPoints(text, max) {
+    let end = 0;
+    let points = 0;
+    while (end < text.length && points < max) {
+        end += text.codePointAt(end) > 0xffff ? 2 : 1;
+        points++;
+    }
+    let omitted = 0;
+    for (let i = end; i < text.length; omitted++)
+        i += text.codePointAt(i) > 0xffff ? 2 : 1;
+    return { head: text.slice(0, end), omitted };
+}
+/** Any value as JSON (a string quoted too). Never throws. */
+function asJson(value) {
+    try {
+        return JSON.stringify(value) ?? 'null';
+    }
+    catch {
+        return Object.prototype.toString.call(value);
+    }
+}
+/** Any value as text: a string as itself, anything else as JSON. Never throws. */
+function asText(value) {
+    return typeof value === 'string' ? value : asJson(value);
+}
+function bounded(value, max = STUB_FIELD_POINTS) {
+    const { head, omitted } = headPoints(asText(value), max);
+    return omitted > 0 ? `${head}…` : head;
+}
+/** A payload's decoded size, its base64 read without the whitespace a
+ *  wrapped encoding carries. */
+function decodedSize(base64) {
+    const compact = base64.replace(/\s+/g, '');
+    const padding = compact.endsWith('==') ? 2 : compact.endsWith('=') ? 1 : 0;
+    return Math.max(0, Math.floor((compact.length * 3) / 4) - padding);
+}
+function humanSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+const KNOWN_EXTENSIONS = { 'octet-stream': 'bin', 'mpeg': 'mp3', 'plain': 'txt', 'x-wav': 'wav' };
+function extensionFor(mimeType) {
+    const subtype = mimeType.split('/')[1]?.split(';')[0]?.trim().toLowerCase() ?? '';
+    // The table's own keys only: a subtype such as 'constructor' must not find
+    // what Object.prototype holds.
+    const ext = Object.hasOwn(KNOWN_EXTENSIONS, subtype) ? KNOWN_EXTENSIONS[subtype] : subtype.replace(/[^a-z0-9]/g, '');
+    return ext.length > 0 && ext.length <= 10 ? ext : 'bin';
+}
+/** The image type a provider takes inline, in its canonical spelling, or
+ *  null when it takes none of these. */
+function nativeImageType(mimeType) {
+    if (typeof mimeType !== 'string')
+        return null;
+    const base = mimeType.split(';')[0].trim().toLowerCase();
+    return NATIVE_IMAGE_TYPES.has(base) ? base : null;
+}
+/**
+ * Normalize a standard MCP tool result into the framework's `ToolResult`.
+ * `label` names saved payloads (one per call; payloads get an index suffix).
+ * A payload that can't be retained (no `save`, or saving failed) makes the
+ * result a failure to materialize, never a success with part of it lost.
+ * Content that is present but isn't a list of blocks makes it a malformed
+ * result, never an empty success. A tool's error result with no words, or
+ * only whitespace, reads as `noWords`, which the framework words for its
+ * server and tool.
+ */
+export async function normalizeStandardToolResult(result, label, save, noWords = 'Tool call failed') {
+    const malformed = result.content !== undefined && !Array.isArray(result.content);
+    const raw = Array.isArray(result.content) ? result.content : [];
+    const blocks = [];
+    let saved = 0;
+    /** Payloads that could be neither shown nor retained. */
+    let lost = 0;
+    const payloadStub = async (kind, base64, mimeType, opts = {}) => {
+        const why = opts.why ?? UNSUPPORTED;
+        const size = humanSize(decodedSize(base64));
+        const what = `[${kind}${opts.origin ? ` ${bounded(opts.origin, URI_POINTS)}` : ''}: ${bounded(mimeType)}, ${size}`;
+        if (!save) {
+            lost++;
+            return `${what}. Not retained: ${why}, and no workspace is mounted to save it]`;
+        }
+        const fileName = `${label}-${++saved}.${extensionFor(mimeType)}`;
+        const path = await save(fileName, Buffer.from(base64, 'base64'), mimeType).catch((error) => {
+            // The stub says only that saving failed; why goes to the host's log.
+            console.error(`[mcp] saving tool payload ${fileName} (${kind}, ${JSON.stringify(bounded(mimeType))}, ${size}) failed:`, error);
+            return null;
+        });
+        if (path)
+            return `${what}, saved to workspace file ${path}${why === UNSUPPORTED ? '' : `; not shown inline: ${why}`}]`;
+        lost++;
+        return `${what}. Not retained: ${why}, and saving it to the workspace failed]`;
+    };
+    for (const entry of raw) {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+            blocks.push({ type: 'text', text: `[malformed content entry, left out: ${bounded(entry)}]` });
+            continue;
+        }
+        const block = entry;
+        switch (block.type) {
+            case 'text':
+                blocks.push(typeof block.text === 'string'
+                    ? { type: 'text', text: block.text }
+                    : { type: 'text', text: '[malformed text block, left out: its text is not a string]' });
+                break;
+            case 'image':
+            case 'audio': {
+                const kind = block.type;
+                if (typeof block.data !== 'string') {
+                    blocks.push({ type: 'text', text: `[${kind} without inline data, not fetched${typeof block.uri === 'string' ? `: ${bounded(block.uri, URI_POINTS)}` : ''}]` });
+                    break;
+                }
+                // Inline data with no type is still a payload, of no known type.
+                const mimeType = typeof block.mimeType === 'string' ? block.mimeType : 'application/octet-stream';
+                const native = kind === 'image' ? nativeImageType(block.mimeType) : null;
+                if (native && decodedSize(block.data) <= NATIVE_IMAGE_MAX_BYTES) {
+                    // Passed on without a wrapped encoding's whitespace, which a
+                    // provider may refuse, and with it the whole request.
+                    blocks.push({ type: 'image', data: block.data.replace(/\s+/g, ''), mimeType: native });
+                }
+                else {
+                    const why = native ? `over the ${humanSize(NATIVE_IMAGE_MAX_BYTES)} a model takes per image` : UNSUPPORTED;
+                    blocks.push({ type: 'text', text: await payloadStub(kind, block.data, mimeType, { why }) });
+                }
+                break;
+            }
+            case 'resource_link': {
+                const name = typeof block.name === 'string' ? block.name : undefined;
+                const mime = typeof block.mimeType === 'string' ? `, ${bounded(block.mimeType)}` : '';
+                blocks.push({ type: 'text', text: `[resource link${name ? ` "${bounded(name)}"` : ''}: ${bounded(block.uri, URI_POINTS)}${mime}; not fetched]` });
+                break;
+            }
+            case 'resource': {
+                const resource = (block.resource && typeof block.resource === 'object' ? block.resource : {});
+                const uri = typeof resource.uri === 'string' ? resource.uri : undefined;
+                const mime = typeof resource.mimeType === 'string' ? resource.mimeType : undefined;
+                if (typeof resource.text === 'string') {
+                    blocks.push({ type: 'text', text: `[resource ${uri === undefined ? '(no uri)' : bounded(uri, URI_POINTS)}${mime ? `, ${bounded(mime)}` : ''}]\n${resource.text}` });
+                }
+                else if (typeof resource.blob === 'string') {
+                    blocks.push({ type: 'text', text: await payloadStub('resource', resource.blob, mime ?? 'application/octet-stream', { origin: uri }) });
+                }
+                else {
+                    blocks.push({ type: 'text', text: `[resource ${uri === undefined ? '(no uri)' : bounded(uri, URI_POINTS)} with no contents]` });
+                }
+                break;
+            }
+            default: {
+                // Unknown to this client: shown as data rather than dropped, bounded
+                // like a stub field, so a large or binary payload can't flood the
+                // model's view.
+                const { head, omitted } = headPoints(asText(entry), STUB_FIELD_POINTS);
+                blocks.push({ type: 'text', text: omitted > 0 ? `${head}… [${omitted} more characters of this block left out]` : head });
+            }
+        }
+    }
+    const failing = !!result.isError || lost > 0 || malformed;
+    if (failing) {
+        // A failed result is read only as its text: an inline image becomes a
+        // payload like any other, saved and named, or marked not retained.
+        for (let i = 0; i < blocks.length; i++) {
+            const block = blocks[i];
+            if (block.type === 'image') {
+                blocks[i] = { type: 'text', text: await payloadStub('image', block.data, block.mimeType, { why: 'a failed result is read as its text alone' }) };
+            }
+        }
+    }
+    const hasStructured = Object.prototype.hasOwnProperty.call(result, 'structuredContent');
+    // Only the server's own text blocks count as its presentation for the
+    // model. Stubs this module wrote are notices, not the server's text.
+    const serverText = raw.some((entry) => {
+        const block = entry;
+        return !!block && typeof block === 'object' && block.type === 'text' && typeof block.text === 'string' && block.text.trim().length > 0;
+    });
+    if (hasStructured && !serverText) {
+        blocks.push({ type: 'text', text: asJson(result.structuredContent) });
+    }
+    const text = blocks.filter((b) => b.type === 'text').map((b) => b.text).join('\n');
+    const structured = hasStructured ? { structured: result.structuredContent } : {};
+    if (result.isError) {
+        return { success: false, error: text.trim() ? text : noWords, isError: true, ...structured };
+    }
+    if (malformed) {
+        return {
+            success: false,
+            error: `${MALFORMED_CONTENT_NOTICE}${text ? `\n${text}` : ''}`,
+            isError: true,
+            ...structured,
+        };
+    }
+    if (lost > 0) {
+        // The server answered, but part of its answer is gone: report that as a
+        // failure to materialize the result, never as a success.
+        return {
+            success: false,
+            error: `[result incomplete: ${lost} payload(s) could not be retained, so this result is not complete; ` +
+                `the tool may already have completed]\n${text}`,
+            isError: true,
+            ...structured,
+        };
+    }
+    const hasImage = blocks.some((b) => b.type === 'image');
+    return {
+        success: true,
+        // Text-only results keep the joined-string convention callers expect.
+        // An image keeps the array, so the model sees it natively.
+        data: hasImage ? blocks : (text || undefined),
+        isError: false,
+        ...structured,
+    };
+}
+//# sourceMappingURL=tool-result-normalize.js.map

package/dist/src/mcpl/tool-result-normalize.js.map

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

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

@@ -35,17 +35,24 @@ export interface TransportCloseInfo {
  *  - `'stderr'` `(line: string)`            diagnostic line (stdio child stderr; never WS)
  *  - `'error'`  `(err: Error)`              transport-level error
  *  - `'close'`  `(info: TransportCloseInfo)` transport closed (once)
+ *  - `'unreaped'` `(failure: Error)`        a stdio child whose pipe failed
+ *    outlived SIGKILL too: the transport stays open, owning the child, and
+ *    close() retries the reap (never WS)
  *
  * Inbound `'line'`/`'stderr'` events are buffered until the first matching
  * listener attaches (and re-buffered whenever there are none), so no message is
  * lost across the handshake→routing handoff regardless of attach timing.
  */
 export declare abstract class McplTransport extends EventEmitter {
+    protected readonly serverId?: string | undefined;
     abstract readonly kind: 'stdio' | 'websocket';
     private _closed;
     private lineBuffer;
     private stderrBuffer;
-    protected constructor();
+    /** The server's id from its config, so a line the transport logs names it.
+     *  The stdio and WebSocket transports always give it; a test's stand-in
+     *  transport may leave it out. */
+    protected constructor(serverId?: string | undefined);
     get closed(): boolean;
     /**
      * The last of what the server wrote to its diagnostic stream: at most its
@@ -54,10 +61,34 @@ export declare abstract class McplTransport extends EventEmitter {
      * child's stderr, and '' for a transport that has none.
      */
     get stderrTail(): string;
+    /**
+     * The error a stdio child's stdin or stdout failed with, once one has. The
+     * transport is ending the child then, and stays open until it exits, but
+     * writes nothing more to it: writeLine drops each line, and both engines
+     * refuse a request as not sent. Undefined while writes go out, and always
+     * for a transport that has no pipes.
+     */
+    get pipeFailure(): Error | undefined;
+    /**
+     * Resolves once the server's diagnostic stream has ended or closed, so that
+     * {@link stderrTail} holds what arrived on it, or once `ms` have passed while
+     * it hasn't. At once for a transport that has none.
+     */
+    stderrEnded(_ms: number): Promise<void>;
     /** Deliver an inbound line, buffering it if nobody is listening yet. */
     protected pushLine(line: string): void;
     /** Deliver a diagnostic line, buffering it if nobody is listening yet. */
     protected pushStderr(line: string): void;
+    /**
+     * Report a transport error: to the 'error' listeners if there are any, else
+     * as a log line. EventEmitter throws an 'error' that nothing listens for,
+     * and a transport reports its errors from I/O callbacks, where nothing
+     * catches that throw, so it would end the process. A transport has no
+     * listener from its creation until the handshake attaches one, and a
+     * WebSocket server that sends a malformed frame with its upgrade response
+     * makes ws raise an 'error' in that window.
+     */
+    protected reportError(err: Error): void;
     /** Emit 'close' exactly once. */
     protected markClosed(info: TransportCloseInfo): void;
     /** Write one JSON-RPC message as an NDJSON line. */
@@ -78,10 +109,24 @@ export declare abstract class McplTransport extends EventEmitter {
 export declare const CHILD_ENV_ALLOWLIST: string[];
 /** Environment for a stdio child: allowlisted host vars (+ LC_*), then the
  *  server's declared `env` on top. Windows names merge case-insensitively;
- *  POSIX names remain case-sensitive. `inheritEnv: true` restores full inheritance. */
+ *  POSIX names remain case-sensitive. `inheritEnv: true` restores full inheritance,
+ *  and only `true` does: a direct caller can pass any value, unchecked. */
 export declare function buildChildEnv(config: Pick<McplServerConfig, 'env' | 'inheritEnv'>, hostEnv?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): NodeJS.ProcessEnv;
 /** The most of a stdio child's stderr a transport keeps for {@link McplTransport.stderrTail}. */
 export declare const STDERR_TAIL_CHARS = 2048;
+/**
+ * How long a refusal at a stdio child's exit waits for the child's stderr to
+ * end, so that its `stderrTail` holds what the child wrote. Node can emit a
+ * child's `exit` before it has read the last of the child's stderr. When the
+ * child held the stream alone, the stream ends with it, and the wait is short.
+ * The bound binds when another process still holds the stream, such as one the
+ * server started that inherited it, or when the host's loop stalls past it
+ * before reading an end that is waiting. The tail then holds what had arrived.
+ * A process that keeps the stream open, such as one the server started and
+ * left running, holds the refusal up by the bound, a fifth of the reconnect's
+ * default first interval.
+ */
+export declare const STDERR_END_WAIT_MS = 1000;
 export declare class StdioTransport extends McplTransport {
     private readonly child;
     private readonly rl;
@@ -90,7 +135,11 @@ export declare class StdioTransport extends McplTransport {
     private pipeError;
     private stderrEnd;
     private stderrCut;
+    /** True once the child's stderr has ended or closed. */
+    private stderrDone;
     get stderrTail(): string;
+    get pipeFailure(): Error | undefined;
+    stderrEnded(ms: number): Promise<void>;
     private constructor();
     /**
      * Spawn `config.command` and resolve with a ready stdio transport once the
@@ -99,7 +148,31 @@ export declare class StdioTransport extends McplTransport {
      */
     static spawn(config: McplServerConfig): Promise<StdioTransport>;
     writeLine(json: string): void;
+    private closing;
+    /**
+     * Close and reap: resolves once the child has actually exited, not merely
+     * been signalled (`child.killed` is true as soon as a signal is sent). A
+     * child that outlives SIGTERM by {@link STDIO_EXIT_GRACE_MS} gets SIGKILL.
+     * If it still hasn't exited after that bound again, close rejects: an
+     * explicit cleanup failure, rather than waiting forever or claiming an
+     * exit that wasn't seen. Calls share one attempt, and so does a pipe
+     * failure that is already ending the child; a later call succeeds if the
+     * child has exited since.
+     */
     close(): Promise<void>;
+    private reap;
+    /** Whether the child has exited, or never started (a spawn error). */
+    private exited;
+    private terminating;
+    /**
+     * End the child: SIGTERM, then SIGKILL once it has outlived SIGTERM by
+     * {@link STDIO_EXIT_GRACE_MS}. Resolves once it has exited; rejects if it
+     * still hasn't that long after SIGKILL. close() and a pipe failure share
+     * one attempt, so no second signal or timer goes out. A failed attempt is
+     * re-checked, not repeated: a child that has exited since resolves it.
+     */
+    private terminate;
+    private escalate;
 }
 export declare class WebSocketTransport extends McplTransport {
     private readonly ws;
@@ -108,24 +181,43 @@ export declare class WebSocketTransport extends McplTransport {
     /**
      * Dial `config.url` and resolve once the socket is OPEN. Appends `?token=`
      * when `config.token` is set. Rejects on connect error / timeout (and tears
-     * the socket down) so a failed dial never leaks an open handle.
+     * the socket down) so a failed dial never leaks an open handle. `signal`
+     * ends a dial whose connection is closed meanwhile, at once, rather than
+     * at the open timeout.
      */
-    static open(config: McplServerConfig): Promise<WebSocketTransport>;
+    static open(config: McplServerConfig, signal?: AbortSignal): Promise<WebSocketTransport>;
     writeLine(json: string): void;
     close(): Promise<void>;
 }
 /**
- * Build the dial URL: validate it's a ws(s):// URL and append the auth token as
- * a `token` query param when provided (preserving any existing query).
+ * Build the dial URL: validate it's a ws(s):// URL the ws library will dial,
+ * which refuses one with a fragment, and append the auth token as a `token`
+ * query param when provided (preserving any existing query).
  */
 export declare function buildWebSocketUrl(config: McplServerConfig, tokenOverride?: string | null): string;
-/** True when the config selects the WebSocket transport (explicit `transport`,
- *  or a `url` with no `command`). */
+/** True when the config selects the WebSocket transport, as
+ *  {@link resolveServerBinding} decides it; false for any other transport and
+ *  for a configuration it refuses. */
 export declare function isWebSocketTransport(config: McplServerConfig): boolean;
 /**
- * Open the transport selected by `config` (WebSocket when `transport` is
- * 'websocket' or a bare `url` is given; stdio otherwise). The returned transport
- * is connected at the byte level but has NOT performed the MCPL handshake.
+ * Refuse a server config whose `inheritEnv`, `reconnect` or `allowHostCommands`
+ * holds anything but true or false. A config read from JSON can carry a quoted
+ * "false" where the type says boolean, and every reader of these settings takes
+ * only `true` as on, so the quotes would hide what the value does. null counts
+ * as not set, so a generated config that writes an unset setting as null
+ * keeps working. `inheritEnv` is checked only for a stdio server, since a
+ * network server, WebSocket or HTTP, never reads it. The error names the
+ * server, the setting and the value's kind, not the value, which could be a
+ * secret pasted into the wrong field.
+ */
+export declare function assertServerConfigBooleans(config: McplServerConfig): void;
+/**
+ * Open the legacy transport `config` selects, as {@link resolveServerBinding}
+ * decides it: stdio for a `command`, MCPL's WebSocket binding for a ws(s)://
+ * url. A configuration it refuses, or one for the modern family (an http(s)
+ * url, or `protocol: 'modern'`), throws before anything is spawned or dialed.
+ * The returned transport is connected at the byte level but has NOT
+ * performed the MCPL handshake.
  */
-export declare function openTransport(config: McplServerConfig): Promise<McplTransport>;
+export declare function openTransport(config: McplServerConfig, signal?: AbortSignal): Promise<McplTransport>;
 //# sourceMappingURL=transport.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/mcpl/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;4EAC4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;qDACiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,8BAAsB,aAAc,SAAQ,YAAY;IACtD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAE9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAgB;IAEpC,SAAS,eAcR;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;;OAKG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,wEAAwE;IACxE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGrC;IAED,0EAA0E;IAC1E,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGvC;IAED,iCAAiC;IACjC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAInD;IAED,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,UAY/B,CAAC;AAEF;;uFAEuF;AACvF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,YAAY,CAAC,EACpD,OAAO,GAAE,MAAM,CAAC,UAAwB,EACxC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,CAAC,UAAU,CAiCnB;AAED,iGAAiG;AACjG,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AAEvC,qBAAa,cAAe,SAAQ,aAAa;IAY7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE;IAZrB,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,iFAAiF;IACjF,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,SAAS,CAAS;IAE1B,IAAa,UAAU,IAAI,MAAM,CAEhC;IAED,OAAO,eAgEN;IAED;;;;OAIG;IACH,OAAa,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4BpE;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG5B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB3B;CACF;AASD,qBAAa,kBAAmB,SAAQ,aAAa;IAG/B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAFvC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAErC,OAAO,eAkBN;IAED;;;;OAIG;IACH,OAAa,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4DvE;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAe3B;CACF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAoBjG;AAMD;qCACqC;AACrC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAItE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAKpF"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/mcpl/transport.ts"],"names":[],"mappings":"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"}