larkin 0.4.7 → 0.4.8

package/dist/feishu/host-shell.cjs

@@ -1165,6 +1165,9 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                     }, 80);
                     hostState.updateStatus(agent, { droughtReconnectAt, droughtReconnectAbandonedAt: null });
                     reconnectFns.get(agent.agentId)?.();
+                    void runtimeHost.scanPendingInboxUpdates?.(agent.agentId)?.catch((error) => {
+                        log(`drought reconnect inbox scan failed agent=${agent.name}: ${errorMessage(error)}`);
+                    });
                 }).catch((error) => {
                     maintenance.inFlight = false;
                     if (shuttingDown || fataling)

package/dist/feishu/host-shell.mjs

@@ -1125,6 +1125,9 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                     }, 80);
                     hostState.updateStatus(agent, { droughtReconnectAt, droughtReconnectAbandonedAt: null });
                     reconnectFns.get(agent.agentId)?.();
+                    void runtimeHost.scanPendingInboxUpdates?.(agent.agentId)?.catch((error) => {
+                        log(`drought reconnect inbox scan failed agent=${agent.name}: ${errorMessage(error)}`);
+                    });
                 }).catch((error) => {
                     maintenance.inFlight = false;
                     if (shuttingDown || fataling)

package/dist/runtime/runtime-host.cjs

@@ -120,8 +120,20 @@ function boundedRecords(agent) {
     const bounded = [...active, ...terminal].slice(-MAX_DELIVERIES);
     agent.records = new Map(bounded.map((record) => [record.deliveryId, record]));
     agent.byMessage = new Map(bounded.map((record) => [record.messageId, record.deliveryId]));
+    prunePromotedInboxUpdateIds(agent);
     return bounded;
 }
+function prunePromotedInboxUpdateIds(agent) {
+    if (!agent.promotedInboxUpdateIds?.size)
+        return;
+    for (const id of agent.promotedInboxUpdateIds) {
+        if (!agent.records.has(id))
+            agent.promotedInboxUpdateIds.delete(id);
+    }
+    if (agent.promotedInboxUpdateIds.size <= MAX_DELIVERIES)
+        return;
+    agent.promotedInboxUpdateIds = new Set([...agent.promotedInboxUpdateIds].slice(-MAX_DELIVERIES));
+}
 function createRuntimeHost(options) {
     const managed = new Map();
     const listeners = new Set();
@@ -294,6 +306,20 @@ function createRuntimeHost(options) {
         }
     };
     const TURN_END_RETRY_REASON = "runtime turn ended before Inbox consumption was observed";
+    const INBOX_UPDATE_PROMOTE_REASON = "accepted inbox_update promoted after Agent became idle";
+    const isInboxUpdateKind = (kind) => kind === "inbox_update" || kind === "inbox-update";
+    const agentIsIdleForInboxScan = (agent) => !agent.stopped && !agent.busy && !agent.submitting && !agent.turnInProgress && !agent.starting && Boolean(agent.session);
+    const acceptedInboxStillPending = (agent, record) => {
+        if (!agent.stateStore?.readNdjson)
+            return true;
+        try {
+            return agent.stateStore.readNdjson("inbox")
+                .some((row) => row?.message_id === record.messageId);
+        }
+        catch {
+            return false;
+        }
+    };
     /**
      * Runtime acceptance acknowledges only the notification. At the safe turn
      * boundary, canonical Inbox presence decides whether that same delivery
@@ -494,6 +520,7 @@ function createRuntimeHost(options) {
                 agent.retryAfterSubmit = false;
                 queueMicrotask(() => { void retryPending(agent); });
             }
+            queueMicrotask(() => { void scanAndPromoteAcceptedInboxUpdates(agent); });
         }
     };
     const retryPending = async (agent) => {
@@ -533,6 +560,45 @@ function createRuntimeHost(options) {
                 agent.retryPendingInFlight = null;
         }
     };
+    /**
+     * After busy/submitting clears, accepted inbox_update notices have no later
+     * turn boundary. Promote each delivery id at most once to a wake.
+     */
+    const scanAndPromoteAcceptedInboxUpdates = async (agent) => {
+        if (!agentIsIdleForInboxScan(agent))
+            return;
+        if (agent.compactionMachines.size > 0 || agent.compactionRecoveryInFlight.size > 0)
+            return;
+        const candidates = [...agent.records.values()].filter((record) => record.status === "accepted"
+            && isInboxUpdateKind(record.input?.kind) && !agent.promotedInboxUpdateIds.has(record.deliveryId));
+        if (!candidates.length)
+            return;
+        reconcileExternalConsumption(agent);
+        let promoted = 0;
+        for (const record of candidates) {
+            const current = agent.records.get(record.deliveryId);
+            if (current?.status !== "accepted")
+                continue;
+            if (!acceptedInboxStillPending(agent, current)) {
+                reconcileAbsentCanonical(agent, current);
+                continue;
+            }
+            agent.promotedInboxUpdateIds.add(current.deliveryId);
+            current.reason = INBOX_UPDATE_PROMOTE_REASON;
+            current.retryable = true;
+            const finalRecord = setRecord(agent, current, "pending");
+            if (finalRecord.status === "consumed")
+                continue;
+            emit({ type: "delivery", agentId: agent.config.agentId, deliveryId: finalRecord.deliveryId,
+                messageId: finalRecord.messageId, status: "deferred", reason: INBOX_UPDATE_PROMOTE_REASON });
+            promoted += 1;
+        }
+        if (!promoted)
+            return;
+        if (agent.retryPendingInFlight)
+            agent.retryAfterSubmit = true;
+        await retryPending(agent);
+    };
     const scheduleRecreate = (agent, reason) => {
         if (agent.stopped || agent.retryTimer || agent.starting || agent.session)
             return;
@@ -870,6 +936,7 @@ function createRuntimeHost(options) {
                 if (outcome !== "failed")
                     return retryPending(agent);
             });
+            queueMicrotask(() => { void scanAndPromoteAcceptedInboxUpdates(agent); });
         }
         else if (event.type === "activity") {
             if (agent.turnInProgress && event.activity !== "internal")
@@ -1230,6 +1297,14 @@ function createRuntimeHost(options) {
             };
         },
         isBusy(agentId) { const agent = managed.get(agentId); return Boolean(agent?.busy || agent?.submitting || agent?.starting); },
+        async scanPendingInboxUpdates(agentId) {
+            const agents = agentId ? [managed.get(agentId)] : [...managed.values()];
+            for (const agent of agents) {
+                if (!agent || agent.stopped)
+                    continue;
+                await scanAndPromoteAcceptedInboxUpdates(agent);
+            }
+        },
         async resetSession(agentId) {
             const agent = managed.get(agentId);
             if (!agent || agent.stopped)
@@ -1546,7 +1621,8 @@ function createRuntimeHost(options) {
                     compactionMachines: new Map(), compactionRecoveryInFlight: new Set(), piOverflowCompactionFailed: new Set(),
                     piProactiveCompaction: null, piProactiveCompactionGeneration: null, piProactiveCompactionSession: null,
                     piProactiveCompactionFailedGeneration: null, readiness: null,
-                    turnInProgress: false, turnHadFailure: false, turnHadAuthenticatedOutput: false, authFailureActive: false };
+                    turnInProgress: false, turnHadFailure: false, turnHadAuthenticatedOutput: false, authFailureActive: false,
+                    promotedInboxUpdateIds: new Set() };
                 const startupConsumed = [];
                 const startupQuarantined = [];
                 for (const record of agent.records.values()) {
@@ -1648,6 +1724,7 @@ function createRuntimeHost(options) {
                         : { inputId: existing.deliveryId, deliveryId: existing.deliveryId, kind: "wake", text: "", attempt: priorAttempt + 1 };
                     delete existing.reason;
                     delete existing.retryable;
+                    agent.promotedInboxUpdateIds.delete(existing.deliveryId);
                     setRecord(agent, existing, "pending");
                     const receipt = await (telemetry?.phase(messageId, "runtime.deliver", api_1.SpanKind.PRODUCER, () => submit(agent, existing, agent.busy || agent.submitting)) ?? submit(agent, existing, agent.busy || agent.submitting));
                     telemetry?.delivery(agentId, messageId, receipt.status);

package/dist/runtime/runtime-host.mjs

@@ -111,8 +111,20 @@ function boundedRecords(agent) {
     const bounded = [...active, ...terminal].slice(-MAX_DELIVERIES);
     agent.records = new Map(bounded.map((record) => [record.deliveryId, record]));
     agent.byMessage = new Map(bounded.map((record) => [record.messageId, record.deliveryId]));
+    prunePromotedInboxUpdateIds(agent);
     return bounded;
 }
+function prunePromotedInboxUpdateIds(agent) {
+    if (!agent.promotedInboxUpdateIds?.size)
+        return;
+    for (const id of agent.promotedInboxUpdateIds) {
+        if (!agent.records.has(id))
+            agent.promotedInboxUpdateIds.delete(id);
+    }
+    if (agent.promotedInboxUpdateIds.size <= MAX_DELIVERIES)
+        return;
+    agent.promotedInboxUpdateIds = new Set([...agent.promotedInboxUpdateIds].slice(-MAX_DELIVERIES));
+}
 export function createRuntimeHost(options) {
     const managed = new Map();
     const listeners = new Set();
@@ -285,6 +297,20 @@ export function createRuntimeHost(options) {
         }
     };
     const TURN_END_RETRY_REASON = "runtime turn ended before Inbox consumption was observed";
+    const INBOX_UPDATE_PROMOTE_REASON = "accepted inbox_update promoted after Agent became idle";
+    const isInboxUpdateKind = (kind) => kind === "inbox_update" || kind === "inbox-update";
+    const agentIsIdleForInboxScan = (agent) => !agent.stopped && !agent.busy && !agent.submitting && !agent.turnInProgress && !agent.starting && Boolean(agent.session);
+    const acceptedInboxStillPending = (agent, record) => {
+        if (!agent.stateStore?.readNdjson)
+            return true;
+        try {
+            return agent.stateStore.readNdjson("inbox")
+                .some((row) => row?.message_id === record.messageId);
+        }
+        catch {
+            return false;
+        }
+    };
     /**
      * Runtime acceptance acknowledges only the notification. At the safe turn
      * boundary, canonical Inbox presence decides whether that same delivery
@@ -485,6 +511,7 @@ export function createRuntimeHost(options) {
                 agent.retryAfterSubmit = false;
                 queueMicrotask(() => { void retryPending(agent); });
             }
+            queueMicrotask(() => { void scanAndPromoteAcceptedInboxUpdates(agent); });
         }
     };
     const retryPending = async (agent) => {
@@ -524,6 +551,45 @@ export function createRuntimeHost(options) {
                 agent.retryPendingInFlight = null;
         }
     };
+    /**
+     * After busy/submitting clears, accepted inbox_update notices have no later
+     * turn boundary. Promote each delivery id at most once to a wake.
+     */
+    const scanAndPromoteAcceptedInboxUpdates = async (agent) => {
+        if (!agentIsIdleForInboxScan(agent))
+            return;
+        if (agent.compactionMachines.size > 0 || agent.compactionRecoveryInFlight.size > 0)
+            return;
+        const candidates = [...agent.records.values()].filter((record) => record.status === "accepted"
+            && isInboxUpdateKind(record.input?.kind) && !agent.promotedInboxUpdateIds.has(record.deliveryId));
+        if (!candidates.length)
+            return;
+        reconcileExternalConsumption(agent);
+        let promoted = 0;
+        for (const record of candidates) {
+            const current = agent.records.get(record.deliveryId);
+            if (current?.status !== "accepted")
+                continue;
+            if (!acceptedInboxStillPending(agent, current)) {
+                reconcileAbsentCanonical(agent, current);
+                continue;
+            }
+            agent.promotedInboxUpdateIds.add(current.deliveryId);
+            current.reason = INBOX_UPDATE_PROMOTE_REASON;
+            current.retryable = true;
+            const finalRecord = setRecord(agent, current, "pending");
+            if (finalRecord.status === "consumed")
+                continue;
+            emit({ type: "delivery", agentId: agent.config.agentId, deliveryId: finalRecord.deliveryId,
+                messageId: finalRecord.messageId, status: "deferred", reason: INBOX_UPDATE_PROMOTE_REASON });
+            promoted += 1;
+        }
+        if (!promoted)
+            return;
+        if (agent.retryPendingInFlight)
+            agent.retryAfterSubmit = true;
+        await retryPending(agent);
+    };
     const scheduleRecreate = (agent, reason) => {
         if (agent.stopped || agent.retryTimer || agent.starting || agent.session)
             return;
@@ -861,6 +927,7 @@ export function createRuntimeHost(options) {
                 if (outcome !== "failed")
                     return retryPending(agent);
             });
+            queueMicrotask(() => { void scanAndPromoteAcceptedInboxUpdates(agent); });
         }
         else if (event.type === "activity") {
             if (agent.turnInProgress && event.activity !== "internal")
@@ -1221,6 +1288,14 @@ export function createRuntimeHost(options) {
             };
         },
         isBusy(agentId) { const agent = managed.get(agentId); return Boolean(agent?.busy || agent?.submitting || agent?.starting); },
+        async scanPendingInboxUpdates(agentId) {
+            const agents = agentId ? [managed.get(agentId)] : [...managed.values()];
+            for (const agent of agents) {
+                if (!agent || agent.stopped)
+                    continue;
+                await scanAndPromoteAcceptedInboxUpdates(agent);
+            }
+        },
         async resetSession(agentId) {
             const agent = managed.get(agentId);
             if (!agent || agent.stopped)
@@ -1537,7 +1612,8 @@ export function createRuntimeHost(options) {
                     compactionMachines: new Map(), compactionRecoveryInFlight: new Set(), piOverflowCompactionFailed: new Set(),
                     piProactiveCompaction: null, piProactiveCompactionGeneration: null, piProactiveCompactionSession: null,
                     piProactiveCompactionFailedGeneration: null, readiness: null,
-                    turnInProgress: false, turnHadFailure: false, turnHadAuthenticatedOutput: false, authFailureActive: false };
+                    turnInProgress: false, turnHadFailure: false, turnHadAuthenticatedOutput: false, authFailureActive: false,
+                    promotedInboxUpdateIds: new Set() };
                 const startupConsumed = [];
                 const startupQuarantined = [];
                 for (const record of agent.records.values()) {
@@ -1639,6 +1715,7 @@ export function createRuntimeHost(options) {
                         : { inputId: existing.deliveryId, deliveryId: existing.deliveryId, kind: "wake", text: "", attempt: priorAttempt + 1 };
                     delete existing.reason;
                     delete existing.retryable;
+                    agent.promotedInboxUpdateIds.delete(existing.deliveryId);
                     setRecord(agent, existing, "pending");
                     const receipt = await (telemetry?.phase(messageId, "runtime.deliver", SpanKind.PRODUCER, () => submit(agent, existing, agent.busy || agent.submitting)) ?? submit(agent, existing, agent.busy || agent.submitting));
                     telemetry?.delivery(agentId, messageId, receipt.status);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkin",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "private": false,
   "larkinPackageRole": "npm-published",
   "files": [