@inkeep/agents-cli 0.59.3 → 0.59.4

package/dist/commands/pull-v4/component-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-parser.js","names":["args"],"sources":["../../../src/commands/pull-v4/component-parser.ts"],"sourcesContent":["/**\n * Component Parser - Find all component definitions (exported and inline)\n * Uses AST parsing to handle complex components including those with render attributes\n * Maps components by looking for patterns like:\n * - export const myTool = tool({id: 'tool-id', ...})\n * - dataComponent({id: 'data-id', ...}) (inline)\n */\n\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { extname, join, relative } from 'node:path';\nimport { type CallExpression, Node, type ObjectLiteralExpression } from 'ts-morph';\nimport { ComponentRegistry, type ComponentType } from './component-registry';\nimport { createInMemoryProject } from './utils';\n\ninterface ComponentMatch {\n  id: string;\n  type: ComponentType;\n  filePath: string;\n  variableName?: string; // If exported\n  startLine: number;\n  isInline: boolean; // true if not exported, false if exported\n  overrideExisting?: boolean; // true if this should override an existing component\n}\n\n/**\n * Valid plural component types for parsing\n */\nconst VALID_COMPONENT_TYPES = new Set<ComponentType>([\n  'project',\n  'agents',\n  'subAgents',\n  'tools',\n  'functionTools',\n  'dataComponents',\n  'artifactComponents',\n  'statusComponents',\n  'externalAgents',\n  'credentials',\n  'contextConfigs',\n  'fetchDefinitions',\n  'headers',\n]);\n\n/**\n * Mapping from SDK function names to ComponentTypes\n */\nconst FUNCTION_NAME_TO_TYPE: Record<string, ComponentType> = {\n  project: 'project',\n  agent: 'agents',\n  subAgent: 'subAgents',\n  tool: 'tools',\n  functionTool: 'functionTools',\n  dataComponent: 'dataComponents',\n  artifactComponent: 'artifactComponents',\n  statusComponent: 'statusComponents',\n  externalAgent: 'externalAgents',\n  credential: 'credentials',\n  contextConfig: 'contextConfigs',\n  fetchDefinition: 'fetchDefinitions',\n  header: 'headers',\n  mcpTool: 'tools',\n};\n\n/**\n * Parse a single file for all component definitions using AST parsing\n * Handles all patterns: exported, declared+exported, declared-only, and inline\n */\nfunction parseFileForComponents(\n  filePath: string,\n  projectRoot: string,\n  debug = false\n): ComponentMatch[] {\n  if (!existsSync(filePath)) {\n    return [];\n  }\n\n  const components: ComponentMatch[] = [];\n  const relativePath = relative(projectRoot, filePath);\n\n  try {\n    const content = readFileSync(filePath, 'utf8');\n\n    // Create a temporary ts-morph project for parsing\n    const project = createInMemoryProject();\n\n    // Add the file to the project\n    const sourceFile = project.createSourceFile('temp.ts', content);\n\n    // Pattern 1: Direct exports (export const name = func({...}))\n    const exportedVariableDeclarations = sourceFile\n      .getVariableStatements()\n      .filter((statement) => statement.hasExportKeyword())\n      .flatMap((statement) => statement.getDeclarationList().getDeclarations());\n\n    for (const declaration of exportedVariableDeclarations) {\n      const variableName = declaration.getName();\n      const initializer = declaration.getInitializer();\n\n      if (Node.isCallExpression(initializer)) {\n        const componentMatch = parseCallExpression(initializer, variableName, false, relativePath);\n        if (componentMatch) {\n          components.push(componentMatch);\n        }\n      }\n    }\n\n    // Pattern 2: Separate declaration + export (const name = func({...}) + export { name })\n    // First, collect all exported names from export declarations\n    const exportedNames = new Set<string>();\n    sourceFile.getExportDeclarations().forEach((exportDecl) => {\n      const namedExports = exportDecl.getNamedExports();\n      namedExports.forEach((namedExport) => {\n        exportedNames.add(namedExport.getName());\n      });\n    });\n\n    // Find variable declarations that are exported via separate export statements\n    const allVariableDeclarations = sourceFile\n      .getVariableStatements()\n      .filter((statement) => !statement.hasExportKeyword()) // Not direct exports\n      .flatMap((statement) => statement.getDeclarationList().getDeclarations());\n\n    for (const declaration of allVariableDeclarations) {\n      const variableName = declaration.getName();\n      const initializer = declaration.getInitializer();\n\n      if (Node.isCallExpression(initializer)) {\n        const isExported = exportedNames.has(variableName);\n        const isInline = !isExported;\n\n        const componentMatch = parseCallExpression(\n          initializer,\n          variableName,\n          isInline,\n          relativePath\n        );\n        if (componentMatch) {\n          components.push(componentMatch);\n        }\n      }\n    }\n\n    // Pattern 3: Truly inline components (function calls without variable assignment)\n    // Walk the AST to find all call expressions that aren't part of variable declarations\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        // Check if this call expression is NOT the initializer of a variable declaration\n        const parent = node.getParent();\n        const isVariableInitializer =\n          Node.isVariableDeclaration(parent) && parent.getInitializer() === node;\n\n        if (!isVariableInitializer) {\n          const componentMatch = parseCallExpression(node, undefined, true, relativePath);\n          if (componentMatch) {\n            components.push(componentMatch);\n          }\n        }\n      }\n    });\n\n    // Pattern 4: Environment-based credentials within registerEnvironmentSettings\n    // export const development = registerEnvironmentSettings({\n    //   credentials: {\n    //     stripe_api_key: {\n    //       id: 'stripe-api-key',\n    //       name: 'Stripe API Key',\n    //       ...\n    //     }\n    //   }\n    // });\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        const expression = node.getExpression();\n\n        // Check if this is a registerEnvironmentSettings call\n        if (\n          Node.isIdentifier(expression) &&\n          expression.getText() === 'registerEnvironmentSettings'\n        ) {\n          const args = node.getArguments();\n          if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {\n            const configObject = args[0];\n\n            // Look for credentials property\n            const credentialsProperty = configObject.getProperty('credentials');\n            if (credentialsProperty && Node.isPropertyAssignment(credentialsProperty)) {\n              const credentialsValue = credentialsProperty.getInitializer();\n\n              if (Node.isObjectLiteralExpression(credentialsValue)) {\n                // Parse each credential in the credentials object\n                credentialsValue.getProperties().forEach((property) => {\n                  if (Node.isPropertyAssignment(property)) {\n                    const credentialKey = property.getName(); // e.g., \"stripe_api_key\"\n                    const credentialConfig = property.getInitializer();\n\n                    if (Node.isObjectLiteralExpression(credentialConfig)) {\n                      // Inline credential definition - Look for the 'id' property in the credential config\n                      const idProperty = credentialConfig.getProperty('id');\n                      if (idProperty && Node.isPropertyAssignment(idProperty)) {\n                        const idValue = idProperty.getInitializer();\n                        if (Node.isStringLiteral(idValue)) {\n                          const credentialId = idValue.getLiteralValue(); // e.g., \"stripe-api-key\"\n                          const startLine = node.getStartLineNumber();\n\n                          components.push({\n                            id: credentialId,\n                            type: 'credentials',\n                            filePath: relativePath,\n                            variableName: credentialKey, // Use the key name as variable name\n                            startLine,\n                            isInline: true, // It's nested within environment settings\n                          });\n                        }\n                      }\n                    } else if (Node.isIdentifier(credentialConfig)) {\n                      // Variable reference - need to find the credential ID from the variable\n                      // This handles cases like: stripe_api_key: stripeApiKey\n                      const variableName = credentialConfig.getText();\n\n                      // Look for the credential variable definition in this file\n                      sourceFile.forEachDescendant((varNode) => {\n                        if (\n                          Node.isVariableDeclaration(varNode) &&\n                          varNode.getName() === variableName\n                        ) {\n                          const initializer = varNode.getInitializer();\n                          if (Node.isCallExpression(initializer)) {\n                            const callExpression = initializer.getExpression();\n                            if (\n                              Node.isIdentifier(callExpression) &&\n                              callExpression.getText() === 'credential'\n                            ) {\n                              const args = initializer.getArguments();\n                              if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {\n                                const configObject = args[0];\n                                const idProperty = configObject.getProperty('id');\n                                if (idProperty && Node.isPropertyAssignment(idProperty)) {\n                                  const idValue = idProperty.getInitializer();\n                                  if (Node.isStringLiteral(idValue)) {\n                                    const credentialId = idValue.getLiteralValue();\n                                    const startLine = node.getStartLineNumber();\n\n                                    components.push({\n                                      id: credentialId,\n                                      type: 'credentials',\n                                      filePath: relativePath,\n                                      variableName: credentialKey, // Use the env settings key as variable name\n                                      startLine,\n                                      isInline: true,\n                                      overrideExisting: true, // Mark this to override any existing registration\n                                    });\n                                  }\n                                }\n                              }\n                            }\n                          }\n                        }\n                      });\n                    }\n                  }\n                });\n              }\n            }\n          }\n        }\n      }\n    });\n\n    return components;\n  } catch (error) {\n    if (debug) {\n      console.warn(`Failed to parse file ${relativePath}: ${error}`);\n    }\n    return [];\n  }\n}\n\n/**\n * Parse a call expression to extract component information\n * Handles the same logic as the original regex patterns\n */\nfunction parseCallExpression(\n  callExpression: CallExpression,\n  variableName: string | undefined,\n  isInline: boolean,\n  relativePath: string\n): ComponentMatch | null {\n  const expression = callExpression.getExpression();\n\n  // Get the function name (e.g., 'dataComponent', 'tool', etc.)\n  let functionName: string;\n  if (Node.isIdentifier(expression)) {\n    functionName = expression.getText();\n  } else {\n    return null;\n  }\n\n  // Map function name to component type\n  const componentType = FUNCTION_NAME_TO_TYPE[functionName];\n  if (!componentType || !VALID_COMPONENT_TYPES.has(componentType)) {\n    return null;\n  }\n\n  // Get the first argument (should be an object literal)\n  const args = callExpression.getArguments();\n  if (args.length === 0 || !Node.isObjectLiteralExpression(args[0])) {\n    return null;\n  }\n\n  const configObject = args[0] as ObjectLiteralExpression;\n\n  // Extract the component ID using the same rules as regex parser\n  let componentId: string | null = null;\n\n  // Look for 'id' property first (most common case)\n  const idProperty = configObject.getProperty('id');\n  if (idProperty && Node.isPropertyAssignment(idProperty)) {\n    const idValue = idProperty.getInitializer();\n    if (Node.isStringLiteral(idValue)) {\n      componentId = idValue.getLiteralValue();\n    }\n  }\n\n  // For statusComponents, look for 'type' property if 'id' not found (matches regex logic)\n  if (!componentId && componentType === 'statusComponents') {\n    const typeProperty = configObject.getProperty('type');\n    if (typeProperty && Node.isPropertyAssignment(typeProperty)) {\n      const typeValue = typeProperty.getInitializer();\n      if (Node.isStringLiteral(typeValue)) {\n        componentId = typeValue.getLiteralValue();\n      }\n    }\n  }\n\n  // For functionTools, look for 'name' property if 'id' not found (matches regex logic)\n  if (!componentId && componentType === 'functionTools') {\n    const nameProperty = configObject.getProperty('name');\n    if (nameProperty && Node.isPropertyAssignment(nameProperty)) {\n      const nameValue = nameProperty.getInitializer();\n      if (Node.isStringLiteral(nameValue)) {\n        componentId = nameValue.getLiteralValue();\n      }\n    }\n  }\n\n  if (!componentId) {\n    return null;\n  }\n\n  const startLine = callExpression.getStartLineNumber();\n\n  return {\n    id: componentId,\n    type: componentType,\n    filePath: relativePath,\n    variableName: variableName,\n    startLine,\n    isInline,\n  };\n}\n\n/**\n * Scan project directory for all components\n */\nfunction scanProjectForComponents(projectRoot: string, debug: boolean = false): ComponentMatch[] {\n  const allComponents: ComponentMatch[] = [];\n\n  if (!existsSync(projectRoot)) {\n    return allComponents;\n  }\n\n  const scanDir = (dir: string) => {\n    try {\n      const items = readdirSync(dir);\n      for (const item of items) {\n        const fullPath = join(dir, item);\n        const stat = statSync(fullPath);\n\n        if (stat.isDirectory()) {\n          // Skip node_modules, build directories, and temp validation directories\n          if (\n            !['node_modules', '.next', '.git', 'dist', 'build'].includes(item) &&\n            !item.startsWith('.temp-validation-')\n          ) {\n            scanDir(fullPath);\n          }\n        } else if (stat.isFile() && ['.ts', '.tsx', '.js', '.jsx'].includes(extname(item))) {\n          const fileComponents = parseFileForComponents(fullPath, projectRoot, debug);\n          allComponents.push(...fileComponents);\n        }\n      }\n    } catch (error) {\n      if (debug) {\n        console.warn(`Failed to scan directory ${dir}: ${error}`);\n      }\n    }\n  };\n\n  scanDir(projectRoot);\n\n  return allComponents;\n}\n\n/**\n * Build component registry from project parsing\n */\nexport function buildComponentRegistryFromParsing(\n  projectRoot: string,\n  debug: boolean = false\n): ComponentRegistry {\n  const registry = new ComponentRegistry();\n\n  const allComponents = scanProjectForComponents(projectRoot, debug);\n\n  // Sort components to prioritize exported over inline (in case of duplicates)\n  allComponents.sort((a, b) => {\n    if (a.id === b.id) {\n      // Same ID: prioritize exported (false) over inline (true)\n      return Number(a.isInline) - Number(b.isInline);\n    }\n    return 0; // Keep original order for different IDs\n  });\n\n  // Register components with registry (avoid duplicates by ID)\n  const stats = {\n    exported: 0,\n    inline: 0,\n    byType: {} as Record<string, number>,\n  };\n\n  const registeredTypeIds = new Set<string>(); // Use type:id instead of just id\n\n  for (const component of allComponents) {\n    const typeId = `${component.type}:${component.id}`;\n\n    // Skip if already registered, unless this component should override existing\n    if (registeredTypeIds.has(typeId) && !component.overrideExisting) {\n      continue;\n    }\n\n    registeredTypeIds.add(typeId);\n\n    if (component.variableName) {\n      // Component has an actual variable name (declared with const/export const), use it\n\n      if (component.overrideExisting && component.type === 'credentials') {\n        // Use override method for credentials with env settings keys\n        registry.overrideCredentialWithEnvKey(\n          component.id,\n          component.filePath,\n          component.variableName\n        );\n      } else {\n        registry.register(\n          component.id,\n          component.type,\n          component.filePath,\n          component.variableName,\n          component.isInline\n        );\n      }\n    } else {\n      // Truly inline component with no variable name, let registry generate unique name\n      registry.register(\n        component.id,\n        component.type,\n        component.filePath,\n        undefined, // Let registry handle naming with conflict resolution\n        true // isInline = true\n      );\n    }\n\n    // Update stats\n    if (component.isInline) {\n      stats.inline++;\n    } else {\n      stats.exported++;\n    }\n    stats.byType[component.type] = (stats.byType[component.type] || 0) + 1;\n  }\n  return registry;\n}\n\n/**\n * Get component location info for a specific component ID\n */\nexport function findComponentById(componentId: string, projectRoot: string): ComponentMatch | null {\n  const allComponents = scanProjectForComponents(projectRoot, false);\n  return allComponents.find((comp) => comp.id === componentId) || null;\n}\n\n/**\n * Get all local component IDs\n */\nexport function getAllLocalComponentIds(projectRoot: string): Set<string> {\n  const allComponents = scanProjectForComponents(projectRoot, false);\n  return new Set(allComponents.map((comp) => comp.id));\n}\n"],"mappings":"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"}
+{"version":3,"file":"component-parser.js","names":["args"],"sources":["../../../src/commands/pull-v4/component-parser.ts"],"sourcesContent":["/**\n * Component Parser - Find all component definitions (exported and inline)\n * Uses AST parsing to handle complex components including those with render attributes\n * Maps components by looking for patterns like:\n * - export const myTool = tool({id: 'tool-id', ...})\n * - dataComponent({id: 'data-id', ...}) (inline)\n */\n\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { extname, join, relative } from 'node:path';\nimport { type CallExpression, Node, type ObjectLiteralExpression } from 'ts-morph';\nimport { ComponentRegistry, type ComponentType } from './component-registry';\nimport { createInMemoryProject } from './utils';\n\ninterface ComponentMatch {\n  id: string;\n  type: ComponentType;\n  filePath: string;\n  variableName?: string; // If exported\n  startLine: number;\n  isInline: boolean; // true if not exported, false if exported\n  overrideExisting?: boolean; // true if this should override an existing component\n}\n\n/**\n * Valid plural component types for parsing\n */\nconst VALID_COMPONENT_TYPES = new Set<ComponentType>([\n  'project',\n  'agents',\n  'subAgents',\n  'tools',\n  'functionTools',\n  'dataComponents',\n  'artifactComponents',\n  'statusComponents',\n  'externalAgents',\n  'credentials',\n  'contextConfigs',\n  'fetchDefinitions',\n  'headers',\n]);\n\n/**\n * Mapping from SDK function names to ComponentTypes\n */\nconst FUNCTION_NAME_TO_TYPE: Record<string, ComponentType> = {\n  project: 'project',\n  agent: 'agents',\n  subAgent: 'subAgents',\n  tool: 'tools',\n  functionTool: 'functionTools',\n  dataComponent: 'dataComponents',\n  artifactComponent: 'artifactComponents',\n  statusComponent: 'statusComponents',\n  externalAgent: 'externalAgents',\n  credential: 'credentials',\n  contextConfig: 'contextConfigs',\n  fetchDefinition: 'fetchDefinitions',\n  header: 'headers',\n  mcpTool: 'tools',\n};\n\n/**\n * Parse a single file for all component definitions using AST parsing\n * Handles all patterns: exported, declared+exported, declared-only, and inline\n */\nfunction parseFileForComponents(\n  filePath: string,\n  projectRoot: string,\n  debug = false\n): ComponentMatch[] {\n  if (!existsSync(filePath)) {\n    return [];\n  }\n\n  const components: ComponentMatch[] = [];\n  const relativePath = relative(projectRoot, filePath);\n\n  try {\n    const content = readFileSync(filePath, 'utf8');\n\n    // Create a temporary ts-morph project for parsing\n    const project = createInMemoryProject();\n\n    // Add the file to the project\n    const sourceFile = project.createSourceFile('temp.ts', content);\n\n    // Pattern 1: Direct exports (export const name = func({...}))\n    const exportedVariableDeclarations = sourceFile\n      .getVariableStatements()\n      .filter((statement) => statement.hasExportKeyword())\n      .flatMap((statement) => statement.getDeclarationList().getDeclarations());\n\n    for (const declaration of exportedVariableDeclarations) {\n      const variableName = declaration.getName();\n      const initializer = declaration.getInitializer();\n\n      if (Node.isCallExpression(initializer)) {\n        const componentMatch = parseCallExpression(initializer, variableName, false, relativePath);\n        if (componentMatch) {\n          components.push(componentMatch);\n        }\n      }\n    }\n\n    // Pattern 2: Separate declaration + export (const name = func({...}) + export { name })\n    // First, collect all exported names from export declarations\n    const exportedNames = new Set<string>();\n    sourceFile.getExportDeclarations().forEach((exportDecl) => {\n      const namedExports = exportDecl.getNamedExports();\n      namedExports.forEach((namedExport) => {\n        exportedNames.add(namedExport.getName());\n      });\n    });\n\n    // Find variable declarations that are exported via separate export statements\n    const allVariableDeclarations = sourceFile\n      .getVariableStatements()\n      .filter((statement) => !statement.hasExportKeyword()) // Not direct exports\n      .flatMap((statement) => statement.getDeclarationList().getDeclarations());\n\n    for (const declaration of allVariableDeclarations) {\n      const variableName = declaration.getName();\n      const initializer = declaration.getInitializer();\n\n      if (Node.isCallExpression(initializer)) {\n        const isExported = exportedNames.has(variableName);\n        const isInline = !isExported;\n\n        const componentMatch = parseCallExpression(\n          initializer,\n          variableName,\n          isInline,\n          relativePath\n        );\n        if (componentMatch) {\n          components.push(componentMatch);\n        }\n      }\n    }\n\n    // Pattern 3: Truly inline components (function calls without variable assignment)\n    // Walk the AST to find all call expressions that aren't part of variable declarations\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        // Check if this call expression is NOT the initializer of a variable declaration\n        const parent = node.getParent();\n        const isVariableInitializer =\n          Node.isVariableDeclaration(parent) && parent.getInitializer() === node;\n\n        if (!isVariableInitializer) {\n          const componentMatch = parseCallExpression(node, undefined, true, relativePath);\n          if (componentMatch) {\n            components.push(componentMatch);\n          }\n        }\n      }\n    });\n\n    // Pattern 4: Environment-based credentials within registerEnvironmentSettings\n    // export const development = registerEnvironmentSettings({\n    //   credentials: {\n    //     stripe_api_key: {\n    //       id: 'stripe-api-key',\n    //       name: 'Stripe API Key',\n    //       ...\n    //     }\n    //   }\n    // });\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        const expression = node.getExpression();\n\n        // Check if this is a registerEnvironmentSettings call\n        if (\n          Node.isIdentifier(expression) &&\n          expression.getText() === 'registerEnvironmentSettings'\n        ) {\n          const args = node.getArguments();\n          if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {\n            const configObject = args[0];\n\n            // Look for credentials property\n            const credentialsProperty = configObject.getProperty('credentials');\n            if (credentialsProperty && Node.isPropertyAssignment(credentialsProperty)) {\n              const credentialsValue = credentialsProperty.getInitializer();\n\n              if (Node.isObjectLiteralExpression(credentialsValue)) {\n                // Parse each credential in the credentials object\n                credentialsValue.getProperties().forEach((property) => {\n                  if (Node.isPropertyAssignment(property)) {\n                    const credentialKey = property.getName(); // e.g., \"stripe_api_key\"\n                    const credentialConfig = property.getInitializer();\n\n                    if (Node.isObjectLiteralExpression(credentialConfig)) {\n                      // Inline credential definition - Look for the 'id' property in the credential config\n                      const idProperty = credentialConfig.getProperty('id');\n                      if (idProperty && Node.isPropertyAssignment(idProperty)) {\n                        const idValue = idProperty.getInitializer();\n                        if (Node.isStringLiteral(idValue)) {\n                          const credentialId = idValue.getLiteralValue(); // e.g., \"stripe-api-key\"\n                          const startLine = node.getStartLineNumber();\n\n                          components.push({\n                            id: credentialId,\n                            type: 'credentials',\n                            filePath: relativePath,\n                            variableName: credentialKey, // Use the key name as variable name\n                            startLine,\n                            isInline: true, // It's nested within environment settings\n                          });\n                        }\n                      }\n                    } else if (Node.isIdentifier(credentialConfig)) {\n                      // Variable reference - need to find the credential ID from the variable\n                      // This handles cases like: stripe_api_key: stripeApiKey\n                      const variableName = credentialConfig.getText();\n\n                      // Look for the credential variable definition in this file\n                      sourceFile.forEachDescendant((varNode) => {\n                        if (\n                          Node.isVariableDeclaration(varNode) &&\n                          varNode.getName() === variableName\n                        ) {\n                          const initializer = varNode.getInitializer();\n                          if (Node.isCallExpression(initializer)) {\n                            const callExpression = initializer.getExpression();\n                            if (\n                              Node.isIdentifier(callExpression) &&\n                              callExpression.getText() === 'credential'\n                            ) {\n                              const args = initializer.getArguments();\n                              if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {\n                                const configObject = args[0];\n                                const idProperty = configObject.getProperty('id');\n                                if (idProperty && Node.isPropertyAssignment(idProperty)) {\n                                  const idValue = idProperty.getInitializer();\n                                  if (Node.isStringLiteral(idValue)) {\n                                    const credentialId = idValue.getLiteralValue();\n                                    const startLine = node.getStartLineNumber();\n\n                                    components.push({\n                                      id: credentialId,\n                                      type: 'credentials',\n                                      filePath: relativePath,\n                                      variableName: credentialKey, // Use the env settings key as variable name\n                                      startLine,\n                                      isInline: true,\n                                      overrideExisting: true, // Mark this to override any existing registration\n                                    });\n                                  }\n                                }\n                              }\n                            }\n                          }\n                        }\n                      });\n                    }\n                  }\n                });\n              }\n            }\n          }\n        }\n      }\n    });\n\n    return components;\n  } catch (error) {\n    if (debug) {\n      console.warn(`Failed to parse file ${relativePath}: ${error}`);\n    }\n    return [];\n  }\n}\n\n/**\n * Parse a call expression to extract component information\n * Handles the same logic as the original regex patterns\n */\nfunction parseCallExpression(\n  callExpression: CallExpression,\n  variableName: string | undefined,\n  isInline: boolean,\n  relativePath: string\n): ComponentMatch | null {\n  const expression = callExpression.getExpression();\n\n  // Get the function name (e.g., 'dataComponent', 'tool', etc.)\n  let functionName: string;\n  if (Node.isIdentifier(expression)) {\n    functionName = expression.getText();\n  } else {\n    return null;\n  }\n\n  // Map function name to component type\n  const componentType = FUNCTION_NAME_TO_TYPE[functionName];\n  if (!componentType || !VALID_COMPONENT_TYPES.has(componentType)) {\n    return null;\n  }\n\n  // Get the first argument (should be an object literal)\n  const args = callExpression.getArguments();\n  if (args.length === 0 || !Node.isObjectLiteralExpression(args[0])) {\n    return null;\n  }\n\n  const configObject = args[0] as ObjectLiteralExpression;\n\n  // Extract the component ID using the same rules as regex parser\n  let componentId: string | null = null;\n\n  // Look for 'id' property first (most common case)\n  const idProperty = configObject.getProperty('id');\n  if (idProperty && Node.isPropertyAssignment(idProperty)) {\n    const idValue = idProperty.getInitializer();\n    if (Node.isStringLiteral(idValue)) {\n      componentId = idValue.getLiteralValue();\n    }\n  }\n\n  // For statusComponents, look for 'type' property if 'id' not found (matches regex logic)\n  if (!componentId && componentType === 'statusComponents') {\n    const typeProperty = configObject.getProperty('type');\n    if (typeProperty && Node.isPropertyAssignment(typeProperty)) {\n      const typeValue = typeProperty.getInitializer();\n      if (Node.isStringLiteral(typeValue)) {\n        componentId = typeValue.getLiteralValue();\n      }\n    }\n  }\n\n  // For functionTools, look for 'name' property if 'id' not found (matches regex logic)\n  if (!componentId && componentType === 'functionTools') {\n    const nameProperty = configObject.getProperty('name');\n    if (nameProperty && Node.isPropertyAssignment(nameProperty)) {\n      const nameValue = nameProperty.getInitializer();\n      if (Node.isStringLiteral(nameValue)) {\n        componentId = nameValue.getLiteralValue();\n      }\n    }\n  }\n\n  if (!componentId) {\n    return null;\n  }\n\n  const startLine = callExpression.getStartLineNumber();\n\n  return {\n    id: componentId,\n    type: componentType,\n    filePath: relativePath,\n    variableName: variableName,\n    startLine,\n    isInline,\n  };\n}\n\n/**\n * Scan project directory for all components\n */\nfunction scanProjectForComponents(projectRoot: string, debug: boolean = false): ComponentMatch[] {\n  const allComponents: ComponentMatch[] = [];\n\n  if (!existsSync(projectRoot)) {\n    return allComponents;\n  }\n\n  const scanDir = (dir: string) => {\n    try {\n      const items = readdirSync(dir);\n      for (const item of items) {\n        const fullPath = join(dir, item);\n        const stat = statSync(fullPath);\n\n        if (stat.isDirectory()) {\n          // Skip node_modules, build directories, and temp validation directories\n          if (\n            !['node_modules', '.next', '.git', 'dist', 'build'].includes(item) &&\n            !item.startsWith('.temp-validation-')\n          ) {\n            scanDir(fullPath);\n          }\n        } else if (stat.isFile() && ['.ts', '.tsx', '.js', '.jsx'].includes(extname(item))) {\n          const fileComponents = parseFileForComponents(fullPath, projectRoot, debug);\n          allComponents.push(...fileComponents);\n        }\n      }\n    } catch (error) {\n      if (debug) {\n        console.warn(`Failed to scan directory ${dir}: ${error}`);\n      }\n    }\n  };\n\n  scanDir(projectRoot);\n\n  return allComponents;\n}\n\n/**\n * Build component registry from project parsing\n */\nexport function buildComponentRegistryFromParsing(\n  projectRoot: string,\n  debug: boolean = false\n): ComponentRegistry {\n  const registry = new ComponentRegistry();\n\n  const allComponents = scanProjectForComponents(projectRoot, debug);\n\n  // Sort components to prioritize exported over inline (in case of duplicates)\n  allComponents.sort((a, b) => {\n    if (a.id === b.id) {\n      // Same ID: prioritize exported (false) over inline (true)\n      return Number(a.isInline) - Number(b.isInline);\n    }\n    return 0; // Keep original order for different IDs\n  });\n\n  // Register components with registry (avoid duplicates by ID)\n  const stats = {\n    exported: 0,\n    inline: 0,\n    byType: {} as Record<string, number>,\n  };\n\n  const registeredTypeIds = new Set<string>(); // Use type:id instead of just id\n\n  for (const component of allComponents) {\n    const typeId = `${component.type}:${component.id}`;\n\n    // Skip if already registered, unless this component should override existing\n    if (registeredTypeIds.has(typeId) && !component.overrideExisting) {\n      continue;\n    }\n\n    registeredTypeIds.add(typeId);\n\n    if (component.variableName) {\n      // Component has an actual variable name (declared with const/export const), use it\n\n      if (component.overrideExisting && component.type === 'credentials') {\n        // Use override method for credentials with env settings keys\n        registry.overrideCredentialWithEnvKey(\n          component.id,\n          component.filePath,\n          component.variableName\n        );\n      } else {\n        registry.register(\n          component.id,\n          component.type,\n          component.filePath,\n          component.variableName,\n          component.isInline\n        );\n      }\n    } else {\n      // Truly inline component with no variable name, let registry generate unique name\n      registry.register(\n        component.id,\n        component.type,\n        component.filePath,\n        undefined, // Let registry handle naming with conflict resolution\n        true // isInline = true\n      );\n    }\n\n    // Update stats\n    if (component.isInline) {\n      stats.inline++;\n    } else {\n      stats.exported++;\n    }\n    stats.byType[component.type] = (stats.byType[component.type] || 0) + 1;\n  }\n  return registry;\n}\n\n/**\n * Get component location info for a specific component ID\n */\nexport function findComponentById(componentId: string, projectRoot: string): ComponentMatch | null {\n  const allComponents = scanProjectForComponents(projectRoot, false);\n  return allComponents.find((comp) => comp.id === componentId) || null;\n}\n\n/**\n * Get all local component IDs\n */\nexport function getAllLocalComponentIds(projectRoot: string): Set<string> {\n  const allComponents = scanProjectForComponents(projectRoot, false);\n  return new Set(allComponents.map((comp) => comp.id));\n}\n"],"mappings":"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"}

package/dist/commands/pull-v4/file-scope.js

@@ -0,0 +1,43 @@
+import { createInMemoryProject } from "./utils/factory-writer.js";
+import "./utils/index.js";
+import { existsSync, readFileSync } from "node:fs";
+
+//#region src/commands/pull-v4/file-scope.ts
+function createFileScope(content, fileName = "scope.ts") {
+	const sourceFile = createInMemoryProject().createSourceFile(fileName, content, { overwrite: true });
+	return {
+		sourceFile,
+		reservedNames: collectReservedTopLevelNames(sourceFile)
+	};
+}
+function readFileScope(filePath) {
+	if (!existsSync(filePath)) return;
+	return createFileScope(readFileSync(filePath, "utf8"), filePath);
+}
+function collectReservedTopLevelNames(sourceFile) {
+	const reservedNames = /* @__PURE__ */ new Set();
+	for (const importDeclaration of sourceFile.getImportDeclarations()) {
+		const defaultImport = importDeclaration.getDefaultImport()?.getText();
+		if (defaultImport) reservedNames.add(defaultImport);
+		const namespaceImport = importDeclaration.getNamespaceImport()?.getText();
+		if (namespaceImport) reservedNames.add(namespaceImport);
+		for (const namedImport of importDeclaration.getNamedImports()) reservedNames.add(namedImport.getAliasNode()?.getText() ?? namedImport.getName());
+	}
+	for (const declarations of [
+		sourceFile.getVariableDeclarations(),
+		sourceFile.getFunctions(),
+		sourceFile.getClasses(),
+		sourceFile.getInterfaces(),
+		sourceFile.getTypeAliases(),
+		sourceFile.getEnums(),
+		sourceFile.getModules()
+	]) for (const declaration of declarations) {
+		const name = declaration.getName();
+		if (name) reservedNames.add(name);
+	}
+	return reservedNames;
+}
+
+//#endregion
+export { collectReservedTopLevelNames, createFileScope, readFileScope };
+//# sourceMappingURL=file-scope.js.map

package/dist/commands/pull-v4/file-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scope.js","names":[],"sources":["../../../src/commands/pull-v4/file-scope.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport type { SourceFile } from 'ts-morph';\nimport { createInMemoryProject } from './utils';\n\nexport interface FileScope {\n  sourceFile: SourceFile;\n  reservedNames: Set<string>;\n}\n\nexport function createFileScope(content: string, fileName = 'scope.ts'): FileScope {\n  const sourceFile = createInMemoryProject().createSourceFile(fileName, content, {\n    overwrite: true,\n  });\n\n  return {\n    sourceFile,\n    reservedNames: collectReservedTopLevelNames(sourceFile),\n  };\n}\n\nexport function readFileScope(filePath: string): FileScope | undefined {\n  if (!existsSync(filePath)) {\n    return;\n  }\n\n  return createFileScope(readFileSync(filePath, 'utf8'), filePath);\n}\n\nexport function collectReservedTopLevelNames(sourceFile: SourceFile): Set<string> {\n  const reservedNames = new Set<string>();\n\n  for (const importDeclaration of sourceFile.getImportDeclarations()) {\n    const defaultImport = importDeclaration.getDefaultImport()?.getText();\n    if (defaultImport) {\n      reservedNames.add(defaultImport);\n    }\n\n    const namespaceImport = importDeclaration.getNamespaceImport()?.getText();\n    if (namespaceImport) {\n      reservedNames.add(namespaceImport);\n    }\n\n    for (const namedImport of importDeclaration.getNamedImports()) {\n      reservedNames.add(namedImport.getAliasNode()?.getText() ?? namedImport.getName());\n    }\n  }\n\n  for (const declarations of [\n    sourceFile.getVariableDeclarations(),\n    sourceFile.getFunctions(),\n    sourceFile.getClasses(),\n    sourceFile.getInterfaces(),\n    sourceFile.getTypeAliases(),\n    sourceFile.getEnums(),\n    sourceFile.getModules(),\n  ]) {\n    for (const declaration of declarations) {\n      const name = declaration.getName();\n      if (name) {\n        reservedNames.add(name);\n      }\n    }\n  }\n\n  return reservedNames;\n}\n"],"mappings":";;;;;AASA,SAAgB,gBAAgB,SAAiB,WAAW,YAAuB;CACjF,MAAM,aAAa,uBAAuB,CAAC,iBAAiB,UAAU,SAAS,EAC7E,WAAW,MACZ,CAAC;AAEF,QAAO;EACL;EACA,eAAe,6BAA6B,WAAW;EACxD;;AAGH,SAAgB,cAAc,UAAyC;AACrE,KAAI,CAAC,WAAW,SAAS,CACvB;AAGF,QAAO,gBAAgB,aAAa,UAAU,OAAO,EAAE,SAAS;;AAGlE,SAAgB,6BAA6B,YAAqC;CAChF,MAAM,gCAAgB,IAAI,KAAa;AAEvC,MAAK,MAAM,qBAAqB,WAAW,uBAAuB,EAAE;EAClE,MAAM,gBAAgB,kBAAkB,kBAAkB,EAAE,SAAS;AACrE,MAAI,cACF,eAAc,IAAI,cAAc;EAGlC,MAAM,kBAAkB,kBAAkB,oBAAoB,EAAE,SAAS;AACzE,MAAI,gBACF,eAAc,IAAI,gBAAgB;AAGpC,OAAK,MAAM,eAAe,kBAAkB,iBAAiB,CAC3D,eAAc,IAAI,YAAY,cAAc,EAAE,SAAS,IAAI,YAAY,SAAS,CAAC;;AAIrF,MAAK,MAAM,gBAAgB;EACzB,WAAW,yBAAyB;EACpC,WAAW,cAAc;EACzB,WAAW,YAAY;EACvB,WAAW,eAAe;EAC1B,WAAW,gBAAgB;EAC3B,WAAW,UAAU;EACrB,WAAW,YAAY;EACxB,CACC,MAAK,MAAM,eAAe,cAAc;EACtC,MAAM,OAAO,YAAY,SAAS;AAClC,MAAI,KACF,eAAc,IAAI,KAAK;;AAK7B,QAAO"}

package/dist/commands/pull-v4/generation-resolver.js

@@ -0,0 +1,305 @@
+import { buildComponentFileName, isHumanReadableId, toCamelCase, toCredentialReferenceName, toKebabCase, toToolReferenceName } from "./utils/naming.js";
+import "./utils/index.js";
+import { asRecord, stripExtension } from "./collector-common.js";
+import { resolveSubAgentVariableName } from "./generators/helpers/sub-agent.js";
+import { basename, dirname, join } from "node:path";
+
+//#region src/commands/pull-v4/generation-resolver.ts
+var GenerationResolver = class {
+	projectRoot;
+	existingComponentRegistry;
+	toolReferenceNamesById;
+	toolReferencePathsById;
+	credentialReferenceNamesById;
+	credentialReferencePathsById;
+	externalAgentReferenceNamesById;
+	externalAgentReferencePathsById;
+	subAgentReferenceNamesById;
+	subAgentReferencePathsById;
+	agentReferenceNamesById;
+	agentReferencePathsById;
+	constructor({ project, projectRoot, completeAgentIds, existingComponentRegistry }) {
+		this.projectRoot = projectRoot;
+		this.existingComponentRegistry = existingComponentRegistry;
+		this.toolReferenceNamesById = buildToolReferenceNamesById(project);
+		this.toolReferencePathsById = buildToolReferencePathById(project);
+		this.credentialReferenceNamesById = buildCredentialReferenceNamesById(project);
+		this.credentialReferencePathsById = buildCredentialReferencePathById(project);
+		this.externalAgentReferenceNamesById = buildExternalAgentReferenceNamesById(project);
+		this.externalAgentReferencePathsById = buildExternalAgentReferencePathById(project);
+		this.subAgentReferenceNamesById = buildSubAgentReferenceNamesById(project, completeAgentIds);
+		this.subAgentReferencePathsById = buildSubAgentReferencePathById(project, completeAgentIds);
+		this.agentReferenceNamesById = buildAgentReferenceNamesById(project);
+		this.agentReferencePathsById = buildAgentReferencePathById(project);
+	}
+	getExistingComponent(id, type) {
+		return this.existingComponentRegistry?.get(id, type);
+	}
+	resolveOutputFilePath(componentType, componentId, fallbackFilePath) {
+		const existingComponent = this.getExistingComponent(componentId, componentType);
+		if (!existingComponent?.filePath) return fallbackFilePath;
+		return resolveProjectFilePath(this.projectRoot, existingComponent.filePath);
+	}
+	getToolReferenceName(toolId) {
+		return this.getPreferredReferenceName(toolId, ["functionTools", "tools"], this.toolReferenceNamesById);
+	}
+	getToolReferencePath(toolId) {
+		const existingTool = this.getExistingComponent(toolId, "functionTools") ?? this.getExistingComponent(toolId, "tools");
+		if (existingTool?.filePath) return resolveToolModulePath(existingTool.filePath);
+		return this.toolReferencePathsById[toolId];
+	}
+	getCredentialReferenceName(credentialId) {
+		return this.getPreferredReferenceName(credentialId, ["credentials"], this.credentialReferenceNamesById);
+	}
+	getCredentialReferencePath(credentialId) {
+		return this.getPreferredReferencePath(credentialId, ["credentials"], this.credentialReferencePathsById);
+	}
+	getExternalAgentReferenceName(externalAgentId) {
+		return this.getPreferredReferenceName(externalAgentId, ["externalAgents"], this.externalAgentReferenceNamesById);
+	}
+	getExternalAgentReferencePath(externalAgentId) {
+		return this.getPreferredReferencePath(externalAgentId, ["externalAgents"], this.externalAgentReferencePathsById);
+	}
+	getSubAgentReferenceName(subAgentId) {
+		return this.getPreferredReferenceName(subAgentId, ["subAgents"], this.subAgentReferenceNamesById);
+	}
+	getSubAgentReferencePath(subAgentId) {
+		return this.getPreferredReferencePath(subAgentId, ["subAgents"], this.subAgentReferencePathsById);
+	}
+	getAgentReferenceName(agentId) {
+		return this.getPreferredReferenceName(agentId, ["agents"], this.agentReferenceNamesById);
+	}
+	getAgentReferencePath(agentId) {
+		return this.getPreferredReferencePath(agentId, ["agents"], this.agentReferencePathsById);
+	}
+	getPreferredReferenceName(componentId, componentTypes, generatedNamesById) {
+		const existingComponent = this.getExistingComponentByTypes(componentId, componentTypes);
+		if (existingComponent?.name) return existingComponent.name;
+		return generatedNamesById[componentId];
+	}
+	getPreferredReferencePath(componentId, componentTypes, generatedPathsById) {
+		const existingComponent = this.getExistingComponentByTypes(componentId, componentTypes);
+		if (existingComponent?.filePath) return stripExtension(basename(existingComponent.filePath));
+		return generatedPathsById[componentId];
+	}
+	getExistingComponentByTypes(componentId, componentTypes) {
+		for (const componentType of componentTypes) {
+			const component = this.getExistingComponent(componentId, componentType);
+			if (component) return component;
+		}
+	}
+};
+function collectFunctionToolEntries(project) {
+	const functionToolsById = collectFunctionToolsById(project);
+	const functionsById = collectFunctionsById(project);
+	const entries = [];
+	for (const [functionToolId, functionToolData] of Object.entries(functionToolsById)) {
+		const functionId = typeof functionToolData.functionId === "string" && functionToolData.functionId.length > 0 ? functionToolData.functionId : functionToolId;
+		const functionData = functionsById[functionId] ?? {};
+		const functionToolName = typeof functionToolData.name === "string" && functionToolData.name.length > 0 ? functionToolData.name : void 0;
+		const functionName = typeof functionData.name === "string" && functionData.name.length > 0 ? functionData.name : void 0;
+		const fallbackName = functionToolName ?? functionName ?? functionToolId;
+		entries.push({
+			functionToolId,
+			functionId,
+			functionToolData,
+			functionData,
+			exportName: fallbackName,
+			fileName: fallbackName
+		});
+	}
+	return entries;
+}
+function collectFunctionToolsById(project) {
+	const functionToolsById = {};
+	for (const [functionToolId, functionToolData] of Object.entries(project.functionTools ?? {})) {
+		const functionToolRecord = asRecord(functionToolData);
+		if (!functionToolRecord) continue;
+		functionToolsById[functionToolId] = { ...functionToolRecord };
+	}
+	for (const agentData of Object.values(project.agents ?? {})) {
+		const agentFunctionTools = asRecord(asRecord(agentData)?.functionTools);
+		if (!agentFunctionTools) continue;
+		for (const [functionToolId, functionToolData] of Object.entries(agentFunctionTools)) {
+			const functionToolRecord = asRecord(functionToolData);
+			if (!functionToolRecord) continue;
+			const existingFunctionTool = functionToolsById[functionToolId] ?? {};
+			functionToolsById[functionToolId] = {
+				...functionToolRecord,
+				...existingFunctionTool
+			};
+		}
+	}
+	return functionToolsById;
+}
+function collectFunctionsById(project) {
+	const functionsById = {};
+	for (const [functionId, functionData] of Object.entries(project.functions ?? {})) {
+		const functionRecord = asRecord(functionData);
+		if (!functionRecord) continue;
+		functionsById[functionId] = { ...functionRecord };
+	}
+	for (const agentData of Object.values(project.agents ?? {})) {
+		const agentFunctions = asRecord(asRecord(agentData)?.functions);
+		if (!agentFunctions) continue;
+		for (const [functionId, functionData] of Object.entries(agentFunctions)) {
+			const functionRecord = asRecord(functionData);
+			if (!functionRecord) continue;
+			const existingFunction = functionsById[functionId] ?? {};
+			functionsById[functionId] = {
+				...functionRecord,
+				...existingFunction
+			};
+		}
+	}
+	return functionsById;
+}
+function buildToolReferenceNamesById(project) {
+	const toolReferenceNamesById = {};
+	for (const [toolId, toolData] of Object.entries(project.tools ?? {})) {
+		const toolName = asRecord(toolData)?.name;
+		toolReferenceNamesById[toolId] = typeof toolName === "string" && toolName.length > 0 ? toToolReferenceName(toolName) : toToolReferenceName(toolId);
+	}
+	for (const functionToolEntry of collectFunctionToolEntries(project)) toolReferenceNamesById[functionToolEntry.functionToolId] = toToolReferenceName(functionToolEntry.exportName);
+	return toolReferenceNamesById;
+}
+function buildToolReferencePathById(project) {
+	const toolEntries = Object.entries(project.tools ?? {});
+	const toolFileNamesById = buildSequentialNameFileNames(toolEntries);
+	const toolReferencePathById = {};
+	for (const [toolId] of toolEntries) toolReferencePathById[toolId] = stripExtension(toolFileNamesById[toolId]);
+	const functionToolEntries = collectFunctionToolEntries(project);
+	const functionToolFileNamesById = buildSequentialNameFileNames(functionToolEntries.map(({ functionToolId, fileName }) => [functionToolId, { name: fileName }]));
+	for (const { functionToolId } of functionToolEntries) toolReferencePathById[functionToolId] = stripExtension(functionToolFileNamesById[functionToolId]);
+	return toolReferencePathById;
+}
+function buildCredentialReferenceNamesById(project) {
+	const credentialReferenceNamesById = {};
+	const countsByReferenceName = /* @__PURE__ */ new Map();
+	for (const [credentialId, credentialData] of Object.entries(project.credentialReferences ?? {})) {
+		const credentialName = asRecord(credentialData)?.name;
+		const baseReferenceName = typeof credentialName === "string" && credentialName.length > 0 ? toCredentialReferenceName(credentialName) : toCredentialReferenceName(credentialId);
+		const occurrence = countsByReferenceName.get(baseReferenceName) ?? 0;
+		countsByReferenceName.set(baseReferenceName, occurrence + 1);
+		credentialReferenceNamesById[credentialId] = occurrence === 0 ? baseReferenceName : `${baseReferenceName}${occurrence}`;
+	}
+	return credentialReferenceNamesById;
+}
+function buildCredentialReferencePathById(project) {
+	const credentialEntries = Object.entries(project.credentialReferences ?? {});
+	const credentialFileNamesById = buildSequentialNameFileNames(credentialEntries);
+	const credentialReferencePathById = {};
+	for (const [credentialId] of credentialEntries) credentialReferencePathById[credentialId] = stripExtension(credentialFileNamesById[credentialId]);
+	return credentialReferencePathById;
+}
+function buildExternalAgentReferenceNamesById(project) {
+	const externalAgentReferenceNamesById = {};
+	const countsByReferenceName = /* @__PURE__ */ new Map();
+	for (const [externalAgentId, externalAgentData] of Object.entries(project.externalAgents ?? {})) {
+		const baseReferenceName = toExternalAgentReferenceName(resolveExternalAgentNamingSeed(externalAgentId, externalAgentData));
+		const occurrence = countsByReferenceName.get(baseReferenceName) ?? 0;
+		countsByReferenceName.set(baseReferenceName, occurrence + 1);
+		externalAgentReferenceNamesById[externalAgentId] = occurrence === 0 ? baseReferenceName : `${baseReferenceName}${occurrence}`;
+	}
+	return externalAgentReferenceNamesById;
+}
+function buildExternalAgentReferencePathById(project) {
+	const externalAgentEntries = Object.entries(project.externalAgents ?? {}).map(([externalAgentId, externalAgentData]) => [externalAgentId, { name: resolveExternalAgentNamingSeed(externalAgentId, externalAgentData) }]);
+	const externalAgentFileNamesById = buildSequentialNameFileNames(externalAgentEntries);
+	const externalAgentReferencePathById = {};
+	for (const [externalAgentId] of externalAgentEntries) externalAgentReferencePathById[externalAgentId] = stripExtension(externalAgentFileNamesById[externalAgentId]);
+	return externalAgentReferencePathById;
+}
+function buildSubAgentReferenceNamesById(project, agentIds) {
+	const subAgentReferenceNamesById = {};
+	const candidateAgentIds = agentIds !== void 0 ? [...agentIds] : Object.keys(project.agents ?? {});
+	for (const agentId of candidateAgentIds) {
+		const agentData = project.agents?.[agentId];
+		const subAgents = asRecord(agentData?.subAgents);
+		if (!subAgents) continue;
+		for (const [subAgentId, subAgentData] of Object.entries(subAgents)) {
+			const subAgentName = asRecord(subAgentData)?.name;
+			subAgentReferenceNamesById[subAgentId] = resolveSubAgentVariableName(subAgentId, typeof subAgentName === "string" ? subAgentName : void 0);
+		}
+	}
+	return subAgentReferenceNamesById;
+}
+function buildSubAgentReferencePathById(project, agentIds) {
+	const subAgentReferencePathById = {};
+	const candidateAgentIds = agentIds !== void 0 ? [...agentIds] : Object.keys(project.agents ?? {});
+	for (const agentId of candidateAgentIds) {
+		const agentData = project.agents?.[agentId];
+		const subAgents = asRecord(agentData?.subAgents);
+		if (!subAgents) continue;
+		for (const [subAgentId, subAgentData] of Object.entries(subAgents)) {
+			const subAgentName = asRecord(subAgentData)?.name;
+			subAgentReferencePathById[subAgentId] = stripExtension(buildComponentFileName(subAgentId, typeof subAgentName === "string" ? subAgentName : void 0));
+		}
+	}
+	return subAgentReferencePathById;
+}
+function buildAgentReferenceNamesById(project) {
+	const agentReferenceNamesById = {};
+	for (const agentId of Object.keys(project.agents ?? {})) agentReferenceNamesById[agentId] = toCamelCase(agentId);
+	return agentReferenceNamesById;
+}
+function buildAgentReferencePathById(project) {
+	const agentReferencePathById = {};
+	for (const [agentId, agentData] of Object.entries(project.agents ?? {})) {
+		const agentName = asRecord(agentData)?.name;
+		agentReferencePathById[agentId] = stripExtension(buildComponentFileName(agentId, typeof agentName === "string" ? agentName : void 0));
+	}
+	return agentReferencePathById;
+}
+function toExternalAgentReferenceName(input) {
+	const base = toCamelCase(input);
+	return base.endsWith("Agent") ? base : `${base}Agent`;
+}
+function resolveExternalAgentNamingSeed(externalAgentId, externalAgentData) {
+	if (isHumanReadableId(externalAgentId)) return externalAgentId;
+	const externalAgentName = asRecord(externalAgentData)?.name;
+	if (typeof externalAgentName === "string" && externalAgentName.length > 0) return externalAgentName;
+	return externalAgentId;
+}
+function resolveToolModulePath(filePath) {
+	const normalizedFilePath = normalizeFilePath(filePath);
+	const toolsIndex = normalizedFilePath.lastIndexOf("/tools/");
+	if (toolsIndex >= 0) {
+		let modulePath = stripExtension(normalizedFilePath.slice(toolsIndex + 7));
+		if (modulePath.endsWith("/index")) modulePath = modulePath.slice(0, -6);
+		if (modulePath.length > 0) return modulePath;
+	}
+	const baseModulePath = stripExtension(basename(normalizedFilePath));
+	if (baseModulePath === "index") return stripExtension(basename(dirname(normalizedFilePath)));
+	return baseModulePath;
+}
+function resolveProjectFilePath(projectRoot, filePath) {
+	if (filePath.startsWith("/")) return filePath;
+	return join(projectRoot, filePath);
+}
+function normalizeFilePath(filePath) {
+	return filePath.replaceAll("\\", "/");
+}
+function buildSequentialNameFileNames(entries) {
+	const countsByStem = /* @__PURE__ */ new Map();
+	const fileNamesById = {};
+	for (const [componentId, componentData] of entries) {
+		const name = asRecord(componentData)?.name;
+		const baseStem = resolveNameFileStem(componentId, typeof name === "string" ? name : void 0);
+		const occurrence = countsByStem.get(baseStem) ?? 0;
+		countsByStem.set(baseStem, occurrence + 1);
+		fileNamesById[componentId] = `${occurrence === 0 ? baseStem : `${baseStem}-${occurrence}`}.ts`;
+	}
+	return fileNamesById;
+}
+function resolveNameFileStem(componentId, name) {
+	const nameStem = name ? toKebabCase(name) : "";
+	if (nameStem.length > 0) return nameStem;
+	const idStem = toKebabCase(componentId);
+	if (idStem.length > 0) return idStem;
+	return componentId;
+}
+
+//#endregion
+export { GenerationResolver, buildSequentialNameFileNames, collectFunctionToolEntries, normalizeFilePath, resolveExternalAgentNamingSeed, resolveProjectFilePath, resolveToolModulePath };
+//# sourceMappingURL=generation-resolver.js.map

package/dist/commands/pull-v4/generation-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-resolver.js","names":[],"sources":["../../../src/commands/pull-v4/generation-resolver.ts"],"sourcesContent":["import { basename, dirname, join } from 'node:path';\nimport type { FullProjectDefinition } from '@inkeep/agents-core';\nimport { asRecord, stripExtension } from './collector-common';\nimport type { ComponentInfo, ComponentRegistry, ComponentType } from './component-registry';\nimport { resolveSubAgentVariableName } from './generators/helpers/sub-agent';\nimport {\n  buildComponentFileName,\n  isHumanReadableId,\n  toCamelCase,\n  toCredentialReferenceName,\n  toKebabCase,\n  toToolReferenceName,\n} from './utils';\n\ninterface GenerationResolverOptions {\n  project: FullProjectDefinition;\n  projectRoot: string;\n  completeAgentIds: Iterable<string>;\n  existingComponentRegistry?: ComponentRegistry;\n}\n\nexport interface FunctionToolEntry {\n  functionToolId: string;\n  functionId: string;\n  functionToolData: Record<string, unknown>;\n  functionData: Record<string, unknown>;\n  exportName: string;\n  fileName: string;\n}\n\nexport class GenerationResolver {\n  private readonly projectRoot: string;\n  private readonly existingComponentRegistry?: ComponentRegistry;\n  private readonly toolReferenceNamesById: Record<string, string>;\n  private readonly toolReferencePathsById: Record<string, string>;\n  private readonly credentialReferenceNamesById: Record<string, string>;\n  private readonly credentialReferencePathsById: Record<string, string>;\n  private readonly externalAgentReferenceNamesById: Record<string, string>;\n  private readonly externalAgentReferencePathsById: Record<string, string>;\n  private readonly subAgentReferenceNamesById: Record<string, string>;\n  private readonly subAgentReferencePathsById: Record<string, string>;\n  private readonly agentReferenceNamesById: Record<string, string>;\n  private readonly agentReferencePathsById: Record<string, string>;\n\n  constructor({\n    project,\n    projectRoot,\n    completeAgentIds,\n    existingComponentRegistry,\n  }: GenerationResolverOptions) {\n    this.projectRoot = projectRoot;\n    this.existingComponentRegistry = existingComponentRegistry;\n    this.toolReferenceNamesById = buildToolReferenceNamesById(project);\n    this.toolReferencePathsById = buildToolReferencePathById(project);\n    this.credentialReferenceNamesById = buildCredentialReferenceNamesById(project);\n    this.credentialReferencePathsById = buildCredentialReferencePathById(project);\n    this.externalAgentReferenceNamesById = buildExternalAgentReferenceNamesById(project);\n    this.externalAgentReferencePathsById = buildExternalAgentReferencePathById(project);\n    this.subAgentReferenceNamesById = buildSubAgentReferenceNamesById(project, completeAgentIds);\n    this.subAgentReferencePathsById = buildSubAgentReferencePathById(project, completeAgentIds);\n    this.agentReferenceNamesById = buildAgentReferenceNamesById(project);\n    this.agentReferencePathsById = buildAgentReferencePathById(project);\n  }\n\n  getExistingComponent(id: string, type: ComponentType): ComponentInfo | undefined {\n    return this.existingComponentRegistry?.get(id, type);\n  }\n\n  resolveOutputFilePath(\n    componentType: ComponentType,\n    componentId: string,\n    fallbackFilePath: string\n  ): string {\n    const existingComponent = this.getExistingComponent(componentId, componentType);\n    if (!existingComponent?.filePath) {\n      return fallbackFilePath;\n    }\n\n    return resolveProjectFilePath(this.projectRoot, existingComponent.filePath);\n  }\n\n  getToolReferenceName(toolId: string): string | undefined {\n    return this.getPreferredReferenceName(\n      toolId,\n      ['functionTools', 'tools'],\n      this.toolReferenceNamesById\n    );\n  }\n\n  getToolReferencePath(toolId: string): string | undefined {\n    const existingTool =\n      this.getExistingComponent(toolId, 'functionTools') ??\n      this.getExistingComponent(toolId, 'tools');\n    if (existingTool?.filePath) {\n      return resolveToolModulePath(existingTool.filePath);\n    }\n\n    return this.toolReferencePathsById[toolId];\n  }\n\n  getCredentialReferenceName(credentialId: string): string | undefined {\n    return this.getPreferredReferenceName(\n      credentialId,\n      ['credentials'],\n      this.credentialReferenceNamesById\n    );\n  }\n\n  getCredentialReferencePath(credentialId: string): string | undefined {\n    return this.getPreferredReferencePath(\n      credentialId,\n      ['credentials'],\n      this.credentialReferencePathsById\n    );\n  }\n\n  getExternalAgentReferenceName(externalAgentId: string): string | undefined {\n    return this.getPreferredReferenceName(\n      externalAgentId,\n      ['externalAgents'],\n      this.externalAgentReferenceNamesById\n    );\n  }\n\n  getExternalAgentReferencePath(externalAgentId: string): string | undefined {\n    return this.getPreferredReferencePath(\n      externalAgentId,\n      ['externalAgents'],\n      this.externalAgentReferencePathsById\n    );\n  }\n\n  getSubAgentReferenceName(subAgentId: string): string | undefined {\n    return this.getPreferredReferenceName(\n      subAgentId,\n      ['subAgents'],\n      this.subAgentReferenceNamesById\n    );\n  }\n\n  getSubAgentReferencePath(subAgentId: string): string | undefined {\n    return this.getPreferredReferencePath(\n      subAgentId,\n      ['subAgents'],\n      this.subAgentReferencePathsById\n    );\n  }\n\n  getAgentReferenceName(agentId: string): string | undefined {\n    return this.getPreferredReferenceName(agentId, ['agents'], this.agentReferenceNamesById);\n  }\n\n  getAgentReferencePath(agentId: string): string | undefined {\n    return this.getPreferredReferencePath(agentId, ['agents'], this.agentReferencePathsById);\n  }\n\n  private getPreferredReferenceName(\n    componentId: string,\n    componentTypes: ComponentType[],\n    generatedNamesById: Record<string, string>\n  ): string | undefined {\n    const existingComponent = this.getExistingComponentByTypes(componentId, componentTypes);\n    if (existingComponent?.name) {\n      return existingComponent.name;\n    }\n\n    return generatedNamesById[componentId];\n  }\n\n  private getPreferredReferencePath(\n    componentId: string,\n    componentTypes: ComponentType[],\n    generatedPathsById: Record<string, string>\n  ): string | undefined {\n    const existingComponent = this.getExistingComponentByTypes(componentId, componentTypes);\n    if (existingComponent?.filePath) {\n      return stripExtension(basename(existingComponent.filePath));\n    }\n\n    return generatedPathsById[componentId];\n  }\n\n  private getExistingComponentByTypes(\n    componentId: string,\n    componentTypes: ComponentType[]\n  ): ComponentInfo | undefined {\n    for (const componentType of componentTypes) {\n      const component = this.getExistingComponent(componentId, componentType);\n      if (component) {\n        return component;\n      }\n    }\n\n    return;\n  }\n}\n\nexport function collectFunctionToolEntries(project: FullProjectDefinition): FunctionToolEntry[] {\n  const functionToolsById = collectFunctionToolsById(project);\n  const functionsById = collectFunctionsById(project);\n  const entries: FunctionToolEntry[] = [];\n\n  for (const [functionToolId, functionToolData] of Object.entries(functionToolsById)) {\n    const functionId =\n      typeof functionToolData.functionId === 'string' && functionToolData.functionId.length > 0\n        ? functionToolData.functionId\n        : functionToolId;\n    const functionData = functionsById[functionId] ?? {};\n    const functionToolName =\n      typeof functionToolData.name === 'string' && functionToolData.name.length > 0\n        ? functionToolData.name\n        : undefined;\n    const functionName =\n      typeof functionData.name === 'string' && functionData.name.length > 0\n        ? functionData.name\n        : undefined;\n    const fallbackName = functionToolName ?? functionName ?? functionToolId;\n\n    entries.push({\n      functionToolId,\n      functionId,\n      functionToolData,\n      functionData,\n      exportName: fallbackName,\n      fileName: fallbackName,\n    });\n  }\n\n  return entries;\n}\n\nfunction collectFunctionToolsById(\n  project: FullProjectDefinition\n): Record<string, Record<string, unknown>> {\n  const functionToolsById: Record<string, Record<string, unknown>> = {};\n\n  for (const [functionToolId, functionToolData] of Object.entries(project.functionTools ?? {})) {\n    const functionToolRecord = asRecord(functionToolData);\n    if (!functionToolRecord) {\n      continue;\n    }\n\n    functionToolsById[functionToolId] = {\n      ...functionToolRecord,\n    };\n  }\n\n  for (const agentData of Object.values(project.agents ?? {})) {\n    const agentRecord = asRecord(agentData);\n    const agentFunctionTools = asRecord(agentRecord?.functionTools);\n    if (!agentFunctionTools) {\n      continue;\n    }\n\n    for (const [functionToolId, functionToolData] of Object.entries(agentFunctionTools)) {\n      const functionToolRecord = asRecord(functionToolData);\n      if (!functionToolRecord) {\n        continue;\n      }\n\n      const existingFunctionTool = functionToolsById[functionToolId] ?? {};\n      functionToolsById[functionToolId] = {\n        ...functionToolRecord,\n        ...existingFunctionTool,\n      };\n    }\n  }\n\n  return functionToolsById;\n}\n\nfunction collectFunctionsById(\n  project: FullProjectDefinition\n): Record<string, Record<string, unknown>> {\n  const functionsById: Record<string, Record<string, unknown>> = {};\n\n  for (const [functionId, functionData] of Object.entries(project.functions ?? {})) {\n    const functionRecord = asRecord(functionData);\n    if (!functionRecord) {\n      continue;\n    }\n\n    functionsById[functionId] = {\n      ...functionRecord,\n    };\n  }\n\n  for (const agentData of Object.values(project.agents ?? {})) {\n    const agentRecord = asRecord(agentData);\n    const agentFunctions = asRecord(agentRecord?.functions);\n    if (!agentFunctions) {\n      continue;\n    }\n\n    for (const [functionId, functionData] of Object.entries(agentFunctions)) {\n      const functionRecord = asRecord(functionData);\n      if (!functionRecord) {\n        continue;\n      }\n\n      const existingFunction = functionsById[functionId] ?? {};\n      functionsById[functionId] = {\n        ...functionRecord,\n        ...existingFunction,\n      };\n    }\n  }\n\n  return functionsById;\n}\n\nfunction buildToolReferenceNamesById(project: FullProjectDefinition): Record<string, string> {\n  const toolReferenceNamesById: Record<string, string> = {};\n\n  for (const [toolId, toolData] of Object.entries(project.tools ?? {})) {\n    const toolName = asRecord(toolData)?.name;\n    const referenceName =\n      typeof toolName === 'string' && toolName.length > 0\n        ? toToolReferenceName(toolName)\n        : toToolReferenceName(toolId);\n    toolReferenceNamesById[toolId] = referenceName;\n  }\n\n  for (const functionToolEntry of collectFunctionToolEntries(project)) {\n    toolReferenceNamesById[functionToolEntry.functionToolId] = toToolReferenceName(\n      functionToolEntry.exportName\n    );\n  }\n\n  return toolReferenceNamesById;\n}\n\nfunction buildToolReferencePathById(project: FullProjectDefinition): Record<string, string> {\n  const toolEntries = Object.entries(project.tools ?? {});\n  const toolFileNamesById = buildSequentialNameFileNames(toolEntries);\n  const toolReferencePathById: Record<string, string> = {};\n\n  for (const [toolId] of toolEntries) {\n    toolReferencePathById[toolId] = stripExtension(toolFileNamesById[toolId]);\n  }\n\n  const functionToolEntries = collectFunctionToolEntries(project);\n  const functionToolFileNamesById = buildSequentialNameFileNames(\n    functionToolEntries.map(({ functionToolId, fileName }) => [functionToolId, { name: fileName }])\n  );\n  for (const { functionToolId } of functionToolEntries) {\n    toolReferencePathById[functionToolId] = stripExtension(\n      functionToolFileNamesById[functionToolId]\n    );\n  }\n\n  return toolReferencePathById;\n}\n\nfunction buildCredentialReferenceNamesById(project: FullProjectDefinition): Record<string, string> {\n  const credentialReferenceNamesById: Record<string, string> = {};\n  const countsByReferenceName = new Map<string, number>();\n\n  for (const [credentialId, credentialData] of Object.entries(project.credentialReferences ?? {})) {\n    const credentialName = asRecord(credentialData)?.name;\n    const baseReferenceName =\n      typeof credentialName === 'string' && credentialName.length > 0\n        ? toCredentialReferenceName(credentialName)\n        : toCredentialReferenceName(credentialId);\n    const occurrence = countsByReferenceName.get(baseReferenceName) ?? 0;\n    countsByReferenceName.set(baseReferenceName, occurrence + 1);\n    credentialReferenceNamesById[credentialId] =\n      occurrence === 0 ? baseReferenceName : `${baseReferenceName}${occurrence}`;\n  }\n\n  return credentialReferenceNamesById;\n}\n\nfunction buildCredentialReferencePathById(project: FullProjectDefinition): Record<string, string> {\n  const credentialEntries = Object.entries(project.credentialReferences ?? {});\n  const credentialFileNamesById = buildSequentialNameFileNames(credentialEntries);\n  const credentialReferencePathById: Record<string, string> = {};\n\n  for (const [credentialId] of credentialEntries) {\n    credentialReferencePathById[credentialId] = stripExtension(\n      credentialFileNamesById[credentialId]\n    );\n  }\n\n  return credentialReferencePathById;\n}\n\nfunction buildExternalAgentReferenceNamesById(\n  project: FullProjectDefinition\n): Record<string, string> {\n  const externalAgentReferenceNamesById: Record<string, string> = {};\n  const countsByReferenceName = new Map<string, number>();\n\n  for (const [externalAgentId, externalAgentData] of Object.entries(project.externalAgents ?? {})) {\n    const baseReferenceName = toExternalAgentReferenceName(\n      resolveExternalAgentNamingSeed(externalAgentId, externalAgentData)\n    );\n    const occurrence = countsByReferenceName.get(baseReferenceName) ?? 0;\n    countsByReferenceName.set(baseReferenceName, occurrence + 1);\n    externalAgentReferenceNamesById[externalAgentId] =\n      occurrence === 0 ? baseReferenceName : `${baseReferenceName}${occurrence}`;\n  }\n\n  return externalAgentReferenceNamesById;\n}\n\nfunction buildExternalAgentReferencePathById(\n  project: FullProjectDefinition\n): Record<string, string> {\n  const externalAgentEntries = Object.entries(project.externalAgents ?? {}).map(\n    ([externalAgentId, externalAgentData]) =>\n      [\n        externalAgentId,\n        { name: resolveExternalAgentNamingSeed(externalAgentId, externalAgentData) },\n      ] as [string, { name: string }]\n  );\n  const externalAgentFileNamesById = buildSequentialNameFileNames(externalAgentEntries);\n  const externalAgentReferencePathById: Record<string, string> = {};\n\n  for (const [externalAgentId] of externalAgentEntries) {\n    externalAgentReferencePathById[externalAgentId] = stripExtension(\n      externalAgentFileNamesById[externalAgentId]\n    );\n  }\n\n  return externalAgentReferencePathById;\n}\n\nfunction buildSubAgentReferenceNamesById(\n  project: FullProjectDefinition,\n  agentIds?: Iterable<string>\n): Record<string, string> {\n  const subAgentReferenceNamesById: Record<string, string> = {};\n  const candidateAgentIds =\n    agentIds !== undefined ? [...agentIds] : Object.keys(project.agents ?? {});\n  for (const agentId of candidateAgentIds) {\n    const agentData = project.agents?.[agentId];\n    const subAgents = asRecord(agentData?.subAgents);\n    if (!subAgents) {\n      continue;\n    }\n\n    for (const [subAgentId, subAgentData] of Object.entries(subAgents)) {\n      const subAgentName = asRecord(subAgentData)?.name;\n      subAgentReferenceNamesById[subAgentId] = resolveSubAgentVariableName(\n        subAgentId,\n        typeof subAgentName === 'string' ? subAgentName : undefined\n      );\n    }\n  }\n\n  return subAgentReferenceNamesById;\n}\n\nfunction buildSubAgentReferencePathById(\n  project: FullProjectDefinition,\n  agentIds?: Iterable<string>\n): Record<string, string> {\n  const subAgentReferencePathById: Record<string, string> = {};\n  const candidateAgentIds =\n    agentIds !== undefined ? [...agentIds] : Object.keys(project.agents ?? {});\n  for (const agentId of candidateAgentIds) {\n    const agentData = project.agents?.[agentId];\n    const subAgents = asRecord(agentData?.subAgents);\n    if (!subAgents) {\n      continue;\n    }\n\n    for (const [subAgentId, subAgentData] of Object.entries(subAgents)) {\n      const subAgentName = asRecord(subAgentData)?.name;\n      subAgentReferencePathById[subAgentId] = stripExtension(\n        buildComponentFileName(\n          subAgentId,\n          typeof subAgentName === 'string' ? subAgentName : undefined\n        )\n      );\n    }\n  }\n\n  return subAgentReferencePathById;\n}\n\nfunction buildAgentReferenceNamesById(project: FullProjectDefinition): Record<string, string> {\n  const agentReferenceNamesById: Record<string, string> = {};\n  for (const agentId of Object.keys(project.agents ?? {})) {\n    agentReferenceNamesById[agentId] = toCamelCase(agentId);\n  }\n  return agentReferenceNamesById;\n}\n\nfunction buildAgentReferencePathById(project: FullProjectDefinition): Record<string, string> {\n  const agentReferencePathById: Record<string, string> = {};\n  for (const [agentId, agentData] of Object.entries(project.agents ?? {})) {\n    const agentName = asRecord(agentData)?.name;\n    agentReferencePathById[agentId] = stripExtension(\n      buildComponentFileName(agentId, typeof agentName === 'string' ? agentName : undefined)\n    );\n  }\n  return agentReferencePathById;\n}\n\nfunction toExternalAgentReferenceName(input: string): string {\n  const base = toCamelCase(input);\n  return base.endsWith('Agent') ? base : `${base}Agent`;\n}\n\nexport function resolveExternalAgentNamingSeed(\n  externalAgentId: string,\n  externalAgentData: unknown\n): string {\n  if (isHumanReadableId(externalAgentId)) {\n    return externalAgentId;\n  }\n\n  const externalAgentName = asRecord(externalAgentData)?.name;\n  if (typeof externalAgentName === 'string' && externalAgentName.length > 0) {\n    return externalAgentName;\n  }\n\n  return externalAgentId;\n}\n\nexport function resolveToolModulePath(filePath: string): string {\n  const normalizedFilePath = normalizeFilePath(filePath);\n  const toolsSegment = '/tools/';\n  const toolsIndex = normalizedFilePath.lastIndexOf(toolsSegment);\n  if (toolsIndex >= 0) {\n    let modulePath = stripExtension(normalizedFilePath.slice(toolsIndex + toolsSegment.length));\n    if (modulePath.endsWith('/index')) {\n      modulePath = modulePath.slice(0, -'/index'.length);\n    }\n    if (modulePath.length > 0) {\n      return modulePath;\n    }\n  }\n\n  const baseModulePath = stripExtension(basename(normalizedFilePath));\n  if (baseModulePath === 'index') {\n    return stripExtension(basename(dirname(normalizedFilePath)));\n  }\n  return baseModulePath;\n}\n\nexport function resolveProjectFilePath(projectRoot: string, filePath: string): string {\n  if (filePath.startsWith('/')) {\n    return filePath;\n  }\n  return join(projectRoot, filePath);\n}\n\nexport function normalizeFilePath(filePath: string): string {\n  return filePath.replaceAll('\\\\', '/');\n}\n\nexport function buildSequentialNameFileNames(\n  entries: Array<[string, unknown]>\n): Record<string, string> {\n  const countsByStem = new Map<string, number>();\n  const fileNamesById: Record<string, string> = {};\n\n  for (const [componentId, componentData] of entries) {\n    const name = asRecord(componentData)?.name;\n    const baseStem = resolveNameFileStem(componentId, typeof name === 'string' ? name : undefined);\n    const occurrence = countsByStem.get(baseStem) ?? 0;\n    countsByStem.set(baseStem, occurrence + 1);\n\n    const stem = occurrence === 0 ? baseStem : `${baseStem}-${occurrence}`;\n    fileNamesById[componentId] = `${stem}.ts`;\n  }\n\n  return fileNamesById;\n}\n\nfunction resolveNameFileStem(componentId: string, name: string | undefined): string {\n  const nameStem = name ? toKebabCase(name) : '';\n  if (nameStem.length > 0) {\n    return nameStem;\n  }\n\n  const idStem = toKebabCase(componentId);\n  if (idStem.length > 0) {\n    return idStem;\n  }\n\n  return componentId;\n}\n"],"mappings":";;;;;;;AA8BA,IAAa,qBAAb,MAAgC;CAC9B,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,EACV,SACA,aACA,kBACA,6BAC4B;AAC5B,OAAK,cAAc;AACnB,OAAK,4BAA4B;AACjC,OAAK,yBAAyB,4BAA4B,QAAQ;AAClE,OAAK,yBAAyB,2BAA2B,QAAQ;AACjE,OAAK,+BAA+B,kCAAkC,QAAQ;AAC9E,OAAK,+BAA+B,iCAAiC,QAAQ;AAC7E,OAAK,kCAAkC,qCAAqC,QAAQ;AACpF,OAAK,kCAAkC,oCAAoC,QAAQ;AACnF,OAAK,6BAA6B,gCAAgC,SAAS,iBAAiB;AAC5F,OAAK,6BAA6B,+BAA+B,SAAS,iBAAiB;AAC3F,OAAK,0BAA0B,6BAA6B,QAAQ;AACpE,OAAK,0BAA0B,4BAA4B,QAAQ;;CAGrE,qBAAqB,IAAY,MAAgD;AAC/E,SAAO,KAAK,2BAA2B,IAAI,IAAI,KAAK;;CAGtD,sBACE,eACA,aACA,kBACQ;EACR,MAAM,oBAAoB,KAAK,qBAAqB,aAAa,cAAc;AAC/E,MAAI,CAAC,mBAAmB,SACtB,QAAO;AAGT,SAAO,uBAAuB,KAAK,aAAa,kBAAkB,SAAS;;CAG7E,qBAAqB,QAAoC;AACvD,SAAO,KAAK,0BACV,QACA,CAAC,iBAAiB,QAAQ,EAC1B,KAAK,uBACN;;CAGH,qBAAqB,QAAoC;EACvD,MAAM,eACJ,KAAK,qBAAqB,QAAQ,gBAAgB,IAClD,KAAK,qBAAqB,QAAQ,QAAQ;AAC5C,MAAI,cAAc,SAChB,QAAO,sBAAsB,aAAa,SAAS;AAGrD,SAAO,KAAK,uBAAuB;;CAGrC,2BAA2B,cAA0C;AACnE,SAAO,KAAK,0BACV,cACA,CAAC,cAAc,EACf,KAAK,6BACN;;CAGH,2BAA2B,cAA0C;AACnE,SAAO,KAAK,0BACV,cACA,CAAC,cAAc,EACf,KAAK,6BACN;;CAGH,8BAA8B,iBAA6C;AACzE,SAAO,KAAK,0BACV,iBACA,CAAC,iBAAiB,EAClB,KAAK,gCACN;;CAGH,8BAA8B,iBAA6C;AACzE,SAAO,KAAK,0BACV,iBACA,CAAC,iBAAiB,EAClB,KAAK,gCACN;;CAGH,yBAAyB,YAAwC;AAC/D,SAAO,KAAK,0BACV,YACA,CAAC,YAAY,EACb,KAAK,2BACN;;CAGH,yBAAyB,YAAwC;AAC/D,SAAO,KAAK,0BACV,YACA,CAAC,YAAY,EACb,KAAK,2BACN;;CAGH,sBAAsB,SAAqC;AACzD,SAAO,KAAK,0BAA0B,SAAS,CAAC,SAAS,EAAE,KAAK,wBAAwB;;CAG1F,sBAAsB,SAAqC;AACzD,SAAO,KAAK,0BAA0B,SAAS,CAAC,SAAS,EAAE,KAAK,wBAAwB;;CAG1F,AAAQ,0BACN,aACA,gBACA,oBACoB;EACpB,MAAM,oBAAoB,KAAK,4BAA4B,aAAa,eAAe;AACvF,MAAI,mBAAmB,KACrB,QAAO,kBAAkB;AAG3B,SAAO,mBAAmB;;CAG5B,AAAQ,0BACN,aACA,gBACA,oBACoB;EACpB,MAAM,oBAAoB,KAAK,4BAA4B,aAAa,eAAe;AACvF,MAAI,mBAAmB,SACrB,QAAO,eAAe,SAAS,kBAAkB,SAAS,CAAC;AAG7D,SAAO,mBAAmB;;CAG5B,AAAQ,4BACN,aACA,gBAC2B;AAC3B,OAAK,MAAM,iBAAiB,gBAAgB;GAC1C,MAAM,YAAY,KAAK,qBAAqB,aAAa,cAAc;AACvE,OAAI,UACF,QAAO;;;;AAQf,SAAgB,2BAA2B,SAAqD;CAC9F,MAAM,oBAAoB,yBAAyB,QAAQ;CAC3D,MAAM,gBAAgB,qBAAqB,QAAQ;CACnD,MAAM,UAA+B,EAAE;AAEvC,MAAK,MAAM,CAAC,gBAAgB,qBAAqB,OAAO,QAAQ,kBAAkB,EAAE;EAClF,MAAM,aACJ,OAAO,iBAAiB,eAAe,YAAY,iBAAiB,WAAW,SAAS,IACpF,iBAAiB,aACjB;EACN,MAAM,eAAe,cAAc,eAAe,EAAE;EACpD,MAAM,mBACJ,OAAO,iBAAiB,SAAS,YAAY,iBAAiB,KAAK,SAAS,IACxE,iBAAiB,OACjB;EACN,MAAM,eACJ,OAAO,aAAa,SAAS,YAAY,aAAa,KAAK,SAAS,IAChE,aAAa,OACb;EACN,MAAM,eAAe,oBAAoB,gBAAgB;AAEzD,UAAQ,KAAK;GACX;GACA;GACA;GACA;GACA,YAAY;GACZ,UAAU;GACX,CAAC;;AAGJ,QAAO;;AAGT,SAAS,yBACP,SACyC;CACzC,MAAM,oBAA6D,EAAE;AAErE,MAAK,MAAM,CAAC,gBAAgB,qBAAqB,OAAO,QAAQ,QAAQ,iBAAiB,EAAE,CAAC,EAAE;EAC5F,MAAM,qBAAqB,SAAS,iBAAiB;AACrD,MAAI,CAAC,mBACH;AAGF,oBAAkB,kBAAkB,EAClC,GAAG,oBACJ;;AAGH,MAAK,MAAM,aAAa,OAAO,OAAO,QAAQ,UAAU,EAAE,CAAC,EAAE;EAE3D,MAAM,qBAAqB,SADP,SAAS,UAAU,EACU,cAAc;AAC/D,MAAI,CAAC,mBACH;AAGF,OAAK,MAAM,CAAC,gBAAgB,qBAAqB,OAAO,QAAQ,mBAAmB,EAAE;GACnF,MAAM,qBAAqB,SAAS,iBAAiB;AACrD,OAAI,CAAC,mBACH;GAGF,MAAM,uBAAuB,kBAAkB,mBAAmB,EAAE;AACpE,qBAAkB,kBAAkB;IAClC,GAAG;IACH,GAAG;IACJ;;;AAIL,QAAO;;AAGT,SAAS,qBACP,SACyC;CACzC,MAAM,gBAAyD,EAAE;AAEjE,MAAK,MAAM,CAAC,YAAY,iBAAiB,OAAO,QAAQ,QAAQ,aAAa,EAAE,CAAC,EAAE;EAChF,MAAM,iBAAiB,SAAS,aAAa;AAC7C,MAAI,CAAC,eACH;AAGF,gBAAc,cAAc,EAC1B,GAAG,gBACJ;;AAGH,MAAK,MAAM,aAAa,OAAO,OAAO,QAAQ,UAAU,EAAE,CAAC,EAAE;EAE3D,MAAM,iBAAiB,SADH,SAAS,UAAU,EACM,UAAU;AACvD,MAAI,CAAC,eACH;AAGF,OAAK,MAAM,CAAC,YAAY,iBAAiB,OAAO,QAAQ,eAAe,EAAE;GACvE,MAAM,iBAAiB,SAAS,aAAa;AAC7C,OAAI,CAAC,eACH;GAGF,MAAM,mBAAmB,cAAc,eAAe,EAAE;AACxD,iBAAc,cAAc;IAC1B,GAAG;IACH,GAAG;IACJ;;;AAIL,QAAO;;AAGT,SAAS,4BAA4B,SAAwD;CAC3F,MAAM,yBAAiD,EAAE;AAEzD,MAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QAAQ,QAAQ,SAAS,EAAE,CAAC,EAAE;EACpE,MAAM,WAAW,SAAS,SAAS,EAAE;AAKrC,yBAAuB,UAHrB,OAAO,aAAa,YAAY,SAAS,SAAS,IAC9C,oBAAoB,SAAS,GAC7B,oBAAoB,OAAO;;AAInC,MAAK,MAAM,qBAAqB,2BAA2B,QAAQ,CACjE,wBAAuB,kBAAkB,kBAAkB,oBACzD,kBAAkB,WACnB;AAGH,QAAO;;AAGT,SAAS,2BAA2B,SAAwD;CAC1F,MAAM,cAAc,OAAO,QAAQ,QAAQ,SAAS,EAAE,CAAC;CACvD,MAAM,oBAAoB,6BAA6B,YAAY;CACnE,MAAM,wBAAgD,EAAE;AAExD,MAAK,MAAM,CAAC,WAAW,YACrB,uBAAsB,UAAU,eAAe,kBAAkB,QAAQ;CAG3E,MAAM,sBAAsB,2BAA2B,QAAQ;CAC/D,MAAM,4BAA4B,6BAChC,oBAAoB,KAAK,EAAE,gBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,UAAU,CAAC,CAAC,CAChG;AACD,MAAK,MAAM,EAAE,oBAAoB,oBAC/B,uBAAsB,kBAAkB,eACtC,0BAA0B,gBAC3B;AAGH,QAAO;;AAGT,SAAS,kCAAkC,SAAwD;CACjG,MAAM,+BAAuD,EAAE;CAC/D,MAAM,wCAAwB,IAAI,KAAqB;AAEvD,MAAK,MAAM,CAAC,cAAc,mBAAmB,OAAO,QAAQ,QAAQ,wBAAwB,EAAE,CAAC,EAAE;EAC/F,MAAM,iBAAiB,SAAS,eAAe,EAAE;EACjD,MAAM,oBACJ,OAAO,mBAAmB,YAAY,eAAe,SAAS,IAC1D,0BAA0B,eAAe,GACzC,0BAA0B,aAAa;EAC7C,MAAM,aAAa,sBAAsB,IAAI,kBAAkB,IAAI;AACnE,wBAAsB,IAAI,mBAAmB,aAAa,EAAE;AAC5D,+BAA6B,gBAC3B,eAAe,IAAI,oBAAoB,GAAG,oBAAoB;;AAGlE,QAAO;;AAGT,SAAS,iCAAiC,SAAwD;CAChG,MAAM,oBAAoB,OAAO,QAAQ,QAAQ,wBAAwB,EAAE,CAAC;CAC5E,MAAM,0BAA0B,6BAA6B,kBAAkB;CAC/E,MAAM,8BAAsD,EAAE;AAE9D,MAAK,MAAM,CAAC,iBAAiB,kBAC3B,6BAA4B,gBAAgB,eAC1C,wBAAwB,cACzB;AAGH,QAAO;;AAGT,SAAS,qCACP,SACwB;CACxB,MAAM,kCAA0D,EAAE;CAClE,MAAM,wCAAwB,IAAI,KAAqB;AAEvD,MAAK,MAAM,CAAC,iBAAiB,sBAAsB,OAAO,QAAQ,QAAQ,kBAAkB,EAAE,CAAC,EAAE;EAC/F,MAAM,oBAAoB,6BACxB,+BAA+B,iBAAiB,kBAAkB,CACnE;EACD,MAAM,aAAa,sBAAsB,IAAI,kBAAkB,IAAI;AACnE,wBAAsB,IAAI,mBAAmB,aAAa,EAAE;AAC5D,kCAAgC,mBAC9B,eAAe,IAAI,oBAAoB,GAAG,oBAAoB;;AAGlE,QAAO;;AAGT,SAAS,oCACP,SACwB;CACxB,MAAM,uBAAuB,OAAO,QAAQ,QAAQ,kBAAkB,EAAE,CAAC,CAAC,KACvE,CAAC,iBAAiB,uBACjB,CACE,iBACA,EAAE,MAAM,+BAA+B,iBAAiB,kBAAkB,EAAE,CAC7E,CACJ;CACD,MAAM,6BAA6B,6BAA6B,qBAAqB;CACrF,MAAM,iCAAyD,EAAE;AAEjE,MAAK,MAAM,CAAC,oBAAoB,qBAC9B,gCAA+B,mBAAmB,eAChD,2BAA2B,iBAC5B;AAGH,QAAO;;AAGT,SAAS,gCACP,SACA,UACwB;CACxB,MAAM,6BAAqD,EAAE;CAC7D,MAAM,oBACJ,aAAa,SAAY,CAAC,GAAG,SAAS,GAAG,OAAO,KAAK,QAAQ,UAAU,EAAE,CAAC;AAC5E,MAAK,MAAM,WAAW,mBAAmB;EACvC,MAAM,YAAY,QAAQ,SAAS;EACnC,MAAM,YAAY,SAAS,WAAW,UAAU;AAChD,MAAI,CAAC,UACH;AAGF,OAAK,MAAM,CAAC,YAAY,iBAAiB,OAAO,QAAQ,UAAU,EAAE;GAClE,MAAM,eAAe,SAAS,aAAa,EAAE;AAC7C,8BAA2B,cAAc,4BACvC,YACA,OAAO,iBAAiB,WAAW,eAAe,OACnD;;;AAIL,QAAO;;AAGT,SAAS,+BACP,SACA,UACwB;CACxB,MAAM,4BAAoD,EAAE;CAC5D,MAAM,oBACJ,aAAa,SAAY,CAAC,GAAG,SAAS,GAAG,OAAO,KAAK,QAAQ,UAAU,EAAE,CAAC;AAC5E,MAAK,MAAM,WAAW,mBAAmB;EACvC,MAAM,YAAY,QAAQ,SAAS;EACnC,MAAM,YAAY,SAAS,WAAW,UAAU;AAChD,MAAI,CAAC,UACH;AAGF,OAAK,MAAM,CAAC,YAAY,iBAAiB,OAAO,QAAQ,UAAU,EAAE;GAClE,MAAM,eAAe,SAAS,aAAa,EAAE;AAC7C,6BAA0B,cAAc,eACtC,uBACE,YACA,OAAO,iBAAiB,WAAW,eAAe,OACnD,CACF;;;AAIL,QAAO;;AAGT,SAAS,6BAA6B,SAAwD;CAC5F,MAAM,0BAAkD,EAAE;AAC1D,MAAK,MAAM,WAAW,OAAO,KAAK,QAAQ,UAAU,EAAE,CAAC,CACrD,yBAAwB,WAAW,YAAY,QAAQ;AAEzD,QAAO;;AAGT,SAAS,4BAA4B,SAAwD;CAC3F,MAAM,yBAAiD,EAAE;AACzD,MAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQ,QAAQ,UAAU,EAAE,CAAC,EAAE;EACvE,MAAM,YAAY,SAAS,UAAU,EAAE;AACvC,yBAAuB,WAAW,eAChC,uBAAuB,SAAS,OAAO,cAAc,WAAW,YAAY,OAAU,CACvF;;AAEH,QAAO;;AAGT,SAAS,6BAA6B,OAAuB;CAC3D,MAAM,OAAO,YAAY,MAAM;AAC/B,QAAO,KAAK,SAAS,QAAQ,GAAG,OAAO,GAAG,KAAK;;AAGjD,SAAgB,+BACd,iBACA,mBACQ;AACR,KAAI,kBAAkB,gBAAgB,CACpC,QAAO;CAGT,MAAM,oBAAoB,SAAS,kBAAkB,EAAE;AACvD,KAAI,OAAO,sBAAsB,YAAY,kBAAkB,SAAS,EACtE,QAAO;AAGT,QAAO;;AAGT,SAAgB,sBAAsB,UAA0B;CAC9D,MAAM,qBAAqB,kBAAkB,SAAS;CAEtD,MAAM,aAAa,mBAAmB,YADjB,UAC0C;AAC/D,KAAI,cAAc,GAAG;EACnB,IAAI,aAAa,eAAe,mBAAmB,MAAM,aAAa,EAAoB,CAAC;AAC3F,MAAI,WAAW,SAAS,SAAS,CAC/B,cAAa,WAAW,MAAM,GAAG,GAAiB;AAEpD,MAAI,WAAW,SAAS,EACtB,QAAO;;CAIX,MAAM,iBAAiB,eAAe,SAAS,mBAAmB,CAAC;AACnE,KAAI,mBAAmB,QACrB,QAAO,eAAe,SAAS,QAAQ,mBAAmB,CAAC,CAAC;AAE9D,QAAO;;AAGT,SAAgB,uBAAuB,aAAqB,UAA0B;AACpF,KAAI,SAAS,WAAW,IAAI,CAC1B,QAAO;AAET,QAAO,KAAK,aAAa,SAAS;;AAGpC,SAAgB,kBAAkB,UAA0B;AAC1D,QAAO,SAAS,WAAW,MAAM,IAAI;;AAGvC,SAAgB,6BACd,SACwB;CACxB,MAAM,+BAAe,IAAI,KAAqB;CAC9C,MAAM,gBAAwC,EAAE;AAEhD,MAAK,MAAM,CAAC,aAAa,kBAAkB,SAAS;EAClD,MAAM,OAAO,SAAS,cAAc,EAAE;EACtC,MAAM,WAAW,oBAAoB,aAAa,OAAO,SAAS,WAAW,OAAO,OAAU;EAC9F,MAAM,aAAa,aAAa,IAAI,SAAS,IAAI;AACjD,eAAa,IAAI,UAAU,aAAa,EAAE;AAG1C,gBAAc,eAAe,GADhB,eAAe,IAAI,WAAW,GAAG,SAAS,GAAG,aACrB;;AAGvC,QAAO;;AAGT,SAAS,oBAAoB,aAAqB,MAAkC;CAClF,MAAM,WAAW,OAAO,YAAY,KAAK,GAAG;AAC5C,KAAI,SAAS,SAAS,EACpB,QAAO;CAGT,MAAM,SAAS,YAAY,YAAY;AACvC,KAAI,OAAO,SAAS,EAClB,QAAO;AAGT,QAAO"}

package/dist/commands/pull-v4/generation-types.js

@@ -0,0 +1,56 @@
+import { asRecord } from "./collector-common.js";
+
+//#region src/commands/pull-v4/generation-types.ts
+function collectCompleteAgentIds(project, skippedAgents) {
+	const completeAgentIds = /* @__PURE__ */ new Set();
+	for (const [agentId, agentData] of Object.entries(project.agents ?? {})) {
+		const completeness = isAgentComplete(agentData);
+		if (!completeness.complete) {
+			skippedAgents.push({
+				id: agentId,
+				reason: completeness.reason ?? "incomplete"
+			});
+			continue;
+		}
+		completeAgentIds.add(agentId);
+	}
+	return completeAgentIds;
+}
+function isAgentComplete(agentData) {
+	const data = asRecord(agentData);
+	if (!data) return {
+		complete: false,
+		reason: "invalid agent object"
+	};
+	if (!data.name || typeof data.name !== "string") return {
+		complete: false,
+		reason: "missing name"
+	};
+	if (!data.defaultSubAgentId || typeof data.defaultSubAgentId !== "string") return {
+		complete: false,
+		reason: "missing defaultSubAgentId"
+	};
+	const subAgents = asRecord(data.subAgents);
+	if (!subAgents || !Object.keys(subAgents).length) return {
+		complete: false,
+		reason: "no sub-agents defined"
+	};
+	return { complete: true };
+}
+function validateProject(project) {
+	if (!project || typeof project !== "object") throw new Error("Project data is required");
+	if (!project.id) throw new Error("Project id is required");
+	if (!project.name) throw new Error("Project name is required");
+}
+function assignComponentReferenceOverrideForProject(registry, overrides, overrideType, componentId, componentType) {
+	const component = registry.get(componentId, componentType);
+	if (!component?.name) return false;
+	const overrideMap = overrides[overrideType] ?? {};
+	overrideMap[componentId] = component.name;
+	overrides[overrideType] = overrideMap;
+	return true;
+}
+
+//#endregion
+export { assignComponentReferenceOverrideForProject, collectCompleteAgentIds, validateProject };
+//# sourceMappingURL=generation-types.js.map

package/dist/commands/pull-v4/generation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-types.js","names":[],"sources":["../../../src/commands/pull-v4/generation-types.ts"],"sourcesContent":["import type { FullProjectDefinition } from '@inkeep/agents-core';\nimport type { SourceFile } from 'ts-morph';\nimport { asRecord } from './collector-common';\nimport type { ComponentRegistry, ComponentType } from './component-registry';\nimport type { GenerationResolver } from './generation-resolver';\n\nexport interface ProjectPaths {\n  projectRoot: string;\n  agentsDir: string;\n  toolsDir: string;\n  dataComponentsDir: string;\n  artifactComponentsDir: string;\n  statusComponentsDir: string;\n  environmentsDir: string;\n  credentialsDir: string;\n  contextConfigsDir: string;\n  externalAgentsDir: string;\n}\n\nexport interface GenerationContext {\n  project: FullProjectDefinition;\n  paths: ProjectPaths;\n  completeAgentIds: Set<string>;\n  existingComponentRegistry?: ComponentRegistry;\n  resolver: GenerationResolver;\n}\n\nexport interface GenerationRecord<TPayload> {\n  id: string;\n  filePath: string;\n  payload: TPayload;\n}\n\nexport interface GenerationTask<TPayload> {\n  type: string;\n  collect: (context: GenerationContext) => GenerationRecord<TPayload>[];\n  generate: (payload: TPayload) => SourceFile;\n}\n\nexport type SubAgentReferenceOverrideType =\n  | 'tools'\n  | 'subAgents'\n  | 'agents'\n  | 'externalAgents'\n  | 'dataComponents'\n  | 'artifactComponents';\n\nexport type SubAgentReferenceOverrides = Partial<\n  Record<SubAgentReferenceOverrideType, Record<string, string>>\n>;\n\nexport type SubAgentReferencePathOverrides = Partial<\n  Record<'tools' | 'subAgents' | 'agents' | 'externalAgents', Record<string, string>>\n>;\n\nexport interface SubAgentDependencyReferences {\n  referenceOverrides?: SubAgentReferenceOverrides;\n  referencePathOverrides?: SubAgentReferencePathOverrides;\n}\n\nexport type ProjectReferenceOverrideType =\n  | 'agents'\n  | 'tools'\n  | 'externalAgents'\n  | 'dataComponents'\n  | 'artifactComponents'\n  | 'credentialReferences';\n\nexport type ProjectReferenceOverrides = Partial<\n  Record<ProjectReferenceOverrideType, Record<string, string>>\n>;\n\nexport type ProjectReferencePathOverrides = Partial<\n  Record<ProjectReferenceOverrideType, Record<string, string>>\n>;\n\nexport interface TemplateReferenceOverride {\n  name: string;\n  local?: boolean;\n}\n\nexport interface ContextTemplateReferences {\n  contextConfigId: string;\n  contextConfigReference: TemplateReferenceOverride;\n  contextConfigHeadersReference?: TemplateReferenceOverride;\n}\n\nexport interface SkippedAgent {\n  id: string;\n  reason: string;\n}\n\nexport function collectCompleteAgentIds(\n  project: FullProjectDefinition,\n  skippedAgents: SkippedAgent[]\n): Set<string> {\n  const completeAgentIds = new Set<string>();\n  for (const [agentId, agentData] of Object.entries(project.agents ?? {})) {\n    const completeness = isAgentComplete(agentData);\n    if (!completeness.complete) {\n      skippedAgents.push({ id: agentId, reason: completeness.reason ?? 'incomplete' });\n      continue;\n    }\n    completeAgentIds.add(agentId);\n  }\n  return completeAgentIds;\n}\n\nfunction isAgentComplete(\n  agentData: unknown\n): { complete: true } | { complete: false; reason: string } {\n  const data = asRecord(agentData);\n  if (!data) {\n    return { complete: false, reason: 'invalid agent object' };\n  }\n  if (!data.name || typeof data.name !== 'string') {\n    return { complete: false, reason: 'missing name' };\n  }\n  if (!data.defaultSubAgentId || typeof data.defaultSubAgentId !== 'string') {\n    return { complete: false, reason: 'missing defaultSubAgentId' };\n  }\n  const subAgents = asRecord(data.subAgents);\n  if (!subAgents || !Object.keys(subAgents).length) {\n    return { complete: false, reason: 'no sub-agents defined' };\n  }\n  return { complete: true };\n}\n\nexport function validateProject(project: FullProjectDefinition): void {\n  if (!project || typeof project !== 'object') {\n    throw new Error('Project data is required');\n  }\n  if (!project.id) {\n    throw new Error('Project id is required');\n  }\n  if (!project.name) {\n    throw new Error('Project name is required');\n  }\n}\n\nexport function assignComponentReferenceOverrideForProject(\n  registry: ComponentRegistry,\n  overrides: ProjectReferenceOverrides,\n  overrideType: ProjectReferenceOverrideType,\n  componentId: string,\n  componentType: ComponentType\n): boolean {\n  const component = registry.get(componentId, componentType);\n  if (!component?.name) {\n    return false;\n  }\n\n  const overrideMap = overrides[overrideType] ?? {};\n  overrideMap[componentId] = component.name;\n  overrides[overrideType] = overrideMap;\n  return true;\n}\n"],"mappings":";;;AA4FA,SAAgB,wBACd,SACA,eACa;CACb,MAAM,mCAAmB,IAAI,KAAa;AAC1C,MAAK,MAAM,CAAC,SAAS,cAAc,OAAO,QAAQ,QAAQ,UAAU,EAAE,CAAC,EAAE;EACvE,MAAM,eAAe,gBAAgB,UAAU;AAC/C,MAAI,CAAC,aAAa,UAAU;AAC1B,iBAAc,KAAK;IAAE,IAAI;IAAS,QAAQ,aAAa,UAAU;IAAc,CAAC;AAChF;;AAEF,mBAAiB,IAAI,QAAQ;;AAE/B,QAAO;;AAGT,SAAS,gBACP,WAC0D;CAC1D,MAAM,OAAO,SAAS,UAAU;AAChC,KAAI,CAAC,KACH,QAAO;EAAE,UAAU;EAAO,QAAQ;EAAwB;AAE5D,KAAI,CAAC,KAAK,QAAQ,OAAO,KAAK,SAAS,SACrC,QAAO;EAAE,UAAU;EAAO,QAAQ;EAAgB;AAEpD,KAAI,CAAC,KAAK,qBAAqB,OAAO,KAAK,sBAAsB,SAC/D,QAAO;EAAE,UAAU;EAAO,QAAQ;EAA6B;CAEjE,MAAM,YAAY,SAAS,KAAK,UAAU;AAC1C,KAAI,CAAC,aAAa,CAAC,OAAO,KAAK,UAAU,CAAC,OACxC,QAAO;EAAE,UAAU;EAAO,QAAQ;EAAyB;AAE7D,QAAO,EAAE,UAAU,MAAM;;AAG3B,SAAgB,gBAAgB,SAAsC;AACpE,KAAI,CAAC,WAAW,OAAO,YAAY,SACjC,OAAM,IAAI,MAAM,2BAA2B;AAE7C,KAAI,CAAC,QAAQ,GACX,OAAM,IAAI,MAAM,yBAAyB;AAE3C,KAAI,CAAC,QAAQ,KACX,OAAM,IAAI,MAAM,2BAA2B;;AAI/C,SAAgB,2CACd,UACA,WACA,cACA,aACA,eACS;CACT,MAAM,YAAY,SAAS,IAAI,aAAa,cAAc;AAC1D,KAAI,CAAC,WAAW,KACd,QAAO;CAGT,MAAM,cAAc,UAAU,iBAAiB,EAAE;AACjD,aAAY,eAAe,UAAU;AACrC,WAAU,gBAAgB;AAC1B,QAAO"}