@action-llama/action-llama 0.13.7 → 0.14.1

package/README.md

@@ -1,192 +0,0 @@
-# Action Llama
-
-[![CI](https://github.com/Action-Llama/action-llama/actions/workflows/ci.yml/badge.svg)](https://github.com/Action-Llama/action-llama/actions/workflows/ci.yml)
-[![npm](https://img.shields.io/npm/v/@action-llama/action-llama)](https://www.npmjs.com/package/@action-llama/action-llama)
-
-Deploy agent workflows to the cloud.
-
-- [**Documentation**](https://docs.actionllama.org)
-- [**actionllama.org**](https://actionllama.org)
-
-Built on [pi.dev](https://github.com/badlogic/pi-mono) as the agent harness.
-
-## How to get started
-
-### 1. Create a project
-
-```bash
-npx @action-llama/action-llama@next new my-project
-cd my-project
-```
-
-This scaffolds the project and sets up your model credentials and defaults.
-
-### 2. Create and manage agents
-
-```bash
-npx al chat
-```
-
-The chat console helps you create and manage agents. If no agents exist yet, it will offer to create one for you.
-
-You can also create agents manually — see the [creating agents guide](docs/creating-agents.md).
-
-Or, if you're using your own coding agent just make sure it reads the AGENTS.md in your project root.
-
-### 3. Run
-
-Once your agents are ready, start the scheduler!
-
-```bash
-npx al start
-```
-
-If any credentials are missing, it will prompt you for them. Credentials are stored in `~/.action-llama/credentials/` (shared across projects, not committed to git). See [credentials docs](docs/credentials.md) for details.
-
-### Project structure
-
-```
-my-project/
-  package.json              # Includes @action-llama/action-llama as a dependency
-  Dockerfile                # Project base image. Generated. Shared customizations for all agents
-  AGENTS.md                 # Project overview, Generated. Credential/webhook reference, example agent
-  config.toml               # Global config: [local], [model], gateway, webhooks (no secrets)
-```
-
-Each agent subdirectory:
-
-```
-  dev/                      # Agent name
-    agent-config.toml       # Agent config: credentials, model, schedule, webhooks, params
-    ACTIONS.md             # Agent instructions (system prompt) — edit to customize behavior
-    Dockerfile              # (optional) Custom Docker image for this agent
-```
-
-## Deployment
-
-For production, deploy agents to a VPS for cost-effective remote hosting.
-
-Action Llama supports:
-
-- **VPS** (Vultr, DigitalOcean, Hetzner, etc.) — SSH + Docker, no registry needed
-
-See the [VPS deployment docs](docs/vps-deployment.md) for setup details.
-
-## CLI commands
-
-If you installed globally (`npm install -g @action-llama/action-llama`), you can use `al` directly. Otherwise, prefix commands with `npx` (e.g., `npx al start`).
-
-| Command | Description |
-|---------|-------------|
-| `al new <name>` | Interactive setup — creates project directory and credentials |
-| `al chat [agent]` | Interactive console — or agent-scoped session with credentials loaded |
-| `al doctor` | Check agents, credentials, webhooks, and config — prompt to fix |
-| `al creds ls` | List stored credentials (names only, no secrets) |
-| `al run <agent>` | Manually run a single agent |
-| `al start` | Start the scheduler |
-| `al stat` | Show agent status |
-| `al logs <agent>` | View agent log files |
-| `al pause [name]` | Pause the scheduler, or a single agent by name |
-| `al resume [name]` | Resume the scheduler, or a single agent by name |
-| `al kill <target>` | Kill an agent (all instances) or a single instance by ID |
-
-Most commands accept `-p <dir>` to set the project directory. See the [CLI command reference](docs/commands.md) for all options and flags.
-
-## Configuration
-
-Configuration lives in two places:
-
-- [**`config.toml`**](docs/config-reference.md) (project root) — global settings: default model (`[model]`), local Docker options (`[local]`), gateway, webhooks, and scheduler options like `maxReruns`.
-- [**`agent-config.toml`**](docs/agent-config-reference.md) (per agent) — model, credentials, schedule, webhooks, and parameters. Each agent can use a different model or provider (e.g., Claude Opus for dev, GPT-4o for review, Gemini for devops).
-
-Credentials are stored outside the project in `~/.action-llama/credentials/` and referenced by name in agent configs. Run `al doctor` to configure them interactively.
-
-Agents run in isolated Docker containers for security and consistency.
-
-See also the [credentials](docs/credentials.md), [webhooks](docs/webhooks.md), and [Docker](docs/docker.md) docs for details.
-
-## Documentation
-
-| Doc | Description |
-|-----|-------------|
-| [Agents](docs/agents.md) | What an agent is: config, ACTIONS.md, Dockerfile, runtime prompt |
-| [CLI Commands](docs/commands.md) | All CLI commands with options and flags |
-| [Creating Agents](docs/creating-agents.md) | Step-by-step guide to creating a new agent |
-| [config.toml Reference](docs/config-reference.md) | Project-level config: model, Docker, gateway, webhooks |
-| [agent-config.toml Reference](docs/agent-config-reference.md) | Per-agent config fields with examples |
-| [Models](docs/models.md) | Supported LLM providers, model IDs, auth types, thinking levels |
-| [Credentials](docs/credentials.md) | Credential types, storage layout, named instances |
-| [Webhooks](docs/webhooks.md) | Webhook setup, filter fields, Sentry integration |
-| [Docker](docs/docker.md) | Container isolation, custom Dockerfiles, filesystem layout |
-| [Deployment](docs/deployment.md) | Deployment overview, VPS deployment guide |
-| [VPS Deployment](docs/vps-deployment.md) | Running agents on any VPS via SSH + Docker |
-| [Example Agents](docs/examples/index.md) | Dev, reviewer, and devops agent templates |
-
-## Developing
-
-### Prerequisites
-
-- Node.js >= 20, Git, Docker
-- GitHub PAT with `repo` + `workflow` scopes
-- Anthropic auth (pi auth, API key, or OAuth token)
-
-### Setup
-
-```bash
-git clone <repo>
-cd action-llama
-npm install
-npm run build
-npm test
-```
-
-### How it works
-
-`al start` runs a single Node.js process (the **scheduler**) that:
-
-1. Discovers agents in the project directory (each subdirectory with an `agent-config.toml`)
-2. Starts a **gateway** HTTP server if webhooks or Docker mode are enabled (health check, webhook receiver, shutdown kill switch)
-3. Creates a **runner** per agent — either `AgentRunner` (host mode) or `ContainerAgentRunner` (Docker mode)
-4. Wires up **cron jobs** and/or **webhook bindings** to trigger each runner
-5. On trigger, the runner builds a prompt (injecting `<agent-config>` and optionally `<webhook-trigger>` blocks), starts a [pi-coding-agent](https://github.com/badlogic/pi-mono) session, and streams output to the logger
-
-### Source layout
-
-```
-src/
-  cli/              # Command definitions (new, doctor, start, status, logs, push, env)
-  setup/            # Project scaffolding
-  scheduler/        # Scheduler: discovers agents, starts gateway, wires cron + webhooks
-  agents/           # Agent runners (host + Docker), prompt builder
-  gateway/          # HTTP server: router, health, shutdown, webhook routes
-  docker/           # Container lifecycle (launch, wait, logs, remove), image + network
-  webhooks/         # Webhook registry, provider interface, GitHub provider
-  tui/              # Ink-based terminal UI (App.tsx, status tracker)
-  shared/           # Config loader, credentials, logger, paths, git helpers
-```
-
-### Tests
-
-```bash
-npm run test:unit     # unit tests only (fast, run during development)
-npm test              # all tests including integration (run before committing)
-npm run test:integration  # integration tests only (Docker-based, slow)
-npm run test:watch    # watch mode (unit tests only)
-npm run test:coverage # V8 coverage report
-```
-
-Tests live in `test/` mirroring `src/`. Integration tests are in `test/integration/` and require Docker. Coverage excludes entry points (`cli/main.ts`), interactive prompts (`setup/prompts.ts`), and type-only files.
-
-### Publishing
-
-```bash
-npm login                            # need @action-llama org access
-npm version patch                    # or minor / major — bumps, tags, pushes
-npm publish --access public          # build + tests run automatically via prepublishOnly
-```
-
-Published tarball includes `dist/`, `docker/`, `README.md`, `LICENSE`, and `package.json`.
-
-## License
-
-MIT

package/dist/gateway/views/logs-page.d.ts

@@ -1,2 +0,0 @@
-export declare function renderLogsPage(agentName: string): string;
-//# sourceMappingURL=logs-page.d.ts.map

package/dist/gateway/views/logs-page.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logs-page.d.ts","sourceRoot":"","sources":["../../../src/gateway/views/logs-page.ts"],"names":[],"mappings":"AAQA,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA+QxD"}

package/dist/gateway/views/logs-page.js

@@ -1,280 +0,0 @@
-function escapeHtml(str) {
-    return str
-        .replace(/&/g, "&")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;")
-        .replace(/"/g, "&quot;");
-}
-export function renderLogsPage(agentName) {
-    return `<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>${escapeHtml(agentName)} — Logs — Action Llama</title>
-<style>
-  * { margin: 0; padding: 0; box-sizing: border-box; }
-  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif; background: #0f172a; color: #e2e8f0; padding: 16px; display: flex; flex-direction: column; height: 100vh; height: 100dvh; }
-  .top-bar { display: flex; align-items: center; gap: 12px; margin-bottom: 12px; flex-shrink: 0; flex-wrap: wrap; }
-  .top-bar a { color: #60a5fa; text-decoration: none; font-size: 0.9rem; }
-  .top-bar a:hover { text-decoration: underline; }
-  h1 { font-size: 1.2rem; color: #f8fafc; }
-  .agent-state { font-size: 0.85rem; color: #94a3b8; }
-  .state-dot { display: inline-block; width: 8px; height: 8px; border-radius: 50%; margin-right: 4px; vertical-align: middle; }
-  .controls { display: flex; gap: 8px; align-items: center; margin-bottom: 10px; flex-shrink: 0; flex-wrap: wrap; }
-  .controls button { background: #334155; color: #e2e8f0; border: 1px solid #475569; border-radius: 4px; padding: 6px 14px; cursor: pointer; font-size: 0.8rem; -webkit-tap-highlight-color: transparent; touch-action: manipulation; }
-  .controls button:hover { background: #475569; }
-  .controls button.active { background: #3b82f6; border-color: #3b82f6; }
-  .controls .status { font-size: 0.8rem; color: #64748b; }
-  .log-container { flex: 1; background: #1e293b; border-radius: 8px; padding: 12px; font-family: 'SF Mono', 'Fira Code', monospace; font-size: 0.75rem; line-height: 1.5; overflow-y: auto; min-height: 0; -webkit-overflow-scrolling: touch; }
-  .log-line { white-space: pre-wrap; word-break: break-all; padding: 1px 0; }
-  .log-time { color: #64748b; }
-  .log-msg { color: #cbd5e1; }
-  .log-assistant { color: #f8fafc; font-weight: 500; }
-  .log-assistant-cont { color: #f8fafc; padding-left: 7.5em; display: block; }
-  .log-bash { color: #22d3ee; }
-  .log-tool { color: #60a5fa; }
-  .log-tool-error { color: #ef4444; }
-  .log-lifecycle { color: #c084fc; font-weight: 600; }
-  .log-completed { color: #22c55e; font-weight: 600; }
-  .log-dim { color: #64748b; }
-  .log-warn { color: #eab308; }
-  .log-error { color: #ef4444; font-weight: 600; }
-  .log-detail { color: #64748b; padding-left: 7.5em; display: block; font-size: 0.9em; }
-  .run-header { border-top: 1px solid #334155; margin-top: 8px; padding-top: 6px; color: #c084fc; font-weight: 600; }
-  .empty { color: #475569; font-style: italic; }
-  .connection-status { font-size: 0.75rem; padding: 2px 8px; border-radius: 3px; }
-  .connection-status.connected { color: #22c55e; }
-  .connection-status.disconnected { color: #ef4444; }
-
-  @media (max-width: 640px) {
-    body { padding: 10px; }
-    h1 { font-size: 1.05rem; }
-    .top-bar { gap: 8px; margin-bottom: 8px; }
-    .top-bar a { font-size: 0.8rem; }
-    .controls button { padding: 8px 14px; font-size: 0.8rem; }
-    .log-container { padding: 10px; font-size: 0.65rem; line-height: 1.45; border-radius: 6px; }
-    .agent-state { font-size: 0.75rem; }
-  }
-
-  @media (min-width: 641px) {
-    body { padding: 24px; }
-    .log-container { padding: 16px; font-size: 0.8rem; line-height: 1.6; }
-  }
-</style>
-</head>
-<body>
-  <div class="top-bar">
-    <a href="/dashboard">&larr; Dashboard</a>
-    <h1>${escapeHtml(agentName)}</h1>
-    <span class="agent-state" id="agent-state"></span>
-  </div>
-
-  <div class="controls">
-    <button id="follow-btn" class="active" onclick="toggleFollow()">Follow</button>
-    <button onclick="clearLogs()">Clear</button>
-    <span class="status" id="line-count">0 lines</span>
-    <span class="connection-status connected" id="conn-status">connected</span>
-  </div>
-
-  <div class="log-container" id="log-container">
-    <div class="empty" id="empty-msg">Waiting for logs...</div>
-  </div>
-
-  <script>
-    const agentName = ${JSON.stringify(agentName)};
-    const container = document.getElementById("log-container");
-    const emptyMsg = document.getElementById("empty-msg");
-    const followBtn = document.getElementById("follow-btn");
-    const lineCountEl = document.getElementById("line-count");
-    const connStatus = document.getElementById("conn-status");
-    const agentStateEl = document.getElementById("agent-state");
-
-    const stateColors = { running: "#22c55e", building: "#eab308", error: "#ef4444", idle: "#6b7280" };
-    let follow = true;
-    let lineCount = 0;
-
-    function esc(s) { const d = document.createElement("div"); d.textContent = s; return d.innerHTML; }
-
-    function toggleFollow() {
-      follow = !follow;
-      followBtn.classList.toggle("active", follow);
-      if (follow) container.scrollTop = container.scrollHeight;
-    }
-
-    function clearLogs() {
-      container.innerHTML = "";
-      lineCount = 0;
-      lineCountEl.textContent = "0 lines";
-    }
-
-    const SKIP_MSGS = new Set(["event", "tool done"]);
-
-    function fmtTime(ts) {
-      return new Date(ts).toLocaleTimeString("en-US", { hour12: false });
-    }
-
-    function formatEntry(p) {
-      var time = '<span class="log-time">' + esc(fmtTime(p.time)) + '</span>  ';
-      var msg = p.msg || "";
-      var lvl = p.level || 30;
-
-      // Skip noise
-      if (SKIP_MSGS.has(msg)) return null;
-      if (lvl <= 20 && msg !== "tool start") return null;
-
-      // Assistant text
-      if (msg === "assistant") {
-        var text = p.text || "";
-        if (!text) return null;
-        var lines = text.split("\\n");
-        var out = time + '<span class="log-assistant">' + esc(lines[0]) + '</span>';
-        for (var i = 1; i < lines.length; i++) {
-          out += '<span class="log-assistant-cont">' + esc(lines[i]) + '</span>';
-        }
-        return out;
-      }
-
-      // Bash command
-      if (msg === "bash") {
-        return time + '<span class="log-bash">$ ' + esc(p.cmd || "") + '</span>';
-      }
-
-      // Tool start
-      if (msg === "tool start") {
-        return time + '<span class="log-tool">\\u25b8 ' + esc(p.tool || "unknown") + '</span>';
-      }
-
-      // Tool error
-      if (msg === "tool error") {
-        var out = time + '<span class="log-tool-error">\\u2717 ' + esc(p.tool || "unknown") + ' failed</span>';
-        if (p.cmd) out += '<span class="log-detail">$ ' + esc(String(p.cmd)) + '</span>';
-        if (p.result) out += '<span class="log-detail">' + esc(String(p.result).slice(0, 300)) + '</span>';
-        return out;
-      }
-
-      // Run start
-      if (msg.startsWith && msg.startsWith("Starting ")) {
-        var ctr = p.container ? ' <span class="log-dim">(' + esc(p.container) + ')</span>' : "";
-        return time + '<span class="log-lifecycle">' + esc(msg) + '</span>' + ctr;
-      }
-
-      // Run completed
-      if (msg === "run completed" || msg === "run completed, rerun requested") {
-        var suffix = msg.includes("rerun") ? ' <span class="log-warn">(rerun requested)</span>' : "";
-        return time + '<span class="log-completed">Run completed</span>' + suffix;
-      }
-
-      // Container lifecycle
-      if (msg === "container launched") {
-        var ctr = p.container ? ' ' + esc(p.container) : "";
-        return time + '<span class="log-dim">Container launched' + ctr + '</span>';
-      }
-      if (msg === "container finished" || msg === "container finished (rerun requested)") {
-        var el = p.elapsed ? ' (' + esc(p.elapsed) + ')' : "";
-        return time + '<span class="log-dim">Container finished' + el + '</span>';
-      }
-      if (msg === "container starting") {
-        var model = p.modelId ? ' <span class="log-dim">model=' + esc(p.modelId) + '</span>' : "";
-        return time + '<span class="log-lifecycle">Container starting: ' + esc(p.agentName || "") + '</span>' + model;
-      }
-      if (msg === "creating agent session" || msg === "session created, sending prompt") {
-        return time + '<span class="log-dim">' + esc(msg) + '</span>';
-      }
-
-      // Errors
-      if (lvl >= 50) {
-        var detail = p.err ? '<span class="log-detail">' + esc(JSON.stringify(p.err).slice(0, 300)) + '</span>' : "";
-        return time + '<span class="log-error">ERROR: ' + esc(msg) + '</span>' + detail;
-      }
-
-      // Warnings
-      if (lvl >= 40) {
-        return time + '<span class="log-warn">WARN: ' + esc(msg) + '</span>';
-      }
-
-      // Catch-all
-      return time + '<span class="log-dim">' + esc(msg) + '</span>';
-    }
-
-    function maybeRunHeader(p) {
-      var msg = p.msg || "";
-      if (msg.startsWith && msg.startsWith("Starting ") && (msg.includes(" run") || msg.includes(" container run"))) {
-        var name = p.name || "agent";
-        var ctr = p.container ? "  " + p.container : "";
-        return '<div class="log-line run-header">\\u2500\\u2500 ' + esc(name + ctr) + ' ' + "\\u2500".repeat(50) + '</div>';
-      }
-      return null;
-    }
-
-    function appendEntry(p) {
-      if (emptyMsg && emptyMsg.parentNode) emptyMsg.remove();
-      var header = maybeRunHeader(p);
-      if (header) {
-        var hdiv = document.createElement("div");
-        hdiv.innerHTML = header;
-        container.appendChild(hdiv.firstChild);
-      }
-      var html = formatEntry(p);
-      if (!html) return;
-      var div = document.createElement("div");
-      div.className = "log-line";
-      div.innerHTML = html;
-      container.appendChild(div);
-      lineCount++;
-      lineCountEl.textContent = lineCount + " line" + (lineCount !== 1 ? "s" : "");
-      if (follow) container.scrollTop = container.scrollHeight;
-    }
-
-    // Pause follow when user scrolls up
-    container.addEventListener("scroll", () => {
-      const atBottom = container.scrollHeight - container.scrollTop - container.clientHeight < 50;
-      if (!atBottom && follow) {
-        follow = false;
-        followBtn.classList.remove("active");
-      } else if (atBottom && !follow) {
-        follow = true;
-        followBtn.classList.add("active");
-      }
-    });
-
-    // Log polling via cursor-based API
-    let logCursor = null;
-    let pollTimer = null;
-    async function fetchLogs(initial) {
-      try {
-        const params = new URLSearchParams();
-        if (initial) params.set("lines", "100");
-        if (logCursor) params.set("cursor", logCursor);
-        const res = await fetch("/api/logs/agents/" + encodeURIComponent(agentName) + "?" + params, { credentials: "same-origin" });
-        if (!res.ok) throw new Error(res.status);
-        const data = await res.json();
-        for (const entry of data.entries) appendEntry(entry);
-        if (data.cursor) logCursor = data.cursor;
-        connStatus.textContent = "connected";
-        connStatus.className = "connection-status connected";
-      } catch {
-        connStatus.textContent = "disconnected";
-        connStatus.className = "connection-status disconnected";
-      }
-    }
-    fetchLogs(true);
-    pollTimer = setInterval(function() { fetchLogs(false); }, 1500);
-
-    // Status stream for agent state
-    const statusEs = new EventSource("/dashboard/api/status-stream");
-    statusEs.onmessage = function(e) {
-      const data = JSON.parse(e.data);
-      if (data.agents) {
-        const agent = data.agents.find(a => a.name === agentName);
-        if (agent) {
-          const color = stateColors[agent.state] || "#6b7280";
-          agentStateEl.innerHTML = '<span class="state-dot" style="background:' + color + '"></span> ' + esc(agent.state);
-        }
-      }
-    };
-  </script>
-</body>
-</html>`;
-}
-//# sourceMappingURL=logs-page.js.map

package/dist/gateway/views/logs-page.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logs-page.js","sourceRoot":"","sources":["../../../src/gateway/views/logs-page.ts"],"names":[],"mappings":"AAAA,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO;;;;;SAKA,UAAU,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAuDpB,UAAU,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;wBAgBP,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAiMzC,CAAC;AACT,CAAC"}

package/dist/preflight/interpolate.d.ts

@@ -1,10 +0,0 @@
-/**
- * Environment variable interpolation for preflight params.
- *
- * Replaces `${VAR_NAME}` tokens in string values with the corresponding
- * value from the provided env map. Nested objects and arrays are traversed
- * recursively; non-string leaves are returned as-is.
- */
-export declare function interpolateString(template: string, env: Record<string, string>): string;
-export declare function interpolateParams(params: Record<string, unknown>, env: Record<string, string>): Record<string, unknown>;
-//# sourceMappingURL=interpolate.d.ts.map

package/dist/preflight/interpolate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/preflight/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIvF;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/preflight/interpolate.js

@@ -1,33 +0,0 @@
-/**
- * Environment variable interpolation for preflight params.
- *
- * Replaces `${VAR_NAME}` tokens in string values with the corresponding
- * value from the provided env map. Nested objects and arrays are traversed
- * recursively; non-string leaves are returned as-is.
- */
-const ENV_VAR_RE = /\$\{([A-Za-z_][A-Za-z0-9_]*)}/g;
-export function interpolateString(template, env) {
-    return template.replace(ENV_VAR_RE, (_match, name) => {
-        return env[name] ?? "";
-    });
-}
-export function interpolateParams(params, env) {
-    const result = {};
-    for (const [key, value] of Object.entries(params)) {
-        result[key] = interpolateValue(value, env);
-    }
-    return result;
-}
-function interpolateValue(value, env) {
-    if (typeof value === "string") {
-        return interpolateString(value, env);
-    }
-    if (Array.isArray(value)) {
-        return value.map((v) => interpolateValue(v, env));
-    }
-    if (value !== null && typeof value === "object") {
-        return interpolateParams(value, env);
-    }
-    return value;
-}
-//# sourceMappingURL=interpolate.js.map

package/dist/preflight/interpolate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../src/preflight/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAEpD,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,GAA2B;IAC7E,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;QAC3D,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAA+B,EAC/B,GAA2B;IAE3B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,GAA2B;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,iBAAiB,CAAC,KAAgC,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/preflight/providers/git-clone.d.ts

@@ -1,3 +0,0 @@
-import type { PreflightProvider } from "../schema.js";
-export declare const gitCloneProvider: PreflightProvider;
-//# sourceMappingURL=git-clone.d.ts.map

package/dist/preflight/providers/git-clone.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-clone.d.ts","sourceRoot":"","sources":["../../../src/preflight/providers/git-clone.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AAGxE,eAAO,MAAM,gBAAgB,EAAE,iBAsC9B,CAAC"}

package/dist/preflight/providers/git-clone.js

@@ -1,36 +0,0 @@
-import { execSync } from "child_process";
-import { interpolateParams } from "../interpolate.js";
-export const gitCloneProvider = {
-    id: "git-clone",
-    async run(params, ctx) {
-        const resolved = interpolateParams(params, ctx.env);
-        const repo = resolved.repo;
-        if (typeof repo !== "string" || !repo) {
-            throw new Error("git-clone provider requires a 'repo' param");
-        }
-        const dest = resolved.dest;
-        if (typeof dest !== "string" || !dest) {
-            throw new Error("git-clone provider requires a 'dest' param");
-        }
-        // Expand short "owner/repo" to SSH URL; full URLs pass through
-        const repoUrl = repo.includes("://") || repo.startsWith("git@")
-            ? repo
-            : `git@github.com:${repo}.git`;
-        const args = ["git", "clone"];
-        if (typeof resolved.branch === "string" && resolved.branch) {
-            args.push("--branch", resolved.branch);
-        }
-        if (typeof resolved.depth === "number" && resolved.depth > 0) {
-            args.push("--depth", String(resolved.depth));
-        }
-        args.push(repoUrl, dest);
-        const cmd = args.join(" ");
-        ctx.logger("info", "preflight git-clone", { repo: repoUrl, dest });
-        execSync(cmd, {
-            env: ctx.env,
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-        ctx.logger("info", "preflight git-clone done", { dest });
-    },
-};
-//# sourceMappingURL=git-clone.js.map

package/dist/preflight/providers/git-clone.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-clone.js","sourceRoot":"","sources":["../../../src/preflight/providers/git-clone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,EAAE,EAAE,WAAW;IAEf,KAAK,CAAC,GAAG,CAAC,MAA+B,EAAE,GAAqB;QAC9D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,+DAA+D;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAC7D,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,kBAAkB,IAAI,MAAM,CAAC;QAEjC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,QAAQ,CAAC,GAAG,EAAE;YACZ,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF,CAAC"}

package/dist/preflight/providers/http.d.ts

@@ -1,3 +0,0 @@
-import type { PreflightProvider } from "../schema.js";
-export declare const httpProvider: PreflightProvider;
-//# sourceMappingURL=http.d.ts.map

package/dist/preflight/providers/http.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/preflight/providers/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AAGxE,eAAO,MAAM,YAAY,EAAE,iBAmC1B,CAAC"}

package/dist/preflight/providers/http.js

@@ -1,36 +0,0 @@
-import { writeFileSync, mkdirSync } from "fs";
-import { dirname } from "path";
-import { interpolateParams } from "../interpolate.js";
-export const httpProvider = {
-    id: "http",
-    async run(params, ctx) {
-        const resolved = interpolateParams(params, ctx.env);
-        const url = resolved.url;
-        if (typeof url !== "string" || !url) {
-            throw new Error("http provider requires a 'url' param");
-        }
-        const output = resolved.output;
-        if (typeof output !== "string" || !output) {
-            throw new Error("http provider requires an 'output' param");
-        }
-        const method = (typeof resolved.method === "string" ? resolved.method : "GET").toUpperCase();
-        const headers = {};
-        if (resolved.headers && typeof resolved.headers === "object" && !Array.isArray(resolved.headers)) {
-            for (const [k, v] of Object.entries(resolved.headers)) {
-                if (typeof v === "string")
-                    headers[k] = v;
-            }
-        }
-        const body = typeof resolved.body === "string" ? resolved.body : undefined;
-        ctx.logger("info", "preflight http", { method, url: url.slice(0, 200) });
-        const response = await fetch(url, { method, headers, body });
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status} ${response.statusText} from ${url}`);
-        }
-        const buffer = Buffer.from(await response.arrayBuffer());
-        mkdirSync(dirname(output), { recursive: true });
-        writeFileSync(output, buffer);
-        ctx.logger("info", "preflight http output written", { path: output, bytes: buffer.length });
-    },
-};
-//# sourceMappingURL=http.js.map

package/dist/preflight/providers/http.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/preflight/providers/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAqB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,EAAE,EAAE,MAAM;IAEV,KAAK,CAAC,GAAG,CAAC,MAA+B,EAAE,GAAqB;QAC9D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7F,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,QAAQ,CAAC,OAAO,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACjG,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAkC,CAAC,EAAE,CAAC;gBACjF,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3E,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,SAAS,GAAG,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,+BAA+B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9F,CAAC;CACF,CAAC"}

package/dist/preflight/providers/shell.d.ts

@@ -1,3 +0,0 @@
-import type { PreflightProvider } from "../schema.js";
-export declare const shellProvider: PreflightProvider;
-//# sourceMappingURL=shell.d.ts.map

package/dist/preflight/providers/shell.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/preflight/providers/shell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AAGxE,eAAO,MAAM,aAAa,EAAE,iBA0B3B,CAAC"}