@sesamespace/hivemind 0.10.0 → 0.11.1

package/dist/{chunk-DPLCEMEC.js → chunk-ZA4NWNS6.js}

@@ -1,6 +1,6 @@
 import {
   startPipeline
-} from "./chunk-M3A2WRXM.js";
+} from "./chunk-OB6OXLPC.js";
 
 // packages/cli/src/commands/start.ts
 import { resolve } from "path";
@@ -66,4 +66,4 @@ Options:
 export {
   runStartCommand
 };
-//# sourceMappingURL=chunk-DPLCEMEC.js.map
+//# sourceMappingURL=chunk-ZA4NWNS6.js.map

package/dist/commands/fleet.js

@@ -1,8 +1,8 @@
 import {
   runFleetCommand
-} from "../chunk-FBQBBAPZ.js";
-import "../chunk-IXBIAX76.js";
-import "../chunk-M3A2WRXM.js";
+} from "../chunk-4C6B2AMB.js";
+import "../chunk-K6KL2VD6.js";
+import "../chunk-OB6OXLPC.js";
 import "../chunk-DGUM43GV.js";
 export {
   runFleetCommand

package/dist/commands/init.js

@@ -1,8 +1,8 @@
 import {
   runInitCommand
-} from "../chunk-FK6WYXRM.js";
-import "../chunk-IXBIAX76.js";
-import "../chunk-M3A2WRXM.js";
+} from "../chunk-4YXOQGQC.js";
+import "../chunk-K6KL2VD6.js";
+import "../chunk-OB6OXLPC.js";
 import "../chunk-DGUM43GV.js";
 export {
   runInitCommand

package/dist/commands/service.js

@@ -1,6 +1,6 @@
 import {
   runServiceCommand
-} from "../chunk-IJRAVHQC.js";
+} from "../chunk-LWJCKTQP.js";
 import "../chunk-DGUM43GV.js";
 export {
   runServiceCommand

package/dist/commands/start.js

@@ -1,8 +1,8 @@
 import {
   runStartCommand
-} from "../chunk-DPLCEMEC.js";
-import "../chunk-IXBIAX76.js";
-import "../chunk-M3A2WRXM.js";
+} from "../chunk-ZA4NWNS6.js";
+import "../chunk-K6KL2VD6.js";
+import "../chunk-OB6OXLPC.js";
 import "../chunk-DGUM43GV.js";
 export {
   runStartCommand

package/dist/commands/watchdog.js

@@ -1,8 +1,8 @@
 import {
   runWatchdogCommand
-} from "../chunk-BHCDOHSK.js";
-import "../chunk-IXBIAX76.js";
-import "../chunk-M3A2WRXM.js";
+} from "../chunk-LYL5GG2F.js";
+import "../chunk-K6KL2VD6.js";
+import "../chunk-OB6OXLPC.js";
 import "../chunk-DGUM43GV.js";
 export {
   runWatchdogCommand

package/dist/dashboard.html

@@ -406,26 +406,36 @@ async function loadHealthView() {
   const tbody = document.getElementById('ctx-summary-body');
   const scoringEl = document.getElementById('scoring-config-section');
 
+  let stats = null;
+  let contexts = [];
+
+  // Fetch stats and contexts independently so partial data still shows
   try {
-    const [statsRes, ctxRes] = await Promise.all([
-      fetch(API + '/api/stats'),
-      fetch(API + '/api/contexts'),
-    ]);
-
-    if (!statsRes.ok || !ctxRes.ok) {
-      showNotification('Failed to load system stats', 'error');
-      cards.innerHTML = '<p style="color:var(--red)">Failed to load stats (daemon may be offline)</p>';
-      return;
+    const ctxRes = await fetch(API + '/api/contexts');
+    if (ctxRes.ok) {
+      const ctxData = await ctxRes.json();
+      contexts = ctxData.contexts || [];
     }
+  } catch {}
 
-    const stats = await statsRes.json();
-    const ctxData = await ctxRes.json();
-    const contexts = ctxData.contexts || [];
+  try {
+    const statsRes = await fetch(API + '/api/stats');
+    if (statsRes.ok) stats = await statsRes.json();
+  } catch {}
 
-    const totalEpisodes = Object.values(stats.total_episodes || {}).reduce((a, b) => a + b, 0);
+  if (!stats && contexts.length === 0) {
+    cards.innerHTML = '<p style="color:var(--red)">Cannot connect to memory daemon</p>';
+    showNotification('Health view failed: daemon may be offline', 'error');
+    return;
+  }
+
+  try {
     const reqCountRes = await fetch(API + '/api/requests?limit=1');
-    const reqCount = reqCountRes.ok ? (await reqCountRes.json()).total || 0 : '?';
+    var reqCount = reqCountRes.ok ? (await reqCountRes.json()).total || 0 : '?';
+  } catch { var reqCount = '?'; }
 
+  if (stats) {
+    const totalEpisodes = Object.values(stats.total_episodes || {}).reduce((a, b) => a + b, 0);
     cards.innerHTML = `
       <div class="status-card"><div class="label">Daemon Status</div><div class="value" style="color:var(${daemonStatus === 'ok' ? '--green' : '--red'})">${daemonStatus === 'ok' ? 'Online' : daemonStatus}</div><div class="sub">v${esc(daemonVersion)}</div></div>
       <div class="status-card"><div class="label">Embedding Model</div><div class="value" style="font-size:14px">${esc(stats.embedding_model)}</div></div>
@@ -434,26 +444,37 @@ async function loadHealthView() {
       <div class="status-card"><div class="label">Access Records</div><div class="value">${stats.total_access_records}</div></div>
       <div class="status-card"><div class="label">Request Logs</div><div class="value">${reqCount}</div></div>
     `;
+  } else {
+    const totalEpisodes = contexts.reduce((a, c) => a + (c.episode_count || 0), 0);
+    cards.innerHTML = `
+      <div class="status-card"><div class="label">Daemon Status</div><div class="value" style="color:var(${daemonStatus === 'ok' ? '--green' : '--red'})">${daemonStatus === 'ok' ? 'Online' : daemonStatus}</div><div class="sub">v${esc(daemonVersion)}</div></div>
+      <div class="status-card"><div class="label">Stats</div><div class="value" style="font-size:14px;color:var(--yellow)">Unavailable</div><div class="sub">/stats endpoint not found — rebuild daemon</div></div>
+      <div class="status-card"><div class="label">Total Episodes</div><div class="value">${totalEpisodes}</div><div class="sub">${contexts.length} contexts</div></div>
+      <div class="status-card"><div class="label">Request Logs</div><div class="value">${reqCount}</div></div>
+    `;
+  }
 
-    // Context summary table
-    tbody.innerHTML = '';
-    for (const c of contexts) {
-      const epCount = stats.total_episodes?.[c.name] ?? c.episode_count ?? 0;
-      const tr = document.createElement('tr');
-      tr.innerHTML = `<td style="color:var(--accent)">${esc(c.name)}</td><td>${epCount}</td><td>-</td><td>${c.created_at ? new Date(c.created_at).toLocaleDateString() : '-'}</td>`;
-      tbody.appendChild(tr);
-    }
+  // Context summary table — always populate from contexts data
+  tbody.innerHTML = '';
+  for (const c of contexts) {
+    const epCount = stats ? (stats.total_episodes?.[c.name] ?? c.episode_count ?? 0) : (c.episode_count ?? 0);
+    const tr = document.createElement('tr');
+    tr.innerHTML = `<td style="color:var(--accent)">${esc(c.name)}</td><td>${epCount}</td><td>-</td><td>${c.created_at ? new Date(c.created_at).toLocaleDateString() : '-'}</td>`;
+    tbody.appendChild(tr);
+  }
 
-    // Scoring section
-    const defaultHL = stats.default_half_life_hours || 48;
+  // Scoring section
+  const defaultHL = (stats && stats.default_half_life_hours) || 48;
+  if (stats) {
     scoringEl.innerHTML = `
       <p style="color:var(--text2);font-size:13px;margin-bottom:12px">Default half-life: <strong>${defaultHL}h</strong>. Episodes lose ~50% relevance weight every ${defaultHL} hours.</p>
       ${renderDecayCurve(defaultHL)}
     `;
-
-  } catch (err) {
-    cards.innerHTML = '<p style="color:var(--red)">Cannot connect to memory daemon</p>';
-    showNotification('Health view failed: ' + err.message, 'error');
+  } else {
+    scoringEl.innerHTML = `
+      <p style="color:var(--yellow);font-size:13px;margin-bottom:12px">Stats unavailable — showing default half-life: <strong>${defaultHL}h</strong>.</p>
+      ${renderDecayCurve(defaultHL)}
+    `;
   }
 }
 
@@ -998,37 +1019,41 @@ async function loadPromotion() {
 
 async function loadThresholds() {
   const el = document.getElementById('promo-thresholds');
+  let stats = null;
+  let statsUnavailable = false;
   try {
     const res = await fetch(API + '/api/stats');
-    if (!res.ok) { el.innerHTML = '<p style="color:var(--red)">Failed to load stats</p>'; return; }
-    const stats = await res.json();
-    const t = stats.promotion_thresholds || { access: 5, cooccurrence: 3 };
-    el.innerHTML = `
-      <div class="status-grid" style="margin-bottom:24px">
-        <div class="status-card">
-          <div class="label">Access Threshold</div>
-          <div class="value">${t.access}</div>
-          <div class="sub">Episode must be accessed at least ${t.access} times</div>
-        </div>
-        <div class="status-card">
-          <div class="label">Co-occurrence Threshold</div>
-          <div class="value">${t.cooccurrence}</div>
-          <div class="sub">Episode must co-occur with others at least ${t.cooccurrence} times</div>
-        </div>
+    if (res.ok) stats = await res.json();
+    else statsUnavailable = true;
+  } catch { statsUnavailable = true; }
+
+  const t = (stats && stats.promotion_thresholds) || { access: 5, cooccurrence: 3 };
+  const warning = statsUnavailable ? '<p style="color:var(--yellow);font-size:12px;margin-bottom:12px;padding:8px;border:1px solid var(--yellow);border-radius:4px">/stats endpoint unavailable — showing default thresholds (access: 5, cooccurrence: 3). Rebuild daemon to enable.</p>' : '';
+
+  el.innerHTML = `
+    ${warning}
+    <div class="status-grid" style="margin-bottom:24px">
+      <div class="status-card">
+        <div class="label">Access Threshold</div>
+        <div class="value">${t.access}</div>
+        <div class="sub">Episode must be accessed at least ${t.access} times</div>
       </div>
-      <h3 style="margin-bottom:12px">How Promotion Works</h3>
-      <div style="color:var(--text2);font-size:13px;line-height:1.8">
-        <p><strong>L2 &rarr; L3 promotion</strong> happens when an episode meets <em>both</em> thresholds:</p>
-        <ol style="margin:8px 0 8px 20px">
-          <li>The episode has been accessed (retrieved in search results) at least <strong>${t.access} times</strong></li>
-          <li>The episode has co-occurred with other episodes at least <strong>${t.cooccurrence} times total</strong> (connection density)</li>
-        </ol>
-        <p>Once promoted, the episode's content is stored as long-term semantic knowledge (L3) and included in future system prompts for that context.</p>
+      <div class="status-card">
+        <div class="label">Co-occurrence Threshold</div>
+        <div class="value">${t.cooccurrence}</div>
+        <div class="sub">Episode must co-occur with others at least ${t.cooccurrence} times</div>
       </div>
-    `;
-  } catch (err) {
-    el.innerHTML = `<p style="color:var(--red)">Failed: ${esc(err.message)}</p>`;
-  }
+    </div>
+    <h3 style="margin-bottom:12px">How Promotion Works</h3>
+    <div style="color:var(--text2);font-size:13px;line-height:1.8">
+      <p><strong>L2 &rarr; L3 promotion</strong> happens when an episode meets <em>both</em> thresholds:</p>
+      <ol style="margin:8px 0 8px 20px">
+        <li>The episode has been accessed (retrieved in search results) at least <strong>${t.access} times</strong></li>
+        <li>The episode has co-occurred with other episodes at least <strong>${t.cooccurrence} times total</strong> (connection density)</li>
+      </ol>
+      <p>Once promoted, the episode's content is stored as long-term semantic knowledge (L3) and included in future system prompts for that context.</p>
+    </div>
+  `;
 }
 
 async function loadCandidates() {
@@ -1036,7 +1061,14 @@ async function loadCandidates() {
   el.innerHTML = '<p style="color:var(--text2)">Loading candidates...</p>';
   try {
     const res = await fetch(API + '/api/access/top?limit=50');
-    if (!res.ok) { el.innerHTML = '<p style="color:var(--red)">Failed to load candidates</p>'; return; }
+    if (!res.ok) {
+      if (res.status === 404) {
+        el.innerHTML = '<p style="color:var(--yellow);padding:12px;border:1px solid var(--yellow);border-radius:4px">/access/top endpoint not found (404). The running daemon binary may be outdated. Rebuild with: <code style="background:var(--bg);padding:2px 6px;border-radius:3px">cd packages/memory && cargo build --release</code> and restart the daemon.</p>';
+      } else {
+        el.innerHTML = `<p style="color:var(--red)">Failed to load candidates (HTTP ${res.status})</p>`;
+      }
+      return;
+    }
     const data = await res.json();
     const records = data.records || [];
 
@@ -1086,6 +1118,7 @@ async function loadScoringTab() {
     // Fetch scoring for each context
     const scoringData = {};
     let defaultHL = 48;
+    let scoringAvailable = true;
     for (const c of contexts) {
       try {
         const sRes = await fetch(API + '/api/contexts/' + encodeURIComponent(c.name) + '/scoring');
@@ -1093,23 +1126,30 @@ async function loadScoringTab() {
           const sd = await sRes.json();
           scoringData[c.name] = sd;
           defaultHL = sd.default_half_life_hours || 48;
+        } else if (sRes.status === 404) {
+          scoringAvailable = false;
         }
       } catch {}
     }
 
-    let html = `<p style="color:var(--text2);font-size:13px;margin-bottom:16px">Default half-life: <strong>${defaultHL}h</strong>. Settings reset when daemon restarts (in-memory only).</p>`;
+    let html = '';
+    if (!scoringAvailable) {
+      html += '<p style="color:var(--yellow);font-size:12px;margin-bottom:12px;padding:8px;border:1px solid var(--yellow);border-radius:4px">/scoring endpoint not found — the running daemon may be outdated. Showing default values. Rebuild daemon to enable per-context scoring configuration.</p>';
+    }
+    html += `<p style="color:var(--text2);font-size:13px;margin-bottom:16px">Default half-life: <strong>${defaultHL}h</strong>. Settings reset when daemon restarts (in-memory only).</p>`;
 
     html += '<table class="data-table"><thead><tr><th>Context</th><th>Half-Life (hours)</th><th>Custom?</th><th>Decay Curve</th><th>Actions</th></tr></thead><tbody>';
     for (const c of contexts) {
       const sd = scoringData[c.name] || {};
       const hl = sd.half_life_hours || defaultHL;
       const isCustom = sd.is_default === false;
+      const sourceLabel = !scoringAvailable ? '<span style="color:var(--text2)">Default (endpoint unavailable)</span>' : (isCustom ? '<span style="color:var(--yellow)">Yes</span>' : 'Default');
       html += `<tr>
         <td style="color:var(--accent)">${esc(c.name)}</td>
-        <td><input type="number" value="${hl}" min="1" max="8760" step="1" style="width:80px;background:var(--bg);border:1px solid var(--border);color:var(--text);padding:4px;border-radius:4px" id="hl-${esc(c.name)}" /></td>
-        <td>${isCustom ? '<span style="color:var(--yellow)">Yes</span>' : 'Default'}</td>
+        <td><input type="number" value="${hl}" min="1" max="8760" step="1" style="width:80px;background:var(--bg);border:1px solid var(--border);color:var(--text);padding:4px;border-radius:4px" id="hl-${esc(c.name)}" ${!scoringAvailable ? 'disabled' : ''} /></td>
+        <td>${sourceLabel}</td>
         <td>${renderDecayCurve(hl)}</td>
-        <td><button class="btn-sm" onclick="saveScoring('${esc(c.name)}')">Save</button></td>
+        <td><button class="btn-sm" onclick="saveScoring('${esc(c.name)}')" ${!scoringAvailable ? 'disabled' : ''}>Save</button></td>
       </tr>`;
     }
     html += '</tbody></table>';

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   PrimaryMemorySync,
   Watchdog,
   WorkerMemorySync
-} from "./chunk-IXBIAX76.js";
+} from "./chunk-K6KL2VD6.js";
 import {
   Agent,
   AutoDebugger,
@@ -34,7 +34,7 @@ import {
   setLogLevel,
   startPipeline,
   startWorker
-} from "./chunk-M3A2WRXM.js";
+} from "./chunk-OB6OXLPC.js";
 import "./chunk-DGUM43GV.js";
 export {
   Agent,

package/dist/main.js

@@ -1,24 +1,24 @@
 #!/usr/bin/env node
 import {
   runInitCommand
-} from "./chunk-FK6WYXRM.js";
+} from "./chunk-4YXOQGQC.js";
 import {
   runStartCommand
-} from "./chunk-DPLCEMEC.js";
+} from "./chunk-ZA4NWNS6.js";
 import {
   runFleetCommand
-} from "./chunk-FBQBBAPZ.js";
+} from "./chunk-4C6B2AMB.js";
 import {
   runServiceCommand
-} from "./chunk-IJRAVHQC.js";
+} from "./chunk-LWJCKTQP.js";
 import {
   runUpgradeCommand
 } from "./chunk-ICSJNKI6.js";
 import {
   runWatchdogCommand
-} from "./chunk-BHCDOHSK.js";
-import "./chunk-IXBIAX76.js";
-import "./chunk-M3A2WRXM.js";
+} from "./chunk-LYL5GG2F.js";
+import "./chunk-K6KL2VD6.js";
+import "./chunk-OB6OXLPC.js";
 import "./chunk-DGUM43GV.js";
 
 // packages/cli/src/commands/session.ts

package/dist/start.js

@@ -3,7 +3,7 @@ import {
   loadConfig,
   startPipeline,
   startWorker
-} from "./chunk-M3A2WRXM.js";
+} from "./chunk-OB6OXLPC.js";
 import "./chunk-DGUM43GV.js";
 
 // packages/runtime/src/start.ts

package/docs/TOOL-PARITY-PLAN.md

@@ -0,0 +1,191 @@
+# Hivemind Tool Parity Plan
+
+*Goal: Bring Hivemind tool capabilities to parity with OpenClaw/Pi, then beyond.*
+
+*Created: 2026-03-01 | Last updated: 2026-03-01*
+
+---
+
+## Context
+
+OpenClaw uses [Pi](https://github.com/badlogic/pi-mono/) as its underlying coding agent (see [Armin's article](https://lucumr.pocoo.org/2026/1/31/pi/)). Pi provides 4 core tools: `read`, `write`, `edit`, `bash`. OpenClaw layers orchestration on top: messaging, scheduling, sub-agents, browser control, vision, TTS, device control, and more.
+
+Hivemind is a **headless messaging agent** (not a TUI coding agent like Pi), but it needs equivalent capabilities. Hivemind's competitive edge is its **3-layer semantic memory** (L2 episodic + L3 semantic), which neither Pi nor OpenClaw have.
+
+**Principle: Build, don't integrate.** Study Pi's source for inspiration, write our own implementations. No external dependency risk, tailored to our headless/messaging paradigm.
+
+---
+
+## What's Already Implemented ✅
+
+### Core Tools (shipped in v0.6.0-v0.7.2)
+| Tool | Status | Notes |
+|------|--------|-------|
+| `shell` | ✅ Shipped | Workspace-scoped, configurable timeout |
+| `read_file` | ✅ Shipped | With offset/limit for large files |
+| `write_file` | ✅ Shipped | Auto-creates directories |
+| `edit_file` | ✅ Shipped | Exact-match find-and-replace |
+| `list_files` | ✅ Shipped | Directory listing |
+| `web_search` | ✅ Shipped | Brave Search API |
+| `web_fetch` | ✅ Shipped | URL → readable text |
+
+### Memory Tools (shipped in v0.7.0)
+| Tool | Status | Notes |
+|------|--------|-------|
+| `memory_search` | ✅ Shipped | L2 semantic search per context |
+| `memory_contexts` | ✅ Shipped | List all contexts |
+| `memory_l3` | ✅ Shipped | View promoted knowledge |
+| `memory_cross_search` | ✅ Shipped | Search across all contexts |
+
+### Infrastructure (shipped in v0.7.0)
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Agentic tool-use loop | ✅ Shipped | OpenAI-compatible function calling via OpenRouter, max 25 iterations |
+| Tool registry | ✅ Shipped | Pluggable registration system |
+| Session persistence | ✅ Shipped | JSONL per context, survives restarts |
+| Lossless compaction | ✅ Shipped | Saves episodes to L2 before summarizing |
+| MEMORY.md | ✅ Shipped | Global + per-context agent-managed memory files |
+| Skills discovery | ✅ Shipped | Auto-scan workspace/skills/*/SKILL.md |
+| Events system | ✅ Shipped | File-based immediate/one-shot/periodic scheduling |
+| Token budget management | ✅ Shipped | Context limit + response reserve |
+| Dashboard | ✅ Shipped | Request inspector, memory browser, context overview |
+| Service install | ✅ Shipped | launchd services (agent + memory daemon + watchdog) |
+| One-line installer | ✅ Shipped | `curl -sL api.sesame.space/api/v1/hivemind/install | bash -s -- <key>` |
+
+---
+
+## What's Not Implemented Yet
+
+### Tier 1 — Essential (Phase 1-2) ✅ COMPLETE
+
+| # | Tool/Feature | Status | Tools Added |
+|---|-------------|--------|------------|
+| 1 | **Event/scheduling tools** | ✅ Shipped | `create_event`, `list_events`, `delete_event` |
+| 2 | **Enhanced Sesame messaging** | ✅ Shipped | `send_message` |
+| 3 | **Sub-agent spawning** | ✅ Shipped | `spawn_agent`, `list_agents`, `kill_agent` |
+| 4 | **Web browsing** | ✅ Shipped | `browse` (extract/screenshot/click/type/evaluate) |
+
+### Tier 2 — Important (Phase 3) ✅ COMPLETE
+
+| # | Tool/Feature | Status | Tools Added |
+|---|-------------|--------|------------|
+| 5 | **Image/vision analysis** | ✅ Shipped | `analyze_image` |
+| 6 | **Git operations** | ✅ Shipped | `git_status`, `git_diff`, `git_commit`, `git_log`, `git_push` |
+| 7 | **Cross-context messaging** | ⬚ Deferred | (existing cross-context search covers most cases) |
+
+### Tier 3 — System & Mac Capabilities ✅ COMPLETE
+
+| # | Tool/Feature | Status | Tools Added |
+|---|-------------|--------|------------|
+| 8 | **System management** | ✅ Shipped | `system_info`, `process_list`, `process_kill`, `service_control`, `disk_usage`, `network_info` |
+| 9 | **macOS automation** | ✅ Shipped | `run_applescript`, `notify`, `clipboard_read`, `clipboard_write`, `open_url`, `screenshot` |
+| 10 | **Data handling** | ✅ Shipped | `sqlite_query`, `archive_create`, `archive_extract`, `pdf_extract` |
+| 11 | **HTTP server/client** | ✅ Shipped | `http_serve`, `http_stop`, `http_request` |
+| 12 | **File watching** | ✅ Shipped | `watch_start`, `watch_stop`, `watch_list` |
+
+### Tier 4 — Future (not yet implemented)
+
+| # | Tool/Feature | What It Does | Notes |
+|---|-------------|-------------|-------|
+| 13 | **Skills/extensions system** | Formalized hot-reloadable skills with tool registration | Inspired by Pi's extension system |
+| 14 | **TTS** | Text-to-speech output via API | ElevenLabs API |
+| 15 | **SSH** | Remote machine access | Could use shell + ssh CLI |
+
+---
+
+## Implementation Plan
+
+### Phase 1: Event Tools + Enhanced Messaging
+**Estimate: 1-2 coding sessions**
+
+```
+packages/runtime/src/tools/
+  events.ts     — NEW: create_event, list_events, delete_event
+  messaging.ts  — NEW: send_message (to any Sesame channel/user)
+```
+
+**Event tools:** Wrap the existing `EventsWatcher` infrastructure. Agent can create one-shot (reminders) and periodic (cron-like) events. Events fire as messages processed by the agent.
+
+**Messaging tools:** Use existing Sesame SDK to send messages to arbitrary channels. Agent can proactively reach out, not just reply to incoming messages.
+
+**Dependencies:** None new. Uses existing EventsWatcher + Sesame SDK.
+
+### Phase 2: Sub-agents + Web Browsing
+**Estimate: 3-4 coding sessions**
+
+```
+packages/runtime/src/tools/
+  spawn.ts      — NEW: spawn_agent, list_agents, kill_agent
+  browser.ts    — NEW: browse_url, browser_action
+```
+
+**Sub-agents:** Fork a new agent process with `hivemind start --context <name> --task "<prompt>"`. Parent tracks child PIDs. Results reported back via Sesame message or shared file. Timeout and cleanup built in.
+
+**Web browsing:** Headless Playwright for full web interaction. Agent can navigate, click, fill forms, extract content from JS-rendered pages. Single dependency (`playwright`), but it's the right tool for this — curl/fetch can't handle SPAs, authentication flows, or dynamic content.
+
+**Why Playwright:** We considered avoiding it (heavy dep), but web browsing is a core capability for agents that need to "do anything a human can do on a computer." Pi/OpenClaw use it. The alternative (shell + curl) only handles static pages.
+
+### Phase 3: Vision + Git
+**Estimate: 1-2 coding sessions**
+
+```
+packages/runtime/src/tools/
+  vision.ts     — NEW: analyze_image
+  git.ts        — NEW: git_status, git_diff, git_commit, git_push
+```
+
+**Vision:** Single HTTP call to OpenRouter with vision-capable model. Accept image URL or base64.
+
+**Git:** Thin wrappers around git CLI with structured output. Reduces token usage vs raw `shell` git output. Safety: confirmation before push.
+
+### Phase 4: Skills/Extensions System
+**Estimate: 2-3 coding sessions**
+
+Formalize the existing skills discovery into a proper extension system:
+- Skills can register new tools dynamically
+- Hot-reload on file change (inspired by Pi's extension system)
+- Agent can write and install its own skills
+- Skills persist across restarts
+
+---
+
+## Architecture Notes
+
+### Tool Registration Pattern
+All tools follow the existing registry pattern:
+```typescript
+// Each tool file exports a register function
+export function registerEventTools(registry: ToolRegistry, dataDir: string): void {
+  registry.register("create_event", description, schema, executor);
+  // ...
+}
+```
+
+### Security Model
+- **Shell:** Workspace-scoped, configurable timeout (existing)
+- **Files:** Scoped to workspace (existing)
+- **Messaging:** Authenticated via existing Sesame connection
+- **Sub-agents:** Inherit parent permissions, isolated context
+- **Events:** File-based, local only
+- **Browser:** Sandboxed Playwright instance, no persistent state
+- **Git:** Confirmation before push
+
+### What Hivemind Has That OpenClaw/Pi Don't
+- **3-layer semantic memory** (L2 episodic + L3 semantic with automatic promotion)
+- **Cross-context knowledge sharing** with isolation by default
+- **Memory-augmented responses** (every LLM call enriched with relevant history)
+- **Dashboard** for debugging LLM calls + memory state
+- **Token budget management** with configurable limits
+
+This isn't just parity — it's parity + memory, which is the competitive edge.
+
+---
+
+## Superseded Documents
+
+- `TOOL-USE-DESIGN.md` (root) — Original tool architecture design. **Fully implemented** in v0.6.0-v0.7.2. Kept for historical reference.
+- `DASHBOARD-PLAN.md` (root) — Dashboard design. **Fully implemented**. Kept for reference.
+
+---
+
+*This is the authoritative plan for Hivemind tool development. Update this document as phases complete.*

package/package.json

@@ -1,34 +1,33 @@
 {
   "name": "@sesamespace/hivemind",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Cognitive architecture for AI agents with multi-layered memory",
-  "type": "module",
-  "bin": {
-    "hivemind": "dist/main.js"
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "pnpm -r typecheck",
+    "lint": "pnpm -r lint",
+    "test": "pnpm -r test",
+    "prepublishOnly": "pnpm install --frozen-lockfile && tsup"
   },
-  "files": [
-    "dist/",
-    "config/",
-    "packages/memory/",
-    "install.sh",
-    "README.md"
-  ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
   },
   "dependencies": {
-    "ws": "^8.18.0"
+    "@sesamespace/sdk": "^0.1.6",
+    "smol-toml": "^1.6.0",
+    "axios": "^1.7.9",
+    "express": "^4.21.2"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1"
+  },
+  "bin": {
+    "hivemind": "dist/main.js"
   },
-  "keywords": [
-    "hivemind",
-    "ai-agent",
-    "memory",
-    "sesame",
-    "cognitive-architecture"
-  ],
-  "license": "UNLICENSED",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/baileydavis2026/hivemind"
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3"
+    ]
   }
 }