@bradygaster/squad-cli 0.8.25 → 0.9.0

package/dist/cli/shell/coordinator.js

@@ -1,5 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { listRoles, searchRoles } from '@bradygaster/squad-sdk';
 /** Debug logger — writes to stderr only when SQUAD_DEBUG=1. */
 function debugLog(...args) {
     if (process.env['SQUAD_DEBUG'] === '1') {
@@ -26,50 +27,167 @@ export function hasRosterEntries(teamContent) {
 /**
  * Build an Init Mode system prompt for team casting.
  * Used when team.md exists but has no roster entries.
+ *
+ * When `config.useBaseRoles` is true (opt-in via `--roles`), the prompt
+ * includes the built-in base roles catalog so the LLM maps agents to
+ * curated role IDs. Otherwise (default), the LLM casts from a fictional
+ * universe with free-form role names — the beloved casting experience.
  */
 export function buildInitModePrompt(config) {
-    return `You are the Squad Coordinator in Init Mode.
-
-This project has a Squad scaffold (.squad/ directory) but no team has been cast yet.
-The user's message describes what they want to build or work on.
-
-Your job: Propose a team of 4-5 AI agents based on what the user wants to do.
-
-## Rules
-1. Analyze the user's message to understand the project (language, stack, scope)
-2. Pick a fictional universe for character names (e.g., Alien, The Usual Suspects, Blade Runner, The Matrix, Heat, Star Wars). Pick ONE universe and use it consistently.
-3. Propose 4-5 agents with roles that match the project needs
-4. Scribe and Ralph are always included automatically — do NOT include them in your proposal
-
-## Response Format — you MUST use this EXACT format:
-
-INIT_TEAM:
-- {Name} | {Role} | {scope: 2-4 words describing expertise}
-- {Name} | {Role} | {scope}
-- {Name} | {Role} | {scope}
-- {Name} | {Role} | {scope}
-UNIVERSE: {universe name}
-PROJECT: {1-sentence project description}
-
-## Example
-
-If user says "Build a React app with a Node backend":
-
-INIT_TEAM:
-- Ripley | Lead | Architecture, code review, decisions
-- Dallas | Frontend Dev | React, components, styling
-- Kane | Backend Dev | Node.js, APIs, database
-- Lambert | Tester | Tests, quality, edge cases
-UNIVERSE: Alien
-PROJECT: A React and Node.js web application
-
-## Important
-- Use character names that feel natural, not forced
-- Roles should match project needs (don't always use the same 4 roles)
-- For CLI projects: maybe skip Frontend, add DevOps or SDK Expert
-- For data projects: add Data Engineer, skip Frontend
-- Keep scope descriptions short (2-4 words each)
-- Respond ONLY with the INIT_TEAM block — no other text
+    if (config.useBaseRoles) {
+        return buildBaseRolesInitPrompt();
+    }
+    return buildUniverseCastingInitPrompt();
+}
+/**
+ * Default init prompt — fictional universe casting (no base roles catalog).
+ */
+function buildUniverseCastingInitPrompt() {
+    return `You are the Squad Coordinator in Init Mode.
+
+This project has a Squad scaffold (.squad/ directory) but no team has been cast yet.
+The user's message describes what they want to build or work on.
+
+Your job: Propose a team of 4-5 AI agents based on what the user wants to do.
+
+## Rules
+1. Analyze the user's message to understand the project (language, stack, scope)
+2. Pick a fictional universe for character names. **Strongly prefer:**
+   - **The Usual Suspects** (8 characters: Keyser, McManus, Fenster, Verbal, Hockney, Redfoot, Edie, Kobayashi)
+   - **Ocean's Eleven** (10 characters: Danny, Rusty, Linus, Basher, Livingston, Saul, Yen, Virgil, Turk, Reuben)
+   
+   You may also choose other film universes (Alien, The Matrix, Heat, Star Wars, Blade Runner, etc.) but the two above are preferred.
+3. Propose 4-5 agents with roles that match the project needs
+4. Scribe and Ralph are always included automatically — do NOT include them in your proposal
+
+## Response Format — you MUST use this EXACT format:
+
+INIT_TEAM:
+- {Name} | {Role} | {scope: 2-4 words describing expertise}
+- {Name} | {Role} | {scope}
+- {Name} | {Role} | {scope}
+- {Name} | {Role} | {scope}
+UNIVERSE: {universe name}
+PROJECT: {1-sentence project description}
+
+## Example
+
+If user says "Build a React app with a Node backend":
+
+INIT_TEAM:
+- Ripley | Lead | Architecture, code review, decisions
+- Dallas | Frontend Dev | React, components, styling
+- Kane | Backend Dev | Node.js, APIs, database
+- Lambert | Tester | Tests, quality, edge cases
+UNIVERSE: Alien
+PROJECT: A React and Node.js web application
+
+## Important
+- Use character names that feel natural, not forced
+- Roles should match project needs (don't always use the same 4 roles)
+- For CLI projects: maybe skip Frontend, add DevOps or SDK Expert
+- For data projects: add Data Engineer, skip Frontend
+- Keep scope descriptions short (2-4 words each)
+- Respond ONLY with the INIT_TEAM block — no other text
+`;
+}
+/**
+ * Opt-in base roles init prompt — includes the curated role catalog.
+ * Activated by `squad init --roles` or `/init --roles`.
+ */
+function buildBaseRolesInitPrompt() {
+    const catalog = new Map(listRoles().map((role) => [role.id, role]));
+    const resolveRole = (id) => catalog.get(id) ?? searchRoles(id)[0];
+    const formatRole = (id, label) => {
+        const role = resolveRole(id);
+        const title = role?.title ?? label;
+        return `  ${id.padEnd(22, ' ')} — ${title}`;
+    };
+    const softwareRoles = [
+        ['lead', 'Lead / Architect'],
+        ['frontend', 'Frontend Developer'],
+        ['backend', 'Backend Developer'],
+        ['fullstack', 'Full-Stack Developer'],
+        ['reviewer', 'Code Reviewer'],
+        ['tester', 'Test Engineer'],
+        ['devops', 'DevOps Engineer'],
+        ['security', 'Security Engineer'],
+        ['data', 'Data Engineer'],
+        ['docs', 'Technical Writer'],
+        ['ai', 'AI / ML Engineer'],
+        ['designer', 'UI/UX Designer'],
+    ];
+    const businessRoles = [
+        ['marketing-strategist', 'Marketing Strategist'],
+        ['sales-strategist', 'Sales Strategist'],
+        ['product-manager', 'Product Manager'],
+        ['project-manager', 'Project Manager'],
+        ['support-specialist', 'Support Specialist'],
+        ['game-developer', 'Game Developer'],
+        ['media-buyer', 'Media Buyer'],
+        ['compliance-legal', 'Compliance & Legal'],
+    ];
+    const softwareRoleLines = softwareRoles.map(([id, label]) => formatRole(id, label)).join('\n');
+    const businessRoleLines = businessRoles.map(([id, label]) => formatRole(id, label)).join('\n');
+    return `You are the Squad Coordinator in Init Mode.
+
+This project has a Squad scaffold (.squad/ directory) but no team has been cast yet.
+The user's message describes what they want to build or work on.
+
+Your job: Propose a team of 4-5 AI agents based on what the user wants to do.
+
+## Rules
+1. Analyze the user's message to understand the project (language, stack, scope)
+2. Pick a fictional universe for character names (e.g., Alien, The Usual Suspects, Blade Runner, The Matrix, Heat, Star Wars). Pick ONE universe and use it consistently.
+3. Propose 4-5 agents with roles that match the project needs
+4. Scribe and Ralph are always included automatically — do NOT include them in your proposal
+
+## Built-in Base Roles (use these as starting points)
+
+The following base roles are available. Prefer these over inventing new roles — they have deep, curated charter content.
+When proposing a team, match the user's project needs to these roles first.
+Only propose a custom role if none of the base roles fit.
+
+Software Development:
+${softwareRoleLines}
+
+Business & Operations:
+${businessRoleLines}
+
+When proposing a team member, use the role ID from above in the Role field.
+Example: "- Ripley | lead | Architecture, code review, decisions"
+This tells the system to use the pre-built Lead/Architect charter content.
+If you use a role not in this list, the system will generate a generic charter instead.
+
+## Response Format — you MUST use this EXACT format:
+
+INIT_TEAM:
+- {Name} | {Role} | {scope: 2-4 words describing expertise}
+- {Name} | {Role} | {scope}
+- {Name} | {Role} | {scope}
+- {Name} | {Role} | {scope}
+UNIVERSE: {universe name}
+PROJECT: {1-sentence project description}
+
+## Example
+
+If user says "Build a React app with a Node backend":
+
+INIT_TEAM:
+- Ripley | lead | Architecture, code review, decisions
+- Dallas | frontend | React, components, styling
+- Kane | backend | Node.js, APIs, database
+- Lambert | tester | Tests, quality, edge cases
+UNIVERSE: Alien
+PROJECT: A React and Node.js web application
+
+## Important
+- Use character names that feel natural, not forced
+- Roles should match project needs (don't always use the same 4 roles)
+- For CLI projects: maybe skip Frontend, add DevOps or SDK Expert
+- For data projects: add Data Engineer, skip Frontend
+- Keep scope descriptions short (2-4 words each)
+- Respond ONLY with the INIT_TEAM block — no other text
 `;
 }
 /**
@@ -84,29 +202,29 @@ export function buildCoordinatorPrompt(config) {
     try {
         teamContent = readFileSync(teamPath, 'utf-8');
         if (!hasRosterEntries(teamContent)) {
-            teamContent = `⚠️ NO TEAM CONFIGURED
-
-This project doesn't have a Squad team yet.
-
-**You MUST NOT do any project work.** Instead, tell the user:
-1. "This project doesn't have a Squad team yet."
-2. Suggest running \`squad init\` or the \`/init\` command to set one up.
-3. Politely refuse any work requests until init is done.
-
+            teamContent = `⚠️ NO TEAM CONFIGURED
+
+This project doesn't have a Squad team yet.
+
+**You MUST NOT do any project work.** Instead, tell the user:
+1. "This project doesn't have a Squad team yet."
+2. Suggest running \`squad init\` or the \`/init\` command to set one up.
+3. Politely refuse any work requests until init is done.
+
 Do not answer coding questions, route to agents, or perform any project tasks.`;
         }
     }
     catch (err) {
         debugLog('buildCoordinatorPrompt: failed to read team.md at', teamPath, err);
-        teamContent = `⚠️ NO TEAM CONFIGURED
-
-This project doesn't have a Squad team yet.
-
-**You MUST NOT do any project work.** Instead, tell the user:
-1. "This project doesn't have a Squad team yet."
-2. Suggest running \`squad init\` or the \`/init\` command to set one up.
-3. Politely refuse any work requests until init is done.
-
+        teamContent = `⚠️ NO TEAM CONFIGURED
+
+This project doesn't have a Squad team yet.
+
+**You MUST NOT do any project work.** Instead, tell the user:
+1. "This project doesn't have a Squad team yet."
+2. Suggest running \`squad init\` or the \`/init\` command to set one up.
+3. Politely refuse any work requests until init is done.
+
 Do not answer coding questions, route to agents, or perform any project tasks.`;
     }
     // Load routing.md for routing rules
@@ -119,34 +237,34 @@ Do not answer coding questions, route to agents, or perform any project tasks.`;
         debugLog('buildCoordinatorPrompt: failed to read routing.md at', routingPath, err);
         routingContent = '(No routing.md found — run `squad init` to create one)';
     }
-    return `You are the Squad Coordinator — you route work to the right agent.
-
-## Team Roster
-${teamContent}
-
-## Routing Rules
-${routingContent}
-
-## Your Job
-1. Read the user's message
-2. Decide which agent(s) should handle it based on routing rules
-3. If naming a specific agent ("Fenster, fix the bug"), route directly
-4. If ambiguous, pick the best match and explain your choice
-5. For status/factual questions, answer directly without spawning
-
-## Response Format
-When routing to an agent, respond with:
-ROUTE: {agent_name}
-TASK: {what the agent should do}
-CONTEXT: {any relevant context}
-
-When answering directly:
-DIRECT: {your answer}
-
-When routing to multiple agents:
-MULTI:
-- {agent1}: {task1}
-- {agent2}: {task2}
+    return `You are the Squad Coordinator — you route work to the right agent.
+
+## Team Roster
+${teamContent}
+
+## Routing Rules
+${routingContent}
+
+## Your Job
+1. Read the user's message
+2. Decide which agent(s) should handle it based on routing rules
+3. If naming a specific agent ("Fenster, fix the bug"), route directly
+4. If ambiguous, pick the best match and explain your choice
+5. For status/factual questions, answer directly without spawning
+
+## Response Format
+When routing to an agent, respond with:
+ROUTE: {agent_name}
+TASK: {what the agent should do}
+CONTEXT: {any relevant context}
+
+When answering directly:
+DIRECT: {your answer}
+
+When routing to multiple agents:
+MULTI:
+- {agent1}: {task1}
+- {agent2}: {task2}
 `;
 }
 export function parseCoordinatorResponse(response) {

package/dist/cli/shell/coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../src/cli/shell/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,+DAA+D;AAC/D,SAAS,QAAQ,CAAC,GAAG,IAAe;IAClC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,GAAG,EAAE,CAAC;QACvC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAClF,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACvB,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;YACjC,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CR,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAyB;IAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;IAElC,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzE,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,WAAW,GAAG;;;;;;;;;+EAS2D,CAAC;QAC5E,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,mDAAmD,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7E,WAAW,GAAG;;;;;;;;;+EAS6D,CAAC;IAC9E,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAClF,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,cAAc,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,sDAAsD,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QACnF,cAAc,GAAG,wDAAwD,CAAC;IAC5E,CAAC;IAED,OAAO;;;EAGP,WAAW;;;EAGX,cAAc;;;;;;;;;;;;;;;;;;;;;;CAsBf,CAAC;AACF,CAAC;AAWD,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEhC,gBAAgB;IAChB,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;SACrD,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,KAAK;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE;YACP,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAC7C,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAwC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACnE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,CAAC;wBACP,KAAK,EAAE,UAAU,CAAC,CAAC,CAAE;wBACrB,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;wBAC1B,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;qBAC3B,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAwB,EACxB,cAAsB,EAAE;IAExB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;IAC5C,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;QAChE,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../src/cli/shell/coordinator.ts"],"names":[],"mappings":"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"}

package/dist/cli/shell/error-messages.d.ts

@@ -14,8 +14,22 @@ export declare function sdkDisconnectGuidance(detail?: string): ErrorGuidance;
 export declare function teamConfigGuidance(issue: string): ErrorGuidance;
 /** Agent session failure */
 export declare function agentSessionGuidance(agentName: string, detail?: string): ErrorGuidance;
+/**
+ * Extract retry-after duration (in seconds) from an error message string.
+ * Handles patterns like "retry after 120 seconds", "try again in 2 hours", etc.
+ */
+export declare function extractRetryAfter(message: string): number | undefined;
+/** Rate limit hit — model or endpoint temporarily throttled */
+export declare function rateLimitGuidance(opts?: {
+    retryAfter?: number;
+    model?: string;
+}): ErrorGuidance;
 /** Generic error with context */
 export declare function genericGuidance(detail: string): ErrorGuidance;
+/** Request timeout */
+export declare function timeoutGuidance(agentName?: string): ErrorGuidance;
+/** Unknown slash command */
+export declare function unknownCommandGuidance(command: string): ErrorGuidance;
 /** Format an ErrorGuidance into a user-facing string */
 export declare function formatGuidance(g: ErrorGuidance): string;
 //# sourceMappingURL=error-messages.d.ts.map

package/dist/cli/shell/error-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-messages.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/error-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CASpE;AAED,iCAAiC;AACjC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAS/D;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAStF;AAED,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAQ7D;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CASvD"}
+{"version":3,"file":"error-messages.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/error-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CASpE;AAED,iCAAiC;AACjC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAS/D;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAStF;AAWD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrE;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAa/F;AAED,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAS7D;AAED,sBAAsB;AACtB,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAUjE;AAED,4BAA4B;AAC5B,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAQrE;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CASvD"}

package/dist/cli/shell/error-messages.js

@@ -37,13 +37,77 @@ export function agentSessionGuidance(agentName, detail) {
         ],
     };
 }
+/** Format seconds into a human-readable duration string */
+function formatDuration(seconds) {
+    const hours = Math.ceil(seconds / 3600);
+    const minutes = Math.ceil(seconds / 60);
+    if (seconds >= 3600)
+        return `${hours} hour${hours === 1 ? '' : 's'}`;
+    if (seconds >= 60)
+        return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+    return `${seconds} second${seconds === 1 ? '' : 's'}`;
+}
+/**
+ * Extract retry-after duration (in seconds) from an error message string.
+ * Handles patterns like "retry after 120 seconds", "try again in 2 hours", etc.
+ */
+export function extractRetryAfter(message) {
+    const secMatch = message.match(/retry.{0,15}after\s+(\d+)\s*second/i);
+    if (secMatch)
+        return parseInt(secMatch[1], 10);
+    const hrMatch = message.match(/(?:try again|retry).{0,20}in\s+(\d+)\s*hour/i);
+    if (hrMatch)
+        return parseInt(hrMatch[1], 10) * 3600;
+    const minMatch = message.match(/(?:try again|retry).{0,20}in\s+(\d+)\s*minute/i);
+    if (minMatch)
+        return parseInt(minMatch[1], 10) * 60;
+    return undefined;
+}
+/** Rate limit hit — model or endpoint temporarily throttled */
+export function rateLimitGuidance(opts) {
+    const modelStr = opts?.model ? ` for ${opts.model}` : '';
+    const retryStr = opts?.retryAfter
+        ? `Try again in ${formatDuration(opts.retryAfter)}`
+        : 'Try again later when the limit resets';
+    return {
+        message: `Rate limit reached${modelStr}. Copilot has temporarily throttled your requests.`,
+        recovery: [
+            retryStr,
+            'Enable economy mode to switch to cheaper models: `squad economy on`',
+            'Or set a different model: add `"defaultModel": "gpt-4.1"` to .squad/config.json',
+        ],
+    };
+}
 /** Generic error with context */
 export function genericGuidance(detail) {
     return {
         message: detail,
         recovery: [
-            'Try again',
+            'Try your message again',
             "Run 'squad doctor' for diagnostics",
+            'Check your internet connection',
+        ],
+    };
+}
+/** Request timeout */
+export function timeoutGuidance(agentName) {
+    const who = agentName ? `${agentName} timed out` : 'Request timed out';
+    return {
+        message: `${who}. The model may be under load.`,
+        recovery: [
+            'Try again — the issue is often transient',
+            'Set SQUAD_REPL_TIMEOUT=120 for a longer timeout (seconds)',
+            "Run 'squad doctor' to verify connectivity",
+        ],
+    };
+}
+/** Unknown slash command */
+export function unknownCommandGuidance(command) {
+    return {
+        message: `Unknown command: /${command}`,
+        recovery: [
+            'Type /help to see available commands',
+            'Check for typos in the command name',
         ],
     };
 }

package/dist/cli/shell/error-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-messages.js","sourceRoot":"","sources":["../../../src/cli/shell/error-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,yCAAyC;AACzC,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC,CAAC,mBAAmB;QACrE,QAAQ,EAAE;YACR,wCAAwC;YACxC,gCAAgC;YAChC,gCAAgC;SACjC;KACF,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO;QACL,OAAO,EAAE,6BAA6B,KAAK,EAAE;QAC7C,QAAQ,EAAE;YACR,gCAAgC;YAChC,wCAAwC;YACxC,gDAAgD;SACjD;KACF,CAAC;AACJ,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,MAAe;IACrE,OAAO;QACL,OAAO,EAAE,GAAG,SAAS,kBAAkB,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;QACrE,QAAQ,EAAE;YACR,sDAAsD;YACtD,mCAAmC;YACnC,QAAQ,SAAS,oBAAoB;SACtC;KACF,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO;QACL,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE;YACR,WAAW;YACX,oCAAoC;SACrC;KACF,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,CAAgB;IAC7C,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"error-messages.js","sourceRoot":"","sources":["../../../src/cli/shell/error-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,yCAAyC;AACzC,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC,CAAC,mBAAmB;QACrE,QAAQ,EAAE;YACR,wCAAwC;YACxC,gCAAgC;YAChC,gCAAgC;SACjC;KACF,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO;QACL,OAAO,EAAE,6BAA6B,KAAK,EAAE;QAC7C,QAAQ,EAAE;YACR,gCAAgC;YAChC,wCAAwC;YACxC,gDAAgD;SACjD;KACF,CAAC;AACJ,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,MAAe;IACrE,OAAO;QACL,OAAO,EAAE,GAAG,SAAS,kBAAkB,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;QACrE,QAAQ,EAAE;YACR,sDAAsD;YACtD,mCAAmC;YACnC,QAAQ,SAAS,oBAAoB;SACtC;KACF,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACxC,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACrE,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACzE,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACtE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC9E,IAAI,OAAO;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACjF,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;IACrD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,IAA8C;IAC9E,MAAM,QAAQ,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,EAAE,UAAU;QAC/B,CAAC,CAAC,gBAAgB,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;QACnD,CAAC,CAAC,uCAAuC,CAAC;IAC5C,OAAO;QACL,OAAO,EAAE,qBAAqB,QAAQ,oDAAoD;QAC1F,QAAQ,EAAE;YACR,QAAQ;YACR,qEAAqE;YACrE,iFAAiF;SAClF;KACF,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO;QACL,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE;YACR,wBAAwB;YACxB,oCAAoC;YACpC,gCAAgC;SACjC;KACF,CAAC;AACJ,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,eAAe,CAAC,SAAkB;IAChD,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,YAAY,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACvE,OAAO;QACL,OAAO,EAAE,GAAG,GAAG,gCAAgC;QAC/C,QAAQ,EAAE;YACR,0CAA0C;YAC1C,2DAA2D;YAC3D,2CAA2C;SAC5C;KACF,CAAC;AACJ,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO;QACL,OAAO,EAAE,qBAAqB,OAAO,EAAE;QACvC,QAAQ,EAAE;YACR,sCAAsC;YACtC,qCAAqC;SACtC;KACF,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,CAAgB;IAC7C,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/cli/shell/index.d.ts

@@ -29,7 +29,7 @@ export type { SessionData, SessionSummary } from './session-store.js';
 export { App } from './components/App.js';
 export type { ShellApi, AppProps } from './components/App.js';
 export { ErrorBoundary } from './components/ErrorBoundary.js';
-export { sdkDisconnectGuidance, teamConfigGuidance, agentSessionGuidance, genericGuidance, formatGuidance, } from './error-messages.js';
+export { sdkDisconnectGuidance, teamConfigGuidance, agentSessionGuidance, genericGuidance, rateLimitGuidance, extractRetryAfter, timeoutGuidance, unknownCommandGuidance, formatGuidance, } from './error-messages.js';
 export type { ErrorGuidance } from './error-messages.js';
 export { enableShellMetrics, recordShellSessionDuration, recordAgentResponseLatency, recordShellError, isShellTelemetryEnabled, _resetShellMetrics, } from './shell-metrics.js';
 /** Options for ghost response retry. */

package/dist/cli/shell/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/index.ts"],"names":[],"mappings":"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"}