@action-llama/action-llama 0.1.1

package/dist/agents/container-runner.js

@@ -0,0 +1,208 @@
+import { spawn } from "child_process";
+import { mkdtempSync, symlinkSync, rmSync } from "fs";
+import { join, resolve } from "path";
+import { tmpdir } from "os";
+import { randomUUID } from "crypto";
+import { readFileSync } from "fs";
+import { CREDENTIALS_DIR } from "../shared/paths.js";
+import { launchContainer, removeContainer, } from "../docker/container.js";
+export class ContainerAgentRunner {
+    _running = false;
+    globalConfig;
+    agentConfig;
+    logger;
+    registerContainer;
+    brokerUrl;
+    projectPath;
+    statusTracker;
+    constructor(globalConfig, agentConfig, logger, registerContainer, brokerUrl, projectPath, statusTracker) {
+        this.globalConfig = globalConfig;
+        this.agentConfig = agentConfig;
+        this.logger = logger;
+        this.registerContainer = registerContainer;
+        this.brokerUrl = brokerUrl;
+        this.projectPath = projectPath;
+        this.statusTracker = statusTracker;
+    }
+    get isRunning() {
+        return this._running;
+    }
+    forwardLogLine(line) {
+        if (!line.trim())
+            return;
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed._log) {
+                const { level, msg, _log, ts, ...data } = parsed;
+                const logFn = level === "error"
+                    ? this.logger.error.bind(this.logger)
+                    : level === "warn"
+                        ? this.logger.warn.bind(this.logger)
+                        : level === "debug"
+                            ? this.logger.debug.bind(this.logger)
+                            : this.logger.info.bind(this.logger);
+                if (Object.keys(data).length > 0) {
+                    logFn(data, msg);
+                }
+                else {
+                    logFn(msg);
+                }
+                // Forward info-level log events to status tracker
+                if (level !== "debug") {
+                    this.statusTracker?.addLogLine(this.agentConfig.name, msg);
+                }
+                return;
+            }
+        }
+        catch {
+            // Not JSON — treat as plain output
+        }
+        // Detect [STATUS: <text>] in plain output
+        const statusMatch = line.match(/\[STATUS:\s*([^\]]+)\]/);
+        if (statusMatch) {
+            this.statusTracker?.setAgentStatusText(this.agentConfig.name, statusMatch[1].trim());
+        }
+        if (line === "[SILENT]") {
+            this.logger.info("no work to do");
+            this.statusTracker?.addLogLine(this.agentConfig.name, "no work to do");
+        }
+    }
+    streamContainerLogs(containerName) {
+        const proc = spawn("docker", ["logs", "-f", containerName], {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let buffer = "";
+        proc.stdout.on("data", (chunk) => {
+            buffer += chunk.toString();
+            const lines = buffer.split("\n");
+            buffer = lines.pop() || "";
+            for (const line of lines) {
+                this.forwardLogLine(line);
+            }
+        });
+        // Also capture stderr
+        proc.stderr.on("data", (chunk) => {
+            const text = chunk.toString().trim();
+            if (text) {
+                this.logger.warn({ stderr: text.slice(0, 500) }, "container stderr");
+            }
+        });
+        return {
+            stop: () => {
+                // Flush remaining buffer
+                if (buffer.trim()) {
+                    this.forwardLogLine(buffer);
+                }
+                proc.kill();
+            },
+        };
+    }
+    waitForContainer(containerName, timeoutSeconds) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn("docker", ["wait", containerName], {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let stdout = "";
+            proc.stdout.on("data", (chunk) => {
+                stdout += chunk.toString();
+            });
+            const timer = setTimeout(() => {
+                proc.kill();
+                spawn("docker", ["kill", containerName], { stdio: "ignore" });
+                reject(new Error(`Container ${containerName} timed out after ${timeoutSeconds}s`));
+            }, timeoutSeconds * 1000);
+            proc.on("close", () => {
+                clearTimeout(timer);
+                resolve(parseInt(stdout.trim(), 10));
+            });
+            proc.on("error", (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+        });
+    }
+    async run(prompt) {
+        if (this._running) {
+            this.logger.warn(`${this.agentConfig.name} is already running, skipping`);
+            return;
+        }
+        this._running = true;
+        this.statusTracker?.setAgentState(this.agentConfig.name, "running");
+        this.logger.info(`Starting ${this.agentConfig.name} container run`);
+        const runStartTime = Date.now();
+        const shutdownSecret = randomUUID();
+        const stagingDir = mkdtempSync(join(tmpdir(), "al-creds-"));
+        let containerName;
+        let logStream;
+        try {
+            const image = this.globalConfig.docker?.image || "al-agent:latest";
+            const timeout = this.globalConfig.docker?.timeout || 3600;
+            // Symlink credentials into staging dir
+            // Always include anthropic-key
+            const allCreds = new Set([...this.agentConfig.credentials, "anthropic-key"]);
+            for (const cred of allCreds) {
+                const src = resolve(CREDENTIALS_DIR, cred);
+                const dst = join(stagingDir, cred);
+                try {
+                    symlinkSync(src, dst);
+                }
+                catch (err) {
+                    this.logger.warn({ cred, err: err.message }, "failed to symlink credential");
+                }
+            }
+            // Read AGENTS.md from disk and include it in the serialized config
+            const agentsMdPath = resolve(this.projectPath, this.agentConfig.name, "AGENTS.md");
+            const agentsMd = readFileSync(agentsMdPath, "utf-8");
+            const configWithMd = { ...this.agentConfig, _agentsMd: agentsMd };
+            containerName = launchContainer({
+                image,
+                agentName: this.agentConfig.name,
+                agentConfig: JSON.stringify(configWithMd),
+                shutdownSecret,
+                brokerUrl: this.brokerUrl,
+                prompt,
+                credentialsStagingDir: stagingDir,
+                memory: this.globalConfig.docker?.memory,
+                cpus: this.globalConfig.docker?.cpus,
+                timeout,
+            });
+            // Register container for shutdown endpoint
+            this.registerContainer(shutdownSecret, containerName);
+            this.logger.info({ container: containerName }, "container launched");
+            // Stream logs in real-time
+            logStream = this.streamContainerLogs(containerName);
+            const startTime = Date.now();
+            const exitCode = await this.waitForContainer(containerName, timeout);
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            // Give the log stream a moment to flush
+            await new Promise((r) => setTimeout(r, 500));
+            logStream.stop();
+            logStream = undefined;
+            if (exitCode !== 0) {
+                this.logger.error({ exitCode, elapsed: `${elapsed}s` }, "container exited with error");
+            }
+            else {
+                this.logger.info({ exitCode, elapsed: `${elapsed}s` }, "container finished");
+            }
+        }
+        catch (err) {
+            this.logger.error({ err }, `${this.agentConfig.name} container run failed`);
+        }
+        finally {
+            if (logStream)
+                logStream.stop();
+            // Clean up staging dir
+            try {
+                rmSync(stagingDir, { recursive: true, force: true });
+            }
+            catch { /* best effort */ }
+            if (containerName) {
+                removeContainer(containerName);
+            }
+            const elapsed = Date.now() - runStartTime;
+            this.statusTracker?.completeRun(this.agentConfig.name, elapsed);
+            this._running = false;
+        }
+    }
+}
+//# sourceMappingURL=container-runner.js.map

package/dist/agents/container-runner.js.map

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

package/dist/agents/definitions/dev/AGENTS.md

@@ -0,0 +1,44 @@
+# Developer Agent
+
+You are a developer agent. Your job is to pick up GitHub issues and implement the requested changes.
+
+Your configuration is in the `<agent-config>` block at the start of your prompt.
+Use those values for repos, triggerLabel, and assignee.
+
+`GITHUB_TOKEN` is already set in your environment. Use `gh` CLI and `git` directly.
+
+**You MUST complete ALL steps below.** Do not stop after reading the issue — you must implement, commit, push, and open a PR.
+
+## Workflow
+
+1. **Find an issue** — run `gh issue list --repo <repo> --label <triggerLabel> --assignee <assignee> --state open --json number,title,body,comments,labels --limit 1`. If empty, respond `[SILENT]` and stop.
+
+2. **Claim the issue** — run `gh issue edit <number> --repo <repo> --add-label in-progress` to mark it as claimed.
+
+3. **Clone and branch** — run `git clone https://github.com/<repo>.git /workspace/repo && cd /workspace/repo && git checkout -b agent/<number>`.
+
+4. **Understand the issue** — read the title, body, and comments. Note file paths, acceptance criteria, and linked issues.
+
+5. **Read project conventions** — in the repo, read `AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING.md`, and `README.md` if they exist. Follow any conventions found there.
+
+6. **Implement changes** — work in the repo. Make the minimum necessary changes, follow existing patterns, and write or update tests if the project has a test suite.
+
+7. **Validate** — run the project's test suite and linters (e.g., `npm test`). Fix failures before proceeding.
+
+8. **Commit** — `git add -A && git commit -m "fix: <description> (closes #<number>)"`
+
+9. **Push** — `git push -u origin agent/<number>`
+
+10. **Create a PR** — run `gh pr create --repo <repo> --head agent/<number> --base main --title "<title>" --body "Closes #<number>\n\n<description>"`.
+
+11. **Comment on the issue** — run `gh issue comment <number> --repo <repo> --body "PR created: <pr_url>"`.
+
+12. **Mark done** — run `gh issue edit <number> --repo <repo> --remove-label in-progress --add-label agent-completed`.
+
+## Rules
+
+- Work on exactly ONE issue per run
+- Never modify files outside the repo directory
+- **You MUST complete steps 8-12.** Do not stop early.
+- If tests fail after 2 attempts, create the PR anyway with a note about failing tests
+- If the issue is unclear, comment asking for clarification and stop

package/dist/agents/definitions/dev/config-definition.json

@@ -0,0 +1,39 @@
+{
+  "name": "dev",
+  "label": "Developer agent",
+  "description": "Picks up issues, writes code, opens PRs",
+  "credentials": {
+    "required": ["anthropic-key", "github-token"],
+    "optional": []
+  },
+  "webhooks": {
+    "description": "Wake when an issue is labeled",
+    "events": ["issues"],
+    "actions": ["labeled"]
+  },
+  "prompts": {
+    "webhook": "An issue was just assigned to you. Implement the changes described in the issue.",
+    "schedule": "Poll GitHub for new issues with the trigger label and implement any found."
+  },
+  "defaultSchedule": "*/5 * * * *",
+  "state": {
+    "file": "active-issues.json",
+    "initial": { "issues": {} }
+  },
+  "params": {
+    "triggerLabel": {
+      "type": "string",
+      "description": "Issue label that triggers the agent",
+      "default": "agent",
+      "required": true,
+      "webhookFilter": { "field": "labels", "wrap": "array" }
+    },
+    "assignee": {
+      "type": "string",
+      "description": "Assign triggered issues to which user",
+      "default": "$githubUser",
+      "required": true,
+      "webhookFilter": { "field": "assignee" }
+    }
+  }
+}

package/dist/agents/definitions/devops/AGENTS.md

@@ -0,0 +1,33 @@
+# DevOps Agent
+
+You are a DevOps monitoring agent. Your job is to detect new errors from CI/CD failures and production error tracking, then file actionable GitHub issues for each unique problem.
+
+Your configuration is in the `<agent-config>` block at the start of your prompt.
+Use those values for repos, sentryOrg, and sentryProjects.
+
+`GITHUB_TOKEN` is already set in your environment. Use `gh` CLI directly.
+If Sentry is configured, `SENTRY_AUTH_TOKEN` is set in your environment. Use `curl` for Sentry API requests.
+
+## Workflow
+
+1. **Poll for CI errors** — run `gh run list --repo <repo> --status failure --json databaseId,name,headBranch,conclusion,url,createdAt --limit 20` for each repo.
+
+2. **Poll Sentry errors (if configured)** — run:
+   ```
+   curl -s -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
+     "https://sentry.io/api/0/projects/<sentryOrg>/<project>/issues/?query=is:unresolved&statsPeriod=24h"
+   ```
+
+3. **Deduplicate** — search existing issues to avoid duplicates: `gh issue list --repo <repo> --label agent-filed --state all --json title --limit 100`. Skip errors that already have matching issues.
+
+4. **File GitHub issues** — for each new error, run `gh issue create --repo <repo>`:
+   - **CI failures** — `--title "[CI Failure] <workflow> on <branch>" --body "<details>" --label ci-failure,agent-filed`
+   - **Sentry errors** — `--title "[Sentry] <title>" --body "<details>" --label production-error,agent-filed`
+
+## Rules
+
+- Always check deduplication before filing — never create duplicate issues
+- Include enough context for a developer to start investigating
+- For Sentry errors, include the permalink for full details
+- For CI failures, include the run URL for log access
+- Do not attempt to fix errors yourself — just file issues

package/dist/agents/definitions/devops/config-definition.json

@@ -0,0 +1,37 @@
+{
+  "name": "devops",
+  "label": "DevOps monitor",
+  "description": "Detects errors, files issues",
+  "credentials": {
+    "required": ["anthropic-key", "github-token"],
+    "optional": ["sentry-token"]
+  },
+  "webhooks": {
+    "description": "Wake when a GitHub Actions workflow completes",
+    "events": ["workflow_run"],
+    "actions": ["completed"]
+  },
+  "prompts": {
+    "webhook": "A workflow run just completed. Check for failures and file issues for any new errors found.",
+    "schedule": "Poll for new errors from GitHub Actions failures and Sentry, file issues for any new ones found."
+  },
+  "defaultSchedule": "*/15 * * * *",
+  "state": {
+    "file": "known-errors.json",
+    "initial": { "errors": {} }
+  },
+  "params": {
+    "sentryOrg": {
+      "type": "string",
+      "description": "Sentry organization slug",
+      "required": false,
+      "credential": "sentry-token"
+    },
+    "sentryProjects": {
+      "type": "string[]",
+      "description": "Sentry project slugs to monitor",
+      "required": false,
+      "credential": "sentry-token"
+    }
+  }
+}

package/dist/agents/definitions/loader.d.ts

@@ -0,0 +1,18 @@
+import type { AgentDefinition } from "./schema.js";
+/**
+ * Load a definition by built-in name or filesystem path.
+ */
+export declare function loadDefinition(nameOrPath: string): AgentDefinition;
+/**
+ * Load the AGENTS.md from a definition package.
+ */
+export declare function loadDefinitionAgentsMd(nameOrPath: string): string;
+/**
+ * List all built-in definitions.
+ */
+export declare function listBuiltinDefinitions(): AgentDefinition[];
+/**
+ * Check if a name corresponds to a built-in definition.
+ */
+export declare function isBuiltinDefinition(nameOrPath: string): boolean;
+//# sourceMappingURL=loader.d.ts.map

package/dist/agents/definitions/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAUnD;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAmBlE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D"}

package/dist/agents/definitions/loader.js

@@ -0,0 +1,59 @@
+import { readFileSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { validateDefinition } from "./schema.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const BUILTIN_NAMES = ["dev", "reviewer", "devops"];
+function builtinDir(name) {
+    return resolve(__dirname, name);
+}
+/**
+ * Load a definition by built-in name or filesystem path.
+ */
+export function loadDefinition(nameOrPath) {
+    let defDir;
+    if (BUILTIN_NAMES.includes(nameOrPath)) {
+        defDir = builtinDir(nameOrPath);
+    }
+    else {
+        defDir = resolve(nameOrPath);
+    }
+    const jsonPath = resolve(defDir, "config-definition.json");
+    if (!existsSync(jsonPath)) {
+        throw new Error(`Agent definition not found at ${jsonPath}. ` +
+            `Provide a built-in name (${BUILTIN_NAMES.join(", ")}) or a path to a definition directory.`);
+    }
+    const raw = JSON.parse(readFileSync(jsonPath, "utf-8"));
+    return validateDefinition(raw);
+}
+/**
+ * Load the AGENTS.md from a definition package.
+ */
+export function loadDefinitionAgentsMd(nameOrPath) {
+    let defDir;
+    if (BUILTIN_NAMES.includes(nameOrPath)) {
+        defDir = builtinDir(nameOrPath);
+    }
+    else {
+        defDir = resolve(nameOrPath);
+    }
+    const mdPath = resolve(defDir, "AGENTS.md");
+    if (!existsSync(mdPath)) {
+        throw new Error(`No AGENTS.md found in definition at ${defDir}. ` +
+            `Create an AGENTS.md in the definition directory.`);
+    }
+    return readFileSync(mdPath, "utf-8");
+}
+/**
+ * List all built-in definitions.
+ */
+export function listBuiltinDefinitions() {
+    return BUILTIN_NAMES.map((name) => loadDefinition(name));
+}
+/**
+ * Check if a name corresponds to a built-in definition.
+ */
+export function isBuiltinDefinition(nameOrPath) {
+    return BUILTIN_NAMES.includes(nameOrPath);
+}
+//# sourceMappingURL=loader.js.map

package/dist/agents/definitions/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/agents/definitions/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAyB,MAAM,IAAI,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAEpD,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,IAAI,MAAc,CAAC;IAEnB,IAAI,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,iCAAiC,QAAQ,IAAI;YAC7C,4BAA4B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAC7F,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,IAAI,MAAc,CAAC;IAEnB,IAAI,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,uCAAuC,MAAM,IAAI;YACjD,kDAAkD,CACnD,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC"}

package/dist/agents/definitions/reviewer/AGENTS.md

@@ -0,0 +1,37 @@
+# PR Reviewer Agent
+
+You are a code review agent. Your job is to review open pull requests, approve good ones, and request changes on problematic ones.
+
+Your configuration is in the `<agent-config>` block at the start of your prompt.
+Use those values for repos.
+
+`GITHUB_TOKEN` is already set in your environment. Use `gh` CLI directly.
+
+## Workflow
+
+1. **List open PRs** — run `gh pr list --repo <repo> --state open --json number,title,headRefName,headRefOid,statusCheckRollup` for each repo. If empty, respond `[SILENT]` and stop.
+
+2. **Review each PR:**
+
+   a. **Get the diff** — run `gh pr diff <number> --repo <repo>`.
+
+   b. **Evaluate** — review for correctness, style, tests, security, and performance.
+
+   c. **Check CI** — look at `statusCheckRollup` from step 1. Do NOT merge if CI is failing.
+
+   d. **Submit review:**
+      - **Good code + green CI** — `gh pr review <number> --repo <repo> --approve --body "<review>"`, then `gh pr merge <number> --repo <repo> --squash`
+      - **Issues found** — `gh pr review <number> --repo <repo> --request-changes --body "<review>"`
+      - **Good code + failing CI** — `gh pr review <number> --repo <repo> --comment --body "LGTM but CI must pass before merging."`
+
+## Review Standards
+
+- **Specific** — point to exact lines or patterns
+- **Constructive** — suggest fixes, don't just point out problems
+- **Proportional** — don't block for minor style nits
+- **Thorough** — check edge cases, error handling, boundaries
+
+## Rules
+
+- Review ALL open PRs in a single run, not just one
+- Never approve a PR with failing CI checks

package/dist/agents/definitions/reviewer/config-definition.json

@@ -0,0 +1,24 @@
+{
+  "name": "reviewer",
+  "label": "PR reviewer",
+  "description": "Reviews and merges pull requests",
+  "credentials": {
+    "required": ["anthropic-key", "github-token"],
+    "optional": []
+  },
+  "webhooks": {
+    "description": "Wake when a PR is opened or updated",
+    "events": ["pull_request"],
+    "actions": ["opened", "synchronize"]
+  },
+  "prompts": {
+    "webhook": "Review the pull request that just came in. Approve or request changes.",
+    "schedule": "Poll GitHub for open PRs that need review, review them, and merge if appropriate."
+  },
+  "defaultSchedule": "*/5 * * * *",
+  "state": {
+    "file": "reviewed-prs.json",
+    "initial": { "prs": {} }
+  },
+  "params": {}
+}

package/dist/agents/definitions/schema.d.ts

@@ -0,0 +1,38 @@
+export interface WebhookFilterMapping {
+    field: string;
+    wrap?: "array";
+}
+export interface ParamDefinition {
+    type: "string" | "string[]";
+    description: string;
+    default?: string;
+    required: boolean;
+    webhookFilter?: WebhookFilterMapping;
+    credential?: string;
+}
+export interface AgentDefinition {
+    name: string;
+    label: string;
+    description: string;
+    credentials: {
+        required: string[];
+        optional: string[];
+    };
+    webhooks: {
+        description: string;
+        events: string[];
+        actions: string[];
+    };
+    prompts: {
+        webhook: string;
+        schedule: string;
+    };
+    defaultSchedule: string;
+    state?: {
+        file: string;
+        initial: Record<string, unknown>;
+    };
+    params: Record<string, ParamDefinition>;
+}
+export declare function validateDefinition(json: unknown): AgentDefinition;
+//# sourceMappingURL=schema.d.ts.map

package/dist/agents/definitions/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/schema.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACzC;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CA4DjE"}