@slock-ai/daemon 0.55.4 → 0.55.5

package/dist/{chunk-S5AEBH3V.js → chunk-NXNXMFLC.js}

@@ -1303,28 +1303,29 @@ Use the \`slock\` CLI for chat / task / attachment operations. The daemon inject
 5. **\`slock channel join\`** \u2014 Join a visible public channel. This only affects your own agent membership.
 6. **\`slock channel leave\`** \u2014 Leave a regular channel you have joined. This only affects your own agent membership.
 7. **\`slock thread unfollow\`** \u2014 Stop receiving ordinary delivery for a thread you no longer need to follow. This only affects your own agent attention state.
-8. **\`slock message read\`** \u2014 Read past messages from a channel, DM, or thread. Supports \`before\` / \`after\` pagination and \`around\` for centered context.
+8. **\`slock message read\`** \u2014 Read past messages from a channel, DM, or thread. Supports \`before\` / \`after\` anchors and \`around\` for centered context.
 9. **\`slock message search\`** \u2014 Search messages visible to you, then inspect a hit with \`slock message read\`.
-10. **\`slock message react\`** \u2014 Add or remove your reaction on a message. Use sparingly: prefer acknowledgement/follow-up signals like \u{1F440}, and do not auto-react to every merge, deploy, or task completion with celebratory emoji.
-11. **\`slock task list\`** \u2014 View a channel's task board.
-12. **\`slock task create\`** \u2014 Create new task-messages in a channel (supports batch titles; equivalent to sending a new message and publishing it as a task-message, not claiming it for yourself).
-13. **\`slock task claim\`** \u2014 Claim tasks by number or message ID (supports batch, handles conflicts).
-14. **\`slock task unclaim\`** \u2014 Release your claim on a task.
-15. **\`slock task update\`** \u2014 Change a task's status (e.g. to in_review or done).
-16. **\`slock attachment upload\`** \u2014 Upload a file to attach to a message. Uses content sniffing for image previews; pass \`--mime-type\` only when you know the exact type. Returns an attachment ID to pass to \`slock message send\`.
-17. **\`slock attachment view\`** \u2014 Download an attached file by its attachment ID so you can inspect it locally.
-18. **\`slock profile show\`** \u2014 Show your own profile, or another visible profile via \`@handle\`. Mirrors the canonical Slock profile view.
-19. **\`slock profile update\`** \u2014 Update your own profile. Supports \`--avatar-file <path>\`, \`--avatar-url pixel:random:<seed>\`, \`--display-name <name>\`, and \`--description <text>\`. Use \`--avatar-url pixel:random:<seed>\` when you want a new pixel avatar but do not have a local image file. Values must be non-empty. Provide at least one flag per call; multiple flags can be combined.
-20. **\`slock integration list\`** \u2014 List built-in Slock apps, registered third-party services, and this agent's active Slock Agent Logins.
-21. **\`slock integration login\`** \u2014 Provision or reuse this agent's login for a built-in Slock app or registered third-party service.
-22. **\`slock integration env\`** \u2014 Print per-agent local CLI environment for a manifest-backed service that requires isolated HOME/XDG state.
-23. **\`slock reminder schedule\`** \u2014 Schedule a reminder for yourself later, at a specific time, or on a recurring cadence.
-24. **\`slock reminder list\`** \u2014 List your reminders, including lifecycle history for each reminder.
-25. **\`slock reminder snooze\`** \u2014 Push a reminder later without replacing it.
-26. **\`slock reminder update\`** \u2014 Change a reminder's title, schedule, or recurrence without creating a new reminder.
-27. **\`slock reminder cancel\`** \u2014 Cancel one of your reminders by ID.
-28. **\`slock reminder log\`** \u2014 Show the event log for a reminder, including fires, dismissals, and reschedules.
-29. **\`slock action prepare\`** \u2014 Prepare an action card for a human to commit (B-mode quick-commit shortcut). Posts a card the human can click to execute the action under their own identity. Pass \`--target <ch>\` and pipe the action JSON on stdin (variants: \`channel:create\`, \`agent:create\`).
+10. **\`slock message resolve\`** \u2014 Verify that a cited message id exists exactly and print its canonical message row. Use this when checking whether a referenced id is real; \`read --around\` is for context, not proof.
+11. **\`slock message react\`** \u2014 Add or remove your reaction on a message. Use sparingly: prefer acknowledgement/follow-up signals like \u{1F440}, and do not auto-react to every merge, deploy, or task completion with celebratory emoji.
+12. **\`slock task list\`** \u2014 View a channel's task board.
+13. **\`slock task create\`** \u2014 Create new task-messages in a channel (supports batch titles; equivalent to sending a new message and publishing it as a task-message, not claiming it for yourself).
+14. **\`slock task claim\`** \u2014 Claim tasks by number or message ID (supports batch, handles conflicts).
+15. **\`slock task unclaim\`** \u2014 Release your claim on a task.
+16. **\`slock task update\`** \u2014 Change a task's status (e.g. to in_review or done).
+17. **\`slock attachment upload\`** \u2014 Upload a file to attach to a message. Uses content sniffing for image previews; pass \`--mime-type\` only when you know the exact type. Returns an attachment ID to pass to \`slock message send\`.
+18. **\`slock attachment view\`** \u2014 Download an attached file by its attachment ID so you can inspect it locally.
+19. **\`slock profile show\`** \u2014 Show your own profile, or another visible profile via \`@handle\`. Mirrors the canonical Slock profile view.
+20. **\`slock profile update\`** \u2014 Update your own profile. Supports \`--avatar-file <path>\`, \`--avatar-url pixel:random:<seed>\`, \`--display-name <name>\`, and \`--description <text>\`. Use \`--avatar-url pixel:random:<seed>\` when you want a new pixel avatar but do not have a local image file. Values must be non-empty. Provide at least one flag per call; multiple flags can be combined.
+21. **\`slock integration list\`** \u2014 List built-in Slock apps, registered third-party services, and this agent's active Slock Agent Logins.
+22. **\`slock integration login\`** \u2014 Provision or reuse this agent's login for a built-in Slock app or registered third-party service.
+23. **\`slock integration env\`** \u2014 Print per-agent local CLI environment for a manifest-backed service that requires isolated HOME/XDG state.
+24. **\`slock reminder schedule\`** \u2014 Schedule a reminder for yourself later, at a specific time, or on a recurring cadence.
+25. **\`slock reminder list\`** \u2014 List your reminders, including lifecycle history for each reminder.
+26. **\`slock reminder snooze\`** \u2014 Push a reminder later without replacing it.
+27. **\`slock reminder update\`** \u2014 Change a reminder's title, schedule, or recurrence without creating a new reminder.
+28. **\`slock reminder cancel\`** \u2014 Cancel one of your reminders by ID.
+29. **\`slock reminder log\`** \u2014 Show the event log for a reminder, including fires, dismissals, and reschedules.
+30. **\`slock action prepare\`** \u2014 Prepare an action card for a human to commit (B-mode quick-commit shortcut). Posts a card the human can click to execute the action under their own identity. Pass \`--target <ch>\` and pipe the action JSON on stdin (variants: \`channel:create\`, \`agent:create\`).
 
 The CLI prints human-readable canonical text on success (matching the format you see in received messages and history). On failure it prints JSON to stderr:
 - failure \u2192 stderr \`{"ok":false,"code":"...","message":"..."}\` with non-zero exit
@@ -1437,7 +1438,9 @@ If a built-in Slock app or registered third-party service requires login, use Sl
 
 \`slock message read --channel "#channel-name"\` or \`slock message read --channel dm:@peer-name\` or \`slock message read --channel "#channel:shortid"\`
 
-To jump directly to a specific hit with nearby context, use \`slock message read --channel "..." --around "messageId"\` or \`slock message read --channel "..." --around 12345\`.` : `### Reading history
+To jump directly to a specific hit with nearby context, use \`slock message read --channel "..." --around "messageId"\` or \`slock message read --channel "..." --around 12345\`.
+
+When verifying a cited message id, use \`slock message resolve <id>\`. It is exact-only and fails closed for missing or ambiguous ids; \`read --around\` is only a context-navigation command.` : `### Reading history
 
 Use ${readCmd} with the \`channel\` parameter set to \`"#channel-name"\`, \`"dm:@peer-name"\`, or a thread target like \`"#channel:shortid"\`.
 
@@ -2349,6 +2352,7 @@ function routeFamilyForPath(pathname) {
   if (pathname === "/internal/agent-api/tasks/update-status") return "tasks/update";
   if (pathname === "/internal/agent-api/tasks" || pathname.startsWith("/internal/agent-api/tasks/")) return "tasks";
   if (pathname.startsWith("/internal/agent-api/attachments/")) return "agent-api/attachments";
+  if (/^\/internal\/agent-api\/messages\/[^/]+\/resolve$/.test(pathname)) return "agent-api/messages/resolve";
   if (/^\/internal\/agent-api\/messages\/[^/]+\/reactions$/.test(pathname)) return "agent-api/messages/reactions";
   if (pathname === "/internal/agent-api/server") return "server";
   if (pathname.startsWith("/internal/agent-api/history")) return "agent-api/events";
@@ -2769,7 +2773,7 @@ function shouldBufferJsonResponse(upstream, pathname, registration) {
   if (!registration.inboxCoordinator) return false;
   const contentType = upstream.headers.get("content-type") ?? "";
   if (!contentType.includes("application/json")) return false;
-  return pathname === "/internal/agent-api/send" || pathname === "/internal/agent-api/events" || pathname === "/internal/agent-api/history";
+  return pathname === "/internal/agent-api/send" || pathname === "/internal/agent-api/events" || pathname === "/internal/agent-api/history" || /^\/internal\/agent-api\/messages\/[^/]+\/resolve$/.test(pathname);
 }
 function consumeVisibleResponse(registration, targetUrl, sendTarget, responseText) {
   const coordinator = registration.inboxCoordinator;

package/dist/cli/index.js

@@ -294,6 +294,10 @@ var ApiClient = class {
     if (suffix === "/send") return "/internal/agent-api/send";
     if (suffix.startsWith("/history")) return `/internal/agent-api/history${suffix.slice("/history".length)}`;
     if (suffix.startsWith("/search")) return `/internal/agent-api/search${suffix.slice("/search".length)}`;
+    const messageResolve = /^\/messages\/([^/]+)\/resolve$/.exec(suffix);
+    if (messageResolve) {
+      return `/internal/agent-api/messages/${messageResolve[1]}/resolve`;
+    }
     if (suffix.startsWith("/channel-members")) return `/internal/agent-api/channel-members${suffix.slice("/channel-members".length)}`;
     if (suffix === "/knowledge" || suffix.startsWith("/knowledge?")) {
       return `/internal/agent-api/knowledge${suffix.slice("/knowledge".length)}`;
@@ -16463,6 +16467,32 @@ function buildReadPath(agentId, opts) {
   if (opts.limit !== void 0) params.set("limit", String(opts.limit));
   return `/internal/agent/${encodeURIComponent(agentId)}/history?${params.toString()}`;
 }
+function mapReadFailure(res) {
+  if (res.errorCode === "NOT_FOUND") {
+    return new CliError({
+      code: "NOT_FOUND",
+      message: res.error ?? `HTTP ${res.status}`,
+      suggestedNextAction: res.suggestedNextAction ?? void 0
+    });
+  }
+  if (res.errorCode === "AMBIGUOUS_ID") {
+    return new CliError({
+      code: "AMBIGUOUS_ID",
+      message: res.error ?? `HTTP ${res.status}`,
+      suggestedNextAction: res.suggestedNextAction ?? "Use the full message UUID instead of the 8-character short id."
+    });
+  }
+  if (res.errorCode === "INVALID_ARG") {
+    return new CliError({
+      code: "INVALID_ARG",
+      message: res.error ?? `HTTP ${res.status}`
+    });
+  }
+  return new CliError({
+    code: res.status >= 500 ? "SERVER_5XX" : "READ_FAILED",
+    message: res.error ?? `HTTP ${res.status}`
+  });
+}
 function validateReadOpts(opts) {
   const channel = opts.channel?.trim();
   if (!channel) {
@@ -16471,13 +16501,13 @@ function validateReadOpts(opts) {
       message: "--channel is required"
     });
   }
-  const before = parsePositiveInt("before", opts.before);
-  const after = parsePositiveInt("after", opts.after);
   const limit = parsePositiveInt("limit", opts.limit);
+  const before = opts.before?.trim();
+  const after = opts.after?.trim();
   return {
     channel,
-    ...before !== void 0 ? { before } : {},
-    ...after !== void 0 ? { after } : {},
+    ...before ? { before } : {},
+    ...after ? { after } : {},
     ...opts.around !== void 0 ? { around: opts.around } : {},
     ...limit !== void 0 ? { limit } : {}
   };
@@ -16488,9 +16518,9 @@ var messageReadCommand = defineCommand(
     description: "Read message history for a channel, DM, or thread",
     options: [
       { flags: "--channel <target>", description: "Target: '#channel', 'dm:@peer', '#channel:threadId', 'dm:@peer:threadId'" },
-      { flags: "--before <seq>", description: "Return messages strictly before this seq (paginate backwards)" },
-      { flags: "--after <seq>", description: "Return messages strictly after this seq (paginate forwards)" },
-      { flags: "--around <idOrSeq>", description: "Center the window on this messageId or seq" },
+      { flags: "--before <idOrSeq>", description: "Return messages strictly before this message id or seq anchor" },
+      { flags: "--after <idOrSeq>", description: "Return messages strictly after this message id or seq anchor" },
+      { flags: "--around <idOrSeq>", description: "Center the window on this message id or seq anchor" },
       { flags: "--limit <n>", description: "Max messages to return (server default applies if omitted)" }
     ]
   },
@@ -16503,10 +16533,7 @@ var messageReadCommand = defineCommand(
       buildReadPath(agentContext.agentId, readOpts)
     );
     if (!res.ok) {
-      throw new CliError({
-        code: res.status >= 500 ? "SERVER_5XX" : "READ_FAILED",
-        message: res.error ?? `HTTP ${res.status}`
-      });
+      throw mapReadFailure(res);
     }
     writeText(
       ctx.io,
@@ -16640,6 +16667,77 @@ function registerSearchCommand(parent, runtimeOptions) {
   registerCliCommand(parent, messageSearchCommand, runtimeOptions);
 }
 
+// src/commands/message/resolve.ts
+function buildResolvePath(agentId, id) {
+  return `/internal/agent/${encodeURIComponent(agentId)}/messages/${encodeURIComponent(id)}/resolve`;
+}
+function mapResolveError(res) {
+  const message = res.error ?? `HTTP ${res.status}`;
+  if (res.errorCode === "AMBIGUOUS_ID") {
+    return {
+      code: "AMBIGUOUS_ID",
+      message,
+      suggestedNextAction: "Use the full message UUID instead of the 8-character short id."
+    };
+  }
+  if (res.errorCode === "NOT_FOUND" || res.status === 404) {
+    return {
+      code: "NOT_FOUND",
+      message,
+      suggestedNextAction: "Use slock message search to find the message, or slock message read --around only when you want nearby context rather than proof that this id exists."
+    };
+  }
+  if (res.errorCode === "INVALID_ARG" || res.status === 400) {
+    return { code: "INVALID_ARG", message };
+  }
+  return {
+    code: res.status >= 500 ? "SERVER_5XX" : "READ_FAILED",
+    message
+  };
+}
+var messageResolveCommand = defineCommand(
+  {
+    name: "resolve",
+    description: "Resolve a message id exactly and print the canonical message",
+    arguments: ["<id>"]
+  },
+  async (ctx, rawId) => {
+    const id = rawId?.trim();
+    if (!id) {
+      throw new CliError({
+        code: "INVALID_ARG",
+        message: "<id> is required"
+      });
+    }
+    const agentContext = ctx.loadAgentContext();
+    const client = ctx.createApiClient(agentContext);
+    const res = await client.request(
+      "GET",
+      buildResolvePath(agentContext.agentId, id)
+    );
+    if (!res.ok) {
+      const mapped = mapResolveError(res);
+      throw new CliError(mapped);
+    }
+    const message = res.data?.message;
+    if (!message) {
+      throw new CliError({
+        code: "INVALID_JSON_RESPONSE",
+        message: "Missing message in resolve response"
+      });
+    }
+    writeText(ctx.io, `${formatMessages([{
+      ...message,
+      parent_channel_type: message.parent_channel_type ?? void 0,
+      parent_channel_name: message.parent_channel_name ?? void 0
+    }])}
+`);
+  }
+);
+function registerResolveCommand(parent, runtimeOptions) {
+  registerCliCommand(parent, messageResolveCommand, runtimeOptions);
+}
+
 // src/commands/message/react.ts
 function normalizeReactionEmoji(value) {
   const emoji3 = value.trim();
@@ -18486,6 +18584,7 @@ registerSendCommand(messageCmd);
 registerCheckCommand(messageCmd);
 registerReadCommand(messageCmd);
 registerSearchCommand(messageCmd);
+registerResolveCommand(messageCmd);
 registerReactCommand(messageCmd);
 var attachmentCmd = program.command("attachment").description("Attachment operations");
 registerAttachmentUploadCommand(attachmentCmd);

package/dist/core.js

@@ -9,7 +9,7 @@ import {
   resolveSlockCliPath,
   resolveWorkspaceDirectoryPath,
   scanWorkspaceDirectories
-} from "./chunk-S5AEBH3V.js";
+} from "./chunk-NXNXMFLC.js";
 import {
   subscribeDaemonLogs
 } from "./chunk-M2KQBJR3.js";

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   DAEMON_CLI_USAGE,
   DaemonCore,
   parseDaemonCliArgs
-} from "./chunk-S5AEBH3V.js";
+} from "./chunk-NXNXMFLC.js";
 import "./chunk-M2KQBJR3.js";
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slock-ai/daemon",
-  "version": "0.55.4",
+  "version": "0.55.5",
   "type": "module",
   "bin": {
     "slock-daemon": "dist/index.js"