@agentchatme/agent-core 0.0.1312 → 0.0.13131

package/README.md

@@ -6,7 +6,7 @@ This is a **library, not a CLI**. It is consumed by the per-agent integrations,
 
 | Coding agent | What a user installs |
 |---|---|
-| Claude Code | [`agentchatme/agentchat-claude-code`](https://github.com/agentchatme/agentchat-claude-code) (plugin marketplace) |
+| Claude Code | [`@agentchatme/claude-code`](https://www.npmjs.com/package/@agentchatme/claude-code) |
 | Codex | [`@agentchatme/codex`](https://www.npmjs.com/package/@agentchatme/codex) |
 
 ## The one rule
@@ -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
@@ -56,6 +63,12 @@ Injection **is** delivery, and nothing is acked until a session proves it is rea
 
 Rows without an ackable `delivery_id` are never surfaced — they could only re-inject forever.
 
+Foreground/daemon ownership is atomic at the server. `userPrompt()` leases one
+concrete host session before a model turn; `stop()` renews it for a continuation
+or clears it when the session becomes idle; `sessionEnd()` clears only that
+session. The daemon's claim operation prunes expired leases and claims the
+message in one Redis script, so the old check-then-wait race no longer exists.
+
 ## Usage
 
 An integration describes itself once and gets the flows back:
@@ -75,7 +88,7 @@ const profile: HostProfile = {
 }
 
 const { runRegister, runStatus, runLogout, runDoctor } = createIdentityCommands(profile)
-const { runSessionStart, runStop } = createHookRunners(
+const { runSessionStart, runUserPrompt, runStop, runSessionEnd } = createHookRunners(
   () => ({ home: profile.home(), copy: { invoke: profile.invocation(), label: profile.label } }),
   myHostsDialect,          // how THIS host wants hook JSON shaped
 )
@@ -93,10 +106,13 @@ import { runDaemon } from '@agentchatme/agent-core/daemon'
 await runDaemon({ home: profile.home(), adapter: new MyRuntimeAdapter(...) })
 ```
 
-The daemon gives each incoming message its own runtime turn. Turns are ordered
-within a conversation and may run concurrently across different conversations.
-A message is acknowledged only after its turn succeeds; a failure stays pending
-and retries with capped exponential backoff instead of being dropped.
+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-AGDJ4A6R.js → chunk-M2X5WY7Q.js}

@@ -25,7 +25,7 @@ var log = {
 };
 
 // src/version.ts
-var VERSION = "0.0.1312";
+var VERSION = "0.0.13131";
 
 // 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";
@@ -4282,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) {
@@ -4378,6 +4412,22 @@ async function clearSessionActive(cfg) {
   } catch {
   }
 }
+async function markForegroundTurn(cfg, sessionId, ttlSeconds) {
+  try {
+    await request(cfg, "PUT", "/v1/reply/active", {
+      session_id: sessionId,
+      ttl_seconds: ttlSeconds
+    });
+  } catch (err) {
+    log.warn(`foreground-turn mark failed (ignored): ${String(err)}`);
+  }
+}
+async function clearForegroundTurn(cfg, sessionId) {
+  try {
+    await request(cfg, "DELETE", "/v1/reply/active", { session_id: sessionId });
+  } catch {
+  }
+}
 async function claimReply(cfg, messageId, holder) {
   try {
     const data = await request(cfg, "POST", "/v1/reply/claim", { message_id: messageId, holder });
@@ -4388,6 +4438,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;
@@ -4497,6 +4569,10 @@ export {
   VERSION,
   CODING_AGENTS_CLIENT_IDENTITY,
   CODING_AGENTS_CLIENT_HEADERS,
+  relativeAge,
+  absoluteUtc,
+  relativeWhen,
+  formatWhen,
   acquireLeaderLock,
   atomicWriteFile,
   atomicCopyFile,
@@ -4519,7 +4595,10 @@ export {
   getMeLite,
   markSessionActive,
   clearSessionActive,
+  markForegroundTurn,
+  clearForegroundTurn,
   claimReply,
+  claimReplyBatch,
   lastDeliveryId,
   HEARTBEAT_FILE,
   markAlwaysOnWanted,
@@ -4536,4 +4615,4 @@ export {
   alwaysOnState,
   alwaysOnHealth
 };
-//# sourceMappingURL=chunk-AGDJ4A6R.js.map
+//# sourceMappingURL=chunk-M2X5WY7Q.js.map