@slock-ai/daemon 0.7.0 → 0.9.0

package/dist/chat-bridge.js

@@ -113,7 +113,7 @@ server.tool(
 );
 server.tool(
   "list_server",
-  "List all channels you are in, all agents, and all humans in this server. Use this to discover who and where you can message.",
+  "List all channels in this server, including which ones you have joined, plus all agents and humans. Use this to discover who and where you can message.",
   {},
   async () => {
     try {
@@ -123,12 +123,13 @@ server.tool(
       );
       const data = await res.json();
       let text = "## Server\n\n";
-      text += "### Your Channels\n";
-      text += "Use `#channel-name` with send_message to post in a channel.\n";
+      text += "### Channels\n";
+      text += "Use `#channel-name` with send_message to post in a channel. `joined` means you currently belong to that channel.\n";
       if (data.channels?.length > 0) {
         for (const t of data.channels) {
-          text += t.description ? `  - #${t.name} \u2014 ${t.description}
-` : `  - #${t.name}
+          const status = t.joined ? "joined" : "not joined";
+          text += t.description ? `  - #${t.name} [${status}] \u2014 ${t.description}
+` : `  - #${t.name} [${status}]
 `;
         }
       } else {
@@ -244,5 +245,214 @@ ${formatted}${footer}`
     }
   }
 );
+server.tool(
+  "list_tasks",
+  "List tasks on a channel's task board. Returns tasks with their number (#t1, #t2...), title, status, and assignee.",
+  {
+    channel: z.string().describe("The channel whose task board to view \u2014 e.g. '#engineering', '#proj-slock'"),
+    status: z.enum(["all", "open", "claimed", "completed"]).default("all").describe("Filter by status (default: all)")
+  },
+  async ({ channel, status }) => {
+    try {
+      const params = new URLSearchParams();
+      params.set("channel", channel);
+      if (status !== "all") params.set("status", status);
+      const res = await fetch(
+        `${serverUrl}/internal/agent/${agentId}/tasks?${params}`,
+        { method: "GET", headers: commonHeaders }
+      );
+      const data = await res.json();
+      if (!res.ok) {
+        return {
+          content: [{ type: "text", text: `Error: ${data.error}` }]
+        };
+      }
+      if (!data.tasks || data.tasks.length === 0) {
+        return {
+          content: [{ type: "text", text: `No${status !== "all" ? ` ${status}` : ""} tasks in ${channel}.` }]
+        };
+      }
+      const formatted = data.tasks.map((t) => {
+        const assignee = t.claimedByName ? ` \u2192 @${t.claimedByName}` : "";
+        const creator = t.createdByName ? ` (by @${t.createdByName})` : "";
+        return `#t${t.taskNumber} [${t.status}] "${t.title}"${assignee}${creator}`;
+      }).join("\n");
+      return {
+        content: [
+          {
+            type: "text",
+            text: `## Task Board for ${channel} (${data.tasks.length} tasks)
+
+${formatted}`
+          }
+        ]
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `Error: ${err.message}` }]
+      };
+    }
+  }
+);
+server.tool(
+  "create_tasks",
+  "Create one or more tasks on a channel's task board. Returns the created task numbers.",
+  {
+    channel: z.string().describe("The channel to create tasks in \u2014 e.g. '#engineering'"),
+    tasks: z.array(
+      z.object({
+        title: z.string().describe("Task title")
+      })
+    ).describe("Array of tasks to create")
+  },
+  async ({ channel, tasks }) => {
+    try {
+      const res = await fetch(`${serverUrl}/internal/agent/${agentId}/tasks`, {
+        method: "POST",
+        headers: commonHeaders,
+        body: JSON.stringify({ channel, tasks })
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        return {
+          content: [{ type: "text", text: `Error: ${data.error}` }]
+        };
+      }
+      const created = data.tasks.map((t) => `#t${t.taskNumber} "${t.title}"`).join("\n");
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Created ${data.tasks.length} task(s) in ${channel}:
+${created}`
+          }
+        ]
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `Error: ${err.message}` }]
+      };
+    }
+  }
+);
+server.tool(
+  "claim_tasks",
+  "Claim one or more tasks by their number. Returns which claims succeeded and which failed (e.g. already claimed by someone else).",
+  {
+    channel: z.string().describe("The channel whose tasks to claim \u2014 e.g. '#engineering'"),
+    task_numbers: z.array(z.number()).describe("Task numbers to claim (e.g. [1, 3, 5])")
+  },
+  async ({ channel, task_numbers }) => {
+    try {
+      const res = await fetch(
+        `${serverUrl}/internal/agent/${agentId}/tasks/claim`,
+        {
+          method: "POST",
+          headers: commonHeaders,
+          body: JSON.stringify({ channel, task_numbers })
+        }
+      );
+      const data = await res.json();
+      if (!res.ok) {
+        return {
+          content: [{ type: "text", text: `Error: ${data.error}` }]
+        };
+      }
+      const lines = data.results.map((r) => {
+        if (r.success) {
+          return `#t${r.taskNumber}: claimed`;
+        }
+        return `#t${r.taskNumber}: FAILED \u2014 ${r.reason || "already claimed"}`;
+      });
+      const succeeded = data.results.filter((r) => r.success).length;
+      const failed = data.results.length - succeeded;
+      let summary = `${succeeded} claimed`;
+      if (failed > 0) summary += `, ${failed} failed`;
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Claim results (${summary}):
+${lines.join("\n")}`
+          }
+        ]
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `Error: ${err.message}` }]
+      };
+    }
+  }
+);
+server.tool(
+  "unclaim_task",
+  "Release your claim on a task, setting it back to open.",
+  {
+    channel: z.string().describe("The channel \u2014 e.g. '#engineering'"),
+    task_number: z.number().describe("The task number to unclaim (e.g. 3)")
+  },
+  async ({ channel, task_number }) => {
+    try {
+      const res = await fetch(
+        `${serverUrl}/internal/agent/${agentId}/tasks/unclaim`,
+        {
+          method: "POST",
+          headers: commonHeaders,
+          body: JSON.stringify({ channel, task_number })
+        }
+      );
+      const data = await res.json();
+      if (!res.ok) {
+        return {
+          content: [{ type: "text", text: `Error: ${data.error}` }]
+        };
+      }
+      return {
+        content: [
+          { type: "text", text: `#t${task_number} unclaimed \u2014 now open.` }
+        ]
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `Error: ${err.message}` }]
+      };
+    }
+  }
+);
+server.tool(
+  "complete_task",
+  "Mark a task as completed. You must be the current claimer.",
+  {
+    channel: z.string().describe("The channel \u2014 e.g. '#engineering'"),
+    task_number: z.number().describe("The task number to complete (e.g. 3)")
+  },
+  async ({ channel, task_number }) => {
+    try {
+      const res = await fetch(
+        `${serverUrl}/internal/agent/${agentId}/tasks/complete`,
+        {
+          method: "POST",
+          headers: commonHeaders,
+          body: JSON.stringify({ channel, task_number })
+        }
+      );
+      const data = await res.json();
+      if (!res.ok) {
+        return {
+          content: [{ type: "text", text: `Error: ${data.error}` }]
+        };
+      }
+      return {
+        content: [
+          { type: "text", text: `#t${task_number} marked as completed.` }
+        ]
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `Error: ${err.message}` }]
+      };
+    }
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/index.js

@@ -120,8 +120,13 @@ You have MCP tools from the "chat" server. Use ONLY these for communication:
 
 1. **${t("receive_message")}** \u2014 Call with block=true to wait for messages. This is your main loop.
 2. **${t("send_message")}** \u2014 Send a message to a channel or DM.
-3. **${t("list_server")}** \u2014 List all channels, agents, and humans in this server.
+3. **${t("list_server")}** \u2014 List all channels in this server, which ones you have joined, plus all agents and humans.
 4. **${t("read_history")}** \u2014 Read past messages from a channel or DM.
+5. **${t("list_tasks")}** \u2014 View a channel's task board.
+6. **${t("create_tasks")}** \u2014 Create tasks on a channel's task board (supports batch).
+7. **${t("claim_tasks")}** \u2014 Claim tasks by number (supports batch, handles conflicts).
+8. **${t("unclaim_task")}** \u2014 Release your claim on a task.
+9. **${t("complete_task")}** \u2014 Mark a task as done.
 
 CRITICAL RULES:
 ${criticalRules.join("\n")}
@@ -155,7 +160,7 @@ The \`[...]\` prefix identifies where the message came from. Reuse it as the \`c
 
 ### Discovering people and channels
 
-Call \`list_server\` to see all your channels, other agents, and humans in this server.
+Call \`list_server\` to see all channels in this server, which ones you have joined, other agents, and humans.
 
 ### Channel awareness
 
@@ -168,6 +173,27 @@ Each channel has a **name** and optionally a **description** that define its pur
 
 \`read_history(channel="#channel-name")\` or \`read_history(channel="DM:@peer-name")\`
 
+### Task boards
+
+Each channel has a task board where humans and agents can create, claim, and complete tasks. Tasks are numbered per channel (#t1, #t2, ...) for easy reference.
+
+- **View tasks**: \`list_tasks(channel="#channel-name")\` \u2014 see all tasks with status and assignee.
+- **Create tasks**: \`create_tasks(channel="#channel-name", tasks=[{title: "..."}, ...])\` \u2014 create one or more tasks. Useful for breaking down a large task into subtasks.
+- **Claim tasks**: \`claim_tasks(channel="#channel-name", task_numbers=[1, 3])\` \u2014 claim tasks you want to work on. If another agent already claimed a task, your claim for that task fails (but others in the batch may succeed). Check the result to see which succeeded.
+- **Unclaim**: \`unclaim_task(channel="#channel-name", task_number=3)\` \u2014 release a task back to open.
+- **Complete**: \`complete_task(channel="#channel-name", task_number=3)\` \u2014 mark a task as done.
+
+**CRITICAL: You MUST claim a task before starting work on it.** Never begin working on a task without claiming it first. The claim mechanism prevents multiple agents from doing the same work. If your claim fails (someone else claimed it), move on to another task.
+
+### Splitting tasks for parallel execution
+
+When you need to break down a large task into subtasks, structure them so agents can work **in parallel**:
+- **Group by phase** if tasks have dependencies. Label them clearly (e.g. "Phase 1: ...", "Phase 2: ...") so agents know what can run concurrently and what must wait.
+- **Prefer independent subtasks** that don't block each other. Each subtask should be completable without waiting for another.
+- **Avoid creating sequential chains** where each task depends on the previous one \u2014 this forces agents to work one at a time, wasting capacity.
+
+When you receive a notification about new tasks, check the task board and claim tasks relevant to your skills.
+
 ## @Mentions
 
 In channel group chats, you can @mention people by their unique name (e.g. "@alice" or "@bob").
@@ -182,6 +208,20 @@ Keep the user informed. They cannot see your internal reasoning, so:
 - When done, summarize the result.
 - Keep updates concise \u2014 one or two sentences. Don't flood the chat.
 
+### Conversation etiquette
+
+- **Don't interrupt ongoing conversations.** If a human is having a back-and-forth with another person (human or agent) on a topic, their follow-up messages are directed at that person \u2014 not at you. Do NOT jump in unless you are explicitly @mentioned or clearly addressed.
+- **Only the person doing the work should report on it.** If someone else completed a task or submitted a PR, don't echo or summarize their work \u2014 let them respond to questions about it.
+- **Claim before you start.** When picking up a task, announce it in the channel first to avoid duplicate work by others.
+
+### Formatting \u2014 URLs in non-English text
+
+When writing a URL next to non-ASCII punctuation (Chinese, Japanese, etc.), always wrap the URL in angle brackets or use markdown link syntax. Otherwise the punctuation may be rendered as part of the URL.
+
+- **Wrong**: \`\u6D4B\u8BD5\u73AF\u5883\uFF1Ahttp://localhost:3000\uFF0C\u8BF7\u67E5\u770B\` (the \`\uFF0C\` gets swallowed into the link)
+- **Correct**: \`\u6D4B\u8BD5\u73AF\u5883\uFF1A<http://localhost:3000>\uFF0C\u8BF7\u67E5\u770B\`
+- **Also correct**: \`\u6D4B\u8BD5\u73AF\u5883\uFF1A[http://localhost:3000](http://localhost:3000)\uFF0C\u8BF7\u67E5\u770B\`
+
 ## Workspace & Memory
 
 Your working directory (cwd) is your **persistent workspace**. Everything you write here survives across sessions.
@@ -382,6 +422,11 @@ var ClaudeDriver = class {
     });
   }
   toolDisplayName(name) {
+    if (name === "mcp__chat__list_tasks") return "Viewing task board\u2026";
+    if (name === "mcp__chat__create_tasks") return "Creating tasks\u2026";
+    if (name === "mcp__chat__claim_tasks") return "Claiming tasks\u2026";
+    if (name === "mcp__chat__unclaim_task") return "Unclaiming task\u2026";
+    if (name === "mcp__chat__complete_task") return "Completing task\u2026";
     if (name.startsWith("mcp__chat__")) return "";
     if (name === "Read" || name === "read_file") return "Reading file\u2026";
     if (name === "Write" || name === "write_file") return "Writing file\u2026";
@@ -412,6 +457,15 @@ var ClaudeDriver = class {
         return input.channel || (input.dm_to ? `DM:@${input.dm_to}` : "");
       }
       if (name === "mcp__chat__read_history") return input.channel || "";
+      if (name === "mcp__chat__list_tasks") return input.channel || "";
+      if (name === "mcp__chat__create_tasks") return input.channel || "";
+      if (name === "mcp__chat__claim_tasks") {
+        const nums = input.task_numbers;
+        return input.channel ? `${input.channel} #t${Array.isArray(nums) ? nums.join(",#t") : nums}` : "";
+      }
+      if (name === "mcp__chat__unclaim_task" || name === "mcp__chat__complete_task") {
+        return input.channel ? `${input.channel} #t${input.task_number}` : "";
+      }
       return "";
     } catch {
       return "";
@@ -584,6 +638,11 @@ var CodexDriver = class {
     });
   }
   toolDisplayName(name) {
+    if (name === `${this.mcpToolPrefix}list_tasks`) return "Viewing task board\u2026";
+    if (name === `${this.mcpToolPrefix}create_tasks`) return "Creating tasks\u2026";
+    if (name === `${this.mcpToolPrefix}claim_tasks`) return "Claiming tasks\u2026";
+    if (name === `${this.mcpToolPrefix}unclaim_task`) return "Unclaiming task\u2026";
+    if (name === `${this.mcpToolPrefix}complete_task`) return "Completing task\u2026";
     if (name.startsWith(this.mcpToolPrefix)) return "";
     if (name === "shell" || name === "command_execution") return "Running command\u2026";
     if (name === "file_change") return "Editing file\u2026";
@@ -608,6 +667,15 @@ var CodexDriver = class {
         return input.channel || (input.dm_to ? `DM:@${input.dm_to}` : "");
       }
       if (name === `${this.mcpToolPrefix}read_history`) return input.channel || "";
+      if (name === `${this.mcpToolPrefix}list_tasks`) return input.channel || "";
+      if (name === `${this.mcpToolPrefix}create_tasks`) return input.channel || "";
+      if (name === `${this.mcpToolPrefix}claim_tasks`) {
+        const nums = input.task_numbers;
+        return input.channel ? `${input.channel} #t${Array.isArray(nums) ? nums.join(",#t") : nums}` : "";
+      }
+      if (name === `${this.mcpToolPrefix}unclaim_task` || name === `${this.mcpToolPrefix}complete_task`) {
+        return input.channel ? `${input.channel} #t${input.task_number}` : "";
+      }
       return "";
     } catch {
       return "";

package/package.json

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