@alook/daemon 0.1.16 → 0.1.17

package/dist/cli/index.js

@@ -17792,7 +17792,9 @@ var communityChannel = sqliteTable("community_channel", {
   creatorId: text("creator_id").references(() => user.id, { onDelete: "set null" }),
   messageCount: integer2("message_count").default(0),
   archived: integer2("archived").default(0),
-  parentMessageId: text("parent_message_id"),
+  parentMessageId: text("parent_message_id").references(() => communityMessage.id, {
+    onDelete: "cascade"
+  }),
   lastMessageAt: text("last_message_at"),
   createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
 }, (t) => [
@@ -18358,8 +18360,9 @@ var communityChannelDeleteSchema = exports_external.strictObject({
   type: exports_external.literal("community:channel.delete"),
   serverId: string4,
   channelId: string4,
-  parentChannelId: nullableString.optional()
-});
+  parentChannelId: nullableString.optional(),
+  parentMessageId: string4.optional()
+}).refine((event) => event.parentMessageId === undefined || typeof event.parentChannelId === "string" && event.parentChannelId.length > 0, { message: "parentMessageId requires parentChannelId" });
 var positionedIdSchema = exports_external.strictObject({ id: string4, position: exports_external.number() });
 var communityChannelReorderSchema = exports_external.strictObject({
   type: exports_external.literal("community:channel.reorder"),
@@ -25980,7 +25983,7 @@ function parseLocalMessageReminderBody(body, agentId) {
     return null;
   if (!Number.isSafeInteger(record4.sentSeq) || record4.sentSeq < 1)
     return null;
-  if (!Number.isSafeInteger(record4.remindAfterMs) || record4.remindAfterMs < LOCAL_MESSAGE_REMINDER_MIN_MS || record4.remindAfterMs > LOCAL_MESSAGE_REMINDER_MAX_MS)
+  if (!Number.isSafeInteger(record4.remindAfterMs) || record4.remindAfterMs !== 0 && record4.remindAfterMs < LOCAL_MESSAGE_REMINDER_MIN_MS || record4.remindAfterMs > LOCAL_MESSAGE_REMINDER_MAX_MS)
     return null;
   return {
     agentId,
@@ -26708,6 +26711,16 @@ function scrubRuntimeErrorDiagnosticText(value) {
 
 // src/drivers/systemPrompt.ts
 var CLI = "$ALOOK_CLI";
+var MESSAGE_SEND_STDIN_POLICY = [
+  "`--stdin` is required and limited to 1 KiB of UTF-8. Write it as social language a person " + "with ADHD can scan without effort:",
+  "",
+  "- Lead with the point, result, decision, or one concrete ask.",
+  "- Keep one message to one topic; suppress tangents and repeated recap.",
+  "- Use at most five short items when a list helps.",
+  "- Drop preambles, play-by-play, and closing pleasantries.",
+  "- Put exact plans, reviews, evidence, logs, and long technical detail in a Markdown attachment. " + "The message body carries only the short summary and next action."
+].join(`
+`);
 function identitySection(config2) {
   const parts = ["## Identity", ""];
   const name = config2.agentName ?? "a member of the household";
@@ -26738,9 +26751,9 @@ function cliCommandsSection() {
     "",
     "### Messaging",
     "",
-    `1. \`${CLI} inbox pull\` — fetch unread messages (advances your read waterline by default, ` + `so they won't re-pull; \`--no-ack\` to peek without advancing).`,
-    `2. \`${CLI} message send\` — send to a channel, DM, or thread. ` + `For a short body, use explicit \`--stdin\` with a quoted heredoc; for a long or complicated body, ` + `use \`--file <path>\`. Attach with \`--attachment <id>\` (repeatable, order matters). Optionally add ` + `\`--remind-after <duration>\` to be reminded if the same channel, thread, or DM receives no ` + `newer message after your send. Use a whole number of minutes or hours from \`1m\` to \`24h\`, ` + `such as \`15m\` or \`2h\`.`,
-    `3. \`${CLI} message attachment upload --target <ref> --file <path>\` — upload a file; ` + `returns an id stable across pending→persisted. Feed it into ` + `\`message send --attachment <id>\`.`,
+    `1. \`${CLI} inbox pull\` — fetch unread messages; \`--no-ack\` peeks without advancing.`,
+    `2. \`${CLI} message send --target <ref> --remind-after <0|Nm|Nh> --stdin\` — send to a ` + `channel, DM, or thread. ` + `The body is required through \`--stdin\` and limited to 1 KiB of UTF-8. ` + `Attach uploaded files with \`--attachment <id>\` (repeatable, order matters). ` + `\`--remind-after\` accepts \`0\`, or a whole-number duration from \`1m\` to \`24h\`.`,
+    `3. \`${CLI} message attachment upload --target <ref> --file <path>\` — upload a file; ` + `returns an id stable across pending→persisted.`,
     `4. \`${CLI} message attachment download --id <id> [--out <path>]\` — download any ` + `attachment you can see (or your own pending uploads).`,
     `5. \`${CLI} message emoji --target <ref> --emoji <e>\` — react with a single emoji. ` + `Works on channel messages (\`/<server>/<channel>#N\`), DM messages ` + `(\`/.dm/<peer>#N\`), and thread-reply messages (\`/<server>/<channel>/#N#M\`).`,
     `6. \`${CLI} message mark set --target <full-message-ref>\` — persist a message as outstanding work.`,
@@ -26770,7 +26783,7 @@ function cliCommandsSection() {
     "",
     "### Context Lifecycle",
     "",
-    `1. \`${CLI} nap --handoff <file>\` — reset your current session and ` + `start fresh. The required handoff is injected into the new session so your future self can ` + `quickly pick up unfinished work. Never nap on your own; only do it when someone explicitly asks.`,
+    `1. \`${CLI} nap --handoff <file>\` — reset the current session from a required handoff file.`,
     "",
     "### Output format",
     "",
@@ -26786,14 +26799,29 @@ function messagingSection() {
     "",
     "### Sending & receiving",
     "",
-    "You can initiate conversations — send to any channel or DM someone directly. You're not " + "limited to replying. Use the same `message send` command whether you're replying or " + "starting a conversation.",
+    "You can initiate conversations — send to any channel or DM someone directly. You're not " + "limited to replying; the same sending rules apply either way.",
+    "",
+    "#### Message body",
+    "",
+    MESSAGE_SEND_STDIN_POLICY,
+    "",
+    "#### Follow up when a conversation goes quiet",
+    "",
+    "`--remind-after T` is required on every send and controls whether a local follow-up is " + "armed for the same channel, thread, or DM.",
+    "",
+    "- Use `1m` to `24h` when silence would leave work unfinished — for example, after a question, " + "approval request, handoff, or blocker. If no newer message arrives by T, you will be reminded " + "to return; a newer message or daemon restart cancels the timer.",
+    "- Use `0` only when no later action depends on a reply. It disables the timer.",
+    "",
+    "Example: `--remind-after 5m` asks for a follow-up after five quiet minutes.",
+    "",
+    "#### Sending mechanics",
     "",
-    "- Reply where the message came from. Post results in the channel that owns the topic. " + "When uncertain, read history (below) or DM the relevant people.",
-    "Free-form message bodies never go in command arguments.",
+    `- Send body: use \`${CLI} message send --target <ref> --remind-after T --stdin\` with the ` + "quoted-heredoc form under *Message formatting*.",
+    `- Long detail: upload it with \`${CLI} message attachment upload --target <ref> --file <path>.md\`; ` + "add the returned id as `--attachment <id>` on the short stdin send.",
+    `- Cite a specific message: add \`--reply "#37"\` — \`--reply\` takes the \`#N\` seq ` + "(within `--target`) of the message you're answering.",
     "",
-    `- Short reply: use \`${CLI} message send --target <ref> --stdin\` with the quoted-heredoc form shown ` + "under *Message formatting*. Choose a fresh quoted delimiter that does not occur as a standalone line in the body.",
-    `- Long or complicated: write the body to a temporary file with a filesystem tool, then ` + `\`${CLI} message send --target <ref> --file ./temp_msg.md\`.`,
-    `- Cite a specific message: add \`--reply "#37"\` to either form — \`--reply\` takes the \`#N\` seq ` + "(within `--target`) of the message you're answering.",
+    "Reply where the message came from. Post results in the channel that owns the topic. " + "When uncertain, read history (below) or DM the relevant people.",
+    "Write every message body in the stdin/heredoc block; never place it directly on the command line.",
     "",
     "### Context refs",
     "",
@@ -26827,14 +26855,14 @@ function messagingSection() {
     "",
     "### Message formatting",
     "",
-    "Alook renders specially formatted plain-text refs and mentions in message bodies. Write them " + "as plain text, not inside backticks.",
+    "Alook specially renders refs and mentions in message bodies. Write them as plain text, not " + "inside backticks.",
     "",
-    "- **Context refs** — use `/<server>/<channel>` for a channel, `/<server>/<channel>#N` for " + "a message, and `/<server>/<channel>/#N#M` for a thread reply; DMs use `/.dm/<peer>` and " + "`/.dm/<peer>#N`. Refs make context clickable across conversations, so use the full path " + "rather than a bare `#N`. Never paste a private DM ref into a server channel.",
+    "- **Context refs** — write the full refs from *Context refs* above so they stay " + "clickable. Never paste a private DM ref into a server channel.",
     "- **Mentions** — `@name#NNNN` calls that person's attention specifically. In a private " + "channel, first verify they " + `are a member with \`${CLI} channel member --channel <ref>\` before mentioning them.`,
     "",
     "```bash",
     "# Choose a fresh quoted delimiter that does not occur as a standalone line in the body.",
-    `${CLI} message send --target "/demo#1234/general" --stdin <<'ALOOK_MESSAGE_7F3C'`,
+    `${CLI} message send --target "/demo#1234/general" --remind-after 5m --stdin <<'ALOOK_MESSAGE_7F3C'`,
     "@alice#0001 Please review /demo#1234/general#42",
     "ALOOK_MESSAGE_7F3C",
     "```",
@@ -26847,7 +26875,7 @@ function messagingSection() {
     "```",
     "",
     "`channel` is the reply ref. `seq` (`#N`) identifies the message within its channel — " + "combine into `/<server>/<channel>/#N` for an in-thread reply.",
-    "`content.replyTo` (`{seq, sender}`) is present when a message replies to another — cite it " + 'back with `--reply "#N"`.',
+    "`content.replyTo` (`{seq, sender}`) identifies the message being replied to.",
     "`hint` is present when the containing surface changes how you should act. Follow it."
   ].join(`
 `);
@@ -26860,15 +26888,15 @@ function channelTypesSection() {
     "",
     "### Text channels",
     "",
-    "- A text channel is a linear conversation. Send directly to its ref with `message send --target " + "/<server>/<channel>`.",
+    "- A text channel is a linear conversation. Send with `message send --target " + "/<server>/<channel>`.",
     "- A text-channel message may have a side thread at `/<server>/<channel>/#N`. Sending to that " + "thread ref replies inside the thread, not in the parent text channel.",
     "",
     "### Forum channels",
     "",
     "- A forum is a collection of posts, not one linear conversation.",
     "- Each top-level message in a forum is a post title. The post body is the first message in " + "that title's thread at `/<server>/<forum>/#N`.",
-    "- To participate in the discussion, reply to that thread with `message send`. Inside the " + "thread, messaging works like a normal text channel.",
-    "- To publish your own post, first send its title as a new message in the forum, then send " + "the body as the first message in the corresponding thread."
+    "- To participate in a post, use `message send --target /<server>/<forum>/#N`.",
+    "- To publish a post, use `message send --target /<server>/<forum>` for its title, then " + "`message send --target /<server>/<forum>/#N` for the body."
   ].join(`
 `);
 }
@@ -26896,13 +26924,7 @@ function utilsSection() {
     "",
     "### Join a new server",
     "",
-    `If a message contains a \`/c/invite/...\` link, just run \`${CLI} server join --invite <link>\`. ` + "The server enforces owner-only: it accepts only invites your owner created and rejects the " + "rest with a reason. Safe to attempt without reasoning about who sent it.",
-    "",
-    "### Follow up when a conversation goes quiet",
-    "",
-    `Use \`message send --remind-after <duration>\` when you send something that may need a later ` + "follow-up — for example, a question, approval request, handoff, or blocker — and silence would " + "leave the work unfinished. If no newer message appears in that channel, thread, or DM during " + "the duration, you'll receive a reminder to return and decide what to do next. Don't add it to " + "ordinary messages that need no follow-up.",
-    "",
-    `Example: ${CLI} message send --target "/demo#1234/team" --remind-after 1m --file ./message.md`
+    `If a message contains a \`/c/invite/...\` link, just run \`${CLI} server join --invite <link>\`. ` + "The server enforces owner-only: it accepts only invites your owner created and rejects the " + "rest with a reason. Safe to attempt without reasoning about who sent it."
   ].join(`
 `);
 }
@@ -26910,11 +26932,10 @@ function criticalRulesSection() {
   return [
     "## Critical rules",
     "",
-    `- **\`${CLI}\` is the only way to communicate.** Messages, files, and data reach other ` + "accounts exclusively through the CLI commands above. Do not assume local files, " + "screenshots, or workspace state are visible to anyone else — they aren't. If someone " + `needs to see something, send it via \`${CLI} message send\` or \`${CLI} message ` + "attachment upload`.",
+    `- **\`${CLI}\` is the only way to communicate.** Messages, files, and data reach other ` + "accounts exclusively through the CLI commands above. Do not assume local files, " + "screenshots, or workspace state are visible to anyone else — they aren't. If someone " + `needs to see something, share it through \`${CLI}\`, uploading a file when needed.`,
     "- **Never expose tokens, keys, or secrets.** Redact credential-like strings from tool output " + "before sharing.",
     "- **Match the sender's language.** Reply in the language they wrote in.",
-    "- **Channel alignment**: you can't send to a channel with unread messages. On a " + `"channel not aligned" error, \`${CLI} inbox pull\` to catch up and READ the new messages. ` + "Judge if your message is still needed or overlaps with what just landed. Adjust or skip; " + "don't mechanically resend.",
-    "- **Finish in-flight work before stopping.** Don't leave anything half-handled. If a message " + "hands you a lead but no explicit ask, treat the investigation as the ask."
+    "- **Channel alignment**: you can't send to a channel with unread messages. On a " + `"channel not aligned" error, \`${CLI} inbox pull\` to catch up and READ the new messages. ` + "Judge if your message is still needed or overlaps with what just landed. Adjust or skip; " + "don't mechanically resend."
   ].join(`
 `);
 }
@@ -26922,7 +26943,7 @@ function executionModelSection() {
   return [
     "## How you work — async, not turn-based",
     "",
-    "Sending a message is I/O, not a stopping point. You keep working as long as anything is " + "in flight — the thing you're actively on, a promised follow-up, an investigation you " + "started. Stop only when all of it is done.",
+    "Sending a message is I/O, not a stopping point. You keep working as long as anything is " + "in flight — the thing you're actively on, a promised follow-up, an investigation you " + "started. If a message hands you a lead but no explicit ask, treat the investigation as " + "the ask. Stop only when all of it is done.",
     "",
     "On wake, restore durable context from `memory.md` and the context timeline, then pull your inbox. " + "Follow *Outstanding work marks* below before taking new work.",
     "",
@@ -29372,6 +29393,10 @@ class MessageReminderScheduler {
   }
   arm(input) {
     const key = reminderKey(input.agentId, input.channel);
+    if (input.remindAfterMs === 0) {
+      this.clearReminder(key);
+      return { armed: false, reason: "disabled" };
+    }
     const latest = this.latestObservedSeq.get(key);
     if (latest !== undefined && latest > input.sentSeq) {
       return { armed: false, reason: "newer_message_observed" };
@@ -29599,6 +29624,78 @@ function createDaemonAgentDriverHost(ctx, onRawLine) {
   };
 }
 
+// src/daemon/daemonSelfSleep.ts
+var DAEMON_SELF_SLEEP_TIMEOUT_MS = 15 * 24 * 60 * 60 * 1000;
+var systemClock = {
+  setTimer: (callback, delayMs) => setTimeout(callback, delayMs),
+  clearTimer: (timer) => clearTimeout(timer)
+};
+
+class DaemonSelfSleepScheduler {
+  opts;
+  clock;
+  workingAgents = new Set;
+  timer = null;
+  generation = 0;
+  started = false;
+  stopped = false;
+  constructor(opts) {
+    this.opts = opts;
+    this.clock = opts.clock ?? systemClock;
+  }
+  start() {
+    if (this.started || this.stopped)
+      return;
+    this.started = true;
+    this.arm();
+  }
+  observeMessage() {
+    if (!this.started || this.stopped)
+      return;
+    this.arm();
+  }
+  observeAgentActivity(agentId, working) {
+    if (this.stopped)
+      return;
+    if (working) {
+      this.workingAgents.add(agentId);
+      if (this.started)
+        this.cancel();
+      return;
+    }
+    if (this.workingAgents.delete(agentId) && this.started && this.workingAgents.size === 0)
+      this.arm();
+  }
+  stop() {
+    if (this.stopped)
+      return;
+    this.stopped = true;
+    this.workingAgents.clear();
+    this.cancel();
+  }
+  arm() {
+    this.cancel();
+    if (this.workingAgents.size > 0)
+      return;
+    const generation = this.generation;
+    this.timer = this.clock.setTimer(() => {
+      if (this.stopped || this.generation !== generation || this.workingAgents.size > 0)
+        return;
+      this.timer = null;
+      this.generation += 1;
+      this.opts.onSleep();
+    }, DAEMON_SELF_SLEEP_TIMEOUT_MS);
+    this.timer.unref?.();
+  }
+  cancel() {
+    this.generation += 1;
+    if (!this.timer)
+      return;
+    this.clock.clearTimer(this.timer);
+    this.timer = null;
+  }
+}
+
 // src/daemon/createDaemon.ts
 var WARMUP_BACKOFF_MS = [250, 500, 1000, 2000, 4000];
 var WARMUP_CEILING_MS = 30000;
@@ -29755,6 +29852,10 @@ async function createDaemon(opts) {
   let channelRef = null;
   let managerRef = null;
   let reminderSchedulerRef = null;
+  const selfSleepScheduler = opts.onSelfSleep ? new DaemonSelfSleepScheduler({
+    onSleep: opts.onSelfSleep,
+    ...opts.selfSleepClock ? { clock: opts.selfSleepClock } : {}
+  }) : null;
   const emitBotAuditEvent = (agentId, event, context) => {
     channelRef?.reportBotAuditEvent?.({
       type: "bot_audit_event",
@@ -30048,6 +30149,7 @@ async function createDaemon(opts) {
     tickIntervalMs: opts.tickIntervalMs ?? 2000,
     onAgentSession: (info) => void channel2.reportAgentSession(info),
     onAgentActivity: (info) => {
+      selfSleepScheduler?.observeAgentActivity(info.agentId, info.state === "running");
       channel2.reportAgentActivity?.(info);
       if (info.state === "starting" || info.state === "running") {
         if (!typingHeartbeats.has(info.agentId)) {
@@ -30125,6 +30227,7 @@ async function createDaemon(opts) {
     reportDiagnosticFailure: opts.reportDiagnosticFailure
   }));
   channel2.onWakeDesiredAdvance((cmd) => {
+    selfSleepScheduler?.observeMessage();
     reminderSchedulerRef?.observe(cmd.agentId, cmd.unreadNotice.channel, cmd.unreadNotice.latestSeq);
   });
   channel2.onCommand((cmd) => {
@@ -30149,6 +30252,7 @@ async function createDaemon(opts) {
   });
   channel2.connect();
   await router.start();
+  selfSleepScheduler?.start();
   return {
     isOpen: () => channel2.status === "open",
     onOpen: (hook) => {
@@ -30158,6 +30262,7 @@ async function createDaemon(opts) {
     },
     proxyUrl: proxy.url,
     stop: async () => {
+      selfSleepScheduler?.stop();
       reminderSchedulerRef?.clearAll();
       for (const agentId of [...typingHeartbeats.keys()]) {
         emitTypingStopsAndClear(agentId);
@@ -31974,6 +32079,10 @@ async function runPreparedDaemon(prepared, opts) {
       onAuthRejected: () => {
         log2.error("machine key rejected by server — is it correct / has it expired?");
         shutdown(1);
+      },
+      onSelfSleep: () => {
+        log2.info("daemon self-sleep threshold reached");
+        shutdown(0);
       }
     });
   } catch (error51) {
@@ -32984,14 +33093,16 @@ var LOCAL_MESSAGE_REMINDER_PATH2 = "/__alook/local/message-reminder";
 var MIN_REMINDER_MS = 60000;
 var MAX_REMINDER_MS = 24 * 60 * 60000;
 function parseRemindAfter(value) {
+  if (value === "0")
+    return 0;
   const match = /^(\d+)(m|h)$/.exec(value);
   if (!match) {
-    throw new Error("message send: --remind-after must be a positive integer followed by m or h (1m..24h)");
+    throw new Error("message send: --remind-after must be 0 or a positive integer followed by m or h (1m..24h)");
   }
   const amount = Number(match[1]);
   const milliseconds = amount * (match[2] === "h" ? 60 * 60000 : 60000);
   if (!Number.isSafeInteger(milliseconds) || milliseconds < MIN_REMINDER_MS || milliseconds > MAX_REMINDER_MS) {
-    throw new Error("message send: --remind-after must be between 1m and 24h");
+    throw new Error("message send: --remind-after must be 0 or between 1m and 24h");
   }
   return milliseconds;
 }
@@ -33126,7 +33237,8 @@ async function readLiteralInput(args) {
     if (!stdin)
       throw new CliError(`${command}: stdin is unavailable`);
     if (stdin.isTTY === true) {
-      throw new CliError(`${command}: --stdin requires piped input; use ${fileOption} in an interactive terminal`);
+      const suffix = fileOption ? `; use ${fileOption} in an interactive terminal` : "";
+      throw new CliError(`${command}: --stdin requires piped input${suffix}`);
     }
     try {
       const chunks = [];
@@ -33148,7 +33260,12 @@ async function readLiteralInput(args) {
   }
   return;
 }
+var MALFORMED_ALOOK_HEREDOC_TAIL = /(^|\r?\n)(?:["']ALOOK_MESSAGE_[A-Z0-9_]+["']?|ALOOK_MESSAGE_[A-Z0-9_]+["'])(?:\r?\n)?$/;
+function stripMalformedAlookHeredocTail(input) {
+  return input.replace(MALFORMED_ALOOK_HEREDOC_TAIL, "$1");
+}
 var CLIENT_MAX_ATTACHMENT_BYTES = 26214400;
+var CLIENT_MAX_MESSAGE_BODY_BYTES = 1024;
 function contentTypeFromFilename(filename) {
   const ext = filename.slice(filename.lastIndexOf(".") + 1).toLowerCase();
   switch (ext) {
@@ -33208,24 +33325,28 @@ async function sendWithRetry(api2, req) {
 }
 async function cmdMessageSend(opts, stdin) {
   const remindAfterFlag = opts.remindAfter;
-  const remindAfterMs = remindAfterFlag === undefined ? undefined : parseRemindAfter(remindAfterFlag);
+  const remindAfterMs = parseRemindAfter(remindAfterFlag);
   const api2 = getApi();
   const agent2 = agentId(opts);
   const channel2 = opts.target;
   if (!channel2)
     throw new CliError("message send: --target <ref> is required (e.g. /demo-workspace#1234/general)");
-  const fileFlag = opts.file;
-  const text2 = await readLiteralInput({
+  const literalText = await readLiteralInput({
     command: "message send",
     stdinSelected: opts.stdin === true,
-    stdin,
-    filePath: fileFlag,
-    fileOption: "--file <path>"
+    stdin
   });
+  const text2 = stripMalformedAlookHeredocTail(literalText ?? "");
+  const textBytes = Buffer.byteLength(text2, "utf8");
+  if (textBytes > CLIENT_MAX_MESSAGE_BODY_BYTES) {
+    throw new CliError(`message send: --stdin body is ${textBytes} bytes; max ${CLIENT_MAX_MESSAGE_BODY_BYTES}. Rewrite it before retrying.
+
+${MESSAGE_SEND_STDIN_POLICY}`);
+  }
   const attachmentIds = Array.isArray(opts.attachment) ? opts.attachment : [];
-  const hasText = typeof text2 === "string" && text2.trim().length > 0;
+  const hasText = text2.trim().length > 0;
   if (!hasText && attachmentIds.length === 0) {
-    throw new CliError("message send: --stdin, --file <path>, or --attachment <id> is required");
+    throw new CliError("message send: --stdin must contain text unless --attachment <id> is present");
   }
   let replyToSeq;
   const replyFlag = opts.reply;
@@ -33251,8 +33372,6 @@ async function cmdMessageSend(opts, stdin) {
     throw new CliError(`channel not aligned: ${res.unreadCount} unread message(s) in ${channel2} (latest #${res.latestSeq}). Run \`alook inbox pull\` and READ the new messages before deciding whether to resend, adjust, or skip your message.`);
   }
   const sent = `${res.message.channel}${res.message.seq}`;
-  if (remindAfterMs === undefined)
-    return { sent };
   const seqText = res.message.seq.replace(/^#/, "");
   const sentSeq = Number(seqText);
   if (!/^\d+$/.test(seqText) || !Number.isSafeInteger(sentSeq) || sentSeq < 1) {
@@ -33586,7 +33705,7 @@ function buildProgram(stdin) {
   }).option("--agent <id>", "agent identity (or ALOOK_AGENT_ID env)");
   const message2 = program.command("message").description("message operations").exitOverride();
   message2.configureOutput({ writeOut: () => {}, writeErr: () => {} });
-  message2.command("send").description("send a message to a channel, DM, or thread").option("--target <ref>", "destination (path-style ref, e.g. /demo-workspace#1234/general)").option("--stdin", "read the literal UTF-8 message body from non-TTY stdin").option("--file <path>", "read the literal UTF-8 message body from a file").option("-a, --attachment <id>", "attach an uploaded file by id (repeatable — order = message order)", (v, prev = []) => [...prev, v], []).option("--reply <seq>", 'reply to a message by its seq in --target (e.g. "#37" or 37)').option("--remind-after <duration>", "optionally arm one local follow-up wake after 1m..24h; a newer same-scope message or daemon restart cancels it").exitOverride().configureOutput({ writeOut: () => {}, writeErr: () => {} }).action(async function() {
+  message2.command("send").description("send a message to a channel, DM, or thread").option("--target <ref>", "destination (path-style ref, e.g. /demo-workspace#1234/general)").requiredOption("--stdin", "read the required UTF-8 message body from non-TTY stdin (max 1 KiB)").option("-a, --attachment <id>", "attach an uploaded file by id (repeatable — order = message order)", (v, prev = []) => [...prev, v], []).option("--reply <seq>", 'reply to a message by its seq in --target (e.g. "#37" or 37)').requiredOption("--remind-after <0|Nm|Nh>", "required idle follow-up: 0 disables; 1m..24h arms/resets one same-scope timer; a newer message or daemon restart cancels it").exitOverride().configureOutput({ writeOut: () => {}, writeErr: () => {} }).action(async function() {
     const localOpts = this.opts();
     const globalOpts = program.opts();
     const result = await cmdMessageSend({ ...globalOpts, ...localOpts }, stdin);

package/dist/index.js

@@ -6891,6 +6891,16 @@ function runtimeModelName(config) {
 
 // src/drivers/systemPrompt.ts
 var CLI = "$ALOOK_CLI";
+var MESSAGE_SEND_STDIN_POLICY = [
+  "`--stdin` is required and limited to 1 KiB of UTF-8. Write it as social language a person " + "with ADHD can scan without effort:",
+  "",
+  "- Lead with the point, result, decision, or one concrete ask.",
+  "- Keep one message to one topic; suppress tangents and repeated recap.",
+  "- Use at most five short items when a list helps.",
+  "- Drop preambles, play-by-play, and closing pleasantries.",
+  "- Put exact plans, reviews, evidence, logs, and long technical detail in a Markdown attachment. " + "The message body carries only the short summary and next action."
+].join(`
+`);
 function identitySection(config) {
   const parts = ["## Identity", ""];
   const name = config.agentName ?? "a member of the household";
@@ -6921,9 +6931,9 @@ function cliCommandsSection() {
     "",
     "### Messaging",
     "",
-    `1. \`${CLI} inbox pull\` — fetch unread messages (advances your read waterline by default, ` + `so they won't re-pull; \`--no-ack\` to peek without advancing).`,
-    `2. \`${CLI} message send\` — send to a channel, DM, or thread. ` + `For a short body, use explicit \`--stdin\` with a quoted heredoc; for a long or complicated body, ` + `use \`--file <path>\`. Attach with \`--attachment <id>\` (repeatable, order matters). Optionally add ` + `\`--remind-after <duration>\` to be reminded if the same channel, thread, or DM receives no ` + `newer message after your send. Use a whole number of minutes or hours from \`1m\` to \`24h\`, ` + `such as \`15m\` or \`2h\`.`,
-    `3. \`${CLI} message attachment upload --target <ref> --file <path>\` — upload a file; ` + `returns an id stable across pending→persisted. Feed it into ` + `\`message send --attachment <id>\`.`,
+    `1. \`${CLI} inbox pull\` — fetch unread messages; \`--no-ack\` peeks without advancing.`,
+    `2. \`${CLI} message send --target <ref> --remind-after <0|Nm|Nh> --stdin\` — send to a ` + `channel, DM, or thread. ` + `The body is required through \`--stdin\` and limited to 1 KiB of UTF-8. ` + `Attach uploaded files with \`--attachment <id>\` (repeatable, order matters). ` + `\`--remind-after\` accepts \`0\`, or a whole-number duration from \`1m\` to \`24h\`.`,
+    `3. \`${CLI} message attachment upload --target <ref> --file <path>\` — upload a file; ` + `returns an id stable across pending→persisted.`,
     `4. \`${CLI} message attachment download --id <id> [--out <path>]\` — download any ` + `attachment you can see (or your own pending uploads).`,
     `5. \`${CLI} message emoji --target <ref> --emoji <e>\` — react with a single emoji. ` + `Works on channel messages (\`/<server>/<channel>#N\`), DM messages ` + `(\`/.dm/<peer>#N\`), and thread-reply messages (\`/<server>/<channel>/#N#M\`).`,
     `6. \`${CLI} message mark set --target <full-message-ref>\` — persist a message as outstanding work.`,
@@ -6953,7 +6963,7 @@ function cliCommandsSection() {
     "",
     "### Context Lifecycle",
     "",
-    `1. \`${CLI} nap --handoff <file>\` — reset your current session and ` + `start fresh. The required handoff is injected into the new session so your future self can ` + `quickly pick up unfinished work. Never nap on your own; only do it when someone explicitly asks.`,
+    `1. \`${CLI} nap --handoff <file>\` — reset the current session from a required handoff file.`,
     "",
     "### Output format",
     "",
@@ -6969,14 +6979,29 @@ function messagingSection() {
     "",
     "### Sending & receiving",
     "",
-    "You can initiate conversations — send to any channel or DM someone directly. You're not " + "limited to replying. Use the same `message send` command whether you're replying or " + "starting a conversation.",
+    "You can initiate conversations — send to any channel or DM someone directly. You're not " + "limited to replying; the same sending rules apply either way.",
+    "",
+    "#### Message body",
+    "",
+    MESSAGE_SEND_STDIN_POLICY,
+    "",
+    "#### Follow up when a conversation goes quiet",
+    "",
+    "`--remind-after T` is required on every send and controls whether a local follow-up is " + "armed for the same channel, thread, or DM.",
     "",
-    "- Reply where the message came from. Post results in the channel that owns the topic. " + "When uncertain, read history (below) or DM the relevant people.",
-    "Free-form message bodies never go in command arguments.",
+    "- Use `1m` to `24h` when silence would leave work unfinished — for example, after a question, " + "approval request, handoff, or blocker. If no newer message arrives by T, you will be reminded " + "to return; a newer message or daemon restart cancels the timer.",
+    "- Use `0` only when no later action depends on a reply. It disables the timer.",
     "",
-    `- Short reply: use \`${CLI} message send --target <ref> --stdin\` with the quoted-heredoc form shown ` + "under *Message formatting*. Choose a fresh quoted delimiter that does not occur as a standalone line in the body.",
-    `- Long or complicated: write the body to a temporary file with a filesystem tool, then ` + `\`${CLI} message send --target <ref> --file ./temp_msg.md\`.`,
-    `- Cite a specific message: add \`--reply "#37"\` to either form — \`--reply\` takes the \`#N\` seq ` + "(within `--target`) of the message you're answering.",
+    "Example: `--remind-after 5m` asks for a follow-up after five quiet minutes.",
+    "",
+    "#### Sending mechanics",
+    "",
+    `- Send body: use \`${CLI} message send --target <ref> --remind-after T --stdin\` with the ` + "quoted-heredoc form under *Message formatting*.",
+    `- Long detail: upload it with \`${CLI} message attachment upload --target <ref> --file <path>.md\`; ` + "add the returned id as `--attachment <id>` on the short stdin send.",
+    `- Cite a specific message: add \`--reply "#37"\` — \`--reply\` takes the \`#N\` seq ` + "(within `--target`) of the message you're answering.",
+    "",
+    "Reply where the message came from. Post results in the channel that owns the topic. " + "When uncertain, read history (below) or DM the relevant people.",
+    "Write every message body in the stdin/heredoc block; never place it directly on the command line.",
     "",
     "### Context refs",
     "",
@@ -7010,14 +7035,14 @@ function messagingSection() {
     "",
     "### Message formatting",
     "",
-    "Alook renders specially formatted plain-text refs and mentions in message bodies. Write them " + "as plain text, not inside backticks.",
+    "Alook specially renders refs and mentions in message bodies. Write them as plain text, not " + "inside backticks.",
     "",
-    "- **Context refs** — use `/<server>/<channel>` for a channel, `/<server>/<channel>#N` for " + "a message, and `/<server>/<channel>/#N#M` for a thread reply; DMs use `/.dm/<peer>` and " + "`/.dm/<peer>#N`. Refs make context clickable across conversations, so use the full path " + "rather than a bare `#N`. Never paste a private DM ref into a server channel.",
+    "- **Context refs** — write the full refs from *Context refs* above so they stay " + "clickable. Never paste a private DM ref into a server channel.",
     "- **Mentions** — `@name#NNNN` calls that person's attention specifically. In a private " + "channel, first verify they " + `are a member with \`${CLI} channel member --channel <ref>\` before mentioning them.`,
     "",
     "```bash",
     "# Choose a fresh quoted delimiter that does not occur as a standalone line in the body.",
-    `${CLI} message send --target "/demo#1234/general" --stdin <<'ALOOK_MESSAGE_7F3C'`,
+    `${CLI} message send --target "/demo#1234/general" --remind-after 5m --stdin <<'ALOOK_MESSAGE_7F3C'`,
     "@alice#0001 Please review /demo#1234/general#42",
     "ALOOK_MESSAGE_7F3C",
     "```",
@@ -7030,7 +7055,7 @@ function messagingSection() {
     "```",
     "",
     "`channel` is the reply ref. `seq` (`#N`) identifies the message within its channel — " + "combine into `/<server>/<channel>/#N` for an in-thread reply.",
-    "`content.replyTo` (`{seq, sender}`) is present when a message replies to another — cite it " + 'back with `--reply "#N"`.',
+    "`content.replyTo` (`{seq, sender}`) identifies the message being replied to.",
     "`hint` is present when the containing surface changes how you should act. Follow it."
   ].join(`
 `);
@@ -7043,15 +7068,15 @@ function channelTypesSection() {
     "",
     "### Text channels",
     "",
-    "- A text channel is a linear conversation. Send directly to its ref with `message send --target " + "/<server>/<channel>`.",
+    "- A text channel is a linear conversation. Send with `message send --target " + "/<server>/<channel>`.",
     "- A text-channel message may have a side thread at `/<server>/<channel>/#N`. Sending to that " + "thread ref replies inside the thread, not in the parent text channel.",
     "",
     "### Forum channels",
     "",
     "- A forum is a collection of posts, not one linear conversation.",
     "- Each top-level message in a forum is a post title. The post body is the first message in " + "that title's thread at `/<server>/<forum>/#N`.",
-    "- To participate in the discussion, reply to that thread with `message send`. Inside the " + "thread, messaging works like a normal text channel.",
-    "- To publish your own post, first send its title as a new message in the forum, then send " + "the body as the first message in the corresponding thread."
+    "- To participate in a post, use `message send --target /<server>/<forum>/#N`.",
+    "- To publish a post, use `message send --target /<server>/<forum>` for its title, then " + "`message send --target /<server>/<forum>/#N` for the body."
   ].join(`
 `);
 }
@@ -7079,13 +7104,7 @@ function utilsSection() {
     "",
     "### Join a new server",
     "",
-    `If a message contains a \`/c/invite/...\` link, just run \`${CLI} server join --invite <link>\`. ` + "The server enforces owner-only: it accepts only invites your owner created and rejects the " + "rest with a reason. Safe to attempt without reasoning about who sent it.",
-    "",
-    "### Follow up when a conversation goes quiet",
-    "",
-    `Use \`message send --remind-after <duration>\` when you send something that may need a later ` + "follow-up — for example, a question, approval request, handoff, or blocker — and silence would " + "leave the work unfinished. If no newer message appears in that channel, thread, or DM during " + "the duration, you'll receive a reminder to return and decide what to do next. Don't add it to " + "ordinary messages that need no follow-up.",
-    "",
-    `Example: ${CLI} message send --target "/demo#1234/team" --remind-after 1m --file ./message.md`
+    `If a message contains a \`/c/invite/...\` link, just run \`${CLI} server join --invite <link>\`. ` + "The server enforces owner-only: it accepts only invites your owner created and rejects the " + "rest with a reason. Safe to attempt without reasoning about who sent it."
   ].join(`
 `);
 }
@@ -7093,11 +7112,10 @@ function criticalRulesSection() {
   return [
     "## Critical rules",
     "",
-    `- **\`${CLI}\` is the only way to communicate.** Messages, files, and data reach other ` + "accounts exclusively through the CLI commands above. Do not assume local files, " + "screenshots, or workspace state are visible to anyone else — they aren't. If someone " + `needs to see something, send it via \`${CLI} message send\` or \`${CLI} message ` + "attachment upload`.",
+    `- **\`${CLI}\` is the only way to communicate.** Messages, files, and data reach other ` + "accounts exclusively through the CLI commands above. Do not assume local files, " + "screenshots, or workspace state are visible to anyone else — they aren't. If someone " + `needs to see something, share it through \`${CLI}\`, uploading a file when needed.`,
     "- **Never expose tokens, keys, or secrets.** Redact credential-like strings from tool output " + "before sharing.",
     "- **Match the sender's language.** Reply in the language they wrote in.",
-    "- **Channel alignment**: you can't send to a channel with unread messages. On a " + `"channel not aligned" error, \`${CLI} inbox pull\` to catch up and READ the new messages. ` + "Judge if your message is still needed or overlaps with what just landed. Adjust or skip; " + "don't mechanically resend.",
-    "- **Finish in-flight work before stopping.** Don't leave anything half-handled. If a message " + "hands you a lead but no explicit ask, treat the investigation as the ask."
+    "- **Channel alignment**: you can't send to a channel with unread messages. On a " + `"channel not aligned" error, \`${CLI} inbox pull\` to catch up and READ the new messages. ` + "Judge if your message is still needed or overlaps with what just landed. Adjust or skip; " + "don't mechanically resend."
   ].join(`
 `);
 }
@@ -7105,7 +7123,7 @@ function executionModelSection() {
   return [
     "## How you work — async, not turn-based",
     "",
-    "Sending a message is I/O, not a stopping point. You keep working as long as anything is " + "in flight — the thing you're actively on, a promised follow-up, an investigation you " + "started. Stop only when all of it is done.",
+    "Sending a message is I/O, not a stopping point. You keep working as long as anything is " + "in flight — the thing you're actively on, a promised follow-up, an investigation you " + "started. If a message hands you a lead but no explicit ask, treat the investigation as " + "the ask. Stop only when all of it is done.",
     "",
     "On wake, restore durable context from `memory.md` and the context timeline, then pull your inbox. " + "Follow *Outstanding work marks* below before taking new work.",
     "",
@@ -25792,7 +25810,7 @@ function parseLocalMessageReminderBody(body, agentId) {
     return null;
   if (!Number.isSafeInteger(record4.sentSeq) || record4.sentSeq < 1)
     return null;
-  if (!Number.isSafeInteger(record4.remindAfterMs) || record4.remindAfterMs < LOCAL_MESSAGE_REMINDER_MIN_MS || record4.remindAfterMs > LOCAL_MESSAGE_REMINDER_MAX_MS)
+  if (!Number.isSafeInteger(record4.remindAfterMs) || record4.remindAfterMs !== 0 && record4.remindAfterMs < LOCAL_MESSAGE_REMINDER_MIN_MS || record4.remindAfterMs > LOCAL_MESSAGE_REMINDER_MAX_MS)
     return null;
   return {
     agentId,
@@ -27630,6 +27648,10 @@ class MessageReminderScheduler {
   }
   arm(input) {
     const key = reminderKey(input.agentId, input.channel);
+    if (input.remindAfterMs === 0) {
+      this.clearReminder(key);
+      return { armed: false, reason: "disabled" };
+    }
     const latest = this.latestObservedSeq.get(key);
     if (latest !== undefined && latest > input.sentSeq) {
       return { armed: false, reason: "newer_message_observed" };
@@ -27857,6 +27879,78 @@ function createDaemonAgentDriverHost(ctx, onRawLine) {
   };
 }
 
+// src/daemon/daemonSelfSleep.ts
+var DAEMON_SELF_SLEEP_TIMEOUT_MS = 15 * 24 * 60 * 60 * 1000;
+var systemClock = {
+  setTimer: (callback, delayMs) => setTimeout(callback, delayMs),
+  clearTimer: (timer) => clearTimeout(timer)
+};
+
+class DaemonSelfSleepScheduler {
+  opts;
+  clock;
+  workingAgents = new Set;
+  timer = null;
+  generation = 0;
+  started = false;
+  stopped = false;
+  constructor(opts) {
+    this.opts = opts;
+    this.clock = opts.clock ?? systemClock;
+  }
+  start() {
+    if (this.started || this.stopped)
+      return;
+    this.started = true;
+    this.arm();
+  }
+  observeMessage() {
+    if (!this.started || this.stopped)
+      return;
+    this.arm();
+  }
+  observeAgentActivity(agentId, working) {
+    if (this.stopped)
+      return;
+    if (working) {
+      this.workingAgents.add(agentId);
+      if (this.started)
+        this.cancel();
+      return;
+    }
+    if (this.workingAgents.delete(agentId) && this.started && this.workingAgents.size === 0)
+      this.arm();
+  }
+  stop() {
+    if (this.stopped)
+      return;
+    this.stopped = true;
+    this.workingAgents.clear();
+    this.cancel();
+  }
+  arm() {
+    this.cancel();
+    if (this.workingAgents.size > 0)
+      return;
+    const generation = this.generation;
+    this.timer = this.clock.setTimer(() => {
+      if (this.stopped || this.generation !== generation || this.workingAgents.size > 0)
+        return;
+      this.timer = null;
+      this.generation += 1;
+      this.opts.onSleep();
+    }, DAEMON_SELF_SLEEP_TIMEOUT_MS);
+    this.timer.unref?.();
+  }
+  cancel() {
+    this.generation += 1;
+    if (!this.timer)
+      return;
+    this.clock.clearTimer(this.timer);
+    this.timer = null;
+  }
+}
+
 // src/daemon/createDaemon.ts
 var WARMUP_BACKOFF_MS = [250, 500, 1000, 2000, 4000];
 var WARMUP_CEILING_MS = 30000;
@@ -28013,6 +28107,10 @@ async function createDaemon(opts) {
   let channelRef = null;
   let managerRef = null;
   let reminderSchedulerRef = null;
+  const selfSleepScheduler = opts.onSelfSleep ? new DaemonSelfSleepScheduler({
+    onSleep: opts.onSelfSleep,
+    ...opts.selfSleepClock ? { clock: opts.selfSleepClock } : {}
+  }) : null;
   const emitBotAuditEvent = (agentId, event, context) => {
     channelRef?.reportBotAuditEvent?.({
       type: "bot_audit_event",
@@ -28306,6 +28404,7 @@ async function createDaemon(opts) {
     tickIntervalMs: opts.tickIntervalMs ?? 2000,
     onAgentSession: (info) => void channel2.reportAgentSession(info),
     onAgentActivity: (info) => {
+      selfSleepScheduler?.observeAgentActivity(info.agentId, info.state === "running");
       channel2.reportAgentActivity?.(info);
       if (info.state === "starting" || info.state === "running") {
         if (!typingHeartbeats.has(info.agentId)) {
@@ -28383,6 +28482,7 @@ async function createDaemon(opts) {
     reportDiagnosticFailure: opts.reportDiagnosticFailure
   }));
   channel2.onWakeDesiredAdvance((cmd) => {
+    selfSleepScheduler?.observeMessage();
     reminderSchedulerRef?.observe(cmd.agentId, cmd.unreadNotice.channel, cmd.unreadNotice.latestSeq);
   });
   channel2.onCommand((cmd) => {
@@ -28407,6 +28507,7 @@ async function createDaemon(opts) {
   });
   channel2.connect();
   await router.start();
+  selfSleepScheduler?.start();
   return {
     isOpen: () => channel2.status === "open",
     onOpen: (hook) => {
@@ -28416,6 +28517,7 @@ async function createDaemon(opts) {
     },
     proxyUrl: proxy.url,
     stop: async () => {
+      selfSleepScheduler?.stop();
       reminderSchedulerRef?.clearAll();
       for (const agentId of [...typingHeartbeats.keys()]) {
         emitTypingStopsAndClear(agentId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alook/daemon",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Alook agent daemon — host-side runtime backend, process manager, credential proxy, and control plane.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/alookai/alook#readme",