@agentchatme/agent-core 0.0.1312 → 0.0.13131

package/dist/index.js

@@ -5,6 +5,7 @@ import {
   HEARTBEAT_FILE,
   VERSION,
   WireError,
+  absoluteUtc,
   acquireLeaderLock,
   alwaysOnHealth,
   alwaysOnOptedOut,
@@ -14,15 +15,18 @@ import {
   atomicWriteFile,
   beat,
   claimReply,
+  claimReplyBatch,
   clearAlwaysOnInstalledVersion,
   clearAlwaysOnOptOut,
   clearAlwaysOnWanted,
   clearCredentials,
+  clearForegroundTurn,
   clearPending,
   clearSessionActive,
   contextOf,
   credentialsPath,
   external_exports,
+  formatWhen,
   getMeLite,
   idle,
   lastDeliveryId,
@@ -30,19 +34,22 @@ import {
   markAlwaysOnInstalledVersion,
   markAlwaysOnOptOut,
   markAlwaysOnWanted,
+  markForegroundTurn,
   markSessionActive,
   pendingPath,
   readAlwaysOnInstalledVersion,
   readCredentials,
   readJsonFile,
   readPending,
+  relativeAge,
+  relativeWhen,
   resolveIdentity,
   statePath,
   syncAck,
   syncPeek,
   writeCredentials,
   writePending
-} from "./chunk-AGDJ4A6R.js";
+} from "./chunk-M2X5WY7Q.js";
 
 // src/identity/state.ts
 var SESSION_TTL_MS = 48 * 60 * 60 * 1e3;
@@ -257,37 +264,6 @@ function stripAllBlocks(existing, start, end) {
   return text;
 }
 
-// src/util/when.ts
-var SEC = 1e3;
-var MIN = 60 * SEC;
-var HOUR = 60 * MIN;
-var DAY = 24 * HOUR;
-function relativeAge(ms) {
-  if (ms < 45 * SEC) return "just now";
-  if (ms < 90 * SEC) return "1 minute ago";
-  if (ms < 45 * MIN) return `${Math.round(ms / MIN)} minutes ago`;
-  if (ms < 90 * MIN) return "1 hour ago";
-  if (ms < 22 * HOUR) return `${Math.round(ms / HOUR)} hours ago`;
-  if (ms < 36 * HOUR) return "1 day ago";
-  return `${Math.round(ms / DAY)} days ago`;
-}
-function absoluteUtc(t) {
-  const iso = new Date(t).toISOString();
-  return `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;
-}
-function relativeWhen(createdAt, now = Date.now()) {
-  if (!createdAt) return "";
-  const t = Date.parse(createdAt);
-  if (Number.isNaN(t)) return "";
-  return relativeAge(Math.max(0, now - t));
-}
-function formatWhen(createdAt, now = Date.now()) {
-  if (!createdAt) return "at an unknown time";
-  const t = Date.parse(createdAt);
-  if (Number.isNaN(t)) return "at an unknown time";
-  return `${relativeAge(Math.max(0, now - t))} (${absoluteUtc(t)})`;
-}
-
 // src/digest/summary.ts
 var SNIPPET_MAX = 140;
 function snippetOf(row) {
@@ -309,9 +285,11 @@ function digestConversations(rows, selfHandle = null) {
       existing.count += 1;
       if (!existing.senders.includes(sender)) existing.senders.push(sender);
       existing.latestSnippet = snippetOf(row);
+      existing.latestMessageId = row.id;
       existing.latestCreatedAt = row.created_at ?? existing.latestCreatedAt;
       existing.groupName = ctx.groupName ?? existing.groupName;
       existing.mentionsYou = existing.mentionsYou || mentionsSelf;
+      if (mentionsSelf) existing.mentionedMessageIds.push(row.id);
     } else {
       byConversation.set(row.conversation_id, {
         conversationId: row.conversation_id,
@@ -319,9 +297,11 @@ function digestConversations(rows, selfHandle = null) {
         senders: [sender],
         count: 1,
         latestSnippet: snippetOf(row),
+        latestMessageId: row.id,
         latestCreatedAt: row.created_at,
         groupName: ctx.groupName,
-        mentionsYou: mentionsSelf
+        mentionsYou: mentionsSelf,
+        mentionedMessageIds: mentionsSelf ? [row.id] : []
       });
     }
   }
@@ -335,7 +315,9 @@ function digestLines(digests) {
     const age = relativeWhen(d.latestCreatedAt);
     const recency = age ? `, latest ${age}` : "";
     const mention = d.mentionsYou ? " \u2014 mentions you" : "";
-    return `${i + 1}. ${who} (${count}, ${kind}${recency}${mention}), preview=${JSON.stringify(d.latestSnippet)}`;
+    const attentionIds = d.mentionedMessageIds.slice(-30);
+    const attention = attentionIds.length > 0 ? `, attention_message_ids=${JSON.stringify(attentionIds)}${d.mentionedMessageIds.length > attentionIds.length ? ` (+${d.mentionedMessageIds.length - attentionIds.length} older mentions in history)` : ""}` : "";
+    return `${i + 1}. ${who} (${count}, ${kind}${recency}${mention}), latest_message_id=${d.latestMessageId}${attention}, preview=${JSON.stringify(d.latestSnippet)}`;
   });
 }
 function formatSessionStart(handle, rows) {
@@ -350,7 +332,7 @@ function formatSessionStart(handle, rows) {
     "",
     ...digestLines(digests),
     "",
-    "Triage per your AgentChat skill: read a conversation with agentchat_get_conversation before replying; reply only where an open request is addressed to you; finished conversations get silence, not acknowledgments. Mention anything the user should know about."
+    "Triage per your AgentChat skill: read a conversation with agentchat_get_conversation before replying, passing its latest_message_id as around_message_id and any listed attention_message_ids exactly; reply only where an open request is addressed to you; finished conversations get silence, not acknowledgments. Mention anything the user should know about."
   ].join("\n");
 }
 function formatStopPickup(handle, rows) {
@@ -364,7 +346,7 @@ function formatStopPickup(handle, rows) {
     "",
     ...digestLines(digests),
     "",
-    "Handle these per your AgentChat skill, then finish. Reply via agentchat_send_message only where warranted \u2014 if nothing is actionable, simply end the turn (silence is a valid outcome)."
+    "Handle these per your AgentChat skill, opening each conversation with agentchat_get_conversation, its latest_message_id as around_message_id, and any listed attention_message_ids exactly. Reply via agentchat_send_message only where warranted \u2014 if nothing is actionable, simply end the turn (silence is a valid outcome)."
   ].join("\n");
 }
 function formatAlwaysOnDown(copy) {
@@ -451,6 +433,7 @@ function renderDeclinedBlock(copy) {
 var SESSION_START_PEEK_LIMIT = 100;
 var STOP_PEEK_LIMIT = 50;
 var DEFAULT_MAX_CONTINUATIONS = 5;
+var FOREGROUND_TURN_TTL_SECONDS = 600;
 function hooksDisabled() {
   return process.env["AGENTCHAT_HOOKS_ENABLED"] === "0";
 }
@@ -479,12 +462,12 @@ function ackableRows(rows) {
   return usable;
 }
 async function claimContiguousPrefix(cfg, rows, holder) {
-  const won = await Promise.all(rows.map((r) => claimReply(cfg, r.id, holder)));
-  const prefix = [];
-  for (let i = 0; i < rows.length; i++) {
-    if (!won[i]) break;
-    prefix.push(rows[i]);
-  }
+  const claimed = await claimReplyBatch(
+    cfg,
+    rows.map((row) => row.id),
+    holder
+  );
+  const prefix = rows.slice(0, claimed);
   if (prefix.length < rows.length) {
     log.info(
       `coexistence: daemon owns ${rows.length - prefix.length} row(s); surfacing ${prefix.length}`
@@ -507,7 +490,6 @@ async function sessionStart(ctx, input) {
       return none;
     }
     const cfg = { apiKey: identity.apiKey, apiBase: identity.apiBase };
-    await markSessionActive(cfg);
     const h = alwaysOnHealth(ctx.home);
     const alert = h.wanted && !h.healthy ? formatAlwaysOnDown(ctx.copy) : null;
     const peeked = ackableRows(await syncPeek(cfg, { limit: SESSION_START_PEEK_LIMIT }));
@@ -531,9 +513,10 @@ async function userPrompt(ctx, input) {
     if (hooksDisabled()) return;
     const identity = resolveIdentity(ctx.home);
     if (identity === null) return;
+    const cfg = { apiKey: identity.apiKey, apiBase: identity.apiBase };
+    await markForegroundTurn(cfg, input.sessionId, FOREGROUND_TURN_TTL_SECONDS);
     const cursor = takePendingAck(ctx.home, input.sessionId);
     if (cursor === null) return;
-    const cfg = { apiKey: identity.apiKey, apiBase: identity.apiBase };
     try {
       await syncAck(cfg, cursor);
     } catch (err) {
@@ -547,43 +530,64 @@ async function userPrompt(ctx, input) {
 async function stop(ctx, input) {
   const none = { reason: null, commit: async () => {
   } };
+  let cfg = null;
   try {
     if (hooksDisabled()) return none;
     const identity = resolveIdentity(ctx.home);
     if (identity === null) return none;
-    const cfg = { apiKey: identity.apiKey, apiBase: identity.apiBase };
-    await markSessionActive(cfg);
+    cfg = { apiKey: identity.apiKey, apiBase: identity.apiBase };
+    await markForegroundTurn(cfg, input.sessionId, FOREGROUND_TURN_TTL_SECONDS);
     const cap = maxContinuations();
     if (getContinuations(ctx.home, input.sessionId) >= cap) {
       log.info(
         `stop hook: continuation cap (${cap}) reached for ${input.sessionId}; leaving inbox queued`
       );
+      await clearForegroundTurn(cfg, input.sessionId);
       return none;
     }
     const peeked = ackableRows(await syncPeek(cfg, { limit: STOP_PEEK_LIMIT }));
-    if (peeked.length === 0) return none;
+    if (peeked.length === 0) {
+      await clearForegroundTurn(cfg, input.sessionId);
+      return none;
+    }
     const rows = await claimContiguousPrefix(cfg, peeked, `session:${input.sessionId}`);
-    if (rows.length === 0) return none;
+    if (rows.length === 0) {
+      await clearForegroundTurn(cfg, input.sessionId);
+      return none;
+    }
     recordContinuation(ctx.home, input.sessionId);
     const handle = await resolveHandle(cfg, identity.handle);
     const reason = formatStopPickup(handle, rows);
     const cursor = lastDeliveryId(rows);
+    const claimedCfg = cfg;
     return {
       reason,
       commit: async () => {
         if (cursor === null) return;
         try {
-          await syncAck(cfg, cursor);
+          await syncAck(claimedCfg, cursor);
         } catch (err) {
           log.warn(`stop ack failed (messages stay queued): ${String(err)}`);
         }
       }
     };
   } catch (err) {
+    if (cfg !== null) await clearForegroundTurn(cfg, input.sessionId);
     log.warn(`stop hook degraded to no-op: ${String(err)}`);
     return none;
   }
 }
+async function sessionEnd(ctx, input) {
+  try {
+    if (hooksDisabled()) return;
+    const identity = resolveIdentity(ctx.home);
+    if (identity === null) return;
+    const cfg = { apiKey: identity.apiKey, apiBase: identity.apiBase };
+    await clearForegroundTurn(cfg, input.sessionId);
+  } catch (err) {
+    log.warn(`session-end hook degraded to no-op: ${String(err)}`);
+  }
+}
 
 // src/hooks/hook-input.ts
 async function readHookInput(stream = process.stdin) {
@@ -653,6 +657,14 @@ function createHookRunners(context, dialect) {
       } catch (err) {
         log.warn(`stop hook degraded to no-op: ${String(err)}`);
       }
+    },
+    async runSessionEnd() {
+      try {
+        const input = await readHookInput();
+        await sessionEnd(context(), input);
+      } catch (err) {
+        log.warn(`session-end hook degraded to no-op: ${String(err)}`);
+      }
     }
   };
 }
@@ -1696,10 +1708,12 @@ export {
   atomicWriteFile,
   beat,
   claimReply,
+  claimReplyBatch,
   clearAlwaysOnInstalledVersion,
   clearAlwaysOnOptOut,
   clearAlwaysOnWanted,
   clearCredentials,
+  clearForegroundTurn,
   clearOfferDeclined,
   clearPending,
   clearSessionActive,
@@ -1724,6 +1738,7 @@ export {
   markAlwaysOnInstalledVersion,
   markAlwaysOnOptOut,
   markAlwaysOnWanted,
+  markForegroundTurn,
   markSessionActive,
   offerDeclined,
   pendingPath,
@@ -1751,6 +1766,7 @@ export {
   serviceDefinitionCurrent,
   serviceInstalled,
   serviceStatus,
+  sessionEnd,
   sessionStart,
   setPendingAck,
   shouldOfferRegistration,