@agentchatme/agent-core 0.0.1311 → 0.0.1313

package/README.md

@@ -32,7 +32,14 @@ Neither bug came from sharing protocol code. Both came from a single command sur
 | Identity flows — register / login / recover / status / logout / doctor | How to render its anchor |
 | Session digest text | What JSON shape its hooks emit (`dialect`) |
 | Hook state machine (continuation cap, ack cursor) | How to spawn a headless turn of its runtime (`RuntimeAdapter`) |
-| Daemon — the loop, WS client, leader lock, service install | Its packaging and front door |
+| Daemon — loop, WS client, canonical delivery prompt, service install | Its packaging and front door |
+
+An unattended turn represents one bounded, same-conversation backlog (up to 30
+durable deliveries). The newest message is the explicit focus, earlier pending
+messages remain chronological context, and exact group-mention ids are surfaced
+as attention. Both host adapters open the same compact, message-anchored
+conversation context through the MCP server. Host adapters do not maintain
+separate prompt dialects.
 
 The test for which column something belongs in: **if changing it requires a
 matching change on the server, it lives here; if changing it requires reading
@@ -93,6 +100,14 @@ import { runDaemon } from '@agentchatme/agent-core/daemon'
 await runDaemon({ home: profile.home(), adapter: new MyRuntimeAdapter(...) })
 ```
 
+The daemon coalesces a burst or reconnect backlog from one conversation into one
+bounded runtime turn, focused on its newest message. A later arrival cannot join
+a batch once its turn has started. Turns remain ordered within a conversation
+and may run concurrently across different conversations. Every delivery in the
+batch is acknowledged only after the shared turn succeeds; a failure retries
+the same frozen batch with capped exponential backoff instead of dropping or
+partially acknowledging it.
+
 ## Development
 
 ```

package/dist/{chunk-ER4AFPH7.js → chunk-27XDHOL3.js}

@@ -25,7 +25,7 @@ var log = {
 };
 
 // src/version.ts
-var VERSION = "0.0.1311";
+var VERSION = "0.0.1313";
 
 // src/client-identity.ts
 var CODING_AGENTS_CLIENT_IDENTITY = {
@@ -37,6 +37,37 @@ var CODING_AGENTS_CLIENT_HEADERS = {
   "X-AgentChat-Client-Version": CODING_AGENTS_CLIENT_IDENTITY.version
 };
 
+// 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/daemon/leader-lock.ts
 import * as fs from "fs";
 import * as path from "path";
@@ -108,6 +139,23 @@ function atomicWriteFile(filePath, data, mode) {
     fs2.chmodSync(filePath, mode);
   }
 }
+function atomicCopyFile(source, destination, mode = 493) {
+  const dir = path2.dirname(destination);
+  fs2.mkdirSync(dir, { recursive: true, mode: 448 });
+  const tmp = path2.join(dir, `.${path2.basename(destination)}.${process.pid}.tmp`);
+  try {
+    fs2.copyFileSync(source, tmp);
+    fs2.chmodSync(tmp, mode);
+    fs2.renameSync(tmp, destination);
+    fs2.chmodSync(destination, mode);
+  } catch (err) {
+    try {
+      fs2.rmSync(tmp, { force: true });
+    } catch {
+    }
+    throw err;
+  }
+}
 function readJsonFile(filePath) {
   try {
     const raw = fs2.readFileSync(filePath, "utf-8");
@@ -4265,8 +4313,11 @@ var SyncRowSchema = external_exports.object({
   // fallback against a future server-side rename).
   sender: external_exports.string().optional(),
   sender_handle: external_exports.string().optional(),
+  seq: external_exports.number().optional(),
   type: external_exports.string().optional(),
   content: external_exports.record(external_exports.unknown()).optional(),
+  metadata: external_exports.record(external_exports.unknown()).optional(),
+  status: external_exports.string().optional(),
   created_at: external_exports.string().optional()
 }).passthrough();
 function contextOf(row) {
@@ -4371,6 +4422,28 @@ async function claimReply(cfg, messageId, holder) {
     return true;
   }
 }
+async function claimReplyBatch(cfg, messageIds, holder) {
+  if (messageIds.length === 0) return 0;
+  try {
+    const data = await request(cfg, "POST", "/v1/reply/claim-batch", {
+      message_ids: messageIds,
+      holder
+    });
+    const parsed = external_exports.object({ claimed_count: external_exports.number().int().min(0).max(messageIds.length) }).passthrough().safeParse(data);
+    return parsed.success ? parsed.data.claimed_count : messageIds.length;
+  } catch (err) {
+    if (!/AgentChat API (404|405)\b/.test(String(err))) {
+      log.warn(`reply-batch-claim failed (surfacing all): ${String(err)}`);
+      return messageIds.length;
+    }
+  }
+  let claimed = 0;
+  for (const messageId of messageIds) {
+    if (!await claimReply(cfg, messageId, holder)) break;
+    claimed += 1;
+  }
+  return claimed;
+}
 function lastDeliveryId(rows) {
   for (let i = rows.length - 1; i >= 0; i--) {
     const id = rows[i]?.delivery_id;
@@ -4383,6 +4456,7 @@ function lastDeliveryId(rows) {
 import * as fs4 from "fs";
 import * as path4 from "path";
 var ALWAYS_ON_WANTED = "always-on.wanted";
+var ALWAYS_ON_INSTALLED_VERSION = "always-on.installed-version";
 var HEARTBEAT_FILE = "daemon.heartbeat";
 var HEARTBEAT_STALE_MS = 3 * 6e4;
 function markAlwaysOnWanted(home) {
@@ -4401,6 +4475,24 @@ function clearAlwaysOnWanted(home) {
 function alwaysOnWanted(home) {
   return fs4.existsSync(path4.join(home, ALWAYS_ON_WANTED));
 }
+function readAlwaysOnInstalledVersion(home) {
+  try {
+    const version = fs4.readFileSync(path4.join(home, ALWAYS_ON_INSTALLED_VERSION), "utf-8").trim();
+    return version.length > 0 ? version : null;
+  } catch {
+    return null;
+  }
+}
+function markAlwaysOnInstalledVersion(home, version) {
+  atomicWriteFile(path4.join(home, ALWAYS_ON_INSTALLED_VERSION), `${version}
+`, 384);
+}
+function clearAlwaysOnInstalledVersion(home) {
+  try {
+    fs4.rmSync(path4.join(home, ALWAYS_ON_INSTALLED_VERSION), { force: true });
+  } catch {
+  }
+}
 var ALWAYS_ON_OPTOUT = "always-on.optout";
 function markAlwaysOnOptOut(home) {
   try {
@@ -4461,8 +4553,13 @@ export {
   VERSION,
   CODING_AGENTS_CLIENT_IDENTITY,
   CODING_AGENTS_CLIENT_HEADERS,
+  relativeAge,
+  absoluteUtc,
+  relativeWhen,
+  formatWhen,
   acquireLeaderLock,
   atomicWriteFile,
+  atomicCopyFile,
   readJsonFile,
   DEFAULT_API_BASE,
   credentialsPath,
@@ -4483,11 +4580,15 @@ export {
   markSessionActive,
   clearSessionActive,
   claimReply,
+  claimReplyBatch,
   lastDeliveryId,
   HEARTBEAT_FILE,
   markAlwaysOnWanted,
   clearAlwaysOnWanted,
   alwaysOnWanted,
+  readAlwaysOnInstalledVersion,
+  markAlwaysOnInstalledVersion,
+  clearAlwaysOnInstalledVersion,
   markAlwaysOnOptOut,
   clearAlwaysOnOptOut,
   alwaysOnOptedOut,
@@ -4496,4 +4597,4 @@ export {
   alwaysOnState,
   alwaysOnHealth
 };
-//# sourceMappingURL=chunk-ER4AFPH7.js.map
+//# sourceMappingURL=chunk-27XDHOL3.js.map