@soleri/forge 5.11.0 → 5.12.0

package/dist/templates/telegram-config.js

@@ -0,0 +1,81 @@
+/**
+ * Template: Telegram configuration module.
+ * Generated by @soleri/forge for agents with Telegram transport.
+ */
+export function generateTelegramConfig(config) {
+    return `/**
+ * Telegram Configuration — env + file-based config loading.
+ * Generated by @soleri/forge.
+ */
+
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+export interface TelegramConfig {
+  /** Telegram bot token (from @BotFather). */
+  botToken: string;
+  /** Anthropic API key. */
+  apiKey: string;
+  /** Claude model to use. Default: 'claude-sonnet-4-20250514'. */
+  model?: string;
+  /** Working directory for the agent. Default: cwd. */
+  workingDirectory?: string;
+  /** Allowed user IDs (empty = any authenticated user). */
+  allowedUsers?: number[];
+  /** Auth passphrase. If unset, auth is disabled. */
+  passphrase?: string;
+  /** Max output tokens per LLM call. Default: 16384. */
+  maxTokens?: number;
+  /** Max agent loop iterations. Default: 200. */
+  maxIterations?: number;
+}
+
+const CONFIG_DIR = join(homedir(), '.${config.id}');
+const CONFIG_FILE = join(CONFIG_DIR, 'telegram.json');
+
+/**
+ * Load Telegram config from environment variables and config file.
+ * Environment variables take priority over file-based config.
+ */
+export function loadTelegramConfig(): TelegramConfig {
+  let fileConfig: Partial<TelegramConfig> = {};
+
+  if (existsSync(CONFIG_FILE)) {
+    try {
+      fileConfig = JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+    } catch {
+      console.error('[config] Failed to parse telegram.json, using defaults');
+    }
+  }
+
+  const botToken = process.env.TELEGRAM_BOT_TOKEN ?? fileConfig.botToken ?? '';
+  const apiKey =
+    process.env.ANTHROPIC_API_KEY ?? fileConfig.apiKey ?? '';
+
+  if (!botToken) {
+    throw new Error(
+      'Missing TELEGRAM_BOT_TOKEN. Set via environment or ~/.${config.id}/telegram.json',
+    );
+  }
+  if (!apiKey) {
+    throw new Error(
+      'Missing ANTHROPIC_API_KEY. Set via environment or ~/.${config.id}/telegram.json',
+    );
+  }
+
+  return {
+    botToken,
+    apiKey,
+    model: process.env.ANTHROPIC_MODEL ?? fileConfig.model ?? 'claude-sonnet-4-20250514',
+    workingDirectory:
+      process.env.AGENT_WORKING_DIR ?? fileConfig.workingDirectory ?? process.cwd(),
+    allowedUsers: fileConfig.allowedUsers ?? [],
+    passphrase: fileConfig.passphrase,
+    maxTokens: fileConfig.maxTokens ?? 16384,
+    maxIterations: fileConfig.maxIterations ?? 200,
+  };
+}
+`;
+}
+//# sourceMappingURL=telegram-config.js.map

package/dist/templates/telegram-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-config.js","sourceRoot":"","sources":["../../src/templates/telegram-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA4B8B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;+DAwBe,MAAM,CAAC,EAAE;;;;;8DAKV,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;CAgBtE,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Template: Telegram supervisor — process management with restart and logging.
+ * Generated by @soleri/forge for agents with Telegram transport.
+ */
+import type { AgentConfig } from '../types.js';
+export declare function generateTelegramSupervisor(config: AgentConfig): string;

package/dist/templates/telegram-supervisor.js

@@ -0,0 +1,148 @@
+/**
+ * Template: Telegram supervisor — process management with restart and logging.
+ * Generated by @soleri/forge for agents with Telegram transport.
+ */
+export function generateTelegramSupervisor(config) {
+    return `/**
+ * ${config.name} — Telegram Bot Supervisor.
+ * Generated by @soleri/forge.
+ *
+ * Wraps the bot process with:
+ * - Restart on crash (exponential backoff)
+ * - Restart on self-update (exit code 75)
+ * - Graceful shutdown (SIGINT/SIGTERM)
+ * - Log rotation
+ */
+
+import { spawn } from 'node:child_process';
+import { mkdirSync, appendFileSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const LOG_DIR = join(homedir(), '.${config.id}', 'logs');
+const MAX_LOG_AGE_DAYS = 7;
+const SELF_UPDATE_EXIT_CODE = 75;
+
+// Exponential backoff: 1s, 2s, 4s, 8s, 16s, 30s max
+const MIN_RESTART_DELAY = 1000;
+const MAX_RESTART_DELAY = 30_000;
+
+let restartCount = 0;
+let shutdownRequested = false;
+
+function log(message: string): void {
+  const ts = new Date().toISOString();
+  const line = \`[\${ts}] [supervisor] \${message}\`;
+  console.log(line);
+  try {
+    mkdirSync(LOG_DIR, { recursive: true });
+    const date = ts.split('T')[0];
+    appendFileSync(join(LOG_DIR, \`telegram-\${date}.log\`), line + '\\n', 'utf-8');
+  } catch {
+    // Log write failure is non-critical
+  }
+}
+
+function rotateLogs(): void {
+  try {
+    const cutoff = Date.now() - MAX_LOG_AGE_DAYS * 24 * 60 * 60 * 1000;
+    const files = readdirSync(LOG_DIR);
+    for (const file of files) {
+      if (!file.startsWith('telegram-') && !file.startsWith('events-')) continue;
+      const filePath = join(LOG_DIR, file);
+      try {
+        const stat = statSync(filePath);
+        if (stat.mtimeMs < cutoff) {
+          rmSync(filePath);
+          log(\`Rotated old log: \${file}\`);
+        }
+      } catch {
+        // Skip files we can't stat
+      }
+    }
+  } catch {
+    // Rotation failure is non-critical
+  }
+}
+
+function getRestartDelay(): number {
+  const delay = Math.min(MIN_RESTART_DELAY * Math.pow(2, restartCount), MAX_RESTART_DELAY);
+  return delay;
+}
+
+function startBot(): void {
+  rotateLogs();
+  log(\`Starting bot (attempt \${restartCount + 1})...\`);
+
+  const child = spawn('node', [join(process.cwd(), 'dist', 'telegram-bot.js')], {
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+
+  child.on('exit', (code, signal) => {
+    if (shutdownRequested) {
+      log('Bot stopped (shutdown requested).');
+      process.exit(0);
+    }
+
+    if (code === SELF_UPDATE_EXIT_CODE) {
+      log('Bot requested self-update restart. Rebuilding...');
+      restartCount = 0;
+      try {
+        const { execFileSync } = require('node:child_process');
+        execFileSync('npm', ['run', 'build'], { cwd: process.cwd(), stdio: 'pipe', timeout: 60_000 });
+        log('Rebuild succeeded. Restarting...');
+      } catch (buildErr: unknown) {
+        const buildMsg = buildErr instanceof Error ? buildErr.message : String(buildErr);
+        log(\`Rebuild failed: \${buildMsg}. Attempting rollback...\`);
+        try {
+          const { execFileSync: execFile2 } = require('node:child_process');
+          execFile2('git', ['revert', 'HEAD', '--no-edit'], { cwd: process.cwd(), stdio: 'pipe', timeout: 30_000 });
+          execFile2('npm', ['run', 'build'], { cwd: process.cwd(), stdio: 'pipe', timeout: 60_000 });
+          log('Rollback succeeded. Restarting with previous code...');
+        } catch {
+          log('Rollback also failed. Restarting with current code anyway...');
+        }
+      }
+      setTimeout(startBot, 1000);
+      return;
+    }
+
+    if (code === 0) {
+      log('Bot exited cleanly.');
+      process.exit(0);
+    }
+
+    restartCount++;
+    const delay = getRestartDelay();
+    log(\`Bot exited with code \${code ?? signal}. Restarting in \${delay}ms...\`);
+    setTimeout(startBot, delay);
+  });
+
+  child.on('error', (err) => {
+    log(\`Failed to start bot: \${err.message}\`);
+    restartCount++;
+    const delay = getRestartDelay();
+    setTimeout(startBot, delay);
+  });
+
+  // Reset backoff after 60 seconds of successful running
+  setTimeout(() => {
+    if (!shutdownRequested) restartCount = 0;
+  }, 60_000);
+}
+
+// Graceful shutdown
+process.on('SIGINT', () => {
+  shutdownRequested = true;
+  log('SIGINT received, shutting down...');
+});
+process.on('SIGTERM', () => {
+  shutdownRequested = true;
+  log('SIGTERM received, shutting down...');
+});
+
+startBot();
+`;
+}
+//# sourceMappingURL=telegram-supervisor.js.map

package/dist/templates/telegram-supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-supervisor.js","sourceRoot":"","sources":["../../src/templates/telegram-supervisor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,0BAA0B,CAAC,MAAmB;IAC5D,OAAO;KACJ,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;oCAeoB,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4H5C,CAAC;AACF,CAAC"}

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-/** Communication tone for the agent persona */
-export declare const TONES: readonly ["precise", "mentor", "pragmatic"];
-export type Tone = (typeof TONES)[number];
+/** Where to scaffold host/client integration setup. */
+export declare const SETUP_TARGETS: readonly ["claude", "codex", "both"];
+export type SetupTarget = (typeof SETUP_TARGETS)[number];
 /** Agent configuration — everything needed to scaffold */
 export declare const AgentConfigSchema: z.ZodObject<{
     /** Agent identifier (kebab-case, used for directory and package name) */
@@ -26,21 +26,27 @@ export declare const AgentConfigSchema: z.ZodObject<{
     hookPacks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Skills to include (if omitted, all skills are included for backward compat) */
     skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** AI client setup target: Claude Code, Codex, or both */
+    setupTarget: z.ZodDefault<z.ZodOptional<z.ZodEnum<["claude", "codex", "both"]>>>;
+    /** Enable Telegram transport scaffolding. Default: false. */
+    telegram: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     id: string;
+    name: string;
     role: string;
     description: string;
     domains: string[];
     principles: string[];
     tone: "precise" | "mentor" | "pragmatic";
     outputDir: string;
+    setupTarget: "claude" | "codex" | "both";
+    telegram: boolean;
     greeting?: string | undefined;
     hookPacks?: string[] | undefined;
     skills?: string[] | undefined;
 }, {
-    name: string;
     id: string;
+    name: string;
     role: string;
     description: string;
     domains: string[];
@@ -50,6 +56,8 @@ export declare const AgentConfigSchema: z.ZodObject<{
     outputDir?: string | undefined;
     hookPacks?: string[] | undefined;
     skills?: string[] | undefined;
+    setupTarget?: "claude" | "codex" | "both" | undefined;
+    telegram?: boolean | undefined;
 }>;
 export type AgentConfig = z.infer<typeof AgentConfigSchema>;
 /** Result of scaffolding */

package/dist/types.js

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 /** Communication tone for the agent persona */
-export const TONES = ['precise', 'mentor', 'pragmatic'];
+const TONES = ['precise', 'mentor', 'pragmatic'];
+/** Where to scaffold host/client integration setup. */
+export const SETUP_TARGETS = ['claude', 'codex', 'both'];
 /** Agent configuration — everything needed to scaffold */
 export const AgentConfigSchema = z.object({
     /** Agent identifier (kebab-case, used for directory and package name) */
@@ -25,5 +27,9 @@ export const AgentConfigSchema = z.object({
     hookPacks: z.array(z.string()).optional(),
     /** Skills to include (if omitted, all skills are included for backward compat) */
     skills: z.array(z.string()).optional(),
+    /** AI client setup target: Claude Code, Codex, or both */
+    setupTarget: z.enum(SETUP_TARGETS).optional().default('claude'),
+    /** Enable Telegram transport scaffolding. Default: false. */
+    telegram: z.boolean().optional().default(false),
 });
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+CAA+C;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAGjE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,yEAAyE;IACzE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;IAC3F,kCAAkC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,gCAAgC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,iDAAiD;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACxC,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClD,0DAA0D;IAC1D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,wDAAwD;IACxD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACnD,gFAAgF;IAChF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,oFAAoF;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9D,yDAAyD;IACzD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,kFAAkF;IAClF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+CAA+C;AAC/C,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAE1D,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAGlE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,yEAAyE;IACzE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;IAC3F,kCAAkC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,gCAAgC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,iDAAiD;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACxC,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClD,0DAA0D;IAC1D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,wDAAwD;IACxD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACnD,gFAAgF;IAChF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,oFAAoF;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9D,yDAAyD;IACzD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,kFAAkF;IAClF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,0DAA0D;IAC1D,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/D,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAChD,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.11.0",
+  "version": "5.12.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",

package/src/__tests__/scaffolder.test.ts

@@ -379,4 +379,66 @@ describe('Scaffolder', () => {
       expect(agents).toEqual([]);
     });
   });
+
+  describe('telegram scaffolding', () => {
+    const telegramConfig: AgentConfig = {
+      ...testConfig,
+      telegram: true,
+    };
+
+    it('should include telegram files in preview', () => {
+      telegramConfig.outputDir = tempDir;
+      const preview = previewScaffold(telegramConfig);
+      const paths = preview.files.map((f) => f.path);
+      expect(paths).toContain('src/telegram-bot.ts');
+      expect(paths).toContain('src/telegram-config.ts');
+      expect(paths).toContain('src/telegram-agent.ts');
+      expect(paths).toContain('src/telegram-supervisor.ts');
+    });
+
+    it('should not include telegram files without flag', () => {
+      const preview = previewScaffold(testConfig);
+      const paths = preview.files.map((f) => f.path);
+      expect(paths).not.toContain('src/telegram-bot.ts');
+    });
+
+    it('should generate telegram source files', () => {
+      telegramConfig.outputDir = tempDir;
+      const result = scaffold(telegramConfig);
+      // Build may fail (grammy not installed) but files should be created
+      expect(result.filesCreated).toContain('src/telegram-bot.ts');
+      expect(result.filesCreated).toContain('src/telegram-config.ts');
+      expect(result.filesCreated).toContain('src/telegram-agent.ts');
+      expect(result.filesCreated).toContain('src/telegram-supervisor.ts');
+
+      // Verify file contents reference the agent
+      const botContent = readFileSync(join(tempDir, 'atlas', 'src', 'telegram-bot.ts'), 'utf-8');
+      expect(botContent).toContain('Atlas');
+      expect(botContent).toContain('grammy');
+
+      const configContent = readFileSync(
+        join(tempDir, 'atlas', 'src', 'telegram-config.ts'),
+        'utf-8',
+      );
+      expect(configContent).toContain('.atlas');
+      expect(configContent).toContain('TELEGRAM_BOT_TOKEN');
+    });
+
+    it('should include grammy dependency in package.json', () => {
+      telegramConfig.outputDir = tempDir;
+      scaffold(telegramConfig);
+      const pkg = JSON.parse(readFileSync(join(tempDir, 'atlas', 'package.json'), 'utf-8'));
+      expect(pkg.dependencies.grammy).toBeDefined();
+      expect(pkg.scripts['telegram:start']).toBeDefined();
+      expect(pkg.scripts['telegram:dev']).toBeDefined();
+    });
+
+    it('should not include grammy without telegram flag', () => {
+      const result = scaffold(testConfig);
+      if (result.success) {
+        const pkg = JSON.parse(readFileSync(join(tempDir, 'atlas', 'package.json'), 'utf-8'));
+        expect(pkg.dependencies.grammy).toBeUndefined();
+      }
+    });
+  });
 });

package/src/facades/forge.facade.ts

@@ -112,15 +112,15 @@ export const forgeOps: OpDef[] = [
           {
             step: 6,
             action: 'Create the agent',
-            ask: 'Call create with the confirmed config. The agent is auto-built (npm install + build) and MCP server is registered in ~/.claude.json automatically.',
+            ask: 'Call create with the confirmed config. The agent is auto-built (npm install + build) and MCP server registration is applied automatically for the selected setup target (Claude, Codex, or both).',
           },
           {
             step: 7,
             action: 'Next steps',
             suggest: [
-              'Restart Claude Code so the new MCP server is picked up',
+              'Restart your selected host client(s) so the new MCP server is picked up',
               'Say "Hello, {AgentName}!" to activate the persona in any session',
-              'The agent will check setup status and offer to inject its CLAUDE.md sections',
+              'For Claude setup, the agent can check setup status and inject CLAUDE.md sections',
               'Add initial knowledge by creating entries in the intelligence data JSON files',
               'Or use the agent and capture knowledge via the capture ops as you work',
             ],

package/src/lib.ts

@@ -10,11 +10,12 @@ export { addDomain } from './domain-manager.js';
 export { patchIndexTs, patchClaudeMdContent } from './patching.js';
 export type {
   AgentConfig,
+  SetupTarget,
   ScaffoldResult,
   ScaffoldPreview,
   AgentInfo,
   InstallKnowledgeResult,
   AddDomainResult,
 } from './types.js';
-export { AgentConfigSchema } from './types.js';
+export { AgentConfigSchema, SETUP_TARGETS } from './types.js';
 export { generateExtensionsIndex, generateExampleOp } from './templates/extensions.js';