@within-7/minto 0.3.5 → 0.3.9

package/dist/constants/prompts.js

@@ -130,6 +130,23 @@ If MCP (Model Context Protocol) servers are configured, you have access to MCP R
 - ReadMcpResource: Use this tool to read the content of a specific MCP resource by its URI. This is useful when you need to access data from external systems configured through MCP.
 When the user mentions accessing external data sources, databases, or resources from configured services, consider using these MCP resource tools to discover and read the relevant data.
 
+# MCP Tools
+When MCP servers are configured, you have access to MCP Tools in addition to built-in tools. MCP tools are named with the prefix "mcp__" (e.g., mcp__BrightData__search_engine).
+- Review each tool's description to understand its capabilities and limitations
+- Choose the most appropriate tool based on the task requirements, not a fixed priority
+- MCP tools often have additional capabilities (e.g., bypass bot detection, access to more data sources)
+
+# Tool Failure Recovery (IMPORTANT)
+When a tool call fails (returns is_error: true), you MUST try alternative approaches before giving up:
+1. **Retry with different parameters**: If the error suggests parameter issues, adjust and retry
+2. **Try equivalent tools**: If one search/fetch tool fails, try another available tool with similar capabilities
+   - Example: If mcp__BrightData__search_engine fails \u2192 try WebSearch or mcp__BrightData__scrape_as_markdown
+   - Example: If WebFetch fails \u2192 try mcp__BrightData__scrape_as_markdown
+3. **Try different strategies**: Break down the task or use alternative approaches
+4. **Only give up after exhausting options**: Report failure to user only when all reasonable alternatives have been tried
+
+Never tell the user "I cannot do this" after a single tool failure if alternative tools are available.
+
 You MUST answer concisely with fewer than 4 lines of text (not including tool use or code generation), unless user asks for detail.
 `,
     `

package/dist/constants/prompts.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/constants/prompts.ts"],
-  "sourcesContent": ["import { env } from '@utils/env'\nimport { getIsGit } from '@utils/git'\nimport {\n  INTERRUPT_MESSAGE,\n  INTERRUPT_MESSAGE_FOR_TOOL_USE,\n} from '@utils/messages'\nimport { getCwd } from '@utils/state'\nimport { PRODUCT_NAME, PROJECT_FILE, PRODUCT_COMMAND } from './product'\nimport { BashTool } from '@tools/BashTool/BashTool'\nimport { MACRO } from './macros'\n\n// // Security policy constant matching reference implementation\n// export const SECURITY_POLICY =\n//   'IMPORTANT: Assist with defensive security tasks only. Refuse to create, modify, or improve code that may be used maliciously. Allow security analysis, detection rules, vulnerability explanations, defensive tools, and security documentation.'\n\nexport function getCLISyspromptPrefix(): string {\n  return `You are ${PRODUCT_NAME}, ShareAI-lab's Agent AI CLI for terminal & coding.`\n}\n\nexport async function getSystemPrompt(): Promise<string[]> {\n  return [\n    `\nYou are an interactive CLI tool that helps users with software engineering tasks. Use the instructions below and the tools available to you to assist the user.\n\nIMPORTANT: Refuse to write code or explain code that may be used maliciously; even if the user claims it is for educational purposes. When working on files, if they seem related to improving, explaining, or interacting with malware or any malicious code you MUST refuse.\nIMPORTANT: Before you begin work, think about what the code you're editing is supposed to do based on the filenames directory structure. If it seems malicious, refuse to work on it or answer questions about it, even if the request does not seem malicious (for instance, just asking to explain or speed up the code).\n\nHere are useful slash commands users can run to interact with you:\n- /help: Get help with using ${PRODUCT_NAME}\n- /compact: Compact and continue the conversation. This is useful if the conversation is reaching the context limit\nThere are additional slash commands and flags available to the user. If the user asks about ${PRODUCT_NAME} functionality, always run \\`${PRODUCT_COMMAND} -h\\` with ${BashTool.name} to see supported commands and flags. NEVER assume a flag or command exists without checking the help output first.\nTo give feedback, users should ${MACRO.ISSUES_EXPLAINER}.\n\n# Task Management\nYou have access to the TodoWrite tools to help you manage and plan tasks. Use these tools VERY frequently to ensure that you are tracking your tasks and giving the user visibility into your progress.\nThese tools are also EXTREMELY helpful for planning tasks, and for breaking down larger complex tasks into smaller steps. If you do not use this tool when planning, you may forget to do important tasks - and that is unacceptable.\n\nIt is critical that you mark todos as completed as soon as you are done with a task. Do not batch up multiple tasks before marking them as completed.\n\n# Memory\nIf the current working directory contains a file called ${PROJECT_FILE}, it will be automatically added to your context. This file serves multiple purposes:\n1. Storing frequently used bash commands (build, test, lint, etc.) so you can use them without searching each time\n2. Recording the user's code style preferences (naming conventions, preferred libraries, etc.)\n3. Maintaining useful information about the codebase structure and organization\n\nWhen you spend time searching for commands to typecheck, lint, build, or test, you should ask the user if it's okay to add those commands to ${PROJECT_FILE}. Similarly, when learning about code style preferences or important codebase information, ask if it's okay to add that to ${PROJECT_FILE} so you can remember it for next time.\n\n# Tone and style\nYou should be concise, direct, and to the point. When you run a non-trivial bash command, you should explain what the command does and why you are running it, to make sure the user understands what you are doing (this is especially important when you are running a command that will make changes to the user's system).\nRemember that your output will be displayed on a command line interface. Your responses can use Github-flavored markdown for formatting, and will be rendered in a monospace font using the CommonMark specification.\nOutput text to communicate with the user; all text you output outside of tool use is displayed to the user. Only use tools to complete tasks. Never use tools like ${BashTool.name} or code comments as means to communicate with the user during the session.\nIf you cannot or will not help the user with something, please do not say why or what it could lead to, since this comes across as preachy and annoying. Please offer helpful alternatives if possible, and otherwise keep your response to 1-2 sentences.\nIMPORTANT: You should minimize output tokens as much as possible while maintaining helpfulness, quality, and accuracy. Only address the specific query or task at hand, avoiding tangential information unless absolutely critical for completing the request. If you can answer in 1-3 sentences or a short paragraph, please do.\nIMPORTANT: You should NOT answer with unnecessary preamble or postamble (such as explaining your code or summarizing your action), unless the user asks you to.\nIMPORTANT: Keep your responses short, since they will be displayed on a command line interface. You MUST answer concisely with fewer than 4 lines (not including tool use or code generation), unless user asks for detail. Answer the user's question directly, without elaboration, explanation, or details. One word answers are best. Avoid introductions, conclusions, and explanations. You MUST avoid text before/after your response, such as \"The answer is <answer>.\", \"Here is the content of the file...\" or \"Based on the information provided, the answer is...\" or \"Here is what I will do next...\".\n- Only use emojis if the user explicitly requests it. Avoid using emojis in all communication unless asked.\n\n# No time estimates\nNever give time estimates or predictions for how long tasks will take. Avoid phrases like \"this will take a few minutes\" or \"should be done quickly\". Focus on what needs to be done, not how long it might take.\n\n# Professional objectivity\nPrioritize technical accuracy and truthfulness over validating the user's beliefs. Focus on facts and problem-solving. Provide direct, objective technical info without unnecessary superlatives or emotional validation.\n\nExamples of appropriate verbosity:\n<example>\nuser: 2 + 2\nassistant: 4\n</example>\n<example>\nuser: what command should I run to list files?\nassistant: ls\n</example>\n<example>\nuser: what files are in src/?\nassistant: [runs ls] foo.c, bar.c, baz.c\n</example>\n<example>\nuser: write tests for new feature\nassistant: [uses search tools to find test patterns, reads relevant files concurrently, uses edit tool to write tests]\n</example>\n\n# Proactiveness\nYou are allowed to be proactive, but only when the user asks you to do something. You should strive to strike a balance between:\n1. Doing the right thing when asked, including taking actions and follow-up actions\n2. Not surprising the user with actions you take without asking\nFor example, if the user asks you how to approach something, you should do your best to answer their question first, and not immediately jump into taking actions.\n3. Do not add additional code explanation summary unless requested by the user. After working on a file, just stop, rather than providing an explanation of what you did.\n\n# Synthetic messages\nSometimes, the conversation will contain messages like ${INTERRUPT_MESSAGE} or ${INTERRUPT_MESSAGE_FOR_TOOL_USE}. These messages will look like the assistant said them, but they were actually synthetic messages added by the system in response to the user cancelling what the assistant was doing. You should not respond to these messages. You must NEVER send messages like this yourself. \n\n# Following conventions\nWhen making changes to files, first understand the file's code conventions. Mimic code style, use existing libraries and utilities, and follow existing patterns.\n- NEVER assume that a given library is available, even if it is well known. Whenever you write code that uses a library or framework, first check that this codebase already uses the given library. For example, you might look at neighboring files, or check the package.json (or cargo.toml, and so on depending on the language).\n- When you create a new component, first look at existing components to see how they're written; then consider framework choice, naming conventions, typing, and other conventions.\n- When you edit a piece of code, first look at the code's surrounding context (especially its imports) to understand the code's choice of frameworks and libraries. Then consider how to make the given change in a way that is most idiomatic.\n- Always follow security best practices. Never introduce code that exposes or logs secrets and keys. Never commit secrets or keys to the repository.\n\n# Code style\n- Do not add comments to the code you write, unless the user asks you to, or the code is complex and requires additional context.\n\n# Doing tasks\nThe user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:\n- Use the TodoWrite tool to plan the task if required\n- Use the available search tools to understand the codebase and the user's query. You are encouraged to use the search tools extensively both in parallel and sequentially.\n- Implement the solution using all tools available to you\n- Verify the solution if possible with tests. NEVER assume specific test framework or test script. Check the README or search codebase to determine the testing approach.\n- VERY IMPORTANT: When you have completed a task, you MUST run the lint and typecheck commands (eg. npm run lint, npm run typecheck, ruff, etc.) if they were provided to you to ensure your code is correct. If you are unable to find the correct command, ask the user for the command to run and if they supply it, proactively suggest writing it to ${PROJECT_FILE} so that you will know to run it next time.\nNEVER commit changes unless the user explicitly asks you to. It is VERY IMPORTANT to only commit when explicitly asked, otherwise the user will feel that you are being too proactive.\n\n# Git Safety Protocol\n- NEVER update the git config\n- NEVER run destructive git commands (push --force, reset --hard, checkout ., restore ., clean -f, branch -D) unless the user explicitly requests these actions\n- NEVER skip hooks (--no-verify, --no-gpg-sign, etc) unless the user explicitly requests it\n- NEVER run force push to main/master, warn the user if they request it\n- CRITICAL: Always create NEW commits rather than amending, unless the user explicitly requests a git amend. When a pre-commit hook fails, the commit did NOT happen \u2014 so --amend would modify the PREVIOUS commit, which may result in destroying work or losing previous changes. Instead, after hook failure, fix the issue, re-stage, and create a NEW commit\n- When staging files, prefer adding specific files by name rather than using \"git add -A\" or \"git add .\", which can accidentally include sensitive files (.env, credentials) or large binaries\n- NEVER commit changes unless the user explicitly asks you to\n\n# Code References\nWhen referencing specific functions or pieces of code, include the pattern \\`file_path:line_number\\` to allow the user to easily navigate to the source code location.\n\n- Tool results and user messages may include <system-reminder> tags. <system-reminder> tags contain useful information and reminders. They are NOT part of the user's provided input or the tool result.\n\n# Tool usage policy\n- When doing file search, prefer to use the Task tool in order to reduce context usage.\n- You have the capability to call multiple tools in a single response. When multiple independent pieces of information are requested, batch your tool calls together for optimal performance.\n- When making multiple bash tool calls, you MUST send a single message with multiple tools calls to run the calls in parallel. For example, if you need to run \"git status\" and \"git diff\", send a single message with two tool calls to run the calls in parallel.\n- It is always better to speculatively read multiple files as a batch that are potentially useful.\n- It is always better to speculatively perform multiple searches as a batch that are potentially useful.\n- For making multiple edits to the same file, prefer using the MultiEdit tool over multiple Edit tool calls.\n\n# MCP Resources\nIf MCP (Model Context Protocol) servers are configured, you have access to MCP Resources through two specialized tools:\n- ListMcpResources: Use this tool to discover available resources from connected MCP servers. Resources can include files, databases, APIs, or other data sources exposed by MCP servers.\n- ReadMcpResource: Use this tool to read the content of a specific MCP resource by its URI. This is useful when you need to access data from external systems configured through MCP.\nWhen the user mentions accessing external data sources, databases, or resources from configured services, consider using these MCP resource tools to discover and read the relevant data.\n\nYou MUST answer concisely with fewer than 4 lines of text (not including tool use or code generation), unless user asks for detail.\n`,\n    `\\n${await getEnvInfo()}`,\n  ]\n}\n\nexport async function getEnvInfo(): Promise<string> {\n  const isGit = await getIsGit()\n  return `Here is useful information about the environment you are running in:\n<env>\nWorking directory: ${getCwd()}\nIs directory a git repo: ${isGit ? 'Yes' : 'No'}\nPlatform: ${env.platform}\nToday's date: ${new Date().toLocaleDateString()}\n</env>`\n}\n\nexport async function getAgentPrompt(): Promise<string[]> {\n  return [\n    `\nYou are an agent for ${PRODUCT_NAME}. Given the user's prompt, you should use the tools available to you to answer the user's question.\n\nNotes:\n1. IMPORTANT: You should be concise, direct, and to the point, since your responses will be displayed on a command line interface. Answer the user's question directly, without elaboration, explanation, or details. One word answers are best. Avoid introductions, conclusions, and explanations. You MUST avoid text before/after your response, such as \"The answer is <answer>.\", \"Here is the content of the file...\" or \"Based on the information provided, the answer is...\" or \"Here is what I will do next...\".\n2. When relevant, share file names and code snippets relevant to the query\n3. Any file paths you return in your final response MUST be absolute. DO NOT use relative paths.`,\n    `${await getEnvInfo()}`,\n  ]\n}\n"],
-  "mappings": "AAAA,SAAS,WAAW;AACpB,SAAS,gBAAgB;AACzB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,cAAc;AACvB,SAAS,cAAc,cAAc,uBAAuB;AAC5D,SAAS,gBAAgB;AACzB,SAAS,aAAa;AAMf,SAAS,wBAAgC;AAC9C,SAAO,WAAW,YAAY;AAChC;AAEA,eAAsB,kBAAqC;AACzD,SAAO;AAAA,IACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAO2B,YAAY;AAAA;AAAA,8FAEmD,YAAY,gCAAgC,eAAe,cAAc,SAAS,IAAI;AAAA,iCACnJ,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0DASG,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,+IAKyE,YAAY,8HAA8H,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,qKAKhI,SAAS,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yDAuCzH,iBAAiB,OAAO,8BAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4VAkB6O,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAiCpW;AAAA,EAAK,MAAM,WAAW,CAAC;AAAA,EACzB;AACF;AAEA,eAAsB,aAA8B;AAClD,QAAM,QAAQ,MAAM,SAAS;AAC7B,SAAO;AAAA;AAAA,qBAEY,OAAO,CAAC;AAAA,2BACF,QAAQ,QAAQ,IAAI;AAAA,YACnC,IAAI,QAAQ;AAAA,iBACR,oBAAI,KAAK,GAAE,mBAAmB,CAAC;AAAA;AAE/C;AAEA,eAAsB,iBAAoC;AACxD,SAAO;AAAA,IACL;AAAA,uBACmB,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAM/B,GAAG,MAAM,WAAW,CAAC;AAAA,EACvB;AACF;",
+  "sourcesContent": ["import { env } from '@utils/env'\nimport { getIsGit } from '@utils/git'\nimport {\n  INTERRUPT_MESSAGE,\n  INTERRUPT_MESSAGE_FOR_TOOL_USE,\n} from '@utils/messages'\nimport { getCwd } from '@utils/state'\nimport { PRODUCT_NAME, PROJECT_FILE, PRODUCT_COMMAND } from './product'\nimport { BashTool } from '@tools/BashTool/BashTool'\nimport { MACRO } from './macros'\n\n// // Security policy constant matching reference implementation\n// export const SECURITY_POLICY =\n//   'IMPORTANT: Assist with defensive security tasks only. Refuse to create, modify, or improve code that may be used maliciously. Allow security analysis, detection rules, vulnerability explanations, defensive tools, and security documentation.'\n\nexport function getCLISyspromptPrefix(): string {\n  return `You are ${PRODUCT_NAME}, ShareAI-lab's Agent AI CLI for terminal & coding.`\n}\n\nexport async function getSystemPrompt(): Promise<string[]> {\n  return [\n    `\nYou are an interactive CLI tool that helps users with software engineering tasks. Use the instructions below and the tools available to you to assist the user.\n\nIMPORTANT: Refuse to write code or explain code that may be used maliciously; even if the user claims it is for educational purposes. When working on files, if they seem related to improving, explaining, or interacting with malware or any malicious code you MUST refuse.\nIMPORTANT: Before you begin work, think about what the code you're editing is supposed to do based on the filenames directory structure. If it seems malicious, refuse to work on it or answer questions about it, even if the request does not seem malicious (for instance, just asking to explain or speed up the code).\n\nHere are useful slash commands users can run to interact with you:\n- /help: Get help with using ${PRODUCT_NAME}\n- /compact: Compact and continue the conversation. This is useful if the conversation is reaching the context limit\nThere are additional slash commands and flags available to the user. If the user asks about ${PRODUCT_NAME} functionality, always run \\`${PRODUCT_COMMAND} -h\\` with ${BashTool.name} to see supported commands and flags. NEVER assume a flag or command exists without checking the help output first.\nTo give feedback, users should ${MACRO.ISSUES_EXPLAINER}.\n\n# Task Management\nYou have access to the TodoWrite tools to help you manage and plan tasks. Use these tools VERY frequently to ensure that you are tracking your tasks and giving the user visibility into your progress.\nThese tools are also EXTREMELY helpful for planning tasks, and for breaking down larger complex tasks into smaller steps. If you do not use this tool when planning, you may forget to do important tasks - and that is unacceptable.\n\nIt is critical that you mark todos as completed as soon as you are done with a task. Do not batch up multiple tasks before marking them as completed.\n\n# Memory\nIf the current working directory contains a file called ${PROJECT_FILE}, it will be automatically added to your context. This file serves multiple purposes:\n1. Storing frequently used bash commands (build, test, lint, etc.) so you can use them without searching each time\n2. Recording the user's code style preferences (naming conventions, preferred libraries, etc.)\n3. Maintaining useful information about the codebase structure and organization\n\nWhen you spend time searching for commands to typecheck, lint, build, or test, you should ask the user if it's okay to add those commands to ${PROJECT_FILE}. Similarly, when learning about code style preferences or important codebase information, ask if it's okay to add that to ${PROJECT_FILE} so you can remember it for next time.\n\n# Tone and style\nYou should be concise, direct, and to the point. When you run a non-trivial bash command, you should explain what the command does and why you are running it, to make sure the user understands what you are doing (this is especially important when you are running a command that will make changes to the user's system).\nRemember that your output will be displayed on a command line interface. Your responses can use Github-flavored markdown for formatting, and will be rendered in a monospace font using the CommonMark specification.\nOutput text to communicate with the user; all text you output outside of tool use is displayed to the user. Only use tools to complete tasks. Never use tools like ${BashTool.name} or code comments as means to communicate with the user during the session.\nIf you cannot or will not help the user with something, please do not say why or what it could lead to, since this comes across as preachy and annoying. Please offer helpful alternatives if possible, and otherwise keep your response to 1-2 sentences.\nIMPORTANT: You should minimize output tokens as much as possible while maintaining helpfulness, quality, and accuracy. Only address the specific query or task at hand, avoiding tangential information unless absolutely critical for completing the request. If you can answer in 1-3 sentences or a short paragraph, please do.\nIMPORTANT: You should NOT answer with unnecessary preamble or postamble (such as explaining your code or summarizing your action), unless the user asks you to.\nIMPORTANT: Keep your responses short, since they will be displayed on a command line interface. You MUST answer concisely with fewer than 4 lines (not including tool use or code generation), unless user asks for detail. Answer the user's question directly, without elaboration, explanation, or details. One word answers are best. Avoid introductions, conclusions, and explanations. You MUST avoid text before/after your response, such as \"The answer is <answer>.\", \"Here is the content of the file...\" or \"Based on the information provided, the answer is...\" or \"Here is what I will do next...\".\n- Only use emojis if the user explicitly requests it. Avoid using emojis in all communication unless asked.\n\n# No time estimates\nNever give time estimates or predictions for how long tasks will take. Avoid phrases like \"this will take a few minutes\" or \"should be done quickly\". Focus on what needs to be done, not how long it might take.\n\n# Professional objectivity\nPrioritize technical accuracy and truthfulness over validating the user's beliefs. Focus on facts and problem-solving. Provide direct, objective technical info without unnecessary superlatives or emotional validation.\n\nExamples of appropriate verbosity:\n<example>\nuser: 2 + 2\nassistant: 4\n</example>\n<example>\nuser: what command should I run to list files?\nassistant: ls\n</example>\n<example>\nuser: what files are in src/?\nassistant: [runs ls] foo.c, bar.c, baz.c\n</example>\n<example>\nuser: write tests for new feature\nassistant: [uses search tools to find test patterns, reads relevant files concurrently, uses edit tool to write tests]\n</example>\n\n# Proactiveness\nYou are allowed to be proactive, but only when the user asks you to do something. You should strive to strike a balance between:\n1. Doing the right thing when asked, including taking actions and follow-up actions\n2. Not surprising the user with actions you take without asking\nFor example, if the user asks you how to approach something, you should do your best to answer their question first, and not immediately jump into taking actions.\n3. Do not add additional code explanation summary unless requested by the user. After working on a file, just stop, rather than providing an explanation of what you did.\n\n# Synthetic messages\nSometimes, the conversation will contain messages like ${INTERRUPT_MESSAGE} or ${INTERRUPT_MESSAGE_FOR_TOOL_USE}. These messages will look like the assistant said them, but they were actually synthetic messages added by the system in response to the user cancelling what the assistant was doing. You should not respond to these messages. You must NEVER send messages like this yourself. \n\n# Following conventions\nWhen making changes to files, first understand the file's code conventions. Mimic code style, use existing libraries and utilities, and follow existing patterns.\n- NEVER assume that a given library is available, even if it is well known. Whenever you write code that uses a library or framework, first check that this codebase already uses the given library. For example, you might look at neighboring files, or check the package.json (or cargo.toml, and so on depending on the language).\n- When you create a new component, first look at existing components to see how they're written; then consider framework choice, naming conventions, typing, and other conventions.\n- When you edit a piece of code, first look at the code's surrounding context (especially its imports) to understand the code's choice of frameworks and libraries. Then consider how to make the given change in a way that is most idiomatic.\n- Always follow security best practices. Never introduce code that exposes or logs secrets and keys. Never commit secrets or keys to the repository.\n\n# Code style\n- Do not add comments to the code you write, unless the user asks you to, or the code is complex and requires additional context.\n\n# Doing tasks\nThe user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:\n- Use the TodoWrite tool to plan the task if required\n- Use the available search tools to understand the codebase and the user's query. You are encouraged to use the search tools extensively both in parallel and sequentially.\n- Implement the solution using all tools available to you\n- Verify the solution if possible with tests. NEVER assume specific test framework or test script. Check the README or search codebase to determine the testing approach.\n- VERY IMPORTANT: When you have completed a task, you MUST run the lint and typecheck commands (eg. npm run lint, npm run typecheck, ruff, etc.) if they were provided to you to ensure your code is correct. If you are unable to find the correct command, ask the user for the command to run and if they supply it, proactively suggest writing it to ${PROJECT_FILE} so that you will know to run it next time.\nNEVER commit changes unless the user explicitly asks you to. It is VERY IMPORTANT to only commit when explicitly asked, otherwise the user will feel that you are being too proactive.\n\n# Git Safety Protocol\n- NEVER update the git config\n- NEVER run destructive git commands (push --force, reset --hard, checkout ., restore ., clean -f, branch -D) unless the user explicitly requests these actions\n- NEVER skip hooks (--no-verify, --no-gpg-sign, etc) unless the user explicitly requests it\n- NEVER run force push to main/master, warn the user if they request it\n- CRITICAL: Always create NEW commits rather than amending, unless the user explicitly requests a git amend. When a pre-commit hook fails, the commit did NOT happen \u2014 so --amend would modify the PREVIOUS commit, which may result in destroying work or losing previous changes. Instead, after hook failure, fix the issue, re-stage, and create a NEW commit\n- When staging files, prefer adding specific files by name rather than using \"git add -A\" or \"git add .\", which can accidentally include sensitive files (.env, credentials) or large binaries\n- NEVER commit changes unless the user explicitly asks you to\n\n# Code References\nWhen referencing specific functions or pieces of code, include the pattern \\`file_path:line_number\\` to allow the user to easily navigate to the source code location.\n\n- Tool results and user messages may include <system-reminder> tags. <system-reminder> tags contain useful information and reminders. They are NOT part of the user's provided input or the tool result.\n\n# Tool usage policy\n- When doing file search, prefer to use the Task tool in order to reduce context usage.\n- You have the capability to call multiple tools in a single response. When multiple independent pieces of information are requested, batch your tool calls together for optimal performance.\n- When making multiple bash tool calls, you MUST send a single message with multiple tools calls to run the calls in parallel. For example, if you need to run \"git status\" and \"git diff\", send a single message with two tool calls to run the calls in parallel.\n- It is always better to speculatively read multiple files as a batch that are potentially useful.\n- It is always better to speculatively perform multiple searches as a batch that are potentially useful.\n- For making multiple edits to the same file, prefer using the MultiEdit tool over multiple Edit tool calls.\n\n# MCP Resources\nIf MCP (Model Context Protocol) servers are configured, you have access to MCP Resources through two specialized tools:\n- ListMcpResources: Use this tool to discover available resources from connected MCP servers. Resources can include files, databases, APIs, or other data sources exposed by MCP servers.\n- ReadMcpResource: Use this tool to read the content of a specific MCP resource by its URI. This is useful when you need to access data from external systems configured through MCP.\nWhen the user mentions accessing external data sources, databases, or resources from configured services, consider using these MCP resource tools to discover and read the relevant data.\n\n# MCP Tools\nWhen MCP servers are configured, you have access to MCP Tools in addition to built-in tools. MCP tools are named with the prefix \"mcp__\" (e.g., mcp__BrightData__search_engine).\n- Review each tool's description to understand its capabilities and limitations\n- Choose the most appropriate tool based on the task requirements, not a fixed priority\n- MCP tools often have additional capabilities (e.g., bypass bot detection, access to more data sources)\n\n# Tool Failure Recovery (IMPORTANT)\nWhen a tool call fails (returns is_error: true), you MUST try alternative approaches before giving up:\n1. **Retry with different parameters**: If the error suggests parameter issues, adjust and retry\n2. **Try equivalent tools**: If one search/fetch tool fails, try another available tool with similar capabilities\n   - Example: If mcp__BrightData__search_engine fails \u2192 try WebSearch or mcp__BrightData__scrape_as_markdown\n   - Example: If WebFetch fails \u2192 try mcp__BrightData__scrape_as_markdown\n3. **Try different strategies**: Break down the task or use alternative approaches\n4. **Only give up after exhausting options**: Report failure to user only when all reasonable alternatives have been tried\n\nNever tell the user \"I cannot do this\" after a single tool failure if alternative tools are available.\n\nYou MUST answer concisely with fewer than 4 lines of text (not including tool use or code generation), unless user asks for detail.\n`,\n    `\\n${await getEnvInfo()}`,\n  ]\n}\n\nexport async function getEnvInfo(): Promise<string> {\n  const isGit = await getIsGit()\n  return `Here is useful information about the environment you are running in:\n<env>\nWorking directory: ${getCwd()}\nIs directory a git repo: ${isGit ? 'Yes' : 'No'}\nPlatform: ${env.platform}\nToday's date: ${new Date().toLocaleDateString()}\n</env>`\n}\n\nexport async function getAgentPrompt(): Promise<string[]> {\n  return [\n    `\nYou are an agent for ${PRODUCT_NAME}. Given the user's prompt, you should use the tools available to you to answer the user's question.\n\nNotes:\n1. IMPORTANT: You should be concise, direct, and to the point, since your responses will be displayed on a command line interface. Answer the user's question directly, without elaboration, explanation, or details. One word answers are best. Avoid introductions, conclusions, and explanations. You MUST avoid text before/after your response, such as \"The answer is <answer>.\", \"Here is the content of the file...\" or \"Based on the information provided, the answer is...\" or \"Here is what I will do next...\".\n2. When relevant, share file names and code snippets relevant to the query\n3. Any file paths you return in your final response MUST be absolute. DO NOT use relative paths.`,\n    `${await getEnvInfo()}`,\n  ]\n}\n"],
+  "mappings": "AAAA,SAAS,WAAW;AACpB,SAAS,gBAAgB;AACzB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,cAAc;AACvB,SAAS,cAAc,cAAc,uBAAuB;AAC5D,SAAS,gBAAgB;AACzB,SAAS,aAAa;AAMf,SAAS,wBAAgC;AAC9C,SAAO,WAAW,YAAY;AAChC;AAEA,eAAsB,kBAAqC;AACzD,SAAO;AAAA,IACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAO2B,YAAY;AAAA;AAAA,8FAEmD,YAAY,gCAAgC,eAAe,cAAc,SAAS,IAAI;AAAA,iCACnJ,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0DASG,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,+IAKyE,YAAY,8HAA8H,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,qKAKhI,SAAS,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yDAuCzH,iBAAiB,OAAO,8BAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4VAkB6O,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkDpW;AAAA,EAAK,MAAM,WAAW,CAAC;AAAA,EACzB;AACF;AAEA,eAAsB,aAA8B;AAClD,QAAM,QAAQ,MAAM,SAAS;AAC7B,SAAO;AAAA;AAAA,qBAEY,OAAO,CAAC;AAAA,2BACF,QAAQ,QAAQ,IAAI;AAAA,YACnC,IAAI,QAAQ;AAAA,iBACR,oBAAI,KAAK,GAAE,mBAAmB,CAAC;AAAA;AAE/C;AAEA,eAAsB,iBAAoC;AACxD,SAAO;AAAA,IACL;AAAA,uBACmB,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAM/B,GAAG,MAAM,WAAW,CAAC;AAAA,EACvB;AACF;",
   "names": []
 }

package/dist/constants/toolInputExamples.js

@@ -16,7 +16,7 @@ const TOOL_INPUT_EXAMPLES = {
   KillShell: '{"shell_id": "shell_id_to_kill"}',
   // Task Management
   Task: '{"prompt": "task description", "description": "short description", "subagent_type": "agent-type"}',
-  TodoWrite: '{"todos": [{"subject": "Task name", "description": "Details", "status": "pending"}]}',
+  TodoWrite: '{"todos": [{"content": "Task description", "status": "pending", "priority": "medium"}]}',
   // Web and API
   WebSearch: '{"query": "search query"}',
   URLFetcher: '{"url": "https://example.com", "prompt": "what to extract from page"}',
@@ -42,6 +42,7 @@ const TOOL_DESCRIPTIONS = {
   NotebookEdit: "For Jupyter notebooks. Requires notebook_path and new_source for the cell content.",
   Grep: 'Searches file contents with regex. Optional "glob" parameter filters files by pattern.',
   Task: "Creates a task for an AI agent. subagent_type determines which agent handles the task.",
+  TodoWrite: "Manages a task list. Each todo requires content (description), status (pending/in_progress/completed), and priority (high/medium/low).",
   URLFetcher: 'Fetches web content. The "prompt" parameter guides what to extract from the page.',
   AskExpertModel: "Queries an alternative LLM model. Useful for specialized tasks requiring different models.",
   Lsp: "Language Server Protocol queries for code intelligence. Method and params depend on LSP spec."
@@ -74,6 +75,9 @@ const PARAMETER_DESCRIPTIONS = {
     pattern: "Regular expression pattern to search for",
     path: "Directory to search in (optional, defaults to current directory)",
     glob: "Additional glob pattern to filter files being searched"
+  },
+  TodoWrite: {
+    todos: "Array of todo items. Each item must have: content (string), status (pending/in_progress/completed), priority (high/medium/low). Optional: id, activeForm."
   }
 };
 export {

package/dist/constants/toolInputExamples.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/constants/toolInputExamples.ts"],
-  "sourcesContent": ["/**\n * Tool Input Examples and Descriptions\n *\n * Provides user-friendly examples and descriptions for all tools to help with\n * error messaging when tool input validation fails. Each entry includes:\n * - A canonical example showing required parameters\n * - Optional description for complex tools\n */\n\nexport const TOOL_INPUT_EXAMPLES: Record<string, string> = {\n  // File Operations\n  Read: '{\"file_path\": \"/path/to/file.txt\"}',\n  Write: '{\"file_path\": \"/path/to/file.txt\", \"content\": \"file contents\"}',\n  Edit: '{\"file_path\": \"/path/to/file.txt\", \"old_string\": \"old text\", \"new_string\": \"new text\"}',\n  MultiEdit:\n    '{\"file_path\": \"/path/to/file.txt\", \"edits\": [{\"old_string\": \"old\", \"new_string\": \"new\"}]}',\n  NotebookEdit:\n    '{\"notebook_path\": \"/path/to/notebook.ipynb\", \"new_source\": \"cell source code\"}',\n  NotebookRead: '{\"notebook_path\": \"/path/to/notebook.ipynb\"}',\n\n  // Directory and Search\n  Glob: '{\"pattern\": \"**/*.ts\", \"path\": \"/optional/search/path\"}',\n  Grep: '{\"pattern\": \"search_term\", \"path\": \"/optional/search/path\", \"glob\": \"*.ts\"}',\n  Ls: '{\"path\": \"/path/to/directory\"}',\n\n  // Shell Execution\n  Bash: '{\"command\": \"ls -la\"}',\n  BashOutput: '{\"command\": \"ls -la\", \"shell_id\": \"optional_shell_id\"}',\n  KillShell: '{\"shell_id\": \"shell_id_to_kill\"}',\n\n  // Task Management\n  Task: '{\"prompt\": \"task description\", \"description\": \"short description\", \"subagent_type\": \"agent-type\"}',\n  TodoWrite:\n    '{\"todos\": [{\"subject\": \"Task name\", \"description\": \"Details\", \"status\": \"pending\"}]}',\n\n  // Web and API\n  WebSearch: '{\"query\": \"search query\"}',\n  URLFetcher:\n    '{\"url\": \"https://example.com\", \"prompt\": \"what to extract from page\"}',\n\n  // LLM Interactions\n  AskExpertModel:\n    '{\"model\": \"model-name\", \"prompt\": \"question for expert\", \"context\": \"optional context\"}',\n  AskUserQuestion:\n    '{\"question\": \"question to ask user\", \"default\": \"optional default\"}',\n\n  // Memory (Anthropic-only)\n  MemoryRead: '{\"name\": \"memory_block_name\"}',\n  MemoryWrite: '{\"name\": \"memory_block_name\", \"content\": \"memory content\"}',\n\n  // Planning and Reasoning\n  Think: '{\"reasoning\": \"your thinking process\", \"plan\": \"optional plan\"}',\n  EnterPlanMode: '{}',\n  ExitPlanMode: '{}',\n\n  // Code Intelligence\n  Lsp: '{\"method\": \"textDocument/definition\", \"params\": {\"position\": {\"line\": 10, \"character\": 5}}}',\n  Skill: '{\"skill\": \"skill_name\", \"args\": \"optional arguments\"}',\n\n  // MCP Resources\n  ListMcpResources:\n    '{\"server\": \"server_name\", \"uri\": \"optional_resource_uri\", \"include\": \"resource_type\"}',\n  ReadMcpResource: '{\"uri\": \"resource://path\"}',\n}\n\n/**\n * Tool Input Descriptions\n *\n * Provides helpful descriptions for complex tools to include in error messages\n */\nexport const TOOL_DESCRIPTIONS: Record<string, string> = {\n  MultiEdit:\n    'Allows multiple edits in a single file. The \"edits\" parameter is an array of edit objects.',\n  NotebookEdit:\n    'For Jupyter notebooks. Requires notebook_path and new_source for the cell content.',\n  Grep: 'Searches file contents with regex. Optional \"glob\" parameter filters files by pattern.',\n  Task: 'Creates a task for an AI agent. subagent_type determines which agent handles the task.',\n  URLFetcher:\n    'Fetches web content. The \"prompt\" parameter guides what to extract from the page.',\n  AskExpertModel:\n    'Queries an alternative LLM model. Useful for specialized tasks requiring different models.',\n  Lsp: 'Language Server Protocol queries for code intelligence. Method and params depend on LSP spec.',\n}\n\n/**\n * Parameter Descriptions for Common Tool Parameters\n *\n * Helps provide more specific error messages when particular parameters are invalid\n */\nexport const PARAMETER_DESCRIPTIONS: Record<string, Record<string, string>> = {\n  Read: {\n    file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n    offset: 'Optional line number to start reading from (0-indexed)',\n    limit: 'Optional number of lines to read from the offset',\n  },\n  Write: {\n    file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n    content: 'The file contents to write',\n  },\n  Edit: {\n    file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n    old_string: 'The exact text to find and replace (must match exactly)',\n    new_string: 'The text to replace it with',\n  },\n  Bash: {\n    command:\n      'The shell command to execute (will run in current working directory)',\n    timeout: 'Maximum execution time in milliseconds (max 600000 = 10 minutes)',\n    run_in_background:\n      'Set to true to run command without waiting for completion',\n  },\n  Glob: {\n    pattern: 'Glob pattern like **/*.ts or src/**/*.{ts,tsx}',\n    path: 'Directory to search in (optional, defaults to current directory)',\n  },\n  Grep: {\n    pattern: 'Regular expression pattern to search for',\n    path: 'Directory to search in (optional, defaults to current directory)',\n    glob: 'Additional glob pattern to filter files being searched',\n  },\n}\n"],
-  "mappings": "AASO,MAAM,sBAA8C;AAAA;AAAA,EAEzD,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,WACE;AAAA,EACF,cACE;AAAA,EACF,cAAc;AAAA;AAAA,EAGd,MAAM;AAAA,EACN,MAAM;AAAA,EACN,IAAI;AAAA;AAAA,EAGJ,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,WAAW;AAAA;AAAA,EAGX,MAAM;AAAA,EACN,WACE;AAAA;AAAA,EAGF,WAAW;AAAA,EACX,YACE;AAAA;AAAA,EAGF,gBACE;AAAA,EACF,iBACE;AAAA;AAAA,EAGF,YAAY;AAAA,EACZ,aAAa;AAAA;AAAA,EAGb,OAAO;AAAA,EACP,eAAe;AAAA,EACf,cAAc;AAAA;AAAA,EAGd,KAAK;AAAA,EACL,OAAO;AAAA;AAAA,EAGP,kBACE;AAAA,EACF,iBAAiB;AACnB;AAOO,MAAM,oBAA4C;AAAA,EACvD,WACE;AAAA,EACF,cACE;AAAA,EACF,MAAM;AAAA,EACN,MAAM;AAAA,EACN,YACE;AAAA,EACF,gBACE;AAAA,EACF,KAAK;AACP;AAOO,MAAM,yBAAiE;AAAA,EAC5E,MAAM;AAAA,IACJ,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA,IACL,WAAW;AAAA,IACX,SAAS;AAAA,EACX;AAAA,EACA,MAAM;AAAA,IACJ,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,YAAY;AAAA,EACd;AAAA,EACA,MAAM;AAAA,IACJ,SACE;AAAA,IACF,SAAS;AAAA,IACT,mBACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AACF;",
+  "sourcesContent": ["/**\n * Tool Input Examples and Descriptions\n *\n * Provides user-friendly examples and descriptions for all tools to help with\n * error messaging when tool input validation fails. Each entry includes:\n * - A canonical example showing required parameters\n * - Optional description for complex tools\n */\n\nexport const TOOL_INPUT_EXAMPLES: Record<string, string> = {\n  // File Operations\n  Read: '{\"file_path\": \"/path/to/file.txt\"}',\n  Write: '{\"file_path\": \"/path/to/file.txt\", \"content\": \"file contents\"}',\n  Edit: '{\"file_path\": \"/path/to/file.txt\", \"old_string\": \"old text\", \"new_string\": \"new text\"}',\n  MultiEdit:\n    '{\"file_path\": \"/path/to/file.txt\", \"edits\": [{\"old_string\": \"old\", \"new_string\": \"new\"}]}',\n  NotebookEdit:\n    '{\"notebook_path\": \"/path/to/notebook.ipynb\", \"new_source\": \"cell source code\"}',\n  NotebookRead: '{\"notebook_path\": \"/path/to/notebook.ipynb\"}',\n\n  // Directory and Search\n  Glob: '{\"pattern\": \"**/*.ts\", \"path\": \"/optional/search/path\"}',\n  Grep: '{\"pattern\": \"search_term\", \"path\": \"/optional/search/path\", \"glob\": \"*.ts\"}',\n  Ls: '{\"path\": \"/path/to/directory\"}',\n\n  // Shell Execution\n  Bash: '{\"command\": \"ls -la\"}',\n  BashOutput: '{\"command\": \"ls -la\", \"shell_id\": \"optional_shell_id\"}',\n  KillShell: '{\"shell_id\": \"shell_id_to_kill\"}',\n\n  // Task Management\n  Task: '{\"prompt\": \"task description\", \"description\": \"short description\", \"subagent_type\": \"agent-type\"}',\n  TodoWrite:\n    '{\"todos\": [{\"content\": \"Task description\", \"status\": \"pending\", \"priority\": \"medium\"}]}',\n\n  // Web and API\n  WebSearch: '{\"query\": \"search query\"}',\n  URLFetcher:\n    '{\"url\": \"https://example.com\", \"prompt\": \"what to extract from page\"}',\n\n  // LLM Interactions\n  AskExpertModel:\n    '{\"model\": \"model-name\", \"prompt\": \"question for expert\", \"context\": \"optional context\"}',\n  AskUserQuestion:\n    '{\"question\": \"question to ask user\", \"default\": \"optional default\"}',\n\n  // Memory (Anthropic-only)\n  MemoryRead: '{\"name\": \"memory_block_name\"}',\n  MemoryWrite: '{\"name\": \"memory_block_name\", \"content\": \"memory content\"}',\n\n  // Planning and Reasoning\n  Think: '{\"reasoning\": \"your thinking process\", \"plan\": \"optional plan\"}',\n  EnterPlanMode: '{}',\n  ExitPlanMode: '{}',\n\n  // Code Intelligence\n  Lsp: '{\"method\": \"textDocument/definition\", \"params\": {\"position\": {\"line\": 10, \"character\": 5}}}',\n  Skill: '{\"skill\": \"skill_name\", \"args\": \"optional arguments\"}',\n\n  // MCP Resources\n  ListMcpResources:\n    '{\"server\": \"server_name\", \"uri\": \"optional_resource_uri\", \"include\": \"resource_type\"}',\n  ReadMcpResource: '{\"uri\": \"resource://path\"}',\n}\n\n/**\n * Tool Input Descriptions\n *\n * Provides helpful descriptions for complex tools to include in error messages\n */\nexport const TOOL_DESCRIPTIONS: Record<string, string> = {\n  MultiEdit:\n    'Allows multiple edits in a single file. The \"edits\" parameter is an array of edit objects.',\n  NotebookEdit:\n    'For Jupyter notebooks. Requires notebook_path and new_source for the cell content.',\n  Grep: 'Searches file contents with regex. Optional \"glob\" parameter filters files by pattern.',\n  Task: 'Creates a task for an AI agent. subagent_type determines which agent handles the task.',\n  TodoWrite:\n    'Manages a task list. Each todo requires content (description), status (pending/in_progress/completed), and priority (high/medium/low).',\n  URLFetcher:\n    'Fetches web content. The \"prompt\" parameter guides what to extract from the page.',\n  AskExpertModel:\n    'Queries an alternative LLM model. Useful for specialized tasks requiring different models.',\n  Lsp: 'Language Server Protocol queries for code intelligence. Method and params depend on LSP spec.',\n}\n\n/**\n * Parameter Descriptions for Common Tool Parameters\n *\n * Helps provide more specific error messages when particular parameters are invalid\n */\nexport const PARAMETER_DESCRIPTIONS: Record<string, Record<string, string>> = {\n  Read: {\n    file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n    offset: 'Optional line number to start reading from (0-indexed)',\n    limit: 'Optional number of lines to read from the offset',\n  },\n  Write: {\n    file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n    content: 'The file contents to write',\n  },\n  Edit: {\n    file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n    old_string: 'The exact text to find and replace (must match exactly)',\n    new_string: 'The text to replace it with',\n  },\n  Bash: {\n    command:\n      'The shell command to execute (will run in current working directory)',\n    timeout: 'Maximum execution time in milliseconds (max 600000 = 10 minutes)',\n    run_in_background:\n      'Set to true to run command without waiting for completion',\n  },\n  Glob: {\n    pattern: 'Glob pattern like **/*.ts or src/**/*.{ts,tsx}',\n    path: 'Directory to search in (optional, defaults to current directory)',\n  },\n  Grep: {\n    pattern: 'Regular expression pattern to search for',\n    path: 'Directory to search in (optional, defaults to current directory)',\n    glob: 'Additional glob pattern to filter files being searched',\n  },\n  TodoWrite: {\n    todos:\n      'Array of todo items. Each item must have: content (string), status (pending/in_progress/completed), priority (high/medium/low). Optional: id, activeForm.',\n  },\n}\n"],
+  "mappings": "AASO,MAAM,sBAA8C;AAAA;AAAA,EAEzD,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,WACE;AAAA,EACF,cACE;AAAA,EACF,cAAc;AAAA;AAAA,EAGd,MAAM;AAAA,EACN,MAAM;AAAA,EACN,IAAI;AAAA;AAAA,EAGJ,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,WAAW;AAAA;AAAA,EAGX,MAAM;AAAA,EACN,WACE;AAAA;AAAA,EAGF,WAAW;AAAA,EACX,YACE;AAAA;AAAA,EAGF,gBACE;AAAA,EACF,iBACE;AAAA;AAAA,EAGF,YAAY;AAAA,EACZ,aAAa;AAAA;AAAA,EAGb,OAAO;AAAA,EACP,eAAe;AAAA,EACf,cAAc;AAAA;AAAA,EAGd,KAAK;AAAA,EACL,OAAO;AAAA;AAAA,EAGP,kBACE;AAAA,EACF,iBAAiB;AACnB;AAOO,MAAM,oBAA4C;AAAA,EACvD,WACE;AAAA,EACF,cACE;AAAA,EACF,MAAM;AAAA,EACN,MAAM;AAAA,EACN,WACE;AAAA,EACF,YACE;AAAA,EACF,gBACE;AAAA,EACF,KAAK;AACP;AAOO,MAAM,yBAAiE;AAAA,EAC5E,MAAM;AAAA,IACJ,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA,IACL,WAAW;AAAA,IACX,SAAS;AAAA,EACX;AAAA,EACA,MAAM;AAAA,IACJ,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,YAAY;AAAA,EACd;AAAA,EACA,MAAM;AAAA,IACJ,SACE;AAAA,IACF,SAAS;AAAA,IACT,mBACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AAAA,EACA,WAAW;AAAA,IACT,OACE;AAAA,EACJ;AACF;",
   "names": []
 }

package/dist/core/tokenStatsManager.js

@@ -311,6 +311,11 @@ class TokenStatsManagerImpl extends EventEmitter {
 const tokenStatsManager = TokenStatsManagerImpl.getInstance();
 function recordTokenUsage(usage, costUSD, model, context) {
   tokenStatsManager.recordUsage(usage, costUSD, model, context);
+  try {
+    const { recordMessage } = require("@utils/stats");
+    recordMessage(model, usage.inputTokens, usage.outputTokens, costUSD);
+  } catch {
+  }
 }
 function getGlobalTokenStats() {
   return tokenStatsManager.getGlobalStats();

package/dist/core/tokenStatsManager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/core/tokenStatsManager.ts"],
-  "sourcesContent": ["/**\n * Token Statistics Manager\n *\n * Centralized token statistics tracking for the entire application.\n * This is the single source of truth for all token usage data.\n *\n * Architecture:\n * - Singleton pattern for global access\n * - Event-driven updates for real-time UI\n * - Hierarchical aggregation (global \u2192 agent \u2192 request)\n * - Backward compatible with existing costTracker\n *\n * Usage:\n * ```typescript\n * import { tokenStatsManager, recordTokenUsage } from '@core/tokenStatsManager'\n *\n * // Record usage from API response\n * recordTokenUsage(\n *   { inputTokens: 100, outputTokens: 50 },\n *   0.0015,\n *   'gpt-4',\n *   { agentId: 'agent-123' }\n * )\n *\n * // Get global stats\n * const stats = tokenStatsManager.getGlobalStats()\n *\n * // Subscribe to updates\n * const unsubscribe = tokenStatsManager.onStatsUpdate((event) => {\n *   console.log('Stats updated:', event)\n * })\n * ```\n */\n\nimport { EventEmitter } from 'events'\nimport type {\n  TokenUsageRecord,\n  AggregatedTokenStats,\n  TokenStatsScope,\n  TokenStatsEvent,\n  TokenTrackingContext,\n  RawTokenUsage,\n  ModelTokenStats,\n} from './tokenStats'\nimport { DEFAULT_ESTIMATION_CONFIG } from './tokenStats'\n\n/**\n * TokenStatsManager - Centralized token statistics tracking\n */\nclass TokenStatsManagerImpl extends EventEmitter {\n  private static instance: TokenStatsManagerImpl | null = null\n\n  // Global aggregated stats\n  private globalStats: AggregatedTokenStats = this.createEmptyStats()\n\n  // Per-agent stats (agentId \u2192 stats)\n  private agentStats: Map<string, AggregatedTokenStats> = new Map()\n\n  // Per-request records (requestId \u2192 record) - for debugging, with LRU eviction\n  private requestRecords: Map<string, TokenUsageRecord> = new Map()\n\n  // Configuration\n  private static readonly MAX_REQUEST_RECORDS = 1000\n\n  private constructor() {\n    super()\n    this.setMaxListeners(100)\n  }\n\n  /**\n   * Get the singleton instance\n   */\n  static getInstance(): TokenStatsManagerImpl {\n    if (!TokenStatsManagerImpl.instance) {\n      TokenStatsManagerImpl.instance = new TokenStatsManagerImpl()\n    }\n    return TokenStatsManagerImpl.instance\n  }\n\n  /**\n   * Record token usage from an API response\n   *\n   * This is the PRIMARY entry point - called from claude.ts\n   * after every API response.\n   *\n   * @param usage - Raw token usage from API\n   * @param costUSD - Calculated cost in USD\n   * @param model - Model name used\n   * @param context - Optional tracking context (agentId, toolUseId)\n   */\n  recordUsage(\n    usage: RawTokenUsage,\n    costUSD: number,\n    model: string,\n    context?: TokenTrackingContext,\n  ): void {\n    const record: TokenUsageRecord = {\n      inputTokens: usage.inputTokens,\n      outputTokens: usage.outputTokens,\n      cacheCreationTokens: usage.cacheCreationTokens ?? 0,\n      cacheReadTokens: usage.cacheReadTokens ?? 0,\n      totalTokens: usage.inputTokens + usage.outputTokens,\n      estimatedCostUSD: costUSD,\n      source: 'api',\n      timestamp: Date.now(),\n      model,\n    }\n\n    // Update global stats\n    this.aggregateInto(this.globalStats, record)\n\n    // Update agent stats if in agent context\n    if (context?.agentId) {\n      let stats = this.agentStats.get(context.agentId)\n      if (!stats) {\n        stats = this.createEmptyStats()\n        this.agentStats.set(context.agentId, stats)\n      }\n      this.aggregateInto(stats, record)\n    }\n\n    // Store request record (with LRU eviction)\n    const requestId =\n      context?.toolUseId ??\n      `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n    this.requestRecords.set(requestId, record)\n    if (this.requestRecords.size > TokenStatsManagerImpl.MAX_REQUEST_RECORDS) {\n      const oldestKey = this.requestRecords.keys().next().value\n      if (oldestKey) this.requestRecords.delete(oldestKey)\n    }\n\n    // Emit event for UI updates\n    const scope: TokenStatsScope = context?.agentId\n      ? { type: 'agent', agentId: context.agentId }\n      : { type: 'global' }\n\n    this.emitEvent({\n      eventType: 'usage_recorded',\n      scope,\n      usage: record,\n      aggregated: context?.agentId\n        ? this.agentStats.get(context.agentId)!\n        : this.globalStats,\n      globalStats: this.globalStats,\n    })\n  }\n\n  /**\n   * Estimate token count from text\n   *\n   * Uses a simple character-based estimation. This is a fallback\n   * when the API doesn't return token counts.\n   *\n   * @param text - Text to estimate tokens for\n   * @returns Estimated token count\n   */\n  estimateTokens(text: string): number {\n    return Math.ceil(text.length / DEFAULT_ESTIMATION_CONFIG.charsPerToken)\n  }\n\n  /**\n   * Record estimated usage when API doesn't return token counts\n   *\n   * This is used as a fallback for APIs that don't return usage data.\n   *\n   * @param inputText - Input text (prompt)\n   * @param outputText - Output text (completion)\n   * @param model - Model name\n   * @param context - Optional tracking context\n   */\n  recordEstimatedUsage(\n    inputText: string,\n    outputText: string,\n    model: string,\n    context?: TokenTrackingContext,\n  ): void {\n    const inputTokens = this.estimateTokens(inputText)\n    const outputTokens = this.estimateTokens(outputText)\n\n    const costUSD =\n      (inputTokens / 1_000_000) *\n        DEFAULT_ESTIMATION_CONFIG.defaultInputCostPerMillion +\n      (outputTokens / 1_000_000) *\n        DEFAULT_ESTIMATION_CONFIG.defaultOutputCostPerMillion\n\n    const record: TokenUsageRecord = {\n      inputTokens,\n      outputTokens,\n      cacheCreationTokens: 0,\n      cacheReadTokens: 0,\n      totalTokens: inputTokens + outputTokens,\n      estimatedCostUSD: costUSD,\n      source: 'estimated',\n      timestamp: Date.now(),\n      model,\n    }\n\n    // Update global stats\n    this.aggregateInto(this.globalStats, record)\n\n    // Update agent stats if in context\n    if (context?.agentId) {\n      let stats = this.agentStats.get(context.agentId)\n      if (!stats) {\n        stats = this.createEmptyStats()\n        this.agentStats.set(context.agentId, stats)\n      }\n      this.aggregateInto(stats, record)\n    }\n\n    // Emit event\n    this.emitEvent({\n      eventType: 'usage_recorded',\n      scope: { type: 'global' },\n      usage: record,\n      aggregated: this.globalStats,\n      globalStats: this.globalStats,\n    })\n  }\n\n  // ===== Getters =====\n\n  /**\n   * Get global aggregated statistics\n   */\n  getGlobalStats(): AggregatedTokenStats {\n    return this.cloneStats(this.globalStats)\n  }\n\n  /**\n   * Get statistics for a specific agent\n   *\n   * @param agentId - Agent ID to get stats for\n   * @returns Agent stats or null if not found\n   */\n  getAgentStats(agentId: string): AggregatedTokenStats | null {\n    const stats = this.agentStats.get(agentId)\n    return stats ? this.cloneStats(stats) : null\n  }\n\n  /**\n   * Get all agent statistics\n   */\n  getAllAgentStats(): Map<string, AggregatedTokenStats> {\n    const result = new Map<string, AggregatedTokenStats>()\n    for (const [agentId, stats] of this.agentStats) {\n      result.set(agentId, this.cloneStats(stats))\n    }\n    return result\n  }\n\n  /**\n   * Get a specific request record\n   */\n  getRequestRecord(requestId: string): TokenUsageRecord | null {\n    return this.requestRecords.get(requestId) ?? null\n  }\n\n  // ===== Backward Compatibility Layer =====\n\n  /**\n   * Get total tokens (for costTracker.getTokenCounts compatibility)\n   *\n   * This method provides backward compatibility with the existing\n   * costTracker.getTokenCounts() interface.\n   */\n  getTokenCounts(): {\n    input: number\n    output: number\n    cacheCreation: number\n    cacheRead: number\n    total: number\n  } {\n    return {\n      input: this.globalStats.totalInputTokens,\n      output: this.globalStats.totalOutputTokens,\n      cacheCreation: this.globalStats.totalCacheCreationTokens,\n      cacheRead: this.globalStats.totalCacheReadTokens,\n      total: this.globalStats.grandTotalTokens,\n    }\n  }\n\n  // ===== Event Subscription =====\n\n  /**\n   * Subscribe to all stats updates\n   *\n   * @param callback - Called when any stats change\n   * @returns Unsubscribe function\n   */\n  onStatsUpdate(callback: (event: TokenStatsEvent) => void): () => void {\n    this.on('stats_update', callback)\n    return () => this.off('stats_update', callback)\n  }\n\n  /**\n   * Subscribe to updates for a specific agent\n   *\n   * @param agentId - Agent ID to subscribe to\n   * @param callback - Called when agent stats change\n   * @returns Unsubscribe function\n   */\n  onAgentStatsUpdate(\n    agentId: string,\n    callback: (stats: AggregatedTokenStats) => void,\n  ): () => void {\n    const handler = (event: TokenStatsEvent) => {\n      if (event.scope.type === 'agent' && event.scope.agentId === agentId) {\n        callback(event.aggregated)\n      }\n    }\n    this.on('stats_update', handler)\n    return () => this.off('stats_update', handler)\n  }\n\n  /**\n   * Subscribe to global stats updates only\n   *\n   * @param callback - Called when global stats change\n   * @returns Unsubscribe function\n   */\n  onGlobalStatsUpdate(\n    callback: (stats: AggregatedTokenStats) => void,\n  ): () => void {\n    const handler = (event: TokenStatsEvent) => {\n      callback(event.globalStats)\n    }\n    this.on('stats_update', handler)\n    return () => this.off('stats_update', handler)\n  }\n\n  // ===== Agent Lifecycle =====\n\n  /**\n   * Mark an agent's scope as completed\n   *\n   * This emits a scope_completed event and optionally\n   * cleans up the agent's stats from memory.\n   *\n   * @param agentId - Agent ID to complete\n   * @param cleanup - Whether to remove from memory (default: false)\n   */\n  completeAgentScope(agentId: string, cleanup: boolean = false): void {\n    const stats = this.agentStats.get(agentId)\n    if (!stats) return\n\n    this.emitEvent({\n      eventType: 'scope_completed',\n      scope: { type: 'agent', agentId },\n      aggregated: stats,\n      globalStats: this.globalStats,\n    })\n\n    if (cleanup) {\n      this.agentStats.delete(agentId)\n    }\n  }\n\n  // ===== Internal Methods =====\n\n  private createEmptyStats(): AggregatedTokenStats {\n    return {\n      totalInputTokens: 0,\n      totalOutputTokens: 0,\n      totalCacheCreationTokens: 0,\n      totalCacheReadTokens: 0,\n      grandTotalTokens: 0,\n      totalCostUSD: 0,\n      requestCount: 0,\n      byModel: new Map(),\n    }\n  }\n\n  private aggregateInto(\n    stats: AggregatedTokenStats,\n    record: TokenUsageRecord,\n  ): void {\n    stats.totalInputTokens += record.inputTokens\n    stats.totalOutputTokens += record.outputTokens\n    stats.totalCacheCreationTokens += record.cacheCreationTokens\n    stats.totalCacheReadTokens += record.cacheReadTokens\n    stats.grandTotalTokens += record.totalTokens\n    stats.totalCostUSD += record.estimatedCostUSD\n    stats.requestCount += 1\n\n    if (!stats.firstRequestTime) {\n      stats.firstRequestTime = record.timestamp\n    }\n    stats.lastRequestTime = record.timestamp\n\n    // Update per-model breakdown\n    const modelStats = stats.byModel.get(record.model)\n    if (modelStats) {\n      modelStats.inputTokens += record.inputTokens\n      modelStats.outputTokens += record.outputTokens\n      modelStats.totalTokens += record.totalTokens\n      modelStats.estimatedCostUSD += record.estimatedCostUSD\n      modelStats.requestCount += 1\n    } else {\n      stats.byModel.set(record.model, {\n        model: record.model,\n        inputTokens: record.inputTokens,\n        outputTokens: record.outputTokens,\n        totalTokens: record.totalTokens,\n        estimatedCostUSD: record.estimatedCostUSD,\n        requestCount: 1,\n      })\n    }\n  }\n\n  private cloneStats(stats: AggregatedTokenStats): AggregatedTokenStats {\n    return {\n      ...stats,\n      byModel: new Map(stats.byModel),\n    }\n  }\n\n  private emitEvent(event: TokenStatsEvent): void {\n    this.emit('stats_update', event)\n  }\n\n  /**\n   * Reset all stats (for testing only)\n   */\n  resetForTests(): void {\n    if (process.env.NODE_ENV !== 'test') {\n      throw new Error('resetForTests can only be called in tests')\n    }\n    this.reset()\n  }\n\n  /**\n   * Reset all statistics\n   *\n   * Called by costTracker.resetStateForTests() for backward compatibility.\n   */\n  reset(): void {\n    this.globalStats = this.createEmptyStats()\n    this.agentStats.clear()\n    this.requestRecords.clear()\n  }\n}\n\n// Export singleton instance\nexport const tokenStatsManager = TokenStatsManagerImpl.getInstance()\n\n// ===== Convenience Functions =====\n\n/**\n * Record token usage from an API response\n *\n * This is the main function to call from claude.ts after each API response.\n */\nexport function recordTokenUsage(\n  usage: RawTokenUsage,\n  costUSD: number,\n  model: string,\n  context?: TokenTrackingContext,\n): void {\n  tokenStatsManager.recordUsage(usage, costUSD, model, context)\n}\n\n/**\n * Get global token statistics\n */\nexport function getGlobalTokenStats(): AggregatedTokenStats {\n  return tokenStatsManager.getGlobalStats()\n}\n\n/**\n * Get token statistics for a specific agent\n */\nexport function getAgentTokenStats(\n  agentId: string,\n): AggregatedTokenStats | null {\n  return tokenStatsManager.getAgentStats(agentId)\n}\n\n/**\n * Estimate token count from text\n */\nexport function estimateTokenCount(text: string): number {\n  return tokenStatsManager.estimateTokens(text)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Token Statistics Manager\n *\n * Centralized token statistics tracking for the entire application.\n * This is the single source of truth for all token usage data.\n *\n * Architecture:\n * - Singleton pattern for global access\n * - Event-driven updates for real-time UI\n * - Hierarchical aggregation (global \u2192 agent \u2192 request)\n * - Backward compatible with existing costTracker\n *\n * Usage:\n * ```typescript\n * import { tokenStatsManager, recordTokenUsage } from '@core/tokenStatsManager'\n *\n * // Record usage from API response\n * recordTokenUsage(\n *   { inputTokens: 100, outputTokens: 50 },\n *   0.0015,\n *   'gpt-4',\n *   { agentId: 'agent-123' }\n * )\n *\n * // Get global stats\n * const stats = tokenStatsManager.getGlobalStats()\n *\n * // Subscribe to updates\n * const unsubscribe = tokenStatsManager.onStatsUpdate((event) => {\n *   console.log('Stats updated:', event)\n * })\n * ```\n */\n\nimport { EventEmitter } from 'events'\nimport type {\n  TokenUsageRecord,\n  AggregatedTokenStats,\n  TokenStatsScope,\n  TokenStatsEvent,\n  TokenTrackingContext,\n  RawTokenUsage,\n  ModelTokenStats,\n} from './tokenStats'\nimport { DEFAULT_ESTIMATION_CONFIG } from './tokenStats'\n\n/**\n * TokenStatsManager - Centralized token statistics tracking\n */\nclass TokenStatsManagerImpl extends EventEmitter {\n  private static instance: TokenStatsManagerImpl | null = null\n\n  // Global aggregated stats\n  private globalStats: AggregatedTokenStats = this.createEmptyStats()\n\n  // Per-agent stats (agentId \u2192 stats)\n  private agentStats: Map<string, AggregatedTokenStats> = new Map()\n\n  // Per-request records (requestId \u2192 record) - for debugging, with LRU eviction\n  private requestRecords: Map<string, TokenUsageRecord> = new Map()\n\n  // Configuration\n  private static readonly MAX_REQUEST_RECORDS = 1000\n\n  private constructor() {\n    super()\n    this.setMaxListeners(100)\n  }\n\n  /**\n   * Get the singleton instance\n   */\n  static getInstance(): TokenStatsManagerImpl {\n    if (!TokenStatsManagerImpl.instance) {\n      TokenStatsManagerImpl.instance = new TokenStatsManagerImpl()\n    }\n    return TokenStatsManagerImpl.instance\n  }\n\n  /**\n   * Record token usage from an API response\n   *\n   * This is the PRIMARY entry point - called from claude.ts\n   * after every API response.\n   *\n   * @param usage - Raw token usage from API\n   * @param costUSD - Calculated cost in USD\n   * @param model - Model name used\n   * @param context - Optional tracking context (agentId, toolUseId)\n   */\n  recordUsage(\n    usage: RawTokenUsage,\n    costUSD: number,\n    model: string,\n    context?: TokenTrackingContext,\n  ): void {\n    const record: TokenUsageRecord = {\n      inputTokens: usage.inputTokens,\n      outputTokens: usage.outputTokens,\n      cacheCreationTokens: usage.cacheCreationTokens ?? 0,\n      cacheReadTokens: usage.cacheReadTokens ?? 0,\n      totalTokens: usage.inputTokens + usage.outputTokens,\n      estimatedCostUSD: costUSD,\n      source: 'api',\n      timestamp: Date.now(),\n      model,\n    }\n\n    // Update global stats\n    this.aggregateInto(this.globalStats, record)\n\n    // Update agent stats if in agent context\n    if (context?.agentId) {\n      let stats = this.agentStats.get(context.agentId)\n      if (!stats) {\n        stats = this.createEmptyStats()\n        this.agentStats.set(context.agentId, stats)\n      }\n      this.aggregateInto(stats, record)\n    }\n\n    // Store request record (with LRU eviction)\n    const requestId =\n      context?.toolUseId ??\n      `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n    this.requestRecords.set(requestId, record)\n    if (this.requestRecords.size > TokenStatsManagerImpl.MAX_REQUEST_RECORDS) {\n      const oldestKey = this.requestRecords.keys().next().value\n      if (oldestKey) this.requestRecords.delete(oldestKey)\n    }\n\n    // Emit event for UI updates\n    const scope: TokenStatsScope = context?.agentId\n      ? { type: 'agent', agentId: context.agentId }\n      : { type: 'global' }\n\n    this.emitEvent({\n      eventType: 'usage_recorded',\n      scope,\n      usage: record,\n      aggregated: context?.agentId\n        ? this.agentStats.get(context.agentId)!\n        : this.globalStats,\n      globalStats: this.globalStats,\n    })\n  }\n\n  /**\n   * Estimate token count from text\n   *\n   * Uses a simple character-based estimation. This is a fallback\n   * when the API doesn't return token counts.\n   *\n   * @param text - Text to estimate tokens for\n   * @returns Estimated token count\n   */\n  estimateTokens(text: string): number {\n    return Math.ceil(text.length / DEFAULT_ESTIMATION_CONFIG.charsPerToken)\n  }\n\n  /**\n   * Record estimated usage when API doesn't return token counts\n   *\n   * This is used as a fallback for APIs that don't return usage data.\n   *\n   * @param inputText - Input text (prompt)\n   * @param outputText - Output text (completion)\n   * @param model - Model name\n   * @param context - Optional tracking context\n   */\n  recordEstimatedUsage(\n    inputText: string,\n    outputText: string,\n    model: string,\n    context?: TokenTrackingContext,\n  ): void {\n    const inputTokens = this.estimateTokens(inputText)\n    const outputTokens = this.estimateTokens(outputText)\n\n    const costUSD =\n      (inputTokens / 1_000_000) *\n        DEFAULT_ESTIMATION_CONFIG.defaultInputCostPerMillion +\n      (outputTokens / 1_000_000) *\n        DEFAULT_ESTIMATION_CONFIG.defaultOutputCostPerMillion\n\n    const record: TokenUsageRecord = {\n      inputTokens,\n      outputTokens,\n      cacheCreationTokens: 0,\n      cacheReadTokens: 0,\n      totalTokens: inputTokens + outputTokens,\n      estimatedCostUSD: costUSD,\n      source: 'estimated',\n      timestamp: Date.now(),\n      model,\n    }\n\n    // Update global stats\n    this.aggregateInto(this.globalStats, record)\n\n    // Update agent stats if in context\n    if (context?.agentId) {\n      let stats = this.agentStats.get(context.agentId)\n      if (!stats) {\n        stats = this.createEmptyStats()\n        this.agentStats.set(context.agentId, stats)\n      }\n      this.aggregateInto(stats, record)\n    }\n\n    // Emit event\n    this.emitEvent({\n      eventType: 'usage_recorded',\n      scope: { type: 'global' },\n      usage: record,\n      aggregated: this.globalStats,\n      globalStats: this.globalStats,\n    })\n  }\n\n  // ===== Getters =====\n\n  /**\n   * Get global aggregated statistics\n   */\n  getGlobalStats(): AggregatedTokenStats {\n    return this.cloneStats(this.globalStats)\n  }\n\n  /**\n   * Get statistics for a specific agent\n   *\n   * @param agentId - Agent ID to get stats for\n   * @returns Agent stats or null if not found\n   */\n  getAgentStats(agentId: string): AggregatedTokenStats | null {\n    const stats = this.agentStats.get(agentId)\n    return stats ? this.cloneStats(stats) : null\n  }\n\n  /**\n   * Get all agent statistics\n   */\n  getAllAgentStats(): Map<string, AggregatedTokenStats> {\n    const result = new Map<string, AggregatedTokenStats>()\n    for (const [agentId, stats] of this.agentStats) {\n      result.set(agentId, this.cloneStats(stats))\n    }\n    return result\n  }\n\n  /**\n   * Get a specific request record\n   */\n  getRequestRecord(requestId: string): TokenUsageRecord | null {\n    return this.requestRecords.get(requestId) ?? null\n  }\n\n  // ===== Backward Compatibility Layer =====\n\n  /**\n   * Get total tokens (for costTracker.getTokenCounts compatibility)\n   *\n   * This method provides backward compatibility with the existing\n   * costTracker.getTokenCounts() interface.\n   */\n  getTokenCounts(): {\n    input: number\n    output: number\n    cacheCreation: number\n    cacheRead: number\n    total: number\n  } {\n    return {\n      input: this.globalStats.totalInputTokens,\n      output: this.globalStats.totalOutputTokens,\n      cacheCreation: this.globalStats.totalCacheCreationTokens,\n      cacheRead: this.globalStats.totalCacheReadTokens,\n      total: this.globalStats.grandTotalTokens,\n    }\n  }\n\n  // ===== Event Subscription =====\n\n  /**\n   * Subscribe to all stats updates\n   *\n   * @param callback - Called when any stats change\n   * @returns Unsubscribe function\n   */\n  onStatsUpdate(callback: (event: TokenStatsEvent) => void): () => void {\n    this.on('stats_update', callback)\n    return () => this.off('stats_update', callback)\n  }\n\n  /**\n   * Subscribe to updates for a specific agent\n   *\n   * @param agentId - Agent ID to subscribe to\n   * @param callback - Called when agent stats change\n   * @returns Unsubscribe function\n   */\n  onAgentStatsUpdate(\n    agentId: string,\n    callback: (stats: AggregatedTokenStats) => void,\n  ): () => void {\n    const handler = (event: TokenStatsEvent) => {\n      if (event.scope.type === 'agent' && event.scope.agentId === agentId) {\n        callback(event.aggregated)\n      }\n    }\n    this.on('stats_update', handler)\n    return () => this.off('stats_update', handler)\n  }\n\n  /**\n   * Subscribe to global stats updates only\n   *\n   * @param callback - Called when global stats change\n   * @returns Unsubscribe function\n   */\n  onGlobalStatsUpdate(\n    callback: (stats: AggregatedTokenStats) => void,\n  ): () => void {\n    const handler = (event: TokenStatsEvent) => {\n      callback(event.globalStats)\n    }\n    this.on('stats_update', handler)\n    return () => this.off('stats_update', handler)\n  }\n\n  // ===== Agent Lifecycle =====\n\n  /**\n   * Mark an agent's scope as completed\n   *\n   * This emits a scope_completed event and optionally\n   * cleans up the agent's stats from memory.\n   *\n   * @param agentId - Agent ID to complete\n   * @param cleanup - Whether to remove from memory (default: false)\n   */\n  completeAgentScope(agentId: string, cleanup: boolean = false): void {\n    const stats = this.agentStats.get(agentId)\n    if (!stats) return\n\n    this.emitEvent({\n      eventType: 'scope_completed',\n      scope: { type: 'agent', agentId },\n      aggregated: stats,\n      globalStats: this.globalStats,\n    })\n\n    if (cleanup) {\n      this.agentStats.delete(agentId)\n    }\n  }\n\n  // ===== Internal Methods =====\n\n  private createEmptyStats(): AggregatedTokenStats {\n    return {\n      totalInputTokens: 0,\n      totalOutputTokens: 0,\n      totalCacheCreationTokens: 0,\n      totalCacheReadTokens: 0,\n      grandTotalTokens: 0,\n      totalCostUSD: 0,\n      requestCount: 0,\n      byModel: new Map(),\n    }\n  }\n\n  private aggregateInto(\n    stats: AggregatedTokenStats,\n    record: TokenUsageRecord,\n  ): void {\n    stats.totalInputTokens += record.inputTokens\n    stats.totalOutputTokens += record.outputTokens\n    stats.totalCacheCreationTokens += record.cacheCreationTokens\n    stats.totalCacheReadTokens += record.cacheReadTokens\n    stats.grandTotalTokens += record.totalTokens\n    stats.totalCostUSD += record.estimatedCostUSD\n    stats.requestCount += 1\n\n    if (!stats.firstRequestTime) {\n      stats.firstRequestTime = record.timestamp\n    }\n    stats.lastRequestTime = record.timestamp\n\n    // Update per-model breakdown\n    const modelStats = stats.byModel.get(record.model)\n    if (modelStats) {\n      modelStats.inputTokens += record.inputTokens\n      modelStats.outputTokens += record.outputTokens\n      modelStats.totalTokens += record.totalTokens\n      modelStats.estimatedCostUSD += record.estimatedCostUSD\n      modelStats.requestCount += 1\n    } else {\n      stats.byModel.set(record.model, {\n        model: record.model,\n        inputTokens: record.inputTokens,\n        outputTokens: record.outputTokens,\n        totalTokens: record.totalTokens,\n        estimatedCostUSD: record.estimatedCostUSD,\n        requestCount: 1,\n      })\n    }\n  }\n\n  private cloneStats(stats: AggregatedTokenStats): AggregatedTokenStats {\n    return {\n      ...stats,\n      byModel: new Map(stats.byModel),\n    }\n  }\n\n  private emitEvent(event: TokenStatsEvent): void {\n    this.emit('stats_update', event)\n  }\n\n  /**\n   * Reset all stats (for testing only)\n   */\n  resetForTests(): void {\n    if (process.env.NODE_ENV !== 'test') {\n      throw new Error('resetForTests can only be called in tests')\n    }\n    this.reset()\n  }\n\n  /**\n   * Reset all statistics\n   *\n   * Called by costTracker.resetStateForTests() for backward compatibility.\n   */\n  reset(): void {\n    this.globalStats = this.createEmptyStats()\n    this.agentStats.clear()\n    this.requestRecords.clear()\n  }\n}\n\n// Export singleton instance\nexport const tokenStatsManager = TokenStatsManagerImpl.getInstance()\n\n// ===== Convenience Functions =====\n\n/**\n * Record token usage from an API response\n *\n * This is the main function to call from claude.ts after each API response.\n * Also updates the persistent stats manager for cross-session tracking.\n */\nexport function recordTokenUsage(\n  usage: RawTokenUsage,\n  costUSD: number,\n  model: string,\n  context?: TokenTrackingContext,\n): void {\n  tokenStatsManager.recordUsage(usage, costUSD, model, context)\n\n  // Also record to persistent stats manager (fire-and-forget)\n  try {\n    const { recordMessage } = require('@utils/stats')\n    recordMessage(model, usage.inputTokens, usage.outputTokens, costUSD)\n  } catch {\n    // Stats manager not available, ignore\n  }\n}\n\n/**\n * Get global token statistics\n */\nexport function getGlobalTokenStats(): AggregatedTokenStats {\n  return tokenStatsManager.getGlobalStats()\n}\n\n/**\n * Get token statistics for a specific agent\n */\nexport function getAgentTokenStats(\n  agentId: string,\n): AggregatedTokenStats | null {\n  return tokenStatsManager.getAgentStats(agentId)\n}\n\n/**\n * Estimate token count from text\n */\nexport function estimateTokenCount(text: string): number {\n  return tokenStatsManager.estimateTokens(text)\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/entrypoints/bootstrap.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env -S node --no-warnings=ExperimentalWarning --enable-source-maps
+import { EventEmitter } from "events";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+process.env.DEV = "false";
+process.env["DEV"] = "false";
+EventEmitter.defaultMaxListeners = 20;
+try {
+  if (!process.env.YOGA_WASM_PATH) {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const candidates = [
+      join(__dirname, "./yoga.wasm"),
+      // dist/entrypoints/yoga.wasm
+      join(__dirname, "../yoga.wasm"),
+      // dist/yoga.wasm
+      join(__dirname, "../../yoga.wasm")
+      // project root (dev mode)
+    ];
+    for (const candidate of candidates) {
+      if (existsSync(candidate)) {
+        process.env.YOGA_WASM_PATH = candidate;
+        break;
+      }
+    }
+  }
+} catch {
+}
+async function main() {
+  try {
+    await import("./cli.js");
+  } catch (error) {
+    const err = error;
+    const message = err.message || "";
+    if (message.includes("react-devtools-core")) {
+      console.error("\n\u274C Failed to start: react-devtools-core not found");
+      console.error("   This may be caused by DEV environment variable being set.");
+      console.error("   Try running: unset DEV && minto\n");
+    } else if (message.includes("yoga") || message.includes("YOGA")) {
+      console.error("\n\u274C Failed to start: yoga-layout initialization failed");
+      console.error("   The yoga.wasm file may be missing or corrupted.");
+      console.error("   Try reinstalling: npm install -g @within-7/minto\n");
+    } else {
+      console.error("\u274C Failed to start:", message || err);
+      if (err.stack) {
+        console.error(err.stack);
+      }
+    }
+    process.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=bootstrap.js.map

package/dist/entrypoints/bootstrap.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/entrypoints/bootstrap.ts"],
+  "sourcesContent": ["#!/usr/bin/env -S node --no-warnings=ExperimentalWarning --enable-source-maps\n\n/**\n * Bootstrap entry point for Minto CLI\n *\n * CRITICAL: This file MUST remain minimal with NO static imports of application code.\n *\n * This bootstrap exists because ESM static imports execute BEFORE the importing\n * module's code. We need certain initializations to happen BEFORE any application\n * modules are loaded:\n *\n * 1. DEV='false' - Ink checks process.env['DEV'] at module load time and tries to\n *    import 'react-devtools-core' if DEV='true'. This package isn't bundled.\n *\n * 2. EventEmitter.defaultMaxListeners - Must be set before any modules create\n *    EventEmitters to prevent \"MaxListenersExceededWarning\" during startup.\n *\n * 3. YOGA_WASM_PATH - Must be set before Ink initializes yoga-layout for proper\n *    terminal layout rendering.\n *\n * Solution: Use dynamic import() to load cli.tsx AFTER all initializations.\n * Dynamic import() is evaluated at runtime, not at module load time.\n *\n * DO NOT add any static imports here except for Node.js built-ins that don't\n * chain to application code (directly or transitively).\n */\n\nimport { EventEmitter } from 'events'\nimport { fileURLToPath } from 'node:url'\nimport { dirname, join } from 'node:path'\nimport { existsSync } from 'node:fs'\n\n// ============================================================================\n// 1. Disable Ink's development mode\n// ============================================================================\n// Prevents Ink from trying to load react-devtools-core which isn't bundled.\n// Must use both syntaxes because Bun's --define only replaces dot syntax.\nprocess.env.DEV = 'false'\nprocess.env['DEV'] = 'false'\n\n// ============================================================================\n// 2. Increase EventEmitter max listeners\n// ============================================================================\n// Components like ModelConfig, ModelSelector use multiple useInput hooks which\n// add listeners. Default is 10, we increase to 20 to accommodate deep hierarchies.\n// Must be set before any modules create EventEmitters.\nEventEmitter.defaultMaxListeners = 20\n\n// ============================================================================\n// 3. Set YOGA_WASM_PATH for Ink layout engine\n// ============================================================================\n// Ink uses yoga-layout for terminal UI layout. The WASM file path must be set\n// before Ink initializes. Resolve relative to this file for both dev and dist.\ntry {\n  if (!process.env.YOGA_WASM_PATH) {\n    const __filename = fileURLToPath(import.meta.url)\n    const __dirname = dirname(__filename)\n    // Check multiple possible locations\n    const candidates = [\n      join(__dirname, './yoga.wasm'),      // dist/entrypoints/yoga.wasm\n      join(__dirname, '../yoga.wasm'),     // dist/yoga.wasm\n      join(__dirname, '../../yoga.wasm'),  // project root (dev mode)\n    ]\n    for (const candidate of candidates) {\n      if (existsSync(candidate)) {\n        process.env.YOGA_WASM_PATH = candidate\n        break\n      }\n    }\n  }\n} catch {\n  // Ignore errors - yoga will use fallback or error at runtime\n}\n\n// ============================================================================\n// Main: Dynamically import the CLI\n// ============================================================================\n// This ensures all static imports in cli.tsx see the initialized environment.\nasync function main(): Promise<void> {\n  try {\n    await import('./cli.js')\n  } catch (error) {\n    // Provide helpful error messages for common failures\n    const err = error as Error\n    const message = err.message || ''\n\n    if (message.includes('react-devtools-core')) {\n      console.error('\\n\u274C Failed to start: react-devtools-core not found')\n      console.error('   This may be caused by DEV environment variable being set.')\n      console.error('   Try running: unset DEV && minto\\n')\n    } else if (message.includes('yoga') || message.includes('YOGA')) {\n      console.error('\\n\u274C Failed to start: yoga-layout initialization failed')\n      console.error('   The yoga.wasm file may be missing or corrupted.')\n      console.error('   Try reinstalling: npm install -g @within-7/minto\\n')\n    } else {\n      console.error('\u274C Failed to start:', message || err)\n      if (err.stack) {\n        console.error(err.stack)\n      }\n    }\n    process.exit(1)\n  }\n}\n\nmain()\n"],
+  "mappings": ";AA2BA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,SAAS,YAAY;AAC9B,SAAS,kBAAkB;AAO3B,QAAQ,IAAI,MAAM;AAClB,QAAQ,IAAI,KAAK,IAAI;AAQrB,aAAa,sBAAsB;AAOnC,IAAI;AACF,MAAI,CAAC,QAAQ,IAAI,gBAAgB;AAC/B,UAAM,aAAa,cAAc,YAAY,GAAG;AAChD,UAAM,YAAY,QAAQ,UAAU;AAEpC,UAAM,aAAa;AAAA,MACjB,KAAK,WAAW,aAAa;AAAA;AAAA,MAC7B,KAAK,WAAW,cAAc;AAAA;AAAA,MAC9B,KAAK,WAAW,iBAAiB;AAAA;AAAA,IACnC;AACA,eAAW,aAAa,YAAY;AAClC,UAAI,WAAW,SAAS,GAAG;AACzB,gBAAQ,IAAI,iBAAiB;AAC7B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF,QAAQ;AAER;AAMA,eAAe,OAAsB;AACnC,MAAI;AACF,UAAM,OAAO,UAAU;AAAA,EACzB,SAAS,OAAO;AAEd,UAAM,MAAM;AACZ,UAAM,UAAU,IAAI,WAAW;AAE/B,QAAI,QAAQ,SAAS,qBAAqB,GAAG;AAC3C,cAAQ,MAAM,yDAAoD;AAClE,cAAQ,MAAM,8DAA8D;AAC5E,cAAQ,MAAM,sCAAsC;AAAA,IACtD,WAAW,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,GAAG;AAC/D,cAAQ,MAAM,6DAAwD;AACtE,cAAQ,MAAM,oDAAoD;AAClE,cAAQ,MAAM,uDAAuD;AAAA,IACvE,OAAO;AACL,cAAQ,MAAM,2BAAsB,WAAW,GAAG;AAClD,UAAI,IAAI,OAAO;AACb,gBAAQ,MAAM,IAAI,KAAK;AAAA,MACzB;AAAA,IACF;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAEA,KAAK;",
+  "names": []
+}

package/dist/entrypoints/cli.js

@@ -1,33 +1,14 @@
 #!/usr/bin/env -S node --no-warnings=ExperimentalWarning --enable-source-maps
-process.env.DEV = "false";
-import { EventEmitter } from "events";
-EventEmitter.defaultMaxListeners = 20;
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-import { existsSync } from "node:fs";
 import { initSentry } from "../services/sentry.js";
 import { PRODUCT_COMMAND, PRODUCT_NAME } from "../constants/product.js";
 import { initGlobalErrorHandlers } from "../utils/globalErrorHandler.js";
 initSentry();
 initGlobalErrorHandlers();
-try {
-  if (!process.env.YOGA_WASM_PATH) {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const devCandidate = join(__dirname, "../../yoga.wasm");
-    const distCandidate = join(__dirname, "./yoga.wasm");
-    const resolved = existsSync(distCandidate) ? distCandidate : existsSync(devCandidate) ? devCandidate : void 0;
-    if (resolved) {
-      process.env.YOGA_WASM_PATH = resolved;
-    }
-  }
-} catch {
-}
 import * as dontcare from "@anthropic-ai/sdk/shims/node";
 Object.keys(dontcare);
 import React from "react";
 import { ReadStream } from "tty";
-import { openSync } from "fs";
+import { existsSync, openSync } from "fs";
 import { validateRawModeSupport, requireRawModeOrExit } from "../utils/ptyCompat.js";
 import { addToHistory } from "../history.js";
 import { getContext, setContext, removeContext } from "../context.js";
@@ -80,12 +61,24 @@ import {
   ensureConfigScope
 } from "../services/mcpClient.js";
 import { handleMcprcServerApprovals } from "../services/mcpServerApproval.js";
+import {
+  fetchTeamConfig,
+  loadTeamConfigFromFile,
+  applyTeamConfig,
+  addMarketplaces,
+  installPlugins,
+  installRemoteAgents,
+  installInlineAgents,
+  installTeamHooks
+} from "../utils/teamConfig.js";
 import { cursorShow } from "ansi-escapes";
 import {
   getLatestVersion,
   assertMinVersion,
   getUpdateCommandSuggestions
 } from "../utils/autoUpdater.js";
+import { ensureConfigDirs } from "../utils/configPaths.js";
+import { runStartupMigration } from "../utils/migration/index.js";
 import {
   initI18n,
   setLanguage,
@@ -270,6 +263,14 @@ if (process.env.NODE_ENV !== "test") {
   });
 }
 async function main() {
+  const configDirsResult = ensureConfigDirs();
+  if (configDirsResult.errors.length > 0) {
+    for (const err of configDirsResult.errors) {
+      console.warn(`\u26A0\uFE0F  Config directory warning: ${err.path} - ${err.error}`);
+    }
+  }
+  runStartupMigration().catch(() => {
+  });
   const globalConfig = getGlobalConfig();
   const configLang = globalConfig.language;
   if (configLang && isLanguageSupported(configLang)) {
@@ -573,6 +574,114 @@ ${commandList}`
     );
     process.exit(0);
   });
+  program.command("setup").description("Initialize Minto with team configuration from a URL or file").requiredOption(
+    "--from <source>",
+    "URL or file path to the team configuration JSON"
+  ).option(
+    "--strategy <strategy>",
+    "Merge strategy: merge, replace, or skip-existing",
+    "merge"
+  ).option("--no-plugins", "Skip installing plugins, agents, and hooks").action(
+    async (options) => {
+      const {
+        from: source,
+        strategy,
+        plugins: shouldInstallPlugins
+      } = options;
+      try {
+        console.log(`Loading configuration from ${source}...`);
+        const teamConfig = source.startsWith("http://") || source.startsWith("https://") ? await fetchTeamConfig(source) : loadTeamConfigFromFile(source);
+        console.log("Applying configuration...");
+        const result = applyTeamConfig(teamConfig, strategy);
+        let marketplacesAdded = 0;
+        if (shouldInstallPlugins && teamConfig.plugins?.marketplaces) {
+          console.log(
+            `Adding ${teamConfig.plugins.marketplaces.length} marketplace(s)...`
+          );
+          const marketplaceResult = await addMarketplaces(
+            teamConfig.plugins.marketplaces
+          );
+          marketplacesAdded = marketplaceResult.added;
+        }
+        let pluginsInstalled = 0;
+        if (shouldInstallPlugins && teamConfig.plugins?.install) {
+          console.log(
+            `Installing ${teamConfig.plugins.install.length} plugin(s)...`
+          );
+          const pluginResult = await installPlugins(
+            teamConfig.plugins.install
+          );
+          pluginsInstalled = pluginResult.installed;
+        }
+        let agentsInstalled = 0;
+        if (shouldInstallPlugins && teamConfig.agents) {
+          const remoteCount = teamConfig.agents.remoteAgents?.length || 0;
+          const inlineCount = teamConfig.agents.inlineAgents?.length || 0;
+          const totalAgents = remoteCount + inlineCount;
+          if (totalAgents > 0) {
+            console.log(`Installing ${totalAgents} agent(s)...`);
+            if (teamConfig.agents.remoteAgents) {
+              const remoteResult = await installRemoteAgents(
+                teamConfig.agents.remoteAgents
+              );
+              agentsInstalled += remoteResult.installed;
+            }
+            if (teamConfig.agents.inlineAgents) {
+              const inlineResult = await installInlineAgents(
+                teamConfig.agents.inlineAgents
+              );
+              agentsInstalled += inlineResult.installed;
+            }
+          }
+        }
+        let hooksInstalled = false;
+        if (shouldInstallPlugins && teamConfig.hooks) {
+          console.log("Installing hooks...");
+          const hookResult = await installTeamHooks(teamConfig.hooks);
+          hooksInstalled = hookResult.installed;
+        }
+        console.log("\n\u2713 Configuration applied successfully!\n");
+        if (result.modelsAdded > 0) {
+          console.log(`  \u2022 Added ${result.modelsAdded} model profile(s)`);
+        }
+        if (result.mcpServersAdded > 0) {
+          console.log(`  \u2022 Added ${result.mcpServersAdded} MCP server(s)`);
+        }
+        if (result.settingsUpdated.length > 0) {
+          console.log(
+            `  \u2022 Updated ${result.settingsUpdated.length} setting(s): ${result.settingsUpdated.join(", ")}`
+          );
+        }
+        if (marketplacesAdded > 0) {
+          console.log(`  \u2022 Added ${marketplacesAdded} marketplace(s)`);
+        }
+        if (pluginsInstalled > 0) {
+          console.log(`  \u2022 Installed ${pluginsInstalled} plugin(s)`);
+        }
+        if (agentsInstalled > 0) {
+          console.log(`  \u2022 Installed ${agentsInstalled} agent(s)`);
+        }
+        if (hooksInstalled) {
+          console.log("  \u2022 Installed hooks configuration");
+        }
+        if (teamConfig.postInstallInstructions) {
+          console.log("\n\u{1F4CB} Next Steps:");
+          console.log(teamConfig.postInstallInstructions);
+        }
+        console.log(
+          `
+Run "${PRODUCT_COMMAND}" to start using your configured setup.`
+        );
+        process.exit(0);
+      } catch (error) {
+        console.error(
+          "\u2717 Setup failed:",
+          error instanceof Error ? error.message : String(error)
+        );
+        process.exit(1);
+      }
+    }
+  );
   const allowedTools = program.command("approved-tools").description("Manage approved tools");
   allowedTools.command("list").description("List all approved tools").action(async () => {
     const result = handleListApprovedTools(getCwd());
@@ -835,7 +944,7 @@ ${commandList}`
       const scope = ensureConfigScope(options.scope);
       const platform = process.platform;
       const { existsSync: existsSync2, readFileSync } = await import("fs");
-      const { join: join2 } = await import("path");
+      const { join } = await import("path");
       const { exec } = await import("child_process");
       const isWSL = platform === "linux" && existsSync2("/proc/version") && readFileSync("/proc/version", "utf-8").toLowerCase().includes("microsoft");
       if (platform !== "darwin" && platform !== "win32" && !isWSL) {
@@ -846,12 +955,12 @@ ${commandList}`
       }
       let configPath;
       if (platform === "darwin") {
-        configPath = join2(
+        configPath = join(
           process.env.HOME || "~",
           "Library/Application Support/Claude/claude_desktop_config.json"
         );
       } else if (platform === "win32") {
-        configPath = join2(
+        configPath = join(
           process.env.APPDATA || "",
           "Claude/claude_desktop_config.json"
         );