agent-army 0.1.0

package/dist/lib/constants.js

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * Constants, preset definitions, aliases, and defaults
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEY_INSTRUCTIONS = exports.MODEL_PROVIDERS = exports.CONFIG_DIR = exports.MANIFEST_FILE = exports.HETZNER_COST_ESTIMATES = exports.COST_ESTIMATES = exports.SSH_USER = exports.HETZNER_US_LOCATIONS = exports.HETZNER_SERVER_TYPES_US = exports.HETZNER_SERVER_TYPES_EU = exports.INSTANCE_TYPES = exports.HETZNER_LOCATIONS = exports.AWS_REGIONS = exports.PROVIDERS = exports.AGENT_ALIASES = exports.PRESETS = void 0;
+exports.hetznerServerTypes = hetznerServerTypes;
+exports.tailscaleHostname = tailscaleHostname;
+exports.slackAppManifest = slackAppManifest;
+/** Available preset agents */
+exports.PRESETS = {
+    pm: {
+        name: "agent-pm",
+        displayName: "Juno",
+        role: "pm",
+        preset: "pm",
+        volumeSize: 30,
+        description: "Break down tickets, research, plan and sequence work, track progress, unblock teams",
+    },
+    eng: {
+        name: "agent-eng",
+        displayName: "Titus",
+        role: "eng",
+        preset: "eng",
+        volumeSize: 50,
+        description: "Lead engineering, coding, shipping",
+    },
+    tester: {
+        name: "agent-tester",
+        displayName: "Scout",
+        role: "tester",
+        preset: "tester",
+        volumeSize: 30,
+        description: "Quality assurance, verification, bug hunting",
+    },
+};
+/** Map agent aliases to role keys */
+exports.AGENT_ALIASES = {
+    juno: "pm",
+    titus: "eng",
+    scout: "tester",
+};
+/** Available cloud providers */
+exports.PROVIDERS = [
+    { value: "aws", label: "AWS", hint: "Amazon Web Services EC2 instances" },
+    { value: "hetzner", label: "Hetzner", hint: "Hetzner Cloud servers (EU/US)" },
+];
+/** Common AWS regions for selection */
+exports.AWS_REGIONS = [
+    { value: "us-east-1", label: "US East (N. Virginia)" },
+    { value: "us-east-2", label: "US East (Ohio)" },
+    { value: "us-west-2", label: "US West (Oregon)" },
+    { value: "eu-west-1", label: "EU (Ireland)" },
+    { value: "eu-central-1", label: "EU (Frankfurt)" },
+    { value: "ap-southeast-1", label: "Asia Pacific (Singapore)" },
+    { value: "ap-northeast-1", label: "Asia Pacific (Tokyo)" },
+];
+/** Hetzner Cloud locations */
+exports.HETZNER_LOCATIONS = [
+    { value: "fsn1", label: "Falkenstein, DE (fsn1)" },
+    { value: "nbg1", label: "Nuremberg, DE (nbg1)" },
+    { value: "hel1", label: "Helsinki, FI (hel1)" },
+    { value: "ash", label: "Ashburn, US (ash)" },
+];
+/** Instance type options (AWS) */
+exports.INSTANCE_TYPES = [
+    { value: "t3.small", label: "t3.small — 2 vCPU, 2 GB (~$15/mo)" },
+    { value: "t3.medium", label: "t3.medium — 2 vCPU, 4 GB (~$30/mo)" },
+    { value: "t3.large", label: "t3.large — 2 vCPU, 8 GB (~$60/mo)" },
+];
+/** Hetzner server types — EU locations (cx shared vCPU) */
+exports.HETZNER_SERVER_TYPES_EU = [
+    { value: "cx22", label: "cx22 — 2 vCPU, 4 GB (~$4/mo)" },
+    { value: "cx32", label: "cx32 — 4 vCPU, 8 GB (~$7/mo)" },
+    { value: "cx42", label: "cx42 — 8 vCPU, 16 GB (~$14/mo)" },
+];
+/** Hetzner server types — US locations (cpx shared vCPU, cx not available) */
+exports.HETZNER_SERVER_TYPES_US = [
+    { value: "cpx21", label: "cpx21 — 3 vCPU, 4 GB (~$5/mo)" },
+    { value: "cpx31", label: "cpx31 — 4 vCPU, 8 GB (~$9/mo)" },
+    { value: "cpx41", label: "cpx41 — 8 vCPU, 16 GB (~$16/mo)" },
+];
+/** US Hetzner locations (cx types not available) */
+exports.HETZNER_US_LOCATIONS = ["ash", "hil"];
+/** Get server type options for a Hetzner location */
+function hetznerServerTypes(location) {
+    return exports.HETZNER_US_LOCATIONS.includes(location)
+        ? exports.HETZNER_SERVER_TYPES_US
+        : exports.HETZNER_SERVER_TYPES_EU;
+}
+/** Default SSH user for agent instances (Ubuntu 24.04 AMI default) */
+exports.SSH_USER = "ubuntu";
+/** Estimated monthly cost per instance type (AWS) */
+exports.COST_ESTIMATES = {
+    "t3.small": 15,
+    "t3.medium": 30,
+    "t3.large": 60,
+};
+/** Estimated monthly cost per server type (Hetzner) */
+exports.HETZNER_COST_ESTIMATES = {
+    cx22: 4,
+    cx32: 7,
+    cx42: 14,
+    cpx21: 5,
+    cpx31: 9,
+    cpx41: 16,
+};
+/** Manifest filename */
+exports.MANIFEST_FILE = "agent-army.json";
+/** Config directory under home (~/.agent-army/configs/) */
+exports.CONFIG_DIR = ".agent-army/configs";
+/**
+ * Supported model providers with their API key prefixes and available models
+ */
+exports.MODEL_PROVIDERS = {
+    anthropic: {
+        name: "Anthropic",
+        envVar: "ANTHROPIC_API_KEY",
+        keyPrefix: "sk-ant-",
+        models: [
+            { value: "anthropic/claude-opus-4-6", label: "Claude Opus 4.6 (Recommended)" },
+            { value: "anthropic/claude-sonnet-4-5", label: "Claude Sonnet 4.5" },
+            { value: "anthropic/claude-haiku-4-5", label: "Claude Haiku 4.5" },
+        ],
+    },
+};
+/**
+ * Build the Tailscale hostname for an agent.
+ * Includes the stack name to avoid conflicts across deployments.
+ * Example: "dev-agent-pm", "prod-agent-eng"
+ */
+function tailscaleHostname(stackName, agentName) {
+    return `${stackName}-${agentName}`;
+}
+/** Key instructions for onboarding prompts */
+exports.KEY_INSTRUCTIONS = {
+    anthropicApiKey: {
+        title: "Anthropic API Key",
+        steps: [
+            "To get your Anthropic API key:",
+            "1. Go to https://console.anthropic.com/account/keys",
+            "2. Click \"Create Key\"",
+            "3. Copy the key (starts with sk-ant-)",
+        ],
+    },
+    tailscaleAuthKey: {
+        title: "Tailscale Auth Key",
+        steps: [
+            "To get your Tailscale auth key:",
+            "1. Go to https://login.tailscale.com/admin/settings/keys",
+            "2. Click \"Generate auth key\"",
+            "3. Enable \"Reusable\" AND \"Ephemeral\" — ephemeral nodes auto-remove when offline",
+            "4. Copy the key (starts with tskey-auth-)",
+        ],
+    },
+    tailscaleApiKey: {
+        title: "Tailscale API Key (optional)",
+        steps: [
+            "For reliable cleanup of Tailscale devices during destroy:",
+            "1. Go to https://login.tailscale.com/admin/settings/keys",
+            "2. Under \"API access tokens\", click \"Generate access token\"",
+            "3. Copy the key (starts with tskey-api-)",
+            "4. This is optional but recommended for clean teardowns",
+        ],
+    },
+    tailnetDnsName: {
+        title: "Tailnet DNS Name",
+        steps: [
+            "To find your Tailnet DNS name:",
+            "1. Go to https://login.tailscale.com/admin/dns",
+            "2. Look for your tailnet name at the top",
+            "3. It looks like \"tailXXXXX.ts.net\" or a custom domain",
+        ],
+    },
+    slackCredentials: {
+        title: "Slack App Setup",
+        steps: [
+            "Create a Slack app for each agent using the manifest shown below:",
+            "1. Go to https://api.slack.com/apps → \"Create New App\" → \"From a manifest\"",
+            "2. Select your workspace, paste the JSON manifest, and create the app",
+            "3. Go to \"OAuth & Permissions\" — copy the Bot Token (xoxb-...)",
+            "4. Under \"Basic Information\" → \"App-Level Tokens\", generate a token",
+            "   with the connections:write scope — copy it (xapp-...)",
+        ],
+    },
+    linearApiKey: {
+        title: "Linear API Key",
+        steps: [
+            "Create a separate Linear account for each agent:",
+            "1. Invite you+agentname@domain.com to your Linear workspace",
+            "   (plus-addressing forwards to your inbox — no new email needed)",
+            "   Follow the link in the invite email to create the account and join the org",
+            "2. Go to Settings → Security & Access → Personal API keys → \"New API key\"",
+            "3. Copy the key (starts with lin_api_)",
+        ],
+    },
+    githubToken: {
+        title: "GitHub Token",
+        steps: [
+            "To get a GitHub personal access token for gh CLI:",
+            "1. Go to https://github.com/settings/tokens?type=beta",
+            "2. Click \"Generate new token\" → Fine-grained token",
+            "3. Select repositories, set expiration, and permissions (e.g., repo, read:org)",
+            "4. Copy the token (starts with github_pat_ or ghp_)",
+        ],
+    },
+    hcloudToken: {
+        title: "Hetzner Cloud API Token",
+        steps: [
+            "To get your Hetzner Cloud API token:",
+            "1. Go to https://console.hetzner.cloud/",
+            "2. Select your project (or create one)",
+            "3. Go to Security → API Tokens",
+            "4. Click \"Generate API Token\" with Read & Write permissions",
+            "5. Copy the token",
+        ],
+    },
+};
+/** Generate a Slack app manifest JSON for a given agent */
+function slackAppManifest(agentName) {
+    return JSON.stringify({
+        display_information: {
+            name: agentName,
+            description: "Slack connector for OpenClaw",
+        },
+        features: {
+            bot_user: {
+                display_name: agentName,
+                always_online: false,
+            },
+            app_home: {
+                messages_tab_enabled: true,
+                messages_tab_read_only_enabled: false,
+            },
+            slash_commands: [
+                {
+                    command: "/openclaw",
+                    description: "Send a message to OpenClaw",
+                    should_escape: false,
+                },
+            ],
+        },
+        oauth_config: {
+            scopes: {
+                bot: [
+                    "chat:write",
+                    "channels:history",
+                    "channels:read",
+                    "groups:history",
+                    "groups:read",
+                    "groups:write",
+                    "im:history",
+                    "im:read",
+                    "im:write",
+                    "mpim:history",
+                    "mpim:read",
+                    "mpim:write",
+                    "users:read",
+                    "app_mentions:read",
+                    "reactions:read",
+                    "reactions:write",
+                    "pins:read",
+                    "pins:write",
+                    "emoji:read",
+                    "commands",
+                    "files:read",
+                    "files:write",
+                ],
+                user: [
+                    "channels:history",
+                    "channels:read",
+                    "groups:history",
+                    "groups:read",
+                    "im:history",
+                    "im:read",
+                    "mpim:history",
+                    "mpim:read",
+                    "users:read",
+                    "reactions:read",
+                    "pins:read",
+                    "emoji:read",
+                    "search:read",
+                ],
+            },
+        },
+        settings: {
+            socket_mode_enabled: true,
+            event_subscriptions: {
+                bot_events: [
+                    "app_mention",
+                    "message.channels",
+                    "message.groups",
+                    "message.im",
+                    "message.mpim",
+                    "reaction_added",
+                    "reaction_removed",
+                    "member_joined_channel",
+                    "member_left_channel",
+                    "channel_rename",
+                    "pin_added",
+                    "pin_removed",
+                ],
+            },
+        },
+    }, null, 2);
+}
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

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

package/dist/lib/exec.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Child process helpers for CLI commands
+ */
+/** Result of a captured command execution */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Execute a command and capture output
+ */
+export declare function capture(command: string, args?: string[], cwd?: string): ExecResult;
+/**
+ * Execute a command with streaming output (stdout/stderr pass-through)
+ * Returns the exit code.
+ */
+export declare function stream(command: string, args?: string[], cwd?: string): Promise<number>;
+/**
+ * Check if a command exists on the system
+ */
+export declare function commandExists(command: string): boolean;

package/dist/lib/exec.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Child process helpers for CLI commands
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capture = capture;
+exports.stream = stream;
+exports.commandExists = commandExists;
+const child_process_1 = require("child_process");
+const process_1 = require("./process");
+/**
+ * Execute a command and capture output
+ */
+function capture(command, args = [], cwd) {
+    try {
+        const result = (0, child_process_1.execSync)([command, ...args].join(" "), {
+            cwd,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return { stdout: result.trim(), stderr: "", exitCode: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            stdout: (e.stdout ?? "").toString().trim(),
+            stderr: (e.stderr ?? "").toString().trim(),
+            exitCode: e.status ?? 1,
+        };
+    }
+}
+/**
+ * Execute a command with streaming output (stdout/stderr pass-through)
+ * Returns the exit code.
+ */
+function stream(command, args = [], cwd) {
+    return new Promise((resolve) => {
+        const opts = {
+            cwd,
+            stdio: "inherit",
+            shell: true,
+        };
+        const child = (0, child_process_1.spawn)(command, args, opts);
+        (0, process_1.trackChild)(child);
+        child.on("close", (code) => resolve(code ?? 1));
+        child.on("error", (err) => {
+            console.warn(`[exec] Child process error: ${err.message}`);
+            resolve(1);
+        });
+    });
+}
+/**
+ * Check if a command exists on the system
+ */
+function commandExists(command) {
+    const bin = process.platform === "win32" ? "where" : "which";
+    const result = (0, child_process_1.spawnSync)(bin, [command], { shell: false, stdio: "ignore" });
+    return result.status === 0;
+}
+//# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../lib/exec.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAeH,0BAgBC;AAMD,wBAeC;AAKD,sCAIC;AA3DD,iDAA8E;AAC9E,uCAAuC;AASvC;;GAEG;AACH,SAAgB,OAAO,CAAC,OAAe,EAAE,OAAiB,EAAE,EAAE,GAAY;IACxE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACpD,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAA4D,CAAC;QACvE,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;YAC1C,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;YAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC;SACxB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,MAAM,CAAC,OAAe,EAAE,OAAiB,EAAE,EAAE,GAAY;IACvE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAiB;YACzB,GAAG;YACH,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,IAAI;SACZ,CAAC;QACF,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,IAAA,oBAAU,EAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,IAAI,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5E,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/lib/prerequisites.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Prerequisite checking for CLI
+ */
+/**
+ * Run all prerequisite checks and display results.
+ * Returns true if all pass, false otherwise.
+ */
+export declare function checkPrerequisites(): Promise<boolean>;

package/dist/lib/prerequisites.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Prerequisite checking for CLI
+ */
+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.checkPrerequisites = checkPrerequisites;
+const p = __importStar(require("@clack/prompts"));
+const exec_1 = require("./exec");
+/**
+ * Run all prerequisite checks and display results.
+ * Returns true if all pass, false otherwise.
+ */
+async function checkPrerequisites() {
+    const results = [];
+    // Pulumi CLI
+    if ((0, exec_1.commandExists)("pulumi")) {
+        const ver = (0, exec_1.capture)("pulumi", ["version"]);
+        results.push({ name: "Pulumi", ok: true, message: `found (${ver.stdout})` });
+    }
+    else {
+        results.push({
+            name: "Pulumi",
+            ok: false,
+            message: "not found",
+            hint: "Install from https://www.pulumi.com/docs/iac/download-install/",
+        });
+    }
+    // Node.js 18+
+    if ((0, exec_1.commandExists)("node")) {
+        const ver = (0, exec_1.capture)("node", ["-v"]);
+        const major = parseInt(ver.stdout.replace("v", "").split(".")[0], 10);
+        if (major >= 18) {
+            results.push({ name: "Node.js", ok: true, message: `${ver.stdout} (>= 18 required)` });
+        }
+        else {
+            results.push({
+                name: "Node.js",
+                ok: false,
+                message: `${ver.stdout} is too old`,
+                hint: "Requires Node.js 18+. Install from https://nodejs.org/",
+            });
+        }
+    }
+    else {
+        results.push({
+            name: "Node.js",
+            ok: false,
+            message: "not found",
+            hint: "Install from https://nodejs.org/",
+        });
+    }
+    // AWS CLI
+    if ((0, exec_1.commandExists)("aws")) {
+        results.push({ name: "AWS CLI", ok: true, message: "found" });
+    }
+    else {
+        results.push({
+            name: "AWS CLI",
+            ok: false,
+            message: "not found",
+            hint: "Install from https://aws.amazon.com/cli/",
+        });
+    }
+    // pnpm
+    if ((0, exec_1.commandExists)("pnpm")) {
+        results.push({ name: "pnpm", ok: true, message: "found" });
+    }
+    else {
+        results.push({
+            name: "pnpm",
+            ok: false,
+            message: "not found",
+            hint: "Install with: npm install -g pnpm",
+        });
+    }
+    // Display results
+    const allOk = results.every((r) => r.ok);
+    for (const r of results) {
+        if (r.ok) {
+            p.log.success(`${r.name}: ${r.message}`);
+        }
+        else {
+            p.log.error(`${r.name}: ${r.message}`);
+            if (r.hint) {
+                p.log.message(`  ${r.hint}`);
+            }
+        }
+    }
+    return allOk;
+}
+//# sourceMappingURL=prerequisites.js.map

package/dist/lib/prerequisites.js.map

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

package/dist/lib/process.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Graceful shutdown and child process tracking.
+ *
+ * Spawn helpers in exec.ts and cli-adapter.ts register child processes here.
+ * bin.ts calls setupGracefulShutdown() at startup so that SIGINT / SIGTERM
+ * are forwarded to any running children before the CLI exits.
+ */
+import type { ChildProcess } from "child_process";
+/**
+ * Register a child process for cleanup on exit.
+ * Automatically unregisters when the child closes or errors.
+ */
+export declare function trackChild(child: ChildProcess): void;
+/**
+ * Install SIGINT and SIGTERM handlers that forward the signal
+ * to tracked child processes before exiting.
+ */
+export declare function setupGracefulShutdown(): void;

package/dist/lib/process.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Graceful shutdown and child process tracking.
+ *
+ * Spawn helpers in exec.ts and cli-adapter.ts register child processes here.
+ * bin.ts calls setupGracefulShutdown() at startup so that SIGINT / SIGTERM
+ * are forwarded to any running children before the CLI exits.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackChild = trackChild;
+exports.setupGracefulShutdown = setupGracefulShutdown;
+const activeChildren = new Set();
+/**
+ * Register a child process for cleanup on exit.
+ * Automatically unregisters when the child closes or errors.
+ */
+function trackChild(child) {
+    activeChildren.add(child);
+    const remove = () => activeChildren.delete(child);
+    child.on("close", remove);
+    child.on("error", remove);
+}
+/**
+ * Install SIGINT and SIGTERM handlers that forward the signal
+ * to tracked child processes before exiting.
+ */
+function setupGracefulShutdown() {
+    const cleanup = (signal, exitCode) => {
+        for (const child of activeChildren) {
+            child.kill(signal);
+        }
+        process.exit(exitCode);
+    };
+    process.on("SIGINT", () => cleanup("SIGINT", 130));
+    process.on("SIGTERM", () => cleanup("SIGTERM", 143));
+}
+//# sourceMappingURL=process.js.map

package/dist/lib/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../lib/process.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAUH,gCAKC;AAMD,sDAUC;AA3BD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAgB,CAAC;AAE/C;;;GAGG;AACH,SAAgB,UAAU,CAAC,KAAmB;IAC5C,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB;IACnC,MAAM,OAAO,GAAG,CAAC,MAAsB,EAAE,QAAgB,EAAE,EAAE;QAC3D,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/lib/pulumi.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pulumi CLI wrappers
+ */
+/**
+ * Get the current Pulumi stack name
+ */
+export declare function currentStack(): string | null;
+/**
+ * Select a Pulumi stack (create if it doesn't exist).
+ * Returns { ok, error } so callers can display the error message.
+ */
+export declare function selectOrCreateStack(stackName: string): {
+    ok: boolean;
+    error?: string;
+};
+/**
+ * Set a Pulumi config value
+ */
+export declare function setConfig(key: string, value: string, secret?: boolean): boolean;
+/**
+ * Get a Pulumi config value
+ */
+export declare function getConfig(key: string): string | null;
+/**
+ * Get stack outputs as JSON
+ */
+export declare function getStackOutputs(showSecrets?: boolean): Record<string, unknown> | null;
+/**
+ * Run pulumi up with streaming output
+ */
+export declare function pulumiUp(): Promise<number>;
+/**
+ * Run pulumi destroy with streaming output
+ */
+export declare function pulumiDestroy(): Promise<number>;
+/**
+ * Run pulumi preview with streaming output
+ */
+export declare function pulumiPreview(): Promise<number>;