@action-llama/skill 0.23.8 → 0.24.2

package/.claude-plugin/plugin.json

@@ -0,0 +1,14 @@
+{
+  "name": "al",
+  "description": "Action Llama — CLI tool for running LLM agents as scripts. Create, run, debug, and manage autonomous agents triggered by cron schedules and webhooks.",
+  "version": "0.23.8",
+  "author": {
+    "name": "Action Llama"
+  },
+  "homepage": "https://docs.actionllama.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Action-Llama/action-llama"
+  },
+  "license": "MIT"
+}

package/dist/build-docs.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Build script that generates skill supporting files from the docs package.
+ *
+ * Reads docs.json for navigation structure, reads MDX source files,
+ * strips Mintlify components, and concatenates them into skill
+ * supporting files grouped by topic.
+ *
+ * Usage: node --import tsx/esm src/build-docs.ts
+ */
+/** Mapping of output filename → list of doc page paths (relative to docs dir, no extension). */
+export declare const DOC_MAPPING: Record<string, string[]>;
+/** Extract title from YAML frontmatter. */
+export declare function extractTitle(content: string): string | null;
+/** Strip YAML frontmatter from MDX content. */
+export declare function stripFrontmatter(content: string): string;
+/**
+ * Strip Mintlify JSX components, keeping their text content.
+ * Handles: <Info>, <Note>, <Warning>, <Tip>, <CardGroup>, <Card>, <Steps>, <Step>, etc.
+ */
+export declare function stripMintlifyComponents(content: string): string;
+/** Process a single MDX file into clean markdown. */
+export declare function processMdxFile(content: string): {
+    title: string | null;
+    body: string;
+};
+/** Read and process a doc page, returning formatted markdown section. */
+export declare function processDocPage(docsDir: string, pagePath: string): string;
+/** Build a single output file from a list of doc pages. */
+export declare function buildOutputFile(docsDir: string, pages: string[]): string;
+/** Build all output files from the mapping. */
+export declare function buildAll(docsDir: string, outputDir: string): void;
+//# sourceMappingURL=build-docs.d.ts.map

package/dist/build-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-docs.d.ts","sourceRoot":"","sources":["../src/build-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,gGAAgG;AAChG,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAsChD,CAAC;AAEF,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK3D;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa/D;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKtF;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWxE;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAGxE;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAMjE"}

package/dist/build-docs.js

@@ -0,0 +1,127 @@
+/**
+ * Build script that generates skill supporting files from the docs package.
+ *
+ * Reads docs.json for navigation structure, reads MDX source files,
+ * strips Mintlify components, and concatenates them into skill
+ * supporting files grouped by topic.
+ *
+ * Usage: node --import tsx/esm src/build-docs.ts
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DOCS_DIR = resolve(__dirname, "..", "..", "docs");
+const SKILLS_DIR = resolve(__dirname, "..", "skills", "al");
+/** Mapping of output filename → list of doc page paths (relative to docs dir, no extension). */
+export const DOC_MAPPING = {
+    "agent-authoring.md": [
+        "concepts/agents",
+        "reference/agent-config",
+        "reference/agent-docs",
+        "reference/credentials",
+        "reference/models",
+        "reference/webhooks",
+        "reference/webhooks/github",
+        "reference/webhooks/sentry",
+        "reference/webhooks/linear",
+        "reference/webhooks/mintlify",
+        "reference/webhooks/slack",
+        "reference/webhooks/twitter",
+    ],
+    "operations.md": [
+        "first-steps/getting-started",
+        "first-steps/using-webhooks",
+        "reference/cli-commands",
+        "reference/project-config",
+        "concepts/scheduler",
+        "reference/dockerfiles",
+        "guides/deploying-to-vps",
+        "guides/cloud-run-runtime",
+        "guides/continuous-deployment",
+        "guides/custom-dockerfiles",
+        "reference/gateway-api",
+        "reference/web-dashboard",
+    ],
+    "debugging.md": [
+        "reference/agent-commands",
+        "concepts/runtime-context",
+        "concepts/resource-locks",
+        "guides/dynamic-context",
+        "guides/shared-context",
+        "guides/subagents",
+        "guides/scaling-agents",
+    ],
+};
+/** Extract title from YAML frontmatter. */
+export function extractTitle(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    const titleMatch = match[1].match(/^title:\s*"?([^"\n]+)"?\s*$/m);
+    return titleMatch ? titleMatch[1] : null;
+}
+/** Strip YAML frontmatter from MDX content. */
+export function stripFrontmatter(content) {
+    return content.replace(/^---\n[\s\S]*?\n---\n*/, "");
+}
+/**
+ * Strip Mintlify JSX components, keeping their text content.
+ * Handles: <Info>, <Note>, <Warning>, <Tip>, <CardGroup>, <Card>, <Steps>, <Step>, etc.
+ */
+export function stripMintlifyComponents(content) {
+    // Remove self-closing tags: <Card ... />
+    let result = content.replace(/<\w+\s+[^>]*\/>/g, "");
+    // Remove opening and closing tags, keeping inner content
+    // Handles both single-line and multi-line: <Info>text</Info>
+    result = result.replace(/<(Info|Note|Warning|Tip|CardGroup|Card|Steps|Step|Accordion|AccordionGroup|Tab|Tabs|Frame|Snippet|Check|ResponseField|Expandable|ParamField)(\s[^>]*)?>/gi, "");
+    result = result.replace(/<\/(Info|Note|Warning|Tip|CardGroup|Card|Steps|Step|Accordion|AccordionGroup|Tab|Tabs|Frame|Snippet|Check|ResponseField|Expandable|ParamField)>/gi, "");
+    // Clean up excessive blank lines (3+ → 2)
+    result = result.replace(/\n{3,}/g, "\n\n");
+    return result;
+}
+/** Process a single MDX file into clean markdown. */
+export function processMdxFile(content) {
+    const title = extractTitle(content);
+    let body = stripFrontmatter(content);
+    body = stripMintlifyComponents(body);
+    return { title, body: body.trim() };
+}
+/** Read and process a doc page, returning formatted markdown section. */
+export function processDocPage(docsDir, pagePath) {
+    const filePath = resolve(docsDir, `${pagePath}.mdx`);
+    if (!existsSync(filePath)) {
+        throw new Error(`Doc file not found: ${filePath}`);
+    }
+    const raw = readFileSync(filePath, "utf-8");
+    const { title, body } = processMdxFile(raw);
+    // Wrap in a section with the title as H1
+    const heading = title ? `# ${title}` : `# ${pagePath.split("/").pop()}`;
+    return `${heading}\n\n${body}`;
+}
+/** Build a single output file from a list of doc pages. */
+export function buildOutputFile(docsDir, pages) {
+    const sections = pages.map((page) => processDocPage(docsDir, page));
+    return sections.join("\n\n---\n\n") + "\n";
+}
+/** Build all output files from the mapping. */
+export function buildAll(docsDir, outputDir) {
+    mkdirSync(outputDir, { recursive: true });
+    for (const [filename, pages] of Object.entries(DOC_MAPPING)) {
+        const content = buildOutputFile(docsDir, pages);
+        writeFileSync(resolve(outputDir, filename), content);
+    }
+}
+// CLI entry point
+if (process.argv[1] && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {
+    const docsDir = process.argv[2] || DOCS_DIR;
+    const outputDir = process.argv[3] || SKILLS_DIR;
+    if (!existsSync(resolve(docsDir, "docs.json"))) {
+        console.error(`docs.json not found in ${docsDir}`);
+        process.exit(1);
+    }
+    buildAll(docsDir, outputDir);
+    const totalPages = Object.values(DOC_MAPPING).reduce((sum, pages) => sum + pages.length, 0);
+    console.log(`Built ${Object.keys(DOC_MAPPING).length} skill files from ${totalPages} doc pages → ${outputDir}`);
+}
+//# sourceMappingURL=build-docs.js.map

package/dist/build-docs.js.map

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

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-/** Absolute path to AGENTS.md (the shared AI reference doc). */
-export declare const agentsMdPath: string;
-/** Absolute path to the MCP server config template. */
+/** Absolute path to the plugin root (contains .claude-plugin/, skills/, .mcp.json). */
+export declare const pluginDir: string;
+/** Absolute path to the skills directory. */
+export declare const skillsDir: string;
+/** Absolute path to the MCP server config. */
 export declare const mcpJsonPath: string;
-/** Absolute path to the commands directory. */
-export declare const commandsDir: string;
-/** Map of command name → absolute file path for each Claude Code slash command. */
-export declare const commandPaths: Record<string, string>;
+/** Absolute path to the plugin manifest. */
+export declare const pluginJsonPath: string;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,gEAAgE;AAChE,eAAO,MAAM,YAAY,QAAmC,CAAC;AAE7D,uDAAuD;AACvD,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D,+CAA+C;AAC/C,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D,mFAAmF;AACnF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM/C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,uFAAuF;AACvF,eAAO,MAAM,SAAS,QAAc,CAAC;AAErC,6CAA6C;AAC7C,eAAO,MAAM,SAAS,QAAiC,CAAC;AAExD,8CAA8C;AAC9C,eAAO,MAAM,WAAW,QAAoC,CAAC;AAE7D,4CAA4C;AAC5C,eAAO,MAAM,cAAc,QAAwD,CAAC"}

package/dist/index.js

@@ -1,19 +1,13 @@
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const contentDir = resolve(__dirname, "..", "content");
-/** Absolute path to AGENTS.md (the shared AI reference doc). */
-export const agentsMdPath = resolve(contentDir, "AGENTS.md");
-/** Absolute path to the MCP server config template. */
-export const mcpJsonPath = resolve(contentDir, "mcp.json");
-/** Absolute path to the commands directory. */
-export const commandsDir = resolve(contentDir, "commands");
-/** Map of command name → absolute file path for each Claude Code slash command. */
-export const commandPaths = {
-    "new-agent": resolve(commandsDir, "new-agent.md"),
-    "run": resolve(commandsDir, "run.md"),
-    "debug": resolve(commandsDir, "debug.md"),
-    "iterate": resolve(commandsDir, "iterate.md"),
-    "status": resolve(commandsDir, "status.md"),
-};
+const packageRoot = resolve(__dirname, "..");
+/** Absolute path to the plugin root (contains .claude-plugin/, skills/, .mcp.json). */
+export const pluginDir = packageRoot;
+/** Absolute path to the skills directory. */
+export const skillsDir = resolve(packageRoot, "skills");
+/** Absolute path to the MCP server config. */
+export const mcpJsonPath = resolve(packageRoot, ".mcp.json");
+/** Absolute path to the plugin manifest. */
+export const pluginJsonPath = resolve(packageRoot, ".claude-plugin", "plugin.json");
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAEvD,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAE7D,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAE3D,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC;IACjD,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;IAC7C,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC;CAC5C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAE7C,uFAAuF;AACvF,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AAErC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAExD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAE7D,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@action-llama/skill",
-  "version": "0.23.8",
-  "description": "AI integration content for Action Llama projects — AGENTS.md, MCP config, Claude Code commands.",
+  "version": "0.24.2",
+  "description": "Action Llama plugin for AI coding tools — skills, MCP config, and reference docs for creating, running, and debugging LLM agents.",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -13,17 +13,20 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
-    },
-    "./content/*": "./content/*"
+    }
   },
   "files": [
     "dist",
-    "content"
+    ".claude-plugin",
+    "skills",
+    ".mcp.json"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsc"
+    "build": "node --experimental-strip-types src/build-docs.ts && tsc",
+    "build:docs": "node --experimental-strip-types src/build-docs.ts",
+    "test": "vitest run --config vitest.config.ts"
   }
 }

package/skills/al/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: al
+description: Action Llama reference — agent authoring, CLI operations, and debugging. Loaded automatically when working with Action Llama projects.
+user-invocable: false
+---
+
+# Action Llama Reference
+
+Action Llama (`al`) is a CLI tool for running LLM agents as scripts, triggered by cron schedules and webhooks.
+
+## When to use this reference
+
+Load the relevant supporting file based on what you need:
+
+- **[agent-authoring.md](agent-authoring.md)** — Creating and configuring agents: SKILL.md format, config.toml fields, credential types, model providers, webhook setup
+- **[operations.md](operations.md)** — Running and deploying: CLI commands, project config, scheduler, Docker, VPS/cloud deployment, gateway API, dashboard
+- **[debugging.md](debugging.md)** — Diagnosing issues: agent commands, exit codes, runtime context, resource locks, dynamic context, subagent calls, scaling
+
+## Key concepts
+
+- An **agent** is a directory under `agents/<name>/` containing `SKILL.md` (portable instructions) and `config.toml` (runtime config)
+- A **skill** is the portable artifact (`SKILL.md` + optional `Dockerfile`) that can be shared and installed
+- Config uses a 3-layer merge: `config.toml` (committed) → `.env.toml` (gitignored) → environment file (machine-level)
+- Credentials live in `~/.action-llama/credentials/<type>/<instance>/<field>`
+- The MCP server (`al mcp serve`) exposes tools: `al_run`, `al_start`, `al_stop`, `al_status`, `al_agents`, `al_logs`, `al_pause`, `al_resume`, `al_kill`