@alejandroroman/agent-kit 0.1.3 → 0.2.0

package/dist/cli/chat.js

@@ -1,14 +1,10 @@
-import * as readline from "readline";
-import * as path from "path";
 import { loadConfig } from "../config/index.js";
-import { buildAgentRuntime, buildSystemPrompt } from "../bootstrap.js";
-import { runAgentLoop } from "../agent/loop.js";
-import { compactMessages } from "../session/compaction.js";
+import { buildAgentRuntime } from "../bootstrap.js";
 import { ensureOllama } from "./ollama.js";
 import { resolveApiKey } from "./ui.js";
-const CONFIG_PATH = path.join(process.cwd(), "agent-kit.json");
-const DATA_DIR = path.join(process.cwd(), "data");
-const SKILLS_DIR = path.join(process.cwd(), "skills");
+import { showWhatsNew } from "./whats-new.js";
+import { CONFIG_PATH, DATA_DIR, SKILLS_DIR } from "./paths.js";
+import { startRepl } from "./repl.js";
 export async function chat(agentName) {
     if (!agentName) {
         const config = loadConfig(CONFIG_PATH);
@@ -24,20 +20,20 @@ export async function chat(agentName) {
         }
     }
     await resolveApiKey({ save: false });
+    showWhatsNew();
     const config = loadConfig(CONFIG_PATH);
     if (!config.agents[agentName]) {
         const names = Object.keys(config.agents).join(", ");
         console.error(`Agent "${agentName}" not found. Available: ${names}`);
         process.exit(1);
     }
-    // Warn if Ollama isn't running (memory tools won't work)
     if (config.defaults.memory) {
         const ollama = await ensureOllama();
         if (!ollama.running) {
             console.log("  (Ollama not running — memory tools unavailable)\n");
         }
     }
-    const runtime = buildAgentRuntime(agentName, config, {
+    const runtime = await buildAgentRuntime(agentName, config, {
         dataDir: DATA_DIR,
         skillsDir: SKILLS_DIR,
     });
@@ -54,58 +50,17 @@ export async function chat(agentName) {
     }
     console.log(`  Commands: /new (reset), /quit`);
     console.log();
-    let messages = session.getMessages();
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
+    startRepl({
+        agentName,
+        model: resolved.model,
+        fallbacks: resolved.fallbacks,
+        maxIterations: resolved.maxIterations,
+        compactionThreshold: resolved.compactionThreshold,
+        maxToolResultSize: resolved.maxToolResultSize,
+        toolRegistry,
+        session,
+        soul,
+        skillsIndex,
+        promptFragments,
     });
-    const ask = () => {
-        rl.question("You: ", async (input) => {
-            const trimmed = input.trim();
-            if (trimmed === "/quit") {
-                rl.close();
-                return;
-            }
-            if (trimmed === "/new") {
-                messages = [];
-                console.log("  Session reset.\n");
-                ask();
-                return;
-            }
-            if (!trimmed) {
-                ask();
-                return;
-            }
-            const userMsg = { role: "user", content: trimmed };
-            messages.push(userMsg);
-            session.append(userMsg);
-            messages = await compactMessages(messages, resolved.model, resolved.compactionThreshold);
-            try {
-                const systemPrompt = buildSystemPrompt(soul, skillsIndex, promptFragments);
-                const result = await runAgentLoop(messages, {
-                    model: resolved.model,
-                    fallbacks: resolved.fallbacks,
-                    systemPrompt,
-                    toolRegistry,
-                    maxIterations: resolved.maxIterations,
-                    compactionThreshold: resolved.compactionThreshold,
-                    maxToolResultSize: resolved.maxToolResultSize,
-                    agentName,
-                    source: "cli",
-                });
-                const newMessages = result.messages.slice(messages.length - 1);
-                for (const msg of newMessages) {
-                    session.append(msg);
-                }
-                messages = result.messages;
-                console.log(`\nAgent: ${result.text}`);
-                console.log(`  (${result.usage.inputTokens + result.usage.outputTokens} tokens)\n`);
-            }
-            catch (err) {
-                console.error(`\n  Error: ${err instanceof Error ? err.message : err}\n`);
-            }
-            ask();
-        });
-    };
-    ask();
 }

package/dist/cli/claude-md-template.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLAUDE.md template generated by `agent-kit init`.
+ * Gives any Claude Code session full context for working on this project.
+ */
+export declare const CLAUDE_MD_TEMPLATE = "# Agent Kit Project\n\nPersonal AI agent framework \u2014 multi-model agent loop with Slack gateway, cron scheduling, skills, and tool sandboxing.\n\nPowered by [`@alejandroroman/agent-kit`](https://www.npmjs.com/package/@alejandroroman/agent-kit).\n\n## Run Commands\n\n- `pnpm start` \u2014 start all services (cron, Slack, heartbeat, REPL)\n- `pnpm chat` \u2014 lightweight single-agent chat\n- `pnpm create` \u2014 AI-powered agent creation wizard\n\n## Project Layout\n\n```\nagent-kit.json     # Main config \u2014 agents, cron jobs, models, defaults\n.env               # Secrets (API keys, Slack tokens)\ndata/              # Runtime data (per-agent sessions, SOUL.md files, DBs)\n  agents/<name>/\n    SOUL.md        # Agent personality / system prompt\n    sessions/      # JSONL conversation logs\nskills/            # Custom skill definitions\n  <skill-name>/\n    skill.json     # Manifest (name, description, tools list)\n    SKILL.md       # Instructions injected when skill is activated\n    tools/         # Tool implementations (TypeScript)\n```\n\n## Configuration (agent-kit.json)\n\n### Models\n\n```json\n\"models\": [\n  { \"model\": \"anthropic:claude-sonnet-4-6\", \"alias\": \"sonnet\" },\n  { \"model\": \"anthropic:claude-haiku-4-5-20251001\", \"alias\": \"haiku\" }\n]\n```\n\nAgents reference models by alias. The framework handles automatic fallback between models on rate limits/server errors.\n\n### Agent Definition\n\n```json\n\"agents\": {\n  \"my-agent\": {\n    \"displayName\": \"My Agent\",\n    \"emoji\": \"\uD83E\uDD16\",\n    \"model\": \"sonnet\",\n    \"tools\": [\"read_file\", \"write_file\", \"web_search\"],\n    \"skills\": [\"my-skill\"],\n    \"sandbox\": { \"allowedPaths\": [\"data/agents/my-agent/\"] },\n    \"slack\": { \"channelId\": \"C0XXX\", \"channelName\": \"#my-channel\" },\n    \"heartbeat\": { \"enabled\": true, \"intervalMinutes\": 60, \"model\": \"haiku\" },\n    \"can_spawn\": [{ \"agent\": \"helper\", \"tool\": \"delegate\", \"description\": \"...\" }]\n  }\n}\n```\n\n**Key fields:**\n- `tools` \u2014 builtin tools the agent can use (see list below)\n- `skills` \u2014 skill directories to make available via `activate_skill`\n- `sandbox` \u2014 restrict file access (`allowedPaths`) or commands (`allowedCommands`)\n- `slack` \u2014 bind agent to a Slack channel for inbound/outbound messages\n- `heartbeat` \u2014 periodic autonomous check-ins (posts to Slack if something noteworthy)\n- `spawn_only: true` \u2014 agent can only be invoked by other agents, not directly\n\n### Cron Jobs\n\n```json\n\"cron\": [\n  {\n    \"id\": \"daily-task\",\n    \"agent\": \"my-agent\",\n    \"schedule\": \"0 8 * * *\",\n    \"prompt\": \"Activate the my-skill skill. Do the daily task.\",\n    \"enabled\": true\n  }\n]\n```\n\nSchedule uses standard cron syntax. Agents must activate their skill first in the prompt.\n\n### Defaults\n\n```json\n\"defaults\": {\n  \"model\": \"sonnet\",\n  \"maxTokens\": 4096,\n  \"maxIterations\": 20,\n  \"memory\": {\n    \"dbPath\": \"./data/memory.db\",\n    \"ollamaEndpoint\": \"http://localhost:11434\",\n    \"ollamaModel\": \"all-minilm:l6-v2\"\n  }\n}\n```\n\n## Built-in Tools\n\n| Tool | Description |\n|------|-------------|\n| `read_file` | Read a file (respects sandbox allowedPaths) |\n| `write_file` | Write a file (respects sandbox allowedPaths) |\n| `run_command` | Execute a shell command (respects sandbox allowedCommands) |\n| `web_search` | Search the web (Brave or Grok provider) |\n| `store_memory` | Store a memory with content and metadata |\n| `search_memory` | Semantic search across stored memories |\n| `get_memory` | Retrieve a specific memory by ID |\n| `update_memory` | Update an existing memory |\n| `forget_memory` | Delete a memory |\n| `list_memories` | List all memories with optional filtering |\n| `update_agent_config` | Agent updates its own config (allowlisted fields) |\n| `manage_cron` | Agent manages its own cron jobs (CRUD) |\n\nMemory tools require Ollama running with `all-minilm:l6-v2` model.\n\n## Creating Skills\n\nA skill is a directory in `skills/` with:\n\n1. **`skill.json`** \u2014 manifest\n```json\n{\n  \"name\": \"my-skill\",\n  \"description\": \"What this skill does\",\n  \"tools\": [\"my_tool\"],\n  \"prompt\": \"SKILL.md\"\n}\n```\n\n2. **`SKILL.md`** \u2014 instructions injected into agent context when activated\n\n3. **`tools/<name>.ts`** \u2014 tool implementations\n```typescript\nimport type { Tool } from \"@alejandroroman/agent-kit/dist/tools/types.js\";\n\nconst tool: Tool = {\n  name: \"my_tool\",\n  description: \"What this tool does\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      input: { type: \"string\", description: \"The input\" }\n    },\n    required: [\"input\"]\n  },\n  execute: async (args) => {\n    return \"result\";\n  },\n};\n\nexport default tool;\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `ANTHROPIC_API_KEY` | Yes | Anthropic API key for Claude models |\n| `OPENAI_API_KEY` | No | OpenAI API key (for fallback models) |\n| `SLACK_BOT_TOKEN` | No | Slack bot token (xoxb-...) for gateway |\n| `SLACK_APP_TOKEN` | No | Slack app token (xapp-...) for Socket Mode |\n| `BRAVE_SEARCH_API_KEY` | No | Brave Search API key for web_search |\n| `XAI_API_KEY` | No | xAI/Grok API key for web_search |\n\n## Slack Setup\n\n1. Create a Slack app at api.slack.com/apps \u2192 From Manifest (YAML):\n```yaml\ndisplay_information:\n  name: Agent Kit\nsettings:\n  socket_mode_enabled: true\nfeatures:\n  bot_user:\n    display_name: Agent Kit\n    always_online: true\n  event_subscriptions:\n    bot_events:\n      - message.channels\n      - message.groups\noauth_config:\n  scopes:\n    bot:\n      - chat:write\n      - channels:history\n      - channels:read\n      - groups:history\n      - groups:read\n```\n2. Generate an App-Level Token (Settings \u2192 Basic Information) with `connections:write` scope \u2192 `SLACK_APP_TOKEN`\n3. Install to workspace \u2192 copy Bot Token \u2192 `SLACK_BOT_TOKEN`\n4. Create channels, invite the bot (`/invite @Agent Kit`), copy channel IDs\n5. Add `slack` binding to each agent in `agent-kit.json`\n\n## Ollama (for Memory)\n\nMemory tools use Ollama for local embeddings:\n```bash\n# Install: https://ollama.com\nollama pull all-minilm:l6-v2\n# Ollama must be running when agent-kit starts\n```\n\nIf Ollama isn't running, everything else works \u2014 memory tools are just unavailable.\n\n## pnpm v10 Note\n\nIf using pnpm v10+, native dependencies need explicit approval:\n```json\n// In package.json:\n\"pnpm\": { \"onlyBuiltDependencies\": [\"better-sqlite3\"] }\n```\nThen `pnpm install` to rebuild native bindings.\n";

package/dist/cli/claude-md-template.js

@@ -0,0 +1,220 @@
+/**
+ * CLAUDE.md template generated by `agent-kit init`.
+ * Gives any Claude Code session full context for working on this project.
+ */
+export const CLAUDE_MD_TEMPLATE = `# Agent Kit Project
+
+Personal AI agent framework — multi-model agent loop with Slack gateway, cron scheduling, skills, and tool sandboxing.
+
+Powered by [\`@alejandroroman/agent-kit\`](https://www.npmjs.com/package/@alejandroroman/agent-kit).
+
+## Run Commands
+
+- \`pnpm start\` — start all services (cron, Slack, heartbeat, REPL)
+- \`pnpm chat\` — lightweight single-agent chat
+- \`pnpm create\` — AI-powered agent creation wizard
+
+## Project Layout
+
+\`\`\`
+agent-kit.json     # Main config — agents, cron jobs, models, defaults
+.env               # Secrets (API keys, Slack tokens)
+data/              # Runtime data (per-agent sessions, SOUL.md files, DBs)
+  agents/<name>/
+    SOUL.md        # Agent personality / system prompt
+    sessions/      # JSONL conversation logs
+skills/            # Custom skill definitions
+  <skill-name>/
+    skill.json     # Manifest (name, description, tools list)
+    SKILL.md       # Instructions injected when skill is activated
+    tools/         # Tool implementations (TypeScript)
+\`\`\`
+
+## Configuration (agent-kit.json)
+
+### Models
+
+\`\`\`json
+"models": [
+  { "model": "anthropic:claude-sonnet-4-6", "alias": "sonnet" },
+  { "model": "anthropic:claude-haiku-4-5-20251001", "alias": "haiku" }
+]
+\`\`\`
+
+Agents reference models by alias. The framework handles automatic fallback between models on rate limits/server errors.
+
+### Agent Definition
+
+\`\`\`json
+"agents": {
+  "my-agent": {
+    "displayName": "My Agent",
+    "emoji": "🤖",
+    "model": "sonnet",
+    "tools": ["read_file", "write_file", "web_search"],
+    "skills": ["my-skill"],
+    "sandbox": { "allowedPaths": ["data/agents/my-agent/"] },
+    "slack": { "channelId": "C0XXX", "channelName": "#my-channel" },
+    "heartbeat": { "enabled": true, "intervalMinutes": 60, "model": "haiku" },
+    "can_spawn": [{ "agent": "helper", "tool": "delegate", "description": "..." }]
+  }
+}
+\`\`\`
+
+**Key fields:**
+- \`tools\` — builtin tools the agent can use (see list below)
+- \`skills\` — skill directories to make available via \`activate_skill\`
+- \`sandbox\` — restrict file access (\`allowedPaths\`) or commands (\`allowedCommands\`)
+- \`slack\` — bind agent to a Slack channel for inbound/outbound messages
+- \`heartbeat\` — periodic autonomous check-ins (posts to Slack if something noteworthy)
+- \`spawn_only: true\` — agent can only be invoked by other agents, not directly
+
+### Cron Jobs
+
+\`\`\`json
+"cron": [
+  {
+    "id": "daily-task",
+    "agent": "my-agent",
+    "schedule": "0 8 * * *",
+    "prompt": "Activate the my-skill skill. Do the daily task.",
+    "enabled": true
+  }
+]
+\`\`\`
+
+Schedule uses standard cron syntax. Agents must activate their skill first in the prompt.
+
+### Defaults
+
+\`\`\`json
+"defaults": {
+  "model": "sonnet",
+  "maxTokens": 4096,
+  "maxIterations": 20,
+  "memory": {
+    "dbPath": "./data/memory.db",
+    "ollamaEndpoint": "http://localhost:11434",
+    "ollamaModel": "all-minilm:l6-v2"
+  }
+}
+\`\`\`
+
+## Built-in Tools
+
+| Tool | Description |
+|------|-------------|
+| \`read_file\` | Read a file (respects sandbox allowedPaths) |
+| \`write_file\` | Write a file (respects sandbox allowedPaths) |
+| \`run_command\` | Execute a shell command (respects sandbox allowedCommands) |
+| \`web_search\` | Search the web (Brave or Grok provider) |
+| \`store_memory\` | Store a memory with content and metadata |
+| \`search_memory\` | Semantic search across stored memories |
+| \`get_memory\` | Retrieve a specific memory by ID |
+| \`update_memory\` | Update an existing memory |
+| \`forget_memory\` | Delete a memory |
+| \`list_memories\` | List all memories with optional filtering |
+| \`update_agent_config\` | Agent updates its own config (allowlisted fields) |
+| \`manage_cron\` | Agent manages its own cron jobs (CRUD) |
+
+Memory tools require Ollama running with \`all-minilm:l6-v2\` model.
+
+## Creating Skills
+
+A skill is a directory in \`skills/\` with:
+
+1. **\`skill.json\`** — manifest
+\`\`\`json
+{
+  "name": "my-skill",
+  "description": "What this skill does",
+  "tools": ["my_tool"],
+  "prompt": "SKILL.md"
+}
+\`\`\`
+
+2. **\`SKILL.md\`** — instructions injected into agent context when activated
+
+3. **\`tools/<name>.ts\`** — tool implementations
+\`\`\`typescript
+import type { Tool } from "@alejandroroman/agent-kit/dist/tools/types.js";
+
+const tool: Tool = {
+  name: "my_tool",
+  description: "What this tool does",
+  parameters: {
+    type: "object",
+    properties: {
+      input: { type: "string", description: "The input" }
+    },
+    required: ["input"]
+  },
+  execute: async (args) => {
+    return "result";
+  },
+};
+
+export default tool;
+\`\`\`
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| \`ANTHROPIC_API_KEY\` | Yes | Anthropic API key for Claude models |
+| \`OPENAI_API_KEY\` | No | OpenAI API key (for fallback models) |
+| \`SLACK_BOT_TOKEN\` | No | Slack bot token (xoxb-...) for gateway |
+| \`SLACK_APP_TOKEN\` | No | Slack app token (xapp-...) for Socket Mode |
+| \`BRAVE_SEARCH_API_KEY\` | No | Brave Search API key for web_search |
+| \`XAI_API_KEY\` | No | xAI/Grok API key for web_search |
+
+## Slack Setup
+
+1. Create a Slack app at api.slack.com/apps → From Manifest (YAML):
+\`\`\`yaml
+display_information:
+  name: Agent Kit
+settings:
+  socket_mode_enabled: true
+features:
+  bot_user:
+    display_name: Agent Kit
+    always_online: true
+  event_subscriptions:
+    bot_events:
+      - message.channels
+      - message.groups
+oauth_config:
+  scopes:
+    bot:
+      - chat:write
+      - channels:history
+      - channels:read
+      - groups:history
+      - groups:read
+\`\`\`
+2. Generate an App-Level Token (Settings → Basic Information) with \`connections:write\` scope → \`SLACK_APP_TOKEN\`
+3. Install to workspace → copy Bot Token → \`SLACK_BOT_TOKEN\`
+4. Create channels, invite the bot (\`/invite @Agent Kit\`), copy channel IDs
+5. Add \`slack\` binding to each agent in \`agent-kit.json\`
+
+## Ollama (for Memory)
+
+Memory tools use Ollama for local embeddings:
+\`\`\`bash
+# Install: https://ollama.com
+ollama pull all-minilm:l6-v2
+# Ollama must be running when agent-kit starts
+\`\`\`
+
+If Ollama isn't running, everything else works — memory tools are just unavailable.
+
+## pnpm v10 Note
+
+If using pnpm v10+, native dependencies need explicit approval:
+\`\`\`json
+// In package.json:
+"pnpm": { "onlyBuiltDependencies": ["better-sqlite3"] }
+\`\`\`
+Then \`pnpm install\` to rebuild native bindings.
+`;

package/dist/cli/config-writer.js

@@ -103,6 +103,9 @@ export function scaffoldProjectPackageJson(projectDir, projectName) {
         dependencies: {
             "@alejandroroman/agent-kit": "^0.1.0",
         },
+        pnpm: {
+            onlyBuiltDependencies: ["better-sqlite3"],
+        },
     };
     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
     // Create .gitignore if missing

package/dist/cli/create.js

@@ -1,12 +1,9 @@
 import * as fs from "fs";
-import * as path from "path";
 import * as p from "@clack/prompts";
 import { banner, done, resolveApiKey } from "./ui.js";
 import { loadConfig } from "../config/index.js";
 import { runSetupAgent } from "./setup-agent/index.js";
-const CONFIG_PATH = path.join(process.cwd(), "agent-kit.json");
-const DATA_DIR = path.join(process.cwd(), "data");
-const SKILLS_DIR = path.join(process.cwd(), "skills");
+import { CONFIG_PATH, DATA_DIR, SKILLS_DIR } from "./paths.js";
 export async function create() {
     banner();
     // Require existing config

package/dist/cli/env.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse a .env file into a key-value map.
+ * Strips quotes, ignores comments and blank lines.
+ */
+export declare function loadEnvFile(envPath: string): Record<string, string>;
+/**
+ * Upsert a key in a .env file. Replaces if exists, appends if not.
+ * Values are always quoted to prevent shell issues.
+ */
+export declare function upsertEnvKey(envPath: string, key: string, value: string): void;
+/**
+ * Load specific keys from .env into process.env (if not already set).
+ */
+export declare function loadEnvIntoProcess(envPath: string, keys: string[]): void;

package/dist/cli/env.js

@@ -0,0 +1,68 @@
+import * as fs from "fs";
+/**
+ * Parse a .env file into a key-value map.
+ * Strips quotes, ignores comments and blank lines.
+ */
+export function loadEnvFile(envPath) {
+    if (!fs.existsSync(envPath))
+        return {};
+    const result = {};
+    const content = fs.readFileSync(envPath, "utf-8");
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        let value = trimmed.slice(eqIndex + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Upsert a key in a .env file. Replaces if exists, appends if not.
+ * Values are always quoted to prevent shell issues.
+ */
+export function upsertEnvKey(envPath, key, value) {
+    const quotedLine = `${key}="${value}"`;
+    if (!fs.existsSync(envPath)) {
+        fs.writeFileSync(envPath, quotedLine + "\n", { mode: 0o600 });
+        return;
+    }
+    const content = fs.readFileSync(envPath, "utf-8");
+    const lines = content.split("\n");
+    const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const pattern = new RegExp(`^${escaped}\\s*=`);
+    let replaced = false;
+    const updated = lines.map((line) => {
+        if (pattern.test(line.trim())) {
+            replaced = true;
+            return quotedLine;
+        }
+        return line;
+    });
+    if (!replaced) {
+        const needsNewline = content.length > 0 && !content.endsWith("\n");
+        fs.writeFileSync(envPath, content + (needsNewline ? "\n" : "") + quotedLine + "\n", { mode: 0o600 });
+    }
+    else {
+        fs.writeFileSync(envPath, updated.join("\n"), { mode: 0o600 });
+    }
+}
+/**
+ * Load specific keys from .env into process.env (if not already set).
+ */
+export function loadEnvIntoProcess(envPath, keys) {
+    const env = loadEnvFile(envPath);
+    for (const key of keys) {
+        if (!process.env[key] && env[key]) {
+            process.env[key] = env[key];
+        }
+    }
+}

package/dist/cli/init.js

@@ -1,14 +1,14 @@
 import * as fs from "fs";
-import * as path from "path";
 import { execSync } from "child_process";
 import * as p from "@clack/prompts";
 import { banner, isCancel, done, resolveApiKey } from "./ui.js";
 import { checkOllama } from "./ollama.js";
 import { createFreshConfig, scaffoldProjectPackageJson } from "./config-writer.js";
 import { runSetupAgent } from "./setup-agent/index.js";
-const CONFIG_PATH = path.join(process.cwd(), "agent-kit.json");
-const DATA_DIR = path.join(process.cwd(), "data");
-const SKILLS_DIR = path.join(process.cwd(), "skills");
+import { setupSlack } from "./slack-setup.js";
+import { CONFIG_PATH, DATA_DIR, SKILLS_DIR } from "./paths.js";
+import { CLAUDE_MD_TEMPLATE } from "./claude-md-template.js";
+import * as path from "path";
 function detectPackageManager() {
     try {
         execSync("pnpm --version", { stdio: "ignore" });
@@ -43,6 +43,11 @@ export async function init() {
         createFreshConfig({ configPath: CONFIG_PATH });
         fs.mkdirSync(DATA_DIR, { recursive: true });
         fs.mkdirSync(SKILLS_DIR, { recursive: true });
+        // Generate CLAUDE.md for Claude Code context
+        const claudeMdPath = path.join(process.cwd(), "CLAUDE.md");
+        if (!fs.existsSync(claudeMdPath)) {
+            fs.writeFileSync(claudeMdPath, CLAUDE_MD_TEMPLATE);
+        }
     }
     catch (err) {
         s.stop(`Failed to create project: ${err instanceof Error ? err.message : err}`);
@@ -53,13 +58,13 @@ export async function init() {
     const pm = detectPackageManager();
     s.start(`Installing dependencies (${pm} install)...`);
     try {
-        execSync(`${pm} install`, { cwd: process.cwd(), stdio: "ignore" });
+        execSync(`${pm} install`, { cwd: process.cwd(), stdio: "pipe" });
+        s.stop("Dependencies installed");
     }
     catch (err) {
         s.stop(`Failed to install dependencies: ${err instanceof Error ? err.message : err}`);
-        p.log.warn("You can install manually later with: npm install");
+        p.log.warn(`Run \`${pm} install\` manually before starting.`);
     }
-    s.stop("Dependencies installed");
     // Ask if they want to create agents now
     const createNow = await p.confirm({
         message: "Create your first agent now? (AI-powered setup)",
@@ -82,4 +87,6 @@ export async function init() {
     });
     console.log();
     done(summary);
+    // Offer Slack setup after agent creation
+    await setupSlack({ configPath: CONFIG_PATH, fromInit: true });
 }

package/dist/cli/list.js

@@ -1,6 +1,5 @@
-import * as path from "path";
 import { loadConfig } from "../config/index.js";
-const CONFIG_PATH = path.join(process.cwd(), "agent-kit.json");
+import { CONFIG_PATH } from "./paths.js";
 export function list() {
     const config = loadConfig(CONFIG_PATH);
     const agents = Object.entries(config.agents);

package/dist/cli/paths.d.ts

@@ -0,0 +1,3 @@
+export declare const CONFIG_PATH: string;
+export declare const DATA_DIR: string;
+export declare const SKILLS_DIR: string;

package/dist/cli/paths.js

@@ -0,0 +1,4 @@
+import * as path from "path";
+export const CONFIG_PATH = path.join(process.cwd(), "agent-kit.json");
+export const DATA_DIR = path.join(process.cwd(), "data");
+export const SKILLS_DIR = path.join(process.cwd(), "skills");

package/dist/cli/repl.d.ts

@@ -0,0 +1,23 @@
+import type { ToolRegistry } from "../tools/registry.js";
+import type { SessionManager } from "../session/manager.js";
+import type { UsageStore } from "../usage/index.js";
+interface ReplOptions {
+    agentName: string;
+    model: string;
+    fallbacks: string[];
+    maxIterations: number;
+    compactionThreshold: number;
+    maxToolResultSize: number;
+    toolRegistry: ToolRegistry;
+    session: SessionManager;
+    soul: string | undefined;
+    skillsIndex: string;
+    promptFragments: string[];
+    usageStore?: UsageStore;
+    /** Extra commands beyond /quit and /new */
+    commands?: Record<string, () => void>;
+    /** Called on /quit before closing */
+    onQuit?: () => Promise<void>;
+}
+export declare function startRepl(opts: ReplOptions): void;
+export {};

package/dist/cli/repl.js

@@ -0,0 +1,73 @@
+import * as readline from "readline";
+import { runAgentLoop } from "../agent/loop.js";
+import { compactMessages } from "../session/compaction.js";
+import { buildSystemPrompt } from "../bootstrap.js";
+export function startRepl(opts) {
+    let messages = opts.session.getMessages();
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const ask = () => {
+        rl.question("You: ", async (input) => {
+            const trimmed = input.trim();
+            if (trimmed === "/quit") {
+                try {
+                    await opts.onQuit?.();
+                }
+                catch (err) {
+                    console.error(`Warning: cleanup error: ${err instanceof Error ? err.message : err}`);
+                }
+                rl.close();
+                return;
+            }
+            if (trimmed === "/new") {
+                messages = [];
+                console.log("  Session reset.\n");
+                ask();
+                return;
+            }
+            // Custom commands
+            if (opts.commands && trimmed in opts.commands) {
+                opts.commands[trimmed]();
+                ask();
+                return;
+            }
+            if (!trimmed) {
+                ask();
+                return;
+            }
+            const userMsg = { role: "user", content: trimmed };
+            messages.push(userMsg);
+            opts.session.append(userMsg);
+            messages = await compactMessages(messages, opts.model, opts.compactionThreshold);
+            try {
+                const systemPrompt = buildSystemPrompt(opts.soul, opts.skillsIndex, opts.promptFragments);
+                const result = await runAgentLoop(messages, {
+                    model: opts.model,
+                    fallbacks: opts.fallbacks,
+                    systemPrompt,
+                    toolRegistry: opts.toolRegistry,
+                    maxIterations: opts.maxIterations,
+                    compactionThreshold: opts.compactionThreshold,
+                    maxToolResultSize: opts.maxToolResultSize,
+                    agentName: opts.agentName,
+                    usageStore: opts.usageStore,
+                    source: "cli",
+                });
+                const newMessages = result.messages.slice(messages.length);
+                for (const msg of newMessages) {
+                    opts.session.append(msg);
+                }
+                messages = result.messages;
+                console.log(`\nAgent: ${result.text}`);
+                console.log(`  (${result.usage.inputTokens + result.usage.outputTokens} tokens)\n`);
+            }
+            catch (err) {
+                console.error(`\n  Error: ${err instanceof Error ? err.message : err}\n`);
+            }
+            ask();
+        });
+    };
+    ask();
+}

package/dist/cli/slack-setup.d.ts

@@ -0,0 +1,6 @@
+interface SetupSlackOpts {
+    configPath: string;
+    fromInit?: boolean;
+}
+export declare function setupSlack(opts: SetupSlackOpts): Promise<void>;
+export {};