mach6-core 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artifact Virtual (SMC-Private) Limited
+
+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,454 @@
+<div align="center">
+
+# ⚡ Mach6
+
+**Multi-channel AI agent framework that runs on a laptop.**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js 20+](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org/)
+[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+
+A persistent daemon that connects to messaging platforms, routes conversations through LLM providers, and executes tool calls in an agentic loop. No cloud dependencies. No vendor lock-in. **Your machine, your data, your keys.**
+
+[Quick Start](#-quick-start) · [Architecture](#-architecture) · [Config](#-configuration) · [Providers](#-providers) · [Tools](#-tools) · [Web UI](#-web-ui)
+
+</div>
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# Clone & build
+git clone https://github.com/amuzetnoM/mach6.git
+cd mach6
+npm install && npm run build
+
+# Interactive setup — generates mach6.json + .env
+npx mach6 init
+
+# Start the daemon
+node dist/gateway/daemon.js --config=mach6.json
+```
+
+> **Windows (PowerShell):** Same commands — Mach6 is fully cross-platform. Use `.\mach6.ps1` or `node dist/gateway/daemon.js --config=mach6.json`.
+
+<details>
+<summary><strong>Manual setup (without wizard)</strong></summary>
+
+```bash
+cp mach6.example.json mach6.json
+cp .env.example .env
+# Edit both files — set API keys, channel tokens, workspace path, ownerIds
+```
+
+</details>
+
+---
+
+## 🏗 Architecture
+
+```
+                         ┌──────────────┐
+                         │   Web UI     │
+                         │   :3006      │
+                         └──────┬───────┘
+                                │ SSE
+┌──────────┐  ┌──────────┐  ┌──┴───────────┐  ┌──────────┐  ┌─────────┐
+│ Discord  │──│  Router   │──│  Message Bus │──│  Agent   │──│ Provider│──→ LLM
+│ WhatsApp │  │  Policy   │  │  Priority Q  │  │  Runner  │  │ (swap)  │
+│ HTTP API │  │  Dedup    │  │  Coalesce    │  │  Tools   │  └─────────┘
+└──────────┘  └──────────┘  │  Interrupt   │  │  Abort   │
+                            │  Backpressure│  │  Iterate │
+                            └──────────────┘  └──────────┘
+```
+
+| Layer | What it does |
+|-------|-------------|
+| **Channels** | Discord (discord.js), WhatsApp (Baileys v7). Adapter pattern — add any platform. |
+| **Router** | Policy enforcement, JID normalization, deduplication, interrupt detection, priority. |
+| **Message Bus** | Priority queue with interrupt bypass, message coalescing, backpressure management. |
+| **Agent Runner** | Agentic loop — tool calling, context management, abort signals, iteration limits. |
+| **Providers** | GitHub Copilot, Anthropic, OpenAI, Gladius (local). Hot-swappable mid-session. |
+| **Tools** | 18 built-in. File I/O, shell, browser, TTS, memory, process management, messaging. |
+| **Sessions** | Persistent, labeled, TTL-aware. Sub-agent spawning up to depth 3. |
+
+---
+
+## 🔥 What Makes Mach6 Different
+
+### Real-Time Interrupts
+
+Most agent frameworks are request-response: you send a message, you wait, you get a reply. If the agent is mid-turn, your new message queues silently. You can't stop it. You can't redirect it.
+
+**Mach6 doesn't work that way.** Every message is priority-classified in real-time:
+
+```
+interrupt  →  Bypasses queue. Cancels active turn immediately.
+high       →  Skips coalescing. Next in line.
+normal     →  Standard processing with coalescing.
+low        →  Reactions, group mentions. Queued politely.
+background →  Typing indicators. Dropped under backpressure.
+```
+
+Send "stop" while the agent is mid-thought → the agent stops. Immediately. Not after the current tool call. Not after the current paragraph. **Now.**
+
+### Message Coalescing
+
+Three messages in rapid succession? Mach6 buffers and merges them:
+
+```
+"hey"              → buffered
+"can you"          → buffered
+"check the logs"   → 2s timer expires → merged into one envelope
+```
+
+One coherent request, one turn, no wasted tokens.
+
+### Single Process, Zero Infrastructure
+
+One Node.js daemon. No Docker. No Redis. No Kubernetes. No microservices. Install, configure, run. It's a binary that talks to LLMs and messaging platforms. That's it.
+
+---
+
+## ⚙ Configuration
+
+### `mach6.json` — Agent configuration
+
+```jsonc
+{
+  "defaultProvider": "github-copilot",
+  "defaultModel": "claude-opus-4-6",
+  "maxTokens": 8192,
+  "maxIterations": 50,
+  "temperature": 0.3,
+
+  // Use forward slashes on all platforms
+  // Windows: "C:/Users/you/workspace"
+  "workspace": "/home/you/workspace",
+  "sessionsDir": ".sessions",
+
+  "providers": {
+    "github-copilot": {},
+    "anthropic": {},
+    "openai": {},
+    "gladius": { "baseUrl": "http://127.0.0.1:8741" }
+  },
+
+  "ownerIds": [
+    "your-discord-user-id",
+    "your-phone@s.whatsapp.net"
+  ],
+
+  "discord": {
+    "enabled": true,
+    "token": "${DISCORD_BOT_TOKEN}",
+    "botId": "${DISCORD_CLIENT_ID}",
+    "siblingBotIds": [],
+    "policy": {
+      "dmPolicy": "allowlist",
+      "groupPolicy": "mention-only",
+      "requireMention": true,
+      "allowedSenders": ["your-discord-user-id"],
+      "allowedGroups": []
+    }
+  },
+
+  "whatsapp": {
+    "enabled": true,
+    "authDir": "~/.mach6/whatsapp-auth",
+    "phoneNumber": "your-phone-number",
+    "autoRead": true,
+    "policy": {
+      "dmPolicy": "allowlist",
+      "groupPolicy": "mention-only",
+      "allowedSenders": ["your-phone@s.whatsapp.net"],
+      "allowedGroups": []
+    }
+  },
+
+  "apiPort": 3006
+}
+```
+
+All string values support `${ENV_VAR}` interpolation.
+
+### `.env` — Secrets
+
+```bash
+# LLM Providers
+ANTHROPIC_API_KEY=sk-ant-...
+OPENAI_API_KEY=sk-...
+
+# GitHub Copilot — usually automatic via `gh auth login`
+# COPILOT_GITHUB_TOKEN=
+
+# Discord
+DISCORD_BOT_TOKEN=
+DISCORD_CLIENT_ID=
+
+# HTTP API authentication
+MACH6_API_KEY=
+
+# Port (default: 3006)
+MACH6_PORT=3006
+```
+
+> Run `mach6 init` to generate both files interactively.
+
+---
+
+## 🧠 Providers
+
+| Provider | Config Key | How it authenticates |
+|----------|-----------|---------------------|
+| **GitHub Copilot** | `github-copilot` | Auto-resolved (see below) — no API key needed |
+| **Anthropic** | `anthropic` | `ANTHROPIC_API_KEY` env var |
+| **OpenAI** | `openai` | `OPENAI_API_KEY` env var |
+| **Gladius** | `gladius` | Local HTTP endpoint |
+
+### GitHub Copilot token resolution
+
+No API key required if `gh` CLI is installed and authenticated. Token resolves in order:
+
+1. `COPILOT_GITHUB_TOKEN` env var
+2. `~/.copilot-cli-access-token` file
+3. `GH_TOKEN` / `GITHUB_TOKEN` env vars
+4. `~/.config/github-copilot/hosts.json` (Linux/macOS)
+5. `%APPDATA%\github-copilot\hosts.json` (Windows)
+6. `gh auth token` CLI fallback (all platforms)
+
+### Available models (via Copilot proxy)
+
+| Model | Config value |
+|-------|-------------|
+| Claude Opus 4.6 | `claude-opus-4-6` |
+| Claude Sonnet 4 | `claude-sonnet-4` |
+| GPT-4o | `gpt-4o` |
+| o3-mini | `o3-mini` |
+
+Providers are hot-swappable mid-session via `/provider` and `/model` commands.
+
+---
+
+## 🛠 Tools
+
+18 built-in tools, available to the agent by default:
+
+| Tool | Description |
+|------|------------|
+| `read` | Read file contents (with offset/limit for large files) |
+| `write` | Write/create files (auto-creates parent directories) |
+| `edit` | Surgical find-and-replace editing |
+| `exec` | Execute shell commands |
+| `image` | Analyze images with vision models |
+| `web_fetch` | Fetch URLs, strip HTML to text |
+| `tts` | Text-to-speech (Edge TTS, multiple voices) |
+| `memory_search` | Hybrid BM25 + vector search over indexed files |
+| `comb_recall` | Recall persistent session-to-session memory |
+| `comb_stage` | Stage information for next session |
+| `message` | Send messages, media, and reactions to any channel |
+| `typing` | Send typing indicators |
+| `presence` | Update presence status |
+| `delete_message` | Delete messages |
+| `mark_read` | Send read receipts |
+| `process_start` | Start background processes |
+| `process_poll` | Poll background process output |
+| `process_kill` | Kill background processes |
+| `process_list` | List background processes |
+| `spawn` | Spawn sub-agents (up to depth 3) |
+
+Tools are sandboxed per-session via the policy engine. MCP bridge available for external tool servers.
+
+---
+
+## 🖥 Web UI
+
+Mach6 ships with a built-in web interface at `http://localhost:3006`:
+
+- **Session management** — create, switch, delete sessions
+- **Streaming responses** — real-time SSE with tool call visualization
+- **Config panel** — change provider, model, temperature, API keys live
+- **Sub-agent monitoring** — view and kill running sub-agents
+- **Generative UI** — file reads, exec outputs, and fetches render as rich cards
+
+No build step. No npm dependencies. One static HTML file.
+
+---
+
+## 🖥 CLI
+
+### Interactive REPL
+
+```bash
+node dist/index.js --config=mach6.json
+```
+
+```
+Mach6 v0.2 | github-copilot/claude-opus-4-6 | session: default
+Tools (18): read, write, edit, exec, image, web_fetch, tts, ...
+Type /help for commands
+
+❯ What's in the logs?
+⚡ exec
+✓ exec tail -50 /var/log/syslog
+...
+```
+
+### Commands
+
+| Command | Description |
+|---------|------------|
+| `/help` | Show all commands |
+| `/tools` | List available tools |
+| `/model <name>` | Switch model mid-session |
+| `/provider <name>` | Switch provider mid-session |
+| `/spawn <task>` | Spawn a sub-agent |
+| `/status` | Session stats (tokens, tool usage) |
+| `/sessions` | List all sessions |
+| `/history [N]` | Show last N messages |
+| `/clear` | Clear current session |
+| `/quit` | Exit |
+
+### One-shot mode
+
+```bash
+node dist/index.js "Summarize the README in this directory"
+```
+
+---
+
+## 🐧 Running as a Service
+
+### Linux (systemd)
+
+```bash
+# Copy the included service file
+sudo cp mach6-gateway.service /etc/systemd/system/
+# Edit it — set your paths and user
+sudo systemctl enable --now mach6-gateway
+
+# Hot-reload config without restarting:
+kill -USR1 $(pgrep -f "gateway/daemon.js")
+```
+
+### macOS (launchd)
+
+Create `~/Library/LaunchAgents/com.mach6.gateway.plist` pointing to `node dist/gateway/daemon.js`.
+
+### Windows
+
+Use [NSSM](https://nssm.cc/) or Task Scheduler to run `node dist/gateway/daemon.js --config=mach6.json`.
+
+> **Note:** `SIGUSR1` hot-reload is not available on Windows. Restart the process to reload config.
+
+---
+
+## 📁 Project Structure
+
+```
+mach6/
+├── src/
+│   ├── agent/          # Runner, context manager, system prompt builder
+│   ├── boot/           # Boot sequence & validation
+│   ├── channels/       # Adapter pattern — Discord, WhatsApp, router, bus
+│   │   ├── bus.ts      # Priority queue, coalescing, interrupts, backpressure
+│   │   ├── router.ts   # Policy, dedup, JID normalization, priority
+│   │   └── adapters/   # Discord (discord.js), WhatsApp (Baileys v7)
+│   ├── cli/            # Interactive setup wizard
+│   ├── config/         # Config loader, validator, env interpolation
+│   ├── cron/           # Cron budget management
+│   ├── formatters/     # Platform-aware markdown formatting
+│   ├── gateway/        # Persistent daemon — signals, hot-reload, turns
+│   ├── heartbeat/      # Activity-aware periodic health checks
+│   ├── memory/         # Index integrity checks
+│   ├── providers/      # LLM providers — Copilot, Anthropic, OpenAI, Gladius
+│   ├── security/       # Input sanitization
+│   ├── sessions/       # Session store, queue, sub-agents
+│   ├── tools/          # 18 built-in tools, policy engine, registry, MCP bridge
+│   └── web/            # Web UI server (SSE streaming, static serving)
+├── web/                # Web UI (single HTML file)
+├── mach6.example.json  # Example config
+├── .env.example        # Example environment variables
+├── mach6.sh            # Linux/macOS start script
+├── mach6.ps1           # Windows start script
+└── mach6-gateway.service  # systemd unit file
+```
+
+---
+
+## 🔒 Hardening
+
+20 production pain points addressed:
+
+- **Config validation** with human-readable diagnostics at boot
+- **Context monitor** with progressive warnings (70/80/90% thresholds)
+- **Priority message queue** — real messages never drop, only background signals shed under backpressure
+- **Tool policy engine** — scope available tools per session and security tier
+- **Provider diagnostics** — health checks and automatic failover
+- **Activity-aware heartbeat** — adapts frequency to system load
+- **Cron budget management** — prevents runaway scheduled tasks
+- **Boot sequence validation** — catch misconfigurations before they become incidents
+- **JID normalization** for WhatsApp Baileys v7 (device suffix stripping)
+- **Abort signal propagation** through agent runner → LLM stream → tool execution
+- **MCP bridge** for connecting external tool servers
+- **Sibling bot yield** — @mention one bot, only that one responds
+
+---
+
+## 📊 Stats
+
+| Metric | Value |
+|--------|-------|
+| Lines of TypeScript | ~8,400 |
+| Built-in tools | 18 |
+| LLM providers | 4 |
+| Channel adapters | 2 + HTTP API |
+| Cold boot to connected | ~2.3s |
+| External runtime deps | Node.js only |
+
+---
+
+## 🌐 Platform Compatibility
+
+| Feature | Windows | Linux | macOS |
+|---------|---------|-------|-------|
+| Gateway daemon | ✅ | ✅ | ✅ |
+| Discord adapter | ✅ | ✅ | ✅ |
+| WhatsApp adapter | ✅ | ✅ | ✅ |
+| HTTP API + Web UI | ✅ | ✅ | ✅ |
+| CLI (REPL + one-shot) | ✅ | ✅ | ✅ |
+| Hot-reload (SIGUSR1) | ❌ | ✅ | ✅ |
+| Service manager | Task Scheduler | systemd | launchd |
+| Temp directory | `%TEMP%` | `/tmp` | `/tmp` |
+| Home directory | `%USERPROFILE%` | `~` | `~` |
+
+All paths resolved via `os.tmpdir()` and `os.homedir()` — zero hardcoded Unix paths.
+
+---
+
+## 📜 History
+
+| Date | Milestone |
+|------|----------|
+| **Feb 22, 2026** | Built from scratch. WhatsApp, Discord, gateway, config, tools, sessions. |
+| **Feb 22, 2026** | 14/14 smoke tests. 20 hardening fixes. Flipped to production same day. |
+| **Feb 23, 2026** | Open-sourced. MIT license. |
+| **Feb 28, 2026** | Cross-platform (Windows/Linux/macOS). CLI wizard. v1.0.0. |
+
+---
+
+## 📄 License
+
+[MIT](LICENSE) — do whatever you want with it.
+
+---
+
+<div align="center">
+
+Built by **[Artifact Virtual](https://artifactvirtual.com)**
+
+Open-sourced because infrastructure wants to be free.
+
+</div>

package/dist/agent/context-monitor.d.ts

@@ -0,0 +1,40 @@
+import type { Message } from '../providers/types.js';
+export interface ContextMonitorConfig {
+    maxContextTokens: number;
+    warnThreshold?: number;
+    compactThreshold?: number;
+    emergencyThreshold?: number;
+    transcriptDir?: string;
+    onCombStage?: (content: string) => Promise<void>;
+}
+export type ContextHealth = 'ok' | 'warning' | 'compacting' | 'emergency';
+export interface ContextStatus {
+    totalTokens: number;
+    maxTokens: number;
+    usage: number;
+    health: ContextHealth;
+    messageCount: number;
+}
+export declare class ContextMonitor {
+    private config;
+    private transcriptDir;
+    private onCombStage?;
+    private hasWarned;
+    constructor(cfg: ContextMonitorConfig);
+    /** Check current context health without modifying anything */
+    check(messages: Message[]): ContextStatus;
+    /**
+     * Check and act: returns (possibly compacted) messages.
+     * - warning: logs, returns as-is
+     * - compacting: COMB stage + summarize old messages
+     * - emergency: save transcript to disk, hard-truncate
+     */
+    manage(messages: Message[]): Promise<Message[]>;
+    /** Summarize old messages, keep system + recent */
+    private compact;
+    /** Emergency: save full transcript, keep only last N messages */
+    private hardTruncate;
+    private buildSummary;
+    private saveTranscript;
+}
+//# sourceMappingURL=context-monitor.d.ts.map

package/dist/agent/context-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.d.ts","sourceRoot":"","sources":["../../src/agent/context-monitor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAiBD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyH;IACvI,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAqC;IACzD,OAAO,CAAC,SAAS,CAAS;gBAEd,GAAG,EAAE,oBAAoB;IAWrC,8DAA8D;IAC9D,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,aAAa;IAYzC;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAqCrD,mDAAmD;IACnD,OAAO,CAAC,OAAO;IAwBf,iEAAiE;IACjE,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,YAAY;YAUN,cAAc;CAU7B"}

package/dist/agent/context-monitor.js

@@ -0,0 +1,138 @@
+// Mach6 — Proactive Context Management (fixes Pain #3)
+// Track tokens in real-time. Compact before overflow. Never hit the wall.
+import os from 'node:os';
+import path from 'node:path';
+/** Rough token estimate: ~4 chars per token */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function messageTokens(msg) {
+    if (typeof msg.content === 'string')
+        return estimateTokens(msg.content);
+    return msg.content.reduce((sum, b) => {
+        if (b.text)
+            return sum + estimateTokens(b.text);
+        if (b.content)
+            return sum + estimateTokens(b.content);
+        if (b.input)
+            return sum + estimateTokens(JSON.stringify(b.input));
+        return sum + 50;
+    }, 0);
+}
+export class ContextMonitor {
+    config;
+    transcriptDir;
+    onCombStage;
+    hasWarned = false;
+    constructor(cfg) {
+        this.config = {
+            maxContextTokens: cfg.maxContextTokens,
+            warnThreshold: cfg.warnThreshold ?? 0.7,
+            compactThreshold: cfg.compactThreshold ?? 0.8,
+            emergencyThreshold: cfg.emergencyThreshold ?? 0.9,
+        };
+        this.transcriptDir = cfg.transcriptDir ?? path.join(os.tmpdir(), 'mach6-transcripts');
+        this.onCombStage = cfg.onCombStage;
+    }
+    /** Check current context health without modifying anything */
+    check(messages) {
+        const totalTokens = messages.reduce((s, m) => s + messageTokens(m), 0);
+        const usage = totalTokens / this.config.maxContextTokens;
+        let health = 'ok';
+        if (usage >= this.config.emergencyThreshold)
+            health = 'emergency';
+        else if (usage >= this.config.compactThreshold)
+            health = 'compacting';
+        else if (usage >= this.config.warnThreshold)
+            health = 'warning';
+        return { totalTokens, maxTokens: this.config.maxContextTokens, usage, health, messageCount: messages.length };
+    }
+    /**
+     * Check and act: returns (possibly compacted) messages.
+     * - warning: logs, returns as-is
+     * - compacting: COMB stage + summarize old messages
+     * - emergency: save transcript to disk, hard-truncate
+     */
+    async manage(messages) {
+        const status = this.check(messages);
+        if (status.health === 'ok') {
+            this.hasWarned = false;
+            return messages;
+        }
+        if (status.health === 'warning') {
+            if (!this.hasWarned) {
+                console.warn(`⚠️  Context at ${(status.usage * 100).toFixed(0)}% (${status.totalTokens}/${status.maxTokens} tokens)`);
+                this.hasWarned = true;
+            }
+            return messages;
+        }
+        // Before any compaction, stage to COMB
+        if (this.onCombStage) {
+            const summary = this.buildSummary(messages);
+            try {
+                await this.onCombStage(summary);
+            }
+            catch (err) {
+                console.error('COMB stage failed during compaction:', err);
+            }
+        }
+        if (status.health === 'emergency') {
+            console.error(`🚨 Context EMERGENCY at ${(status.usage * 100).toFixed(0)}% — flushing to disk`);
+            await this.saveTranscript(messages);
+            return this.hardTruncate(messages, 10);
+        }
+        // compacting
+        console.warn(`🔄 Context at ${(status.usage * 100).toFixed(0)}% — auto-compacting`);
+        return this.compact(messages);
+    }
+    /** Summarize old messages, keep system + recent */
+    compact(messages) {
+        const system = messages.filter(m => m.role === 'system');
+        const rest = messages.filter(m => m.role !== 'system');
+        // Keep last 40% of non-system messages
+        const keepCount = Math.max(10, Math.floor(rest.length * 0.4));
+        const old = rest.slice(0, rest.length - keepCount);
+        const recent = rest.slice(rest.length - keepCount);
+        // Build summary of old messages
+        const summaryParts = ['[Context compacted. Summary of earlier conversation:]'];
+        for (const msg of old) {
+            const text = typeof msg.content === 'string' ? msg.content : '[structured content]';
+            const preview = text.slice(0, 200);
+            summaryParts.push(`${msg.role}: ${preview}${text.length > 200 ? '...' : ''}`);
+        }
+        const summaryMsg = {
+            role: 'user',
+            content: summaryParts.join('\n').slice(0, 2000),
+        };
+        return [...system, summaryMsg, ...recent];
+    }
+    /** Emergency: save full transcript, keep only last N messages */
+    hardTruncate(messages, keepLast) {
+        const system = messages.filter(m => m.role === 'system');
+        const rest = messages.filter(m => m.role !== 'system');
+        const kept = rest.slice(-keepLast);
+        const notice = { role: 'user', content: '[Emergency context flush. Earlier messages saved to disk. Recent context only.]' };
+        return [...system, notice, ...kept];
+    }
+    buildSummary(messages) {
+        const parts = [`Context snapshot at ${new Date().toISOString()} (${messages.length} messages)`];
+        for (const msg of messages) {
+            if (msg.role === 'system')
+                continue;
+            const text = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+            parts.push(`[${msg.role}] ${text.slice(0, 500)}`);
+        }
+        return parts.join('\n');
+    }
+    async saveTranscript(messages) {
+        // Dynamic import to avoid top-level fs dependency issues
+        const fs = await import('node:fs');
+        const path = await import('node:path');
+        fs.mkdirSync(this.transcriptDir, { recursive: true });
+        const filename = `transcript-${Date.now()}.json`;
+        const filepath = path.join(this.transcriptDir, filename);
+        fs.writeFileSync(filepath, JSON.stringify(messages, null, 2));
+        console.log(`📝 Transcript saved: ${filepath}`);
+    }
+}
+//# sourceMappingURL=context-monitor.js.map

package/dist/agent/context-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.js","sourceRoot":"","sources":["../../src/agent/context-monitor.ts"],"names":[],"mappings":"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"}

package/dist/agent/context.d.ts

@@ -0,0 +1,8 @@
+import type { Message } from '../providers/types.js';
+/**
+ * Truncate message history to fit within a token budget.
+ * Strategy: keep system prompt + last N messages, drop oldest first.
+ * CRITICAL: tool_use/tool_result messages must stay paired.
+ */
+export declare function truncateContext(messages: Message[], maxTokens: number): Message[];
+//# sourceMappingURL=context.d.ts.map

package/dist/agent/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/agent/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,uBAAuB,CAAC;AAkFnE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAuFjF"}