@inkeep/agents-cli 0.23.1 → 0.23.3

package/dist/index.js

@@ -207703,8 +207703,8 @@ ${options.prefix}` : "\n" : options.prefix
             )
           };
         }
-        isValidGeneratedFileWatcher(generateFile2, watcher) {
-          return this.toPath(generateFile2) === watcher.generatedFilePath;
+        isValidGeneratedFileWatcher(generateFile, watcher) {
+          return this.toPath(generateFile) === watcher.generatedFilePath;
         }
         clearGeneratedFileWatch() {
           if (this.generatedFilesMap) {
@@ -234014,7 +234014,12 @@ var init_env2 = __esm({
       // Secrets loaded from .env files (relative to where CLI is executed)
       ANTHROPIC_API_KEY: z12.string().optional(),
       OPENAI_API_KEY: z12.string().optional(),
-      GOOGLE_API_KEY: z12.string().optional()
+      GOOGLE_API_KEY: z12.string().optional(),
+      // Langfuse configuration for LLM observability
+      LANGFUSE_SECRET_KEY: z12.string().optional(),
+      LANGFUSE_PUBLIC_KEY: z12.string().optional(),
+      LANGFUSE_BASEURL: z12.string().optional().default("https://cloud.langfuse.com"),
+      LANGFUSE_ENABLED: z12.string().optional().transform((val) => val === "true")
     });
     parseEnv2 = () => {
       try {
@@ -234035,6 +234040,47 @@ ${error.message}`
   }
 });
 
+// src/instrumentation.ts
+import { registerOTel } from "@vercel/otel";
+import { LangfuseExporter } from "langfuse-vercel";
+function isLangfuseConfigured() {
+  return !!(langfuseEnabled && langfuseSecretKey && langfusePublicKey);
+}
+function initializeInstrumentation() {
+  if (!isLangfuseConfigured()) {
+    if (process.env.DEBUG) {
+      console.log("[Langfuse] Tracing disabled - missing configuration");
+    }
+    return;
+  }
+  try {
+    registerOTel({
+      serviceName: "inkeep-agents-cli",
+      traceExporter: new LangfuseExporter({
+        secretKey: langfuseSecretKey,
+        publicKey: langfusePublicKey,
+        baseUrl: process.env.LANGFUSE_BASEURL || "https://cloud.langfuse.com"
+      })
+    });
+    if (process.env.DEBUG) {
+      console.log("[Langfuse] Tracing initialized successfully");
+    }
+  } catch (error) {
+    console.warn("[Langfuse] Failed to initialize tracing:", error);
+  }
+}
+var langfuseEnabled, langfuseSecretKey, langfusePublicKey;
+var init_instrumentation = __esm({
+  "src/instrumentation.ts"() {
+    "use strict";
+    init_esm_shims();
+    langfuseEnabled = process.env.LANGFUSE_ENABLED === "true";
+    langfuseSecretKey = process.env.LANGFUSE_SECRET_KEY;
+    langfusePublicKey = process.env.LANGFUSE_PUBLIC_KEY;
+    initializeInstrumentation();
+  }
+});
+
 // src/utils/tsx-loader.ts
 import { extname } from "path";
 import { pathToFileURL } from "url";
@@ -234440,8 +234486,10 @@ __export(pull_llm_generate_exports, {
   createModel: () => createModel,
   detectAvailableProvider: () => detectAvailableProvider,
   generateAgentFile: () => generateAgentFile,
+  generateAllFilesInBatch: () => generateAllFilesInBatch,
   generateArtifactComponentFile: () => generateArtifactComponentFile,
   generateDataComponentFile: () => generateDataComponentFile,
+  generateEnvironmentFileTemplate: () => generateEnvironmentFileTemplate,
   generateEnvironmentFiles: () => generateEnvironmentFiles,
   generateIndexFile: () => generateIndexFile,
   generateStatusComponentFile: () => generateStatusComponentFile,
@@ -234578,8 +234626,19 @@ async function generateTextWithPlaceholders(model, data, promptTemplate, options
     model,
     prompt,
     ...options,
-    ...reasoningConfig
+    ...reasoningConfig,
     // Merge in reasoning/thinking config if provided
+    // Enable Langfuse telemetry if configured
+    ...isLangfuseConfigured() && {
+      experimental_telemetry: {
+        isEnabled: true,
+        metadata: {
+          fileType: context?.fileType || "unknown",
+          placeholderCount: Object.keys(replacements).length,
+          promptSize: prompt.length
+        }
+      }
+    }
   });
   const restoredText = restorePlaceholders(text2, replacements);
   if (debug && Object.keys(replacements).length > 0) {
@@ -234648,8 +234707,8 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
     },
     false,
     // debug
-    void 0,
-    // context
+    { fileType: "index" },
+    // context - for Langfuse metadata
     reasoningConfig
     // reasoning config
   );
@@ -234904,8 +234963,8 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
       },
       debug,
       // Pass debug flag to show placeholder optimization info
-      void 0,
-      // context
+      { fileType: "agent" },
+      // context - for Langfuse metadata
       reasoningConfig
       // reasoning config
     );
@@ -235001,8 +235060,8 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
     },
     false,
     // debug
-    void 0,
-    // context
+    { fileType: "tool" },
+    // context - for Langfuse metadata
     reasoningConfig
     // reasoning config
   );
@@ -235079,8 +235138,8 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
     },
     false,
     // debug
-    void 0,
-    // context
+    { fileType: "data_component" },
+    // context - for Langfuse metadata
     reasoningConfig
     // reasoning config
   );
@@ -235162,8 +235221,8 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
     },
     false,
     // debug
-    void 0,
-    // context
+    { fileType: "artifact_component" },
+    // context - for Langfuse metadata
     reasoningConfig
     // reasoning config
   );
@@ -235243,13 +235302,84 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
     },
     false,
     // debug
-    void 0,
-    // context
+    { fileType: "status_component" },
+    // context - for Langfuse metadata
     reasoningConfig
     // reasoning config
   );
   writeFileSync3(outputPath, cleanGeneratedCode(text2));
 }
+function generateEnvironmentFileTemplate(environmentsDir, environment, credentials) {
+  const { writeFileSync: writeFileSync7 } = require3("node:fs");
+  const { join: join14 } = require3("node:path");
+  let credentialsCode = "";
+  const hasCredentials = credentials && Object.keys(credentials).length > 0;
+  if (hasCredentials) {
+    const credentialEntries = [];
+    for (const [credId, cred] of Object.entries(credentials)) {
+      if (credId === "_meta") continue;
+      const varName = credId.replace(/-/g, "_").replace(/[^a-zA-Z0-9_]/g, "");
+      const params = [
+        `id: '${cred.id || credId}'`,
+        `type: '${cred.type || "api_key"}'`,
+        `credentialStoreId: '${cred.credentialStoreId || "environment"}'`
+      ];
+      if (cred.retrievalParams) {
+        params.push(
+          `retrievalParams: ${JSON.stringify(cred.retrievalParams, null, 6).replace(/\n/g, "\n      ")}`
+        );
+      }
+      credentialEntries.push(`    ${varName}: credential({
+      ${params.join(",\n      ")}
+    })`);
+    }
+    credentialsCode = `
+${credentialEntries.join(",\n")}
+  `;
+  } else {
+    credentialsCode = "\n  ";
+  }
+  const imports = hasCredentials ? "import { credential, registerEnvironmentSettings } from '@inkeep/agents-sdk';" : "import { registerEnvironmentSettings } from '@inkeep/agents-sdk';";
+  const envContent = `${imports}
+
+export const ${environment} = registerEnvironmentSettings({
+  credentials: {${credentialsCode}}
+});
+`;
+  writeFileSync7(join14(environmentsDir, `${environment}.env.ts`), envContent);
+  updateEnvironmentIndexTemplate(environmentsDir, environment);
+}
+function updateEnvironmentIndexTemplate(environmentsDir, newEnvironment) {
+  const { writeFileSync: writeFileSync7, existsSync: existsSync12, readFileSync: readFileSync8 } = require3("node:fs");
+  const { join: join14 } = require3("node:path");
+  const indexPath = join14(environmentsDir, "index.ts");
+  const existingEnvironments = [];
+  if (existsSync12(indexPath)) {
+    const existingContent = readFileSync8(indexPath, "utf-8");
+    const importRegex = /import\s+{\s*(\w+)\s*}\s+from\s+['"]\.\/([\w-]+)\.env['"];?/g;
+    let match;
+    while ((match = importRegex.exec(existingContent)) !== null) {
+      const envName = match[2];
+      if (!existingEnvironments.includes(envName)) {
+        existingEnvironments.push(envName);
+      }
+    }
+  }
+  if (!existingEnvironments.includes(newEnvironment)) {
+    existingEnvironments.push(newEnvironment);
+  }
+  existingEnvironments.sort();
+  const importStatements = existingEnvironments.map((env3) => `import { ${env3} } from './${env3}.env';`).join("\n");
+  const environmentObject = existingEnvironments.map((env3) => `  ${env3},`).join("\n");
+  const indexContent = `import { createEnvironmentSettings } from '@inkeep/agents-sdk';
+${importStatements}
+
+export const envSettings = createEnvironmentSettings({
+${environmentObject}
+});
+`;
+  writeFileSync7(indexPath, indexContent);
+}
 async function generateEnvironmentFiles(environmentsDir, credentials, environment = "development") {
   const generateCredentialCode = (cred) => {
     const params = [
@@ -235326,6 +235456,268 @@ export { ${exportStatement} };
 `;
   writeFileSync3(indexPath, indexContent);
 }
+async function generateAllFilesInBatch(fileSpecs, modelSettings, debug = false, reasoningConfig) {
+  if (fileSpecs.length === 0) {
+    return;
+  }
+  const model = createModel(modelSettings);
+  const typeDefinitions = getTypeDefinitions();
+  const sharedInstructions = `
+${NAMING_CONVENTION_RULES}
+
+${IMPORT_INSTRUCTIONS}
+`;
+  const filePrompts = fileSpecs.map((spec, index2) => {
+    let fileSpecificInstructions = "";
+    switch (spec.type) {
+      case "index":
+        fileSpecificInstructions = `
+REQUIREMENTS FOR INDEX FILE:
+1. Import the project function from '@inkeep/agents-sdk'
+2. The project object should include all required properties and any optional properties (according to the type definitions) that are present in the project data
+
+PROJECT JSON EXAMPLE:
+${PROJECT_JSON_EXAMPLE}
+
+EXAMPLE OUTPUT:
+import { project } from '@inkeep/agents-sdk';
+
+export const myProject = project({
+  id: 'my-project',
+  name: 'My Project',
+  description: 'test test',
+  models: {
+    base: { model: 'gpt-4o-mini' }
+  }
+});
+`;
+        break;
+      case "agent":
+        const importMappings = spec.toolFilenames || spec.componentFilenames ? `IMPORT PATH MAPPINGS (CRITICAL - USE EXACT PATHS):
+${generateImportMappings(spec.toolFilenames, spec.componentFilenames)}
+
+!!! WARNING: Entity IDs \u2260 File Paths !!!
+- Entity IDs may use underscores or different naming
+- File paths use kebab-case naming convention
+- ALWAYS use the exact import paths from the mappings above
+- NEVER use entity IDs directly as import paths
+
+` : "";
+        fileSpecificInstructions = `
+${importMappings}REQUIREMENTS FOR AGENT FILE:
+1. IMPORTS (CRITICAL - USE FILE PATHS, NOT IDs):
+   - For tool/component imports: Use ONLY the exact file paths from IMPORT PATH MAPPINGS above
+   - Import paths are based on actual file names, not entity IDs
+   - Always use kebab-case file paths (../tools/tool-name, not ../tools/tool_name)
+   - ALWAYS import { agent, subAgent } from '@inkeep/agents-sdk'
+   - ALWAYS import { z } from 'zod' when using ANY Zod schemas (responseSchema, headersSchema, etc.)
+   - ALWAYS import { contextConfig, fetchDefinition, headers } from '@inkeep/agents-core' when agent has contextConfig
+   - Import status components from '../status-components/' when needed
+2. Define each agent using the agent() function following the type definitions provided above
+3. Create the agent using agent() with proper structure
+   - IMPORTANT: If description is null, undefined, or empty string, omit the description field entirely
+4. CRITICAL: Template Literals vs Raw Code:
+   - For STRING VALUES: ALWAYS use template literals with backticks: \`string content\`
+   - This includes: prompt, description, query, url, method, body, defaultValue, etc.
+   - This prevents TypeScript syntax errors with apostrophes (user's, don't, etc.)
+   - IMPORTANT: ANY placeholder that starts with < and ends with > MUST be wrapped in template literals (backticks)
+   - For object keys: use quotes only for keys with hyphens ('Content-Type'), omit for simple identifiers (Authorization)
+
+   EXCEPTION - Schema Fields (NO template literals):
+   - headersSchema: z.object({ ... }) (raw Zod code, NOT a string)
+   - responseSchema: z.object({ ... }) (raw Zod code, NOT a string)
+   - These are TypeScript expressions, not string values
+5. For contextConfig (CRITICAL):
+   - NEVER use plain objects for contextConfig
+   - ALWAYS use helper functions: headers(), fetchDefinition(), contextConfig()
+   - Create separate const variables for each helper before the agent definition
+6. If you are writing zod schemas make them clean. For example if you see z.union([z.string(), z.null()]) write it as z.string().nullable()
+`;
+        break;
+      case "tool":
+        fileSpecificInstructions = `
+REQUIREMENTS FOR TOOL FILE:
+1. Import mcpTool from '@inkeep/agents-sdk'
+2. CRITICAL: Always include serverUrl property (required by SDK) extracted from config.mcp.server.url
+3. CRITICAL: Use individual properties supported by mcpTool - do NOT use nested config object
+4. Extract configuration properties and map them to mcpTool's expected properties (serverUrl, transport, etc.)
+5. CRITICAL: If credentialReferenceId exists in tool data, add it as a credential property using envSettings.getEnvironmentSetting()
+6. Convert credentialReferenceId to credential key format by replacing hyphens with underscores for the getEnvironmentSetting() call (e.g., 'inkeep-api-credential' becomes 'inkeep_api_credential')
+7. TRANSPORT CONFIG: If config.mcp.transport exists, extract it as a transport property (not nested in config)
+8. NO CONFIG OBJECT: mcpTool does not accept a 'config' property - use individual properties only
+`;
+        break;
+      case "data_component":
+        fileSpecificInstructions = `
+REQUIREMENTS FOR DATA COMPONENT FILE:
+1. Import dataComponent from '@inkeep/agents-sdk'
+2. Import z from 'zod' for schema definitions
+3. Create the data component using dataComponent()
+4. Include all properties from the component data INCLUDING the 'id' property
+5. CRITICAL: All imports must be alphabetically sorted to comply with Biome linting
+6. If you are writing zod schemas make them clean. For example if you see z.union([z.string(), z.null()]) write it as z.string().nullable()
+`;
+        break;
+      case "artifact_component":
+        fileSpecificInstructions = `
+REQUIREMENTS FOR ARTIFACT COMPONENT FILE:
+1. Import artifactComponent from '@inkeep/agents-sdk'
+2. Import z from 'zod' and preview from '@inkeep/agents-core' for schema definitions
+3. Create the artifact component using artifactComponent()
+4. Use preview() helper for fields that should be shown in previews
+5. Export following naming convention rules (camelCase version of ID)
+6. Include the 'id' property to preserve the original component ID
+7. CRITICAL: All imports must be alphabetically sorted to comply with Biome linting
+8. If you are writing zod schemas make them clean. For example if you see z.union([z.string(), z.null()]) write it as z.string().nullable()
+`;
+        break;
+      case "status_component":
+        fileSpecificInstructions = `
+REQUIREMENTS FOR STATUS COMPONENT FILE:
+1. Import statusComponent from '@inkeep/agents-sdk'
+2. Import z from 'zod' for schema definitions
+3. Create the status component using statusComponent()
+4. Export following naming convention rules (camelCase version of ID)
+5. Use 'type' field as the identifier (like 'tool_summary')
+6. CRITICAL: All imports must be alphabetically sorted to comply with Biome linting
+7. If you are writing zod schemas make them clean. For example if you see z.union([z.string(), z.null()]) write it as z.string().nullable()
+8. The statusComponent() function handles conversion to .config automatically
+`;
+        break;
+    }
+    return `
+--- FILE ${index2 + 1} OF ${fileSpecs.length}: ${spec.outputPath} ---
+FILE TYPE: ${spec.type}
+FILE ID: ${spec.id}
+
+DATA FOR THIS FILE:
+${JSON.stringify(spec.data, null, 2)}
+
+${fileSpecificInstructions}
+
+Generate ONLY the TypeScript code for this file without any markdown or explanations.
+--- END FILE ${index2 + 1} ---
+`;
+  });
+  const combinedPrompt = `You are generating multiple TypeScript files for an Inkeep project in a single batch.
+
+${typeDefinitions}
+
+${sharedInstructions}
+
+CRITICAL INSTRUCTIONS:
+1. Generate ${fileSpecs.length} separate TypeScript files
+2. Each file MUST be wrapped with its exact separator markers
+3. Use the format: --- FILE: <output-path> --- for the start marker
+4. Use the format: --- END FILE: <output-path> --- for the end marker
+5. Between markers, include ONLY the raw TypeScript code (no markdown, no explanations)
+6. DO NOT include triple backticks or "typescript" language identifiers
+7. The code between markers should be ready to write directly to a .ts file
+
+FILE SPECIFICATIONS:
+${filePrompts.join("\n\n")}
+
+OUTPUT FORMAT EXAMPLE:
+--- FILE: /path/to/file1.ts ---
+import { project } from '@inkeep/agents-sdk';
+
+export const myProject = project({
+  id: 'example'
+});
+--- END FILE: /path/to/file1.ts ---
+
+--- FILE: /path/to/file2.ts ---
+import { agent } from '@inkeep/agents-sdk';
+
+export const myAgent = agent({
+  id: 'example-agent'
+});
+--- END FILE: /path/to/file2.ts ---
+
+Now generate all ${fileSpecs.length} files following this exact format.`;
+  if (debug) {
+    console.log(`
+[DEBUG] === Starting BATCH generation for ${fileSpecs.length} files ===`);
+    console.log(`[DEBUG] Combined prompt size: ${combinedPrompt.length} characters`);
+    console.log(`[DEBUG] Model: ${modelSettings.model || "default"}`);
+    console.log(`[DEBUG] Files to generate:`);
+    for (const spec of fileSpecs) {
+      console.log(`[DEBUG]   - ${spec.type}: ${spec.outputPath}`);
+    }
+  }
+  try {
+    const startTime = Date.now();
+    const { text: text2 } = await generateText({
+      model,
+      prompt: combinedPrompt,
+      temperature: 0.1,
+      maxOutputTokens: 32e3,
+      // Increased for batch generation
+      abortSignal: AbortSignal.timeout(6e5),
+      // 10 minute timeout for batch
+      ...reasoningConfig,
+      // Enable Langfuse telemetry if configured
+      ...isLangfuseConfigured() && {
+        experimental_telemetry: {
+          isEnabled: true,
+          metadata: {
+            batchGeneration: true,
+            fileCount: fileSpecs.length,
+            fileTypes: fileSpecs.map((s2) => s2.type).join(","),
+            promptSize: combinedPrompt.length
+          }
+        }
+      }
+    });
+    const duration = Date.now() - startTime;
+    if (debug) {
+      console.log(`[DEBUG] LLM response received in ${duration}ms`);
+      console.log(`[DEBUG] Response length: ${text2.length} characters`);
+      console.log(`[DEBUG] Parsing individual files from response...`);
+    }
+    const extractedFiles = parseMultiFileResponse(text2, fileSpecs);
+    if (debug) {
+      console.log(`[DEBUG] Successfully extracted ${extractedFiles.length} files`);
+    }
+    for (const { path: path4, content } of extractedFiles) {
+      const cleanedContent = cleanGeneratedCode(content);
+      writeFileSync3(path4, cleanedContent);
+      if (debug) {
+        console.log(`[DEBUG] Wrote file: ${path4} (${cleanedContent.length} chars)`);
+      }
+    }
+    if (debug) {
+      console.log(`[DEBUG] === Completed BATCH generation ===
+`);
+    }
+  } catch (error) {
+    if (debug) {
+      console.error(`[DEBUG] === ERROR in batch generation ===`);
+      console.error(`[DEBUG] Error name: ${error.name}`);
+      console.error(`[DEBUG] Error message: ${error.message}`);
+      console.error(`[DEBUG] Full error:`, error);
+    }
+    throw error;
+  }
+}
+function parseMultiFileResponse(response, fileSpecs) {
+  const results = [];
+  for (const spec of fileSpecs) {
+    const startMarker = `--- FILE: ${spec.outputPath} ---`;
+    const endMarker = `--- END FILE: ${spec.outputPath} ---`;
+    const startIndex = response.indexOf(startMarker);
+    const endIndex = response.indexOf(endMarker);
+    if (startIndex === -1 || endIndex === -1) {
+      throw new Error(`Failed to find file markers for ${spec.outputPath}`);
+    }
+    const content = response.substring(startIndex + startMarker.length, endIndex).trim();
+    results.push({
+      path: spec.outputPath,
+      content
+    });
+  }
+  return results;
+}
 async function generateTypeScriptFileWithLLM(agentData, agentId, outputFilePath, modelSettings, retryContext) {
   const fs5 = await import("fs");
   let existingContent = "";
@@ -235469,6 +235861,7 @@ var init_pull_llm_generate = __esm({
     init_esm_shims();
     init_src();
     init_env2();
+    init_instrumentation();
     init_pull_placeholder_system();
     require3 = createRequire2(import.meta.url);
     PROJECT_JSON_EXAMPLE = `
@@ -235671,6 +236064,7 @@ __export(variable_name_registry_exports, {
 });
 function collectAllEntities(projectData) {
   const entities = [];
+  entities.push({ id: projectData.id, type: "project", data: projectData });
   if (projectData.agents) {
     for (const [agentId, agentData] of Object.entries(projectData.agents)) {
       entities.push({ id: agentId, type: "agent", data: agentData });
@@ -235771,8 +236165,9 @@ var init_variable_name_registry = __esm({
     "use strict";
     init_esm_shims();
     DEFAULT_NAMING_CONVENTIONS = {
-      subAgentSuffix: "SubAgent",
+      projectSuffix: "Project",
       agentSuffix: "Agent",
+      subAgentSuffix: "SubAgent",
       toolSuffix: null,
       // Usually no suffix needed
       dataComponentSuffix: null,
@@ -235788,6 +236183,7 @@ var init_variable_name_registry = __esm({
       conflicts;
       constructor(conventions = DEFAULT_NAMING_CONVENTIONS) {
         this.registry = {
+          projects: /* @__PURE__ */ new Map(),
           agents: /* @__PURE__ */ new Map(),
           subAgents: /* @__PURE__ */ new Map(),
           tools: /* @__PURE__ */ new Map(),
@@ -235925,6 +236321,8 @@ var init_variable_name_registry = __esm({
        */
       getSuffixForType(entityType) {
         switch (entityType) {
+          case "project":
+            return this.conventions.projectSuffix;
           case "agent":
             return this.conventions.agentSuffix;
           case "subAgent":
@@ -235950,6 +236348,8 @@ var init_variable_name_registry = __esm({
        */
       getRegistryMap(entityType) {
         switch (entityType) {
+          case "project":
+            return this.registry.projects;
           case "agent":
             return this.registry.agents;
           case "subAgent":
@@ -236708,6 +237108,7 @@ Generate ONLY the JSON response, no markdown or explanations.`;
 function formatVariableMappings(registry2, allEntities) {
   let result = "";
   const byType = {
+    project: [],
     agent: [],
     subAgent: [],
     tool: [],
@@ -236740,12 +237141,15 @@ ${type.toUpperCase()}S:
 function formatFileNameMappings(fileNameMappings, allEntities) {
   let result = "";
   const byType = {
+    project: [],
     agent: [],
+    subAgent: [],
     tool: [],
     dataComponent: [],
     artifactComponent: [],
     statusComponent: [],
-    credential: []
+    credential: [],
+    environment: []
   };
   for (const entity of allEntities) {
     const fileName = fileNameMappings.get(entity.id);
@@ -236778,6 +237182,8 @@ ${type.toUpperCase()}S:
 }
 function getRegistryMap(registry2, entityType) {
   switch (entityType) {
+    case "project":
+      return registry2.projects;
     case "agent":
       return registry2.agents;
     case "subAgent":
@@ -236792,6 +237198,8 @@ function getRegistryMap(registry2, entityType) {
       return registry2.statusComponents;
     case "credential":
       return registry2.credentials;
+    case "environment":
+      return registry2.environments;
     default:
       throw new Error(`Unknown entity type: ${entityType}`);
   }
@@ -236916,74 +237324,82 @@ import { writeFileSync as writeFileSync4 } from "fs";
 async function generateFilesFromPlan(plan, projectData, dirs, modelSettings, debug = false, reasoningConfig) {
   const startTime = Date.now();
   if (debug) {
-    console.log(`[DEBUG] Starting parallel generation of ${plan.files.length} files...`);
+    console.log(`[DEBUG] Starting batch generation of ${plan.files.length} files...`);
+  }
+  const environmentFiles = plan.files.filter((f) => f.type === "environment");
+  const regularFiles = plan.files.filter((f) => f.type !== "environment");
+  if (debug && regularFiles.length > 0) {
+    console.log(`[DEBUG] Batching ${regularFiles.length} regular files into single LLM request...`);
+  }
+  const fileSpecs = regularFiles.map((fileInfo) => {
+    const outputPath = `${dirs.projectRoot}/${fileInfo.path}`;
+    const fileData = extractDataForFile(fileInfo, projectData);
+    let batchType;
+    switch (fileInfo.type) {
+      case "index":
+        batchType = "index";
+        break;
+      case "agent":
+        batchType = "agent";
+        break;
+      case "tool":
+        batchType = "tool";
+        break;
+      case "dataComponent":
+        batchType = "data_component";
+        break;
+      case "artifactComponent":
+        batchType = "artifact_component";
+        break;
+      case "statusComponent":
+        batchType = "status_component";
+        break;
+      default:
+        throw new Error(`Unknown file type for batch generation: ${fileInfo.type}`);
+    }
+    const entityId = fileInfo.entities[0]?.id || fileInfo.path;
+    return {
+      type: batchType,
+      id: entityId,
+      data: fileData,
+      outputPath,
+      toolFilenames: void 0,
+      // TODO: Extract from plan if needed
+      componentFilenames: void 0
+      // TODO: Extract from plan if needed
+    };
+  });
+  if (fileSpecs.length > 0) {
+    await generateAllFilesInBatch(fileSpecs, modelSettings, debug, reasoningConfig);
+  }
+  if (debug && environmentFiles.length > 0) {
+    console.log(`[DEBUG] Generating ${environmentFiles.length} environment files using templates (no LLM)...`);
+  }
+  for (const envFile of environmentFiles) {
+    const envStartTime = Date.now();
+    const outputPath = `${dirs.projectRoot}/${envFile.path}`;
+    const fileData = extractDataForFile(envFile, projectData);
+    const fileName = envFile.path.split("/").pop() || "";
+    if (fileName === "index.ts") {
+      continue;
+    }
+    const envName = fileName.replace(".env.ts", "");
+    if (debug) {
+      console.log(`[DEBUG] \u25B6 Generating ${envFile.path} using template...`);
+    }
+    generateEnvironmentFileTemplate(dirs.environmentsDir, envName, fileData);
+    const envDuration = ((Date.now() - envStartTime) / 1e3).toFixed(1);
+    if (debug) {
+      console.log(`[DEBUG] \u2713 Completed ${envFile.path} (template, ${envDuration}s)`);
+    }
   }
-  const tasks2 = plan.files.map(
-    (fileInfo, index2) => generateFile(fileInfo, projectData, plan, dirs, modelSettings, debug, reasoningConfig).then(() => {
-      if (debug) {
-        const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
-        console.log(
-          `[DEBUG] \u2713 Completed ${index2 + 1}/${plan.files.length}: ${fileInfo.path} (${elapsed}s elapsed)`
-        );
-      }
-    })
-  );
-  await Promise.all(tasks2);
   const totalTime = ((Date.now() - startTime) / 1e3).toFixed(1);
   if (debug) {
     console.log(
-      `[DEBUG] All files generated in ${totalTime}s (${plan.files.length} files in parallel)`
+      `[DEBUG] All files generated in ${totalTime}s (${regularFiles.length} in batch, ${environmentFiles.length} via templates)`
     );
   }
 }
-async function generateFile(fileInfo, projectData, plan, dirs, modelSettings, debug, reasoningConfig) {
-  const fileStartTime = Date.now();
-  const model = createModel(modelSettings);
-  const outputPath = `${dirs.projectRoot}/${fileInfo.path}`;
-  const fileData = extractDataForFile(fileInfo, projectData);
-  const exampleCode = findExampleCode(fileInfo, plan.patterns);
-  const context = {
-    plan,
-    patterns: plan.patterns,
-    fileInfo,
-    exampleCode
-  };
-  const registryInfo = formatRegistryForFile(fileInfo, plan.variableRegistry);
-  const promptTemplate = createPromptForFile(fileInfo, fileData, context, registryInfo);
-  if (debug) {
-    console.log(`[DEBUG] \u25B6 Starting: ${fileInfo.path} (${fileInfo.type})`);
-  }
-  try {
-    const llmStartTime = Date.now();
-    const text2 = await generateTextWithPlaceholders(
-      model,
-      fileData,
-      promptTemplate,
-      {
-        temperature: 0.1,
-        maxOutputTokens: fileInfo.type === "agent" ? 16e3 : 4e3,
-        abortSignal: AbortSignal.timeout(fileInfo.type === "agent" ? 3e5 : 9e4)
-        // Increased for reasoning (5 min for agents, 90s for others)
-      },
-      debug,
-      { fileType: fileInfo.type },
-      reasoningConfig
-      // Pass reasoning config
-    );
-    const llmDuration = ((Date.now() - llmStartTime) / 1e3).toFixed(1);
-    const cleanedCode = cleanGeneratedCode(text2);
-    writeFileSync4(outputPath, cleanedCode);
-    const totalDuration = ((Date.now() - fileStartTime) / 1e3).toFixed(1);
-    if (debug) {
-      console.log(
-        `[DEBUG] \u2713 Completed: ${fileInfo.path} (LLM: ${llmDuration}s, Total: ${totalDuration}s)`
-      );
-    }
-  } catch (error) {
-    console.error(`[ERROR] Failed to generate ${fileInfo.path}:`, error.message);
-    throw error;
-  }
-}
 function extractDataForFile(fileInfo, projectData) {
   switch (fileInfo.type) {
     case "index":
@@ -236991,7 +237407,8 @@ function extractDataForFile(fileInfo, projectData) {
     case "agent": {
       const agentId = fileInfo.entities.find((e2) => e2.entityType === "agent")?.id;
       if (agentId && projectData.agents) {
-        return projectData.agents[agentId];
+        const agentData = projectData.agents[agentId];
+        return ensureUniqueSubAgentKeys(agentData);
       }
       return {};
     }
@@ -237177,551 +237594,21 @@ function extractDataForFile(fileInfo, projectData) {
       return {};
   }
 }
-function findExampleCode(fileInfo, patterns) {
-  return void 0;
-}
-function createPromptForFile(fileInfo, fileData, context, registryInfo) {
-  const commonInstructions = `
-${getTypeDefinitions()}
-
-DETECTED PATTERNS (FOLLOW THESE):
-- File Structure: ${context.patterns.fileStructure.toolsLocation} tools
-- File Naming: ${context.patterns.fileStructure.preferredFileNaming}
-- Export Style: ${context.patterns.codeStyle.exportNaming}
-- Multi-line strings: ${context.patterns.codeStyle.multiLineStrings}
-
-${context.exampleCode ? `EXAMPLE CODE (your existing style):
-${context.exampleCode}
-` : ""}
-
-VARIABLE NAME REGISTRY (MUST USE EXACT NAMES):
-${registryInfo}
-
-${NAMING_CONVENTION_RULES}
-
-${IMPORT_INSTRUCTIONS}
-
-CRITICAL RULES:
-1. Use EXACT variable names from the registry above - DO NOT modify or "improve" them
-2. Copy the exact import statements provided in the registry
-3. The 'id' field in objects keeps the original value
-4. Variable names must be unique (no conflicts across types)
-5. Follow detected patterns for code style
-6. Match existing formatting and conventions
-7. NEVER generate your own variable names - only use what's provided
-`;
-  switch (fileInfo.type) {
-    case "index":
-      return createIndexPrompt(fileData, context, registryInfo, commonInstructions);
-    case "agent":
-      return createAgentPrompt(fileData, context, registryInfo, commonInstructions);
-    case "tool":
-      return createToolPrompt(fileData, context, registryInfo, commonInstructions);
-    case "dataComponent":
-      return createDataComponentPrompt(fileData, context, registryInfo, commonInstructions);
-    case "artifactComponent":
-      return createArtifactComponentPrompt(fileData, context, registryInfo, commonInstructions);
-    case "statusComponent":
-      return createStatusComponentPrompt(fileData, context, registryInfo, commonInstructions);
-    case "environment":
-      return createEnvironmentPrompt(fileData, context, registryInfo, commonInstructions);
-    default:
-      throw new Error(`Unknown file type: ${fileInfo.type}`);
-  }
-}
-function createIndexPrompt(_projectData, context, _registryInfo, commonInstructions) {
-  const importMappings = generateImportMappings2(context.plan);
-  return `Generate index.ts for Inkeep project.
-
-PROJECT DATA:
-{{DATA}}
-
-IMPORT MAPPINGS (MUST USE THESE):
-${importMappings}
-
-${commonInstructions}
-
-EXAMPLE:
-import { project } from '@inkeep/agents-sdk';
-import { weatherAgent } from './agents/weather-agent';
-import { weatherApi } from './tools/weather-api';
-
-export const myProject = project({
-  id: 'my-weather-project',
-  name: 'Weather Project',
-  models: { base: { model: 'openai/gpt-4o-mini' } },
-  agents: () => [weatherAgent],
-  tools: () => [weatherApi]
-});
-
-Generate ONLY the TypeScript code without markdown.`;
-}
-function createAgentPrompt(_agentData, context, _registryInfo, commonInstructions) {
-  const inlineTools = context.fileInfo.inlineContent || [];
-  const hasInlineTools = inlineTools.length > 0;
-  return `Generate TypeScript file for Inkeep agent.
-
-AGENT DATA:
-{{DATA}}
-
-${commonInstructions}
-
-INLINE CONTENT:
-${hasInlineTools ? `This file should define these tools inline:
-${inlineTools.map((e2) => `- ${e2.variableName} (${e2.entityType})`).join("\n")}` : "No inline content - import all dependencies"}
-
-${hasInlineTools ? `
-FUNCTION TOOL API (CRITICAL):
-functionTool({
-  name: 'tool-name',  // Use 'name' NOT 'id'
-  description: 'Tool description',
-  inputSchema: {
-    type: 'object',
-    properties: { ... },
-    required: [...]
-  },
-  execute: async (params: { ... }) => {  // Use 'execute' function NOT 'executeCode' string
-    // Implementation here
-    return { ... };
-  }
-})
-
-EXAMPLE:
-const calculateBMI = functionTool({
-  name: 'calculate-bmi',
-  description: 'Calculates BMI',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      weight: { type: 'number', description: 'Weight in kg' },
-      height: { type: 'number', description: 'Height in meters' }
-    },
-    required: ['weight', 'height']
-  },
-  execute: async (params: { weight: number; height: number }) => {
-    try {
-      const bmi = params.weight / (params.height * params.height);
-      return { bmi: Math.round(bmi * 10) / 10 };
-    } catch (error: any) {  // Type catch parameter as 'any' for TypeScript
-      throw new Error(\`BMI calculation failed: \${error.message}\`);
-    }
-  }
-});
-` : ""}
-
-IMPORTS (CRITICAL - MUST BE FIRST):
-ALWAYS import these at the TOP of the file:
-- import { agent, subAgent, functionTool } from '@inkeep/agents-sdk';
-- import { z } from 'zod'; (REQUIRED when using ANY Zod schemas like responseSchema, headersSchema)
-- import { contextConfig, fetchDefinition, headers } from '@inkeep/agents-core'; (REQUIRED when agent has contextConfig)
-- import status components from '../status-components/' when needed
-
-SUBAGENT AND AGENT API (CRITICAL):
-- Use 'canUse' (NOT 'tools') - must be a FUNCTION returning array
-- Use 'canDelegateTo' - must be a FUNCTION returning array
-- Use 'dataComponents' - must be a FUNCTION returning array
-- Use 'subAgents' in agent() - must be a FUNCTION returning array
-
-CONTEXT CONFIG (CRITICAL - NO PLAIN OBJECTS):
-- NEVER use plain objects for contextConfig
-- ALWAYS use helper functions: headers(), fetchDefinition(), contextConfig()
-- Create separate const variables for each helper before the agent definition
-- Pattern:
-  const myHeaders = headers({ schema: z.object({ api_key: z.string() }) });
-  const myFetch = fetchDefinition({ id: '...', fetchConfig: {...}, responseSchema: z.object({...}) });
-  const myContext = contextConfig({ headers: myHeaders, contextVariables: { data: myFetch } });
-  export const myAgent = agent({ contextConfig: myContext });
-- Use myHeaders.toTemplate('key_name') for header values in fetchConfig
-- Use myContext.toTemplate('variable.field') for prompt interpolation
-
-FETCHDEFINITION STRUCTURE (CRITICAL - COPY EXACT FORMAT):
-- ALWAYS wrap HTTP config in 'fetchConfig' object
-- COPY the exact authorization format from source data (don't modify headers)
-- Use .nullable() instead of z.union([type, z.null()]) for schemas
-- responseSchema is raw Zod code (NO backticks around it)
-- String values use template literals (backticks for strings)
-
-CORRECT fetchDefinition structure:
-fetchDefinition({
-  id: 'fetch-id',
-  name: 'Fetch Name',
-  trigger: 'initialization',
-  fetchConfig: {
-    url: 'api-endpoint-url',
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: headersVar.toTemplate('key') // COPY EXACT format from source
-    },
-    body: { query: 'request-body' }
-  },
-  responseSchema: z.object({
-    field: z.string().nullable()
-  }),
-  transform: 'data.path',
-  defaultValue: 'fallback'
-})
-
-STRING LITERALS (CRITICAL - MUST FOLLOW):
-- For STRING VALUES: ALWAYS use template literals (backticks \`)
-- This includes: prompt, description, query, url, method, body, defaultValue, etc.
-- Template literals prevent syntax errors with apostrophes (don't, user's, it's)
-- For object keys that are identifiers (no hyphens), omit quotes: Authorization not 'Authorization'
-- For object keys with hyphens, use quotes: 'Content-Type'
-
-EXCEPTION - Schema Fields (NO template literals):
-- headersSchema: z.object({ ... }) (raw Zod code, NOT a string)
-- responseSchema: z.object({ ... }) (raw Zod code, NOT a string)
-- These are TypeScript expressions, not string values
-
-CORRECT EXAMPLES:
-\u2705 prompt: \`You are a helpful assistant.\` (string value)
-\u2705 query: \`query GetData { field }\` (string value)
-\u2705 responseSchema: z.object({ name: z.string() }) (Zod code, NO backticks)
-\u2705 headersSchema: z.object({ 'inkeep_api_key': z.string() }) (Zod code, NO backticks)
-
-WRONG EXAMPLES:
-\u274C prompt: 'You are a helpful assistant.' (use backticks not single quotes)
-\u274C responseSchema: \`z.object({ name: z.string() })\` (don't wrap Zod in backticks)
-
-STATUS COMPONENTS (CRITICAL):
-- Status components are ALWAYS imported from '../status-components/' directory
-- In statusUpdates.statusComponents array, use statusComponent.config to get the config object
-- NEVER inline status component definitions in the agent file
-- Example: import { toolSummary } from '../status-components/tool-summary'
-- Then use: statusComponents: [toolSummary.config]
-
-\u2705 CORRECT:
-import { toolSummary } from '../status-components/tool-summary';
-
-const weatherSubAgent = subAgent({
-  id: 'weather',
-  name: 'Weather Sub',
-  description: '...',
-  prompt: \`You are a helpful assistant.
-When users ask about weather, use your tools.
-Always be clear and concise.\`,  // Template literal for multi-line
-  canUse: () => [tool1, tool2],  // FUNCTION returning array
-  canDelegateTo: () => [otherAgent],  // FUNCTION returning array
-  dataComponents: () => [component1]  // FUNCTION returning array
-});
-
-const weatherAgent = agent({
-  id: 'weather',
-  name: 'Weather Agent',
-  defaultSubAgent: weatherSubAgent,
-  subAgents: () => [weatherSubAgent],  // FUNCTION returning array
-  statusUpdates: {
-    numEvents: 1,
-    timeInSeconds: 1,
-    statusComponents: [toolSummary.config]  // Use .config
-  }
-});
-
-\u274C WRONG:
-prompt: 'Multi-line
-string',  // NO - use backticks for multi-line
-tools: [tool1, tool2],  // NO - use 'canUse' not 'tools'
-canUse: [tool1, tool2],  // NO - must be a function
-subAgents: [weatherSubAgent],  // NO - must be a function
-statusComponents: [{ type: '...', ... }],  // NO - import from files
-
-Generate ONLY the TypeScript code without markdown.`;
-}
-function createToolPrompt(_toolData, _context, _registryInfo, commonInstructions) {
-  return `Generate TypeScript file for Inkeep tool.
-
-TOOL DATA:
-{{DATA}}
-
-${commonInstructions}
-
-REQUIREMENTS:
-1. Import mcpTool or functionTool from '@inkeep/agents-sdk'
-2. Use exact variable name from registry
-3. Include serverUrl property if MCP tool
-4. For tools with credentials, import envSettings and use envSettings.getEnvironmentSetting('credential_key')
-5. CRITICAL: Transport must be an OBJECT format: transport: { type: 'streamable_http' } NOT a string
-
-CREDENTIAL HANDLING (CRITICAL):
-If the tool data includes credential information, you MUST:
-1. Import { envSettings } from '../environments'
-2. Use credential: envSettings.getEnvironmentSetting('credential_key') in the tool definition
-3. Convert credential IDs to underscore format (e.g., 'linear-api' -> 'linear_api')
-
-Example for tool with credential:
-\`\`\`typescript
-import { mcpTool } from '@inkeep/agents-sdk';
-import { envSettings } from '../environments';
-
-export const toolName = mcpTool({
-  id: 'tool-id',
-  name: 'Tool Name',
-  serverUrl: 'https://example.com/mcp',
-  credential: envSettings.getEnvironmentSetting('linear_api'), // underscore format
-  transport: { type: 'streamable_http' }
-});
-\`\`\`
-
-Generate ONLY the TypeScript code without markdown.`;
-}
-function createDataComponentPrompt(_componentData, _context, _registryInfo, commonInstructions) {
-  return `Generate TypeScript file for Inkeep data component.
-
-COMPONENT DATA:
-{{DATA}}
-
-${commonInstructions}
-
-DATA COMPONENT API (CRITICAL):
-dataComponent({
-  id: 'component-id',
-  name: 'ComponentName',
-  description: 'Component description',
-  props: z.object({
-    fieldName: z.string().describe('Field description'),
-    optionalField: z.number().optional().describe('Optional field description'),
-  })
-})
-
-REQUIREMENTS:
-1. Import dataComponent from '@inkeep/agents-sdk'
-2. Import z from 'zod' for schema definitions
-3. Use exact variable name from registry
-4. Use 'props' property with Zod schema (NOT JSON Schema)
-5. Include 'id', 'name', and 'description' properties
-6. Use .describe() for field descriptions
-7. Use .optional() for optional fields
-8. Use .nullable() for nullable fields (not z.union([z.string(), z.null()]))
-9. CRITICAL: All imports must be alphabetically sorted to comply with Biome linting
-
-EXAMPLE:
-import { dataComponent } from '@inkeep/agents-sdk';
-import { z } from 'zod';
-
-export const weatherForecast = dataComponent({
-  id: 'weather-forecast',
-  name: 'WeatherForecast',
-  description: 'Hourly weather forecast',
-  props: z.object({
-    forecast: z.array(z.object({
-      time: z.string().describe('The time of current item E.g. 12PM, 1PM'),
-      temperature: z.number().describe('Temperature at given time in Fahrenheit'),
-      code: z.number().describe('Weather code at given time'),
-    })).describe('The hourly forecast for the weather at a given location'),
-  }),
-});
-
-EXAMPLE WITH OPTIONAL FIELDS:
-import { dataComponent } from '@inkeep/agents-sdk';
-import { z } from 'zod';
-
-export const userProfile = dataComponent({
-  id: 'user-profile',
-  name: 'User Profile',
-  description: 'User profile information',
-  props: z.object({
-    userId: z.string().describe('Unique user identifier'),
-    name: z.string().describe('User full name'),
-    email: z.string().email().describe('User email address'),
-    preferences: z.object({
-      theme: z.enum(['light', 'dark']),
-      notifications: z.boolean(),
-    }).optional().describe('User preferences'),
-  }),
-});
-
-Generate ONLY the TypeScript code without markdown.`;
-}
-function createArtifactComponentPrompt(_componentData, _context, _registryInfo, commonInstructions) {
-  return `Generate TypeScript file for Inkeep artifact component.
-
-COMPONENT DATA:
-{{DATA}}
-
-${commonInstructions}
-
-REQUIREMENTS:
-1. Import artifactComponent from '@inkeep/agents-sdk'
-2. Import z from 'zod' and preview from '@inkeep/agents-core'
-3. Use exact variable name from registry
-4. Use preview() for fields shown in previews
-5. Include 'id' property
-
-Generate ONLY the TypeScript code without markdown.`;
-}
-function createStatusComponentPrompt(_componentData, _context, _registryInfo, commonInstructions) {
-  return `Generate TypeScript file for Inkeep status component.
-
-COMPONENT DATA:
-{{DATA}}
-
-${commonInstructions}
-
-REQUIREMENTS:
-1. Import statusComponent from '@inkeep/agents-sdk'
-2. Import z from 'zod' for schema definitions if detailsSchema is present
-3. Use exact variable name from registry
-4. Convert any JSON Schema in detailsSchema to Zod schema
-5. Use 'type' field as the identifier
-6. The statusComponent() function handles .config conversion automatically
-
-EXAMPLE:
-import { statusComponent } from '@inkeep/agents-sdk';
-import { z } from 'zod';
-
-export const toolSummary = statusComponent({
-  type: 'tool_summary',
-  description: 'Summary of tool calls',
-  detailsSchema: z.object({
-    tool_name: z.string().describe('Name of tool used'),
-    summary: z.string().describe('What was accomplished'),
-  }),
-});
-
-Generate ONLY the TypeScript code without markdown.`;
-}
-function formatRegistryForFile(fileInfo, _registry) {
-  let result = "REQUIRED VARIABLE NAMES (YOU MUST USE ONLY THESE EXACT NAMES):\n\n";
-  if (fileInfo.entities.length > 0) {
-    result += "Variables to define in this file:\n";
-    for (const entity of fileInfo.entities) {
-      result += `  - ID "${entity.id}" \u2192 MUST use variable name: ${entity.variableName}
-`;
-    }
-    result += "\n";
+function ensureUniqueSubAgentKeys(agentData) {
+  if (!agentData?.subAgents) {
+    return agentData;
   }
-  if (fileInfo.inlineContent && fileInfo.inlineContent.length > 0) {
-    result += "Inline variables to define in this file:\n";
-    for (const entity of fileInfo.inlineContent) {
-      result += `  - ID "${entity.id}" \u2192 MUST use variable name: ${entity.variableName}
-`;
+  const transformedData = { ...agentData };
+  const transformedSubAgents = {};
+  for (const [subAgentKey, subAgentData] of Object.entries(agentData.subAgents)) {
+    let uniqueKey = subAgentKey;
+    if (subAgentKey === agentData.id) {
+      uniqueKey = `${subAgentKey}_sub`;
     }
-    result += "\n";
+    transformedSubAgents[uniqueKey] = subAgentData;
   }
-  if (fileInfo.dependencies.length > 0) {
-    result += "!!! EXACT IMPORT STATEMENTS - COPY PRECISELY !!!\n";
-    for (const dep of fileInfo.dependencies) {
-      result += `import { ${dep.variableName} } from '${dep.fromPath}';
-`;
-    }
-    result += "\n";
-    result += "!!! WARNING: IDs \u2260 FILE PATHS !!!\n";
-    result += "Entity IDs (with underscores) are NOT the same as file paths (with kebab-case):\n";
-    for (const dep of fileInfo.dependencies) {
-      const entity = fileInfo.entities.find((e2) => e2.variableName === dep.variableName) || fileInfo.inlineContent?.find((e2) => e2.variableName === dep.variableName);
-      if (entity && entity.id !== dep.fromPath.split("/").pop()?.replace(".ts", "")) {
-        result += `- Entity ID: "${entity.id}" \u2192 File path: "${dep.fromPath}"
-`;
-      }
-    }
-    result += "\nCRITICAL: Use the FILE PATHS above, NOT the entity IDs!\n\n";
-  }
-  return result;
-}
-function generateImportMappings2(plan) {
-  let result = "";
-  for (const file of plan.files) {
-    if (file.type !== "index" && file.type !== "environment") {
-      for (const entity of file.entities) {
-        const importPath = `./${file.path.replace(".ts", "")}`;
-        result += `  - ${entity.variableName} from '${importPath}'
-`;
-      }
-    }
-  }
-  return result;
-}
-function createEnvironmentPrompt(credentialData, context, _registryInfo, commonInstructions) {
-  const filePath = context.fileInfo.path || "";
-  const fileName = filePath.split("/").pop() || "";
-  if (fileName === "index.ts") {
-    const environmentFiles = context.plan.files.filter(
-      (f) => f.type === "environment" && f.path !== "environments/index.ts"
-    );
-    const imports = environmentFiles.map((envFile) => {
-      const envEntity = envFile.entities[0];
-      if (envEntity) {
-        return `import { ${envEntity.variableName} } from './${envFile.path.replace("environments/", "").replace(".ts", "")}';`;
-      }
-      return "";
-    }).filter(Boolean).join("\n");
-    const envSettings = environmentFiles.map((envFile) => {
-      const envEntity = envFile.entities[0];
-      return envEntity ? `  ${envEntity.variableName},` : "";
-    }).filter(Boolean).join("\n");
-    return `${commonInstructions}
-
-ENVIRONMENTS INDEX FILE (CRITICAL):
-
-Create an environments/index.ts file that exports environment settings using createEnvironmentSettings.
-
-CREDENTIAL DATA (from project):
-${JSON.stringify(credentialData, null, 2)}
-
-EXACT IMPORT STATEMENTS (MUST USE THESE):
-${imports}
-
-ENVIRONMENTS INDEX STRUCTURE (MUST FOLLOW EXACTLY):
-
-import { createEnvironmentSettings } from '@inkeep/agents-sdk';
-${imports}
-
-export const envSettings = createEnvironmentSettings({
-${envSettings}
-});
-
-CRITICAL RULES:
-1. Import createEnvironmentSettings from '@inkeep/agents-sdk'
-2. Use the EXACT import statements provided above - DO NOT modify them
-3. Use the EXACT variable names in the createEnvironmentSettings object
-4. Export envSettings using createEnvironmentSettings()
-5. Include all environments that have credential files
-
-Generate ONLY the TypeScript code without markdown.`;
-  }
-  const envName = fileName.replace(".env.ts", "") || "development";
-  return `${commonInstructions}
-
-ENVIRONMENT FILE (CRITICAL):
-
-Create an environment file that registers credential settings for the "${envName}" environment.
-
-CREDENTIAL DATA (from project):
-${JSON.stringify(credentialData, null, 2)}
-
-ENVIRONMENT FILE STRUCTURE (MUST FOLLOW EXACTLY):
-
-import { credential, registerEnvironmentSettings } from '@inkeep/agents-sdk';
-
-export const ${envName} = registerEnvironmentSettings({
-  credentials: {
-    CREDENTIAL_KEY: credential({
-      id: 'CREDENTIAL_ID',
-      type: 'CREDENTIAL_TYPE', 
-      credentialStoreId: 'CREDENTIAL_STORE_ID',
-      retrievalParams: {
-        key: 'ENV_VARIABLE_NAME'
-      }
-    })
-  }
-});
-
-CRITICAL RULES:
-1. Import { credential, registerEnvironmentSettings } from '@inkeep/agents-sdk'
-2. Export a const named "${envName}" (matching the environment)
-3. Use registerEnvironmentSettings() wrapper
-4. Create credential() objects for each credential in the data
-5. Convert credential IDs to environment variable keys (e.g., 'linear-api' -> 'LINEAR_API_KEY')
-6. Use exact credential IDs, types, and credentialStoreId from the data provided
-7. Set retrievalParams.key to the environment variable name (uppercase with underscores)
-
-Example for credential with id 'linear-api':
-- Export const: ${envName}
-- Credential key: linear_api (underscore format for object key)
-- retrievalParams.key: 'LINEAR_API_KEY' (uppercase for environment variable)
-
-Generate ONLY the TypeScript code without markdown.`;
+  transformedData.subAgents = transformedSubAgents;
+  return transformedData;
 }
 var init_unified_generator = __esm({
   "src/codegen/unified-generator.ts"() {
@@ -237929,6 +237816,7 @@ var init_plan_storage = __esm({
 // src/index.ts
 init_esm_shims();
 init_env2();
+init_instrumentation();
 import { readFileSync as readFileSync7 } from "fs";
 import { dirname as dirname6, join as join13 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-cli",
-  "version": "0.23.1",
+  "version": "0.23.3",
   "description": "Inkeep CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,6 +27,10 @@
     "@babel/types": "^7.23.0",
     "@clack/prompts": "^0.11.0",
     "@libsql/client": "^0.15.7",
+    "@opentelemetry/api-logs": "^0.206.0",
+    "@opentelemetry/instrumentation": "^0.206.0",
+    "@opentelemetry/sdk-logs": "^0.206.0",
+    "@vercel/otel": "^2.0.1",
     "ai": "5.0.11",
     "ast-types": "^0.14.2",
     "chalk": "^5.3.0",
@@ -40,6 +44,7 @@
     "inquirer": "^9.2.12",
     "inquirer-autocomplete-prompt": "^3.0.1",
     "json-schema-to-zod": "^2.6.1",
+    "langfuse-vercel": "^3.38.6",
     "ora": "^8.0.1",
     "picocolors": "^1.1.1",
     "pino": "^9.11.0",
@@ -47,8 +52,8 @@
     "recast": "^0.23.0",
     "ts-morph": "^26.0.0",
     "tsx": "^4.20.5",
-    "@inkeep/agents-core": "^0.23.1",
-    "@inkeep/agents-sdk": "^0.23.1"
+    "@inkeep/agents-core": "^0.23.3",
+    "@inkeep/agents-sdk": "^0.23.3"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",