@putervision/behavior-mcp 0.1.1

package/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing to PuterVision
+
+We welcome contributions! Please make sure that all PRs pass tests and formatting checks:
+
+```bash
+npm run ci
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PuterVision
+
+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/PROJECT_INSTRUCTIONS_TEMPLATE.md

@@ -0,0 +1,9 @@
+# Agent Instructions for behavior-mcp
+
+This project uses `@putervision/behavior-mcp` for high-frequency in-browser behavior execution.
+
+## Mandatory Workflow
+1. **Load**: Activate behavior trees via `load_behavior(load)`.
+2. **Monitor**: Check execution status with `get_status(current)`.
+3. **Triggers**: Register reactive emergency interrupts via `register_trigger(register)`.
+4. **Safety**: Use `abort_behavior(abort)` to halt execution on anomalies.

package/README.md

@@ -0,0 +1,94 @@
+# @putervision/behavior-mcp
+
+[![npm version](https://img.shields.io/npm/v/@putervision/behavior-mcp.svg)](https://www.npmjs.com/package/@putervision/behavior-mcp)
+[![CI](https://github.com/putervision/behavior-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/putervision/behavior-mcp/actions/workflows/ci.yml)
+[![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+> **High-Frequency (~60Hz) In-Browser Behavior Tree Tactical Runtime Engine for AI Agents**
+
+`@putervision/behavior-mcp` is a Model Context Protocol (MCP) server that executes deterministic behavior trees directly in browser runtimes at ~60Hz with reactive trigger preemption, frame recordings, SHA-256 Merkle audit chains, and a 5-layer safety guardrail stack.
+
+🌐 **Official Documentation**: [putervision.com](https://putervision.com) • [Interactive Web Docs](docs/index.html)
+
+---
+
+## ⚡ 15-Second Quick Start
+
+```bash
+# 1. Initialize runtime & seed default behavior trees in your workspace
+npx @putervision/behavior-mcp init
+
+# 2. Run system diagnostic and health checks
+npx @putervision/behavior-mcp doctor
+
+# 3. Inspect active executions, blackboard state, and reactive triggers
+npx @putervision/behavior-mcp inspect
+```
+
+---
+
+## 🛠️ 10 Core MCP Tools
+
+| Tool | Actions | Purpose |
+|------|---------|---------|
+| `load_behavior` | `load`, `unload`, `swap` | Inject, initialize, or hot-swap a behavior tree in browser runtime |
+| `set_parameters` | `set`, `get`, `reset` | Dynamically update or query runtime execution parameters |
+| `get_status` | `current`, `history`, `tree_state` | Query active status, node traversal path, tick count, duration |
+| `abort_behavior` | `abort`, `pause`, `resume` | Halt, pause, or resume behavior execution safely |
+| `register_trigger` | `register`, `list` | Configure reactive interrupt triggers with priority preemption |
+| `replay_recording` | `capture`, `list` | Capture or inspect deterministic browser action sequences |
+| `get_metrics` | `current`, `history` | Retrieve runtime telemetry, tick durations, and stuck events |
+| `manage_behaviors` | `register`, `get`, `list` | CRUD for immutable behavior tree JSON with SHA-256 tree hashes |
+| `manage_blackboard` | `get`, `set` | Read, write, or query shared behavior tree blackboard variables |
+| `manage_runtime_db` | `stats`, `audit`, `snapshot`, `restore` | SQLite diagnostics, SHA-256 Merkle audit, and checkpoint rollback |
+
+---
+
+## 🛡️ 5-Layer Safety Guardrail Stack
+
+1. **Fail-Closed Evaluator**: Unrecognized node definitions throw fatal exceptions immediately.
+2. **Watchdog Heartbeat Timer**: Halts execution if tick evaluation stalls beyond 5,000ms.
+3. **Action Rate Limiter**: Strict 60 actions/sec maximum throughput ceiling.
+4. **Leaf Policy Gate**: Blocks irreversible, high-risk mutations (`delete_item`, `spend_currency`).
+5. **Emergency Kill Switch**: Atomic safety latch (`EmergencySafety.engageKillSwitch()`) halts all runtimes.
+
+---
+
+## 📚 Deep Documentation Guides
+
+- 📖 **[Formal API Reference](docs/api-reference.md)**: Full parameter tables, type definitions, and tool schemas.
+- 💡 **[Core Architecture & Concepts](docs/concepts.md)**: Behavior tree execution model, ~60Hz loop, and trigger lifecycle.
+- 🖥️ **[CLI Usage Guide](docs/cli-usage.md)**: Complete CLI command reference (`init`, `doctor`, `inspect`, `run`).
+- 💾 **[Database Schema](docs/database-schema.md)**: SQLite table structures, indexes, and Merkle audit ledger.
+- ⚙️ **[Configuration Reference](docs/configuration.md)**: `.behavior-mcp.json` parameters and environment variables.
+
+---
+
+## 🔗 Client Configuration
+
+Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "behavior-mcp": {
+      "command": "behavior-mcp",
+      "args": ["run"]
+    }
+  }
+}
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run full unit and integration test suite across 15 test files (87 tests)
+npm test
+```
+
+---
+
+## 📄 License
+MIT © PuterVision

package/SECURITY.md

@@ -0,0 +1,11 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.1.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it via private security advisory on GitHub or email security@putervision.org. Please do not open public issues for security vulnerabilities.

package/dist/chunk-FXYS43D6.js

@@ -0,0 +1,291 @@
+import {
+  BehaviorRegistry,
+  generateId,
+  getCurrentIsoString,
+  logRuntimeEvent,
+  safeJsonParse,
+  safeJsonStringify
+} from "./chunk-QU5PNQP4.js";
+import {
+  NotFoundError,
+  ValidationError
+} from "./chunk-L2LJRSDU.js";
+
+// src/engine/executor.ts
+var ExecutionEngine = class {
+  static startExecution(db, params) {
+    const behavior = BehaviorRegistry.getBehavior(db, {
+      project: params.project,
+      name: params.behavior_name,
+      version: params.behavior_version
+    });
+    const id = generateId();
+    const now = getCurrentIsoString();
+    db.prepare(
+      `
+      INSERT INTO execution_state (
+        id, project, behavior_name, behavior_version, session_id, intention_id,
+        status, active_node_path, blackboard_json, current_tick, tick_rate_hz,
+        duration_ms, stuck_score, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, 'running', 'root', ?, 0, 60, 0, 0.0, ?, ?)
+    `
+    ).run(
+      id,
+      params.project,
+      behavior.name,
+      behavior.version,
+      params.session_id ?? null,
+      params.intention_id ?? null,
+      safeJsonStringify(params.parameters || {}),
+      now,
+      now
+    );
+    logRuntimeEvent(db, {
+      project: params.project,
+      entity_id: id,
+      entity_type: "execution",
+      action: "start",
+      details: {
+        behavior_name: behavior.name,
+        intention_id: params.intention_id,
+        trace_id: params.trace_id
+      }
+    });
+    return {
+      id,
+      project: params.project,
+      behavior_name: behavior.name,
+      behavior_version: behavior.version,
+      session_id: params.session_id,
+      intention_id: params.intention_id,
+      trace_id: params.trace_id,
+      status: "running",
+      active_node_path: "root",
+      blackboard_json: safeJsonStringify(params.parameters || {}),
+      current_tick: 0,
+      tick_rate_hz: 60,
+      duration_ms: 0,
+      stuck_score: 0,
+      created_at: now,
+      updated_at: now
+    };
+  }
+  static tickExecution(db, params) {
+    const current = this.getExecution(db, { project: params.project, id: params.execution_id });
+    const now = getCurrentIsoString();
+    const newTick = current.current_tick + 1;
+    const durationMs = Math.round(newTick * (1e3 / current.tick_rate_hz));
+    const status = params.status || current.status;
+    const nodePath = params.active_node_path || current.active_node_path;
+    const stuckScore = params.stuck_score !== void 0 ? params.stuck_score : current.stuck_score;
+    const bbJson = params.blackboard ? safeJsonStringify(params.blackboard) : current.blackboard_json;
+    db.prepare(
+      `
+      UPDATE execution_state SET
+        current_tick = ?, duration_ms = ?, status = ?, active_node_path = ?,
+        stuck_score = ?, blackboard_json = ?, updated_at = ?
+      WHERE id = ?
+    `
+    ).run(newTick, durationMs, status, nodePath, stuckScore, bbJson, now, current.id);
+    return {
+      ...current,
+      current_tick: newTick,
+      duration_ms: durationMs,
+      status,
+      active_node_path: nodePath,
+      stuck_score: stuckScore,
+      blackboard_json: bbJson,
+      updated_at: now
+    };
+  }
+  static stopExecution(db, params) {
+    const current = this.getExecution(db, { project: params.project, id: params.execution_id });
+    const now = getCurrentIsoString();
+    db.prepare(
+      `
+      UPDATE execution_state SET
+        status = ?, error = ?, updated_at = ?
+      WHERE id = ?
+    `
+    ).run(params.status, params.error_message ?? null, now, current.id);
+    logRuntimeEvent(db, {
+      project: params.project,
+      entity_id: current.id,
+      entity_type: "execution",
+      action: "stop",
+      details: { status: params.status, error: params.error_message }
+    });
+    return {
+      intention_id: current.intention_id || "manual",
+      execution_id: current.id,
+      session_id: current.session_id || "default",
+      status: params.status,
+      active_node: current.active_node_path,
+      tick_count: current.current_tick,
+      duration_ms: current.duration_ms,
+      error_message: params.error_message,
+      completed_at: now
+    };
+  }
+  static getExecution(db, params) {
+    const row = db.prepare("SELECT * FROM execution_state WHERE project = ? AND id = ?").get(params.project, params.id);
+    if (!row) throw new NotFoundError(`Execution instance "${params.id}" not found.`);
+    return this.mapRowToExecution(row);
+  }
+  static listExecutions(db, params) {
+    let sql = "SELECT * FROM execution_state WHERE project = ?";
+    const sqlParams = [params.project];
+    if (params.status) {
+      sql += " AND status = ?";
+      sqlParams.push(params.status);
+    }
+    sql += " ORDER BY created_at DESC LIMIT ?";
+    sqlParams.push(params.limit || 50);
+    const rows = db.prepare(sql).all(...sqlParams);
+    return rows.map((r) => this.mapRowToExecution(r));
+  }
+  static mapRowToExecution(row) {
+    return {
+      id: row.id,
+      project: row.project,
+      behavior_name: row.behavior_name,
+      behavior_version: row.behavior_version,
+      session_id: row.session_id,
+      intention_id: row.intention_id,
+      status: row.status,
+      active_node_path: row.active_node_path,
+      blackboard_json: row.blackboard_json || "{}",
+      current_tick: row.current_tick,
+      tick_rate_hz: row.tick_rate_hz,
+      duration_ms: row.duration_ms,
+      stuck_score: row.stuck_score,
+      error: row.error,
+      metadata: safeJsonParse(row.metadata_json, void 0),
+      created_at: row.created_at,
+      updated_at: row.updated_at
+    };
+  }
+};
+
+// src/engine/triggers.ts
+var TriggerRegistry = class {
+  static registerTrigger(db, params) {
+    if (!params.name || !params.behavior_name || !params.condition_type) {
+      throw new ValidationError("Trigger name, behavior_name, and condition_type are required.");
+    }
+    const id = generateId();
+    const now = getCurrentIsoString();
+    const priority = params.priority !== void 0 ? params.priority : 0.5;
+    const cooldown_ms = params.cooldown_ms !== void 0 ? params.cooldown_ms : 1e3;
+    db.prepare(
+      `
+      INSERT INTO triggers (
+        id, project, name, behavior_name, condition_type, condition_params_json,
+        priority, cooldown_ms, is_enabled, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
+      ON CONFLICT(project, name) DO UPDATE SET
+        behavior_name = excluded.behavior_name,
+        condition_type = excluded.condition_type,
+        condition_params_json = excluded.condition_params_json,
+        priority = excluded.priority,
+        cooldown_ms = excluded.cooldown_ms,
+        updated_at = excluded.updated_at
+    `
+    ).run(
+      id,
+      params.project,
+      params.name,
+      params.behavior_name,
+      params.condition_type,
+      safeJsonStringify(params.condition_params || {}),
+      priority,
+      cooldown_ms,
+      now,
+      now
+    );
+    logRuntimeEvent(db, {
+      project: params.project,
+      entity_id: id,
+      entity_type: "trigger",
+      action: "register",
+      details: { name: params.name, behavior_name: params.behavior_name, priority }
+    });
+    return {
+      id,
+      project: params.project,
+      name: params.name,
+      behavior_name: params.behavior_name,
+      condition_type: params.condition_type,
+      condition_params: params.condition_params || {},
+      priority,
+      cooldown_ms,
+      is_enabled: true,
+      created_at: now,
+      updated_at: now
+    };
+  }
+  static listTriggers(db, project) {
+    const rows = db.prepare("SELECT * FROM triggers WHERE project = ? ORDER BY priority DESC, name ASC").all(project);
+    return rows.map((r) => this.mapRowToTrigger(r));
+  }
+  static evaluateTriggers(db, params) {
+    const triggers = this.listTriggers(db, params.project).filter((t) => t.is_enabled);
+    const now = Date.now();
+    for (const trig of triggers) {
+      if (trig.last_fired_at && now - new Date(trig.last_fired_at).getTime() < trig.cooldown_ms) {
+        continue;
+      }
+      let matches = false;
+      if (trig.condition_type === "hp_threshold") {
+        const hp = params.telemetry.hp ?? 100;
+        const threshold = trig.condition_params.threshold ?? 30;
+        matches = hp <= threshold;
+      } else if (trig.condition_type === "enemy_proximity") {
+        const enemyDist = params.telemetry.enemy_distance ?? 999;
+        const radius = trig.condition_params.radius ?? 10;
+        matches = enemyDist <= radius;
+      }
+      if (matches) {
+        db.prepare("UPDATE triggers SET last_fired_at = ?, updated_at = ? WHERE id = ?").run(
+          new Date(now).toISOString(),
+          new Date(now).toISOString(),
+          trig.id
+        );
+        return trig;
+      }
+    }
+    return null;
+  }
+  static mapRowToTrigger(row) {
+    return {
+      id: row.id,
+      project: row.project,
+      name: row.name,
+      behavior_name: row.behavior_name,
+      condition_type: row.condition_type,
+      condition_params: safeJsonParse(row.condition_params_json, {}),
+      priority: row.priority,
+      cooldown_ms: row.cooldown_ms,
+      last_fired_at: row.last_fired_at,
+      is_enabled: row.is_enabled === 1,
+      metadata: safeJsonParse(row.metadata_json, void 0),
+      created_at: row.created_at,
+      updated_at: row.updated_at
+    };
+  }
+};
+
+// src/utils/version.ts
+function getVersion() {
+  if (true) {
+    return "0.1.1";
+  }
+  return "0.1.1";
+}
+
+export {
+  ExecutionEngine,
+  TriggerRegistry,
+  getVersion
+};
+//# sourceMappingURL=chunk-FXYS43D6.js.map

package/dist/chunk-FXYS43D6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/executor.ts","../src/engine/triggers.ts","../src/utils/version.ts"],"sourcesContent":["import Database from 'better-sqlite3';\nimport { ExecutionState, ExecutionId, ExecutionStatus, Outcome } from '../schema/types.js';\nimport { generateId } from '../utils/id.js';\nimport { getCurrentIsoString } from '../utils/time.js';\nimport { safeJsonParse, safeJsonStringify } from '../utils/json-validator.js';\nimport { NotFoundError } from '../utils/errors.js';\nimport { BehaviorRegistry } from './behaviors.js';\nimport { logRuntimeEvent } from './events.js';\n\nexport class ExecutionEngine {\n  static startExecution(\n    db: Database.Database,\n    params: {\n      project: string;\n      behavior_name: string;\n      behavior_version?: number;\n      session_id?: string;\n      intention_id?: string;\n      trace_id?: string;\n      parameters?: Record<string, unknown>;\n      client_request_id?: string;\n    }\n  ): ExecutionState {\n    const behavior = BehaviorRegistry.getBehavior(db, {\n      project: params.project,\n      name: params.behavior_name,\n      version: params.behavior_version,\n    });\n\n    const id = generateId() as ExecutionId;\n    const now = getCurrentIsoString();\n\n    db.prepare(\n      `\n      INSERT INTO execution_state (\n        id, project, behavior_name, behavior_version, session_id, intention_id,\n        status, active_node_path, blackboard_json, current_tick, tick_rate_hz,\n        duration_ms, stuck_score, created_at, updated_at\n      ) VALUES (?, ?, ?, ?, ?, ?, 'running', 'root', ?, 0, 60, 0, 0.0, ?, ?)\n    `\n    ).run(\n      id,\n      params.project,\n      behavior.name,\n      behavior.version,\n      params.session_id ?? null,\n      params.intention_id ?? null,\n      safeJsonStringify(params.parameters || {}),\n      now,\n      now\n    );\n\n    logRuntimeEvent(db, {\n      project: params.project,\n      entity_id: id,\n      entity_type: 'execution',\n      action: 'start',\n      details: {\n        behavior_name: behavior.name,\n        intention_id: params.intention_id,\n        trace_id: params.trace_id,\n      },\n    });\n\n    return {\n      id,\n      project: params.project,\n      behavior_name: behavior.name,\n      behavior_version: behavior.version,\n      session_id: params.session_id,\n      intention_id: params.intention_id,\n      trace_id: params.trace_id,\n      status: 'running',\n      active_node_path: 'root',\n      blackboard_json: safeJsonStringify(params.parameters || {}),\n      current_tick: 0,\n      tick_rate_hz: 60,\n      duration_ms: 0,\n      stuck_score: 0.0,\n      created_at: now,\n      updated_at: now,\n    };\n  }\n\n  static tickExecution(\n    db: Database.Database,\n    params: {\n      project: string;\n      execution_id: string;\n      active_node_path?: string;\n      status?: ExecutionStatus;\n      stuck_score?: number;\n      blackboard?: Record<string, unknown>;\n    }\n  ): ExecutionState {\n    const current = this.getExecution(db, { project: params.project, id: params.execution_id });\n    const now = getCurrentIsoString();\n    const newTick = current.current_tick + 1;\n    const durationMs = Math.round(newTick * (1000 / current.tick_rate_hz));\n    const status = params.status || current.status;\n    const nodePath = params.active_node_path || current.active_node_path;\n    const stuckScore = params.stuck_score !== undefined ? params.stuck_score : current.stuck_score;\n    const bbJson = params.blackboard\n      ? safeJsonStringify(params.blackboard)\n      : current.blackboard_json;\n\n    db.prepare(\n      `\n      UPDATE execution_state SET\n        current_tick = ?, duration_ms = ?, status = ?, active_node_path = ?,\n        stuck_score = ?, blackboard_json = ?, updated_at = ?\n      WHERE id = ?\n    `\n    ).run(newTick, durationMs, status, nodePath, stuckScore, bbJson, now, current.id);\n\n    return {\n      ...current,\n      current_tick: newTick,\n      duration_ms: durationMs,\n      status,\n      active_node_path: nodePath,\n      stuck_score: stuckScore,\n      blackboard_json: bbJson,\n      updated_at: now,\n    };\n  }\n\n  static stopExecution(\n    db: Database.Database,\n    params: {\n      project: string;\n      execution_id: string;\n      status: ExecutionStatus;\n      error_message?: string;\n    }\n  ): Outcome {\n    const current = this.getExecution(db, { project: params.project, id: params.execution_id });\n    const now = getCurrentIsoString();\n\n    db.prepare(\n      `\n      UPDATE execution_state SET\n        status = ?, error = ?, updated_at = ?\n      WHERE id = ?\n    `\n    ).run(params.status, params.error_message ?? null, now, current.id);\n\n    logRuntimeEvent(db, {\n      project: params.project,\n      entity_id: current.id,\n      entity_type: 'execution',\n      action: 'stop',\n      details: { status: params.status, error: params.error_message },\n    });\n\n    return {\n      intention_id: current.intention_id || 'manual',\n      execution_id: current.id,\n      session_id: current.session_id || 'default',\n      status: params.status,\n      active_node: current.active_node_path,\n      tick_count: current.current_tick,\n      duration_ms: current.duration_ms,\n      error_message: params.error_message,\n      completed_at: now,\n    };\n  }\n\n  static getExecution(\n    db: Database.Database,\n    params: { project: string; id: string }\n  ): ExecutionState {\n    const row = db\n      .prepare('SELECT * FROM execution_state WHERE project = ? AND id = ?')\n      .get(params.project, params.id) as any;\n    if (!row) throw new NotFoundError(`Execution instance \"${params.id}\" not found.`);\n    return this.mapRowToExecution(row);\n  }\n\n  static listExecutions(\n    db: Database.Database,\n    params: { project: string; status?: ExecutionStatus; limit?: number }\n  ): ExecutionState[] {\n    let sql = 'SELECT * FROM execution_state WHERE project = ?';\n    const sqlParams: any[] = [params.project];\n\n    if (params.status) {\n      sql += ' AND status = ?';\n      sqlParams.push(params.status);\n    }\n\n    sql += ' ORDER BY created_at DESC LIMIT ?';\n    sqlParams.push(params.limit || 50);\n\n    const rows = db.prepare(sql).all(...sqlParams) as any[];\n    return rows.map((r) => this.mapRowToExecution(r));\n  }\n\n  private static mapRowToExecution(row: any): ExecutionState {\n    return {\n      id: row.id as ExecutionId,\n      project: row.project,\n      behavior_name: row.behavior_name,\n      behavior_version: row.behavior_version,\n      session_id: row.session_id,\n      intention_id: row.intention_id,\n      status: row.status as ExecutionStatus,\n      active_node_path: row.active_node_path,\n      blackboard_json: row.blackboard_json || '{}',\n      current_tick: row.current_tick,\n      tick_rate_hz: row.tick_rate_hz,\n      duration_ms: row.duration_ms,\n      stuck_score: row.stuck_score,\n      error: row.error,\n      metadata: safeJsonParse(row.metadata_json, undefined),\n      created_at: row.created_at,\n      updated_at: row.updated_at,\n    };\n  }\n}\n","import Database from 'better-sqlite3';\nimport { ReactiveTrigger, TriggerId } from '../schema/types.js';\nimport { generateId } from '../utils/id.js';\nimport { getCurrentIsoString } from '../utils/time.js';\nimport { safeJsonParse, safeJsonStringify } from '../utils/json-validator.js';\nimport { ValidationError, NotFoundError } from '../utils/errors.js';\nimport { logRuntimeEvent } from './events.js';\n\nexport class TriggerRegistry {\n  static registerTrigger(\n    db: Database.Database,\n    params: {\n      project: string;\n      name: string;\n      behavior_name: string;\n      condition_type: string;\n      condition_params: Record<string, unknown>;\n      priority?: number;\n      cooldown_ms?: number;\n    }\n  ): ReactiveTrigger {\n    if (!params.name || !params.behavior_name || !params.condition_type) {\n      throw new ValidationError('Trigger name, behavior_name, and condition_type are required.');\n    }\n\n    const id = generateId() as TriggerId;\n    const now = getCurrentIsoString();\n    const priority = params.priority !== undefined ? params.priority : 0.5;\n    const cooldown_ms = params.cooldown_ms !== undefined ? params.cooldown_ms : 1000;\n\n    db.prepare(\n      `\n      INSERT INTO triggers (\n        id, project, name, behavior_name, condition_type, condition_params_json,\n        priority, cooldown_ms, is_enabled, created_at, updated_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)\n      ON CONFLICT(project, name) DO UPDATE SET\n        behavior_name = excluded.behavior_name,\n        condition_type = excluded.condition_type,\n        condition_params_json = excluded.condition_params_json,\n        priority = excluded.priority,\n        cooldown_ms = excluded.cooldown_ms,\n        updated_at = excluded.updated_at\n    `\n    ).run(\n      id,\n      params.project,\n      params.name,\n      params.behavior_name,\n      params.condition_type,\n      safeJsonStringify(params.condition_params || {}),\n      priority,\n      cooldown_ms,\n      now,\n      now\n    );\n\n    logRuntimeEvent(db, {\n      project: params.project,\n      entity_id: id,\n      entity_type: 'trigger',\n      action: 'register',\n      details: { name: params.name, behavior_name: params.behavior_name, priority },\n    });\n\n    return {\n      id,\n      project: params.project,\n      name: params.name,\n      behavior_name: params.behavior_name,\n      condition_type: params.condition_type,\n      condition_params: params.condition_params || {},\n      priority,\n      cooldown_ms,\n      is_enabled: true,\n      created_at: now,\n      updated_at: now,\n    };\n  }\n\n  static listTriggers(db: Database.Database, project: string): ReactiveTrigger[] {\n    const rows = db\n      .prepare('SELECT * FROM triggers WHERE project = ? ORDER BY priority DESC, name ASC')\n      .all(project) as any[];\n    return rows.map((r) => this.mapRowToTrigger(r));\n  }\n\n  static evaluateTriggers(\n    db: Database.Database,\n    params: { project: string; telemetry: Record<string, any> }\n  ): ReactiveTrigger | null {\n    const triggers = this.listTriggers(db, params.project).filter((t) => t.is_enabled);\n    const now = Date.now();\n\n    for (const trig of triggers) {\n      if (trig.last_fired_at && now - new Date(trig.last_fired_at).getTime() < trig.cooldown_ms) {\n        continue; // In cooldown\n      }\n\n      let matches = false;\n      if (trig.condition_type === 'hp_threshold') {\n        const hp = params.telemetry.hp ?? 100;\n        const threshold = (trig.condition_params.threshold as number) ?? 30;\n        matches = hp <= threshold;\n      } else if (trig.condition_type === 'enemy_proximity') {\n        const enemyDist = params.telemetry.enemy_distance ?? 999;\n        const radius = (trig.condition_params.radius as number) ?? 10;\n        matches = enemyDist <= radius;\n      }\n\n      if (matches) {\n        db.prepare('UPDATE triggers SET last_fired_at = ?, updated_at = ? WHERE id = ?').run(\n          new Date(now).toISOString(),\n          new Date(now).toISOString(),\n          trig.id\n        );\n        return trig;\n      }\n    }\n    return null;\n  }\n\n  private static mapRowToTrigger(row: any): ReactiveTrigger {\n    return {\n      id: row.id as TriggerId,\n      project: row.project,\n      name: row.name,\n      behavior_name: row.behavior_name,\n      condition_type: row.condition_type,\n      condition_params: safeJsonParse(row.condition_params_json, {}),\n      priority: row.priority,\n      cooldown_ms: row.cooldown_ms,\n      last_fired_at: row.last_fired_at,\n      is_enabled: row.is_enabled === 1,\n      metadata: safeJsonParse(row.metadata_json, undefined),\n      created_at: row.created_at,\n      updated_at: row.updated_at,\n    };\n  }\n}\n","declare const __APP_VERSION__: string | undefined;\n\nexport function getVersion(): string {\n  if (typeof __APP_VERSION__ !== 'undefined') {\n    return __APP_VERSION__;\n  }\n  return '0.1.1';\n}\n"],"mappings":"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","names":[]}