@soleri/forge 5.11.0 → 5.12.0

package/dist/templates/readme.js

@@ -2,10 +2,81 @@
  * Generate a README.md for the scaffolded agent.
  */
 export function generateReadme(config) {
+    const setupTarget = config.setupTarget ?? 'claude';
+    const claudeSetup = setupTarget === 'claude' || setupTarget === 'both';
+    const codexSetup = setupTarget === 'codex' || setupTarget === 'both';
     const domainRows = config.domains
         .map((d) => `| ${d} | *Ready for knowledge capture* |`)
         .join('\n');
     const principleLines = config.principles.map((p) => `- ${p}`).join('\n');
+    const quickStartSession = claudeSetup && codexSetup
+        ? 'Start a new Claude Code or Codex session, then say:'
+        : claudeSetup
+            ? 'Start a new Claude Code session, then say:'
+            : 'Start a new Codex session, then say:';
+    const prerequisites = [
+        '- **Node.js 18+** — `node --version` to check',
+        ...(claudeSetup ? ['- **Claude Code** — Anthropic CLI (`claude` command)'] : []),
+        ...(codexSetup ? ['- **Codex** — desktop/CLI with `~/.codex/config.toml`'] : []),
+    ].join('\n');
+    const helloFlow = [
+        `- ${config.name} returns its persona, principles, and tool recommendations`,
+        ...(claudeSetup ? [`- Claude can adopt the ${config.name} persona for the session`] : []),
+        ...(claudeSetup
+            ? [`- ${config.name} can inject/check CLAUDE.md integration when requested`]
+            : []),
+        ...(codexSetup
+            ? ['- Codex uses project-level AGENTS.md guidance and local skills for routing']
+            : []),
+    ].join('\n');
+    const manualSetupBlocks = [
+        ...(claudeSetup
+            ? [
+                [
+                    '### Claude Code',
+                    '',
+                    'Add this to `~/.claude/settings.json` under `mcpServers`:',
+                    '',
+                    '```json',
+                    '{',
+                    '  "mcpServers": {',
+                    `    "${config.id}": {`,
+                    '      "command": "node",',
+                    '      "args": ["dist/index.js"],',
+                    `      "cwd": "/absolute/path/to/${config.id}"`,
+                    '    }',
+                    '  }',
+                    '}',
+                    '```',
+                ].join('\n'),
+            ]
+            : []),
+        ...(codexSetup
+            ? [
+                [
+                    '### Codex',
+                    '',
+                    'Add this to `~/.codex/config.toml`:',
+                    '',
+                    '```toml',
+                    `[mcp_servers.${config.id}]`,
+                    'command = "node"',
+                    `args = ["/absolute/path/to/${config.id}/dist/index.js"]`,
+                    '```',
+                ].join('\n'),
+            ]
+            : []),
+    ].join('\n\n');
+    const skillsLead = claudeSetup && codexSetup
+        ? `${config.name} ships with 17 structured workflow skills. In Claude Code they are invocable via \`/<skill-name>\`; in Codex they are available via generated AGENTS.md + local skill files.`
+        : claudeSetup
+            ? `${config.name} ships with 17 structured workflow skills, invocable via \`/<skill-name>\` in Claude Code:`
+            : `${config.name} ships with 17 structured workflow skills, available via generated AGENTS.md + local skill files in Codex:`;
+    const skillsInstallNote = claudeSetup && codexSetup
+        ? 'Skills are installed to `~/.claude/commands/` and `~/.codex/skills/` during setup. Run `./scripts/setup.sh` to install or reinstall.'
+        : claudeSetup
+            ? 'Skills are installed to `~/.claude/commands/` during setup. Run `./scripts/setup.sh` to install or reinstall.'
+            : 'Skills are installed to `~/.codex/skills/` during setup. Run `./scripts/setup.sh` to install or reinstall.';
     return `# ${config.name} — ${config.role}
 
 ${config.description}
@@ -31,10 +102,10 @@ cd ${config.id}
 npm install
 npm run build
 
-# 2. Add to Claude Code
+# 2. Run setup
 ./scripts/setup.sh
 
-# 3. Start a new Claude Code session, then say:
+# 3. ${quickStartSession}
 #    "Hello, ${config.name}!"
 \`\`\`
 
@@ -42,33 +113,15 @@ That's it. ${config.name} will activate, check your setup, and offer to configur
 
 ## Prerequisites
 
-- **Node.js 18+** — \`node --version\` to check
-- **Claude Code** — Anthropic's CLI for Claude (\`claude\` command)
+${prerequisites}
 
 ## What Happens When You Say "Hello, ${config.name}!"
 
-1. ${config.name} returns its persona, principles, and tool recommendations
-2. Claude adopts the ${config.name} persona for the rest of the session
-3. ${config.name} checks if your project has CLAUDE.md integration
-4. If not, it offers to inject its configuration (facades table, intent detection, knowledge protocol)
+${helloFlow}
 
 ## Manual Setup (if setup.sh doesn't work)
 
-Add this to \`~/.claude/settings.json\` under \`mcpServers\`:
-
-\`\`\`json
-{
-  "mcpServers": {
-    "${config.id}": {
-      "command": "node",
-      "args": ["dist/index.js"],
-      "cwd": "/absolute/path/to/${config.id}"
-    }
-  }
-}
-\`\`\`
-
-Then restart Claude Code.
+${manualSetupBlocks}
 
 ## Domains
 
@@ -82,7 +135,7 @@ ${principleLines}
 
 ## Built-in Skills
 
-${config.name} ships with 17 structured workflow skills, invocable via \`/<skill-name>\` in Claude Code:
+${skillsLead}
 
 **Development Workflows:**
 
@@ -116,7 +169,7 @@ ${config.name} ships with 17 structured workflow skills, invocable via \`/<skill
 | \`/onboard-me\` | Instant project knowledge tour for newcomers |
 | \`/health-check\` | Vault maintenance — duplicates, contradictions, stale entries |
 
-Skills are installed to \`~/.claude/commands/\` during setup. Run \`./scripts/setup.sh\` to install or reinstall.
+${skillsInstallNote}
 
 ## Features
 
@@ -172,8 +225,8 @@ Use \`llm_status\` to check provider availability and key pool health.
 
 ### Activating and Deactivating
 
-- **"Hello, ${config.name}!"** — Activate the persona. Claude adopts ${config.name}'s identity, principles, and tool access for the session.
-- **"Goodbye, ${config.name}!"** — Deactivate. Claude returns to its default behavior.
+- **"Hello, ${config.name}!"** — Activate the persona. Your active client session adopts ${config.name}'s identity, principles, and tool access.
+- **"Goodbye, ${config.name}!"** — Deactivate and return to default assistant behavior.
 
 ### Daily Workflow
 

package/dist/templates/readme.js.map

@@ -1 +1 @@
-{"version":3,"file":"readme.js","sourceRoot":"","sources":["../../src/templates/readme.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC;SACtD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzE,OAAO,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI;;EAExC,MAAM,CAAC,WAAW;;SAEX,MAAM,CAAC,IAAI;;;;EAIlB,MAAM,CAAC,IAAI;;;;;;;6EAOgE,MAAM,CAAC,IAAI;;;;;;KAMnF,MAAM,CAAC,EAAE;;;;;;;;eAQC,MAAM,CAAC,IAAI;;;aAGb,MAAM,CAAC,IAAI;;;;;;;uCAOe,MAAM,CAAC,IAAI;;KAE7C,MAAM,CAAC,IAAI;uBACO,MAAM,CAAC,IAAI;KAC7B,MAAM,CAAC,IAAI;;;;;;;;;;OAUT,MAAM,CAAC,EAAE;;;kCAGkB,MAAM,CAAC,EAAE;;;;;;;;;;;;EAYzC,UAAU;;;;EAIV,cAAc;;;;EAId,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiEC,MAAM,CAAC,EAAE;;;;;;;;;;sCAUe,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;cAejC,MAAM,CAAC,IAAI,8CAA8C,MAAM,CAAC,IAAI;gBAClE,MAAM,CAAC,IAAI;;;;eAIZ,MAAM,CAAC,IAAI;;yBAED,MAAM,CAAC,IAAI;;;EAGlC,MAAM,CAAC,IAAI;;;8EAGiE,MAAM,CAAC,IAAI;;;EAGvF,MAAM,CAAC,IAAI;;;+CAGkC,MAAM,CAAC,IAAI;;;EAGxD,MAAM,CAAC,IAAI;;;;;;;;2BAQc,MAAM,CAAC,IAAI;;;EAGpC,MAAM,CAAC,IAAI;;;;;;EAMX,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;EAgBX,MAAM,CAAC,IAAI;;;;0BAIa,MAAM,CAAC,IAAI;;;;;;EAMnC,MAAM,CAAC,IAAI;;;;;;;mJAOsI,MAAM,CAAC,IAAI;;;;;;;EAO5J,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CX,MAAM,CAAC,IAAI;;;;;sCAKyB,MAAM,CAAC,IAAI;;;2CAGN,MAAM,CAAC,IAAI;;;;EAIpD,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCZ,CAAC;AACF,CAAC"}
+{"version":3,"file":"readme.js","sourceRoot":"","sources":["../../src/templates/readme.ts"],"names":[],"mappings":"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"}

package/dist/templates/setup-script.d.ts

@@ -1,6 +1,6 @@
 import type { AgentConfig } from '../types.js';
 /**
  * Generate a scripts/setup.sh for the scaffolded agent.
- * Handles: Node.js check, build, Claude Code MCP server registration.
+ * Handles: Node.js check, build, and host-specific MCP registration.
  */
 export declare function generateSetupScript(config: AgentConfig): string;

package/dist/templates/setup-script.js

@@ -1,50 +1,21 @@
 /**
  * Generate a scripts/setup.sh for the scaffolded agent.
- * Handles: Node.js check, build, Claude Code MCP server registration.
+ * Handles: Node.js check, build, and host-specific MCP registration.
  */
 export function generateSetupScript(config) {
-    return `#!/usr/bin/env bash
-set -euo pipefail
-
-AGENT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-AGENT_NAME="${config.id}"
-
-echo "=== ${config.name} Setup ==="
-echo ""
-
-# Check Node.js
-if ! command -v node &>/dev/null; then
-  echo "Error: Node.js is not installed. Install Node.js 18+ first."
-  exit 1
-fi
-
-NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
-if [ "$NODE_VERSION" -lt 18 ]; then
-  echo "Error: Node.js 18+ required (found v$(node -v))."
-  exit 1
-fi
-echo "[ok] Node.js $(node -v)"
-
-# Check if built
-if [ ! -f "$AGENT_DIR/dist/index.js" ]; then
-  echo ""
-  echo "Building ${config.name}..."
-  cd "$AGENT_DIR"
-  npm install
-  npm run build
-  echo "[ok] Built successfully"
-else
-  echo "[ok] Already built"
-fi
-
+    const setupTarget = config.setupTarget ?? 'claude';
+    const claudeSetup = setupTarget === 'claude' || setupTarget === 'both';
+    const codexSetup = setupTarget === 'codex' || setupTarget === 'both';
+    const hostLabel = claudeSetup && codexSetup ? 'Claude Code + Codex' : claudeSetup ? 'Claude Code' : 'Codex';
+    const claudeSection = claudeSetup
+        ? `
 # Check Claude Code
 if ! command -v claude &>/dev/null; then
   echo ""
   echo "Warning: 'claude' command not found."
   echo "Install Claude Code first: https://docs.anthropic.com/en/docs/claude-code"
   echo ""
-  echo "After installing, add ${config.name} manually to ~/.claude/settings.json"
-  echo "(see README.md for the JSON config)"
+  echo "After installing, re-run this setup script."
   exit 1
 fi
 echo "[ok] Claude Code found"
@@ -52,14 +23,13 @@ echo "[ok] Claude Code found"
 # Register MCP server with Claude Code
 echo ""
 echo "Registering ${config.name} with Claude Code..."
-
 claude mcp add --scope user "$AGENT_NAME" -- node "$AGENT_DIR/dist/index.js"
-echo "[ok] Registered ${config.name} as MCP server"
+echo "[ok] Registered ${config.name} as MCP server (Claude Code)"
 
 # Configure PreCompact hook for session capture
 SETTINGS_FILE="$HOME/.claude/settings.json"
 echo ""
-echo "Configuring session capture hook..."
+echo "Configuring Claude session capture hook..."
 
 if [ ! -d "$HOME/.claude" ]; then
   mkdir -p "$HOME/.claude"
@@ -83,7 +53,6 @@ else
   if grep -q "PreCompact" "$SETTINGS_FILE" 2>/dev/null; then
     echo "[ok] PreCompact hook already configured — skipping"
   else
-    # Use node to safely merge hook into existing settings
     node -e "
       const fs = require('fs');
       const settings = JSON.parse(fs.readFileSync('$SETTINGS_FILE', 'utf-8'));
@@ -105,7 +74,7 @@ COMMANDS_DIR="$HOME/.claude/commands"
 
 if [ -d "$SKILLS_DIR" ]; then
   echo ""
-  echo "Installing skills..."
+  echo "Installing skills for Claude Code..."
   mkdir -p "$COMMANDS_DIR"
   skill_installed=0
   skill_skipped=0
@@ -122,11 +91,13 @@ if [ -d "$SKILLS_DIR" ]; then
       skill_installed=$((skill_installed + 1))
     fi
   done
-  echo "[ok] Skills: $skill_installed installed, $skill_skipped already present"
+  echo "[ok] Claude skills: $skill_installed installed, $skill_skipped already present"
 fi
-
-${config.hookPacks?.length
-        ? `# Install hook packs to global ~/.claude/
+`
+        : '';
+    const hookPackSection = claudeSetup && config.hookPacks?.length
+        ? `
+# Install hook packs to global ~/.claude/
 AGENT_CLAUDE_DIR="$AGENT_DIR/.claude"
 GLOBAL_CLAUDE_DIR="$HOME/.claude"
 
@@ -148,16 +119,127 @@ if [ -d "$AGENT_CLAUDE_DIR" ]; then
   done
   echo "[ok] Hooks: $installed installed, $skipped already present"
 fi
-
 `
-        : ''}echo ""
-echo "=== Setup Complete ==="
+        : '';
+    const codexSection = codexSetup
+        ? `
+# Register MCP server with Codex
 echo ""
-echo "Next:"
-echo "  1. Start a new Claude Code session (or restart if one is open)"
-echo "  2. Say: \\"Hello, ${config.name}!\\""
+echo "Registering ${config.name} with Codex..."
+mkdir -p "$HOME/.codex"
+CODEX_CONFIG="$HOME/.codex/config.toml"
+AGENT_DIST="$AGENT_DIR/dist/index.js"
+
+CODEX_CONFIG="$CODEX_CONFIG" AGENT_NAME="$AGENT_NAME" AGENT_DIST="$AGENT_DIST" node <<'NODE'
+const fs = require('node:fs');
+const path = process.env.CODEX_CONFIG;
+const agentName = process.env.AGENT_NAME;
+const distPath = process.env.AGENT_DIST;
+
+let content = '';
+if (fs.existsSync(path)) {
+  content = fs.readFileSync(path, 'utf-8');
+}
+
+const header = '[mcp_servers.' + agentName + ']';
+const block = header + '\\ncommand = "node"\\nargs = ["' + distPath + '"]\\n';
+const start = content.indexOf(header);
+
+if (start === -1) {
+  const trimmed = content.trimEnd();
+  content = trimmed.length === 0 ? block + '\\n' : trimmed + '\\n\\n' + block + '\\n';
+} else {
+  const afterHeader = start + header.length;
+  const tail = content.slice(afterHeader);
+  const nextSectionOffset = tail.search(/\\n\\[[^\\]]+\\]/);
+  const end = nextSectionOffset === -1 ? content.length : afterHeader + nextSectionOffset;
+  content = content.slice(0, start).trimEnd() + '\\n\\n' + block + '\\n' + content.slice(end).trimStart();
+}
+
+content = content.replace(/\\n{3,}/g, '\\n\\n');
+fs.writeFileSync(path, content, 'utf-8');
+NODE
+echo "[ok] Registered ${config.name} as MCP server (Codex)"
+
+# Install skills to ~/.codex/skills/
+SKILLS_DIR="$AGENT_DIR/skills"
+CODEX_SKILLS_DIR="$HOME/.codex/skills"
+
+if [ -d "$SKILLS_DIR" ]; then
+  echo ""
+  echo "Installing skills for Codex..."
+  mkdir -p "$CODEX_SKILLS_DIR"
+  skill_installed=0
+  skill_skipped=0
+  for skill_dir in "$SKILLS_DIR"/*/; do
+    [ -d "$skill_dir" ] || continue
+    skill_file="$skill_dir/SKILL.md"
+    [ -f "$skill_file" ] || continue
+    skill_name="$(basename "$skill_dir")"
+    dest_dir="$CODEX_SKILLS_DIR/$AGENT_NAME-$skill_name"
+    dest_file="$dest_dir/SKILL.md"
+    if [ -f "$dest_file" ]; then
+      skill_skipped=$((skill_skipped + 1))
+    else
+      mkdir -p "$dest_dir"
+      cp "$skill_file" "$dest_file"
+      skill_installed=$((skill_installed + 1))
+    fi
+  done
+  echo "[ok] Codex skills: $skill_installed installed, $skill_skipped already present"
+fi
+`
+        : '';
+    const nextSteps = [
+        'echo ""',
+        'echo "=== Setup Complete ==="',
+        'echo ""',
+        'echo "Next:"',
+        ...(claudeSetup
+            ? ['echo "  - Start a new Claude Code session (or restart if one is open)"']
+            : []),
+        ...(codexSetup ? ['echo "  - Start a new Codex session (or restart if one is open)"'] : []),
+        `echo "  - Say: \\"Hello, ${config.name}!\\""`,
+        'echo ""',
+        `echo "${config.name} is ready."`,
+    ].join('\n');
+    return `#!/usr/bin/env bash
+set -euo pipefail
+
+AGENT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+AGENT_NAME="${config.id}"
+
+echo "=== ${config.name} Setup (${hostLabel}) ==="
 echo ""
-echo "${config.name} will activate and guide you from there."
+
+# Check Node.js
+if ! command -v node &>/dev/null; then
+  echo "Error: Node.js is not installed. Install Node.js 18+ first."
+  exit 1
+fi
+
+NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+  echo "Error: Node.js 18+ required (found v$(node -v))."
+  exit 1
+fi
+echo "[ok] Node.js $(node -v)"
+
+# Check if built
+if [ ! -f "$AGENT_DIR/dist/index.js" ]; then
+  echo ""
+  echo "Building ${config.name}..."
+  cd "$AGENT_DIR"
+  npm install
+  npm run build
+  echo "[ok] Built successfully"
+else
+  echo "[ok] Already built"
+fi
+${claudeSection}
+${hookPackSection}
+${codexSection}
+${nextSteps}
 `;
 }
 //# sourceMappingURL=setup-script.js.map

package/dist/templates/setup-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-script.js","sourceRoot":"","sources":["../../src/templates/setup-script.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,OAAO;;;;cAIK,MAAM,CAAC,EAAE;;YAEX,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;mBAmBJ,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;gCAeE,MAAM,CAAC,IAAI;;;;;;;;oBAQvB,MAAM,CAAC,IAAI;;;wBAGP,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;uFAkBoD,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;qFAmBX,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC5F,MAAM,CAAC,SAAS,EAAE,MAAM;QACtB,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBL;QACG,CAAC,CAAC,EACN;;;;;4BAK4B,MAAM,CAAC,IAAI;;QAE/B,MAAM,CAAC,IAAI;CAClB,CAAC;AACF,CAAC"}
+{"version":3,"file":"setup-script.js","sourceRoot":"","sources":["../../src/templates/setup-script.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC;IACnD,MAAM,WAAW,GAAG,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,MAAM,CAAC;IACvE,MAAM,UAAU,GAAG,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,MAAM,CAAC;IACrE,MAAM,SAAS,GACb,WAAW,IAAI,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5F,MAAM,aAAa,GAAG,WAAW;QAC/B,CAAC,CAAC;;;;;;;;;;;;;;oBAcc,MAAM,CAAC,IAAI;;wBAEP,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;uFAkBoD,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;qFAkBX,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC7F;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,eAAe,GACnB,WAAW,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM;QACrC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBP;QACK,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,YAAY,GAAG,UAAU;QAC7B,CAAC,CAAC;;;oBAGc,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkCP,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BlC;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,SAAS,GAAG;QAChB,SAAS;QACT,+BAA+B;QAC/B,SAAS;QACT,cAAc;QACd,GAAG,CAAC,WAAW;YACb,CAAC,CAAC,CAAC,wEAAwE,CAAC;YAC5E,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,4BAA4B,MAAM,CAAC,IAAI,OAAO;QAC9C,SAAS;QACT,SAAS,MAAM,CAAC,IAAI,aAAa;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;;;;cAIK,MAAM,CAAC,EAAE;;YAEX,MAAM,CAAC,IAAI,WAAW,SAAS;;;;;;;;;;;;;;;;;;;mBAmBxB,MAAM,CAAC,IAAI;;;;;;;;EAQ5B,aAAa;EACb,eAAe;EACf,YAAY;EACZ,SAAS;CACV,CAAC;AACF,CAAC"}

package/dist/templates/skills.d.ts

@@ -9,10 +9,3 @@ import type { AgentConfig } from '../types.js';
  * - Engine-adapted skills: YOUR_AGENT_core → {config.id}_core
  */
 export declare function generateSkills(config: AgentConfig): Array<[string, string]>;
-/**
- * List all bundled skill names with their descriptions (from YAML frontmatter).
- */
-export declare function listSkillDescriptions(): Array<{
-    name: string;
-    description: string;
-}>;

package/dist/templates/skills.js

@@ -57,25 +57,4 @@ export function generateSkills(config) {
     }
     return files;
 }
-/**
- * List all bundled skill names with their descriptions (from YAML frontmatter).
- */
-export function listSkillDescriptions() {
-    let skillFiles;
-    try {
-        skillFiles = readdirSync(SKILLS_DIR).filter((f) => f.endsWith('.md'));
-    }
-    catch {
-        return [];
-    }
-    return skillFiles.map((file) => {
-        const content = readFileSync(join(SKILLS_DIR, file), 'utf-8');
-        const nameMatch = content.match(/^name:\s*(.+)$/m);
-        const descMatch = content.match(/^description:\s*"?(.+?)"?\s*$/m);
-        return {
-            name: nameMatch?.[1]?.trim() ?? file.replace('.md', ''),
-            description: descMatch?.[1]?.trim() ?? '',
-        };
-    });
-}
 //# sourceMappingURL=skills.js.map

package/dist/templates/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/templates/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/templates/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEnD,wFAAwF;AACxF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,eAAe;IACf,eAAe;IACf,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,sBAAsB;IACtB,yBAAyB;IACzB,eAAe;IACf,iBAAiB;IACjB,gCAAgC;IAChC,eAAe;CAChB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,UAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2DAA2D;IAC3D,gEAAgE;IAChE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,uCAAuC;IAE5G,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAE1C,IAAI,aAAa,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnD,SAAS;QACX,CAAC;QAED,IAAI,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,SAAS,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/templates/telegram-agent.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Template: Telegram agent loop — wires @soleri/core agent loop to MCP tools.
+ * Generated by @soleri/forge for agents with Telegram transport.
+ */
+import type { AgentConfig } from '../types.js';
+export declare function generateTelegramAgent(config: AgentConfig): string;