@ctliz/agent-intercom-claude 0.14.1 → 0.15.0

package/dist/claude-server.mjs

@@ -635,14 +635,15 @@ function isMessage(value) {
     }
     if (message.replyTo !== void 0 || message.expectsReply !== void 0) return false;
   }
-  if (!hasExactDataKeys(message.content, ["text"], ["attachments"])) {
+  if (!hasExactDataKeys(message.content, ["text"], ["attachments", "team"])) {
     return false;
   }
   const content = message.content;
   if (typeof content.text !== "string") {
     return false;
   }
-  if (message.control !== void 0 && (content.text !== "" || content.attachments !== void 0)) return false;
+  if (content.team !== void 0 && (typeof content.team !== "string" || !/^[A-Za-z][A-Za-z0-9_-]{0,31}$/.test(content.team))) return false;
+  if (message.control !== void 0 && (content.text !== "" || content.attachments !== void 0 || content.team !== void 0)) return false;
   return content.attachments === void 0 || isDenseArrayOf(content.attachments, isAttachment);
 }
 function isSessionInfo(value) {
@@ -1265,6 +1266,7 @@ var IntercomClient = class extends EventEmitter {
       ...options.control === void 0 ? {} : { control: options.control },
       content: {
         text: options.text,
+        ...options.team === void 0 ? {} : { team: options.team },
         ...options.attachments === void 0 ? {} : { attachments: options.attachments }
       }
     };
@@ -1859,6 +1861,7 @@ function toInboxEntry(from, message, now = Date.now()) {
     fromId: from.id,
     ...from.name ? { fromName: from.name } : {},
     messageId: message.id,
+    ...message.content.team ? { team: message.content.team } : {},
     ...message.replyTo ? { replyTo: message.replyTo } : {},
     expectsReply: Boolean(message.expectsReply),
     text: message.content.text
@@ -2188,19 +2191,17 @@ function parseStoredTeam(value) {
   if (typeof value.createdAt !== "number" || !Number.isSafeInteger(value.createdAt) || value.createdAt <= 0) {
     return void 0;
   }
+  if (value.memberSessionIds !== void 0 && (!Array.isArray(value.memberSessionIds) || !value.memberSessionIds.every((id) => typeof id === "string" && id.trim() === id && id.length > 0 && !/[\u0000-\u001f\u007f]/.test(id)) || new Set(value.memberSessionIds).size !== value.memberSessionIds.length || !value.memberSessionIds.includes(value.managerSessionId))) return void 0;
+  if (value.work !== void 0 && (typeof value.work !== "string" || !value.work.trim() || value.work.length > 2e3)) return void 0;
   return {
     name: value.name,
     scopeId: value.scopeId,
     managerSessionId: value.managerSessionId,
-    createdAt: value.createdAt
+    createdAt: value.createdAt,
+    ...value.memberSessionIds === void 0 ? {} : { memberSessionIds: value.memberSessionIds },
+    ...value.work === void 0 ? {} : { work: value.work }
   };
 }
-function rejectManagedJoin(env = process.env) {
-  if (env.AGENT_INTERCOM_WORKER_ID?.trim() || env.AGENT_INTERCOM_OWNED === "1" || env.AGENT_INTERCOM_TEAM_MANIFEST?.trim()) {
-    return "This session is already a managed member and cannot join another team.";
-  }
-  return void 0;
-}
 function parseTeamName(raw) {
   const name = raw.trim();
   if (!name || name.includes(" ") || !NAMED_TEAM_NAME_PATTERN.test(name)) {
@@ -2245,35 +2246,6 @@ function listNamedTeams(agentDir) {
   }
   return teams;
 }
-function findNamedTeam(name, agentDir) {
-  return listNamedTeams(agentDir).find((team) => team.name === name);
-}
-function createNamedTeam(input) {
-  const name = parseTeamName(input.name);
-  const managerSessionId = input.managerSessionId.trim();
-  if (!managerSessionId || managerSessionId !== input.managerSessionId || /[\u0000-\u001f\u007f]/.test(managerSessionId)) {
-    throw genericWriteError();
-  }
-  const existing = listNamedTeams(input.agentDir);
-  if (existing.some((team2) => team2.name === name)) {
-    throw new Error(`A named team called ${name} already exists.`);
-  }
-  const scopeId = (input.generateScope ?? (() => generateNamedTeamScope(existing.map((team2) => team2.scopeId))))();
-  if (!isNamedTeamScope(scopeId) || existing.some((team2) => team2.scopeId === scopeId)) {
-    throw genericWriteError();
-  }
-  const team = {
-    name,
-    scopeId,
-    managerSessionId,
-    createdAt: input.now ?? Date.now()
-  };
-  const dir = getIntercomDirPath(input.agentDir ?? getAgentDirPath());
-  ensureIntercomRuntimeDir(dir);
-  const payload = { version: NAMED_TEAMS_VERSION, teams: [...existing, team] };
-  writeDurableJson(teamsFilePath(input.agentDir), payload);
-  return team;
-}
 function formatJoinableNamedTeamList(teams) {
   if (teams.length === 0) {
     return 'No joinable named teams found.\nCreate one with intercom_join({ name: "billing", create: true }).';
@@ -2293,6 +2265,147 @@ Role: teammate
 Display name: ${input.name}`;
 }
 
+// claude/named-team-membership.ts
+import { mkdirSync as mkdirSync4, rmSync } from "node:fs";
+import { join as join8 } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+function namedTeamMemberIds(team) {
+  return team.memberSessionIds ?? [team.managerSessionId];
+}
+function sessionNamedTeams(sessionId, agentDir) {
+  return listNamedTeams(agentDir).filter((team) => namedTeamMemberIds(team).includes(sessionId));
+}
+async function appendNamedTeamMembership(input) {
+  const name = parseTeamName(input.name);
+  const memberIds = [.../* @__PURE__ */ new Set([input.selfId, ...input.members ?? []])];
+  if (memberIds.some((id) => !id || id.trim() !== id || /[\u0000-\u001f\u007f]/.test(id))) {
+    throw new Error("Invalid team member session ID");
+  }
+  if (input.work !== void 0 && (!input.work.trim() || input.work.length > 2e3)) {
+    throw new Error("Work must be a non-empty task description (max 2000 characters)");
+  }
+  const dir = getIntercomDirPath(input.agentDir ?? getAgentDirPath());
+  ensureIntercomRuntimeDir(dir);
+  const lock = join8(dir, "named-teams.lock");
+  const deadline = Date.now() + 5e3;
+  for (; ; ) {
+    try {
+      mkdirSync4(lock, { mode: 448 });
+      break;
+    } catch (error2) {
+      if (error2.code !== "EEXIST") throw error2;
+      if (Date.now() >= deadline) throw new Error("Team registry is busy; retry. If a writer crashed, remove the stale named-teams.lock directory after verifying no writer is active.");
+      await delay(25);
+    }
+  }
+  try {
+    const teams = listNamedTeams(input.agentDir);
+    let team = teams.find((entry) => entry.name === name);
+    if (input.create) {
+      if (team) throw new Error(`A named team called ${name} already exists; join it instead.`);
+      team = { name, scopeId: generateNamedTeamScope(teams.map((entry) => entry.scopeId)), managerSessionId: input.selfId, createdAt: Date.now() };
+      teams.push(team);
+    }
+    if (!team) throw new Error(`Team "${name}" does not exist; create it explicitly.`);
+    if (memberIds.some((id) => id !== input.selfId) && team.managerSessionId !== input.selfId) {
+      throw new Error(`Only the manager of team "${name}" may add other sessions`);
+    }
+    if (input.work !== void 0 && !input.create) {
+      throw new Error("Work is set when creating a team; use a new team for a different task");
+    }
+    const updated = {
+      ...team,
+      memberSessionIds: [.../* @__PURE__ */ new Set([...namedTeamMemberIds(team), ...memberIds])],
+      ...input.work === void 0 ? {} : { work: input.work.trim() }
+    };
+    writeDurableJson(join8(dir, NAMED_TEAMS_FILE), {
+      version: NAMED_TEAMS_VERSION,
+      teams: teams.map((entry) => entry.name === name ? updated : entry)
+    });
+    return updated;
+  } finally {
+    rmSync(lock, { recursive: true });
+  }
+}
+function requireNamedTeamMembers(name, selfId, peerId, agentDir) {
+  const team = listNamedTeams(agentDir).find((entry) => entry.name === name);
+  if (!team) throw new Error(`Unknown team "${name}"`);
+  const members = namedTeamMemberIds(team);
+  if (!members.includes(selfId) || !members.includes(peerId)) {
+    throw new Error(`Both sessions must belong to team "${name}" before messaging`);
+  }
+  return team;
+}
+function resolveNamedMessageTeam(selfId, peerId, requested, agentDir) {
+  if (requested !== void 0) return requireNamedTeamMembers(requested, selfId, peerId, agentDir).name;
+  const mine = sessionNamedTeams(selfId, agentDir);
+  const shared = mine.filter((team) => namedTeamMemberIds(team).includes(peerId));
+  if (shared.length === 1) return shared[0].name;
+  if (shared.length > 1) throw new Error("Multiple shared teams; specify `team` for this task");
+  return void 0;
+}
+function namedTeamRoster(team, selfId, sessions) {
+  return {
+    name: team.name,
+    ...team.work ? { work: team.work } : {},
+    self: { id: selfId, isManager: selfId === team.managerSessionId },
+    manager: { target: team.managerSessionId, connected: sessions.some((entry) => entry.id === team.managerSessionId) },
+    members: namedTeamMemberIds(team).map((id) => ({
+      id,
+      target: id,
+      name: sessions.find((entry) => entry.id === id)?.name,
+      role: id === team.managerSessionId ? "manager" : "member",
+      connected: sessions.some((entry) => entry.id === id)
+    }))
+  };
+}
+function formatNamedTeamRoster(team) {
+  return [
+    `Team: ${team.name}`,
+    ...team.work ? [`Work: ${team.work}`] : [],
+    `You: ${team.self.id}${team.self.isManager ? " [manager]" : ""}`,
+    `Manager: ${team.manager.target}${team.manager.connected ? "" : " [offline]"}`,
+    "Members:",
+    ...team.members.map((member) => `- ${member.name || member.id} (${member.id}) [${member.role}]${member.connected ? "" : " [offline]"}`)
+  ].join("\n");
+}
+
+// claude/reply-context.ts
+function contextId(entry) {
+  return `ctx-${entry.message.id}`;
+}
+function askId(entry) {
+  return `ask-${entry.message.id}`;
+}
+function replyHint(entry) {
+  const team = entry.message.content.team;
+  return `${team ? ` [Team: ${team}]` : ""} [contextId: ${contextId(entry)}]${entry.message.expectsReply ? ` [askId: ${askId(entry)}]` : ""}`;
+}
+function selectReplyContext(entries, asks, input) {
+  if (input.askId && input.contextId) throw new Error("Specify askId or contextId, not both");
+  let target;
+  if (input.askId || input.contextId) {
+    const selected = input.askId ? asks.find((entry) => askId(entry) === input.askId) : entries.find((entry) => contextId(entry) === input.contextId);
+    if (!selected || selected.message.expectsReply && !asks.includes(selected)) throw new Error("Unknown or resolved reply selector; call intercom_pending");
+    if (input.to && selected.from.id !== input.to && selected.from.name?.toLowerCase() !== input.to.toLowerCase()) {
+      throw new Error("Reply sender does not match the selected context");
+    }
+    if (input.which) throw new Error("Do not combine an exact reply selector with which");
+    target = selected;
+  } else {
+    const to = input.to;
+    const candidates = to ? asks.filter((entry) => entry.from.id === to || entry.from.name?.toLowerCase() === to.toLowerCase() || entry.from.id.startsWith(to)) : asks;
+    if (!input.which && new Set(candidates.map((entry) => entry.message.content.team)).size > 1) {
+      throw new Error("Multiple team contexts; specify askId or contextId");
+    }
+    target = selectPendingAsk(asks, input.to, input.which);
+  }
+  if (input.team !== void 0 && input.team !== target.message.content.team) {
+    throw new Error("Reply team must match the original message; omit team to inherit it");
+  }
+  return target;
+}
+
 // claude/runtime.ts
 function matchesPendingSender(entry, to) {
   return entry.from.id === to || entry.from.name?.toLowerCase() === to.toLowerCase() || entry.from.id.startsWith(to);
@@ -2330,6 +2443,9 @@ function publicPendingEntry(entry, selector) {
       ...entry.from.parentSessionId ? { parent_session_id: entry.from.parentSessionId } : {},
       ...entry.from.generation ? { generation: entry.from.generation } : {}
     },
+    contextId: contextId(entry),
+    ...entry.message.expectsReply ? { askId: askId(entry) } : {},
+    ...entry.message.content.team ? { team: entry.message.content.team } : {},
     received_at: entry.receivedAt,
     read: entry.read,
     text: entry.message.content.text,
@@ -2545,7 +2661,7 @@ var ClaudeIntercomRuntime = class {
   }
   scheduleReconnect() {
     if (!this.reconnectEnabled || this.reconnectTimer) return;
-    const delay2 = this.reconnectDelays[Math.min(this.reconnectAttempt, this.reconnectDelays.length - 1)];
+    const delay3 = this.reconnectDelays[Math.min(this.reconnectAttempt, this.reconnectDelays.length - 1)];
     this.reconnectTimer = setTimeout(() => {
       this.reconnectTimer = null;
       void this.connect().then((client) => {
@@ -2557,7 +2673,7 @@ var ClaudeIntercomRuntime = class {
         this.reconnectAttempt += 1;
         this.scheduleReconnect();
       });
-    }, delay2);
+    }, delay3);
     this.reconnectTimer.unref?.();
   }
   clearReconnectTimer() {
@@ -2609,25 +2725,24 @@ var ClaudeIntercomRuntime = class {
     this.reconnectEnabled = true;
     await this.connect();
   }
-  async join(name, create = false) {
-    const blocked = rejectManagedJoin();
-    if (blocked) return textResult(blocked, { ok: false }, true);
+  async join(name, create = false, members, work) {
     try {
-      if (create) {
-        if (typeof name !== "string" || !name.trim()) {
-          return textResult("Creating a team requires a name.", { ok: false }, true);
-        }
-        const team2 = createNamedTeam({ name: parseTeamName(name), managerSessionId: this.identity.sessionId });
-        await this.switchRuntimeScope(team2.scopeId, team2.managerSessionId);
-        return textResult(formatCreateSuccess({ team: team2.name, name: this.identity.name }), { ok: true, team: team2.name, role: "manager" });
-      }
       if (!name?.trim()) {
+        if (create || members?.length || work !== void 0) throw new Error("Creating or extending a team requires a name");
         return textResult(formatJoinableNamedTeamList(listNamedTeams()));
       }
-      const team = findNamedTeam(parseTeamName(name));
-      if (!team) return textResult("Could not join that team.", { ok: false }, true);
-      await this.switchRuntimeScope(team.scopeId, team.managerSessionId);
-      return textResult(formatNamedJoinSuccess({ team: team.name, name: this.identity.name }), { ok: true, team: team.name, role: "teammate" });
+      const client = await this.connect();
+      const sessions = await client.listSessions();
+      const memberIds = (members ?? []).map((member) => {
+        const id = resolveSessionTarget(sessions, member);
+        if (!id) throw new Error(`Session "${member}" is not connected`);
+        return id;
+      });
+      const team = await appendNamedTeamMembership({ name: parseTeamName(name), selfId: this.identity.sessionId, members: memberIds, create, work });
+      const roster = namedTeamRoster(team, this.identity.sessionId, sessions);
+      const notice = create ? formatCreateSuccess({ team: team.name, name: this.identity.name }) : formatNamedJoinSuccess({ team: team.name, name: this.identity.name });
+      return textResult(`${notice}
+Other team memberships are unchanged.`, { ok: true, team: team.name, role: roster.self.isManager ? "manager" : "member", roster });
     } catch (error2) {
       return textResult(error2 instanceof Error ? error2.message : String(error2), { ok: false }, true);
     }
@@ -2637,7 +2752,7 @@ var ClaudeIntercomRuntime = class {
     if (waiter) {
       const senderTarget = from.name || from.id;
       const fromMatches = senderTarget.toLowerCase() === waiter.from.toLowerCase() || from.id === waiter.from;
-      if (fromMatches) {
+      if (fromMatches && message.content.team === waiter.team) {
         this.replyWaiters.delete(waiter.replyTo);
         clearTimeout(waiter.timeout);
         waiter.cleanup?.();
@@ -2655,7 +2770,7 @@ var ClaudeIntercomRuntime = class {
     } catch {
     }
   }
-  waitForReply(from, replyTo, timeoutMs = getAskTimeoutMs(), signal) {
+  waitForReply(from, replyTo, timeoutMs = getAskTimeoutMs(), signal, team) {
     return new Promise((resolve3, reject) => {
       if (signal?.aborted) {
         reject(new Error("intercom_ask cancelled"));
@@ -2679,7 +2794,7 @@ var ClaudeIntercomRuntime = class {
         reject(new Error(`No reply from "${from}" within ${Math.round(timeoutMs / 1e3)} seconds`));
       }, timeoutMs);
       signal?.addEventListener("abort", onAbort, { once: true });
-      this.replyWaiters.set(replyTo, { from, replyTo, resolve: resolve3, reject, timeout, cleanup });
+      this.replyWaiters.set(replyTo, { from, replyTo, team, resolve: resolve3, reject, timeout, cleanup });
     });
   }
   async resolveTarget(to) {
@@ -2697,9 +2812,16 @@ cwd: ${this.identity.cwd}`,
       { session_id: sessionId, name: this.identity.name, cwd: this.identity.cwd, model: this.identity.model }
     );
   }
-  async team() {
+  async team(name) {
     const client = await this.connect();
     const sessions = await client.listSessions();
+    const mine = sessionNamedTeams(this.identity.sessionId);
+    const selected = name ? mine.filter((entry) => entry.name === name) : mine;
+    if (name && !selected.length) return textResult(`You do not belong to team "${name}"`, { ok: false }, true);
+    if (selected.length) {
+      const teams = selected.map((entry) => namedTeamRoster(entry, this.identity.sessionId, sessions));
+      return textResult(teams.map(formatNamedTeamRoster).join("\n\n"), { teams });
+    }
     const team = await resolveIntercomTeam({ selfId: client.sessionId ?? this.identity.sessionId, sessions });
     return textResult(formatIntercomTeam(team), team);
   }
@@ -2751,28 +2873,34 @@ Pending asks: ${this.unresolvedAsks.size}`,
     client.updatePresence({ status: summary.trim() || "idle" });
     return textResult("Summary updated.", { ok: true, summary });
   }
-  async send(to, message, attachments, replyTo) {
+  async send(to, message, attachments, replyTo, requestedTeam) {
     const client = await this.connect();
     const sendTo = await this.resolveTarget(to);
-    const result = await client.send(sendTo, { text: message, attachments, replyTo });
+    const source = replyTo ? this.unread.find((entry) => entry.message.id === replyTo && entry.from.id === sendTo) : void 0;
+    if (replyTo && !source) throw new Error("Unknown inbound reply context");
+    if (source && requestedTeam !== void 0 && requestedTeam !== source.message.content.team) throw new Error("Reply team must match the original message");
+    const team = source ? source.message.content.team : resolveNamedMessageTeam(this.identity.sessionId, sendTo, requestedTeam);
+    const result = await client.send(sendTo, { text: message, attachments, replyTo: source?.message.expectsReply ? replyTo : void 0, team });
     if (!result.delivered) {
       return textResult(`Message to "${to}" was not delivered: ${result.reason ?? "Session may not exist or has disconnected."}`, { ok: false, message_id: result.id, reason: result.reason }, true);
     }
     if (replyTo) this.unresolvedAsks.delete(replyTo);
     return textResult(`Message sent to ${to}.`, { ok: true, message_id: result.id, to });
   }
-  async ask(to, message, attachments, timeoutMs = getAskTimeoutMs(), signal) {
+  async ask(to, message, attachments, timeoutMs = getAskTimeoutMs(), signal, requestedTeam) {
     const client = await this.connect();
     const sendTo = await this.resolveTarget(to);
+    const team = resolveNamedMessageTeam(this.identity.sessionId, sendTo, requestedTeam);
     const questionId = randomUUID4();
-    const replyPromise = this.waitForReply(sendTo, questionId, timeoutMs, signal);
+    const replyPromise = this.waitForReply(sendTo, questionId, timeoutMs, signal, team);
     void replyPromise.catch(() => void 0);
     try {
       const result = await client.send(sendTo, {
         messageId: questionId,
         text: message,
         attachments,
-        expectsReply: true
+        expectsReply: true,
+        team
       });
       if (!result.delivered) {
         this.replyWaiters.get(questionId)?.reject(new Error(result.reason ?? "Session may not exist or has disconnected."));
@@ -2796,12 +2924,12 @@ ${replyText}`, { ok: true, message_id: result.id, reply });
     }
     const pendingAsks = Array.from(this.unresolvedAsks.values()).sort((a, b) => a.receivedAt - b.receivedAt);
     const lines = [
-      unreadMessages.length ? unreadMessages.map((entry) => `- ${formatSessionDisplay(entry.from)}: ${entry.message.content.text}${formatAttachments(entry.message.content.attachments)}`).join("\n") : "No unread messages.",
+      unreadMessages.length ? unreadMessages.map((entry) => `- ${formatSessionDisplay(entry.from)}${replyHint(entry)}: ${entry.message.content.text}${formatAttachments(entry.message.content.attachments)}`).join("\n") : "No unread messages.",
       pendingAsks.length ? `
 Pending asks:
 ${pendingAsks.map((entry) => {
         const selector = pendingSelector(pendingAsks, entry);
-        return `- ${formatSessionDisplay(entry.from)}${selector ? ` [${selector}]` : ""}: ${entry.message.content.text}`;
+        return `- ${formatSessionDisplay(entry.from)}${replyHint(entry)}${selector ? ` [${selector}]` : ""}: ${entry.message.content.text}`;
       }).join("\n")}` : ""
     ].filter(Boolean);
     return textResult(lines.join("\n"), {
@@ -2809,10 +2937,10 @@ ${pendingAsks.map((entry) => {
       pending_asks: pendingAsks.map((entry) => publicPendingEntry(entry, pendingSelector(pendingAsks, entry)))
     });
   }
-  async reply(message, to, which) {
+  async reply(message, to, which, askId2, contextId2, team) {
     let target;
     try {
-      target = selectPendingAsk(Array.from(this.unresolvedAsks.values()), to, which);
+      target = selectReplyContext(this.unread, Array.from(this.unresolvedAsks.values()), { to, which, askId: askId2, contextId: contextId2, team });
     } catch (error2) {
       return textResult(error2 instanceof Error ? error2.message : String(error2), { ok: false }, true);
     }
@@ -2824,6 +2952,15 @@ ${pendingAsks.map((entry) => {
   }
 };
 
+// claude/team-guidance.ts
+var TASK_TEAM_GUIDANCE = `Intercom task-team rules:
+- When the user delegates to named peers and this task has no approved team, ask once whether to form a team with you and those peers. Wait for approval before creating a team or adding peers. An explicit create/join request is approval; never ask again for an approved task or inbound team message.
+- After approval, discover the connected peers, then intercom_join({ name: "launch", create: true, members: ["front", "writer"], work: "Current task" }) adds everyone in one call. Do not ask the user to join each terminal manually.
+- Membership is additive: joining another team preserves previous teams. Reuse the approved team for the same task; a different task may need a different team.
+- Initial contact without a shared team is allowed: omit team for an ungrouped direct message. Unrelated team memberships must not prevent contact or silently create teams.
+- Include team on task sends/asks, especially when peers share multiple teams. Replies inherit the original message's team via askId or contextId from intercom_pending; never override it using a current team or mix contexts from different tasks.
+- Use intercom_send for assignments, progress/status requests, notifications and follow-ups. Use intercom_ask only when your next step genuinely depends on the answer; keep only one unresolved ask per recipient.`;
+
 // claude/mcp-protocol.ts
 var inflightToolCalls = /* @__PURE__ */ new Map();
 function asString(value, name) {
@@ -2832,6 +2969,14 @@ function asString(value, name) {
   }
   return value;
 }
+function optionalString(value, name) {
+  return value === void 0 ? void 0 : asString(value, name);
+}
+function memberArray(value) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value)) throw new Error("members must be an array of session names or IDs");
+  return Array.from(value, (member) => asString(member, "member"));
+}
 function asBoolean(value, defaultValue) {
   return typeof value === "boolean" ? value : defaultValue;
 }
@@ -2882,26 +3027,30 @@ function buildToolDefinitions(runtime) {
     },
     {
       name: "intercom_team",
-      description: "Show your current manager and the live coworkers owned by that manager. No arguments are required.",
-      inputSchema: { type: "object", properties: {}, additionalProperties: false },
+      description: "Show all your named task teams, or inspect one by name. Falls back to managed-team discovery.",
+      inputSchema: { type: "object", properties: { team: { type: "string" } }, additionalProperties: false },
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
-      handler: async () => runtime.team()
+      handler: async (args) => runtime.team(optionalString(args.team, "team"))
     },
     {
       name: "intercom_join",
-      description: "List, join, or create a named intercom team without tmux. Omit name to list joinable teams. Set create=true to create a team and join as manager.",
+      description: "After user approval, create or join a task team. Membership is additive; members lets the manager add connected peers in one call. Omit name to list teams.",
       inputSchema: {
         type: "object",
         properties: {
           name: { type: "string", description: "Team name to join. Omit to list joinable teams." },
-          create: { type: "boolean", description: "Create this named team and join as manager. Requires name." }
+          create: { type: "boolean", description: "Create this named team and join as manager. Requires name." },
+          members: { type: "array", items: { type: "string" }, description: "Connected session names or IDs to add; manager only." },
+          work: { type: "string", maxLength: 2e3, description: "Task description when creating a team." }
         },
         additionalProperties: false
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
       handler: async (args) => runtime.join(
-        typeof args.name === "string" ? args.name : void 0,
-        args.create === true
+        optionalString(args.name, "name"),
+        args.create === true,
+        memberArray(args.members),
+        optionalString(args.work, "work")
       )
     },
     {
@@ -2948,13 +3097,14 @@ function buildToolDefinitions(runtime) {
         properties: {
           to: { type: "string" },
           message: { type: "string" },
-          attachments: attachmentsSchema
+          attachments: attachmentsSchema,
+          team: { type: "string", description: "Task team; required when multiple teams are shared. Omit for ungrouped contact." }
         },
         required: ["to", "message"],
         additionalProperties: false
       },
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
-      handler: async (args) => runtime.send(asString(args.to, "to"), asString(args.message, "message"), asAttachmentArray(args.attachments))
+      handler: async (args) => runtime.send(asString(args.to, "to"), asString(args.message, "message"), asAttachmentArray(args.attachments), void 0, optionalString(args.team, "team"))
     },
     {
       name: "intercom_ask",
@@ -2965,6 +3115,7 @@ function buildToolDefinitions(runtime) {
           to: { type: "string" },
           message: { type: "string" },
           attachments: attachmentsSchema,
+          team: { type: "string", description: "Task team; required when multiple teams are shared." },
           timeout_ms: { type: "integer", minimum: 1, maximum: 12e4, description: "Maximum time to wait for a reply before returning an error. Use intercom_send plus intercom_pending for longer work." }
         },
         required: ["to", "message"],
@@ -2976,7 +3127,8 @@ function buildToolDefinitions(runtime) {
         asString(args.message, "message"),
         asAttachmentArray(args.attachments),
         asOptionalPositiveInteger(args.timeout_ms, "timeout_ms"),
-        signal
+        signal,
+        optionalString(args.team, "team")
       )
     },
     {
@@ -2992,19 +3144,22 @@ function buildToolDefinitions(runtime) {
     },
     {
       name: "intercom_reply",
-      description: "Reply to a pending inbound ask. Use to plus which=oldest/latest when one sender has multiple unresolved asks.",
+      description: "Reply to an inbound ask or ordinary message using askId or contextId from intercom_pending. Inherits the original team; team cannot override it.",
       inputSchema: {
         type: "object",
         properties: {
           message: { type: "string" },
           to: { type: "string", description: "Optional sender/session selector; never a message or thread ID." },
+          askId: { type: "string", description: "Stable receiver-local pending ask selector." },
+          contextId: { type: "string", description: "Exact inbound context selector, including ordinary messages." },
+          team: { type: "string", description: "Must match the original message; omit to inherit." },
           which: { type: "string", enum: ["oldest", "latest"], description: "Select the oldest or latest ask from the chosen sender." }
         },
         required: ["message"],
         additionalProperties: false
       },
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
-      handler: async (args) => runtime.reply(asString(args.message, "message"), typeof args.to === "string" ? args.to : void 0, args.which === "oldest" || args.which === "latest" ? args.which : void 0)
+      handler: async (args) => runtime.reply(asString(args.message, "message"), typeof args.to === "string" ? args.to : void 0, args.which === "oldest" || args.which === "latest" ? args.which : void 0, optionalString(args.askId, "askId"), optionalString(args.contextId, "contextId"), optionalString(args.team, "team"))
     }
   ];
   return tools;
@@ -3035,7 +3190,8 @@ async function handleMcpRequest(request, runtime) {
       return ok(request.id, {
         protocolVersion: "2025-06-18",
         capabilities: { tools: {} },
-        serverInfo: { name: "claude-intercom", version: "0.14.0" }
+        instructions: TASK_TEAM_GUIDANCE,
+        serverInfo: { name: "claude-intercom", version: "0.15.0" }
       });
     case "ping":
       return ok(request.id, {});
@@ -3072,9 +3228,9 @@ async function handleMcpRequest(request, runtime) {
 // claude/session-lifecycle.ts
 import { execFileSync } from "node:child_process";
 import { closeSync as closeSync2, openSync as openSync2, readFileSync as readFileSync7, readSync, renameSync as renameSync3, statSync, writeFileSync as writeFileSync3 } from "node:fs";
-import { basename as basename2, dirname as dirname4, join as join8 } from "node:path";
+import { basename as basename2, dirname as dirname4, join as join9 } from "node:path";
 import { StringDecoder } from "node:string_decoder";
-import { setTimeout as delay } from "node:timers/promises";
+import { setTimeout as delay2 } from "node:timers/promises";
 function findClaudeHost(pid = process.ppid) {
   for (let depth = 0; pid > 1 && depth < 16; depth++) {
     let parts;
@@ -3097,7 +3253,7 @@ function findClaudeHost(pid = process.ppid) {
   return void 0;
 }
 function claudeSessionMetadataPath(host) {
-  return join8(getIntercomDirPath(), `claude-host-${host.pid}.json`);
+  return join9(getIntercomDirPath(), `claude-host-${host.pid}.json`);
 }
 function readClaudeSessionMetadata(path, host) {
   try {
@@ -3183,7 +3339,7 @@ async function waitForClaudeSession(reader) {
   for (let attempt = 0; attempt < 20; attempt++) {
     const metadata = reader.read();
     if (metadata) return metadata;
-    await delay(50);
+    await delay2(50);
   }
   return reader.read();
 }

package/dist/inbox-monitor.mjs

@@ -33,7 +33,8 @@ function formatInboxLine(entry) {
   const who = entry.fromName ? `${entry.fromName} (${entry.fromId.slice(0, 8)})` : entry.fromId;
   const kind = entry.expectsReply ? " [asking \u2014 awaiting your reply]" : "";
   const oneLine = entry.text.replace(/\s+/g, " ").trim();
-  return `Intercom message from ${who}${kind}: ${oneLine}`;
+  return `Intercom message from ${who}${entry.team ? ` [Team: ${entry.team}]` : ""}${kind}: ${oneLine}
+Reply with intercom_reply({ contextId: "ctx-${entry.messageId}", message: "..." }); inherit the original team.`;
 }
 function inboxBatchFrom(content, alreadyEmitted) {
   const lines = content.split("\n").map((line) => line.trim()).filter(Boolean);

package/dist/worker-daemon.mjs

@@ -1190,14 +1190,15 @@ function isMessage(value) {
     }
     if (message.replyTo !== void 0 || message.expectsReply !== void 0) return false;
   }
-  if (!hasExactDataKeys(message.content, ["text"], ["attachments"])) {
+  if (!hasExactDataKeys(message.content, ["text"], ["attachments", "team"])) {
     return false;
   }
   const content = message.content;
   if (typeof content.text !== "string") {
     return false;
   }
-  if (message.control !== void 0 && (content.text !== "" || content.attachments !== void 0)) return false;
+  if (content.team !== void 0 && (typeof content.team !== "string" || !/^[A-Za-z][A-Za-z0-9_-]{0,31}$/.test(content.team))) return false;
+  if (message.control !== void 0 && (content.text !== "" || content.attachments !== void 0 || content.team !== void 0)) return false;
   return content.attachments === void 0 || isDenseArrayOf(content.attachments, isAttachment);
 }
 function isSessionInfo(value) {
@@ -1820,6 +1821,7 @@ var IntercomClient = class extends EventEmitter {
       ...options.control === void 0 ? {} : { control: options.control },
       content: {
         text: options.text,
+        ...options.team === void 0 ? {} : { team: options.team },
         ...options.attachments === void 0 ? {} : { attachments: options.attachments }
       }
     };
@@ -2479,6 +2481,7 @@ ${agent.instructions}` : "";
   return [
     `Intercom message for ${agent.name}.`,
     `From: ${formatSessionDisplay(from)} (${from.id})`,
+    ...message.content.team ? [`[Team: ${message.content.team}]`] : [],
     `Message id: ${message.id}`,
     "",
     message.content.text,
@@ -2631,7 +2634,8 @@ var VirtualClaudeAgent = class {
       if (message.expectsReply) {
         void this.client.send(from.id, {
           text: "This worker is rate limited (too many wakes this minute). Please try again shortly.",
-          replyTo: message.id
+          replyTo: message.id,
+          ...message.content.team === void 0 ? {} : { team: message.content.team }
         }).catch((error) => {
           process.stderr.write(`worker ${this.agent.id}: rate-limit reply failed: ${error instanceof Error ? error.message : String(error)}
 `);
@@ -2693,7 +2697,8 @@ var VirtualClaudeAgent = class {
       if (message.expectsReply) {
         await this.client.send(from.id, {
           text: result.result || "(the worker finished without a final message)",
-          replyTo: message.id
+          replyTo: message.id,
+          ...message.content.team === void 0 ? {} : { team: message.content.team }
         });
         process.stderr.write(`worker ${this.agent.id}: replied to ${from.name || from.id} (session ${this.sessionId ?? "none"})
 `);
@@ -2705,7 +2710,8 @@ var VirtualClaudeAgent = class {
       if (message.expectsReply) {
         await this.client.send(from.id, {
           text: `Worker error: ${text}`,
-          replyTo: message.id
+          replyTo: message.id,
+          ...message.content.team === void 0 ? {} : { team: message.content.team }
         }).catch((sendError) => {
           process.stderr.write(`worker ${this.agent.id}: error reply failed: ${sendError instanceof Error ? sendError.message : String(sendError)}
 `);