@within-7/minto 0.3.9 → 0.4.0

package/dist/utils/skillLoader.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/skillLoader.ts"],
-  "sourcesContent": ["/**\n * Skill Loader\n *\n * Progressive disclosure system for loading skills from plugins and standalone directories.\n * Implements Claude Code skill specification for plugin and standalone skills.\n *\n * Directory Priority (later overrides earlier):\n * 1. Plugin skills\n * 2. ~/.minto/skills/ (user directory)\n * 3. ./.minto/skills/ (project directory - highest priority)\n *\n * Supports two file patterns:\n * - skill-name/SKILL.md (subdirectory pattern)\n * - skill-name.md (flat file pattern)\n */\n\nimport { existsSync, readFileSync, readdirSync, statSync } from 'fs'\nimport { join, basename, dirname } from 'path'\nimport { homedir } from 'os'\nimport matter from 'gray-matter'\nimport { LoadedSkill, SkillConfig } from '../types/plugin'\nimport { loadAllPlugins } from './pluginLoader'\nimport { getCwd } from './state'\n\n/**\n * In-memory cache for loaded skills\n * Maps skill name to skill object\n */\nlet skillsCache: Map<string, LoadedSkill> | null = null\n\n/**\n * Cache for fully-loaded skill content\n * Maps skill name to full markdown content\n */\nconst contentCache = new Map<string, string>()\n\n/**\n * Parse a skill file and extract configuration\n * Supports Claude Code skill specification frontmatter fields\n */\nfunction parseSkillFile(\n  filePath: string,\n  source: 'user' | 'project',\n): LoadedSkill | null {\n  try {\n    if (!existsSync(filePath)) return null\n\n    const fileContent = readFileSync(filePath, 'utf-8')\n    const { data: frontmatter, content } = matter(fileContent)\n\n    // Determine skill name from frontmatter or filename\n    const fileName = basename(filePath, '.md')\n    const name =\n      frontmatter.name ||\n      (fileName === 'SKILL' ? basename(dirname(filePath)) : fileName)\n\n    // Parse Claude Code spec fields\n    const config: SkillConfig = {\n      name,\n      description: frontmatter.description || '',\n      argumentHint: frontmatter['argument-hint'] || frontmatter.argumentHint,\n      disableModelInvocation:\n        frontmatter['disable-model-invocation'] ??\n        frontmatter.disableModelInvocation,\n      userInvocable:\n        frontmatter['user-invocable'] ?? frontmatter.userInvocable ?? true,\n      allowedTools: parseStringOrArray(\n        frontmatter['allowed-tools'] || frontmatter.allowedTools,\n      ),\n      model: frontmatter.model,\n      context: frontmatter.context,\n      agent: frontmatter.agent,\n      content: content.trim(),\n    }\n\n    return {\n      name,\n      filePath,\n      config,\n      pluginName: 'standalone',\n      source,\n    }\n  } catch (error) {\n    console.warn(`Failed to parse skill file ${filePath}:`, error)\n    return null\n  }\n}\n\n/**\n * Parse a value that could be a string, array, or comma-separated string\n */\nfunction parseStringOrArray(value: unknown): string[] | undefined {\n  if (!value) return undefined\n  if (Array.isArray(value)) return value.map(String)\n  if (typeof value === 'string') {\n    return value.split(',').map(s => s.trim())\n  }\n  return undefined\n}\n\n/**\n * Scan a standalone skills directory\n * Supports both patterns:\n * - skill-name/SKILL.md (subdirectory pattern)\n * - skill-name.md (flat file pattern)\n */\nfunction scanStandaloneSkillsDirectory(\n  dirPath: string,\n  source: 'user' | 'project',\n): LoadedSkill[] {\n  const skills: LoadedSkill[] = []\n\n  if (!existsSync(dirPath)) return skills\n\n  try {\n    const entries = readdirSync(dirPath, { withFileTypes: true })\n\n    for (const entry of entries) {\n      const entryPath = join(dirPath, entry.name)\n\n      if (entry.isDirectory()) {\n        // Pattern 1: skill-name/SKILL.md\n        const skillMdPath = join(entryPath, 'SKILL.md')\n        if (existsSync(skillMdPath)) {\n          const skill = parseSkillFile(skillMdPath, source)\n          if (skill) skills.push(skill)\n        }\n      } else if (entry.name.endsWith('.md') && entry.name !== 'README.md') {\n        // Pattern 2: skill-name.md\n        const skill = parseSkillFile(entryPath, source)\n        if (skill) skills.push(skill)\n      }\n    }\n  } catch (error) {\n    console.warn(`Failed to scan skills directory ${dirPath}:`, error)\n  }\n\n  return skills\n}\n\n/**\n * Load all standalone skills from user and project directories\n */\nfunction loadStandaloneSkills(): LoadedSkill[] {\n  const home = homedir()\n  const cwd = getCwd()\n\n  const userSkillsDir = join(home, '.minto', 'skills')\n  const projectSkillsDir = join(cwd, '.minto', 'skills')\n\n  const userSkills = scanStandaloneSkillsDirectory(userSkillsDir, 'user')\n  const projectSkills = scanStandaloneSkillsDirectory(\n    projectSkillsDir,\n    'project',\n  )\n\n  return [...userSkills, ...projectSkills]\n}\n\n/**\n * Load all skills from plugins and standalone directories\n * Uses progressive disclosure - only loads metadata (name, description)\n * Content is lazy-loaded when needed\n *\n * Priority: plugin < user < project (later overrides earlier)\n */\nexport function loadAllSkills(): LoadedSkill[] {\n  // Return cached skills if available\n  if (skillsCache !== null) {\n    return Array.from(skillsCache.values())\n  }\n\n  const pluginSkills: LoadedSkill[] = []\n  const plugins = loadAllPlugins()\n\n  // Collect all skills from all plugins\n  for (const plugin of plugins) {\n    if (!plugin.enabled) continue\n\n    for (const skill of plugin.skills) {\n      // Ensure plugin skills have source field\n      pluginSkills.push({\n        ...skill,\n        source: 'plugin',\n      })\n    }\n  }\n\n  // Load standalone skills\n  const standaloneSkills = loadStandaloneSkills()\n\n  // Build cache map for fast lookups (later entries override earlier ones)\n  skillsCache = new Map()\n\n  // Add in priority order: plugin < standalone (user < project)\n  for (const skill of pluginSkills) {\n    skillsCache.set(skill.name, skill)\n  }\n  for (const skill of standaloneSkills) {\n    skillsCache.set(skill.name, skill)\n  }\n\n  return Array.from(skillsCache.values())\n}\n\n/**\n * Get a specific skill by name\n * Returns undefined if skill not found\n */\nexport function getSkill(name: string): LoadedSkill | undefined {\n  // Ensure cache is populated\n  if (skillsCache === null) {\n    loadAllSkills()\n  }\n\n  return skillsCache?.get(name)\n}\n\n/**\n * Load the full content of a skill\n * Uses caching to avoid repeated file reads\n */\nexport async function loadSkillContent(skill: LoadedSkill): Promise<string> {\n  // Check content cache first\n  if (contentCache.has(skill.name)) {\n    return contentCache.get(skill.name)!\n  }\n\n  // If content was already loaded in the skill object, use it\n  if (skill.config.content) {\n    contentCache.set(skill.name, skill.config.content)\n    return skill.config.content\n  }\n\n  // Otherwise, read from file\n  try {\n    const fileContent = readFileSync(skill.filePath, 'utf-8')\n    const { content } = matter(fileContent)\n    const trimmedContent = content.trim()\n\n    // Cache the content\n    contentCache.set(skill.name, trimmedContent)\n\n    // Update the skill object\n    skill.config.content = trimmedContent\n\n    return trimmedContent\n  } catch (error) {\n    throw new Error(\n      `Failed to load skill content for \"${skill.name}\": ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    )\n  }\n}\n\n/**\n * Search skills by name or description\n * Returns skills matching the query (case-insensitive)\n */\nexport function searchSkills(query: string): LoadedSkill[] {\n  const allSkills = loadAllSkills()\n  const lowerQuery = query.toLowerCase()\n\n  return allSkills.filter(\n    skill =>\n      skill.name.toLowerCase().includes(lowerQuery) ||\n      skill.config.description.toLowerCase().includes(lowerQuery) ||\n      skill.pluginName.toLowerCase().includes(lowerQuery),\n  )\n}\n\n/**\n * Get skills from a specific plugin\n */\nexport function getSkillsByPlugin(pluginName: string): LoadedSkill[] {\n  const allSkills = loadAllSkills()\n  return allSkills.filter(skill => skill.pluginName === pluginName)\n}\n\n/**\n * Clear the skills cache (useful for hot-reloading)\n */\nexport function clearSkillsCache(): void {\n  skillsCache = null\n  contentCache.clear()\n}\n\n/**\n * Get count of available skills\n */\nexport function getSkillCount(): number {\n  const skills = loadAllSkills()\n  return skills.length\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Skill Loader\n *\n * Progressive disclosure system for loading skills from plugins and standalone directories.\n * Implements Claude Code skill specification for plugin and standalone skills.\n *\n * Directory Priority (later overrides earlier):\n * 1. Plugin skills\n * 2. ~/.minto/skills/ (user directory)\n * 3. ./.minto/skills/ (project directory - highest priority)\n *\n * Supports two file patterns:\n * - skill-name/SKILL.md (subdirectory pattern)\n * - skill-name.md (flat file pattern)\n */\n\nimport { existsSync, readFileSync, readdirSync, statSync } from 'fs'\nimport { join, basename, dirname } from 'path'\nimport { homedir } from 'os'\nimport matter from 'gray-matter'\nimport { LoadedSkill, SkillConfig, SkillHookDefinition } from '../types/plugin'\nimport { loadAllPlugins } from './pluginLoader'\nimport { getCwd } from './state'\n\n/**\n * In-memory cache for loaded skills\n * Maps skill name to skill object\n */\nlet skillsCache: Map<string, LoadedSkill> | null = null\n\n/**\n * Cache for fully-loaded skill content\n * Maps skill name to full markdown content\n */\nconst contentCache = new Map<string, string>()\n\n/**\n * Parse a skill file and extract configuration\n * Supports Claude Code skill specification frontmatter fields\n */\nfunction parseSkillFile(\n  filePath: string,\n  source: 'user' | 'project',\n): LoadedSkill | null {\n  try {\n    if (!existsSync(filePath)) return null\n\n    const fileContent = readFileSync(filePath, 'utf-8')\n    const { data: frontmatter, content } = matter(fileContent)\n\n    // Determine skill name from frontmatter or filename\n    const fileName = basename(filePath, '.md')\n    const name =\n      frontmatter.name ||\n      (fileName === 'SKILL' ? basename(dirname(filePath)) : fileName)\n\n    // Parse hooks from frontmatter\n    const hooks = parseSkillHooks(frontmatter.hooks)\n\n    // Parse Claude Code spec fields\n    const config: SkillConfig = {\n      name,\n      description: frontmatter.description || '',\n      argumentHint: frontmatter['argument-hint'] || frontmatter.argumentHint,\n      disableModelInvocation:\n        frontmatter['disable-model-invocation'] ??\n        frontmatter.disableModelInvocation,\n      userInvocable:\n        frontmatter['user-invocable'] ?? frontmatter.userInvocable ?? true,\n      allowedTools: parseStringOrArray(\n        frontmatter['allowed-tools'] || frontmatter.allowedTools,\n      ),\n      model: frontmatter.model,\n      context: frontmatter.context,\n      agent: frontmatter.agent,\n      ...(hooks?.length && { hooks }),\n      ...(frontmatter.license && { license: frontmatter.license }),\n      ...(frontmatter.compatibility && {\n        compatibility: frontmatter.compatibility,\n      }),\n      ...(frontmatter.metadata && { metadata: frontmatter.metadata }),\n      content: content.trim(),\n    }\n\n    return {\n      name,\n      filePath,\n      config,\n      pluginName: 'standalone',\n      source,\n    }\n  } catch (error) {\n    console.warn(`Failed to parse skill file ${filePath}:`, error)\n    return null\n  }\n}\n\n/**\n * Parse skill-level hooks from frontmatter\n */\nfunction parseSkillHooks(hooks: unknown): SkillHookDefinition[] | undefined {\n  if (!hooks) return undefined\n  if (!Array.isArray(hooks)) return undefined\n\n  const parsed: SkillHookDefinition[] = []\n  for (const h of hooks) {\n    if (!h || typeof h !== 'object') continue\n    if (!h.event) continue\n    parsed.push({\n      event: h.event,\n      ...(h.matcher && { matcher: h.matcher }),\n      ...(h.type && { type: h.type }),\n      ...(h.command && { command: h.command }),\n      ...(h.prompt && { prompt: h.prompt }),\n      ...(h.timeout && { timeout: Number(h.timeout) }),\n    })\n  }\n  return parsed.length > 0 ? parsed : undefined\n}\n\n/**\n * Parse a value that could be a string, array, or comma-separated string\n */\nfunction parseStringOrArray(value: unknown): string[] | undefined {\n  if (!value) return undefined\n  if (Array.isArray(value)) return value.map(String)\n  if (typeof value === 'string') {\n    return value.split(',').map(s => s.trim())\n  }\n  return undefined\n}\n\n/**\n * Scan a standalone skills directory\n * Supports both patterns:\n * - skill-name/SKILL.md (subdirectory pattern)\n * - skill-name.md (flat file pattern)\n */\nfunction scanStandaloneSkillsDirectory(\n  dirPath: string,\n  source: 'user' | 'project',\n): LoadedSkill[] {\n  const skills: LoadedSkill[] = []\n\n  if (!existsSync(dirPath)) return skills\n\n  try {\n    const entries = readdirSync(dirPath, { withFileTypes: true })\n\n    for (const entry of entries) {\n      const entryPath = join(dirPath, entry.name)\n\n      if (entry.isDirectory()) {\n        // Pattern 1: skill-name/SKILL.md\n        const skillMdPath = join(entryPath, 'SKILL.md')\n        if (existsSync(skillMdPath)) {\n          const skill = parseSkillFile(skillMdPath, source)\n          if (skill) skills.push(skill)\n        }\n      } else if (entry.name.endsWith('.md') && entry.name !== 'README.md') {\n        // Pattern 2: skill-name.md\n        const skill = parseSkillFile(entryPath, source)\n        if (skill) skills.push(skill)\n      }\n    }\n  } catch (error) {\n    console.warn(`Failed to scan skills directory ${dirPath}:`, error)\n  }\n\n  return skills\n}\n\n/**\n * Load all standalone skills from user and project directories\n */\nfunction loadStandaloneSkills(): LoadedSkill[] {\n  const home = homedir()\n  const cwd = getCwd()\n\n  // .claude/ dirs are legacy fallbacks, .minto/ dirs take precedence\n  const userClaudeDir = join(home, '.claude', 'skills')\n  const userMintoDir = join(home, '.minto', 'skills')\n  const projectClaudeDir = join(cwd, '.claude', 'skills')\n  const projectMintoDir = join(cwd, '.minto', 'skills')\n\n  const userClaudeSkills = scanStandaloneSkillsDirectory(userClaudeDir, 'user')\n  const userMintoSkills = scanStandaloneSkillsDirectory(userMintoDir, 'user')\n  const projectClaudeSkills = scanStandaloneSkillsDirectory(\n    projectClaudeDir,\n    'project',\n  )\n  const projectMintoSkills = scanStandaloneSkillsDirectory(\n    projectMintoDir,\n    'project',\n  )\n\n  return [\n    ...userClaudeSkills,\n    ...userMintoSkills,\n    ...projectClaudeSkills,\n    ...projectMintoSkills,\n  ]\n}\n\n/**\n * Load all skills from plugins and standalone directories\n * Uses progressive disclosure - only loads metadata (name, description)\n * Content is lazy-loaded when needed\n *\n * Priority: plugin < user < project (later overrides earlier)\n */\nexport function loadAllSkills(): LoadedSkill[] {\n  // Return cached skills if available\n  if (skillsCache !== null) {\n    return Array.from(skillsCache.values())\n  }\n\n  const pluginSkills: LoadedSkill[] = []\n  const plugins = loadAllPlugins()\n\n  // Collect all skills from all plugins\n  for (const plugin of plugins) {\n    if (!plugin.enabled) continue\n\n    for (const skill of plugin.skills) {\n      // Ensure plugin skills have source field\n      pluginSkills.push({\n        ...skill,\n        source: 'plugin',\n      })\n    }\n  }\n\n  // Load standalone skills\n  const standaloneSkills = loadStandaloneSkills()\n\n  // Build cache map for fast lookups (later entries override earlier ones)\n  skillsCache = new Map()\n\n  // Add in priority order: plugin < standalone (user < project)\n  // Plugin skills are namespaced as \"pluginName:skillName\"\n  for (const skill of pluginSkills) {\n    if (skill.pluginName && skill.pluginName !== 'standalone') {\n      const namespacedKey = `${skill.pluginName}:${skill.name}`\n      skillsCache.set(namespacedKey, skill)\n    } else {\n      skillsCache.set(skill.name, skill)\n    }\n  }\n  // Standalone skills keep their original name (no namespace)\n  for (const skill of standaloneSkills) {\n    skillsCache.set(skill.name, skill)\n  }\n\n  return Array.from(skillsCache.values())\n}\n\n/**\n * Get a specific skill by name\n * Supports both namespaced (\"plugin:skill\") and bare (\"skill\") lookups.\n * Bare names match standalone skills first; if not found, searches plugin skills.\n */\nexport function getSkill(name: string): LoadedSkill | undefined {\n  // Ensure cache is populated\n  if (skillsCache === null) {\n    loadAllSkills()\n  }\n\n  // Direct match (namespaced \"plugin:skill\" or standalone \"skill\")\n  const direct = skillsCache?.get(name)\n  if (direct) return direct\n\n  // If no colon in name, try to find among plugin skills by bare component name\n  if (!name.includes(':')) {\n    for (const [key, skill] of skillsCache ?? []) {\n      if (key.includes(':') && key.split(':').pop() === name) {\n        return skill\n      }\n    }\n  }\n\n  return undefined\n}\n\n/**\n * Get the cache key for a skill (namespaced if from a plugin)\n */\nfunction getSkillCacheKey(skill: LoadedSkill): string {\n  if (skill.pluginName && skill.pluginName !== 'standalone') {\n    return `${skill.pluginName}:${skill.name}`\n  }\n  return skill.name\n}\n\n/**\n * Load the full content of a skill\n * Uses caching to avoid repeated file reads\n */\nexport async function loadSkillContent(skill: LoadedSkill): Promise<string> {\n  const cacheKey = getSkillCacheKey(skill)\n\n  // Check content cache first\n  if (contentCache.has(cacheKey)) {\n    return contentCache.get(cacheKey)!\n  }\n\n  // If content was already loaded in the skill object, use it\n  if (skill.config.content) {\n    contentCache.set(cacheKey, skill.config.content)\n    return skill.config.content\n  }\n\n  // Otherwise, read from file\n  try {\n    const fileContent = readFileSync(skill.filePath, 'utf-8')\n    const { content } = matter(fileContent)\n    const trimmedContent = content.trim()\n\n    // Cache the content\n    contentCache.set(cacheKey, trimmedContent)\n\n    // Update the skill object\n    skill.config.content = trimmedContent\n\n    return trimmedContent\n  } catch (error) {\n    throw new Error(\n      `Failed to load skill content for \"${skill.name}\": ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    )\n  }\n}\n\n/**\n * Get all skills with their cache keys (may be namespaced)\n * Returns [key, skill] entries from the cache\n */\nexport function getAllSkillEntries(): [string, LoadedSkill][] {\n  if (skillsCache === null) {\n    loadAllSkills()\n  }\n  return Array.from(skillsCache?.entries() ?? [])\n}\n\n/**\n * Search skills by name or description\n * Returns skills matching the query (case-insensitive)\n */\nexport function searchSkills(query: string): LoadedSkill[] {\n  const allSkills = loadAllSkills()\n  const lowerQuery = query.toLowerCase()\n\n  return allSkills.filter(\n    skill =>\n      skill.name.toLowerCase().includes(lowerQuery) ||\n      skill.config.description.toLowerCase().includes(lowerQuery) ||\n      skill.pluginName.toLowerCase().includes(lowerQuery),\n  )\n}\n\n/**\n * Get skills from a specific plugin\n */\nexport function getSkillsByPlugin(pluginName: string): LoadedSkill[] {\n  const allSkills = loadAllSkills()\n  return allSkills.filter(skill => skill.pluginName === pluginName)\n}\n\n/**\n * Clear the skills cache (useful for hot-reloading)\n */\nexport function clearSkillsCache(): void {\n  skillsCache = null\n  contentCache.clear()\n}\n\n/**\n * Get count of available skills\n */\nexport function getSkillCount(): number {\n  const skills = loadAllSkills()\n  return skills.length\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/utils/streamingState.js

@@ -0,0 +1,52 @@
+function createDefaultState() {
+  return { phase: "thinking" };
+}
+const streamingStates = /* @__PURE__ */ new Map([
+  ["__main__", createDefaultState()]
+]);
+const agentContextStack = ["__main__"];
+function getCurrentAgentContext() {
+  return agentContextStack[agentContextStack.length - 1] ?? "__main__";
+}
+function pushAgentContext(agentId) {
+  agentContextStack.push(agentId);
+  if (!streamingStates.has(agentId)) {
+    streamingStates.set(agentId, createDefaultState());
+  }
+}
+function popAgentContext() {
+  if (agentContextStack.length > 1) {
+    return agentContextStack.pop();
+  }
+  return void 0;
+}
+function setStreamingState(state, agentId) {
+  const targetId = agentId ?? getCurrentAgentContext();
+  const current = streamingStates.get(targetId) ?? createDefaultState();
+  streamingStates.set(targetId, { ...current, ...state });
+}
+function resetStreamingState(agentId) {
+  const targetId = agentId ?? getCurrentAgentContext();
+  streamingStates.set(targetId, createDefaultState());
+}
+function getStreamingState(agentId) {
+  const targetId = agentId ?? getCurrentAgentContext();
+  return streamingStates.get(targetId) ?? createDefaultState();
+}
+function getMainStreamingState() {
+  return streamingStates.get("__main__") ?? createDefaultState();
+}
+function cleanupAgentStreamingState(agentId) {
+  streamingStates.delete(agentId);
+}
+export {
+  cleanupAgentStreamingState,
+  getCurrentAgentContext,
+  getMainStreamingState,
+  getStreamingState,
+  popAgentContext,
+  pushAgentContext,
+  resetStreamingState,
+  setStreamingState
+};
+//# sourceMappingURL=streamingState.js.map

package/dist/utils/streamingState.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/streamingState.ts"],
+  "sourcesContent": ["/**\n * Streaming State Management\n *\n * Extracted from Spinner.tsx to break the layer violation where\n * service-layer code (claude.ts, query.ts) imported from a UI component.\n *\n * Provides per-agent streaming state tracking with hierarchical context support.\n */\n\n// Streaming phases for better UX feedback\nexport type StreamingPhase =\n  | 'thinking' // Initial thinking phase\n  | 'generating' // Generating response content\n  | 'tool_use' // Executing a tool\n  | 'waiting' // Waiting for API response\n  | 'deep_thinking' // Extended thinking mode (Claude thinking blocks)\n  | 'retrying' // API retry in progress\n  | 'permission' // Waiting for user permission\n  | 'compacting' // Compacting conversation context\n  | 'concurrent' // Running concurrent tasks\n\n// Streaming state type definition\nexport interface StreamingStateData {\n  phase: StreamingPhase\n  toolName?: string\n  tokenCount?: number\n  chunkCount?: number\n  // New fields for enhanced feedback\n  retryCount?: number\n  maxRetries?: number\n  errorName?: string\n  concurrentCount?: number\n  thinkingMaxTokens?: number\n  // Token usage from API (real-time streaming)\n  inputTokens?: number\n  outputTokens?: number\n  // Character counts for approximate token estimation\n  sentChars?: number // Characters sent to API (input)\n  receivedChars?: number // Characters received from API (output)\n  // Thinking timing\n  thinkingStartTime?: number\n  thinkingDurationMs?: number\n}\n\n// Default state factory\nfunction createDefaultState(): StreamingStateData {\n  return { phase: 'thinking' }\n}\n\n// Store streaming state per agent (agentId -> state)\n// '__main__' is used for the main/root agent\nconst streamingStates: Map<string, StreamingStateData> = new Map([\n  ['__main__', createDefaultState()],\n])\n\n// Current active agent context (stack to support nesting)\nconst agentContextStack: string[] = ['__main__']\n\n/**\n * Get the current active agent ID\n */\nexport function getCurrentAgentContext(): string {\n  return agentContextStack[agentContextStack.length - 1] ?? '__main__'\n}\n\n/**\n * Push a new agent context (when entering a subagent)\n */\nexport function pushAgentContext(agentId: string): void {\n  agentContextStack.push(agentId)\n  if (!streamingStates.has(agentId)) {\n    streamingStates.set(agentId, createDefaultState())\n  }\n}\n\n/**\n * Pop the current agent context (when exiting a subagent)\n */\nexport function popAgentContext(): string | undefined {\n  if (agentContextStack.length > 1) {\n    return agentContextStack.pop()\n  }\n  return undefined\n}\n\n/**\n * Set streaming state for a specific agent (or current context if not specified)\n */\nexport function setStreamingState(\n  state: Partial<StreamingStateData>,\n  agentId?: string,\n): void {\n  const targetId = agentId ?? getCurrentAgentContext()\n  const current = streamingStates.get(targetId) ?? createDefaultState()\n  streamingStates.set(targetId, { ...current, ...state })\n}\n\n/**\n * Reset streaming state for a specific agent (or current context if not specified)\n */\nexport function resetStreamingState(agentId?: string): void {\n  const targetId = agentId ?? getCurrentAgentContext()\n  streamingStates.set(targetId, createDefaultState())\n}\n\n/**\n * Get streaming state for a specific agent (or current context if not specified)\n */\nexport function getStreamingState(agentId?: string): StreamingStateData {\n  const targetId = agentId ?? getCurrentAgentContext()\n  return streamingStates.get(targetId) ?? createDefaultState()\n}\n\n/**\n * Get streaming state for the main/root agent (used by main Spinner)\n */\nexport function getMainStreamingState(): StreamingStateData {\n  return streamingStates.get('__main__') ?? createDefaultState()\n}\n\n/**\n * Clean up streaming state for a completed agent\n */\nexport function cleanupAgentStreamingState(agentId: string): void {\n  streamingStates.delete(agentId)\n}\n"],
+  "mappings": "AA6CA,SAAS,qBAAyC;AAChD,SAAO,EAAE,OAAO,WAAW;AAC7B;AAIA,MAAM,kBAAmD,oBAAI,IAAI;AAAA,EAC/D,CAAC,YAAY,mBAAmB,CAAC;AACnC,CAAC;AAGD,MAAM,oBAA8B,CAAC,UAAU;AAKxC,SAAS,yBAAiC;AAC/C,SAAO,kBAAkB,kBAAkB,SAAS,CAAC,KAAK;AAC5D;AAKO,SAAS,iBAAiB,SAAuB;AACtD,oBAAkB,KAAK,OAAO;AAC9B,MAAI,CAAC,gBAAgB,IAAI,OAAO,GAAG;AACjC,oBAAgB,IAAI,SAAS,mBAAmB,CAAC;AAAA,EACnD;AACF;AAKO,SAAS,kBAAsC;AACpD,MAAI,kBAAkB,SAAS,GAAG;AAChC,WAAO,kBAAkB,IAAI;AAAA,EAC/B;AACA,SAAO;AACT;AAKO,SAAS,kBACd,OACA,SACM;AACN,QAAM,WAAW,WAAW,uBAAuB;AACnD,QAAM,UAAU,gBAAgB,IAAI,QAAQ,KAAK,mBAAmB;AACpE,kBAAgB,IAAI,UAAU,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC;AACxD;AAKO,SAAS,oBAAoB,SAAwB;AAC1D,QAAM,WAAW,WAAW,uBAAuB;AACnD,kBAAgB,IAAI,UAAU,mBAAmB,CAAC;AACpD;AAKO,SAAS,kBAAkB,SAAsC;AACtE,QAAM,WAAW,WAAW,uBAAuB;AACnD,SAAO,gBAAgB,IAAI,QAAQ,KAAK,mBAAmB;AAC7D;AAKO,SAAS,wBAA4C;AAC1D,SAAO,gBAAgB,IAAI,UAAU,KAAK,mBAAmB;AAC/D;AAKO,SAAS,2BAA2B,SAAuB;AAChE,kBAAgB,OAAO,OAAO;AAChC;",
+  "names": []
+}

package/dist/utils/stringSubstitution.js

@@ -50,10 +50,7 @@ async function substituteVariables(content, args, context = {}) {
       }
     }
   } else {
-    result = result.replace(
-      /!\`([^`]+)\`/g,
-      "(dynamic commands disabled)"
-    );
+    result = result.replace(/!\`([^`]+)\`/g, "(dynamic commands disabled)");
   }
   return result;
 }
@@ -86,7 +83,9 @@ function extractSubstitutionPatterns(content) {
   for (const match of cmdMatches) {
     patterns.commands.push(match[1]);
   }
-  patterns.indexedArgs = [...new Set(patterns.indexedArgs)].sort((a, b) => a - b);
+  patterns.indexedArgs = [...new Set(patterns.indexedArgs)].sort(
+    (a, b) => a - b
+  );
   patterns.variables = [...new Set(patterns.variables)];
   return patterns;
 }

package/dist/utils/stringSubstitution.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/stringSubstitution.ts"],
-  "sourcesContent": ["/**\n * String Substitution Engine\n *\n * Implements Claude Code skill specification for variable substitution.\n * Supports the following patterns:\n *\n * - $ARGUMENTS       - All arguments as a single string\n * - $ARGUMENTS[N]    - Indexed argument (0-based)\n * - $N               - Shorthand for $ARGUMENTS[N]\n * - ${VARIABLE_NAME} - Environment variable or context variable\n * - !`command`       - Dynamic command execution (with security controls)\n */\n\nimport { exec } from 'child_process'\nimport { promisify } from 'util'\n\nconst execAsync = promisify(exec)\n\n/**\n * Context for string substitution\n */\nexport interface SubstitutionContext {\n  sessionId?: string\n  cwd?: string\n  env?: Record<string, string>\n  /**\n   * Allow dynamic command execution (!`command`)\n   * Default: false (security consideration)\n   */\n  allowDynamicCommands?: boolean\n  /**\n   * Timeout for dynamic command execution in milliseconds\n   * Default: 10000 (10 seconds)\n   */\n  commandTimeout?: number\n}\n\n/**\n * Default substitution context\n */\nconst DEFAULT_CONTEXT: Required<SubstitutionContext> = {\n  sessionId: '',\n  cwd: process.cwd(),\n  env: {},\n  allowDynamicCommands: false,\n  commandTimeout: 10000,\n}\n\n/**\n * Substitute variables in a string\n *\n * @param content - The content to substitute variables in\n * @param args - Arguments string (space-separated)\n * @param context - Substitution context\n * @returns The content with variables substituted\n */\nexport async function substituteVariables(\n  content: string,\n  args: string,\n  context: SubstitutionContext = {},\n): Promise<string> {\n  const ctx = { ...DEFAULT_CONTEXT, ...context }\n  let result = content\n  const argValues = args.trim() ? args.trim().split(/\\s+/) : []\n\n  // 1. $ARGUMENTS - All arguments as a single string\n  // Use negative lookahead to avoid matching $ARGUMENTS[N]\n  result = result.replace(/\\$ARGUMENTS(?!\\[)/g, args)\n\n  // 2. $ARGUMENTS[N] - Indexed argument (0-based)\n  result = result.replace(/\\$ARGUMENTS\\[(\\d+)\\]/g, (_, indexStr) => {\n    const index = parseInt(indexStr, 10)\n    return argValues[index] ?? ''\n  })\n\n  // 3. $N - Shorthand for indexed argument (0-based)\n  // Use negative lookahead to avoid matching multi-digit or $ARGUMENTS\n  result = result.replace(/\\$(\\d+)(?!\\d)/g, (_, indexStr) => {\n    const index = parseInt(indexStr, 10)\n    return argValues[index] ?? ''\n  })\n\n  // 4. ${VARIABLE_NAME} - Context and environment variables\n  result = result.replace(/\\$\\{([A-Z_][A-Z0-9_]*)\\}/gi, (_, varName) => {\n    // Built-in context variables (Claude Code spec)\n    switch (varName.toUpperCase()) {\n      case 'CLAUDE_SESSION_ID':\n      case 'SESSION_ID':\n        return ctx.sessionId || ''\n      case 'CWD':\n      case 'PWD':\n        return ctx.cwd\n      default:\n        // Check custom context env first, then process.env\n        return ctx.env[varName] ?? process.env[varName] ?? ''\n    }\n  })\n\n  // 5. !`command` - Dynamic command execution\n  // Only execute if explicitly allowed (security consideration)\n  if (ctx.allowDynamicCommands) {\n    const commandPattern = /!\\`([^`]+)\\`/g\n    const matches = [...result.matchAll(commandPattern)]\n\n    for (const match of matches) {\n      const command = match[1]\n      try {\n        const { stdout } = await execAsync(command, {\n          timeout: ctx.commandTimeout,\n          cwd: ctx.cwd,\n        })\n        result = result.replace(match[0], stdout.trim())\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error ? error.message : String(error)\n        result = result.replace(match[0], `(error: ${errorMessage})`)\n      }\n    }\n  } else {\n    // Replace !`command` with placeholder when not allowed\n    result = result.replace(\n      /!\\`([^`]+)\\`/g,\n      '(dynamic commands disabled)',\n    )\n  }\n\n  return result\n}\n\n/**\n * Check if a string contains substitution patterns\n * Useful for optimization - skip substitution if no patterns present\n */\nexport function hasSubstitutionPatterns(content: string): boolean {\n  return /\\$(?:ARGUMENTS|\\d+|\\{[A-Z_][A-Z0-9_]*\\})|!\\`/.test(content)\n}\n\n/**\n * Extract all substitution patterns from a string\n * Useful for validation and documentation\n */\nexport function extractSubstitutionPatterns(\n  content: string,\n): {\n  arguments: string[]\n  indexedArgs: number[]\n  variables: string[]\n  commands: string[]\n} {\n  const patterns = {\n    arguments: [] as string[],\n    indexedArgs: [] as number[],\n    variables: [] as string[],\n    commands: [] as string[],\n  }\n\n  // $ARGUMENTS\n  if (/\\$ARGUMENTS(?!\\[)/.test(content)) {\n    patterns.arguments.push('$ARGUMENTS')\n  }\n\n  // $ARGUMENTS[N]\n  const argIndexMatches = content.matchAll(/\\$ARGUMENTS\\[(\\d+)\\]/g)\n  for (const match of argIndexMatches) {\n    patterns.indexedArgs.push(parseInt(match[1], 10))\n  }\n\n  // $N\n  const shortIndexMatches = content.matchAll(/\\$(\\d+)(?!\\d)/g)\n  for (const match of shortIndexMatches) {\n    patterns.indexedArgs.push(parseInt(match[1], 10))\n  }\n\n  // ${VARIABLE}\n  const varMatches = content.matchAll(/\\$\\{([A-Z_][A-Z0-9_]*)\\}/gi)\n  for (const match of varMatches) {\n    patterns.variables.push(match[1])\n  }\n\n  // !`command`\n  const cmdMatches = content.matchAll(/!\\`([^`]+)\\`/g)\n  for (const match of cmdMatches) {\n    patterns.commands.push(match[1])\n  }\n\n  // Deduplicate indexed args\n  patterns.indexedArgs = [...new Set(patterns.indexedArgs)].sort((a, b) => a - b)\n  patterns.variables = [...new Set(patterns.variables)]\n\n  return patterns\n}\n\n/**\n * Validate arguments against expected patterns\n * Returns error message if validation fails, null if valid\n */\nexport function validateArguments(\n  args: string,\n  patterns: ReturnType<typeof extractSubstitutionPatterns>,\n): string | null {\n  const argValues = args.trim() ? args.trim().split(/\\s+/) : []\n  const maxIndex = Math.max(...patterns.indexedArgs, -1)\n\n  if (maxIndex >= 0 && argValues.length <= maxIndex) {\n    return `Expected at least ${maxIndex + 1} argument(s), got ${argValues.length}`\n  }\n\n  return null\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * String Substitution Engine\n *\n * Implements Claude Code skill specification for variable substitution.\n * Supports the following patterns:\n *\n * - $ARGUMENTS       - All arguments as a single string\n * - $ARGUMENTS[N]    - Indexed argument (0-based)\n * - $N               - Shorthand for $ARGUMENTS[N]\n * - ${VARIABLE_NAME} - Environment variable or context variable\n * - !`command`       - Dynamic command execution (with security controls)\n */\n\nimport { exec } from 'child_process'\nimport { promisify } from 'util'\n\nconst execAsync = promisify(exec)\n\n/**\n * Context for string substitution\n */\nexport interface SubstitutionContext {\n  sessionId?: string\n  cwd?: string\n  env?: Record<string, string>\n  /**\n   * Allow dynamic command execution (!`command`)\n   * Default: false (security consideration)\n   */\n  allowDynamicCommands?: boolean\n  /**\n   * Timeout for dynamic command execution in milliseconds\n   * Default: 10000 (10 seconds)\n   */\n  commandTimeout?: number\n}\n\n/**\n * Default substitution context\n */\nconst DEFAULT_CONTEXT: Required<SubstitutionContext> = {\n  sessionId: '',\n  cwd: process.cwd(),\n  env: {},\n  allowDynamicCommands: false,\n  commandTimeout: 10000,\n}\n\n/**\n * Substitute variables in a string\n *\n * @param content - The content to substitute variables in\n * @param args - Arguments string (space-separated)\n * @param context - Substitution context\n * @returns The content with variables substituted\n */\nexport async function substituteVariables(\n  content: string,\n  args: string,\n  context: SubstitutionContext = {},\n): Promise<string> {\n  const ctx = { ...DEFAULT_CONTEXT, ...context }\n  let result = content\n  const argValues = args.trim() ? args.trim().split(/\\s+/) : []\n\n  // 1. $ARGUMENTS - All arguments as a single string\n  // Use negative lookahead to avoid matching $ARGUMENTS[N]\n  result = result.replace(/\\$ARGUMENTS(?!\\[)/g, args)\n\n  // 2. $ARGUMENTS[N] - Indexed argument (0-based)\n  result = result.replace(/\\$ARGUMENTS\\[(\\d+)\\]/g, (_, indexStr) => {\n    const index = parseInt(indexStr, 10)\n    return argValues[index] ?? ''\n  })\n\n  // 3. $N - Shorthand for indexed argument (0-based)\n  // Use negative lookahead to avoid matching multi-digit or $ARGUMENTS\n  result = result.replace(/\\$(\\d+)(?!\\d)/g, (_, indexStr) => {\n    const index = parseInt(indexStr, 10)\n    return argValues[index] ?? ''\n  })\n\n  // 4. ${VARIABLE_NAME} - Context and environment variables\n  result = result.replace(/\\$\\{([A-Z_][A-Z0-9_]*)\\}/gi, (_, varName) => {\n    // Built-in context variables (Claude Code spec)\n    switch (varName.toUpperCase()) {\n      case 'CLAUDE_SESSION_ID':\n      case 'SESSION_ID':\n        return ctx.sessionId || ''\n      case 'CWD':\n      case 'PWD':\n        return ctx.cwd\n      default:\n        // Check custom context env first, then process.env\n        return ctx.env[varName] ?? process.env[varName] ?? ''\n    }\n  })\n\n  // 5. !`command` - Dynamic command execution\n  // Only execute if explicitly allowed (security consideration)\n  if (ctx.allowDynamicCommands) {\n    const commandPattern = /!\\`([^`]+)\\`/g\n    const matches = [...result.matchAll(commandPattern)]\n\n    for (const match of matches) {\n      const command = match[1]\n      try {\n        const { stdout } = await execAsync(command, {\n          timeout: ctx.commandTimeout,\n          cwd: ctx.cwd,\n        })\n        result = result.replace(match[0], stdout.trim())\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error ? error.message : String(error)\n        result = result.replace(match[0], `(error: ${errorMessage})`)\n      }\n    }\n  } else {\n    // Replace !`command` with placeholder when not allowed\n    result = result.replace(/!\\`([^`]+)\\`/g, '(dynamic commands disabled)')\n  }\n\n  return result\n}\n\n/**\n * Check if a string contains substitution patterns\n * Useful for optimization - skip substitution if no patterns present\n */\nexport function hasSubstitutionPatterns(content: string): boolean {\n  return /\\$(?:ARGUMENTS|\\d+|\\{[A-Z_][A-Z0-9_]*\\})|!\\`/.test(content)\n}\n\n/**\n * Extract all substitution patterns from a string\n * Useful for validation and documentation\n */\nexport function extractSubstitutionPatterns(content: string): {\n  arguments: string[]\n  indexedArgs: number[]\n  variables: string[]\n  commands: string[]\n} {\n  const patterns = {\n    arguments: [] as string[],\n    indexedArgs: [] as number[],\n    variables: [] as string[],\n    commands: [] as string[],\n  }\n\n  // $ARGUMENTS\n  if (/\\$ARGUMENTS(?!\\[)/.test(content)) {\n    patterns.arguments.push('$ARGUMENTS')\n  }\n\n  // $ARGUMENTS[N]\n  const argIndexMatches = content.matchAll(/\\$ARGUMENTS\\[(\\d+)\\]/g)\n  for (const match of argIndexMatches) {\n    patterns.indexedArgs.push(parseInt(match[1], 10))\n  }\n\n  // $N\n  const shortIndexMatches = content.matchAll(/\\$(\\d+)(?!\\d)/g)\n  for (const match of shortIndexMatches) {\n    patterns.indexedArgs.push(parseInt(match[1], 10))\n  }\n\n  // ${VARIABLE}\n  const varMatches = content.matchAll(/\\$\\{([A-Z_][A-Z0-9_]*)\\}/gi)\n  for (const match of varMatches) {\n    patterns.variables.push(match[1])\n  }\n\n  // !`command`\n  const cmdMatches = content.matchAll(/!\\`([^`]+)\\`/g)\n  for (const match of cmdMatches) {\n    patterns.commands.push(match[1])\n  }\n\n  // Deduplicate indexed args\n  patterns.indexedArgs = [...new Set(patterns.indexedArgs)].sort(\n    (a, b) => a - b,\n  )\n  patterns.variables = [...new Set(patterns.variables)]\n\n  return patterns\n}\n\n/**\n * Validate arguments against expected patterns\n * Returns error message if validation fails, null if valid\n */\nexport function validateArguments(\n  args: string,\n  patterns: ReturnType<typeof extractSubstitutionPatterns>,\n): string | null {\n  const argValues = args.trim() ? args.trim().split(/\\s+/) : []\n  const maxIndex = Math.max(...patterns.indexedArgs, -1)\n\n  if (maxIndex >= 0 && argValues.length <= maxIndex) {\n    return `Expected at least ${maxIndex + 1} argument(s), got ${argValues.length}`\n  }\n\n  return null\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/utils/style.js

@@ -9,11 +9,14 @@ const getCodeStyle = memoize(() => {
   let currentDir = getCwd();
   while (currentDir !== parse(currentDir).root) {
     const stylePath = join(currentDir, PROJECT_FILE);
-    if (existsSync(stylePath)) {
+    const agentsStylePath = join(currentDir, "AGENTS.md");
+    const claudeStylePath = join(currentDir, "CLAUDE.md");
+    const foundPath = existsSync(stylePath) ? stylePath : existsSync(agentsStylePath) ? agentsStylePath : existsSync(claudeStylePath) ? claudeStylePath : null;
+    if (foundPath) {
       styles.push(
-        `Contents of ${stylePath}:
+        `Contents of ${foundPath}:
 
-${readFileSync(stylePath, "utf-8")}`
+${readFileSync(foundPath, "utf-8")}`
       );
     }
     currentDir = dirname(currentDir);

package/dist/utils/style.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/style.ts"],
-  "sourcesContent": ["import { existsSync, readFileSync } from 'fs'\nimport { join, parse, dirname } from 'path'\nimport { memoize } from 'lodash-es'\nimport { getCwd } from './state'\nimport { PROJECT_FILE } from '@constants/product'\n\nconst STYLE_PROMPT =\n  'The codebase follows strict style guidelines shown below. All code changes must strictly adhere to these guidelines to maintain consistency and quality.'\n\nexport const getCodeStyle = memoize((): string => {\n  const styles: string[] = []\n  let currentDir = getCwd()\n\n  while (currentDir !== parse(currentDir).root) {\n    const stylePath = join(currentDir, PROJECT_FILE)\n    if (existsSync(stylePath)) {\n      styles.push(\n        `Contents of ${stylePath}:\\n\\n${readFileSync(stylePath, 'utf-8')}`,\n      )\n    }\n    currentDir = dirname(currentDir)\n  }\n\n  if (styles.length === 0) {\n    return ''\n  }\n\n  return `${STYLE_PROMPT}\\n\\n${styles.reverse().join('\\n\\n')}`\n})\n"],
-  "mappings": "AAAA,SAAS,YAAY,oBAAoB;AACzC,SAAS,MAAM,OAAO,eAAe;AACrC,SAAS,eAAe;AACxB,SAAS,cAAc;AACvB,SAAS,oBAAoB;AAE7B,MAAM,eACJ;AAEK,MAAM,eAAe,QAAQ,MAAc;AAChD,QAAM,SAAmB,CAAC;AAC1B,MAAI,aAAa,OAAO;AAExB,SAAO,eAAe,MAAM,UAAU,EAAE,MAAM;AAC5C,UAAM,YAAY,KAAK,YAAY,YAAY;AAC/C,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO;AAAA,QACL,eAAe,SAAS;AAAA;AAAA,EAAQ,aAAa,WAAW,OAAO,CAAC;AAAA,MAClE;AAAA,IACF;AACA,iBAAa,QAAQ,UAAU;AAAA,EACjC;AAEA,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,YAAY;AAAA;AAAA,EAAO,OAAO,QAAQ,EAAE,KAAK,MAAM,CAAC;AAC5D,CAAC;",
+  "sourcesContent": ["import { existsSync, readFileSync } from 'fs'\nimport { join, parse, dirname } from 'path'\nimport { memoize } from 'lodash-es'\nimport { getCwd } from './state'\nimport { PROJECT_FILE } from '@constants/product'\n\nconst STYLE_PROMPT =\n  'The codebase follows strict style guidelines shown below. All code changes must strictly adhere to these guidelines to maintain consistency and quality.'\n\nexport const getCodeStyle = memoize((): string => {\n  const styles: string[] = []\n  let currentDir = getCwd()\n\n  while (currentDir !== parse(currentDir).root) {\n    const stylePath = join(currentDir, PROJECT_FILE)\n    const agentsStylePath = join(currentDir, 'AGENTS.md')\n    const claudeStylePath = join(currentDir, 'CLAUDE.md')\n    const foundPath = existsSync(stylePath)\n      ? stylePath\n      : existsSync(agentsStylePath)\n        ? agentsStylePath\n        : existsSync(claudeStylePath)\n          ? claudeStylePath\n          : null\n    if (foundPath) {\n      styles.push(\n        `Contents of ${foundPath}:\\n\\n${readFileSync(foundPath, 'utf-8')}`,\n      )\n    }\n    currentDir = dirname(currentDir)\n  }\n\n  if (styles.length === 0) {\n    return ''\n  }\n\n  return `${STYLE_PROMPT}\\n\\n${styles.reverse().join('\\n\\n')}`\n})\n"],
+  "mappings": "AAAA,SAAS,YAAY,oBAAoB;AACzC,SAAS,MAAM,OAAO,eAAe;AACrC,SAAS,eAAe;AACxB,SAAS,cAAc;AACvB,SAAS,oBAAoB;AAE7B,MAAM,eACJ;AAEK,MAAM,eAAe,QAAQ,MAAc;AAChD,QAAM,SAAmB,CAAC;AAC1B,MAAI,aAAa,OAAO;AAExB,SAAO,eAAe,MAAM,UAAU,EAAE,MAAM;AAC5C,UAAM,YAAY,KAAK,YAAY,YAAY;AAC/C,UAAM,kBAAkB,KAAK,YAAY,WAAW;AACpD,UAAM,kBAAkB,KAAK,YAAY,WAAW;AACpD,UAAM,YAAY,WAAW,SAAS,IAClC,YACA,WAAW,eAAe,IACxB,kBACA,WAAW,eAAe,IACxB,kBACA;AACR,QAAI,WAAW;AACb,aAAO;AAAA,QACL,eAAe,SAAS;AAAA;AAAA,EAAQ,aAAa,WAAW,OAAO,CAAC;AAAA,MAClE;AAAA,IACF;AACA,iBAAa,QAAQ,UAAU;AAAA,EACjC;AAEA,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,YAAY;AAAA;AAAA,EAAO,OAAO,QAAQ,EAAE,KAAK,MAAM,CAAC;AAC5D,CAAC;",
   "names": []
 }

package/dist/utils/teamConfig.js

@@ -5,6 +5,7 @@ import {
 } from "./config.js";
 import { debug as debugLogger } from "./debugLogger.js";
 import { safeParseJSON } from "./json.js";
+import { ensureProxyBypass, hasSystemProxy } from "./envConfig.js";
 function interpolateEnvVars(value) {
   return value.replace(/\$\{([^}]+)\}/g, (match, varName) => {
     const envValue = process.env[varName.trim()];
@@ -58,18 +59,21 @@ function convertTeamMcpConfig(teamConfig) {
       enabled: teamConfig.enabled ?? true
     };
   }
+  const env = teamConfig.env ? ensureProxyBypass(interpolateEnvVarsInObject(teamConfig.env)) : hasSystemProxy() ? { no_proxy: "*", NO_PROXY: "*" } : void 0;
   return {
     type: "stdio",
     command: interpolateEnvVars(teamConfig.command || ""),
     args: (teamConfig.args || []).map((arg) => interpolateEnvVars(arg)),
-    env: teamConfig.env ? interpolateEnvVarsInObject(teamConfig.env) : void 0,
+    env,
     enabled: teamConfig.enabled ?? true
   };
 }
 async function fetchTeamConfig(url) {
   debugLogger.state("TEAM_CONFIG_FETCH_START", { url });
   try {
-    const response = await fetch(url);
+    const response = await fetch(url, {
+      signal: AbortSignal.timeout(3e4)
+    });
     if (!response.ok) {
       throw new Error(
         `Failed to fetch config: ${response.status} ${response.statusText}`
@@ -288,16 +292,19 @@ async function installPlugins(pluginNames, targetDir) {
   const { join } = await import("path");
   const { homedir } = await import("os");
   const installDir = targetDir || join(homedir(), ".minto", "plugins");
-  for (const pluginName of pluginNames) {
+  for (const pluginSpec of pluginNames) {
+    const atIndex = pluginSpec.indexOf("@");
+    const pluginName = atIndex !== -1 ? pluginSpec.slice(0, atIndex) : pluginSpec;
+    const marketplaceName = atIndex !== -1 ? pluginSpec.slice(atIndex + 1) : void 0;
     try {
       debugLogger.state("TEAM_CONFIG_INSTALL_PLUGIN", {
         pluginName,
+        marketplace: marketplaceName,
         targetDir: installDir
       });
       await installPluginFromMarketplace(
         pluginName,
-        void 0,
-        // Search all marketplaces
+        marketplaceName,
         join(installDir, pluginName)
       );
       installed++;
@@ -314,21 +321,23 @@ async function installPlugins(pluginNames, targetDir) {
   }
   return { installed, failed, errors };
 }
-async function installRemoteAgents(agentUrls) {
+async function installRemoteAgents(agentUrls, targetDir) {
   let installed = 0;
   let failed = 0;
   const errors = [];
   const { join } = await import("path");
   const { homedir } = await import("os");
   const { writeFileSync, mkdirSync, existsSync: existsSync2 } = await import("fs");
-  const agentsDir = join(homedir(), ".minto", "agents");
+  const agentsDir = targetDir || join(homedir(), ".minto", "agents");
   if (!existsSync2(agentsDir)) {
     mkdirSync(agentsDir, { recursive: true });
   }
   for (const url of agentUrls) {
     try {
       debugLogger.state("TEAM_CONFIG_DOWNLOAD_AGENT", { url });
-      const response = await fetch(url);
+      const response = await fetch(url, {
+        signal: AbortSignal.timeout(3e4)
+      });
       if (!response.ok) {
         throw new Error(`HTTP ${response.status}: ${response.statusText}`);
       }
@@ -353,14 +362,14 @@ async function installRemoteAgents(agentUrls) {
   }
   return { installed, failed, errors };
 }
-async function installInlineAgents(agents) {
+async function installInlineAgents(agents, targetDir) {
   let installed = 0;
   let failed = 0;
   const errors = [];
   const { join } = await import("path");
   const { homedir } = await import("os");
   const { writeFileSync, mkdirSync, existsSync: existsSync2 } = await import("fs");
-  const agentsDir = join(homedir(), ".minto", "agents");
+  const agentsDir = targetDir || join(homedir(), ".minto", "agents");
   if (!existsSync2(agentsDir)) {
     mkdirSync(agentsDir, { recursive: true });
   }
@@ -400,17 +409,17 @@ ${agent.systemPrompt}
   }
   return { installed, failed, errors };
 }
-async function installTeamHooks(hooks) {
-  const { join } = await import("path");
+async function installTeamHooks(hooks, targetPath) {
+  const { join, dirname } = await import("path");
   const { homedir } = await import("os");
   const { writeFileSync, mkdirSync, existsSync: existsSync2, readFileSync: readFileSync2 } = await import("fs");
   try {
     debugLogger.state("TEAM_CONFIG_INSTALL_HOOKS", {});
-    const mintoDir = join(homedir(), ".minto");
-    if (!existsSync2(mintoDir)) {
-      mkdirSync(mintoDir, { recursive: true });
+    const hooksPath = targetPath || join(homedir(), ".minto", "hooks.json");
+    const hooksDir = dirname(hooksPath);
+    if (!existsSync2(hooksDir)) {
+      mkdirSync(hooksDir, { recursive: true });
     }
-    const hooksPath = join(mintoDir, "hooks.json");
     const hooksConfig = {
       description: "Team-configured hooks",
       hooks: {}
@@ -461,6 +470,141 @@ async function installTeamHooks(hooks) {
     return { installed: false, error: errorMsg };
   }
 }
+async function installInlineSkills(skills, targetDir) {
+  let installed = 0;
+  let failed = 0;
+  const errors = [];
+  const { join } = await import("path");
+  const { homedir } = await import("os");
+  const { writeFileSync, mkdirSync, existsSync: existsSync2 } = await import("fs");
+  const skillsDir = targetDir || join(homedir(), ".minto", "skills");
+  if (!existsSync2(skillsDir)) {
+    mkdirSync(skillsDir, { recursive: true });
+  }
+  for (const skill of skills) {
+    try {
+      debugLogger.state("TEAM_CONFIG_INSTALL_SKILL", { name: skill.name });
+      const frontmatterLines = [
+        `name: ${skill.name}`,
+        `description: "${skill.description.replace(/"/g, '\\"')}"`
+      ];
+      if (skill.argumentHint) {
+        frontmatterLines.push(`argument-hint: "${skill.argumentHint}"`);
+      }
+      if (skill.disableModelInvocation !== void 0) {
+        frontmatterLines.push(
+          `disable-model-invocation: ${skill.disableModelInvocation}`
+        );
+      }
+      if (skill.userInvocable !== void 0) {
+        frontmatterLines.push(`user-invocable: ${skill.userInvocable}`);
+      }
+      if (skill.allowedTools && skill.allowedTools.length > 0) {
+        frontmatterLines.push(
+          `allowed-tools: ${JSON.stringify(skill.allowedTools)}`
+        );
+      }
+      if (skill.model) {
+        frontmatterLines.push(`model: ${skill.model}`);
+      }
+      if (skill.context) {
+        frontmatterLines.push(`context: "${skill.context}"`);
+      }
+      if (skill.agent) {
+        frontmatterLines.push(`agent: "${skill.agent}"`);
+      }
+      const content = `---
+${frontmatterLines.join("\n")}
+---
+
+${skill.content}
+`;
+      const filename = `${skill.name}.md`;
+      const targetPath = join(skillsDir, filename);
+      writeFileSync(targetPath, content, "utf-8");
+      installed++;
+      debugLogger.state("TEAM_CONFIG_INSTALL_SKILL_SUCCESS", {
+        name: skill.name,
+        targetPath
+      });
+    } catch (error) {
+      failed++;
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      errors.push(`${skill.name}: ${errorMsg}`);
+      debugLogger.error("TEAM_CONFIG_INSTALL_SKILL_ERROR", {
+        name: skill.name,
+        error: errorMsg
+      });
+    }
+  }
+  return { installed, failed, errors };
+}
+async function installInlineCommands(commands, targetDir) {
+  let installed = 0;
+  let failed = 0;
+  const errors = [];
+  const { join } = await import("path");
+  const { homedir } = await import("os");
+  const { writeFileSync, mkdirSync, existsSync: existsSync2 } = await import("fs");
+  const commandsDir = targetDir || join(homedir(), ".minto", "commands");
+  if (!existsSync2(commandsDir)) {
+    mkdirSync(commandsDir, { recursive: true });
+  }
+  for (const cmd of commands) {
+    try {
+      debugLogger.state("TEAM_CONFIG_INSTALL_COMMAND", { name: cmd.name });
+      const frontmatterLines = [`name: ${cmd.name}`];
+      if (cmd.description) {
+        frontmatterLines.push(
+          `description: "${cmd.description.replace(/"/g, '\\"')}"`
+        );
+      }
+      if (cmd.aliases && cmd.aliases.length > 0) {
+        frontmatterLines.push(`aliases: ${JSON.stringify(cmd.aliases)}`);
+      }
+      if (cmd.enabled !== void 0) {
+        frontmatterLines.push(`enabled: ${cmd.enabled}`);
+      }
+      if (cmd.hidden !== void 0) {
+        frontmatterLines.push(`hidden: ${cmd.hidden}`);
+      }
+      if (cmd.progressMessage) {
+        frontmatterLines.push(`progressMessage: "${cmd.progressMessage}"`);
+      }
+      if (cmd.argNames && cmd.argNames.length > 0) {
+        frontmatterLines.push(`argNames: ${JSON.stringify(cmd.argNames)}`);
+      }
+      if (cmd.allowedTools && cmd.allowedTools.length > 0) {
+        frontmatterLines.push(
+          `allowed-tools: ${JSON.stringify(cmd.allowedTools)}`
+        );
+      }
+      const content = `---
+${frontmatterLines.join("\n")}
+---
+
+${cmd.content}
+`;
+      const filename = `${cmd.name}.md`;
+      const targetPath = join(commandsDir, filename);
+      writeFileSync(targetPath, content, "utf-8");
+      installed++;
+      debugLogger.state("TEAM_CONFIG_INSTALL_COMMAND_SUCCESS", {
+        name: cmd.name,
+        targetPath
+      });
+    } catch (error) {
+      failed++;
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      errors.push(`${cmd.name}: ${errorMsg}`);
+      debugLogger.error("TEAM_CONFIG_INSTALL_COMMAND_ERROR", {
+        name: cmd.name,
+        error: errorMsg
+      });
+    }
+  }
+  return { installed, failed, errors };
+}
 export {
   addMarketplaces,
   applyTeamConfig,
@@ -468,6 +612,8 @@ export {
   convertTeamModelProfile,
   fetchTeamConfig,
   installInlineAgents,
+  installInlineCommands,
+  installInlineSkills,
   installPlugins,
   installRemoteAgents,
   installTeamHooks,