@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/runtime/buffered-process.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBufferedProcess = runBufferedProcess;
+const node_child_process_1 = require("node:child_process");
+const DEFAULT_MAX_BUFFER_BYTES = 64 * 1024 * 1024;
+function runBufferedProcess(options) {
+    return new Promise((resolve) => {
+        const stdout = [];
+        const stderr = [];
+        const maxBufferBytes = options.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;
+        let stdoutBytes = 0;
+        let stderrBytes = 0;
+        let settled = false;
+        let processError = null;
+        let overflowError = null;
+        let terminating = null;
+        const child = (0, node_child_process_1.spawn)(options.command, [...options.args], {
+            cwd: options.cwd,
+            env: options.env,
+            shell: options.shell === true,
+            windowsHide: true,
+            detached: process.platform !== "win32",
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        const terminate = () => {
+            terminating ??= terminateProcessTree(child);
+            return terminating;
+        };
+        const append = (target, stream, chunk) => {
+            const value = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            if (stream === "stdout")
+                stdoutBytes += value.byteLength;
+            else
+                stderrBytes += value.byteLength;
+            if ((stdoutBytes > maxBufferBytes || stderrBytes > maxBufferBytes) && !overflowError) {
+                overflowError = Object.assign(new Error(`${stream} exceeded maxBuffer length of ${maxBufferBytes} bytes`), {
+                    code: "ENOBUFS"
+                });
+                void terminate();
+                return;
+            }
+            if (!overflowError)
+                target.push(value);
+        };
+        child.stdout?.on("data", (chunk) => append(stdout, "stdout", chunk));
+        child.stderr?.on("data", (chunk) => append(stderr, "stderr", chunk));
+        child.stdin?.on("error", () => undefined);
+        child.once("error", (error) => {
+            processError = error;
+        });
+        child.once("close", (status, signal) => {
+            if (settled)
+                return;
+            settled = true;
+            options.signal?.removeEventListener("abort", onAbort);
+            resolve({
+                status,
+                signal,
+                stdout: Buffer.concat(stdout).toString("utf8"),
+                stderr: Buffer.concat(stderr).toString("utf8"),
+                error: overflowError ?? processError
+            });
+        });
+        const onAbort = () => {
+            void terminate();
+        };
+        if (options.signal?.aborted)
+            onAbort();
+        else
+            options.signal?.addEventListener("abort", onAbort, { once: true });
+        if (options.input !== undefined)
+            child.stdin?.end(options.input);
+        else
+            child.stdin?.end();
+    });
+}
+async function terminateProcessTree(child) {
+    const pid = child.pid;
+    if (!pid || child.exitCode !== null || child.signalCode !== null)
+        return;
+    if (process.platform === "win32") {
+        const killer = (0, node_child_process_1.spawn)("taskkill.exe", ["/pid", String(pid), "/t", "/f"], {
+            windowsHide: true,
+            stdio: "ignore"
+        });
+        await Promise.race([new Promise((resolve) => {
+                killer.once("error", () => resolve());
+                killer.once("close", () => resolve());
+            }), delay(1_000)]);
+        if (killer.exitCode === null && killer.signalCode === null)
+            killer.kill();
+        if (child.exitCode === null && child.signalCode === null)
+            child.kill();
+        return;
+    }
+    try {
+        process.kill(-pid, "SIGTERM");
+    }
+    catch {
+        child.kill("SIGTERM");
+    }
+    await delay(250);
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    try {
+        process.kill(-pid, "SIGKILL");
+    }
+    catch {
+        child.kill("SIGKILL");
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/runtime/bundled-node.js

@@ -1 +1,97 @@
-"use strict";var f=exports&&exports.__createBinding||(Object.create?(function(r,e,n,t){t===void 0&&(t=n);var i=Object.getOwnPropertyDescriptor(e,n);(!i||("get"in i?!e.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return e[n]}}),Object.defineProperty(r,t,i)}):(function(r,e,n,t){t===void 0&&(t=n),r[t]=e[n]})),l=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:!0,value:e})}):function(r,e){r.default=e}),a=exports&&exports.__importStar||(function(){var r=function(e){return r=Object.getOwnPropertyNames||function(n){var t=[];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(t[t.length]=i);return t},r(e)};return function(e){if(e&&e.__esModule)return e;var n={};if(e!=null)for(var t=r(e),i=0;i<t.length;i++)t[i]!=="default"&&f(n,e,t[i]);return l(n,e),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.defaultPackageRoot=c,exports.resolveNodeRuntime=p,exports.findPackagedNodeRuntime=s;const o=a(require("node:fs")),u=a(require("node:path")),d=require("../config/env-vars");function c(){return u.resolve(__dirname,"..","..")}function p(r=c()){const e=process.env[d.CLI_ENV.nodePath]?.trim();if(e&&o.existsSync(e)){const t=u.resolve(e);return{command:t,source:"env",path:t}}const n=s(r);return n?{command:n,source:"packaged",path:n}:{command:process.execPath,source:"process",path:process.execPath}}function s(r){const e=m();if(!e)return null;const n=process.platform==="win32"?u.join(r,"runtimes","node",e,"node.exe"):u.join(r,"runtimes","node",e,"bin","node");return o.existsSync(n)?n:null}function m(){const r=process.arch;return process.platform==="win32"&&r==="x64"?"win-x64":process.platform==="linux"&&r==="x64"?"linux-x64":process.platform==="linux"&&r==="arm64"?"linux-arm64":process.platform==="darwin"&&r==="x64"?"darwin-x64":process.platform==="darwin"&&r==="arm64"?"darwin-arm64":null}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultPackageRoot = defaultPackageRoot;
+exports.resolveNodeRuntime = resolveNodeRuntime;
+exports.findPackagedNodeRuntime = findPackagedNodeRuntime;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const env_vars_1 = require("../config/env-vars");
+function defaultPackageRoot() {
+    return path.resolve(__dirname, "..", "..");
+}
+function resolveNodeRuntime(packageRoot = defaultPackageRoot()) {
+    const explicitNodePath = process.env[env_vars_1.CLI_ENV.nodePath]?.trim();
+    if (explicitNodePath && fs.existsSync(explicitNodePath)) {
+        const resolved = path.resolve(explicitNodePath);
+        return {
+            command: resolved,
+            source: "env",
+            path: resolved
+        };
+    }
+    const packaged = findPackagedNodeRuntime(packageRoot);
+    if (packaged) {
+        return {
+            command: packaged,
+            source: "packaged",
+            path: packaged
+        };
+    }
+    return {
+        command: process.execPath,
+        source: "process",
+        path: process.execPath
+    };
+}
+function findPackagedNodeRuntime(packageRoot) {
+    const platformDir = nodeRuntimePlatformDir();
+    if (!platformDir) {
+        return null;
+    }
+    const candidate = process.platform === "win32"
+        ? path.join(packageRoot, "runtimes", "node", platformDir, "node.exe")
+        : path.join(packageRoot, "runtimes", "node", platformDir, "bin", "node");
+    return fs.existsSync(candidate) ? candidate : null;
+}
+function nodeRuntimePlatformDir() {
+    const arch = process.arch;
+    if (process.platform === "win32" && arch === "x64") {
+        return "win-x64";
+    }
+    if (process.platform === "linux" && arch === "x64") {
+        return "linux-x64";
+    }
+    if (process.platform === "linux" && arch === "arm64") {
+        return "linux-arm64";
+    }
+    if (process.platform === "darwin" && arch === "x64") {
+        return "darwin-x64";
+    }
+    if (process.platform === "darwin" && arch === "arm64") {
+        return "darwin-arm64";
+    }
+    return null;
+}

package/dist/runtime/command-lifecycle.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/input-source.js

@@ -1 +1,238 @@
-"use strict";var h=exports&&exports.__createBinding||(Object.create?(function(e,o,t,n){n===void 0&&(n=t);var i=Object.getOwnPropertyDescriptor(o,t);(!i||("get"in i?!o.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return o[t]}}),Object.defineProperty(e,n,i)}):(function(e,o,t,n){n===void 0&&(n=t),e[n]=o[t]})),P=exports&&exports.__setModuleDefault||(Object.create?(function(e,o){Object.defineProperty(e,"default",{enumerable:!0,value:o})}):function(e,o){e.default=o}),m=exports&&exports.__importStar||(function(){var e=function(o){return e=Object.getOwnPropertyNames||function(t){var n=[];for(var i in t)Object.prototype.hasOwnProperty.call(t,i)&&(n[n.length]=i);return n},e(o)};return function(o){if(o&&o.__esModule)return o;var t={};if(o!=null)for(var n=e(o),i=0;i<n.length;i++)n[i]!=="default"&&h(t,o,n[i]);return P(t,o),t}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.COMMAND_INPUT_CAPABILITIES=void 0,exports.resolveCommandInputSource=D,exports.getCommandInputCapability=O,exports.commandRequiresPayload=v;const E=m(require("node:fs")),y=m(require("node:path")),C=require("../commands/json-file-input"),M=require("../commands/session-workspace"),L=require("../payloads/read-stdin-json"),u=require("../shared/errors"),S={stdin:!1,fromJson:!1,fromJsonMode:"central",requiredPayload:!1};exports.COMMAND_INPUT_CAPABILITIES={inspect:{stdin:!0,fromJson:!0,fromJsonMode:"command",requiredPayload:!1},move:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!0,allowNoPayload:e=>e[0]==="help"||e[0]==="--help"||e[1]==="help"||e[1]==="--help"||e[0]==="toFile"&&e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--"),invalidJsonCode:"INVALID_MOVE_TO_FILE_JSON_FILE"},rename:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!0,allowNoPayload:e=>e.includes("--help")||e[0]==="help"||e.includes("--preview")||e.includes("--preview-id")||e[0]==="preview"&&typeof e[1]=="string"&&typeof e[2]=="string"&&typeof e[3]=="string"||e[0]==="validate"&&typeof e[1]=="string"&&typeof e[2]=="string"&&typeof e[3]=="string"||e[0]==="apply"&&typeof e[1]=="string"&&!e[1].startsWith("--"),invalidJsonCode:"INVALID_RENAME_ENTITIES_JSON_FILE"},refactor:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!0,allowNoPayload:e=>e[0]==="help"||e[0]==="--help"||e[1]==="help"||e[1]==="--help"||e[0]==="batch"&&e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--"),invalidJsonCode:"INVALID_REFACTOR_BATCH_JSON_FILE"},modulePlan:{stdin:!0,fromJson:!0,fromJsonMode:"command",requiredPayload:!1},file:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!0,allowNoPayload:e=>e[0]==="help"||e[0]==="--help"||e[1]==="help"||e[1]==="--help"||e[2]==="help"||e[2]==="--help"||e[0]==="move"&&e[1]==="toDir"&&e[2]==="apply"&&typeof e[3]=="string"&&!e[3].startsWith("--")||e[0]==="rename"&&e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--")||e[0]==="refactor"&&e[1]==="batch"&&e[2]==="apply"&&typeof e[3]=="string"&&!e[3].startsWith("--"),invalidJsonCode:"INVALID_FILE_MOVE_TO_DIR_JSON_FILE"},declaration:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!0,allowNoPayload:e=>e[0]==="help"||e[0]==="--help"||e[1]==="help"||e[1]==="--help"||e[1]==="apply"&&typeof e[2]=="string"&&!e[2].startsWith("--"),invalidJsonCode:"INVALID_DECLARATION_JSON_FILE"},imports:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!1,invalidJsonCode:"INVALID_NORMALIZE_IMPORTS_JSON_FILE"},moveToFile:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!1,invalidJsonCode:"INVALID_MOVE_TO_FILE_JSON_FILE"},renameEntities:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!1,invalidJsonCode:"INVALID_RENAME_ENTITIES_JSON_FILE"},refactorBatch:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!1,invalidJsonCode:"INVALID_REFACTOR_BATCH_JSON_FILE"},session:{stdin:!0,fromJson:!1,fromJsonMode:"central",requiredPayload:!1},view:{stdin:!0,fromJson:!0,fromJsonMode:"central",requiredPayload:!1,invalidJsonCode:"INVALID_VIEW_INPUT_FILE"}};async function D(e){const{command:o,cwd:t,restArgs:n,preResolvedPayload:i,preResolvedSource:r,readStdinJson:s,readStdinInput:I}=e,a=O(o),p=n.includes("--stdin"),d=_(n,"--from-json"),f=_(n,"--from-dsl"),c=_(n,"--from");if(Number(p)+ +(d!==null)+ +(f!==null)+ +(c!==null)>1)throw new u.CliError("INPUT_SOURCE_CONFLICT",`Use only one input source for ${o}: --stdin, --from, --from-json, or --from-dsl.`);if(p&&!a.stdin)throw new u.CliError("INPUT_STDIN_UNSUPPORTED",`${o} does not support --stdin input.`);if((d!==null||f!==null||c!==null)&&!a.fromJson)throw new u.CliError("INPUT_FROM_UNSUPPORTED",`${o} does not support file input.`);if(i!==void 0)return{kind:c!==null?"from":f!==null?"from-dsl":d!==null?"from-json":"stdin",payload:T(i,o),...r!==void 0?{source:r}:{},capability:a};if(p){if(I){const l=await I();return{kind:"stdin",payload:l.payload,source:l.source,capability:a}}if(!s)throw new u.CliError("STDIN_REQUIRED",`${o} expects JSON on stdin and the --stdin flag.`);return{kind:"stdin",payload:await s(),capability:a}}if(d!==null)return a.fromJsonMode==="command"?{kind:"delegated-from-json",capability:a}:{kind:"from-json",payload:(0,C.readJsonObjectFile)(t,d,a.invalidJsonCode??"INVALID_COMMAND_JSON_FILE"),source:{format:"json",text:J(t,d,a.invalidJsonCode??"INVALID_COMMAND_JSON_FILE")},capability:a};if(f!==null){const l=N(t,f,o,n,"dsl",a.invalidJsonCode??"INVALID_COMMAND_DSL_FILE");return{kind:"from-dsl",payload:l.payload,source:l.source,capability:a}}if(c!==null){const l=N(t,c,o,n,"auto",a.invalidJsonCode??"INVALID_COMMAND_INPUT_FILE");return{kind:"from",payload:l.payload,source:l.source,capability:a}}return{kind:"none",capability:a}}function N(e,o,t,n,i,r){const s=J(e,o,r);return(0,L.parseInputPayloadWithSource)(s,{command:t,restArgs:n,...i==="dsl"?{format:"dsl"}:{}})}function J(e,o,t){const n=(0,M.resolveSessionFileArgument)(e,o),i=y.isAbsolute(n)?n:y.resolve(e,n);try{return E.readFileSync(i,"utf8")}catch(r){throw new u.CliError(t,`Failed to read input file: ${o}`,{file:o,error:r instanceof Error?r.message:String(r)})}}function O(e){return exports.COMMAND_INPUT_CAPABILITIES[e]??S}function v(e,o,t){return t.capability.requiredPayload===!0&&t.payload===void 0&&t.kind!=="delegated-from-json"&&t.capability.allowNoPayload?.(o)!==!0}function T(e,o){if(e&&typeof e=="object"&&!Array.isArray(e))return e;throw new u.CliError("INVALID_COMMAND_JSON_PAYLOAD",`${o} expects a JSON object payload.`)}function _(e,o){const t=e.indexOf(o);if(t<0)return null;const n=e[t+1];return n&&!n.startsWith("--")?n:null}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMAND_INPUT_CAPABILITIES = void 0;
+exports.resolveCommandInputSource = resolveCommandInputSource;
+exports.getCommandInputCapability = getCommandInputCapability;
+exports.commandRequiresPayload = commandRequiresPayload;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const json_file_input_1 = require("../commands/json-file-input");
+const session_workspace_1 = require("../commands/session-workspace");
+const read_stdin_json_1 = require("../payloads/read-stdin-json");
+const errors_1 = require("../shared/errors");
+const NO_INPUT = {
+    stdin: false,
+    fromJson: false,
+    fromJsonMode: "central",
+    requiredPayload: false
+};
+exports.COMMAND_INPUT_CAPABILITIES = {
+    inspect: {
+        stdin: true,
+        fromJson: true,
+        fromJsonMode: "command",
+        requiredPayload: false
+    },
+    mutate: {
+        stdin: true,
+        fromJson: true,
+        fromJsonMode: "central",
+        requiredPayload: true,
+        allowNoPayload: (restArgs) => restArgs[0] === "help" ||
+            restArgs[0] === "--help" ||
+            (restArgs[0] === "apply" && typeof restArgs[1] === "string" && !restArgs[1].startsWith("--")),
+        invalidJsonCode: "INVALID_MUTATE_JSON_FILE"
+    },
+    declaration: {
+        stdin: true,
+        fromJson: true,
+        fromJsonMode: "central",
+        requiredPayload: true,
+        allowNoPayload: (restArgs) => restArgs[0] === "help" ||
+            restArgs[0] === "--help" ||
+            restArgs[1] === "help" ||
+            restArgs[1] === "--help" ||
+            (restArgs[1] === "apply" && typeof restArgs[2] === "string" && !restArgs[2].startsWith("--")),
+        invalidJsonCode: "INVALID_DECLARATION_JSON_FILE"
+    },
+    imports: {
+        stdin: true,
+        fromJson: true,
+        fromJsonMode: "central",
+        requiredPayload: false,
+        invalidJsonCode: "INVALID_NORMALIZE_IMPORTS_JSON_FILE"
+    },
+    internal: {
+        stdin: true,
+        fromJson: true,
+        fromJsonMode: "central",
+        requiredPayload: true,
+        allowNoPayload: (restArgs) => restArgs[0] === "help" ||
+            restArgs[0] === "--help",
+        invalidJsonCode: "INVALID_INTERNAL_JSON_FILE"
+    },
+    session: {
+        stdin: true,
+        fromJson: false,
+        fromJsonMode: "central",
+        requiredPayload: false
+    },
+    view: {
+        stdin: true,
+        fromJson: true,
+        fromJsonMode: "central",
+        requiredPayload: false,
+        invalidJsonCode: "INVALID_VIEW_INPUT_FILE"
+    }
+};
+async function resolveCommandInputSource(options) {
+    const { command, cwd, restArgs, preResolvedPayload, preResolvedSource, readStdinJson, readStdinInput } = options;
+    const capability = getCommandInputCapability(command);
+    const hasStdin = restArgs.includes("--stdin");
+    const fromJson = readFlagValue(restArgs, "--from-json");
+    const fromDsl = readFlagValue(restArgs, "--from-dsl");
+    const from = readFlagValue(restArgs, "--from");
+    const inputSourceCount = Number(hasStdin) + Number(fromJson !== null) + Number(fromDsl !== null) + Number(from !== null);
+    if (inputSourceCount > 1) {
+        throw new errors_1.CliError("INPUT_SOURCE_CONFLICT", `Use only one input source for ${command}: --stdin, --from, --from-json, or --from-dsl.`);
+    }
+    if (hasStdin && !capability.stdin) {
+        throw new errors_1.CliError("INPUT_STDIN_UNSUPPORTED", `${command} does not support --stdin input.`);
+    }
+    if ((fromJson !== null || fromDsl !== null || from !== null) && !capability.fromJson) {
+        throw new errors_1.CliError("INPUT_FROM_UNSUPPORTED", `${command} does not support file input.`);
+    }
+    if (preResolvedPayload !== undefined) {
+        return {
+            kind: from !== null ? "from" : fromDsl !== null ? "from-dsl" : fromJson !== null ? "from-json" : "stdin",
+            payload: assertJsonObject(preResolvedPayload, command),
+            ...(preResolvedSource !== undefined ? { source: preResolvedSource } : {}),
+            capability
+        };
+    }
+    if (hasStdin) {
+        if (readStdinInput) {
+            const input = await readStdinInput();
+            return {
+                kind: "stdin",
+                payload: input.payload,
+                source: input.source,
+                capability
+            };
+        }
+        if (!readStdinJson) {
+            throw new errors_1.CliError("STDIN_REQUIRED", `${command} expects JSON on stdin and the --stdin flag.`);
+        }
+        return {
+            kind: "stdin",
+            payload: await readStdinJson(),
+            capability
+        };
+    }
+    if (fromJson !== null) {
+        if (capability.fromJsonMode === "command") {
+            return {
+                kind: "delegated-from-json",
+                capability
+            };
+        }
+        return {
+            kind: "from-json",
+            payload: (0, json_file_input_1.readJsonObjectFile)(cwd, fromJson, capability.invalidJsonCode ?? "INVALID_COMMAND_JSON_FILE"),
+            source: {
+                format: "json",
+                text: readInputFileText(cwd, fromJson, capability.invalidJsonCode ?? "INVALID_COMMAND_JSON_FILE")
+            },
+            capability
+        };
+    }
+    if (fromDsl !== null) {
+        const input = readInputFilePayload(cwd, fromDsl, command, restArgs, "dsl", capability.invalidJsonCode ?? "INVALID_COMMAND_DSL_FILE");
+        return {
+            kind: "from-dsl",
+            payload: input.payload,
+            source: input.source,
+            capability
+        };
+    }
+    if (from !== null) {
+        const input = readInputFilePayload(cwd, from, command, restArgs, "auto", capability.invalidJsonCode ?? "INVALID_COMMAND_INPUT_FILE");
+        return {
+            kind: "from",
+            payload: input.payload,
+            source: input.source,
+            capability
+        };
+    }
+    return {
+        kind: "none",
+        capability
+    };
+}
+function readInputFilePayload(cwd, filePath, command, restArgs, format, errorCode) {
+    const text = readInputFileText(cwd, filePath, errorCode);
+    return (0, read_stdin_json_1.parseInputPayloadWithSource)(text, {
+        command,
+        restArgs,
+        ...(format === "dsl" ? { format: "dsl" } : {})
+    });
+}
+function readInputFileText(cwd, filePath, errorCode) {
+    const resolvedFilePath = (0, session_workspace_1.resolveSessionFileArgument)(cwd, filePath);
+    const absolutePath = path.isAbsolute(resolvedFilePath) ? resolvedFilePath : path.resolve(cwd, resolvedFilePath);
+    try {
+        return fs.readFileSync(absolutePath, "utf8");
+    }
+    catch (error) {
+        throw new errors_1.CliError(errorCode, `Failed to read input file: ${filePath}`, {
+            file: filePath,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+function getCommandInputCapability(command) {
+    return exports.COMMAND_INPUT_CAPABILITIES[command] ?? NO_INPUT;
+}
+function commandRequiresPayload(command, restArgs, resolved) {
+    return resolved.capability.requiredPayload === true &&
+        resolved.payload === undefined &&
+        resolved.kind !== "delegated-from-json" &&
+        resolved.capability.allowNoPayload?.(restArgs) !== true;
+}
+function assertJsonObject(value, command) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        return value;
+    }
+    throw new errors_1.CliError("INVALID_COMMAND_JSON_PAYLOAD", `${command} expects a JSON object payload.`);
+}
+function readFlagValue(args, flag) {
+    const index = args.indexOf(flag);
+    if (index < 0) {
+        return null;
+    }
+    const value = args[index + 1];
+    return value && !value.startsWith("--") ? value : null;
+}

package/dist/runtime/node-cli-identity.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.establishNodeCliIdentity = establishNodeCliIdentity;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const NODE_CLI_ENV = "AIB_NODE_CLI";
+function establishNodeCliIdentity(executingEntrypoint, env = process.env) {
+    const executingPath = canonicalFilePath(executingEntrypoint);
+    if (node_path_1.default.basename(executingPath).toLowerCase() !== "aib.js" ||
+        node_path_1.default.basename(node_path_1.default.dirname(executingPath)).toLowerCase() !== "bin") {
+        throw new Error(`AIB Node CLI entrypoint is not dist/bin/aib.js: ${executingPath}`);
+    }
+    const explicit = env[NODE_CLI_ENV];
+    if (explicit) {
+        try {
+            const explicitPath = canonicalFilePath(explicit);
+            if (fileKey(explicitPath) === fileKey(executingPath)) {
+                env[NODE_CLI_ENV] = explicitPath;
+                return explicitPath;
+            }
+        }
+        catch {
+            // A stale launcher value is replaced by the artifact that is actually executing.
+        }
+    }
+    env[NODE_CLI_ENV] = executingPath;
+    return executingPath;
+}
+function canonicalFilePath(filePath) {
+    return node_fs_1.default.realpathSync.native(node_path_1.default.resolve(filePath));
+}
+function fileKey(filePath) {
+    return process.platform === "win32" ? filePath.toLowerCase() : filePath;
+}