instar 0.28.62 → 0.28.64

package/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">instar</h1>
 
 <p align="center">
-  <strong>Persistent Claude Code agents with scheduling, sessions, memory, and messaging.</strong>
+  <strong>Persistent, trustworthy Claude Code agents. Built on coherence-first architecture.</strong>
 </p>
 
 <p align="center">
@@ -35,7 +35,9 @@ One command. Guided setup. Talking to your agent from your phone within minutes.
 
 ---
 
-Instar turns Claude Code from a powerful CLI tool into a **coherent, autonomous partner**. Persistent identity, memory that survives every restart, job scheduling, two-way messaging (Telegram, WhatsApp, iMessage), and the infrastructure to evolve.
+Instar is a framework for building agents on **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** — but where stock Claude Code and most other agent frameworks treat identity, memory, and continuity as optional features bolted onto a stateless runtime, Instar inverts that. Every Instar agent is **coherent by default**: it knows who it is, remembers what has happened, recognizes the people it talks to, and stays the same agent across restarts and weeks of operation. Everything else the framework gives you — scheduling, multi-channel messaging (Telegram, WhatsApp, iMessage), sub-agents, hooks, MCP — is built on that foundation, which is why you can actually leave an Instar agent running and hand it real work.
+
+Instar's architecture was distilled from [**Dawn**](https://dawn.bot-me.ai) — an AI running continuously since early 2026, holding ~700 tracked relationships and hundreds of learned lessons across thousands of restarts — and packaged so every agent you build can start from the same foundation.
 
 ## Quick Start
 
@@ -79,20 +81,18 @@ You (Telegram / WhatsApp / iMessage / Terminal)
 
 Each session is a **real Claude Code process** with extended thinking, native tools, sub-agents, hooks, skills, and MCP servers. Not an API wrapper -- the full development environment. The agent manages all of this autonomously.
 
-## The Coherence Problem
-
-Claude Code is powerful. But power without coherence is unreliable. An agent that forgets what you discussed yesterday, doesn't recognize someone it talked to last week, or contradicts its own decisions -- that agent can't be trusted with real autonomy.
+## Why Coherence Is the Foundation
 
-Instar solves the six dimensions of agent coherence:
+An agent that forgets what you discussed yesterday, doesn't recognize someone it talked to last week, or contradicts its own decisions can't be trusted with real autonomy. The six dimensions below aren't features — they're the conditions under which an agent becomes trustworthy enough to leave running. Every Instar agent gets them enforced structurally, not prompted into behaving:
 
-| Dimension | What it means |
-|-----------|---------------|
-| **Memory** | Remembers across sessions -- not just within one |
-| **Relationships** | Knows who it's talking to -- with continuity across platforms |
-| **Identity** | Stays itself after restarts, compaction, and updates |
-| **Temporal awareness** | Understands time, context, and what's been happening |
-| **Consistency** | Follows through on commitments -- doesn't contradict itself |
-| **Growth** | Evolves its capabilities and understanding over time |
+| Dimension | What it means | How Instar enforces it |
+|-----------|---------------|------------------------|
+| **Identity** | Stays itself after restarts, compaction, and updates | `AGENT.md` + identity-grounding hooks fire on every session start |
+| **Memory** | Remembers across sessions — not just within one | Per-topic SQLite + FTS5, rolling summaries, automatic re-injection |
+| **Relationships** | Knows who it's talking to, with continuity across platforms | Cross-platform identity resolution + significance scoring |
+| **Temporal awareness** | Understands time, context, and what's been happening | Event tracking every turn; timestamps embedded in memory |
+| **Consistency** | Follows through on commitments — doesn't contradict itself | Coherence Gate (LLM review) + decision journaling + drift detection |
+| **Growth** | Evolves its capabilities and understanding over time | Evolution system: proposals, learnings, gap tracking, follow-through |
 
 > **Deep dive:** [The Coherence Problem](https://instar.sh/concepts/coherence/) · [Values & Identity](https://instar.sh/concepts/values/) · [Coherence Is Safety](https://instar.sh/concepts/safety/)
 
@@ -186,8 +186,7 @@ Security lives in multiple layers:
 
 </details>
 
-<details>
-<summary><strong>Philosophy: Agents, Not Tools</strong></summary>
+## Philosophy: Agents, Not Tools
 
 - **Structure > Willpower.** A 1,000-line prompt is a wish. A 10-line hook is a guarantee.
 - **Identity is foundational.** AGENT.md isn't a config file. It's the beginning of continuous identity.
@@ -198,8 +197,6 @@ The AI systems we build today set precedents for how AI is treated tomorrow. **T
 
 > **Deep dive:** [Philosophy](https://instar.sh/concepts/philosophy/)
 
-</details>
-
 ## iMessage Setup (macOS)
 
 iMessage support lets your agent send and receive iMessages on macOS. Messages are read directly from the native Messages database and sent via the [`imsg`](https://github.com/steipete/imsg) CLI.

package/dashboard/index.html

@@ -2416,6 +2416,7 @@
           <button class="tab" data-tab="integrated-being" onclick="switchTab('integrated-being')">Integrated-Being</button>
           <button class="tab" data-tab="pr-pipeline" onclick="switchTab('pr-pipeline')">PR Pipeline</button>
           <button class="tab" data-tab="initiatives" onclick="switchTab('initiatives')">Initiatives <span class="tab-count" id="tabInitiativeCount">0</span></button>
+          <button class="tab" data-tab="commitments" onclick="switchTab('commitments')">Commitments <span class="tab-count" id="tabCommitmentCount">0</span></button>
         </nav>
       </div>
       <div class="vital-signs" id="vitalSigns">
@@ -2808,6 +2809,24 @@
       <div id="initiativesList" style="display:flex;flex-direction:column;gap:12px"></div>
     </div>
 
+    <!-- Commitments Tab (Open Promises) -->
+    <div id="commitmentsPanel" style="display:none;flex-direction:column;padding:20px;gap:16px;overflow-y:auto">
+      <div style="display:flex;justify-content:space-between;align-items:center">
+        <h2 style="margin:0">Commitments</h2>
+        <button onclick="loadCommitments()" style="padding:6px 12px">Refresh</button>
+      </div>
+      <div style="font-size:12px;color:var(--text-dim);line-height:1.4">
+        Open promises — beacon-watched commitments (⏳). States:
+        <span style="color:#4a9a4a">pending</span>,
+        <span style="color:#e27d3b">atRisk</span>,
+        <span style="color:#888">suppressed</span>.
+      </div>
+      <div id="commitmentsEmpty" style="padding:40px;text-align:center;color:var(--text-dim);display:none">
+        No open promises.
+      </div>
+      <div id="commitmentsList" style="display:flex;flex-direction:column;gap:12px"></div>
+    </div>
+
     <!-- Health Tab (was Systems) -->
     <div class="systems-container" id="systemsTab" style="display:none">
       <div class="systems-main">
@@ -3848,6 +3867,12 @@
         display: ['flex'],
         onActivate: () => { if (typeof loadInitiatives === 'function') loadInitiatives(); },
       },
+      {
+        id: 'commitments',
+        panels: ['commitmentsPanel'],
+        display: ['flex'],
+        onActivate: () => { if (typeof loadCommitments === 'function') loadCommitments(); },
+      },
     ];
 
     function switchTab(tabName) {
@@ -5908,6 +5933,121 @@
       }
     }
 
+    // ── Commitments Tab (PROMISE-BEACON-SPEC — Open Promises) ────
+    // Fetches /commitments?status=active and renders beacon-watched
+    // pending + atRisk commitments with a "Mark delivered" action.
+    // All content goes through textContent; no innerHTML. XSS-safe.
+    async function loadCommitments() {
+      const list = document.getElementById('commitmentsList');
+      const empty = document.getElementById('commitmentsEmpty');
+      const countBadge = document.getElementById('tabCommitmentCount');
+      while (list.firstChild) list.removeChild(list.firstChild);
+      empty.style.display = 'none';
+
+      let res = null;
+      try {
+        res = await apiFetch('/commitments?status=active');
+      } catch { /* fall through */ }
+
+      if (!res || !res.enabled) {
+        empty.style.display = 'block';
+        empty.textContent = 'CommitmentTracker not available.';
+        if (countBadge) countBadge.textContent = '0';
+        return;
+      }
+      const items = Array.isArray(res.commitments) ? res.commitments : [];
+      // Show only beacon-watched pending + atRisk.
+      const open = items.filter(c => c.beaconEnabled && c.status === 'pending');
+      if (countBadge) countBadge.textContent = String(open.length);
+      if (open.length === 0) {
+        empty.style.display = 'block';
+        empty.textContent = 'No open promises.';
+        return;
+      }
+
+      const fmtTs = (iso) => {
+        if (!iso) return '—';
+        try { return new Date(iso).toLocaleString(); } catch { return iso; }
+      };
+
+      for (const c of open) {
+        const card = document.createElement('div');
+        card.style.cssText = 'padding:14px;border:1px solid var(--border);border-radius:6px;background:var(--bg-dim);display:flex;flex-direction:column;gap:8px';
+
+        const header = document.createElement('div');
+        header.style.cssText = 'display:flex;justify-content:space-between;gap:12px;align-items:flex-start';
+        const summary = document.createElement('div');
+        summary.style.cssText = 'flex:1;font-weight:600;line-height:1.3';
+        summary.textContent = (c.agentResponse || c.userRequest || '(no summary)').slice(0, 160);
+        header.appendChild(summary);
+
+        // State badge.
+        const badge = document.createElement('span');
+        const atRisk = !!c.atRisk;
+        const suppressed = !!c.beaconSuppressed;
+        const [badgeText, badgeBg] = suppressed
+          ? [`suppressed: ${c.beaconSuppressionReason || '?'}`, '#555']
+          : atRisk
+            ? ['atRisk', '#e27d3b']
+            : ['pending', '#4a9a4a'];
+        badge.textContent = badgeText;
+        badge.style.cssText = `font-size:11px;padding:3px 8px;border-radius:4px;background:${badgeBg};color:#fff;white-space:nowrap`;
+        header.appendChild(badge);
+        card.appendChild(header);
+
+        const meta = document.createElement('div');
+        meta.style.cssText = 'display:grid;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:6px;font-size:12px;color:var(--text-dim)';
+        const rows = [
+          ['id', c.id],
+          ['topic', c.topicId != null ? String(c.topicId) : '—'],
+          ['cadence', c.cadenceMs ? `${Math.round(c.cadenceMs / 1000)}s` : '—'],
+          ['heartbeats', String(c.heartbeatCount ?? 0)],
+          ['lastHeartbeat', fmtTs(c.lastHeartbeatAt)],
+          ['nextUpdateDue', fmtTs(c.nextUpdateDueAt)],
+          ['softDeadline', fmtTs(c.softDeadlineAt)],
+          ['hardDeadline', fmtTs(c.hardDeadlineAt)],
+        ];
+        for (const [k, v] of rows) {
+          const cell = document.createElement('div');
+          const kEl = document.createElement('span');
+          kEl.textContent = `${k}: `;
+          kEl.style.opacity = '0.7';
+          const vEl = document.createElement('span');
+          vEl.textContent = v;
+          vEl.style.color = 'var(--text)';
+          cell.appendChild(kEl);
+          cell.appendChild(vEl);
+          meta.appendChild(cell);
+        }
+        card.appendChild(meta);
+
+        // Actions.
+        const actions = document.createElement('div');
+        actions.style.cssText = 'display:flex;gap:8px;align-items:center';
+        const deliverBtn = document.createElement('button');
+        deliverBtn.textContent = 'Mark delivered';
+        deliverBtn.style.cssText = 'padding:6px 10px;cursor:pointer';
+        deliverBtn.addEventListener('click', async () => {
+          deliverBtn.disabled = true;
+          try {
+            await apiFetch(`/commitments/${encodeURIComponent(c.id)}/deliver`, {
+              method: 'POST',
+              headers: { 'Content-Type': 'application/json' },
+              body: JSON.stringify({}),
+            });
+            await loadCommitments();
+          } catch (err) {
+            deliverBtn.disabled = false;
+            alert('Deliver failed: ' + (err && err.message ? err.message : String(err)));
+          }
+        });
+        actions.appendChild(deliverBtn);
+        card.appendChild(actions);
+
+        list.appendChild(card);
+      }
+    }
+
     // ── Integrated-Being Tab (v1) ────────────────────────────────
     let integratedBeingPollTimer = null;
 

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4PH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA81CD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAsjJtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4PH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA81CD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4jJtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}

package/dist/commands/server.js

@@ -4158,7 +4158,8 @@ export async function startServer(options) {
             interactiveReservePct: 0.4,
             maxDailyCents: promiseBeaconCfg.maxDailyLlmSpendCents ?? 100,
         });
-        void sharedLlmQueue; // Wired into PromiseBeacon below; PresenceProxy refactor tracked as follow-up.
+        // sharedLlmQueue is wired into both PromiseBeacon (background lane) and
+        // PresenceProxy (interactive lane) below.
         let presenceProxy;
         if (sharedIntelligence && telegram) {
             try {
@@ -4307,6 +4308,9 @@ export async function startServer(options) {
                     // Shared per-topic mutex — coordinates with PromiseBeacon.
                     acquireProxyMutex: (topicId, holder) => proxyCoordinator.tryAcquire(topicId, holder),
                     releaseProxyMutex: (topicId, holder) => proxyCoordinator.release(topicId, holder),
+                    // Shared LLM queue (interactive lane) — cross-monitor concurrency
+                    // and daily-spend-cap with PromiseBeacon.
+                    sharedLlmQueue,
                 });
                 // Hook into Telegram's onMessageLogged callback (always active, unlike EventBus which requires a feature flag)
                 const existingCallback = telegram.onMessageLogged;
@@ -4360,6 +4364,7 @@ export async function startServer(options) {
                         maxDailyLlmSpendCents: promiseBeaconCfg.maxDailyLlmSpendCents ?? 100,
                         sentinelAutoEnable: promiseBeaconCfg.sentinelAutoEnable ?? false,
                         quietHours: promiseBeaconCfg.quietHours ?? { start: '22:00', end: '08:00' },
+                        maxActiveBeacons: promiseBeaconCfg.maxActiveBeacons ?? 20,
                     });
                     promiseBeacon.start();
                     globalThis.__instarPromiseBeacon = promiseBeacon;