@yoda.digital/iris-gateway 1.13.3

package/README.md

@@ -0,0 +1,282 @@
+# Iris Gateway
+
+**Your self-hosted AI assistant that talks to you on Telegram, WhatsApp, Discord, and Slack — powered entirely by free AI models.**
+
+Run a personal AI with memory, goals, and proactive nudges on your own server, at zero model cost, using [OpenRouter's free tier](https://openrouter.ai).
+
+[![npm](https://img.shields.io/npm/v/@yoda.digital/iris-gateway)](https://www.npmjs.com/package/@yoda.digital/iris-gateway)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org)
+[![Coverage](https://img.shields.io/badge/coverage-%3E75%25-brightgreen)](docs/configuration.md)
+
+- 💸 **Free models only** — four pre-vetted OpenRouter free-tier presets in the init wizard. No paid API keys required to run.
+- 🧠 **Intelligence layer** — derives language, timezone, engagement patterns, and arc state from every conversation without you touching config
+- 📱 **All your channels, one brain** — Telegram, WhatsApp, Discord, Slack, WebChat share a single SQLite vault
+- 🎯 **Goal and arc tracking** — remembers what you're working on, sets next-action deadlines, follows up when relevant
+- 🔧 **40+ built-in tools** — calendar, email, contacts, tasks, web search, vault search out of the box
+- 📊 **Execution traces** — turn-grouped audit logs with step indexing for debugging multi-tool workflows
+- 🛡️ **Self-healing health monitor** — linear regression trend detection, predictive threshold breach, health-aware throttling
+- 🔒 **Master policy enforcement** — structural ceiling for tool access, agent modes, and permission grants — config-driven, immutable at runtime
+- 🔌 **Extensible** — write plugins, add CLI tools, create custom skills with trigger-based activation
+- 📦 **SDK client** — typed HTTP client for building external integrations against tool-server API
+- 🔀 **Multi-instance support** — run multiple nodes against the same SQLite database with automatic leader election
+
+---
+
+## Quick Start
+
+### Install from npm (recommended)
+
+```bash
+npm install -g @yoda.digital/iris-gateway
+# or
+pnpm add -g @yoda.digital/iris-gateway
+
+iris init        # interactive setup wizard
+iris gateway run # start the gateway
+```
+
+### Clone and run from source
+
+```bash
+# 1. Clone and install
+git clone https://github.com/yoda-digital/iris-gateway.git iris && cd iris
+pnpm install
+
+# 2. Interactive setup (recommended)
+iris init
+
+# 3. Build and run
+pnpm run build && pnpm start
+
+# 4. Verify
+curl http://127.0.0.1:19876/health
+```
+
+**Telegram bot token:** [@BotFather](https://t.me/botfather) → `/newbot`  
+**Free AI models:** Sign up at [openrouter.ai/keys](https://openrouter.ai/keys) — no credit card required for free tier  
+**Full config reference:** [docs/configuration.md](docs/configuration.md)
+
+### Init Wizard
+
+`iris init` walks you through every required setting interactively:
+
+```
+$ iris init
+
+◆  Config output path: iris.config.json
+◆  Which AI model? › Arcee Trinity Large (free) — OpenRouter, no API key required
+◆  OpenCode CLI detected at /usr/local/bin/opencode ✓
+◆  Enable Telegram? › Yes
+◆  Telegram bot token: ████████████████████
+◆  Enable Discord? › No
+◆  Writing iris.config.json... done.
+```
+
+Free model options: Arcee Spotlight, Arcee Trinity Large, Llama 3.3 70B, Mistral 7B — or enter any custom model string.
+
+### Docker (even faster)
+
+```bash
+cp iris.config.example.json iris.config.json
+# Edit iris.config.json — set your bot token and model
+docker-compose up -d
+```
+
+---
+
+## Why Iris?
+
+|  | **Iris** | DIY Bot | n8n |
+|---|:---:|:---:|:---:|
+| Free AI models | ✅ | ❌ | ❌ |
+| Multi-channel (one brain) | ✅ | manual | ✅ |
+| Intelligence layer | ✅ | ❌ | ❌ |
+| Goal & arc tracking | ✅ | ❌ | ❌ |
+| Master policy enforcement | ✅ | ❌ | ❌ |
+| Multi-instance (leader election) | ✅ | ❌ | ✅ |
+| Self-hosted | ✅ | ✅ | ✅ |
+| Setup time | ~10 min | days | hours |
+
+---
+
+## What People Use It For
+
+**Personal AI assistant** — Replace generic chatbots with something that knows your name, remembers your projects, and follows up when a deadline is approaching. Works across all your messaging apps simultaneously.
+
+**Smart home / server automation** — Send messages from cron jobs, get AI-summarized alerts, ask questions about your infrastructure in plain language from your phone.
+
+**Team assistant** — Deploy to a Discord or Slack server, configure per-channel policies, add custom tools, and give your team an AI that respects governance rules you define.
+
+---
+
+## Architecture
+
+Two cooperating processes connected via HTTP IPC:
+
+1. **Iris Gateway** (Node.js) — manages channels, security, vault, governance, and a tool server on port 19877
+2. **OpenCode CLI** (AI backend) — auto-spawned or external on port 4096. A single plugin exposes all 40+ Iris tools to the AI via HTTP callbacks
+
+```
+ Telegram ─┐
+ WhatsApp ─┼── Adapters ──► Auto-Reply ──► Router ──► OpenCode ──► AI Model
+ Discord  ─┤      │          Engine                    Bridge
+ Slack    ─┤      ▼                                    Plugin SDK
+ WebChat  ─┘  Security                                 (40+ tools)
+              Gate
+               │
+               ▼
+        ┌──────┴──────────────────────────────────────────┐
+        │  Vault   Policy   Govern.  Proact.  Heart.  CLI  │
+        │ (SQLite) Engine   Engine   Engine   Engine  Exec │
+        └──────┬──────────────────────────────┬────────────┘
+               │                              │
+        Intelligence Layer              Health Layer
+        ┌──────┴──────────┐          ┌────────┴────────┐
+        │ Arcs  Goals     │          │ TrendDetector   │
+        │ Inference       │          │ HealthGate      │
+        │ Triggers        │          │ OutcomeAnalyzer │
+        │ CrossChannel    │          └─────────────────┘
+        └─────────────────┘
+```
+
+**Inbound flow:**
+```
+platform message
+  → adapter normalize
+  → security gate (pairing / allowlist / rate-limit)
+  → auto-reply check
+  → onboarding enrichment
+  → inference engine (timezone / language / engagement)
+  → trigger evaluator
+  → OpenCode prompt
+  → streaming coalesce
+  → deliver
+```
+
+### Intelligence Layer
+
+Seven deterministic subsystems — zero LLM cost, pure Node.js + SQLite:
+
+| Subsystem | What it does |
+|-----------|-------------|
+| **Signal Inference Engine** | Derives timezone, language, engagement trend, session patterns from raw signals |
+| **Event-Driven Triggers** | Structural pattern detection: temporal markers, dormancy, engagement drops. Language-agnostic. |
+| **Outcome-Aware Proactive Loop** | Tracks engagement by category (task/work/health/hobby/social). AI-assigned, not keyword-guessed. |
+| **Memory Arcs** | Temporal threads tracking evolving situations. Auto-stale after 14 days, configurable. |
+| **Goal Tracking** | Persistent goals with state machine, success criteria, next-action queue, due-date alerts |
+| **Cross-Channel Intelligence** | Unified presence detection across all channels |
+| **Self-Tuning Heartbeat** | Linear regression trend detection, predictive threshold breach, health-aware proactive throttling |
+
+### Multi-Instance Support
+
+Iris supports running multiple instances against the same SQLite database via WAL mode and advisory leader election:
+
+```bash
+IRIS_INSTANCE_ID=node-1 pnpm start &
+IRIS_INSTANCE_ID=node-2 pnpm start &
+```
+
+One instance holds the leader lease and drives proactive/heartbeat engines. Others serve requests in read-write mode. Leader failover is automatic within one election interval (~30s).
+
+See [docs/deployment/multi-instance.md](docs/deployment/multi-instance.md) for full configuration.
+
+### Security
+
+Four DM policy modes:
+
+| Mode | Behavior |
+|------|----------|
+| `open` | Any user can start a conversation |
+| `pairing` _(default)_ | New users get a pairing code you approve via `iris pairing approve` |
+| `allowlist` | Only explicitly listed user IDs can interact |
+| `disabled` | All DMs rejected |
+
+Rate limiting per user per channel. Groups support `requireMention` gating so Iris only responds when mentioned.
+
+### Master Policy
+
+The `policy` config section defines a structural ceiling for the entire system — immutable at runtime:
+
+```json
+{
+  "policy": {
+    "enabled": true,
+    "tools": { "denied": ["rules_update"] },
+    "permissions": { "bash": "deny", "edit": "deny" },
+    "agents": { "allowedModes": ["subagent"], "maxSteps": 25 },
+    "enforcement": { "blockUnknownTools": true }
+  }
+}
+```
+
+Agents and skills can only narrow within the policy — never widen it. See [docs/configuration.md#policy-config](docs/configuration.md#policy-config) for full reference.
+
+---
+
+## CLI
+
+```bash
+iris init                 # Interactive setup wizard — generates iris.config.json
+iris gateway run          # Start the gateway
+iris doctor               # Diagnostic checks (config, OpenCode, channel connectivity)
+iris status               # Gateway status (instances, channels, model)
+iris pairing list|approve # Manage user pairing codes
+iris session list|reset   # Manage channel sessions
+iris config validate      # Validate config file (exits non-zero on error)
+iris config show          # Show resolved config with secrets redacted
+iris send <ch> <to> <msg> # One-shot message without starting the gateway
+```
+
+---
+
+## Documentation
+
+| Doc | Contents |
+|-----|----------|
+| [docs/configuration.md](docs/configuration.md) | Full config reference — every field, type, default, and example |
+| [docs/cookbook.md](docs/cookbook.md) | Patterns: policy, governance, vault hooks, skills, cron jobs |
+| [docs/deployment.md](docs/deployment.md) | Docker, systemd, nginx reverse proxy, Prometheus metrics |
+| [docs/deployment/multi-instance.md](docs/deployment/multi-instance.md) | Multi-instance leader election, WAL mode, instance identity |
+| [docs/iris-model-reference.md](docs/iris-model-reference.md) | Model capabilities matrix, fallback chains, speed profiles |
+| [docs/sdk/getting-started.md](docs/sdk/getting-started.md) | SDK client — build external plugins in under 30 minutes |
+| [docs/tool-api.md](docs/tool-api.md) | Tool-server API reference — every endpoint with request/response types |
+| [CHANGELOG.md](CHANGELOG.md) | Full version history |
+
+---
+
+## SDK
+
+Build external plugins and integrations using the typed HTTP client:
+
+```bash
+npm install @yoda.digital/iris-gateway
+# or
+pnpm add @yoda.digital/iris-gateway
+```
+
+```typescript
+import IrisClient from "@yoda.digital/iris-gateway/sdk";
+
+const iris = new IrisClient({ baseUrl: "http://localhost:19877" });
+
+// Search vault
+const { results } = await iris.vault.search({ query: "project goals", limit: 5 });
+
+// Send a message
+await iris.channels.sendMessage({ channel: "telegram", to: "123456", text: "Hello!" });
+
+// Check execution traces
+const trace = await iris.governance.getTraces("turn-abc-123");
+```
+
+Full SDK documentation: [docs/sdk/getting-started.md](docs/sdk/getting-started.md)
+
+Tool-server API reference: [docs/tool-api.md](docs/tool-api.md)
+
+---
+
+## License
+
+MIT
+

package/dist/auto-reply/engine.d.ts

@@ -0,0 +1,13 @@
+import type { InboundMessage } from "../channels/adapter.js";
+import type { AutoReplyTemplate, TemplateMatch } from "./types.js";
+export declare class TemplateEngine {
+    private readonly templates;
+    private readonly cooldowns;
+    private readonly onceFired;
+    constructor(templates: AutoReplyTemplate[]);
+    match(msg: InboundMessage): TemplateMatch | null;
+    private triggerMatches;
+    private scheduleActive;
+    private render;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/auto-reply/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/auto-reply/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,SAAS,EAAE,iBAAiB,EAAE;IAI1C,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,aAAa,GAAG,IAAI;IAwBhD,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,MAAM;CAQf"}

package/dist/auto-reply/engine.js

@@ -0,0 +1,70 @@
+export class TemplateEngine {
+    templates;
+    cooldowns = new Map();
+    onceFired = new Set();
+    constructor(templates) {
+        this.templates = [...templates].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    }
+    match(msg) {
+        const text = msg.text ?? "";
+        for (const tpl of this.templates) {
+            if (tpl.channels && !tpl.channels.includes(msg.channelId))
+                continue;
+            if (tpl.chatTypes && !tpl.chatTypes.includes(msg.chatType))
+                continue;
+            const coolKey = `${tpl.id}:${msg.senderId}`;
+            if (tpl.cooldown) {
+                const last = this.cooldowns.get(coolKey);
+                if (last && Date.now() - last < tpl.cooldown * 1000)
+                    continue;
+            }
+            if (tpl.once && this.onceFired.has(coolKey))
+                continue;
+            if (!this.triggerMatches(tpl.trigger, text))
+                continue;
+            // Match found
+            if (tpl.cooldown)
+                this.cooldowns.set(coolKey, Date.now());
+            if (tpl.once)
+                this.onceFired.add(coolKey);
+            return { template: tpl, response: this.render(tpl.response, msg) };
+        }
+        return null;
+    }
+    triggerMatches(trigger, text) {
+        switch (trigger.type) {
+            case "exact":
+                return text.toLowerCase().trim() === trigger.pattern.toLowerCase().trim();
+            case "regex":
+                return new RegExp(trigger.pattern, "i").test(text);
+            case "keyword":
+                return trigger.words.some((w) => text.toLowerCase().includes(w.toLowerCase()));
+            case "command":
+                return text.trim().toLowerCase().startsWith(`/${trigger.name.toLowerCase()}`);
+            case "schedule":
+                return this.scheduleActive(trigger.when);
+        }
+    }
+    scheduleActive(when) {
+        const now = new Date();
+        if (when.hours) {
+            const hour = now.getHours();
+            if (hour < when.hours[0] || hour >= when.hours[1])
+                return false;
+        }
+        if (when.days) {
+            if (!when.days.includes(now.getDay()))
+                return false;
+        }
+        return true;
+    }
+    render(template, msg) {
+        return template
+            .replace(/\{sender\.name\}/g, msg.senderName ?? "there")
+            .replace(/\{sender\.id\}/g, msg.senderId)
+            .replace(/\{channel\}/g, msg.channelId)
+            .replace(/\{time\}/g, new Date().toLocaleTimeString())
+            .replace(/\{date\}/g, new Date().toLocaleDateString());
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/auto-reply/engine.js.map

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

package/dist/auto-reply/types.d.ts

@@ -0,0 +1,37 @@
+export interface AutoReplyTemplate {
+    readonly id: string;
+    readonly trigger: TemplateTrigger;
+    readonly response: string;
+    readonly priority?: number;
+    readonly cooldown?: number;
+    readonly once?: boolean;
+    readonly channels?: string[];
+    readonly chatTypes?: ("dm" | "group")[];
+    readonly forwardToAi?: boolean;
+}
+export type TemplateTrigger = {
+    readonly type: "exact";
+    readonly pattern: string;
+} | {
+    readonly type: "regex";
+    readonly pattern: string;
+} | {
+    readonly type: "keyword";
+    readonly words: string[];
+} | {
+    readonly type: "command";
+    readonly name: string;
+} | {
+    readonly type: "schedule";
+    readonly when: ScheduleCondition;
+};
+export interface ScheduleCondition {
+    readonly hours?: [number, number];
+    readonly days?: number[];
+    readonly timezone?: string;
+}
+export interface TemplateMatch {
+    readonly template: AutoReplyTemplate;
+    readonly response: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auto-reply/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auto-reply/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/auto-reply/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/auto-reply/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/auto-reply/types.ts"],"names":[],"mappings":""}

package/dist/bridge/circuit-breaker.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Circuit breaker for OpenCode bridge reliability.
+ *
+ * States:
+ *   CLOSED    - normal operation, requests pass through
+ *   OPEN      - bridge is down, reject immediately with user-visible message
+ *   HALF_OPEN - testing recovery, let one request through
+ */
+export type CircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
+export interface CircuitBreakerOptions {
+    /** Number of consecutive failures before opening the circuit. Default: 3 */
+    failureThreshold?: number;
+    /** How long (ms) to stay OPEN before attempting HALF_OPEN. Default: 10_000 */
+    recoveryTimeoutMs?: number;
+    /** Message sent to users when circuit is OPEN. */
+    unavailableMessage?: string;
+}
+export declare class CircuitBreaker {
+    private state;
+    private consecutiveFailures;
+    private openedAt;
+    private halfOpenInFlight;
+    private readonly failureThreshold;
+    private readonly recoveryTimeoutMs;
+    readonly unavailableMessage: string;
+    constructor(opts?: CircuitBreakerOptions);
+    /** Returns true if the request should proceed. */
+    allowRequest(): boolean;
+    onSuccess(): void;
+    onFailure(): void;
+    /**
+     * Returns the effective circuit state.
+     * Pure — no mutations. If OPEN and recovery timeout has elapsed,
+     * returns HALF_OPEN to reflect that a probe would be allowed,
+     * but does NOT set halfOpenInFlight (that happens in allowRequest()).
+     */
+    getState(): CircuitState;
+    reset(): void;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/bridge/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/bridge/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;gBAExB,IAAI,GAAE,qBAA0B;IAQ5C,kDAAkD;IAClD,YAAY,IAAI,OAAO;IAuBvB,SAAS,IAAI,IAAI;IAOjB,SAAS,IAAI,IAAI;IASjB;;;;;OAKG;IACH,QAAQ,IAAI,YAAY;IASxB,KAAK,IAAI,IAAI;CAMd"}

package/dist/bridge/circuit-breaker.js

@@ -0,0 +1,82 @@
+/**
+ * Circuit breaker for OpenCode bridge reliability.
+ *
+ * States:
+ *   CLOSED    - normal operation, requests pass through
+ *   OPEN      - bridge is down, reject immediately with user-visible message
+ *   HALF_OPEN - testing recovery, let one request through
+ */
+export class CircuitBreaker {
+    state = "CLOSED";
+    consecutiveFailures = 0;
+    openedAt = null;
+    halfOpenInFlight = false;
+    failureThreshold;
+    recoveryTimeoutMs;
+    unavailableMessage;
+    constructor(opts = {}) {
+        this.failureThreshold = opts.failureThreshold ?? 3;
+        this.recoveryTimeoutMs = opts.recoveryTimeoutMs ?? 10_000;
+        this.unavailableMessage =
+            opts.unavailableMessage ??
+                "\u26a0\ufe0f I am temporarily unavailable \u2014 my AI backend is restarting. I'll respond shortly.";
+    }
+    /** Returns true if the request should proceed. */
+    allowRequest() {
+        if (this.state === "CLOSED")
+            return true;
+        if (this.state === "OPEN") {
+            const elapsed = Date.now() - (this.openedAt ?? 0);
+            if (elapsed >= this.recoveryTimeoutMs) {
+                this.state = "HALF_OPEN";
+                this.halfOpenInFlight = false;
+            }
+            else {
+                return false;
+            }
+        }
+        // HALF_OPEN - allow exactly one probe request
+        if (this.state === "HALF_OPEN") {
+            if (this.halfOpenInFlight)
+                return false;
+            this.halfOpenInFlight = true;
+            return true;
+        }
+        return false;
+    }
+    onSuccess() {
+        this.consecutiveFailures = 0;
+        this.openedAt = null;
+        this.halfOpenInFlight = false;
+        this.state = "CLOSED";
+    }
+    onFailure() {
+        this.halfOpenInFlight = false;
+        this.consecutiveFailures++;
+        if (this.consecutiveFailures >= this.failureThreshold || this.state === "HALF_OPEN") {
+            this.state = "OPEN";
+            this.openedAt = Date.now();
+        }
+    }
+    /**
+     * Returns the effective circuit state.
+     * Pure — no mutations. If OPEN and recovery timeout has elapsed,
+     * returns HALF_OPEN to reflect that a probe would be allowed,
+     * but does NOT set halfOpenInFlight (that happens in allowRequest()).
+     */
+    getState() {
+        if (this.state === "OPEN" && this.openedAt !== null) {
+            if (Date.now() - this.openedAt >= this.recoveryTimeoutMs) {
+                return "HALF_OPEN";
+            }
+        }
+        return this.state;
+    }
+    reset() {
+        this.state = "CLOSED";
+        this.consecutiveFailures = 0;
+        this.openedAt = null;
+        this.halfOpenInFlight = false;
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/bridge/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/bridge/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,MAAM,OAAO,cAAc;IACjB,KAAK,GAAiB,QAAQ,CAAC;IAC/B,mBAAmB,GAAG,CAAC,CAAC;IACxB,QAAQ,GAAkB,IAAI,CAAC;IAC/B,gBAAgB,GAAG,KAAK,CAAC;IAEhB,gBAAgB,CAAS;IACzB,iBAAiB,CAAS;IAClC,kBAAkB,CAAS;IAEpC,YAAY,OAA8B,EAAE;QAC1C,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,MAAM,CAAC;QAC1D,IAAI,CAAC,kBAAkB;YACrB,IAAI,CAAC,kBAAkB;gBACvB,qGAAqG,CAAC;IAC1G,CAAC;IAED,kDAAkD;IAClD,YAAY;QACV,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAEzC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;YAClD,IAAI,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACtC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;gBACzB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,gBAAgB;gBAAE,OAAO,KAAK,CAAC;YACxC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS;QACP,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;IACxB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACpF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACzD,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACtB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAChC,CAAC;CACF"}

package/dist/bridge/event-handler.d.ts

@@ -0,0 +1,18 @@
+import type { OpenCodeEvent } from "./opencode-client.js";
+import { TypedEventEmitter } from "../utils/typed-emitter.js";
+export interface EventHandlerEvents {
+    response: (sessionId: string, text: string) => void;
+    partial: (sessionId: string, delta: string) => void;
+    error: (sessionId: string, error: unknown) => void;
+    toolCall: (sessionId: string, toolName: string, input: unknown) => void;
+}
+export declare class EventHandler {
+    readonly events: TypedEventEmitter<EventHandlerEvents>;
+    private readonly accumulator;
+    private cleanupTimer;
+    constructor();
+    dispose(): void;
+    handleEvent(event: OpenCodeEvent): void;
+    private pruneStale;
+}
+//# sourceMappingURL=event-handler.d.ts.map

package/dist/bridge/event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.d.ts","sourceRoot":"","sources":["../../src/bridge/event-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAQ,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACzE;AAsCD,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,wCAA+C;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6F;IACzH,OAAO,CAAC,YAAY,CAA+C;;IAOnE,OAAO,IAAI,IAAI;IAQf,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IA2EvC,OAAO,CAAC,UAAU;CAQnB"}