clawmini 0.0.1 → 0.0.2

package/README.md

@@ -1,98 +1,91 @@
 # Clawmini
 
-Clawmini is an orchestration layer for command-line AI agents, providing a unified chat experience that can span multiple conversations and multiple agents. Ultimately, it aims to deliver a personal assistant experience built entirely on top of your local tools and agents.
+**The secure, local-first orchestrator for your AI agents.**
 
-## Features
+Clawmini gives you the power of a proactive personal AI assistant, without compromising your system's security. Unlike other local agents that run with unrestricted access to your machine, Clawmini is built from the ground up with **sandboxing**, **human-in-the-loop approvals**, and **strict network isolation**.
 
-- **Persistent, Multi-Agent Chat Sessions:** Maintain separate chats for different tasks, allowing you to converse with multiple agents across multiple conversations.
-- **Safe Concurrency:** Automatically manages state and handles race conditions, queuing background commands safely to prevent file lock issues.
-- **Built-in & Bring-Your-Own UI:** Includes a fast, beautifully designed SvelteKit Web UI to visually manage agents, chats, and monitor real-time execution. Alternatively, easily build and connect your own interfaces to its local API.
-- **Agent Templates:** Quickly scaffold new agents using built-in or custom templates (e.g. `gemini`), automatically merging configuration settings.
-- **Routers & Middleware Pipeline:** Process user messages through an extensible pipeline to dynamically alter content, target specific agents or sessions, and expand slash commands before they reach an agent.
-- **Local File System Storage:** Everything is stored completely locally in `.clawmini/` within your workspace as transparent JSON/JSONL files. No cloud syncing required.
-- **Sandboxed Agent API:** The daemon can optionally expose a secure HTTP server configured via the `api` setting in `.clawmini/settings.json`, allowing remote or containerized access. Give agents a minimal zero-dependency standalone client exported via `clawmini export-lite`. It securely authenticates with the Agent API using dynamically generated HMAC tokens (`CLAW_API_TOKEN`) to allow sandboxed agents to log messages and manage cron jobs without needing direct access to the host's Unix socket.
-- **Proactivity:** Incoming messages or events from various external sources can be proactively routed back to the user or directly to the agent for autonomous handling.
+Bring your favorite CLI agents (Gemini CLI, Claude Code, OpenAI Codex, etc.), and Clawmini provides the memory, the chat support, and the security boundaries.
 
-### Coming Soon
+## Why Clawmini?
 
-- **Human Approval Requests:** When an agent needs permission to execute a sensitive action or requires input, it will pause and ask the user for approval via a dedicated UI or dashboard.
+🛡️ **Zero-Trust Security by Default**
+Run agents safely. Clawmini uses built-in sandboxing (macOS seatbelt or containerized environments) to restrict what your AI can touch. Sensitive actions require your explicit approval before execution.
 
-## Quick Start
+🧠 **Persistent Memory & Proactivity**
+Your agents don't just react; they act. Clawmini allows agents to schedule recurring tasks (cron jobs), maintain long-term context across sessions, and proactively notify you of updates or route messages from external sources.
 
-Assuming you have built and linked the package globally:
+💻 **Beautiful Web UI & Chat App Extensibility**
+No need to stay in the terminal. Manage your agents and chat with them through a fast, built-in Web interface running entirely on `localhost`. Hook up Discord to chat on-the-go, or easily build your adapters against the local API.
 
-```bash
-# Initialize a new .clawmini settings folder, create an agent named 'coder' with the 'gemini-cladding' template, and set it as the default chat
-clawmini init --agent coder --agent-template gemini-cladding
-
-# Start the local web interface on http://localhost:8080
-clawmini web
-```
+🔌 **Bring Your Own Agent**
+Clawmini isn't tied to one model. It orchestrates _any_ CLI-based agent, acting as the secure bridge between the AI and your filesystem.
 
-## Command Reference
+## Quick Start: Meet Jeeves
 
-### Initialization & Daemon
+Let's set up a secure, sandboxed agent named Jeeves using the Gemini CLI template.
 
-- `clawmini init`: Initialize a new `.clawmini` configuration folder.
-- `clawmini up`: Start the local daemon server in the background.
-- `clawmini down`: Stop the local daemon server.
-- `clawmini export-lite [--out <path>] [--stdout]`: Export the standalone `clawmini-lite` client script for use in sandboxed environments.
+```bash
+# 1. Install globally
+npm install -g clawmini
 
-### Chat Management
+# 2. Initialize a workspace and create your first sandboxed agent
+# For a more OpenClaw-like experience, try the gemini-claw template
+mkdir my-workspace && cd my-workspace
+clawmini init --agent jeeves --agent-template gemini --environment macos
 
-- `clawmini chats list`: Display all existing chats in the workspace.
-- `clawmini chats add <id>`: Create a new chat with the specified identifier.
-- `clawmini chats delete <id>`: Remove a chat and its associated history.
-- `clawmini chats set-default <id>`: Update the globally configured default chat for the workspace.
+# 3. Start the background daemon
+clawmini up
 
-### Messaging
+# 4. Open the Web UI to start chatting!
+clawmini web
+```
 
-- `clawmini messages send <message> [--chat <id>] [--agent <name>]`: Send a message to a specific chat (defaults to the workspace default chat). Use `--agent` to assign a specific agent to handle the message.
-- `clawmini messages tail [-n NUM] [--json] [--chat <id>]`: Display the most recent messages and command logs in a chat.
+**Try asking Jeeves:** _"Summarize the recent changes in my git repository."_ Jeeves will run securely in its sandbox, read the diffs, and report back.
 
-### Agents
+### Common Slash Commands
 
-- `clawmini agents list`: Display all existing agents.
-- `clawmini agents add <id> [-d, --directory <dir>] [-t, --template <name>] [-e, --env <KEY=VALUE>...]`: Create a new agent, optionally setting its working directory, applying a template, and environment variables.
-- `clawmini agents update <id> [-d, --directory <dir>] [-e, --env <KEY=VALUE>...]`: Update an existing agent's configuration.
-- `clawmini agents delete <id>`: Remove an agent.
+You can use these built-in slash commands in your chat interfaces:
 
-### Cron Jobs
+- `/new`: Clear previous context and start a new conversation thread.
+- `/stop`: Stop all running commands and drop any queued messages.
+- `/interrupt [message]`: Interrupt the current thinking, batching together all queued messages and sending them immediately.
+- `/pending`: View any pending permission requests from your agent.
+- `/approve [id]`: Approve a specific pending agent request.
+- `/reject [id]`: Reject a specific pending agent request.
 
-- `clawmini cron list [--chat <id>]`: Display all cron jobs configured for a chat.
-- `clawmini cron add <name> [--cron <expr> | --every <duration> | --at <iso-time>] [-m, --message <text>]`: Create a new scheduled job. Supports standard cron expressions, recurring intervals (e.g., `10m`), or one-off executions at a specific time.
-- `clawmini cron delete <name> [--chat <id>]`: Remove an existing scheduled job.
+### Guides & Integrations
 
-### Web Interface
+- [Discord Integration Setup](./docs/guides/discord_adapter_setup.md)
+- [Configuring Permission Requests](./docs/guides/sandbox_policies.md)
 
-- `clawmini web [-p, --port <number>]`: Start the local web interface (default port: 8080).
+## How It Works
 
-## Configuration
+**User** ↔️ **Web UI / CLI** ↔️ **Daemon** ↔️ **Sandbox / Environment** ↔️ **Agent**
 
-## Global settings
+The daemon securely authenticates with the Agent API using dynamically generated HMAC tokens (`CLAW_API_TOKEN`), allowing sandboxed agents to operate safely without direct access to the host's Unix socket.
 
-**TODO**
+### Built-in Environments
 
-## Routers
+- `cladding` (most secure): A container-based sandbox using [cladding](https://github.com/dstoc/cladding)
+- `macos`: A macOS sandbox environment that restricts write-access to the workspace.
+- `macos-proxy`: A more constrained macOS sandbox that limits network access to an allowlist.
 
-Clawmini provides an extensible pipeline for processing user messages before they reach an agent using **Routers**. By defining a sequence of routers in your `.clawmini/settings.json` (global) or per-chat settings, you can dynamically alter message content, target specific agents or sessions, inject environment variables, and add automated replies.
+### Extensible Pipeline (Routers)
 
-Built-in routers include:
+Process user messages before they reach an agent. Dynamically alter content, target specific agents, or expand slash commands (e.g., `/new` to clear context, `/foo` to expand a command script).
 
-- `@clawmini/slash-new`: Creates a new session ID when a message starts with `/new`, effectively clearing the context window for the agent.
-- `@clawmini/slash-command`: Expands slash commands (e.g., `/foo`) with the contents of matching files in your `.clawmini/commands/` directory.
+## Next Steps: Build Autonomous Workflows
 
-You can also write custom shell script routers that accept the current state via `stdin` and output JSON to dynamically control the routing logic. See the [`RouterState` interface](src/daemon/routers/types.ts) for the exact input and output schema.
+Once you're comfortable, Clawmini offers powerful tools for advanced users:
 
-## Agent Templates
+- **The `gemini-claw` Template:** Scaffold a complete autonomous assistant with built-in memory management (`MEMORY.md`), identity (`SOUL.md`), and heartbeat checks (`HEARTBEAT.md`) for proactive tasking.
+- **`clawmini-lite`:** Deploy agents into heavily restricted containers. Export the minimal, zero-dependency client (`clawmini export-lite`) to securely authenticate with the daemon, allowing the agent to log actions and request permissions without host access.
 
-Clawmini provides built-in templates to help you quickly scaffold new agents with pre-configured settings and files. When you run `clawmini agents add <id> --template <name>`, it copies the template's files into the agent's working directory and merges any provided environment variables or directory options with the template's `settings.json`.
+---
 
-The currently available built-in templates are:
+## Documentation & References
 
-- `gemini`: A basic template configured to use the `gemini` CLI as the agent's backend.
-- `gemini-cladding`: A template configured to run the `gemini` CLI wrapped inside `cladding` for enhanced security.
-- `gemini-claw-cladding`: A comprehensive template that sets up an autonomous personal assistant workspace (OpenClaw). It includes the `gemini-cladding` setup plus a full suite of scaffolding files like `GEMINI.md`, `SOUL.md`, `MEMORY.md`, and `HEARTBEAT.md` to establish the agent's identity, memory, and proactive capabilities.
+For a full list of commands for managing chats, messages, agents, background jobs, and environments, please see the [CLI Command Reference](./docs/CLI_REFERENCE.md).
 
 ## Development Setup
 
@@ -103,35 +96,25 @@ Clawmini is a monorepo consisting of a Node.js TypeScript CLI/Daemon and an embe
 - Node.js (v18+)
 - npm
 
-### Setup
+### Setup & Scripts
 
 ```bash
-# Install dependencies for both the root CLI and the web workspace
+# Install dependencies and build the project
 npm install
-
-# Build the CLI, Daemon, and statically compile the Web UI
 npm run build
-```
-
-### Development Scripts
 
-During development, you can run the following commands from the root:
-
-```bash
-# Watch mode for the CLI
+# Development Watch Modes
 npm run dev:cli
-
-# Watch mode for the Daemon
 npm run dev:daemon
 
-# Run formatting, linting, type-checking, and tests
+# Linting & Testing
 npm run format
 npm run lint
 npm run check
 npm run test
 ```
 
-## Architecture Notes
+**Architecture Notes:**
 
 - **Separation of Concerns:** The daemon (`src/daemon`) acts as the stateful orchestrator and queue manager, while the CLI (`src/cli`) is simply a thin TRPC client connecting via a UNIX socket.
-- **Web UI:** The `web/` directory is a SvelteKit application built with `@sveltejs/adapter-static`. Running `npm run build` bundles the web UI into `dist/web`, which is then served statically by the `clawmini web` Node.js server. Real-time updates to the web UI are powered by Server-Sent Events (SSE) tailing the local `.clawmini/chats/:id/chat.jsonl` files.
+- **Web UI:** The `web/` directory is a SvelteKit application built with `@sveltejs/adapter-static`. Running `npm run build` bundles the web UI into `dist/web`, which is served statically by the `clawmini web` Node.js server. Real-time updates use Server-Sent Events (SSE) tailing local `.clawmini/chats/:id/chat.jsonl` files.

package/dist/adapter-discord/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { l as getSocketPath, o as getClawminiDir, u as getWorkspaceRoot } from "../workspace-CSgfo_2J.mjs";
+import { l as getSocketPath, o as getClawminiDir, u as getWorkspaceRoot } from "../workspace-BC1ahx4R.mjs";
 import { t as createUnixSocketFetch } from "../fetch-BjZVyU3Z.mjs";
 import fs from "node:fs";
 import path from "node:path";
@@ -387,7 +387,7 @@ async function main() {
 		console.log(`Received message from ${message.author.tag}: ${message.content}`);
 		const downloadedFiles = [];
 		if (message.attachments.size > 0) {
-			const { getClawminiDir } = await import("../workspace-CSgfo_2J.mjs").then((n) => n._);
+			const { getClawminiDir } = await import("../workspace-BC1ahx4R.mjs").then((n) => n.v);
 			const tmpDir = path.join(getClawminiDir(process.cwd()), "tmp", "discord");
 			await fs$1.mkdir(tmpDir, { recursive: true });
 			const maxSizeMB = config.maxAttachmentSizeMB ?? 25;

package/dist/{chats-Zd_HXDHx.mjs → chats-BcbxvPlj.mjs}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-95iHPtFO.mjs";
-import { n as appendMessage$1 } from "./chats-DKgTeU7i.mjs";
+import { n as appendMessage$1 } from "./chats-CpRQrNHj.mjs";
 import { EventEmitter } from "node:events";
 
 //#region src/daemon/events.ts
@@ -26,4 +26,4 @@ async function appendMessage(id, message, startDir = process.cwd()) {
 
 //#endregion
 export { daemonEvents as a, DAEMON_EVENT_TYPING as i, chats_exports as n, emitTyping as o, DAEMON_EVENT_MESSAGE_APPENDED as r, appendMessage as t };
-//# sourceMappingURL=chats-Zd_HXDHx.mjs.map
+//# sourceMappingURL=chats-BcbxvPlj.mjs.map

package/dist/{chats-Zd_HXDHx.mjs.map → chats-BcbxvPlj.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"chats-Zd_HXDHx.mjs","names":["shared.appendMessage"],"sources":["../src/daemon/events.ts","../src/daemon/chats.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { ChatMessage } from '../shared/chats.js';\n\nexport const daemonEvents = new EventEmitter();\n\nexport const DAEMON_EVENT_MESSAGE_APPENDED = 'message-appended';\nexport const DAEMON_EVENT_TYPING = 'typing';\n\nexport function emitMessageAppended(chatId: string, message: ChatMessage) {\n  daemonEvents.emit(DAEMON_EVENT_MESSAGE_APPENDED, { chatId, message });\n}\n\nexport function emitTyping(chatId: string) {\n  daemonEvents.emit(DAEMON_EVENT_TYPING, { chatId });\n}\n","import * as shared from '../shared/chats.js';\nimport { emitMessageAppended } from './events.js';\n\nexport async function appendMessage(\n  id: string,\n  message: shared.ChatMessage,\n  startDir = process.cwd()\n): Promise<void> {\n  await shared.appendMessage(id, message, startDir);\n  emitMessageAppended(id, message);\n}\n\nexport {\n  type ChatMessage,\n  type UserMessage,\n  type CommandLogMessage,\n  getChatsDir,\n  isValidChatId,\n  createChat,\n  listChats,\n  deleteChat,\n  getMessages,\n  getDefaultChatId,\n  setDefaultChatId,\n  DEFAULT_CHAT_ID,\n} from '../shared/chats.js';\n"],"mappings":";;;;;AAGA,MAAa,eAAe,IAAI,cAAc;AAE9C,MAAa,gCAAgC;AAC7C,MAAa,sBAAsB;AAEnC,SAAgB,oBAAoB,QAAgB,SAAsB;AACxE,cAAa,KAAK,+BAA+B;EAAE;EAAQ;EAAS,CAAC;;AAGvE,SAAgB,WAAW,QAAgB;AACzC,cAAa,KAAK,qBAAqB,EAAE,QAAQ,CAAC;;;;;;ACVpD,eAAsB,cACpB,IACA,SACA,WAAW,QAAQ,KAAK,EACT;AACf,OAAMA,gBAAqB,IAAI,SAAS,SAAS;AACjD,qBAAoB,IAAI,QAAQ"}
+{"version":3,"file":"chats-BcbxvPlj.mjs","names":["shared.appendMessage"],"sources":["../src/daemon/events.ts","../src/daemon/chats.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport type { ChatMessage } from '../shared/chats.js';\n\nexport const daemonEvents = new EventEmitter();\n\nexport const DAEMON_EVENT_MESSAGE_APPENDED = 'message-appended';\nexport const DAEMON_EVENT_TYPING = 'typing';\n\nexport function emitMessageAppended(chatId: string, message: ChatMessage) {\n  daemonEvents.emit(DAEMON_EVENT_MESSAGE_APPENDED, { chatId, message });\n}\n\nexport function emitTyping(chatId: string) {\n  daemonEvents.emit(DAEMON_EVENT_TYPING, { chatId });\n}\n","import * as shared from '../shared/chats.js';\nimport { emitMessageAppended } from './events.js';\n\nexport async function appendMessage(\n  id: string,\n  message: shared.ChatMessage,\n  startDir = process.cwd()\n): Promise<void> {\n  await shared.appendMessage(id, message, startDir);\n  emitMessageAppended(id, message);\n}\n\nexport {\n  type ChatMessage,\n  type UserMessage,\n  type CommandLogMessage,\n  getChatsDir,\n  isValidChatId,\n  createChat,\n  listChats,\n  deleteChat,\n  getMessages,\n  getDefaultChatId,\n  setDefaultChatId,\n  DEFAULT_CHAT_ID,\n} from '../shared/chats.js';\n"],"mappings":";;;;;AAGA,MAAa,eAAe,IAAI,cAAc;AAE9C,MAAa,gCAAgC;AAC7C,MAAa,sBAAsB;AAEnC,SAAgB,oBAAoB,QAAgB,SAAsB;AACxE,cAAa,KAAK,+BAA+B;EAAE;EAAQ;EAAS,CAAC;;AAGvE,SAAgB,WAAW,QAAgB;AACzC,cAAa,KAAK,qBAAqB,EAAE,QAAQ,CAAC;;;;;;ACVpD,eAAsB,cACpB,IACA,SACA,WAAW,QAAQ,KAAK,EACT;AACf,OAAMA,gBAAqB,IAAI,SAAS,SAAS;AACjD,qBAAoB,IAAI,QAAQ"}

package/dist/{chats-DKgTeU7i.mjs → chats-CpRQrNHj.mjs}

@@ -1,4 +1,4 @@
-import { c as getSettingsPath, o as getClawminiDir } from "./workspace-CSgfo_2J.mjs";
+import { c as getSettingsPath, o as getClawminiDir } from "./workspace-BC1ahx4R.mjs";
 import { n as pathIsInsideDir } from "./fs-B5wW0oaH.mjs";
 import { existsSync } from "node:fs";
 import path from "node:path";
@@ -88,4 +88,4 @@ async function setDefaultChatId(id, startDir = process.cwd()) {
 
 //#endregion
 export { getChatsDir as a, isValidChatId as c, deleteChat as i, listChats as l, appendMessage as n, getDefaultChatId as o, createChat as r, getMessages as s, DEFAULT_CHAT_ID as t, setDefaultChatId as u };
-//# sourceMappingURL=chats-DKgTeU7i.mjs.map
+//# sourceMappingURL=chats-CpRQrNHj.mjs.map

package/dist/{chats-DKgTeU7i.mjs.map → chats-CpRQrNHj.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"chats-DKgTeU7i.mjs","names":["fs"],"sources":["../src/shared/chats.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { getClawminiDir, getSettingsPath } from './workspace.js';\nimport { pathIsInsideDir } from './utils/fs.js';\n\nexport const DEFAULT_CHAT_ID = 'default';\n\nexport interface UserMessage {\n  id: string;\n  role: 'user';\n  content: string;\n  timestamp: string;\n}\n\nexport interface CommandLogMessage {\n  id: string;\n  messageId: string;\n  role: 'log';\n  source?: 'router';\n  content: string;\n  stderr: string;\n  timestamp: string;\n  command: string;\n  cwd: string;\n  exitCode: number;\n  stdout?: string;\n  files?: string[];\n  level?: 'default' | 'debug' | 'verbose';\n}\n\nexport type ChatMessage = UserMessage | CommandLogMessage;\n\nexport async function getChatsDir(startDir = process.cwd()): Promise<string> {\n  const dir = path.join(getClawminiDir(startDir), 'chats');\n  if (!existsSync(dir)) {\n    await fs.mkdir(dir, { recursive: true });\n  }\n  return dir;\n}\n\nexport function isValidChatId(chatId: string): boolean {\n  if (!chatId || chatId.length === 0) return false;\n  return /^[a-zA-Z0-9_-]+$/.test(chatId);\n}\n\nfunction assertValidChatId(id: string): void {\n  if (!isValidChatId(id)) {\n    throw new Error(`Invalid chat ID: ${id}`);\n  }\n}\n\nexport async function createChat(id: string, startDir = process.cwd()): Promise<void> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatDir = path.join(chatsDir, id);\n  if (!existsSync(chatDir)) {\n    await fs.mkdir(chatDir, { recursive: true });\n  }\n  const chatFile = path.join(chatDir, 'chat.jsonl');\n  if (!existsSync(chatFile)) {\n    await fs.writeFile(chatFile, '');\n  }\n}\n\nexport async function listChats(startDir = process.cwd()): Promise<string[]> {\n  const chatsDir = await getChatsDir(startDir);\n  try {\n    const entries = await fs.readdir(chatsDir, { withFileTypes: true });\n    return entries.filter((e) => e.isDirectory()).map((e) => e.name);\n  } catch {\n    return [];\n  }\n}\n\nexport async function deleteChat(id: string, startDir = process.cwd()): Promise<void> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatDir = path.join(chatsDir, id);\n\n  if (!pathIsInsideDir(chatDir, chatsDir)) {\n    throw new Error(`Security Error: Cannot delete chat directory outside of ${chatsDir}`);\n  }\n\n  if (existsSync(chatDir)) {\n    await fs.rm(chatDir, { recursive: true, force: true });\n  }\n}\n\nexport async function appendMessage(\n  id: string,\n  message: ChatMessage,\n  startDir = process.cwd()\n): Promise<void> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatDir = path.join(chatsDir, id);\n  if (!existsSync(chatDir)) {\n    await createChat(id, startDir);\n  }\n  const chatFile = path.join(chatDir, 'chat.jsonl');\n  await fs.appendFile(chatFile, JSON.stringify(message) + '\\n');\n}\n\nexport async function getMessages(\n  id: string,\n  limit?: number,\n  startDir = process.cwd()\n): Promise<ChatMessage[]> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatFile = path.join(chatsDir, id, 'chat.jsonl');\n  if (!existsSync(chatFile)) {\n    throw new Error(`Chat directory or file for '${id}' not found.`);\n  }\n  const content = await fs.readFile(chatFile, 'utf8');\n  const lines = content.split('\\n').filter((line) => line.trim() !== '');\n  const messages = lines.map((line) => JSON.parse(line) as ChatMessage);\n\n  if (limit !== undefined && limit > 0) {\n    return messages.slice(-limit);\n  }\n  return messages;\n}\n\nexport async function getDefaultChatId(startDir = process.cwd()): Promise<string> {\n  const settingsPath = getSettingsPath(startDir);\n  if (!existsSync(settingsPath)) return DEFAULT_CHAT_ID;\n\n  try {\n    const content = await fs.readFile(settingsPath, 'utf8');\n    const settings = JSON.parse(content);\n    return settings.chats?.defaultId || DEFAULT_CHAT_ID;\n  } catch {\n    return DEFAULT_CHAT_ID;\n  }\n}\n\nexport async function setDefaultChatId(id: string, startDir = process.cwd()): Promise<void> {\n  assertValidChatId(id);\n  const settingsPath = getSettingsPath(startDir);\n  let settings: { chats?: { defaultId?: string; [key: string]: unknown }; [key: string]: unknown } =\n    {};\n  if (existsSync(settingsPath)) {\n    try {\n      const content = await fs.readFile(settingsPath, 'utf8');\n      settings = JSON.parse(content);\n    } catch {\n      // Ignore invalid JSON\n    }\n  }\n\n  if (!settings.chats) {\n    settings.chats = {};\n  }\n  settings.chats.defaultId = id;\n\n  const clawminiDir = getClawminiDir(startDir);\n  if (!existsSync(clawminiDir)) {\n    await fs.mkdir(clawminiDir, { recursive: true });\n  }\n\n  await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));\n}\n"],"mappings":"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"}
+{"version":3,"file":"chats-CpRQrNHj.mjs","names":["fs"],"sources":["../src/shared/chats.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { getClawminiDir, getSettingsPath } from './workspace.js';\nimport { pathIsInsideDir } from './utils/fs.js';\n\nexport const DEFAULT_CHAT_ID = 'default';\n\nexport interface UserMessage {\n  id: string;\n  role: 'user';\n  content: string;\n  timestamp: string;\n}\n\nexport interface CommandLogMessage {\n  id: string;\n  messageId: string;\n  role: 'log';\n  source?: 'router';\n  content: string;\n  stderr: string;\n  timestamp: string;\n  command: string;\n  cwd: string;\n  exitCode: number;\n  stdout?: string;\n  files?: string[];\n  level?: 'default' | 'debug' | 'verbose';\n}\n\nexport type ChatMessage = UserMessage | CommandLogMessage;\n\nexport async function getChatsDir(startDir = process.cwd()): Promise<string> {\n  const dir = path.join(getClawminiDir(startDir), 'chats');\n  if (!existsSync(dir)) {\n    await fs.mkdir(dir, { recursive: true });\n  }\n  return dir;\n}\n\nexport function isValidChatId(chatId: string): boolean {\n  if (!chatId || chatId.length === 0) return false;\n  return /^[a-zA-Z0-9_-]+$/.test(chatId);\n}\n\nfunction assertValidChatId(id: string): void {\n  if (!isValidChatId(id)) {\n    throw new Error(`Invalid chat ID: ${id}`);\n  }\n}\n\nexport async function createChat(id: string, startDir = process.cwd()): Promise<void> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatDir = path.join(chatsDir, id);\n  if (!existsSync(chatDir)) {\n    await fs.mkdir(chatDir, { recursive: true });\n  }\n  const chatFile = path.join(chatDir, 'chat.jsonl');\n  if (!existsSync(chatFile)) {\n    await fs.writeFile(chatFile, '');\n  }\n}\n\nexport async function listChats(startDir = process.cwd()): Promise<string[]> {\n  const chatsDir = await getChatsDir(startDir);\n  try {\n    const entries = await fs.readdir(chatsDir, { withFileTypes: true });\n    return entries.filter((e) => e.isDirectory()).map((e) => e.name);\n  } catch {\n    return [];\n  }\n}\n\nexport async function deleteChat(id: string, startDir = process.cwd()): Promise<void> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatDir = path.join(chatsDir, id);\n\n  if (!pathIsInsideDir(chatDir, chatsDir)) {\n    throw new Error(`Security Error: Cannot delete chat directory outside of ${chatsDir}`);\n  }\n\n  if (existsSync(chatDir)) {\n    await fs.rm(chatDir, { recursive: true, force: true });\n  }\n}\n\nexport async function appendMessage(\n  id: string,\n  message: ChatMessage,\n  startDir = process.cwd()\n): Promise<void> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatDir = path.join(chatsDir, id);\n  if (!existsSync(chatDir)) {\n    await createChat(id, startDir);\n  }\n  const chatFile = path.join(chatDir, 'chat.jsonl');\n  await fs.appendFile(chatFile, JSON.stringify(message) + '\\n');\n}\n\nexport async function getMessages(\n  id: string,\n  limit?: number,\n  startDir = process.cwd()\n): Promise<ChatMessage[]> {\n  assertValidChatId(id);\n  const chatsDir = await getChatsDir(startDir);\n  const chatFile = path.join(chatsDir, id, 'chat.jsonl');\n  if (!existsSync(chatFile)) {\n    throw new Error(`Chat directory or file for '${id}' not found.`);\n  }\n  const content = await fs.readFile(chatFile, 'utf8');\n  const lines = content.split('\\n').filter((line) => line.trim() !== '');\n  const messages = lines.map((line) => JSON.parse(line) as ChatMessage);\n\n  if (limit !== undefined && limit > 0) {\n    return messages.slice(-limit);\n  }\n  return messages;\n}\n\nexport async function getDefaultChatId(startDir = process.cwd()): Promise<string> {\n  const settingsPath = getSettingsPath(startDir);\n  if (!existsSync(settingsPath)) return DEFAULT_CHAT_ID;\n\n  try {\n    const content = await fs.readFile(settingsPath, 'utf8');\n    const settings = JSON.parse(content);\n    return settings.chats?.defaultId || DEFAULT_CHAT_ID;\n  } catch {\n    return DEFAULT_CHAT_ID;\n  }\n}\n\nexport async function setDefaultChatId(id: string, startDir = process.cwd()): Promise<void> {\n  assertValidChatId(id);\n  const settingsPath = getSettingsPath(startDir);\n  let settings: { chats?: { defaultId?: string; [key: string]: unknown }; [key: string]: unknown } =\n    {};\n  if (existsSync(settingsPath)) {\n    try {\n      const content = await fs.readFile(settingsPath, 'utf8');\n      settings = JSON.parse(content);\n    } catch {\n      // Ignore invalid JSON\n    }\n  }\n\n  if (!settings.chats) {\n    settings.chats = {};\n  }\n  settings.chats.defaultId = id;\n\n  const clawminiDir = getClawminiDir(startDir);\n  if (!existsSync(clawminiDir)) {\n    await fs.mkdir(clawminiDir, { recursive: true });\n  }\n\n  await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));\n}\n"],"mappings":"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"}

package/dist/cli/index.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { a as getAgent, b as writeChatSettings, d as isValidAgentId, f as listAgents, g as readSettings, l as getSocketPath, m as readChatSettings, n as deleteAgent, o as getClawminiDir, r as enableEnvironment, t as applyTemplateToAgent, x as writeSettings, y as writeAgentSettings } from "../workspace-CSgfo_2J.mjs";
+import { S as writeSettings, _ as readSettings, a as getAgent, b as writeAgentSettings, d as isValidAgentId, f as listAgents, l as getSocketPath, m as readChatSettings, n as deleteAgent, o as getClawminiDir, r as enableEnvironment, t as applyTemplateToAgent, x as writeChatSettings } from "../workspace-BC1ahx4R.mjs";
 import { n as pathIsInsideDir } from "../fs-B5wW0oaH.mjs";
-import { a as getChatsDir, c as isValidChatId, i as deleteChat, l as listChats, o as getDefaultChatId, r as createChat, s as getMessages, t as DEFAULT_CHAT_ID, u as setDefaultChatId } from "../chats-DKgTeU7i.mjs";
+import { a as getChatsDir, c as isValidChatId, i as deleteChat, l as listChats, o as getDefaultChatId, r as createChat, s as getMessages, t as DEFAULT_CHAT_ID, u as setDefaultChatId } from "../chats-CpRQrNHj.mjs";
 import { t as createUnixSocketFetch } from "../fetch-BjZVyU3Z.mjs";
-import { i as writeLiteScript, r as getLiteScriptContent, t as exportLiteToAllEnvironments } from "../lite-Dl7WXyaH.mjs";
+import { i as writeLiteScript, r as getLiteScriptContent, t as exportLiteToAllEnvironments } from "../lite-DBUuHsX0.mjs";
 import { Command } from "commander";
 import fs from "node:fs";
 import path from "node:path";
@@ -56,6 +56,7 @@ const initCmd = new Command("init").description("Initialize a new .clawmini sett
 			"@clawmini/slash-new",
 			"@clawmini/slash-stop",
 			"@clawmini/slash-interrupt",
+			"@clawmini/slash-policies",
 			"@clawmini/slash-command"
 		],
 		api: true