nemoris 0.1.0 → 0.1.2

package/.env.example

@@ -1,49 +1,49 @@
-# ============================================================
-# Nemoris — Environment Variables
-# Copy this file to .env and fill in your values
-# Run: nemoris setup  (walks you through the essentials)
-# ============================================================
-
-# ---- Anthropic (required for cloud AI) --------------------
-NEMORIS_ANTHROPIC_API_KEY=          # Get from console.anthropic.com
-
-# ---- OpenRouter (optional — fallback + Perplexity search) --
-OPENROUTER_API_KEY=                  # Get from openrouter.ai
-
-# ---- Telegram (required for Telegram channel) -------------
-NEMORIS_TELEGRAM_BOT_TOKEN=          # From @BotFather on Telegram
-NEMORIS_TELEGRAM_CHAT_ID=            # Your Telegram user/chat ID
-NEMORIS_ALLOW_ANY_CHAT=false         # true = accept messages from any chat (dev only)
-NEMORIS_ALLOW_TELEGRAM_DELIVERY=true # false = suppress outbound Telegram messages
-
-# ---- Slack (optional) -------------------------------------
-SLACK_BOT_TOKEN=                     # xoxb-... from Slack App dashboard
-SLACK_SIGNING_SECRET=                # From Slack App dashboard → Basic Info
-
-# ---- Ollama (optional — local inference) ------------------
-# Install from https://ollama.com then run: nemoris setup ollama
-OLLAMA_BASE_URL=http://localhost:11434   # Override if Ollama runs on a different port
-NEMORIS_OLLAMA_MODEL=kimi-k2.5          # Default local model
-
-# ---- Runtime tuning (optional) ----------------------------
-NEMORIS_RATE_LIMIT_MAX=10            # Max messages per window (default: 10)
-NEMORIS_RATE_LIMIT_WINDOW_MS=60000   # Rate limit window in ms (default: 60000)
-NEMORIS_IDENTITY_CACHE_TTL_MS=300000 # Identity cache TTL in ms (default: 5 min)
-
-# ---- Provider mode (required at startup) ------------------
-NEMORIS_ALLOW_PROVIDER_MODE=remote   # "remote" or "local"
-NEMORIS_ALLOW_REMOTE_PROVIDER_MODE=true
-
-# ---- Advanced / internal ----------------------------------
-NEMORIS_AGENT_NAME=                  # Override default agent name
-NEMORIS_LIVE_ROOT=                   # Override live root path
-NEMORIS_INIT_MODE=                   # "fresh" forces re-initialisation
-NEMORIS_QUIET=false                  # Suppress startup logs
-ANTHROPIC_THINKING_ENABLED=false     # Enable /think extended thinking mode
-
-# ---- Semantic embeddings (local via Ollama nomic-embed-text) --
-# NEMORIS_ALLOW_EMBEDDINGS=1
-# NEMORIS_ALLOW_REMOTE_EMBEDDINGS=0
-
-# ---- Feature flags ----------------------------------------
-NEMORIS_WEBHOOK_SECRET=              # Optional — validates Telegram webhook payloads
+# ============================================================
+# Nemoris — Environment Variables
+# Copy this file to .env and fill in your values
+# Run: nemoris setup  (walks you through the essentials)
+# ============================================================
+
+# ---- Anthropic (required for cloud AI) --------------------
+NEMORIS_ANTHROPIC_API_KEY=          # Get from console.anthropic.com
+
+# ---- OpenRouter (optional — fallback + Perplexity search) --
+OPENROUTER_API_KEY=                  # Get from openrouter.ai
+
+# ---- Telegram (required for Telegram channel) -------------
+NEMORIS_TELEGRAM_BOT_TOKEN=          # From @BotFather on Telegram
+NEMORIS_TELEGRAM_CHAT_ID=            # Your Telegram user/chat ID
+NEMORIS_ALLOW_ANY_CHAT=false         # true = accept messages from any chat (dev only)
+NEMORIS_ALLOW_TELEGRAM_DELIVERY=true # false = suppress outbound Telegram messages
+
+# ---- Slack (optional) -------------------------------------
+SLACK_BOT_TOKEN=                     # xoxb-... from Slack App dashboard
+SLACK_SIGNING_SECRET=                # From Slack App dashboard → Basic Info
+
+# ---- Ollama (optional — local inference) ------------------
+# Install from https://ollama.com then run: nemoris setup ollama
+OLLAMA_BASE_URL=http://localhost:11434   # Override if Ollama runs on a different port
+NEMORIS_OLLAMA_MODEL=kimi-k2.5          # Default local model
+
+# ---- Runtime tuning (optional) ----------------------------
+NEMORIS_RATE_LIMIT_MAX=10            # Max messages per window (default: 10)
+NEMORIS_RATE_LIMIT_WINDOW_MS=60000   # Rate limit window in ms (default: 60000)
+NEMORIS_IDENTITY_CACHE_TTL_MS=300000 # Identity cache TTL in ms (default: 5 min)
+
+# ---- Provider mode (required at startup) ------------------
+NEMORIS_ALLOW_PROVIDER_MODE=remote   # "remote" or "local"
+NEMORIS_ALLOW_REMOTE_PROVIDER_MODE=true
+
+# ---- Advanced / internal ----------------------------------
+NEMORIS_AGENT_NAME=                  # Override default agent name
+NEMORIS_LIVE_ROOT=                   # Override live root path
+NEMORIS_INIT_MODE=                   # "fresh" forces re-initialisation
+NEMORIS_QUIET=false                  # Suppress startup logs
+ANTHROPIC_THINKING_ENABLED=false     # Enable /think extended thinking mode
+
+# ---- Semantic embeddings (local via Ollama nomic-embed-text) --
+# NEMORIS_ALLOW_EMBEDDINGS=1
+# NEMORIS_ALLOW_REMOTE_EMBEDDINGS=0
+
+# ---- Feature flags ----------------------------------------
+NEMORIS_WEBHOOK_SECRET=              # Optional — validates Telegram webhook payloads

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Lee Anderson
-
-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.
+MIT License
+
+Copyright (c) 2026 Lee Anderson
+
+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

@@ -1,209 +1,209 @@
-<p align="left">
-  <img src="assets/logo.svg" alt="Nemoris" width="600">
-</p>
-
-[![npm](https://img.shields.io/npm/v/nemoris)](https://npmjs.com/package/nemoris)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Tests](https://github.com/amzer24/nemoris/actions/workflows/main.yml/badge.svg)](https://github.com/amzer24/nemoris/actions/workflows/main.yml)
-[![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org)
-
-A personal AI agent runtime. Runs locally. Persistent memory, delivery guarantees, scheduled jobs, and self-healing — no cloud, no lock-in.
-
-```bash
-npm install -g nemoris
-```
-
-Most agent frameworks give you a chatbot that forgets everything between sessions and silently drops messages when something breaks.
-
----
-
-## Why Nemoris
-
-Nemoris fixes this with three things that actually work:
-
-### Active Memory
-SQLite-backed semantic memory with embeddings, salience scoring, deduplication, and compaction. Your agents remember what matters across sessions — not just within them.
-
-### Delivery Guarantees
-Criticality-classified message delivery with retry pipelines, ack tracking, and pending decision management. Messages don't get lost. Decisions don't fall through cracks.
-
-### Task Contracts
-Structured task lifecycle with state machines, escalation chains, and explicit completion signals. When an agent starts something, it finishes it — or tells you why it didn't.
-
----
-
-## Quick Start
-
-```bash
-# Install globally
-npm install -g nemoris
-
-# Interactive setup (~2 minutes)
-nemoris setup
-```
-
-You'll need an API key from Anthropic or OpenRouter — or just use Ollama for free local models.
-
-```bash
-# Start the daemon
-nemoris start
-```
-
-The setup wizard connects a provider, optionally wires up Telegram, and starts your first agent. Coming from OpenClaw? Run `nemoris migrate` — agents, jobs, and memory import in under 2 minutes.
-
-### Requirements
-
-- **Node.js >= 22**
-- **Ollama** (optional — free local models via [ollama.ai](https://ollama.ai))
-
----
-
-## Providers
-
-- **Anthropic** (Claude) — direct API with prompt caching
-- **OpenRouter** — access to 100+ models
-- **Ollama** — free local models, zero cloud dependency
-
----
-
-## What You Get
-
-| Feature | What it does |
-|---------|-------------|
-| **Active Memory** | Semantic search, embeddings, salience scoring, dedup, compaction — all in SQLite |
-| **Self-Healing** | Nurse system with health probes, automatic repair, rule promotion, severity-tiered notifications |
-| **Exec Approval** | Side-effect gating — approve or deny shell commands from Telegram before they run |
-| **Task Contracts** | State machine lifecycle, escalation chains, completion pings, multi-agent coordination |
-| **Context Compaction** | DAG-based session summarisation — long conversations stay fast and relevant |
-| **Runtime Resilience** | Circuit breaker, near-duplicate detection, idempotent retries |
-| **Session Search** | FTS5 full-text search over conversation history via `/search` and `session_search` tool |
-| **MCP Consumer** | Connect external MCP servers as native tools — filesystem, GitHub, databases, anything |
-| **Vision** | Telegram photos processed by vision-capable models |
-| **Scheduled Jobs** | Cron-triggered and ad-hoc jobs land in the same unified queue as interactive messages |
-| **Multi-Agent** | Agents trigger each other via task contracts and completion pings |
-| **Telegram** | Chat with agents from your phone — slash commands, photos, reactions |
-| **OpenClaw Migration** | Full import of agents, jobs, and memory |
-
----
-
-## CLI Commands
-
-```bash
-nemoris setup          # Interactive setup wizard
-nemoris start          # Start the daemon
-nemoris stop           # Stop the daemon
-nemoris status         # Show running agents, jobs, providers
-nemoris doctor         # Health check and dependency report
-nemoris migrate        # Import from OpenClaw
-nemoris mcp list       # Show connected MCP servers and tools
-```
-
-## Telegram Commands
-
-| Command | Description |
-|---------|-------------|
-| `/switch` | Switch who you're talking to |
-| `/who` | Show current agent |
-| `/status` | System status and usage |
-| `/cost` | Today / week / month spending totals |
-| `/search` | Search conversation history |
-| `/logs` | Tail recent daemon logs |
-| `/model` | Change AI model — `/model sonnet \| haiku \| opus` |
-| `/clear` | Start a fresh conversation |
-| `/stop` | Cancel current task |
-| `/compact` | Free up memory (keeps recent turns) |
-| `/exec_approve <id>` | Approve a pending exec command |
-| `/exec_deny <id>` | Deny a pending exec command |
-| `/agents` | List available agents |
-| `/help` | Show all commands |
-
----
-
-## Architecture
-
-Nemoris runs as a single background daemon on your machine — no Docker, no cloud. Inbound messages enter a unified queue alongside scheduled jobs. The drain loop hydrates context (memory, history, tools), calls the LLM, executes tool calls with approval gating, writes to memory, and delivers responses. The Nurse watches everything and repairs what breaks.
-
-```
-  Telegram / MCP / CLI
-          │
-    ┌─────▼──────┐
-    │  Inbound    │
-    │  Handler    │
-    └─────┬──────┘
-          │
-    ┌─────▼──────┐     ┌────────────┐
-    │  Unified    │◄────│  Scheduled │
-    │  Queue      │     │  Jobs      │
-    └─────┬──────┘     └────────────┘
-          │
-    ┌─────▼──────┐
-    │  Drain      │
-    │  Loop       │
-    └─────┬──────┘
-          │
-    ┌─────▼──────────────────────────────────┐
-    │  Executor                               │
-    │  ┌──────┐  ┌───────┐  ┌──────────────┐ │
-    │  │ LLM  ├──► Tools  ├──► Memory Write │ │
-    │  └──────┘  └───┬───┘  └──────────────┘ │
-    │                │                        │
-    │         ┌──────▼──────┐                 │
-    │         │ Exec Approve│                 │
-    │         └─────────────┘                 │
-    └─────┬──────────────────────────────────┘
-          │
-    ┌─────▼──────┐     ┌────────────┐
-    │  Delivery   │     │  Nurse     │
-    │  Pipeline   │     │  (healing) │
-    └─────┬──────┘     └──────┬─────┘
-          │                   │
-    ┌─────▼───┐         ┌────▼─────┐
-    │Telegram │         │ Probes & │
-    │Agent    │         │ Repair   │
-    │Webhook  │         └──────────┘
-    └─────────┘
-```
-
----
-
-## Platform Support
-
-| Platform | Service Manager | Status |
-|----------|----------------|--------|
-| macOS | launchd | Full support |
-| Linux | systemd (user) | Full support |
-| Windows | PM2 | Supported (WSL2 recommended) |
-
----
-
-## Development
-
-Requires Node.js >= 22.
-
-```bash
-git clone https://github.com/amzer24/nemoris.git
-cd nemoris
-npm install
-npm test           # 1179 tests
-npm run test:e2e   # End-to-end tests
-```
-
-Agents are configured in TOML with their own identity files, memory, tool access, and workspace context. See `docs/` for specs and architecture decisions.
-
----
-
-## Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
-
-Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating.
-
-## Security
-
-See [SECURITY.md](SECURITY.md) for our security policy and how to report vulnerabilities.
-
----
-
-## License
-
-[MIT](LICENSE)
+<p align="left">
+  <img src="assets/logo.svg" alt="Nemoris" width="600">
+</p>
+
+[![npm](https://img.shields.io/npm/v/nemoris)](https://npmjs.com/package/nemoris)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Tests](https://github.com/amzer24/nemoris/actions/workflows/main.yml/badge.svg)](https://github.com/amzer24/nemoris/actions/workflows/main.yml)
+[![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org)
+
+A personal AI agent runtime. Runs locally. Persistent memory, delivery guarantees, scheduled jobs, and self-healing — no cloud, no lock-in.
+
+```bash
+npm install -g nemoris
+```
+
+Most agent frameworks give you a chatbot that forgets everything between sessions and silently drops messages when something breaks.
+
+---
+
+## Why Nemoris
+
+Nemoris fixes this with three things that actually work:
+
+### Active Memory
+SQLite-backed semantic memory with embeddings, salience scoring, deduplication, and compaction. Your agents remember what matters across sessions — not just within them.
+
+### Delivery Guarantees
+Criticality-classified message delivery with retry pipelines, ack tracking, and pending decision management. Messages don't get lost. Decisions don't fall through cracks.
+
+### Task Contracts
+Structured task lifecycle with state machines, escalation chains, and explicit completion signals. When an agent starts something, it finishes it — or tells you why it didn't.
+
+---
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g nemoris
+
+# Interactive setup (~2 minutes)
+nemoris setup
+```
+
+You'll need an API key from Anthropic or OpenRouter — or just use Ollama for free local models.
+
+```bash
+# Start the daemon
+nemoris start
+```
+
+The setup wizard connects a provider, optionally wires up Telegram, and starts your first agent. Coming from OpenClaw? Run `nemoris migrate` — agents, jobs, and memory import in under 2 minutes.
+
+### Requirements
+
+- **Node.js >= 22**
+- **Ollama** (optional — free local models via [ollama.ai](https://ollama.ai))
+
+---
+
+## Providers
+
+- **Anthropic** (Claude) — direct API with prompt caching
+- **OpenRouter** — access to 100+ models
+- **Ollama** — free local models, zero cloud dependency
+
+---
+
+## What You Get
+
+| Feature | What it does |
+|---------|-------------|
+| **Active Memory** | Semantic search, embeddings, salience scoring, dedup, compaction — all in SQLite |
+| **Self-Healing** | Nurse system with health probes, automatic repair, rule promotion, severity-tiered notifications |
+| **Exec Approval** | Side-effect gating — approve or deny shell commands from Telegram before they run |
+| **Task Contracts** | State machine lifecycle, escalation chains, completion pings, multi-agent coordination |
+| **Context Compaction** | DAG-based session summarisation — long conversations stay fast and relevant |
+| **Runtime Resilience** | Circuit breaker, near-duplicate detection, idempotent retries |
+| **Session Search** | FTS5 full-text search over conversation history via `/search` and `session_search` tool |
+| **MCP Consumer** | Connect external MCP servers as native tools — filesystem, GitHub, databases, anything |
+| **Vision** | Telegram photos processed by vision-capable models |
+| **Scheduled Jobs** | Cron-triggered and ad-hoc jobs land in the same unified queue as interactive messages |
+| **Multi-Agent** | Agents trigger each other via task contracts and completion pings |
+| **Telegram** | Chat with agents from your phone — slash commands, photos, reactions |
+| **OpenClaw Migration** | Full import of agents, jobs, and memory |
+
+---
+
+## CLI Commands
+
+```bash
+nemoris setup          # Interactive setup wizard
+nemoris start          # Start the daemon
+nemoris stop           # Stop the daemon
+nemoris status         # Show running agents, jobs, providers
+nemoris doctor         # Health check and dependency report
+nemoris migrate        # Import from OpenClaw
+nemoris mcp list       # Show connected MCP servers and tools
+```
+
+## Telegram Commands
+
+| Command | Description |
+|---------|-------------|
+| `/switch` | Switch who you're talking to |
+| `/who` | Show current agent |
+| `/status` | System status and usage |
+| `/cost` | Today / week / month spending totals |
+| `/search` | Search conversation history |
+| `/logs` | Tail recent daemon logs |
+| `/model` | Change AI model — `/model sonnet \| haiku \| opus` |
+| `/clear` | Start a fresh conversation |
+| `/stop` | Cancel current task |
+| `/compact` | Free up memory (keeps recent turns) |
+| `/exec_approve <id>` | Approve a pending exec command |
+| `/exec_deny <id>` | Deny a pending exec command |
+| `/agents` | List available agents |
+| `/help` | Show all commands |
+
+---
+
+## Architecture
+
+Nemoris runs as a single background daemon on your machine — no Docker, no cloud. Inbound messages enter a unified queue alongside scheduled jobs. The drain loop hydrates context (memory, history, tools), calls the LLM, executes tool calls with approval gating, writes to memory, and delivers responses. The Nurse watches everything and repairs what breaks.
+
+```
+  Telegram / MCP / CLI
+          │
+    ┌─────▼──────┐
+    │  Inbound    │
+    │  Handler    │
+    └─────┬──────┘
+          │
+    ┌─────▼──────┐     ┌────────────┐
+    │  Unified    │◄────│  Scheduled │
+    │  Queue      │     │  Jobs      │
+    └─────┬──────┘     └────────────┘
+          │
+    ┌─────▼──────┐
+    │  Drain      │
+    │  Loop       │
+    └─────┬──────┘
+          │
+    ┌─────▼──────────────────────────────────┐
+    │  Executor                               │
+    │  ┌──────┐  ┌───────┐  ┌──────────────┐ │
+    │  │ LLM  ├──► Tools  ├──► Memory Write │ │
+    │  └──────┘  └───┬───┘  └──────────────┘ │
+    │                │                        │
+    │         ┌──────▼──────┐                 │
+    │         │ Exec Approve│                 │
+    │         └─────────────┘                 │
+    └─────┬──────────────────────────────────┘
+          │
+    ┌─────▼──────┐     ┌────────────┐
+    │  Delivery   │     │  Nurse     │
+    │  Pipeline   │     │  (healing) │
+    └─────┬──────┘     └──────┬─────┘
+          │                   │
+    ┌─────▼───┐         ┌────▼─────┐
+    │Telegram │         │ Probes & │
+    │Agent    │         │ Repair   │
+    │Webhook  │         └──────────┘
+    └─────────┘
+```
+
+---
+
+## Platform Support
+
+| Platform | Service Manager | Status |
+|----------|----------------|--------|
+| macOS | launchd | Full support |
+| Linux | systemd (user) | Full support |
+| Windows | PM2 | Supported (WSL2 recommended) |
+
+---
+
+## Development
+
+Requires Node.js >= 22.
+
+```bash
+git clone https://github.com/amzer24/nemoris.git
+cd nemoris
+npm install
+npm test           # 1403 tests
+npm run test:e2e   # End-to-end tests
+```
+
+Agents are configured in TOML with their own identity files, memory, tool access, and workspace context. See `docs/` for specs and architecture decisions.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating.
+
+## Security
+
+See [SECURITY.md](SECURITY.md) for our security policy and how to report vulnerabilities.
+
+---
+
+## License
+
+[MIT](LICENSE)