@holon-run/agentinbox 0.4.0 → 0.5.0

package/dist/src/service.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActivationDispatcher = exports.AgentInboxService = void 0;
+const node_crypto_1 = require("node:crypto");
 const backend_1 = require("./backend");
 const util_1 = require("./util");
 const source_schema_1 = require("./source_schema");
@@ -1407,15 +1408,26 @@ class AgentInboxService {
             const state = this.store.getActivationDispatchState(buffer.agentId, buffer.targetId);
             if (!state) {
                 const inbox = this.ensureInboxForAgent(buffer.agentId);
+                const unackedItems = this.store.listInboxItems(inbox.inboxId, { includeAcked: false }).map((item) => ({
+                    itemId: item.itemId,
+                    sourceId: item.sourceId,
+                    sourceNativeId: item.sourceNativeId,
+                    eventVariant: item.eventVariant,
+                    inboxId: item.inboxId,
+                    occurredAt: item.occurredAt,
+                    metadata: item.metadata,
+                    rawPayload: item.rawPayload,
+                    deliveryHandle: item.deliveryHandle,
+                }));
                 const dispatched = await this.dispatchActivationTarget({
                     agentId: buffer.agentId,
                     targetId: buffer.targetId,
                     newItemCount: entries.length,
-                    totalUnackedCount: this.store.countInboxItems(inbox.inboxId, false),
-                    summary: entries[0]?.summary ?? null,
+                    totalUnackedCount: unackedItems.length,
+                    summary: latestSummary(entries),
                     subscriptionIds: uniqueSortedNullable(entries.map((entry) => entry.subscriptionId)),
                     sourceIds: uniqueSorted(entries.map((entry) => entry.sourceId)),
-                    items: entries.map((entry) => entry.item),
+                    items: unackedItems,
                 });
                 if (dispatched === "retryable_failure") {
                     this.upsertDirtyDispatchState(buffer.agentId, buffer.targetId, entries);
@@ -1427,8 +1439,9 @@ class AgentInboxService {
                     targetId: buffer.targetId,
                     status: "dirty",
                     leaseExpiresAt: state.leaseExpiresAt,
+                    lastNotifiedFingerprint: state.lastNotifiedFingerprint,
                     pendingNewItemCount: state.pendingNewItemCount + entries.length,
-                    pendingSummary: state.pendingSummary ?? entries[0]?.summary ?? null,
+                    pendingSummary: latestSummary(entries) ?? state.pendingSummary,
                     pendingSubscriptionIds: uniqueSortedNullable([...state.pendingSubscriptionIds, ...entries.map((entry) => entry.subscriptionId)]),
                     pendingSourceIds: uniqueSorted([...state.pendingSourceIds, ...entries.map((entry) => entry.sourceId)]),
                     updatedAt: (0, util_1.nowIso)(),
@@ -1477,6 +1490,20 @@ class AgentInboxService {
         if (reason === "ack" && state.status !== "dirty") {
             return;
         }
+        if (reason === "lease" && state.status === "notified") {
+            const target = this.getActivationTarget(targetId);
+            if (target.kind !== "terminal") {
+                // Webhook targets keep the existing lease-based behavior.
+            }
+            else {
+                this.store.upsertActivationDispatchState({
+                    ...state,
+                    leaseExpiresAt: new Date(Date.now() + target.notifyLeaseMs).toISOString(),
+                    updatedAt: (0, util_1.nowIso)(),
+                });
+                return;
+            }
+        }
         const dispatched = await this.dispatchActivationTarget({
             agentId,
             targetId,
@@ -1515,9 +1542,11 @@ class AgentInboxService {
         if (target.status === "offline") {
             return "offline";
         }
+        const state = this.store.getActivationDispatchState(input.agentId, input.targetId);
         const inbox = this.ensureInboxForAgent(input.agentId);
         const summary = summarizeActivation(inbox.inboxId, input.newItemCount, input.summary);
         const totalUnackedCount = input.totalUnackedCount ?? this.store.countInboxItems(inbox.inboxId, false);
+        let terminalPrompt = null;
         try {
             if (target.kind === "terminal") {
                 const gate = await this.activationGate.evaluate(target);
@@ -1532,6 +1561,7 @@ class AgentInboxService {
                         targetId: input.targetId,
                         status: "dirty",
                         leaseExpiresAt: new Date(Date.now() + DEFAULT_NOTIFY_RETRY_MS).toISOString(),
+                        lastNotifiedFingerprint: state?.lastNotifiedFingerprint ?? null,
                         pendingNewItemCount: input.newItemCount,
                         pendingSummary: input.summary,
                         pendingSubscriptionIds: uniqueSortedNullable(input.subscriptionIds),
@@ -1540,11 +1570,32 @@ class AgentInboxService {
                     });
                     return "deferred";
                 }
+                const preview = totalUnackedCount === 1 && input.items.length === 1
+                    ? (0, terminal_1.deriveInlineItemPreview)(input.items[0], input.summary)
+                    : null;
                 const prompt = (0, terminal_1.renderAgentPrompt)({
                     inboxId: inbox.inboxId,
                     totalUnackedCount,
                     summary: input.summary,
+                    preview,
                 });
+                terminalPrompt = prompt;
+                const promptFingerprint = terminalReminderFingerprint(prompt, input.items);
+                if (state?.status === "dirty" && state.lastNotifiedFingerprint === promptFingerprint) {
+                    this.store.upsertActivationDispatchState({
+                        agentId: input.agentId,
+                        targetId: input.targetId,
+                        status: "notified",
+                        leaseExpiresAt: new Date(Date.now() + target.notifyLeaseMs).toISOString(),
+                        lastNotifiedFingerprint: promptFingerprint,
+                        pendingNewItemCount: 0,
+                        pendingSummary: null,
+                        pendingSubscriptionIds: [],
+                        pendingSourceIds: [],
+                        updatedAt: (0, util_1.nowIso)(),
+                    });
+                    return "suppressed";
+                }
                 await this.terminalDispatcher.dispatch(target, prompt);
             }
             else {
@@ -1573,6 +1624,9 @@ class AgentInboxService {
                 targetId: input.targetId,
                 status: "notified",
                 leaseExpiresAt: new Date(Date.now() + target.notifyLeaseMs).toISOString(),
+                lastNotifiedFingerprint: target.kind === "terminal"
+                    ? terminalReminderFingerprint(terminalPrompt ?? "", input.items)
+                    : state?.lastNotifiedFingerprint ?? null,
                 pendingNewItemCount: 0,
                 pendingSummary: null,
                 pendingSubscriptionIds: [],
@@ -1602,8 +1656,9 @@ class AgentInboxService {
             targetId,
             status: "dirty",
             leaseExpiresAt: new Date(Date.now() + DEFAULT_NOTIFY_RETRY_MS).toISOString(),
+            lastNotifiedFingerprint: this.store.getActivationDispatchState(agentId, targetId)?.lastNotifiedFingerprint ?? null,
             pendingNewItemCount: entries.length,
-            pendingSummary: entries[0]?.summary ?? null,
+            pendingSummary: latestSummary(entries),
             pendingSubscriptionIds: uniqueSortedNullable(entries.map((entry) => entry.subscriptionId)),
             pendingSourceIds: uniqueSorted(entries.map((entry) => entry.sourceId)),
             updatedAt: (0, util_1.nowIso)(),
@@ -2288,6 +2343,24 @@ function summarizeActivation(inboxId, newItemCount, firstSummary) {
     }
     return `${newItemCount} new ${itemWord} in ${inboxId}`;
 }
+function latestSummary(entries) {
+    for (let index = entries.length - 1; index >= 0; index -= 1) {
+        const summary = entries[index]?.summary;
+        if (summary) {
+            return summary;
+        }
+    }
+    return null;
+}
+function terminalReminderFingerprint(prompt, items) {
+    const payload = JSON.stringify({
+        prompt,
+        itemIds: items
+            .map((item) => item.itemId)
+            .sort((left, right) => left.localeCompare(right)),
+    });
+    return (0, node_crypto_1.createHash)("sha256").update(payload).digest("hex");
+}
 function summarizeSourceEvent(sourceType, sourceKey, eventVariant) {
     if (sourceType === "github_repo_ci") {
         const parts = eventVariant.split(".");

package/dist/src/store.js

@@ -729,12 +729,13 @@ class AgentInboxStore {
     upsertActivationDispatchState(state) {
         this.db.run(`
       insert into activation_dispatch_states (
-        agent_id, target_id, status, lease_expires_at, pending_new_item_count, pending_summary,
+        agent_id, target_id, status, lease_expires_at, last_notified_fingerprint, pending_new_item_count, pending_summary,
         pending_subscription_ids_json, pending_source_ids_json, updated_at
-      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       on conflict(agent_id, target_id) do update set
         status = excluded.status,
         lease_expires_at = excluded.lease_expires_at,
+        last_notified_fingerprint = excluded.last_notified_fingerprint,
         pending_new_item_count = excluded.pending_new_item_count,
         pending_summary = excluded.pending_summary,
         pending_subscription_ids_json = excluded.pending_subscription_ids_json,
@@ -745,6 +746,7 @@ class AgentInboxStore {
             state.targetId,
             state.status,
             state.leaseExpiresAt ?? null,
+            state.lastNotifiedFingerprint ?? null,
             state.pendingNewItemCount,
             state.pendingSummary ?? null,
             JSON.stringify(state.pendingSubscriptionIds),
@@ -1251,6 +1253,7 @@ class AgentInboxStore {
             targetId: String(row.target_id),
             status: row.status,
             leaseExpiresAt: row.lease_expires_at ? String(row.lease_expires_at) : null,
+            lastNotifiedFingerprint: row.last_notified_fingerprint ? String(row.last_notified_fingerprint) : null,
             pendingNewItemCount: Number(row.pending_new_item_count),
             pendingSummary: row.pending_summary ? String(row.pending_summary) : null,
             pendingSubscriptionIds: parseJson(row.pending_subscription_ids_json),

package/dist/src/terminal.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TerminalDispatcher = void 0;
 exports.detectTerminalContext = detectTerminalContext;
 exports.renderAgentPrompt = renderAgentPrompt;
+exports.deriveInlineItemPreview = deriveInlineItemPreview;
 exports.assignedAgentIdFromContext = assignedAgentIdFromContext;
 const node_child_process_1 = require("node:child_process");
 const node_util_1 = require("node:util");
@@ -49,11 +50,41 @@ function renderAgentPrompt(input) {
     const totalUnackedCount = input.totalUnackedCount ?? input.newItemCount ?? 0;
     const itemWord = totalUnackedCount === 1 ? "item" : "items";
     const base = `AgentInbox: ${totalUnackedCount} unacked ${itemWord} in inbox ${input.inboxId}.`;
+    if (totalUnackedCount === 1 && input.preview) {
+        const suffix = /(?:[.!?…]|\.{3})$/.test(input.preview) ? "" : ".";
+        return `${base} Preview: ${input.preview}${suffix} Read the inbox for full details if needed.`;
+    }
     if (input.summary) {
         return `${base} Summary: ${input.summary}. Please read the inbox, process them, and ack when finished.`;
     }
     return `${base} Please read the inbox, process them, and ack when finished.`;
 }
+const MAX_INLINE_PREVIEW_INPUT_CHARS = 240;
+const MAX_INLINE_PREVIEW_CHARS = 96;
+const INLINE_PREVIEW_KEYS = ["message", "text", "body", "title"];
+function deriveInlineItemPreview(item, summary) {
+    const candidates = [];
+    for (const key of INLINE_PREVIEW_KEYS) {
+        const rawPayloadValue = item.rawPayload[key];
+        if (typeof rawPayloadValue === "string") {
+            candidates.push(rawPayloadValue);
+        }
+        const metadataValue = item.metadata[key];
+        if (typeof metadataValue === "string") {
+            candidates.push(metadataValue);
+        }
+    }
+    if (isPreviewFriendlySummary(summary)) {
+        candidates.push(summary);
+    }
+    for (const candidate of candidates) {
+        const preview = normalizeInlinePreview(candidate);
+        if (preview) {
+            return preview;
+        }
+    }
+    return null;
+}
 function assignedAgentIdFromContext(input) {
     const primary = normalizeOptionalString(input.runtimeSessionId)
         ?? normalizeOptionalString(input.tmuxPaneId)
@@ -176,6 +207,44 @@ function normalizeItermSessionId(raw) {
     const parts = value.split(":");
     return parts[parts.length - 1] || null;
 }
+function normalizeInlinePreview(value) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    if (!normalized) {
+        return null;
+    }
+    if (normalized.length > MAX_INLINE_PREVIEW_INPUT_CHARS) {
+        return null;
+    }
+    if (looksStructured(normalized)) {
+        return null;
+    }
+    if (normalized.length <= MAX_INLINE_PREVIEW_CHARS) {
+        return normalized;
+    }
+    return `${normalized.slice(0, MAX_INLINE_PREVIEW_CHARS - 3).trimEnd()}...`;
+}
+function isPreviewFriendlySummary(summary) {
+    if (typeof summary !== "string") {
+        return false;
+    }
+    const normalized = summary.trim();
+    if (!normalized) {
+        return false;
+    }
+    if (!normalized.includes(" ")) {
+        return false;
+    }
+    if (/^[a-z0-9_.-]+:/i.test(normalized)) {
+        return false;
+    }
+    return true;
+}
+function looksStructured(value) {
+    if ((value.startsWith("{") && value.endsWith("}")) || (value.startsWith("[") && value.endsWith("]"))) {
+        return true;
+    }
+    return false;
+}
 function detectRuntimeContext(env) {
     const codexThreadId = normalizeOptionalString(env.CODEX_THREAD_ID);
     if (codexThreadId) {

package/drizzle/migrations/0007_activation_dispatch_last_notified_fingerprint.sql

@@ -0,0 +1,2 @@
+alter table activation_dispatch_states
+  add column last_notified_fingerprint text;

package/drizzle/schema.ts

@@ -122,6 +122,7 @@ export const activationDispatchStates = sqliteTable("activation_dispatch_states"
   targetId: text("target_id").notNull(),
   status: text("status").notNull(),
   leaseExpiresAt: text("lease_expires_at"),
+  lastNotifiedFingerprint: text("last_notified_fingerprint"),
   pendingNewItemCount: integer("pending_new_item_count").notNull(),
   pendingSummary: text("pending_summary"),
   pendingSubscriptionIdsJson: text("pending_subscription_ids_json").notNull(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/agentinbox",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {
@@ -49,8 +49,8 @@
   "devDependencies": {
     "@types/node": "^24.5.2",
     "@types/sql.js": "^1.4.9",
-    "drizzle-kit": "^0.31.6",
-    "drizzle-orm": "^0.44.2",
+    "drizzle-kit": "1.0.0-beta.21",
+    "drizzle-orm": "^0.45.2",
     "mdorigin": "^0.5.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.2"