@fancyboi999/open-tag-daemon 0.6.0 → 0.7.0

package/dist/agent-cli.mjs

@@ -3079,8 +3079,9 @@ function createLogger(component) {
     }
     const extra = fields && Object.keys(fields).length ? " " + safeJson(fields) : "";
     const line = `${rec.t} ${level.toUpperCase().padEnd(5)} [${component}] ${msg}${extra}`;
+    const stream = consoleStream(component, level);
     try {
-      process.stderr.write(line + "\n");
+      stream.write(line + "\n");
     } catch {
     }
   }
@@ -3092,6 +3093,10 @@ function createLogger(component) {
     child: (sub) => createLogger(`${component}:${sub}`)
   };
 }
+function consoleStream(component, level) {
+  if (level === "error" || component === "cli" || component.startsWith("cli:")) return process.stderr;
+  return process.stdout;
+}
 function safeJson(o) {
   try {
     return JSON.stringify(o, (_k, v) => typeof v === "string" && v.length > 300 ? v.slice(0, 300) + "\u2026" : v);
@@ -3151,7 +3156,7 @@ message.command("check").description("non-blocking check for new messages").acti
   for (const m of d.messages) console.log(m.text);
   console.log("No more new messages.");
 });
-message.command("send").description("send a message (body read from stdin); if new messages arrived since last read the message is freshness-held as a draft \u2014 revise it or use --send-draft to submit as-is").requiredOption("--target <target>", "#channel / dm:@name / #channel:shortid").option("--attach <ids>", "attachment ids, comma-separated").option("--send-draft", "submit the held draft as-is, bypassing freshness check").action(async (opts) => {
+message.command("send").description("send a message (body read from stdin); if new messages arrived since last read the message is freshness-held as a draft \u2014 revise it or use --send-draft to submit as-is").requiredOption("--target <target>", "#channel / dm:@name / #channel:shortid / thread:shortid").option("--attach <ids>", "attachment ids, comma-separated").option("--send-draft", "submit the held draft as-is, bypassing freshness check").action(async (opts) => {
   const sendDraft = !!opts.sendDraft;
   const content = sendDraft ? "" : (await readStdin()).trim();
   const attachmentIds = opts.attach ? String(opts.attach).split(",").map((s) => s.trim()).filter(Boolean) : [];
@@ -3227,6 +3232,16 @@ task.command("update").description("update task status (--message-id, or --chann
   await api("POST", "/agent-api/task/update", body);
   console.log(`Updated -> ${opts.status}`);
 });
+task.command("assign").description("hand off a task to another agent (--message-id, or --channel #ch --number N)").option("--message-id <id>").option("--channel <ch>", "#name / dm:@name (used with --number)").option("--number <n>", "task number #N").requiredOption("--to <agent>", "@agent handle").action(async (opts) => {
+  const body = { to: opts.to };
+  if (opts.number != null) {
+    body.channel = opts.channel;
+    body.number = Number(opts.number);
+  } else body.messageId = opts.messageId;
+  const d = await api("POST", "/agent-api/task/assign", body);
+  console.log(`Assigned task #${d.number ?? "?"} -> @${d.to}`);
+  if (d.followUp) console.log(d.followUp);
+});
 var taskCreate = async (opts) => {
   const d = await api("POST", "/agent-api/task/new", { target: opts.channel, title: opts.title });
   for (const t of d.tasks ?? []) console.log(`Created task #${t.number ?? "-"} ${String(t.id).slice(0, 8)}: ${t.content}`);
@@ -3251,7 +3266,7 @@ thread.command("reply").description("start or reply to a thread under a message
   const d = await api("POST", "/agent-api/thread/reply", { parent: opts.parent, channel: opts.channel, content });
   console.log(`Replied in thread (thread ${String(d.threadChannelId).slice(0, 8)}, msg ${String(d.id).slice(0, 8)})`);
 });
-thread.command("unfollow").description("stop receiving deliveries from a thread").requiredOption("--target <thread>", "#channel:shortid").action(async (opts) => {
+thread.command("unfollow").description("stop receiving deliveries from a thread").requiredOption("--target <thread>", "#channel:shortid or thread:shortid").action(async (opts) => {
   await api("POST", "/agent-api/thread/unfollow", { target: opts.target });
   console.log(`Unfollowed ${opts.target}`);
 });

package/dist/cli.mjs

@@ -3770,8 +3770,9 @@ function createLogger(component) {
     }
     const extra = fields && Object.keys(fields).length ? " " + safeJson(fields) : "";
     const line = `${rec.t} ${level.toUpperCase().padEnd(5)} [${component}] ${msg}${extra}`;
+    const stream = consoleStream(component, level);
     try {
-      process.stderr.write(line + "\n");
+      stream.write(line + "\n");
     } catch {
     }
   }
@@ -3783,6 +3784,10 @@ function createLogger(component) {
     child: (sub) => createLogger(`${component}:${sub}`)
   };
 }
+function consoleStream(component, level) {
+  if (level === "error" || component === "cli" || component.startsWith("cli:")) return process.stderr;
+  return process.stdout;
+}
 function safeJson(o) {
   try {
     return JSON.stringify(o, (_k, v) => typeof v === "string" && v.length > 300 ? v.slice(0, 300) + "\u2026" : v);
@@ -3797,6 +3802,7 @@ var MACHINE_REJECTED_CODE = 4001;
 // src/daemon/connection.ts
 var INITIAL_BACKOFF_MS = 1e3;
 var MAX_BACKOFF_MS = 3e4;
+var SERVER_STALE_MS = Number(process.env.OPEN_TAG_DAEMON_SERVER_STALE_MS ?? 9e4);
 var Connection = class {
   constructor(url, key, onMsg, onOpen, mkWs = (u) => new wrapper_default(u)) {
     this.url = url;
@@ -3813,9 +3819,11 @@ var Connection = class {
   ws = null;
   delay = INITIAL_BACKOFF_MS;
   timer = null;
+  watchdog = null;
   should = true;
   accepted = false;
   // per-attempt: flips true once the server sends any frame (proof it accepted us, not rejected)
+  lastServerFrameAt = 0;
   log = createLogger("daemon:conn");
   connect() {
     this.should = true;
@@ -3827,13 +3835,22 @@ var Connection = class {
   close() {
     this.should = false;
     if (this.timer) clearTimeout(this.timer);
+    if (this.watchdog) {
+      clearTimeout(this.watchdog);
+      this.watchdog = null;
+    }
     this.ws?.close();
   }
   doConnect() {
     if (!this.should) return;
     const wsUrl = this.url.replace(/^http/, "ws") + `/daemon/connect?key=${encodeURIComponent(this.key)}`;
     this.log.info("connecting", { url: this.url });
+    if (this.watchdog) {
+      clearTimeout(this.watchdog);
+      this.watchdog = null;
+    }
     this.accepted = false;
+    this.lastServerFrameAt = 0;
     this.ws = this.mkWs(wsUrl);
     this.ws.on("open", () => {
       this.log.info("connected");
@@ -3844,6 +3861,8 @@ var Connection = class {
         this.accepted = true;
         this.delay = INITIAL_BACKOFF_MS;
       }
+      this.lastServerFrameAt = Date.now();
+      this.armWatchdog();
       let m;
       try {
         m = JSON.parse(d.toString());
@@ -3853,6 +3872,10 @@ var Connection = class {
       this.onMsg(m);
     });
     this.ws.on("close", (code, reason) => {
+      if (this.watchdog) {
+        clearTimeout(this.watchdog);
+        this.watchdog = null;
+      }
       if (code === MACHINE_REJECTED_CODE) {
         this.delay = MAX_BACKOFF_MS;
         this.log.error(
@@ -3866,6 +3889,18 @@ var Connection = class {
     });
     this.ws.on("error", (e) => this.log.error("ws error", { detail: String(e?.message ?? e) }));
   }
+  armWatchdog() {
+    if (this.watchdog) clearTimeout(this.watchdog);
+    this.watchdog = setTimeout(() => {
+      if (!this.accepted || !this.lastServerFrameAt || this.ws?.readyState !== wrapper_default.OPEN) return;
+      this.log.warn("server heartbeat stale; closing socket to reconnect", { staleMs: Date.now() - this.lastServerFrameAt });
+      try {
+        this.ws.close();
+      } catch {
+      }
+    }, SERVER_STALE_MS + 1);
+    this.watchdog.unref?.();
+  }
   scheduleReconnect() {
     if (!this.should || this.timer) return;
     this.log.info("reconnecting", { ms: this.delay });
@@ -3902,8 +3937,8 @@ A local \`open-tag\` command is on your PATH. Use ONLY it to communicate, via yo
 - \`open-tag message read --channel <t> [--limit N]\` \u2014 read history.
 - \`open-tag server info\` \u2014 list channels / agents / humans.
 - \`open-tag channel join --target "#name"\` \u2014 join a public channel.
-- \`open-tag task list --channel <t>\` \xB7 \`open-tag task claim --message-id <id>\` \xB7 \`open-tag task update --message-id <id> --status <todo|in_progress|in_review|done>\` \xB7 \`open-tag task create --channel <t> --title <t>\`(delegate a task)
-- **Threads (no dedicated thread command \u2014 use message send/read with a thread-suffix target)**: reply to / open a thread = \`open-tag message send --target "#channel:shortid"\` (suffix shortid = the 8-char short id from the \`msg=\` field in the message header; if it does not exist, a thread is created automatically); read a thread = \`open-tag message read --channel "#channel:shortid"\`; stop receiving deliveries for a thread = \`open-tag thread unfollow --target "#channel:shortid"\` (only when work in that thread is clearly done or irrelevant). Threads cannot be nested.
+- \`open-tag task list --channel <t>\` \xB7 \`open-tag task claim --message-id <id>\` \xB7 \`open-tag task assign --message-id <id> --to @agent\`(handoff to another agent) \xB7 \`open-tag task update --message-id <id> --status <todo|in_progress|in_review|done>\` \xB7 \`open-tag task create --channel <t> --title <t>\`(delegate a task)
+- **Threads (no dedicated thread command \u2014 use a thread target)**: reply to / open a thread = \`open-tag message send --target "#channel:shortid"\` or the stable \`thread:shortid\` form (where \`shortid\` is the 8-char parent message id from the message header; if the thread does not exist yet, the target creates it automatically when the parent channel is accessible); read a thread = \`open-tag message read --channel "thread:shortid"\`; stop receiving deliveries for a thread = \`open-tag thread unfollow --target "thread:shortid"\` (or the older \`#channel:shortid\` form) when work there is clearly done or irrelevant. Threads cannot be nested.
 - \`open-tag message react --message-id <id> --emoji <e> [--remove]\`(emoji reaction) \xB7 \`open-tag message search --query <q>\`(search channels you are in)
 - \`open-tag attachment upload --file <path> --channel <t>\`(upload a file, returns an id; then use \`message send --attach <id>\`) \xB7 \`open-tag attachment view --id <id>\`(downloads the attachment to the local \`attachments/\` directory and prints its local path for inspection \u2014 this command only handles the download and path; how you open it is up to your local tools)
 - \`open-tag message resolve --id <id>\`(verify that a cited message id is real \u2014 always resolve before referencing, never invent ids from memory) \xB7 \`open-tag channel members --channel <t>\` \xB7 \`open-tag channel leave --target "#name"\` \xB7 \`open-tag task unclaim --message-id <id>\`
@@ -3911,7 +3946,7 @@ A local \`open-tag\` command is on your PATH. Use ONLY it to communicate, via yo
 - \`open-tag reminder schedule --content <t> --in <seconds> [--anchor <msgId>] [--recurring <seconds>]\`(schedule a future wakeup for yourself \u2014 at the scheduled time the system will @-mention you to wake you up) \xB7 \`open-tag reminder list/cancel/snooze\`. For anything that depends on a future state, use a reminder instead of busy-waiting.
 - \`open-tag action prepare --target <t>\` \u2014 prepare an action card for a human to commit (B-mode quick-commit). You do NOT have permission to create channels/agents yourself; instead pipe the action JSON on STDIN and post a card the human clicks to execute under their own identity. Variants: \`channel:create\` (\`{"type":"channel:create","name":"x","description":"...","visibility":"public"}\`), \`agent:create\` (\`{"type":"agent:create","name":"y","description":"..."}\`). Use when a human asks you to set up a channel/agent \u2014 propose it as a card, don't ask them to do it manually.
 
-Targets: \`#channel\`, \`dm:@name\`, thread \`#channel:shortid\`. Send the body via stdin heredoc:
+Targets: \`#channel\`, \`dm:@name\`, thread \`#channel:shortid\` or \`thread:shortid\`. Prefer \`thread:shortid\` when reusing a thread target across different agents, private channels, or DMs because it is stable across actor viewpoints. Send the body via stdin heredoc:
 \`\`\`bash
 open-tag message send --target "#all" <<'MSG'
 Your reply. Quotes, $vars, \`backticks\`, code blocks are all safe here.
@@ -3923,11 +3958,11 @@ FRESHNESS HOLD (collaboration safety): if new messages arrived in that target si
 
 ## Received message format
 \`[target=<id> msg=<shortid> time=<iso> type=human|agent|system] @sender: content\`
-Reuse the \`target=\` value when replying so it lands in the right channel/DM/thread. @mention people by their @handle. \`msg=\` is the 8-char short id \u2014 use it as a thread suffix (\`#channel:shortid\`) to start/reply in a thread, and pass it to \`open-tag message resolve\` to verify a cited id is real. \`type=system\` messages announce state changes (task events, reminders) \u2014 don't reply unless they clearly ask you to act.
+Reuse the \`target=\` value when replying so it lands in the right channel/DM/thread. @mention people by their @handle. \`msg=\` is the 8-char short id \u2014 use it as a thread suffix (\`#channel:shortid\`) or as the stable form \`thread:shortid\` to start/reply in a thread, and pass it to \`open-tag message resolve\` to verify a cited id is real. \`type=system\` messages announce state changes (task events, reminders) \u2014 don't reply unless they clearly ask you to act.
 
 ### Formatting \u2014 so refs/links render
 open-tag auto-renders these **bare-text** tokens into clickable refs; write them as plain words, NOT wrapped in backticks (code spans are literal, won't render):
-- \`@handle\` \u2192 user/agent \xB7 \`#channel\` \u2192 channel \xB7 \`#channel:shortid\` \u2192 thread \xB7 \`task #N\` \u2192 task (write "task #N", not bare "#N").
+- \`@handle\` \u2192 user/agent \xB7 \`#channel\` \u2192 channel \xB7 \`#channel:shortid\` or \`thread:shortid\` \u2192 thread \xB7 \`task #N\` \u2192 task (write "task #N", not bare "#N").
 - **URL next to CJK/non-ASCII punctuation**: wrap it in \`<url>\` or \`[text](url)\`, else the punctuation gets swallowed into the link. Wrong: \`env:http://x:3000,see\` \u2192 Right: \`env:<http://x:3000>,see\`.
 
 ### Citing prior discussion
@@ -5956,7 +5991,7 @@ conn = new Connection(serverUrl, apiKey, (msg) => {
     runningAgents: mgr.running(),
     hostname: os4.hostname(),
     os: `${os4.platform()} ${os4.arch()}`,
-    daemonVersion: "0.6.0",
+    daemonVersion: "0.7.0",
     machineId: readMachineId()
     // Stable identity: empty on first connection; server sends it back via ready:ack for persistence.
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fancyboi999/open-tag-daemon",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "open-tag compute-plane daemon — connect any machine to an open-tag server so its agents run there. No repo clone needed.",
   "license": "Apache-2.0",
   "type": "module",