@abaigram/abai-stub 0.0.0-stage → 0.2.0

package/dist/entry.js

@@ -0,0 +1,409 @@
+// The standard agent entry (abaigrammar section 4.4), the part the stub
+// provides itself: `<prog> abai manifest` prints the effective manifest and
+// `<prog> abai doctor` runs the offline conformance checks. The verbs that
+// need a harness (session, install, config, mcp, run) are delegated once a
+// harness binding exists; until then the usage says so. Never throws;
+// resolves to the exit code.
+import { spawn } from "node:child_process";
+import { accessSync, constants, existsSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { findRoot, MANIFEST_FILE } from "./content.js";
+import { ENV_HARNESS, ENV_MODE, expandHome } from "./env.js";
+import { validateManifest } from "./manifest/manifest.js";
+import { parseManifestYaml, renderManifestYaml } from "./manifest/render.js";
+import { harnessBinary, importHarnessModule } from "./program.js";
+export const STUB_VERSION = "0.2.0";
+export const processIo = {
+    out: (text) => {
+        process.stdout.write(text);
+    },
+    err: (text) => {
+        process.stderr.write(`${text}\n`);
+    },
+    env: process.env,
+    get cwd() {
+        return process.cwd();
+    },
+};
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function usageLines(entry) {
+    return [
+        `usage: ${entry}                      open a session`,
+        `       ${entry} install              run the install touchpoint`,
+        `       ${entry} manifest [--json]    print the effective manifest`,
+        `       ${entry} doctor [--root <dir>] [--offline] [--json]`,
+        `       ${entry} config [set ...]       the machine-level model configuration`,
+        `       ${entry} mcp                  serve the agent's tools to an MCP client over stdio`,
+        `       ${entry} run [--auto] -- ARGS  the harness starts this program as its supervised child`,
+        "",
+        "doctor  offline conformance checks: the effective manifest, the checked-in",
+        `        ${MANIFEST_FILE}, the identity content, the modes, the audit directory`,
+        "",
+        "session and install attach a harness and return when none can attach; mcp needs no model,",
+        "since the client's own agent is this program's; run is always sidecar launch, with the whole",
+        "lifecycle channel and the program's output observed from outside.",
+    ];
+}
+/** `--flag`, `--flag value` and `--flag=value`; anything else is a usage error. */
+function parseFlags(args, allowed) {
+    const flags = { json: false, root: undefined, offline: false };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const eq = arg.indexOf("=");
+        const name = eq === -1 ? arg : arg.slice(0, eq);
+        if (!allowed.includes(name))
+            return `unknown option ${arg}`;
+        const takeValue = () => {
+            if (eq !== -1)
+                return arg.slice(eq + 1);
+            i += 1;
+            return args[i];
+        };
+        switch (name) {
+            case "--json":
+                flags.json = true;
+                break;
+            case "--offline":
+                flags.offline = true;
+                break;
+            case "--root": {
+                const value = takeValue();
+                if (value === undefined || value === "")
+                    return "--root needs a directory";
+                flags.root = value;
+                break;
+            }
+            default:
+                return `unknown option ${arg}`;
+        }
+    }
+    return flags;
+}
+/** The first line at which two texts differ (1-based), or undefined when equal. */
+export function firstDifferingLine(a, b) {
+    if (a === b)
+        return undefined;
+    const linesA = a.split("\n");
+    const linesB = b.split("\n");
+    const n = Math.max(linesA.length, linesB.length);
+    for (let i = 0; i < n; i++) {
+        if (linesA[i] !== linesB[i])
+            return i + 1;
+    }
+    return n;
+}
+/** The first existing ancestor of a path (the path itself included). */
+function existingAncestor(path) {
+    let current = path;
+    while (!existsSync(current)) {
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return current;
+}
+/** The offline half of `doctor` (section 4.4), plus the online half when the harness package is installed. Never throws. */
+export async function runDoctor(app, options = {}) {
+    const io = options.io ?? processIo;
+    const checks = [];
+    const add = (name, status, detail) => {
+        checks.push({ name, status, detail });
+    };
+    const { manifest } = app;
+    add("entry", "ok", `${manifest.entry} reached (abai stub ${STUB_VERSION})`);
+    const violations = validateManifest(manifest);
+    let rendered;
+    if (violations.length === 0) {
+        rendered = renderManifestYaml(manifest);
+        add("manifest", "ok", `the effective manifest validates (${manifest.cells.length} cells, ${manifest.events.length} events, ${manifest.capabilities.length} capabilities, ${manifest.decisions.length} decisions, ${manifest.turns.length} turns)`);
+    }
+    else {
+        add("manifest", "fail", `the effective manifest does not validate: ${violations.join("; ")}`);
+    }
+    const root = options.root !== undefined
+        ? resolve(io.cwd, options.root)
+        : (findRoot(manifest.name, io.cwd) ??
+            (existsSync(join(app.content.root, MANIFEST_FILE)) ? app.content.root : undefined));
+    if (root === undefined) {
+        add("root", "skip", `no checkout found (pass --root <dir> to check a checked-in ${MANIFEST_FILE})`);
+        add(MANIFEST_FILE, "skip", "no checkout");
+        add("identity", "skip", "no checkout");
+    }
+    else {
+        add("root", "ok", root);
+        const path = join(root, MANIFEST_FILE);
+        if (!existsSync(path)) {
+            add(MANIFEST_FILE, "fail", `${path} is missing; run: ${manifest.entry} manifest > ${MANIFEST_FILE}`);
+        }
+        else {
+            let text;
+            try {
+                text = readFileSync(path, "utf8");
+            }
+            catch (error) {
+                add(MANIFEST_FILE, "fail", `${path} could not be read: ${errorMessage(error)}`);
+            }
+            if (text !== undefined) {
+                let parsed;
+                let parseError;
+                try {
+                    parsed = parseManifestYaml(text);
+                }
+                catch (error) {
+                    parseError = errorMessage(error);
+                }
+                if (parseError !== undefined) {
+                    add(MANIFEST_FILE, "fail", `${path} does not parse: ${parseError}`);
+                }
+                else {
+                    const fileViolations = validateManifest(parsed);
+                    if (fileViolations.length > 0) {
+                        add(MANIFEST_FILE, "fail", `${path} does not validate: ${fileViolations.join("; ")}`);
+                    }
+                    else if (rendered !== undefined && text !== rendered) {
+                        add(MANIFEST_FILE, "fail", `${path} is stale: first difference at line ${firstDifferingLine(text, rendered)}; run: ${manifest.entry} manifest > ${MANIFEST_FILE}`);
+                    }
+                    else if (rendered !== undefined) {
+                        add(MANIFEST_FILE, "ok", `${path} validates and agrees with the code`);
+                    }
+                    else {
+                        add(MANIFEST_FILE, "fail", `${path} validates but the effective manifest does not`);
+                    }
+                }
+            }
+        }
+        const identity = join(root, manifest.content.identity);
+        try {
+            if (!existsSync(identity))
+                add("identity", "fail", `${identity} is missing`);
+            else if (readFileSync(identity, "utf8").trim() === "")
+                add("identity", "fail", `${identity} is empty`);
+            else
+                add("identity", "ok", identity);
+        }
+        catch (error) {
+            add("identity", "fail", `${identity} could not be read: ${errorMessage(error)}`);
+        }
+    }
+    if (app.harnessSelectionError !== undefined)
+        add("harness", "fail", app.harnessSelectionError);
+    else
+        add("harness", "ok", `${ENV_HARNESS}: ${app.harnessSelection}`);
+    const modes = manifest.modes;
+    const selected = io.env[ENV_MODE]?.trim();
+    if (selected === undefined || selected === "") {
+        add("modes", "ok", `declared: ${modes.join(", ")}; default ${modes[0]}`);
+    }
+    else if (modes.includes(selected)) {
+        add("modes", "ok", `${ENV_MODE}=${selected} is declared (declared: ${modes.join(", ")})`);
+    }
+    else {
+        add("modes", "fail", `${ENV_MODE}=${selected} is not declared (declared: ${modes.join(", ")}); a plain run falls back and counts it`);
+    }
+    if (app.endpoint !== undefined) {
+        // under sidecar the endpoint has been listening since startup; doctor says where, or why not
+        try {
+            await app.endpoint.ready;
+            add("endpoint", "ok", `listening at ${app.endpoint.socketPath}`);
+        }
+        catch (error) {
+            add("endpoint", "fail", `the endpoint could not listen: ${errorMessage(error)}`);
+        }
+    }
+    try {
+        const auditPath = expandHome(manifest.audit.path, io.env.HOME ?? "");
+        const ancestor = existingAncestor(dirname(resolve(io.cwd, auditPath)));
+        if (!statSync(ancestor).isDirectory()) {
+            add("audit", "fail", `${ancestor} is not a directory`);
+        }
+        else {
+            accessSync(ancestor, constants.W_OK);
+            add("audit", "ok", `${auditPath} (${ancestor} is writable)`);
+        }
+    }
+    catch (error) {
+        add("audit", "fail", `the audit directory is not writable: ${errorMessage(error)}`);
+    }
+    if (options.online === false) {
+        add("online", "skip", "not asked (--offline)");
+    }
+    else {
+        const harness = await importHarnessModule(io.env, manifest);
+        if (!harness?.doctorOnline) {
+            add("online", "skip", "no harness is installed to check the model");
+        }
+        else {
+            try {
+                for (const check of await harness.doctorOnline(manifest, io.env))
+                    add(check.name, check.status, check.detail);
+            }
+            catch (error) {
+                add("online", "fail", `the harness's check failed: ${errorMessage(error)}`);
+            }
+        }
+    }
+    return { ok: checks.every((check) => check.status !== "fail"), root: root ?? null, checks };
+}
+function printReport(report, io) {
+    for (const check of report.checks)
+        io.out(`${check.status.padEnd(4)} ${check.name}: ${check.detail}\n`);
+    io.out(report.ok ? "doctor: ok\n" : "doctor: failed\n");
+}
+/**
+ * `<prog> abai <verb> ...`. `args` are the arguments after the program's
+ * own name; the first must be `abai`. Resolves to the exit code; -1 means
+ * the arguments were not an abai entry at all.
+ */
+export async function runEntry(app, args, io = processIo) {
+    if (args[0] !== "abai") {
+        // the entry is one of the five attach places (4.3): a launched program takes up its connection here,
+        // before its own work, so its first touchpoint finds the agent present
+        if (app.launched)
+            await app.attach();
+        return -1;
+    }
+    const { manifest } = app;
+    const usage = (problem) => {
+        if (problem !== undefined)
+            io.err(`${manifest.entry}: ${problem}`);
+        for (const line of usageLines(manifest.entry))
+            io.err(line);
+        return 2;
+    };
+    try {
+        const verb = args[1];
+        switch (verb) {
+            case "manifest": {
+                const flags = parseFlags(args.slice(2), ["--json"]);
+                if (typeof flags === "string")
+                    return usage(flags);
+                // a selected mode the manifest does not declare is an error at the entry (section 4.4)
+                const selected = io.env[ENV_MODE]?.trim();
+                if (selected !== undefined && selected !== "" && !manifest.modes.includes(selected)) {
+                    io.err(`${manifest.entry}: ${ENV_MODE}=${selected} is not a declared mode (declared: ${manifest.modes.join(", ")})`);
+                    return 2;
+                }
+                io.out(flags.json ? `${JSON.stringify(manifest, null, 2)}\n` : renderManifestYaml(manifest));
+                return 0;
+            }
+            case "doctor": {
+                const flags = parseFlags(args.slice(2), ["--json", "--root", "--offline"]);
+                if (typeof flags === "string")
+                    return usage(flags);
+                const report = await runDoctor(app, { root: flags.root, io, online: !flags.offline });
+                if (flags.json)
+                    io.out(`${JSON.stringify(report, null, 2)}\n`);
+                else
+                    printReport(report, io);
+                return report.ok ? 0 : 1;
+            }
+            case undefined:
+            case "session": {
+                await app.session();
+                if (app.attached)
+                    return 0;
+                io.err(`${manifest.entry}: no harness attached (${app.attachError ?? "unknown reason"})`);
+                return 1;
+            }
+            case "install": {
+                await app.install();
+                if (app.attached)
+                    return 0;
+                io.err(`${manifest.entry}: no harness attached (${app.attachError ?? "unknown reason"})`);
+                return 1;
+            }
+            case "config": {
+                const harness = await importHarnessModule(io.env, manifest);
+                if (!harness?.runConfig)
+                    return usage("config needs the harness package, which is not installed");
+                return await harness.runConfig(args.slice(2), io, { program: manifest.name });
+            }
+            case "mcp": {
+                // the program at its entry serves an MCP client: under sidecar through the binary on this
+                // process's stdio, otherwise in-process through the installed harness package (section 4.4).
+                // ABAI_HARNESS is honoured like everywhere: off attaches nothing, a null harness is attached already
+                if (app.harnessSelection === "off") {
+                    io.err(`${manifest.entry}: no harness attached (${ENV_HARNESS}=off)`);
+                    return 1;
+                }
+                if (app.attached) {
+                    io.err(`${manifest.entry}: ${manifest.name} already has a harness attached`);
+                    return 1;
+                }
+                if (app.endpoint !== undefined) {
+                    const code = await app.serveMcpSidecar(app.endpoint);
+                    if (code >= 0)
+                        return code;
+                    io.err(`${manifest.entry}: no harness attached (${app.attachError ?? "unknown reason"})`);
+                    return 1;
+                }
+                const harness = await importHarnessModule(io.env, manifest);
+                if (!harness?.serveMcpEmbedded)
+                    return usage("mcp needs the harness package, which is not installed");
+                const binding = app.bind("mcp");
+                binding.enterSafepoint();
+                try {
+                    return await harness.serveMcpEmbedded(binding);
+                }
+                finally {
+                    binding.leaveSafepoint();
+                }
+            }
+            case "run": {
+                // sidecar launch (4.4, 6.3): the harness binary starts this very program again as its child
+                if (!manifest.modes.includes("sidecar")) {
+                    io.err(`${manifest.entry}: run is sidecar launch, and ${manifest.name} declares ${manifest.modes.join(", ")}`);
+                    return 2;
+                }
+                const separator = args.indexOf("--");
+                const flags = args.slice(2, separator === -1 ? undefined : separator);
+                const programArgs = separator === -1 ? [] : args.slice(separator + 1);
+                for (const flag of flags) {
+                    if (flag !== "--auto" && flag !== "--deny-mutate" && flag !== "--all-events") {
+                        return usage(`unknown option ${flag} (run takes --auto, --deny-mutate, --all-events)`);
+                    }
+                }
+                const binary = harnessBinary(io.env, app.content.root);
+                const script = process.argv[1];
+                if (script === undefined)
+                    return usage("run cannot tell how this program was started");
+                const command = [process.execPath, ...process.execArgv, script, ...programArgs];
+                const child = spawn(binary.command, [...binary.args, "run", ...flags, "--", ...command], {
+                    stdio: "inherit",
+                    env: { ...process.env, ...io.env },
+                });
+                // whoever ends this process ends the launcher behind it, which ends the program it supervises
+                const forward = (signal) => {
+                    if (child.exitCode === null && child.signalCode === null)
+                        child.kill(signal);
+                };
+                const forwarded = ["SIGTERM", "SIGINT", "SIGHUP"];
+                for (const signal of forwarded)
+                    process.on(signal, forward);
+                try {
+                    return await new Promise((resolve) => {
+                        child.once("error", (error) => {
+                            io.err(`${manifest.entry}: the harness binary could not be started: ${errorMessage(error)}`);
+                            resolve(1);
+                        });
+                        child.once("exit", (code) => resolve(code ?? 1));
+                    });
+                }
+                finally {
+                    for (const signal of forwarded)
+                        process.off(signal, forward);
+                }
+            }
+            default:
+                return usage(`unknown verb ${verb}`);
+        }
+    }
+    catch (error) {
+        io.err(`${manifest.entry}: ${errorMessage(error)}`);
+        return 2;
+    }
+}
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"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","sourcesContent":["// The standard agent entry (abaigrammar section 4.4), the part the stub\n// provides itself: `<prog> abai manifest` prints the effective manifest and\n// `<prog> abai doctor` runs the offline conformance checks. The verbs that\n// need a harness (session, install, config, mcp, run) are delegated once a\n// harness binding exists; until then the usage says so. Never throws;\n// resolves to the exit code.\nimport { spawn } from \"node:child_process\";\nimport { accessSync, constants, existsSync, readFileSync, statSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { findRoot, MANIFEST_FILE } from \"./content.ts\";\nimport { ENV_HARNESS, ENV_MODE, expandHome } from \"./env.ts\";\nimport { validateManifest } from \"./manifest/manifest.ts\";\nimport { parseManifestYaml, renderManifestYaml } from \"./manifest/render.ts\";\nimport { type Abaigram, harnessBinary, importHarnessModule } from \"./program.ts\";\n\nexport const STUB_VERSION = \"0.2.0\";\n\nexport type CheckStatus = \"ok\" | \"fail\" | \"skip\";\n\nexport interface DoctorCheck {\n\tname: string;\n\tstatus: CheckStatus;\n\tdetail: string;\n}\n\nexport interface DoctorReport {\n\tok: boolean;\n\troot: string | null;\n\tchecks: DoctorCheck[];\n}\n\n/** Where the entry writes; injectable for tests. */\nexport interface EntryIo {\n\tout(text: string): void;\n\terr(text: string): void;\n\tenv: NodeJS.ProcessEnv;\n\tcwd: string;\n}\n\nexport const processIo: EntryIo = {\n\tout: (text) => {\n\t\tprocess.stdout.write(text);\n\t},\n\terr: (text) => {\n\t\tprocess.stderr.write(`${text}\\n`);\n\t},\n\tenv: process.env,\n\tget cwd() {\n\t\treturn process.cwd();\n\t},\n};\n\nfunction errorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nfunction usageLines(entry: string): string[] {\n\treturn [\n\t\t`usage: ${entry}                      open a session`,\n\t\t`       ${entry} install              run the install touchpoint`,\n\t\t`       ${entry} manifest [--json]    print the effective manifest`,\n\t\t`       ${entry} doctor [--root <dir>] [--offline] [--json]`,\n\t\t`       ${entry} config [set ...]       the machine-level model configuration`,\n\t\t`       ${entry} mcp                  serve the agent's tools to an MCP client over stdio`,\n\t\t`       ${entry} run [--auto] -- ARGS  the harness starts this program as its supervised child`,\n\t\t\"\",\n\t\t\"doctor  offline conformance checks: the effective manifest, the checked-in\",\n\t\t`        ${MANIFEST_FILE}, the identity content, the modes, the audit directory`,\n\t\t\"\",\n\t\t\"session and install attach a harness and return when none can attach; mcp needs no model,\",\n\t\t\"since the client's own agent is this program's; run is always sidecar launch, with the whole\",\n\t\t\"lifecycle channel and the program's output observed from outside.\",\n\t];\n}\n\ninterface Flags {\n\tjson: boolean;\n\troot: string | undefined;\n\toffline: boolean;\n}\n\n/** `--flag`, `--flag value` and `--flag=value`; anything else is a usage error. */\nfunction parseFlags(args: string[], allowed: readonly string[]): Flags | string {\n\tconst flags: Flags = { json: false, root: undefined, offline: false };\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\t\tconst eq = arg.indexOf(\"=\");\n\t\tconst name = eq === -1 ? arg : arg.slice(0, eq);\n\t\tif (!allowed.includes(name)) return `unknown option ${arg}`;\n\t\tconst takeValue = (): string | undefined => {\n\t\t\tif (eq !== -1) return arg.slice(eq + 1);\n\t\t\ti += 1;\n\t\t\treturn args[i];\n\t\t};\n\t\tswitch (name) {\n\t\t\tcase \"--json\":\n\t\t\t\tflags.json = true;\n\t\t\t\tbreak;\n\t\t\tcase \"--offline\":\n\t\t\t\tflags.offline = true;\n\t\t\t\tbreak;\n\t\t\tcase \"--root\": {\n\t\t\t\tconst value = takeValue();\n\t\t\t\tif (value === undefined || value === \"\") return \"--root needs a directory\";\n\t\t\t\tflags.root = value;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn `unknown option ${arg}`;\n\t\t}\n\t}\n\treturn flags;\n}\n\n/** The first line at which two texts differ (1-based), or undefined when equal. */\nexport function firstDifferingLine(a: string, b: string): number | undefined {\n\tif (a === b) return undefined;\n\tconst linesA = a.split(\"\\n\");\n\tconst linesB = b.split(\"\\n\");\n\tconst n = Math.max(linesA.length, linesB.length);\n\tfor (let i = 0; i < n; i++) {\n\t\tif (linesA[i] !== linesB[i]) return i + 1;\n\t}\n\treturn n;\n}\n\n/** The first existing ancestor of a path (the path itself included). */\nfunction existingAncestor(path: string): string {\n\tlet current = path;\n\twhile (!existsSync(current)) {\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) break;\n\t\tcurrent = parent;\n\t}\n\treturn current;\n}\n\n/** The offline half of `doctor` (section 4.4), plus the online half when the harness package is installed. Never throws. */\nexport async function runDoctor(\n\tapp: Abaigram,\n\toptions: { root?: string; io?: EntryIo; online?: boolean } = {},\n): Promise<DoctorReport> {\n\tconst io = options.io ?? processIo;\n\tconst checks: DoctorCheck[] = [];\n\tconst add = (name: string, status: CheckStatus, detail: string) => {\n\t\tchecks.push({ name, status, detail });\n\t};\n\tconst { manifest } = app;\n\n\tadd(\"entry\", \"ok\", `${manifest.entry} reached (abai stub ${STUB_VERSION})`);\n\n\tconst violations = validateManifest(manifest);\n\tlet rendered: string | undefined;\n\tif (violations.length === 0) {\n\t\trendered = renderManifestYaml(manifest);\n\t\tadd(\n\t\t\t\"manifest\",\n\t\t\t\"ok\",\n\t\t\t`the effective manifest validates (${manifest.cells.length} cells, ${manifest.events.length} events, ${manifest.capabilities.length} capabilities, ${manifest.decisions.length} decisions, ${manifest.turns.length} turns)`,\n\t\t);\n\t} else {\n\t\tadd(\"manifest\", \"fail\", `the effective manifest does not validate: ${violations.join(\"; \")}`);\n\t}\n\n\tconst root =\n\t\toptions.root !== undefined\n\t\t\t? resolve(io.cwd, options.root)\n\t\t\t: (findRoot(manifest.name, io.cwd) ??\n\t\t\t\t(existsSync(join(app.content.root, MANIFEST_FILE)) ? app.content.root : undefined));\n\tif (root === undefined) {\n\t\tadd(\"root\", \"skip\", `no checkout found (pass --root <dir> to check a checked-in ${MANIFEST_FILE})`);\n\t\tadd(MANIFEST_FILE, \"skip\", \"no checkout\");\n\t\tadd(\"identity\", \"skip\", \"no checkout\");\n\t} else {\n\t\tadd(\"root\", \"ok\", root);\n\t\tconst path = join(root, MANIFEST_FILE);\n\t\tif (!existsSync(path)) {\n\t\t\tadd(MANIFEST_FILE, \"fail\", `${path} is missing; run: ${manifest.entry} manifest > ${MANIFEST_FILE}`);\n\t\t} else {\n\t\t\tlet text: string | undefined;\n\t\t\ttry {\n\t\t\t\ttext = readFileSync(path, \"utf8\");\n\t\t\t} catch (error) {\n\t\t\t\tadd(MANIFEST_FILE, \"fail\", `${path} could not be read: ${errorMessage(error)}`);\n\t\t\t}\n\t\t\tif (text !== undefined) {\n\t\t\t\tlet parsed: unknown;\n\t\t\t\tlet parseError: string | undefined;\n\t\t\t\ttry {\n\t\t\t\t\tparsed = parseManifestYaml(text);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tparseError = errorMessage(error);\n\t\t\t\t}\n\t\t\t\tif (parseError !== undefined) {\n\t\t\t\t\tadd(MANIFEST_FILE, \"fail\", `${path} does not parse: ${parseError}`);\n\t\t\t\t} else {\n\t\t\t\t\tconst fileViolations = validateManifest(parsed);\n\t\t\t\t\tif (fileViolations.length > 0) {\n\t\t\t\t\t\tadd(MANIFEST_FILE, \"fail\", `${path} does not validate: ${fileViolations.join(\"; \")}`);\n\t\t\t\t\t} else if (rendered !== undefined && text !== rendered) {\n\t\t\t\t\t\tadd(\n\t\t\t\t\t\t\tMANIFEST_FILE,\n\t\t\t\t\t\t\t\"fail\",\n\t\t\t\t\t\t\t`${path} is stale: first difference at line ${firstDifferingLine(text, rendered)}; run: ${manifest.entry} manifest > ${MANIFEST_FILE}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t} else if (rendered !== undefined) {\n\t\t\t\t\t\tadd(MANIFEST_FILE, \"ok\", `${path} validates and agrees with the code`);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tadd(MANIFEST_FILE, \"fail\", `${path} validates but the effective manifest does not`);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tconst identity = join(root, manifest.content.identity);\n\t\ttry {\n\t\t\tif (!existsSync(identity)) add(\"identity\", \"fail\", `${identity} is missing`);\n\t\t\telse if (readFileSync(identity, \"utf8\").trim() === \"\") add(\"identity\", \"fail\", `${identity} is empty`);\n\t\t\telse add(\"identity\", \"ok\", identity);\n\t\t} catch (error) {\n\t\t\tadd(\"identity\", \"fail\", `${identity} could not be read: ${errorMessage(error)}`);\n\t\t}\n\t}\n\n\tif (app.harnessSelectionError !== undefined) add(\"harness\", \"fail\", app.harnessSelectionError);\n\telse add(\"harness\", \"ok\", `${ENV_HARNESS}: ${app.harnessSelection}`);\n\n\tconst modes = manifest.modes as string[];\n\tconst selected = io.env[ENV_MODE]?.trim();\n\tif (selected === undefined || selected === \"\") {\n\t\tadd(\"modes\", \"ok\", `declared: ${modes.join(\", \")}; default ${modes[0]}`);\n\t} else if (modes.includes(selected)) {\n\t\tadd(\"modes\", \"ok\", `${ENV_MODE}=${selected} is declared (declared: ${modes.join(\", \")})`);\n\t} else {\n\t\tadd(\n\t\t\t\"modes\",\n\t\t\t\"fail\",\n\t\t\t`${ENV_MODE}=${selected} is not declared (declared: ${modes.join(\", \")}); a plain run falls back and counts it`,\n\t\t);\n\t}\n\n\tif (app.endpoint !== undefined) {\n\t\t// under sidecar the endpoint has been listening since startup; doctor says where, or why not\n\t\ttry {\n\t\t\tawait app.endpoint.ready;\n\t\t\tadd(\"endpoint\", \"ok\", `listening at ${app.endpoint.socketPath}`);\n\t\t} catch (error) {\n\t\t\tadd(\"endpoint\", \"fail\", `the endpoint could not listen: ${errorMessage(error)}`);\n\t\t}\n\t}\n\n\ttry {\n\t\tconst auditPath = expandHome(manifest.audit.path, io.env.HOME ?? \"\");\n\t\tconst ancestor = existingAncestor(dirname(resolve(io.cwd, auditPath)));\n\t\tif (!statSync(ancestor).isDirectory()) {\n\t\t\tadd(\"audit\", \"fail\", `${ancestor} is not a directory`);\n\t\t} else {\n\t\t\taccessSync(ancestor, constants.W_OK);\n\t\t\tadd(\"audit\", \"ok\", `${auditPath} (${ancestor} is writable)`);\n\t\t}\n\t} catch (error) {\n\t\tadd(\"audit\", \"fail\", `the audit directory is not writable: ${errorMessage(error)}`);\n\t}\n\n\tif (options.online === false) {\n\t\tadd(\"online\", \"skip\", \"not asked (--offline)\");\n\t} else {\n\t\tconst harness = await importHarnessModule(io.env, manifest);\n\t\tif (!harness?.doctorOnline) {\n\t\t\tadd(\"online\", \"skip\", \"no harness is installed to check the model\");\n\t\t} else {\n\t\t\ttry {\n\t\t\t\tfor (const check of await harness.doctorOnline(manifest, io.env))\n\t\t\t\t\tadd(check.name, check.status, check.detail);\n\t\t\t} catch (error) {\n\t\t\t\tadd(\"online\", \"fail\", `the harness's check failed: ${errorMessage(error)}`);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { ok: checks.every((check) => check.status !== \"fail\"), root: root ?? null, checks };\n}\n\nfunction printReport(report: DoctorReport, io: EntryIo): void {\n\tfor (const check of report.checks) io.out(`${check.status.padEnd(4)} ${check.name}: ${check.detail}\\n`);\n\tio.out(report.ok ? \"doctor: ok\\n\" : \"doctor: failed\\n\");\n}\n\n/**\n * `<prog> abai <verb> ...`. `args` are the arguments after the program's\n * own name; the first must be `abai`. Resolves to the exit code; -1 means\n * the arguments were not an abai entry at all.\n */\nexport async function runEntry(app: Abaigram, args: string[], io: EntryIo = processIo): Promise<number> {\n\tif (args[0] !== \"abai\") {\n\t\t// the entry is one of the five attach places (4.3): a launched program takes up its connection here,\n\t\t// before its own work, so its first touchpoint finds the agent present\n\t\tif (app.launched) await app.attach();\n\t\treturn -1;\n\t}\n\tconst { manifest } = app;\n\tconst usage = (problem?: string): number => {\n\t\tif (problem !== undefined) io.err(`${manifest.entry}: ${problem}`);\n\t\tfor (const line of usageLines(manifest.entry)) io.err(line);\n\t\treturn 2;\n\t};\n\ttry {\n\t\tconst verb = args[1];\n\t\tswitch (verb) {\n\t\t\tcase \"manifest\": {\n\t\t\t\tconst flags = parseFlags(args.slice(2), [\"--json\"]);\n\t\t\t\tif (typeof flags === \"string\") return usage(flags);\n\t\t\t\t// a selected mode the manifest does not declare is an error at the entry (section 4.4)\n\t\t\t\tconst selected = io.env[ENV_MODE]?.trim();\n\t\t\t\tif (selected !== undefined && selected !== \"\" && !(manifest.modes as string[]).includes(selected)) {\n\t\t\t\t\tio.err(\n\t\t\t\t\t\t`${manifest.entry}: ${ENV_MODE}=${selected} is not a declared mode (declared: ${manifest.modes.join(\", \")})`,\n\t\t\t\t\t);\n\t\t\t\t\treturn 2;\n\t\t\t\t}\n\t\t\t\tio.out(flags.json ? `${JSON.stringify(manifest, null, 2)}\\n` : renderManifestYaml(manifest));\n\t\t\t\treturn 0;\n\t\t\t}\n\t\t\tcase \"doctor\": {\n\t\t\t\tconst flags = parseFlags(args.slice(2), [\"--json\", \"--root\", \"--offline\"]);\n\t\t\t\tif (typeof flags === \"string\") return usage(flags);\n\t\t\t\tconst report = await runDoctor(app, { root: flags.root, io, online: !flags.offline });\n\t\t\t\tif (flags.json) io.out(`${JSON.stringify(report, null, 2)}\\n`);\n\t\t\t\telse printReport(report, io);\n\t\t\t\treturn report.ok ? 0 : 1;\n\t\t\t}\n\t\t\tcase undefined:\n\t\t\tcase \"session\": {\n\t\t\t\tawait app.session();\n\t\t\t\tif (app.attached) return 0;\n\t\t\t\tio.err(`${manifest.entry}: no harness attached (${app.attachError ?? \"unknown reason\"})`);\n\t\t\t\treturn 1;\n\t\t\t}\n\t\t\tcase \"install\": {\n\t\t\t\tawait app.install();\n\t\t\t\tif (app.attached) return 0;\n\t\t\t\tio.err(`${manifest.entry}: no harness attached (${app.attachError ?? \"unknown reason\"})`);\n\t\t\t\treturn 1;\n\t\t\t}\n\t\t\tcase \"config\": {\n\t\t\t\tconst harness = await importHarnessModule(io.env, manifest);\n\t\t\t\tif (!harness?.runConfig) return usage(\"config needs the harness package, which is not installed\");\n\t\t\t\treturn await harness.runConfig(args.slice(2), io, { program: manifest.name });\n\t\t\t}\n\t\t\tcase \"mcp\": {\n\t\t\t\t// the program at its entry serves an MCP client: under sidecar through the binary on this\n\t\t\t\t// process's stdio, otherwise in-process through the installed harness package (section 4.4).\n\t\t\t\t// ABAI_HARNESS is honoured like everywhere: off attaches nothing, a null harness is attached already\n\t\t\t\tif (app.harnessSelection === \"off\") {\n\t\t\t\t\tio.err(`${manifest.entry}: no harness attached (${ENV_HARNESS}=off)`);\n\t\t\t\t\treturn 1;\n\t\t\t\t}\n\t\t\t\tif (app.attached) {\n\t\t\t\t\tio.err(`${manifest.entry}: ${manifest.name} already has a harness attached`);\n\t\t\t\t\treturn 1;\n\t\t\t\t}\n\t\t\t\tif (app.endpoint !== undefined) {\n\t\t\t\t\tconst code = await app.serveMcpSidecar(app.endpoint);\n\t\t\t\t\tif (code >= 0) return code;\n\t\t\t\t\tio.err(`${manifest.entry}: no harness attached (${app.attachError ?? \"unknown reason\"})`);\n\t\t\t\t\treturn 1;\n\t\t\t\t}\n\t\t\t\tconst harness = await importHarnessModule(io.env, manifest);\n\t\t\t\tif (!harness?.serveMcpEmbedded) return usage(\"mcp needs the harness package, which is not installed\");\n\t\t\t\tconst binding = app.bind(\"mcp\");\n\t\t\t\tbinding.enterSafepoint();\n\t\t\t\ttry {\n\t\t\t\t\treturn await harness.serveMcpEmbedded(binding);\n\t\t\t\t} finally {\n\t\t\t\t\tbinding.leaveSafepoint();\n\t\t\t\t}\n\t\t\t}\n\t\t\tcase \"run\": {\n\t\t\t\t// sidecar launch (4.4, 6.3): the harness binary starts this very program again as its child\n\t\t\t\tif (!(manifest.modes as string[]).includes(\"sidecar\")) {\n\t\t\t\t\tio.err(\n\t\t\t\t\t\t`${manifest.entry}: run is sidecar launch, and ${manifest.name} declares ${manifest.modes.join(\", \")}`,\n\t\t\t\t\t);\n\t\t\t\t\treturn 2;\n\t\t\t\t}\n\t\t\t\tconst separator = args.indexOf(\"--\");\n\t\t\t\tconst flags = args.slice(2, separator === -1 ? undefined : separator);\n\t\t\t\tconst programArgs = separator === -1 ? [] : args.slice(separator + 1);\n\t\t\t\tfor (const flag of flags) {\n\t\t\t\t\tif (flag !== \"--auto\" && flag !== \"--deny-mutate\" && flag !== \"--all-events\") {\n\t\t\t\t\t\treturn usage(`unknown option ${flag} (run takes --auto, --deny-mutate, --all-events)`);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst binary = harnessBinary(io.env, app.content.root);\n\t\t\t\tconst script = process.argv[1];\n\t\t\t\tif (script === undefined) return usage(\"run cannot tell how this program was started\");\n\t\t\t\tconst command = [process.execPath, ...process.execArgv, script, ...programArgs];\n\t\t\t\tconst child = spawn(binary.command, [...binary.args, \"run\", ...flags, \"--\", ...command], {\n\t\t\t\t\tstdio: \"inherit\",\n\t\t\t\t\tenv: { ...process.env, ...io.env },\n\t\t\t\t});\n\t\t\t\t// whoever ends this process ends the launcher behind it, which ends the program it supervises\n\t\t\t\tconst forward = (signal: NodeJS.Signals): void => {\n\t\t\t\t\tif (child.exitCode === null && child.signalCode === null) child.kill(signal);\n\t\t\t\t};\n\t\t\t\tconst forwarded: NodeJS.Signals[] = [\"SIGTERM\", \"SIGINT\", \"SIGHUP\"];\n\t\t\t\tfor (const signal of forwarded) process.on(signal, forward);\n\t\t\t\ttry {\n\t\t\t\t\treturn await new Promise<number>((resolve) => {\n\t\t\t\t\t\tchild.once(\"error\", (error) => {\n\t\t\t\t\t\t\tio.err(`${manifest.entry}: the harness binary could not be started: ${errorMessage(error)}`);\n\t\t\t\t\t\t\tresolve(1);\n\t\t\t\t\t\t});\n\t\t\t\t\t\tchild.once(\"exit\", (code) => resolve(code ?? 1));\n\t\t\t\t\t});\n\t\t\t\t} finally {\n\t\t\t\t\tfor (const signal of forwarded) process.off(signal, forward);\n\t\t\t\t}\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn usage(`unknown verb ${verb}`);\n\t\t}\n\t} catch (error) {\n\t\tio.err(`${manifest.entry}: ${errorMessage(error)}`);\n\t\treturn 2;\n\t}\n}\n"]}

package/dist/env.d.ts

@@ -0,0 +1,38 @@
+import type { Mode } from "./manifest/manifest.ts";
+export declare const ENV_MODE = "ABAI_MODE";
+export declare const ENV_HARNESS = "ABAI_HARNESS";
+/**
+ * Set by a harness that launched this program (section 6.3): the socket its
+ * endpoint must listen on, where the launcher is already waiting. Its
+ * presence is also what makes the full lifecycle channel available (5.5).
+ */
+export declare const ENV_LAUNCH_SOCKET = "ABAI_LAUNCH_SOCKET";
+/** Where a sidecar endpoint puts its socket and descriptor; default `<ABAI_HOME or ~/.abai>/run`, the harness's own default. */
+export declare const ENV_RUN_DIR = "ABAI_RUN_DIR";
+/** The harness binary the stub spawns at a touchpoint under sidecar; default: the program's `node_modules/.bin`, else PATH. */
+export declare const ENV_HARNESS_BIN = "ABAI_HARNESS_BIN";
+/** How long a sidecar attach waits for the spawned harness to connect, in milliseconds. */
+export declare const ENV_ATTACH_WAIT_MS = "ABAI_ATTACH_WAIT_MS";
+export declare const DEFAULT_ATTACH_WAIT_MS = 30000;
+/** The run directory for this environment. With no home at all, a private directory under the machine's temp dir. */
+export declare function runDirFrom(env?: NodeJS.ProcessEnv): string;
+/** The attach wait for this environment; an unusable value means the default. */
+export declare function attachWaitMsFrom(env?: NodeJS.ProcessEnv): number;
+export type HarnessSelection = "real" | "off" | "null" | "exercise";
+export interface ModeSelection {
+    mode: Mode;
+    /** The requested mode was not declared; the default applies and is counted. */
+    fallback: boolean;
+    /** What `ABAI_MODE` asked for, when set. */
+    requested?: string;
+}
+/** The mode for this run: the first declared, unless `ABAI_MODE` names a declared one. */
+export declare function selectMode(modes: readonly Mode[], env?: NodeJS.ProcessEnv): ModeSelection;
+/** The harness for this run. An unknown value selects the real harness and is reported, never thrown: the program runs. */
+export declare function selectHarness(env?: NodeJS.ProcessEnv): {
+    selection: HarnessSelection;
+    error?: string;
+};
+/** `~` at the start of a path means the home directory. */
+export declare function expandHome(path: string, home?: string): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,eAAO,MAAM,QAAQ,cAAc,CAAC;AACpC,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,gIAAgI;AAChI,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,+HAA+H;AAC/H,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAClD,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,qHAAqH;AACrH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAOvE;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG7E;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAOtG;AAED,2HAA2H;AAC3H,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG;IAAE,SAAS,EAAE,gBAAgB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAKnH;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAyB,GAAG,MAAM,CAI9E","sourcesContent":["// Mode and harness selection from the environment (abaigrammar section 4.4).\n// `ABAI_MODE` overrides the manifest's default mode; a value the manifest\n// does not declare falls back to the default and is counted. `ABAI_HARNESS`\n// is read only by check runs: unset means the real harness, `off` makes\n// every attach fail at once, `null` and `exercise` select the null harness\n// in its passive and active forms.\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Mode } from \"./manifest/manifest.ts\";\n\nexport const ENV_MODE = \"ABAI_MODE\";\nexport const ENV_HARNESS = \"ABAI_HARNESS\";\n/**\n * Set by a harness that launched this program (section 6.3): the socket its\n * endpoint must listen on, where the launcher is already waiting. Its\n * presence is also what makes the full lifecycle channel available (5.5).\n */\nexport const ENV_LAUNCH_SOCKET = \"ABAI_LAUNCH_SOCKET\";\n/** Where a sidecar endpoint puts its socket and descriptor; default `<ABAI_HOME or ~/.abai>/run`, the harness's own default. */\nexport const ENV_RUN_DIR = \"ABAI_RUN_DIR\";\n/** The harness binary the stub spawns at a touchpoint under sidecar; default: the program's `node_modules/.bin`, else PATH. */\nexport const ENV_HARNESS_BIN = \"ABAI_HARNESS_BIN\";\n/** How long a sidecar attach waits for the spawned harness to connect, in milliseconds. */\nexport const ENV_ATTACH_WAIT_MS = \"ABAI_ATTACH_WAIT_MS\";\nexport const DEFAULT_ATTACH_WAIT_MS = 30_000;\n\n/** The run directory for this environment. With no home at all, a private directory under the machine's temp dir. */\nexport function runDirFrom(env: NodeJS.ProcessEnv = process.env): string {\n\tconst explicit = env[ENV_RUN_DIR]?.trim();\n\tif (explicit) return explicit;\n\tconst home = env.ABAI_HOME?.trim();\n\tif (home) return join(home, \"run\");\n\tconst user = env.HOME?.trim();\n\treturn user ? join(user, \".abai\", \"run\") : join(tmpdir(), \"abai-run\");\n}\n\n/** The attach wait for this environment; an unusable value means the default. */\nexport function attachWaitMsFrom(env: NodeJS.ProcessEnv = process.env): number {\n\tconst value = Number(env[ENV_ATTACH_WAIT_MS]);\n\treturn Number.isInteger(value) && value > 0 ? value : DEFAULT_ATTACH_WAIT_MS;\n}\n\nexport type HarnessSelection = \"real\" | \"off\" | \"null\" | \"exercise\";\n\nexport interface ModeSelection {\n\tmode: Mode;\n\t/** The requested mode was not declared; the default applies and is counted. */\n\tfallback: boolean;\n\t/** What `ABAI_MODE` asked for, when set. */\n\trequested?: string;\n}\n\n/** The mode for this run: the first declared, unless `ABAI_MODE` names a declared one. */\nexport function selectMode(modes: readonly Mode[], env: NodeJS.ProcessEnv = process.env): ModeSelection {\n\tconst requested = env[ENV_MODE]?.trim();\n\tconst first = modes[0];\n\tif (first === undefined) throw new Error(\"the manifest declares no modes\");\n\tif (requested === undefined || requested === \"\") return { mode: first, fallback: false };\n\tif ((modes as readonly string[]).includes(requested)) return { mode: requested as Mode, fallback: false, requested };\n\treturn { mode: first, fallback: true, requested };\n}\n\n/** The harness for this run. An unknown value selects the real harness and is reported, never thrown: the program runs. */\nexport function selectHarness(env: NodeJS.ProcessEnv = process.env): { selection: HarnessSelection; error?: string } {\n\tconst value = env[ENV_HARNESS]?.trim();\n\tif (value === undefined || value === \"\") return { selection: \"real\" };\n\tif (value === \"off\" || value === \"null\" || value === \"exercise\") return { selection: value };\n\treturn { selection: \"real\", error: `${ENV_HARNESS} must be unset, off, null or exercise (got ${value})` };\n}\n\n/** `~` at the start of a path means the home directory. */\nexport function expandHome(path: string, home = process.env.HOME ?? \"\"): string {\n\tif (path === \"~\") return home;\n\tif (path.startsWith(\"~/\")) return `${home}${path.slice(1)}`;\n\treturn path;\n}\n"]}

package/dist/env.js

@@ -0,0 +1,69 @@
+// Mode and harness selection from the environment (abaigrammar section 4.4).
+// `ABAI_MODE` overrides the manifest's default mode; a value the manifest
+// does not declare falls back to the default and is counted. `ABAI_HARNESS`
+// is read only by check runs: unset means the real harness, `off` makes
+// every attach fail at once, `null` and `exercise` select the null harness
+// in its passive and active forms.
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+export const ENV_MODE = "ABAI_MODE";
+export const ENV_HARNESS = "ABAI_HARNESS";
+/**
+ * Set by a harness that launched this program (section 6.3): the socket its
+ * endpoint must listen on, where the launcher is already waiting. Its
+ * presence is also what makes the full lifecycle channel available (5.5).
+ */
+export const ENV_LAUNCH_SOCKET = "ABAI_LAUNCH_SOCKET";
+/** Where a sidecar endpoint puts its socket and descriptor; default `<ABAI_HOME or ~/.abai>/run`, the harness's own default. */
+export const ENV_RUN_DIR = "ABAI_RUN_DIR";
+/** The harness binary the stub spawns at a touchpoint under sidecar; default: the program's `node_modules/.bin`, else PATH. */
+export const ENV_HARNESS_BIN = "ABAI_HARNESS_BIN";
+/** How long a sidecar attach waits for the spawned harness to connect, in milliseconds. */
+export const ENV_ATTACH_WAIT_MS = "ABAI_ATTACH_WAIT_MS";
+export const DEFAULT_ATTACH_WAIT_MS = 30_000;
+/** The run directory for this environment. With no home at all, a private directory under the machine's temp dir. */
+export function runDirFrom(env = process.env) {
+    const explicit = env[ENV_RUN_DIR]?.trim();
+    if (explicit)
+        return explicit;
+    const home = env.ABAI_HOME?.trim();
+    if (home)
+        return join(home, "run");
+    const user = env.HOME?.trim();
+    return user ? join(user, ".abai", "run") : join(tmpdir(), "abai-run");
+}
+/** The attach wait for this environment; an unusable value means the default. */
+export function attachWaitMsFrom(env = process.env) {
+    const value = Number(env[ENV_ATTACH_WAIT_MS]);
+    return Number.isInteger(value) && value > 0 ? value : DEFAULT_ATTACH_WAIT_MS;
+}
+/** The mode for this run: the first declared, unless `ABAI_MODE` names a declared one. */
+export function selectMode(modes, env = process.env) {
+    const requested = env[ENV_MODE]?.trim();
+    const first = modes[0];
+    if (first === undefined)
+        throw new Error("the manifest declares no modes");
+    if (requested === undefined || requested === "")
+        return { mode: first, fallback: false };
+    if (modes.includes(requested))
+        return { mode: requested, fallback: false, requested };
+    return { mode: first, fallback: true, requested };
+}
+/** The harness for this run. An unknown value selects the real harness and is reported, never thrown: the program runs. */
+export function selectHarness(env = process.env) {
+    const value = env[ENV_HARNESS]?.trim();
+    if (value === undefined || value === "")
+        return { selection: "real" };
+    if (value === "off" || value === "null" || value === "exercise")
+        return { selection: value };
+    return { selection: "real", error: `${ENV_HARNESS} must be unset, off, null or exercise (got ${value})` };
+}
+/** `~` at the start of a path means the home directory. */
+export function expandHome(path, home = process.env.HOME ?? "") {
+    if (path === "~")
+        return home;
+    if (path.startsWith("~/"))
+        return `${home}${path.slice(1)}`;
+    return path;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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","sourcesContent":["// Mode and harness selection from the environment (abaigrammar section 4.4).\n// `ABAI_MODE` overrides the manifest's default mode; a value the manifest\n// does not declare falls back to the default and is counted. `ABAI_HARNESS`\n// is read only by check runs: unset means the real harness, `off` makes\n// every attach fail at once, `null` and `exercise` select the null harness\n// in its passive and active forms.\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Mode } from \"./manifest/manifest.ts\";\n\nexport const ENV_MODE = \"ABAI_MODE\";\nexport const ENV_HARNESS = \"ABAI_HARNESS\";\n/**\n * Set by a harness that launched this program (section 6.3): the socket its\n * endpoint must listen on, where the launcher is already waiting. Its\n * presence is also what makes the full lifecycle channel available (5.5).\n */\nexport const ENV_LAUNCH_SOCKET = \"ABAI_LAUNCH_SOCKET\";\n/** Where a sidecar endpoint puts its socket and descriptor; default `<ABAI_HOME or ~/.abai>/run`, the harness's own default. */\nexport const ENV_RUN_DIR = \"ABAI_RUN_DIR\";\n/** The harness binary the stub spawns at a touchpoint under sidecar; default: the program's `node_modules/.bin`, else PATH. */\nexport const ENV_HARNESS_BIN = \"ABAI_HARNESS_BIN\";\n/** How long a sidecar attach waits for the spawned harness to connect, in milliseconds. */\nexport const ENV_ATTACH_WAIT_MS = \"ABAI_ATTACH_WAIT_MS\";\nexport const DEFAULT_ATTACH_WAIT_MS = 30_000;\n\n/** The run directory for this environment. With no home at all, a private directory under the machine's temp dir. */\nexport function runDirFrom(env: NodeJS.ProcessEnv = process.env): string {\n\tconst explicit = env[ENV_RUN_DIR]?.trim();\n\tif (explicit) return explicit;\n\tconst home = env.ABAI_HOME?.trim();\n\tif (home) return join(home, \"run\");\n\tconst user = env.HOME?.trim();\n\treturn user ? join(user, \".abai\", \"run\") : join(tmpdir(), \"abai-run\");\n}\n\n/** The attach wait for this environment; an unusable value means the default. */\nexport function attachWaitMsFrom(env: NodeJS.ProcessEnv = process.env): number {\n\tconst value = Number(env[ENV_ATTACH_WAIT_MS]);\n\treturn Number.isInteger(value) && value > 0 ? value : DEFAULT_ATTACH_WAIT_MS;\n}\n\nexport type HarnessSelection = \"real\" | \"off\" | \"null\" | \"exercise\";\n\nexport interface ModeSelection {\n\tmode: Mode;\n\t/** The requested mode was not declared; the default applies and is counted. */\n\tfallback: boolean;\n\t/** What `ABAI_MODE` asked for, when set. */\n\trequested?: string;\n}\n\n/** The mode for this run: the first declared, unless `ABAI_MODE` names a declared one. */\nexport function selectMode(modes: readonly Mode[], env: NodeJS.ProcessEnv = process.env): ModeSelection {\n\tconst requested = env[ENV_MODE]?.trim();\n\tconst first = modes[0];\n\tif (first === undefined) throw new Error(\"the manifest declares no modes\");\n\tif (requested === undefined || requested === \"\") return { mode: first, fallback: false };\n\tif ((modes as readonly string[]).includes(requested)) return { mode: requested as Mode, fallback: false, requested };\n\treturn { mode: first, fallback: true, requested };\n}\n\n/** The harness for this run. An unknown value selects the real harness and is reported, never thrown: the program runs. */\nexport function selectHarness(env: NodeJS.ProcessEnv = process.env): { selection: HarnessSelection; error?: string } {\n\tconst value = env[ENV_HARNESS]?.trim();\n\tif (value === undefined || value === \"\") return { selection: \"real\" };\n\tif (value === \"off\" || value === \"null\" || value === \"exercise\") return { selection: value };\n\treturn { selection: \"real\", error: `${ENV_HARNESS} must be unset, off, null or exercise (got ${value})` };\n}\n\n/** `~` at the start of a path means the home directory. */\nexport function expandHome(path: string, home = process.env.HOME ?? \"\"): string {\n\tif (path === \"~\") return home;\n\tif (path.startsWith(\"~/\")) return `${home}${path.slice(1)}`;\n\treturn path;\n}\n"]}