kindflow 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kindflow Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,222 @@
+<p align="center">
+  <img src=".github/logo.png" alt="Kindflow" height="60">
+</p>
+
+<p align="center">
+  Opinionated agent platform for enterprises
+</p>
+
+<p align="center">
+  <a href="#install">Install</a> &middot;
+  <a href="#quick-start">Quick Start</a> &middot;
+  <a href="#how-it-works">How It Works</a> &middot;
+  <a href="#capabilities">Capabilities</a> &middot;
+  <a href="#contributing">Contributing</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/surajpratap/kindflow/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="https://github.com/surajpratap/kindflow"><img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node"></a>
+  <img src="https://img.shields.io/badge/coverage-95%25-brightgreen.svg" alt="Coverage">
+</p>
+
+---
+
+Kindflow is an opinionated platform for running AI agents as independent OS processes. Each agent gets its own directory, its own identity, and its own set of capabilities. You create and configure agents through an embedded AI terminal in the browser, and Kindflow orchestrates the rest — process lifecycle, inter-agent communication, scheduled tasks, webhooks, and integrations.
+
+**Philosophy:** Agents are processes, not prompts. Each one is a first-class citizen with its own filesystem, config, and runtime. The platform handles orchestration so you can focus on what the agent should do, not how to run it.
+
+## Install
+
+```bash
+npm install -g kindflow
+```
+
+## Quick Start
+
+```bash
+# Start the daemon (API server on port 7777)
+kindflow start
+
+# Start with the web UI (port 7001)
+kindflow start --web
+
+# Create an agent
+kindflow create my-first-agent
+
+# List all agents
+kindflow list
+```
+
+Open http://localhost:7001 to access the dashboard, create agents, and configure them with AI.
+
+## How It Works
+
+```
+                            +-------------------+
+                            |     Web UI        |
+                            |   (Next.js)       |
+                            +--------+----------+
+                                     |
+                            +--------v----------+
+                            |      Daemon       |
+                            |   HTTP + WS API   |
+                            |   IPC Hub         |
+                            |   Process Manager |
+                            +---+----+----+-----+
+                                |    |    |
+                   +------------+    |    +------------+
+                   |                 |                  |
+            +------v------+  +------v------+  +--------v--------+
+            |   Agent     |  |   Agent     |  | Helper processes |
+            |  headless   |  |  headless   |  | Cron / Email /   |
+            |  process    |  |  process    |  | Telegram         |
+            +-------------+  +-------------+  +-----------------+
+```
+
+- **Agents** run as isolated headless processes. Each agent is a directory with a `config.json`, identity file, scripts, and commands.
+- **The daemon** is the central orchestrator. It manages agent lifecycles, routes IPC messages, serves the HTTP/WebSocket API, and auto-generates capability files.
+- **Configure with AI** opens an embedded AI terminal in the browser. A master agent walks through discovery, design, build, and review phases to set up your agent.
+- **Helper processes** (cron scheduler, email watcher, Telegram bot runner) are singletons shared across all agents.
+- **Everything is filesystem-driven.** The agent's `config.json` is the source of truth. No central database for agent config.
+
+## Agent Directory
+
+Each agent lives in its own directory:
+
+```
+~/.kindflow/agents/my-agent/
+  agent/                     # Agent working directory
+    config.json              # Agent configuration (source of truth)
+    CLAUDE.md                # Agent identity and instructions
+    .claude/commands/*.md    # Slash commands (procedures)
+    scripts/                 # Tool scripts
+    resources/               # Reference documents
+    data/                    # Persistent data
+    capabilities/            # Auto-generated capability files
+  master/                    # "Configure with AI" directory
+    CLAUDE.md                # Master agent instructions
+    .claude/commands/        # Setup commands (S3, database, etc.)
+    resources/               # Capability reference docs
+```
+
+## Capabilities
+
+Kindflow provides six built-in capability types. Each follows the same pattern: a global resource (configured in the web UI) connected to one or more agents.
+
+| Capability | Resource | What It Does |
+|------------|----------|--------------|
+| **Cron** | Scheduled jobs | Triggers agent commands on a cron schedule |
+| **HTTP** | Webhook endpoints | Routes incoming HTTP requests to agents via IPC |
+| **Email** | Gmail accounts (OAuth) | Watches inboxes via IMAP, forwards to agents |
+| **Telegram** | Bot tokens | Receives messages, routes to agents by chat ID |
+| **S3** | AWS S3 buckets | Agents read/write objects via `kindflow/s3` |
+| **Database** | PostgreSQL / SQLite | Agents query databases via `kindflow/database` |
+
+When you connect a resource to an agent, Kindflow auto-generates a capability file at `agent/capabilities/<type>/<connection-id>.md` so the agent knows what it has access to.
+
+### Agent Scripts
+
+Agent scripts can import Kindflow client libraries:
+
+```typescript
+import { createS3Bucket } from 'kindflow/s3';
+import { createDatabaseClient } from 'kindflow/database';
+import { createTelegramClient } from 'kindflow/telegram';
+```
+
+## Configuration
+
+All config and credentials are stored in `~/.kindflow/` (never in the repo):
+
+| Path | Description |
+|------|-------------|
+| `~/.kindflow/config.db` | Global config (connections, settings, helpers) |
+| `~/.kindflow/encryption.key` | AES-256 key for secret encryption at rest |
+| `~/.kindflow/agents/` | All agent directories |
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `KINDFLOW_PORT` | `7777` | Daemon API port |
+| `KINDFLOW_DATA_DIR` | `~/.kindflow` | Override the data directory |
+| `KINDFLOW_DEV` | — | Set to `1` to force dev mode |
+
+## CLI Reference
+
+```
+kindflow start [options]     Start the daemon
+  --web                      Also start the web UI (port 7001)
+  --port <n>                 Override the API port
+  --web-port <n>             Override the web UI port
+  --agents-dir <path>        Override the agents directory
+
+kindflow create <name>       Create a new agent from template
+
+kindflow list                List all agents
+```
+
+## Development
+
+Kindflow is a Turborepo monorepo. For local development:
+
+```bash
+git clone https://github.com/surajpratap/kindflow.git
+cd kindflow
+npm install
+
+# Start everything in dev mode
+npm run dev
+
+# Or start individually
+npm run start --workspace=@repo/daemon   # Daemon on :7777
+npm run dev --workspace=apps/web         # Web UI on :7001
+```
+
+### Project Structure
+
+```
+packages/
+  cli/              CLI entry point (kindflow command)
+  daemon/           Process orchestrator, HTTP API, IPC hub
+  agent-runner/     Headless agent process wrapper
+  cron-runner/      Singleton cron scheduler
+  imap-runner/      Email IMAP watcher
+  telegram-runner/  Telegram bot runner
+  ipc/              node-ipc hub + client
+  store/            SQLite persistence (sql.js)
+  crypto/           AES-256-CBC encryption for secrets
+  s3/               S3 client library
+  database/         PostgreSQL + SQLite client
+  telegram/         Telegram bot client
+  types/            Shared TypeScript types
+  ui/               Shared React components
+
+apps/
+  web/              Next.js web UI (dashboard + terminal)
+
+templates/
+  agent/            Default agent scaffold
+```
+
+### Commands
+
+```bash
+npm run dev              # Start all apps in dev mode
+npm run build            # Build all packages
+npm run build:release    # Build CLI + web for npm publish
+npm run lint             # Lint everything
+npm run format           # Format with Prettier
+npm run check-types      # Type-check all packages
+npm run test             # Run all tests
+npm run duplicates       # Check for code duplication
+```
+
+## Contributing
+
+Contributions are welcome. Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](./LICENSE)

package/agent-runner.js

@@ -0,0 +1,190 @@
+import {
+  createIpcClient
+} from "./chunk-2UX7Z5TH.js";
+
+// ../agent-runner/src/agent.ts
+import { query } from "@anthropic-ai/claude-agent-sdk";
+
+// ../agent-runner/src/message-queue.ts
+var MessageQueue = class {
+  /** Buffered messages waiting to be consumed. */
+  queue = [];
+  /** Resolver for a pending `pull()` call, set when queue is empty and SDK is waiting. */
+  waiting = null;
+  /**
+   * Add a message to the queue. If the SDK is currently waiting
+   * for a message (via `pull()`), it's delivered immediately.
+   *
+   * @param message - the prompt text to enqueue
+   */
+  push(message) {
+    if (this.waiting) {
+      this.waiting(message);
+      this.waiting = null;
+    } else {
+      this.queue.push(message);
+    }
+  }
+  /**
+   * Wait for and return the next message. If messages are already
+   * queued, returns immediately. Otherwise blocks until `push()` is called.
+   *
+   * @returns the next prompt text
+   */
+  pull() {
+    if (this.queue.length > 0) {
+      return Promise.resolve(this.queue.shift());
+    }
+    return new Promise((resolve) => {
+      this.waiting = resolve;
+    });
+  }
+  /** Returns the number of messages currently in the queue. */
+  get length() {
+    return this.queue.length;
+  }
+};
+
+// ../agent-runner/src/renderer.ts
+var RESET = "\x1B[0m";
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var CYAN = "\x1B[36m";
+var GREEN = "\x1B[32m";
+var YELLOW = "\x1B[33m";
+var RED = "\x1B[31m";
+var MAGENTA = "\x1B[35m";
+var BLUE = "\x1B[34m";
+var renderMessage = (msg) => {
+  switch (msg.type) {
+    case "assistant": {
+      if (!msg.message?.content) return;
+      for (const block of msg.message.content) {
+        if (block.type === "text" && block.text) {
+          console.log(`
+${CYAN}${BOLD}assistant${RESET} ${DIM}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${RESET}`);
+          console.log(block.text);
+        }
+        if (block.type === "tool_use") {
+          const input = JSON.stringify(block.input, null, 2);
+          console.log(`
+${MAGENTA}${BOLD}tool${RESET} ${YELLOW}${block.name}${RESET}`);
+          if (input.length < 200) {
+            console.log(`${DIM}${input}${RESET}`);
+          }
+        }
+      }
+      break;
+    }
+    case "result": {
+      if (msg.subtype === "success") {
+        console.log(
+          `
+${GREEN}${BOLD}done${RESET} ${DIM}(${msg.num_turns} turns, ${Math.round(msg.duration_ms / 1e3)}s)${RESET}`
+        );
+        if (msg.result) console.log(msg.result);
+      } else {
+        console.log(`
+${RED}${BOLD}error${RESET} ${msg.subtype}`);
+      }
+      break;
+    }
+    case "tool_progress": {
+      process.stdout.write(
+        `${DIM}  [${msg.tool_name}] ${Math.round(msg.elapsed_time_seconds)}s${RESET}\r`
+      );
+      break;
+    }
+    case "system": {
+      if (msg.subtype === "status") {
+        console.log(`${BLUE}${DIM}status: ${msg.status}${RESET}`);
+      }
+      break;
+    }
+  }
+};
+
+// ../agent-runner/src/agent.ts
+var createAgent = (options) => {
+  const queue = new MessageQueue();
+  async function* messageGenerator() {
+    while (true) {
+      const message = await queue.pull();
+      yield {
+        type: "user",
+        message: { role: "user", content: message }
+      };
+    }
+  }
+  const agentQuery = query({
+    prompt: messageGenerator(),
+    options: options.sdkOptions
+  });
+  const onMessage = options.onMessage ?? renderMessage;
+  (async () => {
+    for await (const msg of agentQuery) {
+      onMessage(msg);
+    }
+  })();
+  return {
+    query: agentQuery,
+    sendMessage: (message) => queue.push(message)
+  };
+};
+
+// ../agent-runner/src/process.ts
+var startAgentProcess = () => {
+  const processId = process.env["KINDFLOW_PROCESS_ID"];
+  const hubId = process.env["KINDFLOW_HUB_ID"];
+  if (!processId || !hubId) {
+    console.error("[agent-runner] Missing KINDFLOW_PROCESS_ID or KINDFLOW_HUB_ID env vars");
+    process.exit(1);
+  }
+  process.on("message", async (msg) => {
+    if (msg.type === "config") {
+      await handleConfig(msg.config, processId, hubId);
+    }
+    if (msg.type === "ping") {
+      process.send?.({ type: "pong" });
+    }
+    if (msg.type === "stop") {
+      console.log(`[agent-runner:${processId}] Received stop signal, shutting down`);
+      process.exit(0);
+    }
+  });
+  console.log(`[agent-runner:${processId}] Waiting for config from daemon...`);
+};
+var handleConfig = async (config, processId, hubId) => {
+  console.log(`[agent-runner:${processId}] Received config for agent "${config.name}"`);
+  const agent = createAgent({
+    sdkOptions: config.sdkOptions,
+    onMessage: (msg) => {
+      process.send?.({ type: "agent:sdk-message", message: msg });
+    }
+  });
+  const client = createIpcClient({
+    clientId: processId,
+    hubId,
+    onMessage: (ipcMsg) => {
+      if (ipcMsg.to !== processId && ipcMsg.to !== "*") return;
+      if (ipcMsg.type === "prompt") {
+        const payload = ipcMsg.payload;
+        console.log(`[agent-runner:${processId}] Received prompt from ${ipcMsg.from}`);
+        agent.sendMessage(payload.text);
+      }
+    },
+    onConnect: () => {
+      console.log(`[agent-runner:${processId}] Connected to IPC hub`);
+    },
+    onDisconnect: () => {
+      console.log(`[agent-runner:${processId}] Disconnected from IPC hub, will retry...`);
+    }
+  });
+  await client.connect();
+  process.send?.({ type: "ready" });
+  console.log(`[agent-runner:${processId}] Ready`);
+};
+
+// ../agent-runner/src/entry.ts
+startAgentProcess();
+//# sourceMappingURL=agent-runner.js.map

package/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../agent-runner/src/agent.ts","../../agent-runner/src/message-queue.ts","../../agent-runner/src/renderer.ts","../../agent-runner/src/process.ts","../../agent-runner/src/entry.ts"],"sourcesContent":["import { query, type SDKUserMessage, type SDKMessage, type Options } from '@anthropic-ai/claude-agent-sdk';\nimport { MessageQueue } from './message-queue.js';\nimport { renderMessage } from './renderer.js';\n\n/**\n * Options for creating a headless agent.\n * Uses the SDK's Options type directly for all Claude-specific config.\n */\nexport interface AgentOptions {\n  /** Claude Agent SDK options passed directly to `query()`. */\n  sdkOptions: Options;\n\n  /**\n   * Custom handler for SDK messages. Defaults to `renderMessage`\n   * which prints colored output to the terminal.\n   */\n  onMessage?: (msg: SDKMessage) => void;\n}\n\n/**\n * A running headless agent instance.\n */\nexport interface Agent {\n  /** The underlying SDK query (async generator of SDKMessage). */\n  query: AsyncGenerator<SDKMessage, void>;\n\n  /** Inject a prompt into the agent's message queue. */\n  sendMessage: (message: string) => void;\n}\n\n/**\n * Create a headless agent that wraps the Claude Agent SDK.\n *\n * The agent uses an internal MessageQueue to receive prompts asynchronously.\n * Prompts can come from IPC (via the daemon hub) or from `sendMessage()`.\n * Each prompt is yielded to the SDK as an `SDKUserMessage`.\n *\n * @param options - agent configuration including SDK options and message handler\n * @returns an Agent instance with the active query and a sendMessage function\n */\nexport const createAgent = (options: AgentOptions): Agent => {\n  const queue = new MessageQueue();\n\n  /**\n   * Async generator that pulls messages from the queue and yields them\n   * as SDKUserMessage objects for the SDK to process.\n   *\n   * @yields SDKUserMessage for each prompt received from the queue\n   */\n  async function* messageGenerator(): AsyncGenerator<SDKUserMessage> {\n    while (true) {\n      const message = await queue.pull();\n      yield {\n        type: 'user',\n        message: { role: 'user', content: message },\n      } as SDKUserMessage;\n    }\n  }\n\n  /** Start the SDK query with the message generator as input. */\n  const agentQuery = query({\n    prompt: messageGenerator(),\n    options: options.sdkOptions,\n  });\n\n  const onMessage = options.onMessage ?? renderMessage;\n\n  /** Consume SDK messages in the background. */\n  (async () => {\n    for await (const msg of agentQuery) {\n      onMessage(msg);\n    }\n  })();\n\n  return {\n    query: agentQuery,\n    sendMessage: (message: string) => queue.push(message),\n  };\n};\n","/**\n * Async message queue for buffering prompts between IPC delivery and\n * the Claude Agent SDK's async generator consumption.\n *\n * When a prompt arrives via IPC while the agent is busy, it's queued.\n * When the SDK is ready for the next message, it pulls from the queue.\n * If the queue is empty, `pull()` blocks until a message arrives.\n */\nexport class MessageQueue {\n  /** Buffered messages waiting to be consumed. */\n  private queue: string[] = [];\n\n  /** Resolver for a pending `pull()` call, set when queue is empty and SDK is waiting. */\n  private waiting: ((msg: string) => void) | null = null;\n\n  /**\n   * Add a message to the queue. If the SDK is currently waiting\n   * for a message (via `pull()`), it's delivered immediately.\n   *\n   * @param message - the prompt text to enqueue\n   */\n  push(message: string): void {\n    if (this.waiting) {\n      this.waiting(message);\n      this.waiting = null;\n    } else {\n      this.queue.push(message);\n    }\n  }\n\n  /**\n   * Wait for and return the next message. If messages are already\n   * queued, returns immediately. Otherwise blocks until `push()` is called.\n   *\n   * @returns the next prompt text\n   */\n  pull(): Promise<string> {\n    if (this.queue.length > 0) {\n      return Promise.resolve(this.queue.shift()!);\n    }\n    return new Promise((resolve) => {\n      this.waiting = resolve;\n    });\n  }\n\n  /** Returns the number of messages currently in the queue. */\n  get length(): number {\n    return this.queue.length;\n  }\n}\n","import type { SDKMessage } from '@anthropic-ai/claude-agent-sdk';\n\n/** ANSI color codes for terminal output formatting. */\nconst RESET = '\\x1b[0m';\nconst BOLD = '\\x1b[1m';\nconst DIM = '\\x1b[2m';\nconst CYAN = '\\x1b[36m';\nconst GREEN = '\\x1b[32m';\nconst YELLOW = '\\x1b[33m';\nconst RED = '\\x1b[31m';\nconst MAGENTA = '\\x1b[35m';\nconst BLUE = '\\x1b[34m';\n\n/**\n * Render an SDK message to the terminal with colored formatting.\n * Used as the default `onMessage` handler when no custom handler is provided.\n *\n * Handles assistant text, tool calls, result summaries, progress indicators,\n * and system status messages.\n *\n * @param msg - the SDK message to render\n */\nexport const renderMessage = (msg: SDKMessage): void => {\n  switch (msg.type) {\n    case 'assistant': {\n      if (!msg.message?.content) return;\n      for (const block of msg.message.content) {\n        if (block.type === 'text' && block.text) {\n          console.log(`\\n${CYAN}${BOLD}assistant${RESET} ${DIM}─────────────────────${RESET}`);\n          console.log(block.text);\n        }\n        if (block.type === 'tool_use') {\n          const input = JSON.stringify(block.input, null, 2);\n          console.log(`\\n${MAGENTA}${BOLD}tool${RESET} ${YELLOW}${block.name}${RESET}`);\n          if (input.length < 200) {\n            console.log(`${DIM}${input}${RESET}`);\n          }\n        }\n      }\n      break;\n    }\n\n    case 'result': {\n      if (msg.subtype === 'success') {\n        console.log(\n          `\\n${GREEN}${BOLD}done${RESET} ${DIM}(${msg.num_turns} turns, ${Math.round(msg.duration_ms / 1000)}s)${RESET}`,\n        );\n        if (msg.result) console.log(msg.result);\n      } else {\n        console.log(`\\n${RED}${BOLD}error${RESET} ${msg.subtype}`);\n      }\n      break;\n    }\n\n    case 'tool_progress': {\n      process.stdout.write(\n        `${DIM}  [${msg.tool_name}] ${Math.round(msg.elapsed_time_seconds)}s${RESET}\\r`,\n      );\n      break;\n    }\n\n    case 'system': {\n      if (msg.subtype === 'status') {\n        console.log(`${BLUE}${DIM}status: ${msg.status}${RESET}`);\n      }\n      break;\n    }\n  }\n};\n","import type { AgentConfig, DaemonToChild, IpcMessage, PromptPayload } from '@repo/types';\nimport { createIpcClient } from '@repo/ipc';\nimport { createAgent } from './agent.js';\n\n/**\n * Entry point for the agent-runner child process.\n *\n * This module is designed to be forked by the daemon via `child_process.fork()`.\n * It follows this lifecycle:\n *\n * 1. Reads KINDFLOW_PROCESS_ID and KINDFLOW_HUB_ID from env\n * 2. Waits for a `config` message from the daemon via Node.js IPC\n * 3. Creates the Claude Agent SDK wrapper with the received config\n * 4. Connects to the daemon's IPC hub to receive prompts\n * 5. Sends `ready` back to the daemon\n * 6. Responds to `ping` with `pong` for health checks\n * 7. Shuts down gracefully on `stop`\n */\nexport const startAgentProcess = (): void => {\n  const processId = process.env['KINDFLOW_PROCESS_ID'];\n  const hubId = process.env['KINDFLOW_HUB_ID'];\n\n  if (!processId || !hubId) {\n    console.error('[agent-runner] Missing KINDFLOW_PROCESS_ID or KINDFLOW_HUB_ID env vars');\n    process.exit(1);\n  }\n\n  /** Listen for control plane messages from the daemon. */\n  process.on('message', async (msg: DaemonToChild) => {\n    if (msg.type === 'config') {\n      await handleConfig(msg.config as AgentConfig, processId, hubId);\n    }\n\n    if (msg.type === 'ping') {\n      process.send?.({ type: 'pong' });\n    }\n\n    if (msg.type === 'stop') {\n      console.log(`[agent-runner:${processId}] Received stop signal, shutting down`);\n      process.exit(0);\n    }\n  });\n\n  console.log(`[agent-runner:${processId}] Waiting for config from daemon...`);\n};\n\n/**\n * Handle the initial config message — create the agent and connect to the IPC hub.\n *\n * @param config - the agent configuration from the daemon\n * @param processId - this process's unique identifier\n * @param hubId - the daemon's IPC hub server ID\n */\nconst handleConfig = async (config: AgentConfig, processId: string, hubId: string): Promise<void> => {\n  console.log(`[agent-runner:${processId}] Received config for agent \"${config.name}\"`);\n\n  /** Create the agent with SDK options passed through directly. */\n  const agent = createAgent({\n    sdkOptions: config.sdkOptions,\n    onMessage: (msg) => {\n      /* Forward SDK messages to daemon for web UI display. */\n      process.send?.({ type: 'agent:sdk-message', message: msg });\n    },\n  });\n\n  /** Connect to the daemon's IPC hub to receive routed prompts. */\n  const client = createIpcClient({\n    clientId: processId,\n    hubId,\n    onMessage: (ipcMsg: IpcMessage) => {\n      /* Only process messages addressed to us or broadcast. */\n      if (ipcMsg.to !== processId && ipcMsg.to !== '*') return;\n\n      if (ipcMsg.type === 'prompt') {\n        const payload = ipcMsg.payload as PromptPayload;\n        console.log(`[agent-runner:${processId}] Received prompt from ${ipcMsg.from}`);\n        agent.sendMessage(payload.text);\n      }\n    },\n    onConnect: () => {\n      console.log(`[agent-runner:${processId}] Connected to IPC hub`);\n    },\n    onDisconnect: () => {\n      console.log(`[agent-runner:${processId}] Disconnected from IPC hub, will retry...`);\n    },\n  });\n\n  await client.connect();\n\n  /** Tell the daemon we're ready. */\n  process.send?.({ type: 'ready' });\n  console.log(`[agent-runner:${processId}] Ready`);\n};\n","/**\n * Process entry point for the agent-runner.\n * This file is invoked via `child_process.fork()` from the daemon.\n */\nimport { startAgentProcess } from './process.js';\n\nstartAgentProcess();\n"],"mappings":"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","names":[]}

package/chunk-2UX7Z5TH.js

@@ -0,0 +1,95 @@
+// ../ipc/src/hub.ts
+import ipc from "node-ipc";
+import { randomUUID } from "crypto";
+var createIpcHub = (options) => {
+  ipc.config.id = options.id;
+  ipc.config.retry = 1500;
+  ipc.config.silent = options.silent ?? true;
+  return {
+    start() {
+      return new Promise((resolve) => {
+        ipc.serve(() => {
+          ipc.server.on("message", (data, socket) => {
+            try {
+              const message = JSON.parse(data);
+              const socketId = socket.id ?? "unknown";
+              options.onMessage?.(message, socketId);
+            } catch {
+            }
+          });
+          ipc.server.on("connect", (socket) => {
+            options.onConnect?.(socket.id ?? "unknown");
+          });
+          ipc.server.on("socket.disconnected", (socket) => {
+            options.onDisconnect?.(socket.id ?? "unknown");
+          });
+          resolve();
+        });
+        ipc.server.start();
+      });
+    },
+    sendTo(socketId, message) {
+      const data = JSON.stringify(message);
+      ipc.server.emit(socketId, "message", data);
+    },
+    broadcast(message) {
+      const data = JSON.stringify(message);
+      ipc.server.broadcast("message", data);
+    },
+    stop() {
+      ipc.server.stop();
+    }
+  };
+};
+var createMessage = (from, to, type, payload) => ({
+  id: randomUUID(),
+  from,
+  to,
+  type,
+  payload,
+  timestamp: Date.now()
+});
+
+// ../ipc/src/client.ts
+import ipc2 from "node-ipc";
+var createIpcClient = (options) => {
+  ipc2.config.id = options.clientId;
+  ipc2.config.retry = options.retryInterval ?? 1500;
+  ipc2.config.silent = options.silent ?? true;
+  return {
+    connect() {
+      return new Promise((resolve) => {
+        ipc2.connectTo(options.hubId, () => {
+          ipc2.of[options.hubId].on("connect", () => {
+            options.onConnect?.();
+            resolve();
+          });
+          ipc2.of[options.hubId].on("message", (data) => {
+            try {
+              const message = JSON.parse(data);
+              options.onMessage?.(message);
+            } catch {
+            }
+          });
+          ipc2.of[options.hubId].on("disconnect", () => {
+            options.onDisconnect?.();
+          });
+        });
+      });
+    },
+    send(message) {
+      const data = JSON.stringify(message);
+      ipc2.of[options.hubId].emit("message", data);
+    },
+    disconnect() {
+      ipc2.disconnect(options.hubId);
+    }
+  };
+};
+
+export {
+  createIpcHub,
+  createMessage,
+  createIpcClient
+};
+//# sourceMappingURL=chunk-2UX7Z5TH.js.map

package/chunk-2UX7Z5TH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../ipc/src/hub.ts","../../ipc/src/client.ts"],"sourcesContent":["// @ts-expect-error node-ipc has no type declarations\nimport ipc from 'node-ipc';\nimport { randomUUID } from 'crypto';\nimport type { IpcMessage } from '@repo/types';\n\n/**\n * Callback invoked when the hub receives a message from a connected client.\n */\nexport type HubMessageHandler = (message: IpcMessage, socketId: string) => void;\n\n/**\n * Options for creating an IPC hub.\n */\nexport interface IpcHubOptions {\n  /** Unique identifier for this IPC server (e.g. \"kindflow-hub\"). */\n  id: string;\n\n  /** Called when a message arrives from any connected client. */\n  onMessage?: HubMessageHandler;\n\n  /** Called when a client connects. Receives the client's socket ID. */\n  onConnect?: (socketId: string) => void;\n\n  /** Called when a client disconnects. Receives the client's socket ID. */\n  onDisconnect?: (socketId: string) => void;\n\n  /** Suppress node-ipc internal logging. Defaults to true. */\n  silent?: boolean;\n}\n\n/**\n * An IPC hub server that accepts client connections and routes messages.\n * Uses node-ipc Unix domain sockets for local inter-process communication.\n */\nexport interface IpcHub {\n  /** Start the IPC server and begin accepting connections. */\n  start: () => Promise<void>;\n\n  /**\n   * Send a message to a specific connected client.\n   *\n   * @param socketId - the target client's socket identifier\n   * @param message - the message envelope to send\n   */\n  sendTo: (socketId: string, message: IpcMessage) => void;\n\n  /**\n   * Broadcast a message to all connected clients.\n   *\n   * @param message - the message envelope to broadcast\n   */\n  broadcast: (message: IpcMessage) => void;\n\n  /** Stop the IPC server and close all connections. */\n  stop: () => void;\n}\n\n/**\n * Create an IPC hub server.\n *\n * The hub acts as a central message router. Child processes (agents, helpers)\n * connect as clients and exchange messages through the hub.\n *\n * @param options - hub configuration\n * @returns an IpcHub instance\n */\nexport const createIpcHub = (options: IpcHubOptions): IpcHub => {\n  ipc.config.id = options.id;\n  ipc.config.retry = 1500;\n  ipc.config.silent = options.silent ?? true;\n\n  return {\n    start(): Promise<void> {\n      return new Promise((resolve) => {\n        ipc.serve(() => {\n          ipc.server.on('message', (data: string, socket: { id?: string }) => {\n            try {\n              const message = JSON.parse(data) as IpcMessage;\n              const socketId = socket.id ?? 'unknown';\n              options.onMessage?.(message, socketId);\n            } catch {\n              /* Ignore malformed messages. */\n            }\n          });\n\n          ipc.server.on('connect', (socket: { id?: string }) => {\n            options.onConnect?.(socket.id ?? 'unknown');\n          });\n\n          /* node-ipc emits 'socket.disconnected' when a client drops. */\n          ipc.server.on('socket.disconnected', (socket: { id?: string }) => {\n            options.onDisconnect?.(socket.id ?? 'unknown');\n          });\n\n          resolve();\n        });\n\n        ipc.server.start();\n      });\n    },\n\n    sendTo(socketId: string, message: IpcMessage): void {\n      /* node-ipc tracks sockets internally; broadcast with filter. */\n      const data = JSON.stringify(message);\n      ipc.server.emit(socketId, 'message', data);\n    },\n\n    broadcast(message: IpcMessage): void {\n      const data = JSON.stringify(message);\n      ipc.server.broadcast('message', data);\n    },\n\n    stop(): void {\n      ipc.server.stop();\n    },\n  };\n};\n\n/**\n * Create a new IpcMessage envelope with a generated UUID and timestamp.\n *\n * @param from - sender process ID\n * @param to - recipient process ID (or '*' for broadcast)\n * @param type - message type\n * @param payload - message payload\n * @returns a fully populated IpcMessage\n */\nexport const createMessage = (\n  from: string,\n  to: string,\n  type: IpcMessage['type'],\n  payload: unknown,\n): IpcMessage => ({\n  id: randomUUID(),\n  from,\n  to,\n  type,\n  payload,\n  timestamp: Date.now(),\n});\n","// @ts-expect-error node-ipc has no type declarations\nimport ipc from 'node-ipc';\nimport type { IpcMessage } from '@repo/types';\n\n/**\n * Callback invoked when the client receives a message from the hub.\n */\nexport type ClientMessageHandler = (message: IpcMessage) => void;\n\n/**\n * Options for creating an IPC client connection.\n */\nexport interface IpcClientOptions {\n  /** Unique identifier for this client (e.g. \"agent-news\"). */\n  clientId: string;\n\n  /** The hub server ID to connect to (e.g. \"kindflow-hub\"). */\n  hubId: string;\n\n  /** Called when a message is received from the hub. */\n  onMessage?: ClientMessageHandler;\n\n  /** Called when the client successfully connects to the hub. */\n  onConnect?: () => void;\n\n  /** Called when the client disconnects from the hub. */\n  onDisconnect?: () => void;\n\n  /** Retry interval in milliseconds for reconnection attempts. Defaults to 1500. */\n  retryInterval?: number;\n\n  /** Suppress node-ipc internal logging. Defaults to true. */\n  silent?: boolean;\n}\n\n/**\n * An IPC client that connects to a hub server.\n */\nexport interface IpcClient {\n  /** Initiate connection to the hub. Resolves when connected. */\n  connect: () => Promise<void>;\n\n  /**\n   * Send a message to the hub.\n   *\n   * @param message - the message envelope to send\n   */\n  send: (message: IpcMessage) => void;\n\n  /** Disconnect from the hub. */\n  disconnect: () => void;\n}\n\n/**\n * Create an IPC client that connects to a hub server.\n *\n * The client automatically retries on disconnect using the configured interval.\n * Messages are JSON-serialized over the node-ipc 'message' event channel.\n *\n * @param options - client configuration\n * @returns an IpcClient instance\n */\nexport const createIpcClient = (options: IpcClientOptions): IpcClient => {\n  ipc.config.id = options.clientId;\n  ipc.config.retry = options.retryInterval ?? 1500;\n  ipc.config.silent = options.silent ?? true;\n\n  return {\n    connect(): Promise<void> {\n      return new Promise((resolve) => {\n        ipc.connectTo(options.hubId, () => {\n          ipc.of[options.hubId].on('connect', () => {\n            options.onConnect?.();\n            resolve();\n          });\n\n          ipc.of[options.hubId].on('message', (data: string) => {\n            try {\n              const message = JSON.parse(data) as IpcMessage;\n              options.onMessage?.(message);\n            } catch {\n              /* Ignore malformed messages. */\n            }\n          });\n\n          ipc.of[options.hubId].on('disconnect', () => {\n            options.onDisconnect?.();\n          });\n        });\n      });\n    },\n\n    send(message: IpcMessage): void {\n      const data = JSON.stringify(message);\n      ipc.of[options.hubId].emit('message', data);\n    },\n\n    disconnect(): void {\n      ipc.disconnect(options.hubId);\n    },\n  };\n};\n"],"mappings":";AACA,OAAO,SAAS;AAChB,SAAS,kBAAkB;AAgEpB,IAAM,eAAe,CAAC,YAAmC;AAC9D,MAAI,OAAO,KAAK,QAAQ;AACxB,MAAI,OAAO,QAAQ;AACnB,MAAI,OAAO,SAAS,QAAQ,UAAU;AAEtC,SAAO;AAAA,IACL,QAAuB;AACrB,aAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,YAAI,MAAM,MAAM;AACd,cAAI,OAAO,GAAG,WAAW,CAAC,MAAc,WAA4B;AAClE,gBAAI;AACF,oBAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,oBAAM,WAAW,OAAO,MAAM;AAC9B,sBAAQ,YAAY,SAAS,QAAQ;AAAA,YACvC,QAAQ;AAAA,YAER;AAAA,UACF,CAAC;AAED,cAAI,OAAO,GAAG,WAAW,CAAC,WAA4B;AACpD,oBAAQ,YAAY,OAAO,MAAM,SAAS;AAAA,UAC5C,CAAC;AAGD,cAAI,OAAO,GAAG,uBAAuB,CAAC,WAA4B;AAChE,oBAAQ,eAAe,OAAO,MAAM,SAAS;AAAA,UAC/C,CAAC;AAED,kBAAQ;AAAA,QACV,CAAC;AAED,YAAI,OAAO,MAAM;AAAA,MACnB,CAAC;AAAA,IACH;AAAA,IAEA,OAAO,UAAkB,SAA2B;AAElD,YAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAI,OAAO,KAAK,UAAU,WAAW,IAAI;AAAA,IAC3C;AAAA,IAEA,UAAU,SAA2B;AACnC,YAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAI,OAAO,UAAU,WAAW,IAAI;AAAA,IACtC;AAAA,IAEA,OAAa;AACX,UAAI,OAAO,KAAK;AAAA,IAClB;AAAA,EACF;AACF;AAWO,IAAM,gBAAgB,CAC3B,MACA,IACA,MACA,aACgB;AAAA,EAChB,IAAI,WAAW;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,KAAK,IAAI;AACtB;;;AC1IA,OAAOA,UAAS;AA6DT,IAAM,kBAAkB,CAAC,YAAyC;AACvE,EAAAA,KAAI,OAAO,KAAK,QAAQ;AACxB,EAAAA,KAAI,OAAO,QAAQ,QAAQ,iBAAiB;AAC5C,EAAAA,KAAI,OAAO,SAAS,QAAQ,UAAU;AAEtC,SAAO;AAAA,IACL,UAAyB;AACvB,aAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,QAAAA,KAAI,UAAU,QAAQ,OAAO,MAAM;AACjC,UAAAA,KAAI,GAAG,QAAQ,KAAK,EAAE,GAAG,WAAW,MAAM;AACxC,oBAAQ,YAAY;AACpB,oBAAQ;AAAA,UACV,CAAC;AAED,UAAAA,KAAI,GAAG,QAAQ,KAAK,EAAE,GAAG,WAAW,CAAC,SAAiB;AACpD,gBAAI;AACF,oBAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,sBAAQ,YAAY,OAAO;AAAA,YAC7B,QAAQ;AAAA,YAER;AAAA,UACF,CAAC;AAED,UAAAA,KAAI,GAAG,QAAQ,KAAK,EAAE,GAAG,cAAc,MAAM;AAC3C,oBAAQ,eAAe;AAAA,UACzB,CAAC;AAAA,QACH,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,IAEA,KAAK,SAA2B;AAC9B,YAAM,OAAO,KAAK,UAAU,OAAO;AACnC,MAAAA,KAAI,GAAG,QAAQ,KAAK,EAAE,KAAK,WAAW,IAAI;AAAA,IAC5C;AAAA,IAEA,aAAmB;AACjB,MAAAA,KAAI,WAAW,QAAQ,KAAK;AAAA,IAC9B;AAAA,EACF;AACF;","names":["ipc"]}

package/chunk-2YT53FBK.js

@@ -0,0 +1,38 @@
+// ../telegram/src/client.ts
+import TelegramBot from "node-telegram-bot-api";
+var createTelegramClient = (config) => {
+  const bot = new TelegramBot(config.token, {
+    polling: config.polling ?? false
+  });
+  return {
+    sendMessage: (chatId, text) => bot.sendMessage(chatId, text),
+    sendPhoto: (chatId, photo) => bot.sendPhoto(chatId, photo),
+    onMessage: (handler) => {
+      bot.on("message", handler);
+    },
+    start: () => {
+      if (!bot.isPolling()) {
+        bot.startPolling();
+      }
+    },
+    stop: async () => {
+      if (bot.isPolling()) {
+        await bot.stopPolling();
+      }
+    },
+    verify: async () => {
+      try {
+        const me = await bot.getMe();
+        return { ok: true, username: me.username ?? "" };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        return { ok: false, error: message };
+      }
+    }
+  };
+};
+
+export {
+  createTelegramClient
+};
+//# sourceMappingURL=chunk-2YT53FBK.js.map

package/chunk-2YT53FBK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../telegram/src/client.ts"],"sourcesContent":["/**\n * Reusable Telegram bot client wrapping `node-telegram-bot-api`.\n *\n * Provides a thin, typed interface for sending and receiving messages.\n * Used both by the telegram-runner (daemon-managed polling process)\n * and by agent scripts that send messages proactively.\n */\n\nimport TelegramBot from 'node-telegram-bot-api';\n\n/**\n * Configuration for creating a Telegram client.\n */\nexport interface TelegramClientConfig {\n  /** Bot API token from @BotFather. */\n  token: string;\n\n  /** Whether to start long polling. Defaults to false (send-only mode). */\n  polling?: boolean;\n}\n\n/**\n * Callback for incoming Telegram messages.\n */\nexport type MessageHandler = (message: TelegramBot.Message) => void;\n\n/**\n * A typed Telegram bot client with send, receive, and verify capabilities.\n */\nexport interface TelegramClient {\n  /** Send a text message to a chat. Returns the sent message. */\n  sendMessage: (chatId: number | string, text: string) => Promise<TelegramBot.Message>;\n\n  /** Send a photo to a chat. Returns the sent message. */\n  sendPhoto: (chatId: number | string, photo: string | Buffer) => Promise<TelegramBot.Message>;\n\n  /** Register a handler for incoming text messages. */\n  onMessage: (handler: MessageHandler) => void;\n\n  /** Start polling for messages (if not already started). */\n  start: () => void;\n\n  /** Stop polling and clean up resources. */\n  stop: () => Promise<void>;\n\n  /**\n   * Verify the bot token by calling getMe().\n   * Returns the bot username on success, or an error message on failure.\n   */\n  verify: () => Promise<{ ok: true; username: string } | { ok: false; error: string }>;\n}\n\n/**\n * Create a Telegram bot client.\n *\n * @param config - bot token and polling configuration\n * @returns a TelegramClient instance\n */\nexport const createTelegramClient = (config: TelegramClientConfig): TelegramClient => {\n  const bot = new TelegramBot(config.token, {\n    polling: config.polling ?? false,\n  });\n\n  return {\n    sendMessage: (chatId, text) => bot.sendMessage(chatId, text),\n\n    sendPhoto: (chatId, photo) => bot.sendPhoto(chatId, photo),\n\n    onMessage: (handler) => {\n      bot.on('message', handler);\n    },\n\n    start: () => {\n      if (!bot.isPolling()) {\n        bot.startPolling();\n      }\n    },\n\n    stop: async () => {\n      if (bot.isPolling()) {\n        await bot.stopPolling();\n      }\n    },\n\n    verify: async () => {\n      try {\n        const me = await bot.getMe();\n        return { ok: true, username: me.username ?? '' };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : 'Unknown error';\n        return { ok: false, error: message };\n      }\n    },\n  };\n};\n"],"mappings":";AAQA,OAAO,iBAAiB;AAkDjB,IAAM,uBAAuB,CAAC,WAAiD;AACpF,QAAM,MAAM,IAAI,YAAY,OAAO,OAAO;AAAA,IACxC,SAAS,OAAO,WAAW;AAAA,EAC7B,CAAC;AAED,SAAO;AAAA,IACL,aAAa,CAAC,QAAQ,SAAS,IAAI,YAAY,QAAQ,IAAI;AAAA,IAE3D,WAAW,CAAC,QAAQ,UAAU,IAAI,UAAU,QAAQ,KAAK;AAAA,IAEzD,WAAW,CAAC,YAAY;AACtB,UAAI,GAAG,WAAW,OAAO;AAAA,IAC3B;AAAA,IAEA,OAAO,MAAM;AACX,UAAI,CAAC,IAAI,UAAU,GAAG;AACpB,YAAI,aAAa;AAAA,MACnB;AAAA,IACF;AAAA,IAEA,MAAM,YAAY;AAChB,UAAI,IAAI,UAAU,GAAG;AACnB,cAAM,IAAI,YAAY;AAAA,MACxB;AAAA,IACF;AAAA,IAEA,QAAQ,YAAY;AAClB,UAAI;AACF,cAAM,KAAK,MAAM,IAAI,MAAM;AAC3B,eAAO,EAAE,IAAI,MAAM,UAAU,GAAG,YAAY,GAAG;AAAA,MACjD,SAAS,KAAK;AACZ,cAAM,UAAU,eAAe,QAAQ,IAAI,UAAU;AACrD,eAAO,EAAE,IAAI,OAAO,OAAO,QAAQ;AAAA,MACrC;AAAA,IACF;AAAA,EACF;AACF;","names":[]}