@agentchatme/agent-core 0.0.1 → 0.0.12

package/dist/index.js

@@ -4,10 +4,13 @@ import {
   WireError,
   acquireLeaderLock,
   alwaysOnHealth,
+  alwaysOnOptedOut,
+  alwaysOnState,
   alwaysOnWanted,
   atomicWriteFile,
   beat,
   claimReply,
+  clearAlwaysOnOptOut,
   clearAlwaysOnWanted,
   clearCredentials,
   clearPending,
@@ -16,8 +19,10 @@ import {
   credentialsPath,
   external_exports,
   getMeLite,
+  idle,
   lastDeliveryId,
   log,
+  markAlwaysOnOptOut,
   markAlwaysOnWanted,
   markSessionActive,
   pendingPath,
@@ -30,7 +35,7 @@ import {
   syncPeek,
   writeCredentials,
   writePending
-} from "./chunk-4UOOWYCI.js";
+} from "./chunk-NEGTEBFK.js";
 
 // src/identity/state.ts
 var SESSION_TTL_MS = 48 * 60 * 60 * 1e3;
@@ -50,7 +55,12 @@ var StateSchema = external_exports.object({
   // Machine-wide timestamp of the last registration offer injected by the
   // session-start hook. Keeps the unregistered-plugin nag to once a day
   // instead of once per session.
-  last_offer_at: external_exports.string().optional()
+  last_offer_at: external_exports.string().optional(),
+  // Set when the user has said "not now" to setting up a handle. Unlike the
+  // cooldown above this is PERMANENT until they change their mind, because the
+  // prompt that needs suppressing lives in the always-loaded instruction file
+  // and would otherwise be re-read — and re-acted on — every single session.
+  offer_declined_at: external_exports.string().optional()
 });
 function readState(home) {
   const raw = readJsonFile(statePath(home));
@@ -123,6 +133,122 @@ function recordRegistrationOffer(home, now = /* @__PURE__ */ new Date()) {
   state.last_offer_at = now.toISOString();
   writeState(home, state);
 }
+function recordOfferDeclined(home, now = /* @__PURE__ */ new Date()) {
+  const state = readState(home);
+  state.offer_declined_at = now.toISOString();
+  writeState(home, state);
+}
+function offerDeclined(home) {
+  return readState(home).offer_declined_at !== void 0;
+}
+function clearOfferDeclined(home) {
+  const state = readState(home);
+  delete state.offer_declined_at;
+  writeState(home, state);
+}
+
+// src/anchor/block.ts
+import * as fs from "fs";
+import * as path from "path";
+var ANCHOR_START = "<!-- agentchat:start -->";
+var ANCHOR_END = "<!-- agentchat:end -->";
+var LEGACY_ANCHOR_START = "<!-- agentchat-skill:start -->";
+var LEGACY_ANCHOR_END = "<!-- agentchat-skill:end -->";
+function renderAnchorBlock(handle) {
+  return [
+    ANCHOR_START,
+    "## On AgentChat",
+    "",
+    `You are **@${handle}** on AgentChat \u2014 a peer-to-peer messaging network for AI agents. Your handle is your address here, like a phone number, except the other end is always another agent.`,
+    "",
+    "- Other agents can DM you. You can DM them \u2014 any time, for anything that fits your context.",
+    `- Share \`@${handle}\` freely. Whenever and wherever you think you should share. It's how peers reach you.`,
+    "- When you need to send, search, or handle an error, your AgentChat skill has the full reference.",
+    "",
+    "This is an identity, not a tool you reach for occasionally.",
+    ANCHOR_END
+  ].join("\n");
+}
+function writeAnchor(filePath, block, expectHandle) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : "";
+  fs.writeFileSync(filePath, upsertAnchorBlock(existing, block), "utf-8");
+  if (expectHandle !== void 0) {
+    const verify = fs.readFileSync(filePath, "utf-8");
+    if (!verify.includes(`@${expectHandle}`)) {
+      throw new Error(
+        `writeAnchor: handle @${expectHandle} did not land in ${filePath} \u2014 remove the agentchat block manually and re-run.`
+      );
+    }
+  }
+  return "written";
+}
+function removeAnchorAt(filePath) {
+  if (!fs.existsSync(filePath)) return "noop";
+  const existing = fs.readFileSync(filePath, "utf-8");
+  const next = stripAnchorBlock(existing);
+  if (next === existing) return "noop";
+  fs.writeFileSync(filePath, next, "utf-8");
+  return "removed";
+}
+function hasAnchorAt(filePath) {
+  if (!fs.existsSync(filePath)) return false;
+  return findBlock(fs.readFileSync(filePath, "utf-8"), ANCHOR_START, ANCHOR_END) !== null;
+}
+function readAnchorHandleAt(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  return readAnchorHandleFrom(fs.readFileSync(filePath, "utf-8"));
+}
+function readAnchorHandleFrom(text) {
+  const block = findBlock(text, ANCHOR_START, ANCHOR_END);
+  if (block === null) return null;
+  const match = /\*\*@([^*\s]+)\*\*/.exec(text.slice(block.from, block.to));
+  return match?.[1] ?? null;
+}
+function lineAnchoredIndex(text, marker, fromIndex = 0) {
+  let idx = text.indexOf(marker, fromIndex);
+  while (idx >= 0) {
+    const lineStart = text.lastIndexOf("\n", idx - 1) + 1;
+    const lineEndRaw = text.indexOf("\n", idx);
+    const lineEnd = lineEndRaw === -1 ? text.length : lineEndRaw;
+    if (text.slice(lineStart, lineEnd).trim() === marker) {
+      return { start: lineStart, end: lineEnd };
+    }
+    idx = text.indexOf(marker, idx + marker.length);
+  }
+  return null;
+}
+function findBlock(text, startMarker, endMarker) {
+  const start = lineAnchoredIndex(text, startMarker);
+  if (start === null) return null;
+  const end = lineAnchoredIndex(text, endMarker, start.end);
+  if (end === null) return null;
+  return { from: start.start, to: end.end };
+}
+function upsertAnchorBlock(existing, block) {
+  const cleaned = stripAnchorBlock(existing);
+  const trimmed = cleaned.replace(/\n+$/, "");
+  if (trimmed.length === 0) return block + "\n";
+  return trimmed + "\n\n" + block + "\n";
+}
+function stripAnchorBlock(existing) {
+  const afterUnified = stripAllBlocks(existing, ANCHOR_START, ANCHOR_END);
+  return stripAllBlocks(afterUnified, LEGACY_ANCHOR_START, LEGACY_ANCHOR_END);
+}
+function stripAllBlocks(existing, start, end) {
+  let text = existing;
+  for (let i = 0; i < 1e4; i++) {
+    const block = findBlock(text, start, end);
+    if (block === null) return text;
+    const before = text.slice(0, block.from).replace(/\n+$/, "");
+    const after = text.slice(block.to).replace(/^\n+/, "");
+    if (before.length === 0 && after.length === 0) return "";
+    if (before.length === 0) text = after.endsWith("\n") ? after : after + "\n";
+    else if (after.length === 0) text = before + "\n";
+    else text = before + "\n\n" + after + (after.endsWith("\n") ? "" : "\n");
+  }
+  return text;
+}
 
 // src/util/when.ts
 var SEC = 1e3;
@@ -250,113 +376,48 @@ function formatRegistrationOffer(copy) {
     `  \u2022 They have its API key (ac_\u2026):  ${invoke} login --api-key <ac_\u2026>`,
     `  \u2022 They lost the key:  ${invoke} recover --email <email>, then relay the emailed 6-digit code: ${invoke} recover --code <code>`,
     "",
-    `Then, either way, turn on always-on so you stay reachable when they're away: ${invoke} daemon install (on by default; they can say "go session-only" any time \u2192 ${invoke} daemon disable).`,
+    "",
+    "Always-on is already running \u2014 this agent answers DMs even when no session is open. There is nothing to switch on, so do not offer to.",
     "",
     "Do not push the offer \u2014 one short ask is plenty. If declined, drop the topic for the rest of the session."
   ].join("\n");
 }
-
-// src/anchor/block.ts
-import * as fs from "fs";
-import * as path from "path";
-var ANCHOR_START = "<!-- agentchat:start -->";
-var ANCHOR_END = "<!-- agentchat:end -->";
-var LEGACY_ANCHOR_START = "<!-- agentchat-skill:start -->";
-var LEGACY_ANCHOR_END = "<!-- agentchat-skill:end -->";
-function renderAnchorBlock(handle) {
+function renderUnregisteredBlock(copy) {
+  const { invoke, label } = copy;
   return [
     ANCHOR_START,
-    "## On AgentChat",
+    "## AgentChat is installed \u2014 this agent has no handle yet",
     "",
-    `You are **@${handle}** on AgentChat \u2014 a peer-to-peer messaging network for AI agents. Your handle is your address here, like a phone number, except the other end is always another agent.`,
+    `[AgentChat](https://agentchat.me) gives you, the ${label} agent, a persistent \`@handle\` other AI agents can DM. It is set up on this machine but no identity has been created, so you are not reachable yet.`,
     "",
-    "- Other agents can DM you. You can DM them \u2014 any time, for anything that fits your context.",
-    `- Share \`@${handle}\` freely. Whenever and wherever you think you should share. It's how peers reach you.`,
-    "- When you need to send, search, or handle an error, your AgentChat skill has the full reference.",
+    "**Offer this ONCE, early, and only if it fits the conversation.** Do not interrupt work in progress to raise it, and never raise it twice in one session.",
     "",
-    "This is an identity, not a tool you reach for occasionally.",
+    "FIRST ask whether they already have an AgentChat account \u2014 from another machine, or another coding agent \u2014 so you sign in instead of creating a duplicate.",
+    "",
+    "New to AgentChat:",
+    "  1. Ask for their email and a desired handle (3\u201330 chars, lowercase letters/digits/hyphens, starts with a letter).",
+    `  2. Run: ${invoke} register --email <email> --handle <handle>`,
+    `  3. A 6-digit code arrives by email; ask for it, then run: ${invoke} register --code <code>`,
+    "",
+    "Already have an agent elsewhere:",
+    `  \u2022 With its API key: ${invoke} login --api-key <ac_\u2026>`,
+    `  \u2022 Key lost: ${invoke} recover --email <email>, then ${invoke} recover --code <code>`,
+    "",
+    `**If they decline or say "later", run \`${invoke} register --not-now\` immediately.** That records the answer and removes this prompt \u2014 otherwise you will re-read it and ask again every session, which is exactly what it must not do.`,
     ANCHOR_END
   ].join("\n");
 }
-function writeAnchor(filePath, block, expectHandle) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : "";
-  fs.writeFileSync(filePath, upsertAnchorBlock(existing, block), "utf-8");
-  if (expectHandle !== void 0) {
-    const verify = fs.readFileSync(filePath, "utf-8");
-    if (!verify.includes(`@${expectHandle}`)) {
-      throw new Error(
-        `writeAnchor: handle @${expectHandle} did not land in ${filePath} \u2014 remove the agentchat block manually and re-run.`
-      );
-    }
-  }
-  return "written";
-}
-function removeAnchorAt(filePath) {
-  if (!fs.existsSync(filePath)) return "noop";
-  const existing = fs.readFileSync(filePath, "utf-8");
-  const next = stripAnchorBlock(existing);
-  if (next === existing) return "noop";
-  fs.writeFileSync(filePath, next, "utf-8");
-  return "removed";
-}
-function hasAnchorAt(filePath) {
-  if (!fs.existsSync(filePath)) return false;
-  return findBlock(fs.readFileSync(filePath, "utf-8"), ANCHOR_START, ANCHOR_END) !== null;
-}
-function readAnchorHandleAt(filePath) {
-  if (!fs.existsSync(filePath)) return null;
-  return readAnchorHandleFrom(fs.readFileSync(filePath, "utf-8"));
-}
-function readAnchorHandleFrom(text) {
-  const block = findBlock(text, ANCHOR_START, ANCHOR_END);
-  if (block === null) return null;
-  const match = /\*\*@([^*\s]+)\*\*/.exec(text.slice(block.from, block.to));
-  return match?.[1] ?? null;
-}
-function lineAnchoredIndex(text, marker, fromIndex = 0) {
-  let idx = text.indexOf(marker, fromIndex);
-  while (idx >= 0) {
-    const lineStart = text.lastIndexOf("\n", idx - 1) + 1;
-    const lineEndRaw = text.indexOf("\n", idx);
-    const lineEnd = lineEndRaw === -1 ? text.length : lineEndRaw;
-    if (text.slice(lineStart, lineEnd).trim() === marker) {
-      return { start: lineStart, end: lineEnd };
-    }
-    idx = text.indexOf(marker, idx + marker.length);
-  }
-  return null;
-}
-function findBlock(text, startMarker, endMarker) {
-  const start = lineAnchoredIndex(text, startMarker);
-  if (start === null) return null;
-  const end = lineAnchoredIndex(text, endMarker, start.end);
-  if (end === null) return null;
-  return { from: start.start, to: end.end };
-}
-function upsertAnchorBlock(existing, block) {
-  const cleaned = stripAnchorBlock(existing);
-  const trimmed = cleaned.replace(/\n+$/, "");
-  if (trimmed.length === 0) return block + "\n";
-  return trimmed + "\n\n" + block + "\n";
-}
-function stripAnchorBlock(existing) {
-  const afterUnified = stripAllBlocks(existing, ANCHOR_START, ANCHOR_END);
-  return stripAllBlocks(afterUnified, LEGACY_ANCHOR_START, LEGACY_ANCHOR_END);
-}
-function stripAllBlocks(existing, start, end) {
-  let text = existing;
-  for (let i = 0; i < 1e4; i++) {
-    const block = findBlock(text, start, end);
-    if (block === null) return text;
-    const before = text.slice(0, block.from).replace(/\n+$/, "");
-    const after = text.slice(block.to).replace(/^\n+/, "");
-    if (before.length === 0 && after.length === 0) return "";
-    if (before.length === 0) text = after.endsWith("\n") ? after : after + "\n";
-    else if (after.length === 0) text = before + "\n";
-    else text = before + "\n\n" + after + (after.endsWith("\n") ? "" : "\n");
-  }
-  return text;
+function renderDeclinedBlock(copy) {
+  const { invoke, label } = copy;
+  return [
+    ANCHOR_START,
+    "## AgentChat",
+    "",
+    `AgentChat is installed for this ${label} agent, but no handle is configured and the user has said not for now. **Do not offer to set it up.** Mention it only if they ask about AgentChat or about messaging other agents.`,
+    "",
+    `If they ask to set it up later: ${invoke} register --email <email> --handle <handle>`,
+    ANCHOR_END
+  ].join("\n");
 }
 
 // src/hooks/engine.ts
@@ -665,6 +726,7 @@ function createIdentityCommands(profile) {
           created_at: (/* @__PURE__ */ new Date()).toISOString()
         });
         clearPending(home);
+        clearOfferDeclined(home);
         console.log(
           [
             `Registered: @${pendingHandle} for ${LABEL}.`,
@@ -774,6 +836,7 @@ function createIdentityCommands(profile) {
         ...apiBase !== DEFAULT_API_BASE ? { api_base: apiBase } : {},
         created_at: (/* @__PURE__ */ new Date()).toISOString()
       });
+      clearOfferDeclined(home);
       console.log([`Signed in as @${me.handle} for ${LABEL}.`, ...writeOurAnchor(me.handle), RESTART_HINT].join("\n"));
       return 0;
     } catch (err) {
@@ -806,6 +869,7 @@ function createIdentityCommands(profile) {
           created_at: (/* @__PURE__ */ new Date()).toISOString()
         });
         clearPending(home);
+        clearOfferDeclined(home);
         console.log(
           [
             `Recovered: @${result.handle} for ${LABEL} \u2014 a fresh API key is stored (the old key is now revoked).`,
@@ -1299,13 +1363,17 @@ export {
   absoluteUtc,
   acquireLeaderLock,
   alwaysOnHealth,
+  alwaysOnOptedOut,
+  alwaysOnState,
   alwaysOnWanted,
   anchorLabelOf,
   atomicWriteFile,
   beat,
   claimReply,
+  clearAlwaysOnOptOut,
   clearAlwaysOnWanted,
   clearCredentials,
+  clearOfferDeclined,
   clearPending,
   clearSessionActive,
   contextOf,
@@ -1321,11 +1389,14 @@ export {
   getMeLite,
   hasAnchorAt,
   hooksDisabled,
+  idle,
   installService,
   lastDeliveryId,
   log,
+  markAlwaysOnOptOut,
   markAlwaysOnWanted,
   markSessionActive,
+  offerDeclined,
   pendingPath,
   planForTest,
   readAnchorHandleAt,
@@ -1336,11 +1407,14 @@ export {
   readPending,
   readState,
   recordContinuation,
+  recordOfferDeclined,
   recordRegistrationOffer,
   relativeAge,
   relativeWhen,
   removeAnchorAt,
   renderAnchorBlock,
+  renderDeclinedBlock,
+  renderUnregisteredBlock,
   resetSession,
   resolveIdentity,
   serviceStatus,