@muha-sdk/agy-adapter 0.0.0-stage → 0.1.13

package/dist/agy-supervisor.c

@@ -0,0 +1,205 @@
+#define _GNU_SOURCE
+#include <errno.h>
+#include <fcntl.h>
+#include <limits.h>
+#include <poll.h>
+#include <signal.h>
+#include <stdbool.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <sys/prctl.h>
+#include <sys/signalfd.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+#include <time.h>
+#include <unistd.h>
+
+/* fd 0/1/2 belong to the CLI; fd 3 is a private duplex
+ * control channel, closed before native exec. The helper is single-threaded
+ * and the only reaper of its children. Shared by AGY and the ACP transport.
+ * ADR-0128 (AGY) and ADR-0138 (shared ACP) separately exclude complete
+ * reclamation after this helper's own death; callers must report that failure.
+ * This process alone cannot reclaim descendants after its own SIGKILL. */
+static int control_fd = 3;
+static int signal_fd = -1;
+static int exec_fd = -1;
+static pid_t native_pid = -1;
+static bool closing = false;
+static bool cleanup_error = false;
+static long long force_at;
+static char children_path[96];
+
+static long long now_ms(void) {
+    struct timespec value;
+    if (clock_gettime(CLOCK_MONOTONIC, &value) < 0) _exit(125);
+    return (long long)value.tv_sec * 1000 + value.tv_nsec / 1000000;
+}
+
+static void error_event(const char *operation) {
+    int saved = errno;
+    dprintf(control_fd, "{\"type\":\"error\",\"operation\":\"%s\",\"errno\":%d}\n", operation, saved);
+    cleanup_error = true;
+}
+
+/* No wait(), SIGCHLD reaper, SA_NOCLDWAIT, or second thread may run between
+ * reading a PID here and signalling it. Even an exited direct child remains
+ * ours, unreaped, so its PID cannot be reused. A truncated/racing list is never
+ * treated as complete: subsequent adoption passes continue until ECHILD. */
+static int signal_direct_children(int signo) {
+    FILE *children = fopen(children_path, "re");
+    if (!children) return -1;
+    long value;
+    int count = 0;
+    while (fscanf(children, "%ld", &value) == 1) {
+        if (value <= 1 || value > INT_MAX || value == getpid()) {
+            errno = EINVAL;
+            fclose(children);
+            return -1;
+        }
+        if (kill((pid_t)value, signo) < 0 && errno != ESRCH) {
+            int saved = errno;
+            fclose(children);
+            errno = saved;
+            return -1;
+        }
+        count++;
+    }
+    if (ferror(children)) {
+        int saved = errno;
+        fclose(children);
+        errno = saved;
+        return -1;
+    }
+    fclose(children);
+    return count;
+}
+
+static void start_close(const char *reason, int signo, long grace_ms) {
+    if (closing) return;
+    closing = true;
+    force_at = now_ms() + grace_ms;
+    dprintf(control_fd, "{\"type\":\"closing\",\"reason\":\"%s\"}\n", reason);
+    if (signal_direct_children(signo) < 0) error_event("signalOwnedChildren");
+}
+
+/* Returns true only after the kernel confirms that this sole owner has no
+ * children left. Once native spawning is disabled, ECHILD also excludes any
+ * remaining descendant that could later fork or become an adopted orphan. */
+static bool reap_children(void) {
+    int status;
+    pid_t pid;
+    while ((pid = waitpid(-1, &status, WNOHANG)) > 0) {
+        if (pid == native_pid) {
+            native_pid = -1;
+            dprintf(control_fd, "{\"type\":\"nativeExit\",\"code\":%d,\"signal\":%d}\n",
+                WIFEXITED(status) ? WEXITSTATUS(status) : -1,
+                WIFSIGNALED(status) ? WTERMSIG(status) : 0);
+            if (!closing) start_close("nativeExit", SIGKILL, 0);
+        }
+    }
+    if (pid < 0 && errno != ECHILD && errno != EINTR) error_event("waitpid");
+    return pid < 0 && errno == ECHILD;
+}
+
+static void start_native(char **argv, const sigset_t *original_mask, const struct sigaction *original_pipe) {
+    int startup[2];
+    if (pipe2(startup, O_CLOEXEC) < 0) { error_event("execPipe"); start_close("spawnError", SIGKILL, 0); return; }
+    if (fcntl(startup[0], F_SETFL, O_NONBLOCK) < 0) {
+        close(startup[0]); close(startup[1]); error_event("execPipeFlags"); start_close("spawnError", SIGKILL, 0); return;
+    }
+    native_pid = fork();
+    if (native_pid == 0) {
+        close(startup[0]);
+        close(control_fd);
+        close(signal_fd);
+        if (sigprocmask(SIG_SETMASK, original_mask, NULL) < 0 || sigaction(SIGPIPE, original_pipe, NULL) < 0 || setsid() < 0) {
+            int saved = errno;
+            _exit(write(startup[1], &saved, sizeof(saved)) == sizeof(saved) ? 126 : 125);
+        }
+        execvp(argv[0], argv);
+        int saved = errno;
+        _exit(write(startup[1], &saved, sizeof(saved)) == sizeof(saved) ? 127 : 125);
+    }
+    close(startup[1]);
+    if (native_pid < 0) {
+        close(startup[0]); error_event("fork"); start_close("spawnError", SIGKILL, 0); return;
+    }
+    exec_fd = startup[0];
+}
+
+static void observe_exec(void) {
+    if (exec_fd < 0) return;
+    int exec_errno = 0;
+    ssize_t size = read(exec_fd, &exec_errno, sizeof(exec_errno));
+    if (size < 0 && (errno == EAGAIN || errno == EINTR)) return;
+    close(exec_fd);
+    exec_fd = -1;
+    if (size != 0) {
+        errno = size == sizeof(exec_errno) ? exec_errno : EIO;
+        error_event("exec"); start_close("spawnError", SIGKILL, 0); return;
+    }
+    dprintf(control_fd, "{\"type\":\"spawned\",\"pid\":%d}\n", native_pid);
+}
+
+int main(int argc, char **argv) {
+    if (argc < 3) return 64;
+    char *end;
+    errno = 0;
+    long grace_ms = strtol(argv[1], &end, 10);
+    if (errno || *end || grace_ms < 0 || grace_ms > 60000) return 64;
+    struct sigaction action = { .sa_handler = SIG_DFL }, original_pipe;
+    sigemptyset(&action.sa_mask);
+    if (sigaction(SIGCHLD, &action, NULL) < 0) return 125;
+    action.sa_handler = SIG_IGN;
+    if (sigaction(SIGPIPE, &action, &original_pipe) < 0) return 125;
+    sigset_t mask, original_mask;
+    sigemptyset(&mask);
+    sigaddset(&mask, SIGCHLD);
+    if (sigprocmask(SIG_BLOCK, &mask, &original_mask) < 0 || prctl(PR_SET_CHILD_SUBREAPER, 1) < 0) return 125;
+    signal_fd = signalfd(-1, &mask, SFD_CLOEXEC | SFD_NONBLOCK);
+    if (signal_fd < 0) return 125;
+    snprintf(children_path, sizeof(children_path), "/proc/%d/task/%d/children", getpid(), getpid());
+    if (signal_direct_children(0) < 0) { error_event("ownershipPreflight"); return 125; }
+    dprintf(control_fd, "{\"type\":\"ready\",\"pid\":%d}\n", getpid());
+    char command[128];
+    size_t used = 0;
+    bool started = false, control_open = true;
+    for (;;) {
+        observe_exec();
+        if (closing && now_ms() >= force_at && signal_direct_children(SIGKILL) < 0) error_event("forceOwnedChildren");
+        if (reap_children() && closing) {
+            dprintf(control_fd, "{\"type\":\"closed\",\"noChildren\":true,\"cleanupError\":%s}\n", cleanup_error ? "true" : "false");
+            return cleanup_error ? 125 : 0;
+        }
+        struct pollfd fds[3] = { { .fd = control_open ? control_fd : -1, .events = POLLIN }, { .fd = signal_fd, .events = POLLIN }, { .fd = exec_fd, .events = POLLIN } };
+        int timeout = closing ? (now_ms() >= force_at ? 1 : (int)(force_at - now_ms())) : -1;
+        int count = poll(fds, 3, timeout);
+        if (count < 0) { if (errno == EINTR) continue; error_event("poll"); start_close("controlError", SIGKILL, 0); continue; }
+        if (fds[1].revents & POLLIN) {
+            struct signalfd_siginfo info;
+            while (read(signal_fd, &info, sizeof(info)) == sizeof(info)) {}
+        }
+        if (!(fds[0].revents & (POLLIN | POLLHUP | POLLERR | POLLNVAL))) continue;
+        char chunk[128];
+        ssize_t size = read(control_fd, chunk, sizeof(chunk));
+        if (size <= 0) {
+            if (size < 0 && (errno == EINTR || errno == EAGAIN)) continue;
+            control_open = false;
+            start_close("controlEof", SIGKILL, 0);
+            continue;
+        }
+        for (ssize_t i = 0; i < size; i++) {
+            if (chunk[i] != '\n') {
+                if (used + 1 == sizeof(command)) { start_close("invalidControl", SIGKILL, 0); used = 0; break; }
+                command[used++] = chunk[i]; continue;
+            }
+            command[used] = 0;
+            used = 0;
+            if (!strcmp(command, "go") && !started && !closing) { started = true; start_native(argv + 2, &original_mask, &original_pipe); }
+            else if (!strcmp(command, "close")) start_close("close", SIGTERM, grace_ms);
+            else if (!strcmp(command, "interrupt")) start_close("interrupt", SIGINT, grace_ms);
+            else start_close("invalidControl", SIGKILL, 0);
+        }
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessRegistration, OfficialAdapterOptions } from "@muha-sdk/core";
+export type { OfficialAdapterOptions } from "@muha-sdk/core";
+export declare function agyAdapter(options?: OfficialAdapterOptions): HarnessRegistration;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAevG,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,wBAAgB,UAAU,CAAC,OAAO,GAAE,sBAA2B,GAAG,mBAAmB,CAOpF"}

package/dist/index.js

@@ -0,0 +1,19 @@
+import { composeWorkspaceConfigurator, createOfficialHarnessRegistration, createSkillsCliPlanner } from "@muha-sdk/core/internal";
+import { AgyProcess } from "./agy-process.js";
+// Stage-five target declaration; admission additionally requires the complete
+// Conformance matrix and real CLI / Orchestrator qualification in #1.
+const capabilities = Object.freeze({
+    sessionListing: false, imageInput: false,
+    approvalPolicies: Object.freeze(["harnessManaged", "autoApprove"]),
+    turnQuestions: false, workspaceSkills: true, workspaceMcp: false,
+    model: Object.freeze({ selectionAt: Object.freeze(["createSession", "resumeSession"]), observation: "selectedOnly" }),
+    effort: Object.freeze({ selectionAt: Object.freeze(["createSession", "resumeSession"]), observation: "selectedOnly", requiresKnownModel: false }),
+    assistantMessageStreaming: true, assistantReasoningStreaming: false, toolEvents: true, turnUsage: true,
+});
+export function agyAdapter(options = {}) {
+    return createOfficialHarnessRegistration("agy", options, capabilities, composeWorkspaceConfigurator({
+        planSkill: createSkillsCliPlanner("antigravity-cli"),
+        planMcpServer() { throw new Error("AGY Workspace MCP is not supported"); },
+    }), (snapshot, context) => new AgyProcess(snapshot, context));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAClI,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,8EAA8E;AAC9E,sEAAsE;AACtE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACjC,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK;IACxC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,gBAAgB,EAAE,aAAa,CAAU,CAAC;IAC3E,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK;IAChE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,eAAe,CAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9H,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,eAAe,CAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;IAC1J,yBAAyB,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI;CACzE,CAAC,CAAC;AAGjC,MAAM,UAAU,UAAU,CAAC,UAAkC,EAAE;IAC7D,OAAO,iCAAiC,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EACnE,4BAA4B,CAAC;QAC3B,SAAS,EAAE,sBAAsB,CAAC,iBAAiB,CAAC;QACpD,aAAa,KAAK,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC;KAC3E,CAAC,EACF,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/native-metadata.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessErrorData } from "@muha-sdk/core";
+export declare function nativeBinding(env: NodeJS.ProcessEnv, id: string, workspace: string, operation?: HarnessErrorData["operation"]): Promise<string>;
+//# sourceMappingURL=native-metadata.d.ts.map

package/dist/native-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-metadata.d.ts","sourceRoot":"","sources":["../src/native-metadata.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKvD,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EACvF,SAAS,GAAE,gBAAgB,CAAC,WAAW,CAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2D7E"}

package/dist/native-metadata.js

@@ -0,0 +1,164 @@
+import { constants } from "node:fs";
+import { access, open, realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { fileURLToPath } from "node:url";
+import { failure, object } from "./protocol.js";
+// Private native format qualified in the metadata research. Never enumerate
+// conversations, read transcripts, repair a DB, or maintain a Muha index.
+export async function nativeBinding(env, id, workspace, operation = "resumeSession") {
+    const invalid = (detail) => { throw failure(operation, `Unusable AGY Session metadata: ${detail}`); };
+    if (!safeComponent(id))
+        invalid("invalid native identity");
+    const home = env.HOME ?? homedir();
+    const path = join(home, ".gemini/antigravity-cli/conversations", `${id}.db`);
+    try {
+        await access(path);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            throw {
+                ...failure(operation, "AGY native Session does not exist"), nativeCode: "session_not_found",
+            };
+        invalid("cannot access native database");
+    }
+    let projectId;
+    let workspaceUris;
+    try {
+        const db = new DatabaseSync(path, { readOnly: true });
+        try {
+            db.exec("PRAGMA busy_timeout=0; PRAGMA query_only=ON; BEGIN");
+            // Inspect lengths in a separate statement before SQLite materializes
+            // values. substr alone would still load a corrupt oversized BLOB.
+            const identitySizes = db.prepare("SELECT typeof(cascade_id) AS kind, octet_length(cascade_id) AS size FROM trajectory_meta LIMIT 2").all();
+            const blobSizes = db.prepare("SELECT typeof(id) AS idKind, octet_length(id) AS idSize, typeof(data) AS kind, octet_length(data) AS size FROM trajectory_metadata_blob LIMIT 2").all();
+            if (identitySizes.length !== 1 || identitySizes[0].kind !== "text" ||
+                identitySizes[0].size !== Buffer.byteLength(id) ||
+                blobSizes.length !== 1 || blobSizes[0].idKind !== "text" || blobSizes[0].idSize !== 4 ||
+                blobSizes[0].kind !== "blob" || typeof blobSizes[0].size !== "number" || blobSizes[0].size > 1024 * 1024) {
+                invalid("identity, metadata cardinality, or supported size bound");
+            }
+            const identities = db.prepare("SELECT cascade_id FROM trajectory_meta LIMIT 2").all();
+            const blobs = db.prepare("SELECT id, data FROM trajectory_metadata_blob LIMIT 2").all();
+            if (identities.length !== 1 || identities[0].cascade_id !== id || blobs.length !== 1 ||
+                blobs[0].id !== "main" || !(blobs[0].data instanceof Uint8Array))
+                invalid("identity or metadata cardinality");
+            const data = blobs[0].data;
+            if (blobSizes[0].size !== data.byteLength)
+                invalid("metadata changed within its read snapshot");
+            const fields = decodeFields(data);
+            const projects = strings(fields, 18);
+            workspaceUris = strings(fields, 7);
+            if (projects.length !== 1 || !safeComponent(projects[0]) || workspaceUris.length !== 1)
+                invalid("Project or Workspace cardinality");
+            projectId = projects[0];
+            // Deprecated workspaces supply a consistency check only. Their git root
+            // field is deliberately not treated as an additional Workspace.
+            const legacy = fields.filter(field => field.number === 1);
+            if (legacy.length) {
+                if (legacy.length !== 1 || legacy[0].wire !== 2)
+                    invalid("legacy Workspace cardinality");
+                const oldUris = strings(decodeFields(legacy[0].bytes), 1);
+                if (oldUris.length !== 1 || await directory(oldUris[0]) !== await directory(workspaceUris[0]))
+                    invalid("conflicting Workspace metadata");
+            }
+            db.exec("COMMIT");
+        }
+        finally {
+            db.close();
+        }
+        const json = await readProject(join(home, ".gemini/config/projects", `${projectId}.json`));
+        const project = object(JSON.parse(json));
+        const resources = object(project.projectResources).resources;
+        if (project.id !== projectId || !Array.isArray(resources) || resources.length !== 1)
+            return invalid("Project identity or resources");
+        const folderUri = object(resources[0]).folderUri;
+        if (typeof folderUri !== "string")
+            invalid("Project has no directory binding");
+        if (await directory(folderUri) !== workspace || await directory(workspaceUris[0]) !== workspace) {
+            invalid("Session, Project, and requested Workspace disagree");
+        }
+        return projectId;
+    }
+    catch {
+        return invalid("unknown format, unreadable data, or conflicting Workspace binding");
+    }
+}
+async function readProject(path) {
+    const limit = 1024 * 1024;
+    const file = await open(path, constants.O_RDONLY | constants.O_NONBLOCK);
+    try {
+        const metadata = await file.stat();
+        if (!metadata.isFile() || metadata.size > limit)
+            throw new Error("Unsupported Project file");
+        const buffer = Buffer.alloc(limit + 1);
+        let offset = 0;
+        while (offset < buffer.length) {
+            const { bytesRead } = await file.read(buffer, offset, buffer.length - offset, offset);
+            if (bytesRead === 0)
+                break;
+            offset += bytesRead;
+        }
+        if (offset > limit)
+            throw new Error("Project exceeds supported bound");
+        return new TextDecoder("utf-8", { fatal: true }).decode(buffer.subarray(0, offset));
+    }
+    finally {
+        await file.close();
+    }
+}
+function safeComponent(value) {
+    return value.length > 0 && value.length < 256 && value !== "." && value !== ".." && !/[\/\\\u0000-\u001f]/u.test(value);
+}
+async function directory(value) {
+    const uri = new URL(value);
+    if (uri.protocol !== "file:" || uri.hostname !== "" || uri.search || uri.hash)
+        throw new Error("Nonlocal Workspace URI");
+    const path = fileURLToPath(uri);
+    if (path.includes("\0"))
+        throw new Error("Invalid Workspace URI");
+    return realpath(path);
+}
+function decodeFields(data) {
+    let offset = 0;
+    const varint = () => {
+        let value = 0n;
+        for (let shift = 0n; shift < 70n; shift += 7n) {
+            const byte = data[offset++];
+            if (byte === undefined || (shift === 63n && byte > 1))
+                throw new Error("Invalid protobuf varint");
+            value |= BigInt(byte & 127) << shift;
+            if (!(byte & 128))
+                return value;
+        }
+        throw new Error("Unterminated protobuf varint");
+    };
+    const fields = [];
+    while (offset < data.length) {
+        const tag = varint();
+        const number = Number(tag >> 3n);
+        const wire = Number(tag & 7n);
+        if (number < 1 || number > 0x1fffffff)
+            throw new Error("Invalid protobuf field");
+        if (wire === 0) {
+            varint();
+            fields.push({ number, wire });
+            continue;
+        }
+        const length = wire === 2 ? Number(varint()) : wire === 1 ? 8 : wire === 5 ? 4 : -1;
+        if (!Number.isSafeInteger(length) || length < 0 || length > data.length - offset)
+            throw new Error("Invalid protobuf length or wire type");
+        fields.push({ number, wire, bytes: data.subarray(offset, offset + length) });
+        offset += length;
+    }
+    return fields;
+}
+function strings(fields, number) {
+    return fields.filter(field => field.number === number).map(field => {
+        if (field.wire !== 2)
+            throw new Error("Incorrect native field type");
+        return new TextDecoder("utf-8", { fatal: true }).decode(field.bytes);
+    });
+}
+//# sourceMappingURL=native-metadata.js.map

package/dist/native-metadata.js.map

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

package/dist/owned-cli.d.ts

@@ -0,0 +1,11 @@
+import type { HarnessErrorData } from "@muha-sdk/core";
+import type { LiveHarnessAdapterContext } from "@muha-sdk/core/internal";
+import { Deferred, type JsonObject } from "./protocol.js";
+export declare class OwnedCli {
+    #private;
+    readonly ready: Deferred<JsonObject>;
+    constructor(args: readonly string[], cwd: string, env: NodeJS.ProcessEnv, shutdownMs: number, context: LiveHarnessAdapterContext, onEvent: (event: JsonObject, printTimedOut: boolean) => void, onLoss: (error: HarnessErrorData) => void, operation: HarnessErrorData["operation"]);
+    write(event: JsonObject): void;
+    close(interrupt?: boolean): Promise<void>;
+}
+//# sourceMappingURL=owned-cli.d.ts.map

package/dist/owned-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-cli.d.ts","sourceRoot":"","sources":["../src/owned-cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAW,QAAQ,EAAmB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAIpF,qBAAa,QAAQ;;IACnB,QAAQ,CAAC,KAAK,uBAA8B;gBAiBhC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAC1F,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,KAAK,IAAI,EAChG,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC;IA4GrF,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAC9B,KAAK,CAAC,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBxC"}

package/dist/owned-cli.js

@@ -0,0 +1,182 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+import { bounded, Deferred, failure, object } from "./protocol.js";
+// The independent helper owns/reaps its descendants. Nothing changes the
+// consuming Node process's signals, child ownership, cwd, or environment.
+export class OwnedCli {
+    ready = new Deferred();
+    #closed = new Deferred();
+    #child;
+    #control;
+    #input;
+    #shutdownMs;
+    #onLoss;
+    #incoming = Promise.resolve();
+    #closePromise;
+    #closing = false;
+    #reaped = false;
+    #lost = false;
+    #nativeReady = false;
+    #nativeExited = false;
+    #printTimedOut = false;
+    #outputEnded = new Deferred();
+    constructor(args, cwd, env, shutdownMs, context, onEvent, onLoss, operation) {
+        this.#shutdownMs = shutdownMs;
+        this.#onLoss = onLoss;
+        this.#child = spawn(fileURLToPath(new URL("./agy-supervisor", import.meta.url)), [String(Math.min(1_000, Math.floor(shutdownMs / 2))), "agy", ...args], { cwd, env, shell: false, stdio: ["pipe", "pipe", "pipe", "pipe"] });
+        this.#control = this.#child.stdio[3];
+        this.#input = this.#child.stdin;
+        const lose = (message) => {
+            const error = failure("closeHarness", message);
+            this.ready.reject(error);
+            if (!this.#closing && !this.#lost) {
+                this.#lost = true;
+                onLoss(error);
+            }
+        };
+        this.#child.once("error", error => lose(`AGY supervisor spawn failed: ${error.message}`));
+        this.#input.on("error", error => lose(`AGY input channel failed: ${error.message}`));
+        this.#control.on("error", error => lose(`AGY ownership channel failed: ${error.message}`));
+        this.#control.on("end", () => {
+            if (!this.#reaped && !this.#nativeExited)
+                lose("AGY ownership channel ended before cleanup");
+        });
+        const controlLines = createInterface({ input: this.#control });
+        controlLines.on("error", error => lose(`AGY ownership reader failed: ${error.message}`));
+        controlLines.on("line", line => {
+            try {
+                const event = object(JSON.parse(line));
+                if (event.type === "ready")
+                    this.#control.write("go\n");
+                else if (event.type === "closed") {
+                    this.#reaped = event.noChildren === true && event.cleanupError === false;
+                    if (!this.#reaped)
+                        this.#closed.reject(failure("closeSession", "AGY owned-process cleanup failed"));
+                }
+                else if (event.type === "nativeExit") {
+                    this.#nativeExited = true;
+                    // stdout and fd3 are independent pipes: drain semantic responses
+                    // before classifying an exit, especially an explicit startup ERROR.
+                    void this.#outputEnded.promise.then(() => this.#incoming).then(() => lose("AGY native process exited"), () => lose("AGY output failed before exit"));
+                }
+                else if (event.type === "error")
+                    lose(`AGY supervisor failed during ${String(event.operation)} (${String(event.errno)})`);
+            }
+            catch {
+                lose("Invalid AGY ownership response");
+            }
+        });
+        const output = this.#child.stdout;
+        const handle = async (line) => {
+            if (!line.trim())
+                return;
+            const event = object(JSON.parse(line));
+            if (event.event !== "init" && event.event !== "step_update" && event.event !== "result") {
+                throw new Error("Unrecognized AGY semantic envelope");
+            }
+            await context.recordNativeEvent("agy", event);
+            if (event.event === "init") {
+                if (this.#nativeReady)
+                    throw new Error("AGY repeated Session initialization");
+                this.#nativeReady = true;
+                this.ready.resolve(event);
+            }
+            else if (!this.#nativeReady && event.event === "result" && object(event.result).status === "ERROR") {
+                const result = object(event.result);
+                this.#closing = true;
+                this.ready.reject({ ...failure(operation, typeof result.error === "string" ? result.error : "AGY rejected Session initialization"),
+                    nativeCode: "ERROR", stage: "handshake" });
+            }
+            else {
+                // Native timeout reporting precedes result on a separate stderr
+                // pipe. Drain this poll's ready descriptors before its terminal.
+                if (event.event === "result")
+                    await new Promise(resolve => setImmediate(resolve));
+                onEvent(event, this.#printTimedOut);
+            }
+        };
+        output.setEncoding("utf8");
+        this.#incoming = (async () => {
+            let buffer = "";
+            try {
+                for await (const chunk of output) {
+                    buffer += String(chunk);
+                    if (Buffer.byteLength(buffer) > 8 * 1024 * 1024)
+                        throw new Error("AGY protocol frame exceeds 8 MiB");
+                    let end;
+                    while ((end = buffer.indexOf("\n")) >= 0) {
+                        const line = buffer.slice(0, end);
+                        buffer = buffer.slice(end + 1);
+                        await handle(line);
+                    }
+                }
+                if (buffer.trim())
+                    await handle(buffer);
+                lose("AGY output channel ended");
+            }
+            catch {
+                lose("AGY output protocol or diagnostic recording failed");
+            }
+            finally {
+                this.#outputEnded.resolve();
+            }
+        })();
+        // Stderr is a bounded control observation, never a Native Event Record.
+        let stderrLine = "";
+        this.#child.stderr.setEncoding("utf8");
+        this.#child.stderr.on("data", (chunk) => {
+            stderrLine += chunk;
+            let end;
+            while ((end = stderrLine.indexOf("\n")) >= 0) {
+                const line = stderrLine.slice(0, end);
+                stderrLine = stderrLine.slice(end + 1);
+                if (/^\[agy\] print timeout after .+ with turn in progress; returning partial output\r?$/u.test(line))
+                    this.#printTimedOut = true;
+            }
+            if (stderrLine.length > 4_096)
+                stderrLine = stderrLine.slice(-4_096);
+        });
+        this.#child.stderr.on("error", error => lose(`AGY error channel failed: ${error.message}`));
+        this.#child.once("close", (code, signal) => {
+            void this.#incoming.finally(() => {
+                // This shipped helper exits 0 only after ECHILD with no cleanup error.
+                // A close write can race its exit and lose the final fd3 response; the
+                // child's exit status remains independent evidence of reclamation.
+                if (code === 0 && signal === null)
+                    this.#reaped = true;
+                if (this.#reaped)
+                    this.#closed.resolve();
+                else
+                    this.#closed.reject(failure("closeSession", "AGY supervisor exited without confirming descendant cleanup"));
+                lose("AGY supervisor exited");
+            }).catch(() => { });
+        });
+    }
+    write(event) { this.#printTimedOut = false; this.#input.write(`${JSON.stringify(event)}\n`); }
+    close(interrupt = false) {
+        if (this.#closePromise)
+            return this.#closePromise;
+        this.#closing = true;
+        if (!this.#reaped && !this.#control.destroyed)
+            this.#control.write(interrupt ? "interrupt\n" : "close\n");
+        this.#closePromise = bounded(this.#closed.promise, this.#shutdownMs, failure("closeSession", "AGY descendant cleanup timed out")).catch(error => {
+            // Helper death is outside the complete cleanup guarantee (ADR-0128).
+            // A deadline reports failure and never claims descendants were reaped.
+            this.#child.kill("SIGKILL");
+            this.#control.destroy();
+            this.#input.destroy();
+            this.#child.stdout?.destroy();
+            this.#child.stderr?.destroy();
+            // An intentional close suppresses expected EOF, never an inability
+            // to reclaim execution. Helper loss remains fatal under ADR-0128.
+            if (!this.#lost) {
+                this.#lost = true;
+                this.#onLoss(error);
+            }
+            throw error;
+        });
+        return this.#closePromise;
+    }
+}
+//# sourceMappingURL=owned-cli.js.map

package/dist/owned-cli.js.map

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