@arvoretech/hub 0.12.1 → 0.13.1

package/dist/{chunk-MDJG7IOU.js → chunk-EEGDGBJL.js}

@@ -117,7 +117,7 @@ async function checkAndAutoRegenerate(hubDir) {
       return;
     }
     console.log(chalk.yellow("\n  Detected outdated configs, auto-regenerating..."));
-    const { generators: generators2 } = await import("./generate-KSB3QH7S.js");
+    const { generators: generators2 } = await import("./generate-3UEFSWPT.js");
     const generator = generators2[result.editor];
     if (!generator) {
       console.log(chalk.red(`  Unknown editor '${result.editor}' in cache. Run 'hub generate' manually.`));
@@ -968,6 +968,88 @@ tools:
 ${body.trim()}
 `;
 }
+function hasAgentTeamsLeadMcp(mcps) {
+  if (!mcps) return false;
+  const proxyMcp = mcps.find((m) => m.upstreams && m.upstreams.length > 0);
+  const directMatch = mcps.some((m) => m.name === "agent-teams-lead");
+  const upstreamMatch = proxyMcp?.upstreams?.includes("agent-teams-lead") ?? false;
+  return directMatch || upstreamMatch;
+}
+function buildAgentTeamsSection(mcps) {
+  if (!hasAgentTeamsLeadMcp(mcps)) return "";
+  return `
+## Agent Teams
+
+This workspace has agent teams support via the \`agent-teams-lead\` MCP. You can act as a team lead, spawning multiple AI teammates that work in parallel on different tasks.
+
+**When to use agent teams** instead of sub-agents:
+- Tasks that benefit from parallel exploration (research, review, debugging)
+- Cross-layer work (frontend + backend + tests simultaneously)
+- Work where teammates need to communicate and coordinate with each other
+
+**How it works:**
+1. Use \`spawn_team\` to create a team with an objective and list of teammates (each referencing an agent file)
+2. Use \`create_task\` to add tasks to the shared task list (tasks can have dependencies and exclusive file paths)
+3. Teammates automatically claim pending tasks, do the work, and mark them complete
+4. Use \`send_message\` to communicate with teammates (or broadcast to all)
+5. Use \`wait_for_team\` to block until all tasks are resolved or teammates finish
+6. Use \`team_status\` to check progress, task states, and unread messages
+7. Use \`read_artifact\` to read outputs published by teammates
+
+**Available tools:** \`spawn_team\`, \`add_teammate\`, \`remove_teammate\`, \`create_task\`, \`team_status\`, \`send_message\`, \`wait_for_team\`, \`read_artifact\`.
+
+**Best practices:**
+- Create tasks IMMEDIATELY after spawning the team (teammates start looking for tasks right away)
+- Use \`exclusive_paths\` on tasks to prevent file conflicts between teammates
+- Use \`depends_on\` to chain tasks that must run in order
+- Keep 2-3 tasks per teammate for good throughput
+- Send a broadcast message after creating tasks to notify teammates
+- Always call \`wait_for_team\` after creating tasks to monitor completion`;
+}
+function hasAgentTeamsChatMcp(mcps) {
+  if (!mcps) return false;
+  const proxyMcp = mcps.find((m) => m.upstreams && m.upstreams.length > 0);
+  const directMatch = mcps.some((m) => m.name === "agent-teams-chat");
+  const upstreamMatch = proxyMcp?.upstreams?.includes("agent-teams-chat") ?? false;
+  return directMatch || upstreamMatch;
+}
+function buildAgentTeamsChatSection(mcps) {
+  if (!hasAgentTeamsChatMcp(mcps)) return "";
+  return `
+## Agent Chat (Cross-Developer Communication)
+
+You can communicate with agents from other developers on the team via the \`agent-teams-chat\` MCP. This is NOT the same as agent teams (which coordinates teammates within your own session). Agent chat lets you talk to agents running in other people's workspaces through Slack threads.
+
+**When to use agent chat:**
+- You need context or help from another developer's agent (e.g. "Hey, Jo\xE3o's agent \u2014 what was the decision on the auth migration?")
+- Coordinating cross-developer work asynchronously (e.g. "I'm changing the API contract, heads up")
+- Sharing decisions, blockers, or discoveries that affect the whole team
+- Asking questions that another developer's agent might already know the answer to
+
+**How it works:**
+1. Use \`open_thread\` to start a new conversation thread about a topic
+2. Use \`reply_to_thread\` to respond in an existing thread
+3. Use \`read_thread\` to catch up on what others have said
+4. Use \`list_threads\` to see recent conversations in the channel
+5. Use \`find_thread\` to search for threads by topic or content
+
+**Available tools:** \`open_thread\`, \`reply_to_thread\`, \`read_thread\`, \`list_threads\`, \`find_thread\`.
+
+**Message format:** Messages are automatically formatted with your identity (e.g. \`\u{1F916} *Jo\xE3o's Agent* \u2014 your message here\`). Other agents' messages will show their owner's name.
+
+**IMPORTANT \u2014 Proactive message checking:**
+- When you open or reply to a thread, periodically check for new replies using \`read_thread\` with the \`since\` parameter set to the last message timestamp you saw
+- After sending a message that expects a response, wait a reasonable time (30-60 seconds) then check for replies
+- At the start of a task, use \`list_threads\` to check if there are recent threads relevant to your current work
+- If you're waiting on another agent's input, poll the thread every 30-60 seconds until you get a response or a reasonable timeout (5 minutes)
+
+**Best practices:**
+- Search for existing threads before opening a new one on the same topic
+- Keep messages concise and actionable
+- Use threads to maintain context \u2014 avoid top-level messages for replies
+- Read the thread before replying to avoid repeating what others said
+- When starting a task that touches shared code, check recent threads for relevant context`;
+}
 function buildMcpToolsSection(mcps) {
   if (!mcps || mcps.length === 0) return "";
   const proxyMcp = mcps.find((m) => m.upstreams && m.upstreams.length > 0);
@@ -1108,6 +1190,10 @@ Available tools: \`search_memories\`, \`get_memory\`, \`add_memory\`, \`list_mem
   }
   const designSectionOpenCode = buildDesignSection(config);
   if (designSectionOpenCode) sections.push(designSectionOpenCode);
+  const agentTeamsSectionOpenCode = buildAgentTeamsSection(config.mcps);
+  if (agentTeamsSectionOpenCode) sections.push(agentTeamsSectionOpenCode);
+  const agentTeamsChatSectionOpenCode = buildAgentTeamsChatSection(config.mcps);
+  if (agentTeamsChatSectionOpenCode) sections.push(agentTeamsChatSectionOpenCode);
   sections.push(`
 ## Troubleshooting and Debugging
 
@@ -1401,6 +1487,10 @@ Available tools: \`search_memories\`, \`get_memory\`, \`add_memory\`, \`list_mem
   }
   const designSectionKiro = buildDesignSection(config);
   if (designSectionKiro) sections.push(designSectionKiro);
+  const agentTeamsSectionKiro = buildAgentTeamsSection(config.mcps);
+  if (agentTeamsSectionKiro) sections.push(agentTeamsSectionKiro);
+  const agentTeamsChatSectionKiro = buildAgentTeamsChatSection(config.mcps);
+  if (agentTeamsChatSectionKiro) sections.push(agentTeamsChatSectionKiro);
   sections.push(`
 ## Troubleshooting and Debugging
 
@@ -1589,6 +1679,10 @@ Available tools: \`search_memories\`, \`get_memory\`, \`add_memory\`, \`list_mem
   }
   const designSectionCursor = buildDesignSection(config);
   if (designSectionCursor) sections.push(designSectionCursor);
+  const agentTeamsSectionCursor = buildAgentTeamsSection(config.mcps);
+  if (agentTeamsSectionCursor) sections.push(agentTeamsSectionCursor);
+  const agentTeamsChatSectionCursor = buildAgentTeamsChatSection(config.mcps);
+  if (agentTeamsChatSectionCursor) sections.push(agentTeamsChatSectionCursor);
   sections.push(`
 ## Troubleshooting and Debugging
 

package/dist/config/index.d.ts

@@ -194,6 +194,8 @@ declare const mcp: {
     googleChat(overrides?: MCPOverrides): MCPConfig;
     playwright(overrides?: MCPOverrides): MCPConfig;
     context7(overrides?: MCPOverrides): MCPConfig;
+    agentTeamsLead(overrides?: MCPOverrides): MCPConfig;
+    agentTeamsChat(overrides?: MCPOverrides): MCPConfig;
     proxy(name: string, overrides: MCPOverrides & {
         upstreams: string[];
     }): MCPConfig;

package/dist/config/index.js

@@ -194,6 +194,22 @@ var mcp = {
       ...overrides
     };
   },
+  agentTeamsLead(overrides) {
+    return {
+      name: "agent-teams-lead",
+      package: "@arvoretech/agent-teams-lead-mcp",
+      ...overrides,
+      env: { ...overrides?.env }
+    };
+  },
+  agentTeamsChat(overrides) {
+    return {
+      name: "agent-teams-chat",
+      package: "@arvoretech/agent-teams-chat-mcp",
+      ...overrides,
+      env: { ...overrides?.env }
+    };
+  },
   proxy(name, overrides) {
     return {
       name,

package/dist/{generate-KSB3QH7S.js → generate-3UEFSWPT.js}

@@ -1,7 +1,7 @@
 import {
   generateCommand,
   generators
-} from "./chunk-MDJG7IOU.js";
+} from "./chunk-EEGDGBJL.js";
 import "./chunk-VMN4KGAK.js";
 export {
   generateCommand,

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   checkAndAutoRegenerate,
   generateCommand
-} from "./chunk-MDJG7IOU.js";
+} from "./chunk-EEGDGBJL.js";
 import {
   loadHubConfig,
   resolveConfigPath
@@ -761,6 +761,8 @@ var AVAILABLE_MCPS = [
   { name: "meet-transcriptions", description: "Semantic search across meeting transcriptions" },
   { name: "google-chat", description: "Google Chat spaces, members, and messages" },
   { name: "tempmail", description: "Temporary email for testing" },
+  { name: "agent-teams-lead", description: "Spawn AI teammate teams that work in parallel on tasks" },
+  { name: "agent-teams-chat", description: "Cross-developer agent communication via Slack threads" },
   { name: "mcp-proxy", description: "Proxy gateway that reduces token usage via mcp_search/mcp_call" }
 ];
 
@@ -1275,6 +1277,8 @@ var MCP_HELPER_MAP = {
   "google-chat": { helper: "mcp.googleChat", hasNameArg: false },
   playwright: { helper: "mcp.playwright", hasNameArg: false },
   context7: { helper: "mcp.context7", hasNameArg: false },
+  "agent-teams-lead": { helper: "mcp.agentTeamsLead", hasNameArg: false },
+  "agent-teams-chat": { helper: "mcp.agentTeamsChat", hasNameArg: false },
   "mcp-proxy": { helper: "mcp.proxy", hasNameArg: true }
 };
 function buildTypeScriptConfig(state) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvoretech/hub",
-  "version": "0.12.1",
+  "version": "0.13.1",
   "description": "CLI for managing AI-aware multi-repository workspaces",
   "main": "dist/index.js",
   "type": "module",