@alpacakit/agents 0.1.0-beta.20 → 0.1.0-beta.21

package/dist/internal/controlled-process/framed-transport.js

@@ -0,0 +1,117 @@
+import { readJsonRecord } from "../../core/json.js";
+const FRAME_HEADER_BYTES = 4;
+const MAX_FRAME_BYTES = 64 * 1024;
+const EMPTY_BUFFER = Buffer.alloc(0);
+export async function writeFramedRecord(writable, record) {
+    const payload = Buffer.from(JSON.stringify(record), "utf8");
+    if (payload.byteLength === 0 || payload.byteLength > MAX_FRAME_BYTES) {
+        throw new Error("Framed record payload length is invalid.");
+    }
+    const header = Buffer.allocUnsafe(FRAME_HEADER_BYTES);
+    header.writeUInt32BE(payload.byteLength);
+    await writeWithSettlement(writable, Buffer.concat([header, payload]));
+}
+function writeWithSettlement(writable, frame) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let writeReturned = false;
+        let drainRequired = false;
+        let drainComplete = false;
+        let callbackComplete = false;
+        let callbackFailure = null;
+        const cleanup = () => {
+            writable.off("drain", drained);
+            writable.off("error", failed);
+            writable.off("close", closed);
+        };
+        const complete = () => {
+            if (!settled &&
+                writeReturned &&
+                callbackComplete &&
+                (!drainRequired || drainComplete)) {
+                settled = true;
+                cleanup();
+                resolve();
+            }
+        };
+        const settleFailure = (error) => {
+            if (!settled) {
+                settled = true;
+                cleanup();
+                reject(error);
+            }
+        };
+        const drained = () => {
+            drainComplete = true;
+            complete();
+        };
+        const failed = (error) => {
+            settleFailure(callbackFailure ?? error);
+        };
+        const closed = () => {
+            settleFailure(callbackFailure ??
+                new Error("Framed transport closed before write settlement."));
+        };
+        writable.once("drain", drained);
+        writable.once("error", failed);
+        writable.once("close", closed);
+        if (writable.destroyed || writable.closed || writable.writableEnded) {
+            closed();
+            return;
+        }
+        try {
+            drainRequired = !writable.write(frame, (error) => {
+                if (error !== undefined && error !== null) {
+                    callbackFailure = error;
+                    setImmediate(() => settleFailure(error));
+                    return;
+                }
+                callbackComplete = true;
+                complete();
+            });
+            writeReturned = true;
+            complete();
+        }
+        catch (error) {
+            settleFailure(error instanceof Error
+                ? error
+                : new Error("Framed transport write failed."));
+        }
+    });
+}
+export async function* readFramedRecords(readable) {
+    let buffered = EMPTY_BUFFER;
+    for await (const rawChunk of readable) {
+        const chunk = Buffer.isBuffer(rawChunk)
+            ? rawChunk
+            : Buffer.from(String(rawChunk), "utf8");
+        buffered = Buffer.concat([buffered, chunk]);
+        while (buffered.byteLength >= FRAME_HEADER_BYTES) {
+            const payloadLength = buffered.readUInt32BE(0);
+            if (payloadLength === 0 || payloadLength > MAX_FRAME_BYTES) {
+                throw new Error("Framed record payload length is invalid.");
+            }
+            const frameLength = FRAME_HEADER_BYTES + payloadLength;
+            if (buffered.byteLength < frameLength) {
+                break;
+            }
+            const payload = buffered.subarray(FRAME_HEADER_BYTES, frameLength);
+            buffered = buffered.subarray(frameLength);
+            const record = readJsonRecord(payload.toString("utf8"));
+            if (record === null) {
+                throw new Error("Framed payload must be one JSON object.");
+            }
+            yield record;
+        }
+    }
+    if (buffered.byteLength !== 0) {
+        throw new Error("Framed transport ended with a partial frame.");
+    }
+}
+export async function readRequiredFrame(frames) {
+    const next = await frames.next();
+    if (next.done) {
+        throw new Error("Framed transport ended before the required frame.");
+    }
+    return next.value;
+}

package/dist/internal/controlled-process/host-controller.d.ts

@@ -0,0 +1,23 @@
+import type { ChildProcessCompletion, ChildProcessIdentity, ChildProcessLifecycle, ChildProcessTerminationResult } from "../../core/controlled-process.js";
+import type { ControlledProcessOutput, SupervisorTimingOptions, SupervisorWorkerOptions } from "./supervisor-model.js";
+export type ControlledProcessLaunchInput = {
+    readonly supervisorEntryPath: string;
+    readonly shimEntryPath: string;
+    readonly runtimeDirectory: string;
+    readonly worker: SupervisorWorkerOptions;
+    readonly timing: SupervisorTimingOptions;
+    readonly lifecycle: ChildProcessLifecycle;
+};
+export interface ControlledProcessHostHandle {
+    readonly identity: ChildProcessIdentity;
+    readonly chunks: AsyncIterable<ControlledProcessOutput>;
+    readonly completion: Promise<ChildProcessCompletion>;
+    requestTermination(): Promise<ChildProcessCompletion>;
+}
+export declare function launchControlledProcess(input: ControlledProcessLaunchInput): Promise<ControlledProcessHostHandle>;
+export declare function recoverControlledProcess(input: {
+    readonly identity: ChildProcessIdentity;
+    readonly runtimeDirectory: string;
+    readonly lifecycle: Pick<ChildProcessLifecycle, "afterTermination">;
+}): Promise<ChildProcessTerminationResult>;
+//# sourceMappingURL=host-controller.d.ts.map

package/dist/internal/controlled-process/host-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-controller.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/host-controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EAErB,6BAA6B,EAC9B,MAAM,kCAAkC,CAAC;AA+B1C,OAAO,KAAK,EACV,uBAAuB,EAEvB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAoC/B,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;CAC3C,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrD,kBAAkB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACvD;AAqED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CA2GtC;AAymBD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAC;CACrE,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA4BzC"}