@inkeep/agents-cli 0.22.2 → 0.22.4

package/dist/index.js

@@ -82,11 +82,11 @@ var init_models = __esm({
       CLAUDE_OPUS_4_1_20250805: "anthropic/claude-opus-4-1-20250805",
       CLAUDE_SONNET_4_5: "anthropic/claude-sonnet-4-5",
       CLAUDE_SONNET_4_5_20250929: "anthropic/claude-sonnet-4-5-20250929",
-      CLAUDE_SONNET_4: "anthropic/claude-sonnet-4",
+      CLAUDE_SONNET_4: "anthropic/claude-sonnet-4-0",
       CLAUDE_SONNET_4_20250514: "anthropic/claude-sonnet-4-20250514",
-      CLAUDE_3_5_SONNET: "anthropic/claude-3-5-sonnet",
-      CLAUDE_3_5_SONNET_20241022: "anthropic/claude-3-5-sonnet-20241022",
-      CLAUDE_3_5_HAIKU: "anthropic/claude-3-5-haiku",
+      CLAUDE_HAIKU_4_5: "anthropic/claude-haiku-4-5",
+      CLAUDE_HAIKU_4_5_20251001: "anthropic/claude-haiku-4-5-20251001",
+      CLAUDE_3_5_HAIKU: "anthropic/claude-3-5-haiku-latest",
       CLAUDE_3_5_HAIKU_20241022: "anthropic/claude-3-5-haiku-20241022"
     };
     OPENAI_MODELS = {
@@ -5025,7 +5025,7 @@ var require_util = __commonJS({
       return path4;
     }
     exports.normalize = normalize;
-    function join13(aRoot, aPath) {
+    function join14(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -5057,7 +5057,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports.join = join13;
+    exports.join = join14;
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -5230,7 +5230,7 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index2 + 1);
           }
         }
-        sourceURL = join13(urlGenerate(parsed), sourceURL);
+        sourceURL = join14(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -234345,7 +234345,7 @@ ${errorText}`);
             ...emitOperations && { "x-emit-operations": "true" }
           },
           body: JSON.stringify({
-            model: OPENAI_MODELS.GPT_4_1_MINI_20250414,
+            model: OPENAI_MODELS.GPT_4_1_MINI,
             // Required but will be overridden by graph config
             messages: messages2,
             conversationId,
@@ -234612,18 +234612,18 @@ __export(pull_llm_generate_exports, {
   generateTypeScriptFileWithLLM: () => generateTypeScriptFileWithLLM,
   getTypeDefinitions: () => getTypeDefinitions
 });
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "fs";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { createRequire as createRequire2 } from "module";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 import { anthropic, createAnthropic } from "@ai-sdk/anthropic";
 import { createOpenAI, openai } from "@ai-sdk/openai";
 import { generateText } from "ai";
 function getTypeDefinitions() {
   try {
     const sdkPackagePath = require3.resolve("@inkeep/agents-sdk/package.json");
-    const sdkPackageDir = join6(sdkPackagePath, "..");
-    const sdkDtsPath = join6(sdkPackageDir, "dist/index.d.ts");
-    const dtsContent = readFileSync2(sdkDtsPath, "utf-8");
+    const sdkPackageDir = join7(sdkPackagePath, "..");
+    const sdkDtsPath = join7(sdkPackageDir, "dist/index.d.ts");
+    const dtsContent = readFileSync3(sdkDtsPath, "utf-8");
     return `
 TYPESCRIPT TYPE DEFINITIONS (from @inkeep/agents-sdk):
 
@@ -235294,16 +235294,16 @@ export const ${environment} = registerEnvironmentSettings({
   credentials: {${credentialsCode}}
 });
 `;
-  writeFileSync3(join6(environmentsDir, `${environment}.env.ts`), envContent);
+  writeFileSync3(join7(environmentsDir, `${environment}.env.ts`), envContent);
   await updateEnvironmentIndex(environmentsDir, environment);
 }
 async function updateEnvironmentIndex(environmentsDir, environment) {
-  const indexPath = join6(environmentsDir, "index.ts");
-  const { readFileSync: readFileSync7, existsSync: existsSync11 } = await import("fs");
+  const indexPath = join7(environmentsDir, "index.ts");
+  const { readFileSync: readFileSync8, existsSync: existsSync12 } = await import("fs");
   const existingEnvironments = [];
   let existingContent = "";
-  if (existsSync11(indexPath)) {
-    existingContent = readFileSync7(indexPath, "utf-8");
+  if (existsSync12(indexPath)) {
+    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) {
@@ -235484,21 +235484,21 @@ var init_pull_llm_generate = __esm({
   "description": "test test",
   "models": {
     "base": {
-      "model": "${ANTHROPIC_MODELS.CLAUDE_OPUS_4_1_20250805}",
+      "model": "${ANTHROPIC_MODELS.CLAUDE_OPUS_4_1}",
       "providerOptions": {
         "temperature": 0.7,
         "maxTokens": 2096
       }
     },
     "structuredOutput": {
-      "model": "${OPENAI_MODELS.GPT_4_1_MINI_20250414}",
+      "model": "${OPENAI_MODELS.GPT_4_1_MINI}",
       "providerOptions": {
         "temperature": 0.4,
         "maxTokens": 2048
       }
     },
     "summarizer": {
-      "model": "${OPENAI_MODELS.GPT_5_NANO_20250807}",
+      "model": "${OPENAI_MODELS.GPT_5_NANO}",
       "providerOptions": {
         "temperature": 0.8,
         "maxTokens": 1024
@@ -235558,7 +235558,7 @@ var init_pull_llm_generate = __esm({
       "updatedAt": "2025-10-05T16:43:26.813Z",
       "models": {
         "base": {
-          "model": "${ANTHROPIC_MODELS.CLAUDE_SONNET_4_20250514}",
+          "model": "${ANTHROPIC_MODELS.CLAUDE_SONNET_4_5}",
           "providerOptions": {
             "temperature": 0.5
           }
@@ -235899,11 +235899,11 @@ var pattern_analyzer_exports = {};
 __export(pattern_analyzer_exports, {
   analyzeExistingPatterns: () => analyzeExistingPatterns
 });
-import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync4, statSync } from "fs";
+import { join as join8 } from "path";
 async function analyzeExistingPatterns(projectDir) {
-  const indexPath = join7(projectDir, "index.ts");
-  if (!existsSync6(indexPath)) {
+  const indexPath = join8(projectDir, "index.ts");
+  if (!existsSync7(indexPath)) {
     return null;
   }
   const fileStructure = analyzeFileStructure(projectDir);
@@ -235923,18 +235923,18 @@ async function analyzeExistingPatterns(projectDir) {
   };
 }
 function analyzeFileStructure(projectDir) {
-  const hasAgentsDirectory = existsSync6(join7(projectDir, "agents"));
-  const hasToolsDirectory = existsSync6(join7(projectDir, "tools"));
-  const hasDataComponentsDirectory = existsSync6(join7(projectDir, "data-components"));
-  const hasArtifactComponentsDirectory = existsSync6(join7(projectDir, "artifact-components"));
-  const hasEnvironmentsDirectory = existsSync6(join7(projectDir, "environments"));
+  const hasAgentsDirectory = existsSync7(join8(projectDir, "agents"));
+  const hasToolsDirectory = existsSync7(join8(projectDir, "tools"));
+  const hasDataComponentsDirectory = existsSync7(join8(projectDir, "data-components"));
+  const hasArtifactComponentsDirectory = existsSync7(join8(projectDir, "artifact-components"));
+  const hasEnvironmentsDirectory = existsSync7(join8(projectDir, "environments"));
   let toolsLocation = "unknown";
   if (hasToolsDirectory) {
     toolsLocation = "separate";
   } else if (hasAgentsDirectory) {
-    const agentFiles = getFilesInDirectory(join7(projectDir, "agents"), ".ts");
+    const agentFiles = getFilesInDirectory(join8(projectDir, "agents"), ".ts");
     const hasInlineTools = agentFiles.some((file) => {
-      const content = readFileSync3(file, "utf-8");
+      const content = readFileSync4(file, "utf-8");
       return content.includes("functionTool(");
     });
     toolsLocation = hasInlineTools ? "inline" : "unknown";
@@ -235942,8 +235942,8 @@ function analyzeFileStructure(projectDir) {
   const agentsLocation = hasAgentsDirectory ? "flat" : "unknown";
   const allFiles = [
     ...getFilesInDirectory(projectDir, ".ts"),
-    ...hasAgentsDirectory ? getFilesInDirectory(join7(projectDir, "agents"), ".ts") : [],
-    ...hasToolsDirectory ? getFilesInDirectory(join7(projectDir, "tools"), ".ts") : []
+    ...hasAgentsDirectory ? getFilesInDirectory(join8(projectDir, "agents"), ".ts") : [],
+    ...hasToolsDirectory ? getFilesInDirectory(join8(projectDir, "tools"), ".ts") : []
   ];
   const preferredFileNaming = detectFileNamingConvention(allFiles);
   return {
@@ -235988,10 +235988,10 @@ function collectCodeExamples(projectDir, fileStructure) {
     mappings: []
   };
   if (fileStructure.hasAgentsDirectory) {
-    const agentDir = join7(projectDir, "agents");
+    const agentDir = join8(projectDir, "agents");
     const agentFiles = getFilesInDirectory(agentDir, ".ts");
     for (const file of agentFiles.slice(0, 3)) {
-      const content = readFileSync3(file, "utf-8");
+      const content = readFileSync4(file, "utf-8");
       examples.agentFiles.push({ path: file, content });
       const imports = extractImports(content);
       examples.imports.push(...imports);
@@ -236000,18 +236000,18 @@ function collectCodeExamples(projectDir, fileStructure) {
     }
   }
   if (fileStructure.hasToolsDirectory) {
-    const toolsDir = join7(projectDir, "tools");
+    const toolsDir = join8(projectDir, "tools");
     const toolFiles = getFilesInDirectory(toolsDir, ".ts");
     for (const file of toolFiles.slice(0, 3)) {
-      const content = readFileSync3(file, "utf-8");
+      const content = readFileSync4(file, "utf-8");
       examples.toolFiles.push({ path: file, content });
       const mappings = extractVariableMappings(content, file);
       examples.mappings.push(...mappings);
     }
   }
-  const indexPath = join7(projectDir, "index.ts");
-  if (existsSync6(indexPath)) {
-    const content = readFileSync3(indexPath, "utf-8");
+  const indexPath = join8(projectDir, "index.ts");
+  if (existsSync7(indexPath)) {
+    const content = readFileSync4(indexPath, "utf-8");
     const imports = extractImports(content);
     examples.imports.push(...imports);
   }
@@ -236140,13 +236140,13 @@ function mostCommon(arr) {
   return mostCommonItem;
 }
 function getFilesInDirectory(dir, extension) {
-  if (!existsSync6(dir)) {
+  if (!existsSync7(dir)) {
     return [];
   }
   const files = [];
   const entries = readdirSync2(dir);
   for (const entry of entries) {
-    const fullPath = join7(dir, entry);
+    const fullPath = join8(dir, entry);
     const stat = statSync(fullPath);
     if (stat.isDirectory()) {
       files.push(...getFilesInDirectory(fullPath, extension));
@@ -236175,23 +236175,23 @@ __export(display_utils_exports, {
   displayPlanSummary: () => displayPlanSummary,
   displayRecommendedPattern: () => displayRecommendedPattern
 });
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 function displayPlanSummary(plan) {
-  console.log(chalk7.cyan("\n\u{1F4CB} Generation Plan:"));
-  console.log(chalk7.gray(`  \u2022 Total files: ${plan.metadata.totalFiles}`));
-  console.log(chalk7.gray(`  \u2022 New files: ${plan.metadata.newFiles}`));
-  console.log(chalk7.gray(`  \u2022 Updated files: ${plan.metadata.updatedFiles}`));
+  console.log(chalk8.cyan("\n\u{1F4CB} Generation Plan:"));
+  console.log(chalk8.gray(`  \u2022 Total files: ${plan.metadata.totalFiles}`));
+  console.log(chalk8.gray(`  \u2022 New files: ${plan.metadata.newFiles}`));
+  console.log(chalk8.gray(`  \u2022 Updated files: ${plan.metadata.updatedFiles}`));
   if (plan.metadata.conflicts && plan.metadata.conflicts.length > 0) {
-    console.log(chalk7.yellow("\n\u26A0\uFE0F  Variable Name Conflicts Resolved:"));
+    console.log(chalk8.yellow("\n\u26A0\uFE0F  Variable Name Conflicts Resolved:"));
     for (const conflict of plan.metadata.conflicts) {
-      console.log(chalk7.gray(`  \u2022 ID "${conflict.id}" used by ${conflict.types.join(", ")}`));
-      console.log(chalk7.gray("    Resolved to:"));
+      console.log(chalk8.gray(`  \u2022 ID "${conflict.id}" used by ${conflict.types.join(", ")}`));
+      console.log(chalk8.gray("    Resolved to:"));
       for (const [type, name] of Object.entries(conflict.resolvedNames)) {
-        console.log(chalk7.gray(`      - ${type}: ${name}`));
+        console.log(chalk8.gray(`      - ${type}: ${name}`));
       }
     }
   }
-  console.log(chalk7.cyan("\n\u{1F4C4} Files to generate:"));
+  console.log(chalk8.cyan("\n\u{1F4C4} Files to generate:"));
   const filesByType = {
     index: [],
     agent: [],
@@ -236208,130 +236208,130 @@ function displayPlanSummary(plan) {
     filesByType[file.type].push(file);
   }
   if (filesByType.index.length > 0) {
-    console.log(chalk7.gray("\n  Index:"));
+    console.log(chalk8.gray("\n  Index:"));
     for (const file of filesByType.index) {
-      console.log(chalk7.gray(`    \u2022 ${file.path}`));
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
     }
   }
   if (filesByType.agent.length > 0) {
-    console.log(chalk7.gray("\n  Agents:"));
+    console.log(chalk8.gray("\n  Agents:"));
     for (const file of filesByType.agent) {
-      console.log(chalk7.gray(`    \u2022 ${file.path}`));
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
       for (const entity of file.entities) {
         const badge = entity.id !== entity.variableName ? ` (id: "${entity.id}")` : "";
-        console.log(chalk7.gray(`        - ${entity.variableName}${badge}`));
+        console.log(chalk8.gray(`        - ${entity.variableName}${badge}`));
       }
     }
   }
   if (filesByType.tool.length > 0) {
-    console.log(chalk7.gray("\n  Tools:"));
+    console.log(chalk8.gray("\n  Tools:"));
     for (const file of filesByType.tool) {
-      console.log(chalk7.gray(`    \u2022 ${file.path}`));
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
       for (const entity of file.entities) {
         const badge = entity.id !== entity.variableName ? ` (id: "${entity.id}")` : "";
-        console.log(chalk7.gray(`        - ${entity.variableName}${badge}`));
+        console.log(chalk8.gray(`        - ${entity.variableName}${badge}`));
       }
     }
   }
   if (filesByType.dataComponent.length > 0) {
-    console.log(chalk7.gray("\n  Data Components:"));
+    console.log(chalk8.gray("\n  Data Components:"));
     for (const file of filesByType.dataComponent) {
-      console.log(chalk7.gray(`    \u2022 ${file.path}`));
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
       for (const entity of file.entities) {
-        console.log(chalk7.gray(`        - ${entity.variableName}`));
+        console.log(chalk8.gray(`        - ${entity.variableName}`));
       }
     }
   }
   if (filesByType.artifactComponent.length > 0) {
-    console.log(chalk7.gray("\n  Artifact Components:"));
+    console.log(chalk8.gray("\n  Artifact Components:"));
     for (const file of filesByType.artifactComponent) {
-      console.log(chalk7.gray(`    \u2022 ${file.path}`));
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
       for (const entity of file.entities) {
-        console.log(chalk7.gray(`        - ${entity.variableName}`));
+        console.log(chalk8.gray(`        - ${entity.variableName}`));
       }
     }
   }
   if (filesByType.statusComponent.length > 0) {
-    console.log(chalk7.gray("\n  Status Components:"));
+    console.log(chalk8.gray("\n  Status Components:"));
     for (const file of filesByType.statusComponent) {
-      console.log(chalk7.gray(`    \u2022 ${file.path}`));
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
       for (const entity of file.entities) {
-        console.log(chalk7.gray(`        - ${entity.variableName}`));
+        console.log(chalk8.gray(`        - ${entity.variableName}`));
       }
     }
   }
   if (filesByType.environment.length > 0) {
-    console.log(chalk7.gray("\n  Environments:"));
+    console.log(chalk8.gray("\n  Environments:"));
     for (const file of filesByType.environment) {
-      console.log(chalk7.gray(`    \u2022 ${file.path}`));
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
     }
   }
 }
 function displayPatternSummary(patterns) {
-  console.log(chalk7.cyan("\n\u{1F50D} Detected Patterns:"));
-  console.log(chalk7.gray("  File Structure:"));
-  console.log(chalk7.gray(`    \u2022 Tools: ${patterns.fileStructure.toolsLocation}`));
-  console.log(chalk7.gray(`    \u2022 Agents: ${patterns.fileStructure.agentsLocation}`));
-  console.log(chalk7.gray(`    \u2022 File naming: ${patterns.fileStructure.preferredFileNaming}`));
-  console.log(chalk7.gray("  Code Style:"));
-  console.log(chalk7.gray(`    \u2022 Exports: ${patterns.codeStyle.exportNaming}`));
-  console.log(chalk7.gray(`    \u2022 Multi-line strings: ${patterns.codeStyle.multiLineStrings}`));
-  console.log(chalk7.gray(`    \u2022 Imports: ${patterns.codeStyle.importStyle}`));
-  console.log(chalk7.gray("  Naming Conventions:"));
-  console.log(chalk7.gray(`    \u2022 Agent suffix: "${patterns.namingConventions.agentSuffix}"`));
-  console.log(chalk7.gray(`    \u2022 SubAgent suffix: "${patterns.namingConventions.subAgentSuffix}"`));
+  console.log(chalk8.cyan("\n\u{1F50D} Detected Patterns:"));
+  console.log(chalk8.gray("  File Structure:"));
+  console.log(chalk8.gray(`    \u2022 Tools: ${patterns.fileStructure.toolsLocation}`));
+  console.log(chalk8.gray(`    \u2022 Agents: ${patterns.fileStructure.agentsLocation}`));
+  console.log(chalk8.gray(`    \u2022 File naming: ${patterns.fileStructure.preferredFileNaming}`));
+  console.log(chalk8.gray("  Code Style:"));
+  console.log(chalk8.gray(`    \u2022 Exports: ${patterns.codeStyle.exportNaming}`));
+  console.log(chalk8.gray(`    \u2022 Multi-line strings: ${patterns.codeStyle.multiLineStrings}`));
+  console.log(chalk8.gray(`    \u2022 Imports: ${patterns.codeStyle.importStyle}`));
+  console.log(chalk8.gray("  Naming Conventions:"));
+  console.log(chalk8.gray(`    \u2022 Agent suffix: "${patterns.namingConventions.agentSuffix}"`));
+  console.log(chalk8.gray(`    \u2022 SubAgent suffix: "${patterns.namingConventions.subAgentSuffix}"`));
   if (patterns.examples.mappings && patterns.examples.mappings.length > 0) {
     console.log(
-      chalk7.gray(`  Found ${patterns.examples.mappings.length} existing variable mappings`)
+      chalk8.gray(`  Found ${patterns.examples.mappings.length} existing variable mappings`)
     );
   }
 }
 function displayRecommendedPattern() {
-  console.log(chalk7.cyan("\n\u{1F4DD} Using Recommended Pattern:"));
-  console.log(chalk7.gray("  File Structure:"));
-  console.log(chalk7.gray("    \u2022 Tools: separate (tools/ directory)"));
-  console.log(chalk7.gray("    \u2022 Agents: flat (agents/ directory)"));
-  console.log(chalk7.gray("    \u2022 File naming: kebab-case"));
-  console.log(chalk7.gray("  Code Style:"));
-  console.log(chalk7.gray("    \u2022 Exports: camelCase"));
-  console.log(chalk7.gray("    \u2022 Multi-line strings: template-literals"));
-  console.log(chalk7.gray("    \u2022 Imports: named"));
-  console.log(chalk7.gray("  Naming:"));
-  console.log(chalk7.gray('    \u2022 Agent suffix: "Agent"'));
-  console.log(chalk7.gray('    \u2022 SubAgent suffix: "SubAgent"'));
+  console.log(chalk8.cyan("\n\u{1F4DD} Using Recommended Pattern:"));
+  console.log(chalk8.gray("  File Structure:"));
+  console.log(chalk8.gray("    \u2022 Tools: separate (tools/ directory)"));
+  console.log(chalk8.gray("    \u2022 Agents: flat (agents/ directory)"));
+  console.log(chalk8.gray("    \u2022 File naming: kebab-case"));
+  console.log(chalk8.gray("  Code Style:"));
+  console.log(chalk8.gray("    \u2022 Exports: camelCase"));
+  console.log(chalk8.gray("    \u2022 Multi-line strings: template-literals"));
+  console.log(chalk8.gray("    \u2022 Imports: named"));
+  console.log(chalk8.gray("  Naming:"));
+  console.log(chalk8.gray('    \u2022 Agent suffix: "Agent"'));
+  console.log(chalk8.gray('    \u2022 SubAgent suffix: "SubAgent"'));
 }
 function displayGenerationProgress(current, total, fileName) {
   const percentage = Math.round(current / total * 100);
-  console.log(chalk7.gray(`  [${current}/${total}] ${percentage}% - ${fileName}`));
+  console.log(chalk8.gray(`  [${current}/${total}] ${percentage}% - ${fileName}`));
 }
 function displayGenerationComplete(plan, duration) {
-  console.log(chalk7.green("\n\u2728 Files generated successfully!"));
-  console.log(chalk7.gray(`  \u2022 Duration: ${(duration / 1e3).toFixed(2)}s`));
-  console.log(chalk7.gray(`  \u2022 Files: ${plan.metadata.totalFiles}`));
+  console.log(chalk8.green("\n\u2728 Files generated successfully!"));
+  console.log(chalk8.gray(`  \u2022 Duration: ${(duration / 1e3).toFixed(2)}s`));
+  console.log(chalk8.gray(`  \u2022 Files: ${plan.metadata.totalFiles}`));
   const avgPerFile = duration / plan.metadata.totalFiles;
-  console.log(chalk7.gray(`  \u2022 Average: ${(avgPerFile / 1e3).toFixed(2)}s per file`));
+  console.log(chalk8.gray(`  \u2022 Average: ${(avgPerFile / 1e3).toFixed(2)}s per file`));
 }
 function displayConflictWarning(conflicts) {
   if (!conflicts || conflicts.length === 0) {
     return;
   }
-  console.log(chalk7.yellow("\n\u26A0\uFE0F  Variable Name Conflicts:"));
-  console.log(chalk7.yellow("The following IDs are used by multiple entity types:"));
+  console.log(chalk8.yellow("\n\u26A0\uFE0F  Variable Name Conflicts:"));
+  console.log(chalk8.yellow("The following IDs are used by multiple entity types:"));
   for (const conflict of conflicts) {
-    console.log(chalk7.yellow(`
+    console.log(chalk8.yellow(`
   ID: "${conflict.id}"`));
-    console.log(chalk7.gray(`  Used by: ${conflict.types.join(", ")}`));
-    console.log(chalk7.gray("  Variable names assigned:"));
+    console.log(chalk8.gray(`  Used by: ${conflict.types.join(", ")}`));
+    console.log(chalk8.gray("  Variable names assigned:"));
     for (const [type, name] of Object.entries(conflict.resolvedNames)) {
-      console.log(chalk7.gray(`    - ${type}: ${name}`));
+      console.log(chalk8.gray(`    - ${type}: ${name}`));
     }
   }
-  console.log(chalk7.yellow("\nThese conflicts have been automatically resolved with suffixes."));
-  console.log(chalk7.gray("This is normal and ensures TypeScript compilation succeeds.\n"));
+  console.log(chalk8.yellow("\nThese conflicts have been automatically resolved with suffixes."));
+  console.log(chalk8.gray("This is normal and ensures TypeScript compilation succeeds.\n"));
 }
 function displayFileStructureTree(plan, projectRoot) {
-  console.log(chalk7.cyan("\n\u{1F4C1} Generated structure:"));
-  console.log(chalk7.gray(`  ${projectRoot}/`));
+  console.log(chalk8.cyan("\n\u{1F4C1} Generated structure:"));
+  console.log(chalk8.gray(`  ${projectRoot}/`));
   const byDirectory = {};
   for (const file of plan.files) {
     const parts = file.path.split("/");
@@ -236349,16 +236349,16 @@ function displayFileStructureTree(plan, projectRoot) {
     const isLast = i2 === dirs.length - 1;
     if (dir === ".") {
       for (const file of files) {
-        console.log(chalk7.gray(`  \u251C\u2500\u2500 ${file}`));
+        console.log(chalk8.gray(`  \u251C\u2500\u2500 ${file}`));
       }
     } else {
-      console.log(chalk7.gray(`  \u251C\u2500\u2500 ${dir}/`));
+      console.log(chalk8.gray(`  \u251C\u2500\u2500 ${dir}/`));
       for (let j2 = 0; j2 < files.length; j2++) {
         const file = files[j2];
         const isLastFile = j2 === files.length - 1;
         const prefix = isLast ? "      " : "  \u2502   ";
         const branch = isLastFile ? "\u2514\u2500\u2500" : "\u251C\u2500\u2500";
-        console.log(chalk7.gray(`${prefix}${branch} ${file}`));
+        console.log(chalk8.gray(`${prefix}${branch} ${file}`));
       }
     }
   }
@@ -237260,11 +237260,11 @@ __export(plan_storage_exports, {
   planExists: () => planExists,
   savePlan: () => savePlan
 });
-import { existsSync as existsSync7, mkdirSync, readFileSync as readFileSync4, writeFileSync as writeFileSync5 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync8, mkdirSync, readFileSync as readFileSync5, writeFileSync as writeFileSync5 } from "fs";
+import { join as join9 } from "path";
 function savePlan(projectRoot, plan) {
-  const inkeepDir = join8(projectRoot, ".inkeep");
-  if (!existsSync7(inkeepDir)) {
+  const inkeepDir = join9(projectRoot, ".inkeep");
+  if (!existsSync8(inkeepDir)) {
     mkdirSync(inkeepDir, { recursive: true });
   }
   const gitCommit = getGitCommit(projectRoot);
@@ -237277,19 +237277,19 @@ function savePlan(projectRoot, plan) {
     },
     plan
   };
-  const planPath = join8(inkeepDir, "generation-plan.json");
+  const planPath = join9(inkeepDir, "generation-plan.json");
   writeFileSync5(planPath, JSON.stringify(storedPlan, null, 2));
-  const backupPath = join8(inkeepDir, `generation-plan-${Date.now()}.json`);
+  const backupPath = join9(inkeepDir, `generation-plan-${Date.now()}.json`);
   writeFileSync5(backupPath, JSON.stringify(storedPlan, null, 2));
   cleanupOldBackups(inkeepDir);
 }
 function loadPlan(projectRoot) {
-  const planPath = join8(projectRoot, ".inkeep", "generation-plan.json");
-  if (!existsSync7(planPath)) {
+  const planPath = join9(projectRoot, ".inkeep", "generation-plan.json");
+  if (!existsSync8(planPath)) {
     return null;
   }
   try {
-    const content = readFileSync4(planPath, "utf-8");
+    const content = readFileSync5(planPath, "utf-8");
     return JSON.parse(content);
   } catch (error) {
     console.error("Failed to load generation plan:", error);
@@ -237297,8 +237297,8 @@ function loadPlan(projectRoot) {
   }
 }
 function planExists(projectRoot) {
-  const planPath = join8(projectRoot, ".inkeep", "generation-plan.json");
-  return existsSync7(planPath);
+  const planPath = join9(projectRoot, ".inkeep", "generation-plan.json");
+  return existsSync8(planPath);
 }
 function getGitCommit(projectRoot) {
   try {
@@ -237317,8 +237317,8 @@ function cleanupOldBackups(inkeepDir) {
     const { readdirSync: readdirSync3, unlinkSync, statSync: statSync2 } = __require("fs");
     const files = readdirSync3(inkeepDir).filter((f) => f.startsWith("generation-plan-") && f.endsWith(".json")).map((f) => ({
       name: f,
-      path: join8(inkeepDir, f),
-      mtime: statSync2(join8(inkeepDir, f)).mtime.getTime()
+      path: join9(inkeepDir, f),
+      mtime: statSync2(join9(inkeepDir, f)).mtime.getTime()
     })).sort((a, b2) => b2.mtime - a.mtime);
     for (let i2 = 5; i2 < files.length; i2++) {
       unlinkSync(files[i2].path);
@@ -237393,44 +237393,44 @@ function comparePatterns(oldPatterns, newPatterns, diff) {
   }
 }
 function displayPlanDiff(diff) {
-  const chalk11 = __require("chalk");
+  const chalk13 = __require("chalk");
   if (diff.filesAdded.length === 0 && diff.filesRemoved.length === 0 && diff.registryChanges.length === 0 && diff.patternChanges.length === 0) {
-    console.log(chalk11.green("No changes detected"));
+    console.log(chalk13.green("No changes detected"));
     return;
   }
-  console.log(chalk11.cyan("\n\u{1F4DD} Changes since last pull:"));
+  console.log(chalk13.cyan("\n\u{1F4DD} Changes since last pull:"));
   if (diff.filesAdded.length > 0) {
-    console.log(chalk11.green("\n  Files added:"));
+    console.log(chalk13.green("\n  Files added:"));
     for (const file of diff.filesAdded) {
-      console.log(chalk11.green(`    + ${file}`));
+      console.log(chalk13.green(`    + ${file}`));
     }
   }
   if (diff.filesRemoved.length > 0) {
-    console.log(chalk11.red("\n  Files removed:"));
+    console.log(chalk13.red("\n  Files removed:"));
     for (const file of diff.filesRemoved) {
-      console.log(chalk11.red(`    - ${file}`));
+      console.log(chalk13.red(`    - ${file}`));
     }
   }
   if (diff.registryChanges.length > 0) {
-    console.log(chalk11.yellow("\n  Variable name changes:"));
+    console.log(chalk13.yellow("\n  Variable name changes:"));
     for (const change of diff.registryChanges) {
-      console.log(chalk11.yellow(`    \u2022 ${change.type}.${change.id}:`));
-      console.log(chalk11.gray(`      ${change.oldName} \u2192 ${change.newName}`));
+      console.log(chalk13.yellow(`    \u2022 ${change.type}.${change.id}:`));
+      console.log(chalk13.gray(`      ${change.oldName} \u2192 ${change.newName}`));
     }
   }
   if (diff.patternChanges.length > 0) {
-    console.log(chalk11.yellow("\n  Pattern changes:"));
+    console.log(chalk13.yellow("\n  Pattern changes:"));
     for (const change of diff.patternChanges) {
-      console.log(chalk11.yellow(`    \u2022 ${change.field}:`));
-      console.log(chalk11.gray(`      ${change.oldValue} \u2192 ${change.newValue}`));
+      console.log(chalk13.yellow(`    \u2022 ${change.field}:`));
+      console.log(chalk13.gray(`      ${change.oldValue} \u2192 ${change.newValue}`));
     }
   }
 }
 function ensureGitignore(projectRoot) {
-  const gitignorePath = join8(projectRoot, ".gitignore");
+  const gitignorePath = join9(projectRoot, ".gitignore");
   let content = "";
-  if (existsSync7(gitignorePath)) {
-    content = readFileSync4(gitignorePath, "utf-8");
+  if (existsSync8(gitignorePath)) {
+    content = readFileSync5(gitignorePath, "utf-8");
   }
   if (content.includes(".inkeep")) {
     return;
@@ -237451,11 +237451,11 @@ __export(chat_enhanced_exports, {
   chatCommandEnhanced: () => chatCommandEnhanced
 });
 import * as readline from "readline";
-import chalk10 from "chalk";
+import chalk12 from "chalk";
 import inquirer2 from "inquirer";
-import ora7 from "ora";
+import ora8 from "ora";
 async function chatCommandEnhanced(agentIdInput, options) {
-  console.log(chalk10.cyan("\u{1F916} Inkeep Chat Interface\n"));
+  console.log(chalk12.cyan("\u{1F916} Inkeep Chat Interface\n"));
   const configPath = options?.config || options?.configFilePath;
   const { config } = await initializeCommand({
     configPath,
@@ -237475,18 +237475,18 @@ async function chatCommandEnhanced(agentIdInput, options) {
   );
   let agentId = agentIdInput;
   if (!agentId) {
-    const spinner2 = ora7("Fetching available agent...").start();
+    const spinner2 = ora8("Fetching available agent...").start();
     try {
       const agent = await managementApi.listAgents();
       spinner2.stop();
       if (agent.length === 0) {
         console.error(
-          chalk10.red("No agent available. Define agent in your project and run: inkeep push")
+          chalk12.red("No agent available. Define agent in your project and run: inkeep push")
         );
         process.exit(1);
       }
       const agentChoices = agent.map((g) => ({
-        name: `${chalk10.cyan(g.id)} - ${g.name || "Unnamed Agent"}`,
+        name: `${chalk12.cyan(g.id)} - ${g.name || "Unnamed Agent"}`,
         value: g.id,
         short: g.id,
         searchText: `${g.id} ${g.name || ""}`.toLowerCase()
@@ -237503,11 +237503,11 @@ async function chatCommandEnhanced(agentIdInput, options) {
       agentId = answer.agentId;
     } catch (error) {
       spinner2.fail("Failed to fetch agent");
-      console.error(chalk10.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(chalk12.red("Error:"), error instanceof Error ? error.message : error);
       process.exit(1);
     }
   }
-  const spinner = ora7("Connecting to agent...").start();
+  const spinner = ora8("Connecting to agent...").start();
   try {
     if (!agentId) {
       throw new Error("No agent selected");
@@ -237517,38 +237517,38 @@ async function chatCommandEnhanced(agentIdInput, options) {
       spinner.fail(`Agent "${agentId}" not found`);
       const agent2 = await managementApi.listAgents();
       if (agent2.length > 0) {
-        console.log(chalk10.yellow("\nAvailable agent:"));
+        console.log(chalk12.yellow("\nAvailable agent:"));
         agent2.forEach((g) => {
-          console.log(chalk10.gray(`  \u2022 ${g.id} - ${g.name || "Unnamed"}`));
+          console.log(chalk12.gray(`  \u2022 ${g.id} - ${g.name || "Unnamed"}`));
         });
-        console.log(chalk10.gray('\nRun "inkeep chat" without arguments for interactive selection'));
+        console.log(chalk12.gray('\nRun "inkeep chat" without arguments for interactive selection'));
       } else {
-        console.log(chalk10.yellow("\nNo agent found. Please define agent and push your project."));
+        console.log(chalk12.yellow("\nNo agent found. Please define agent and push your project."));
       }
       process.exit(1);
     }
-    spinner.succeed(`Connected to agent: ${chalk10.green(agent.name || agentId)}`);
+    spinner.succeed(`Connected to agent: ${chalk12.green(agent.name || agentId)}`);
     if (agent.description) {
-      console.log(chalk10.gray(`Description: ${agent.description}`));
+      console.log(chalk12.gray(`Description: ${agent.description}`));
     }
     if (agent.defaultSubAgentId) {
-      console.log(chalk10.gray(`Default Agent: ${agent.defaultSubAgentId}`));
+      console.log(chalk12.gray(`Default Agent: ${agent.defaultSubAgentId}`));
     }
   } catch (error) {
     spinner.fail("Failed to connect to agent");
-    console.error(chalk10.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk12.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
-    prompt: chalk10.cyan("You> ")
+    prompt: chalk12.cyan("You> ")
   });
   const conversationId = `cli-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
   const messages2 = [];
   let emitOperations = false;
-  console.log(chalk10.gray('\n\u{1F4AC} Chat session started. Type "exit" or press Ctrl+C to quit.'));
-  console.log(chalk10.gray("Commands: help, clear, history, reset, operations\n"));
+  console.log(chalk12.gray('\n\u{1F4AC} Chat session started. Type "exit" or press Ctrl+C to quit.'));
+  console.log(chalk12.gray("Commands: help, clear, history, reset, operations\n"));
   async function handleStreamingResponse(stream, showDebug = false) {
     const decoder = new TextDecoder();
     const reader = stream.getReader();
@@ -237615,12 +237615,12 @@ async function chatCommandEnhanced(agentIdInput, options) {
                         if (opType === "completion" && hasStartedResponse) {
                           console.log("");
                         }
-                        console.log(chalk10.gray(`  [${opType}] ${displayText}`));
+                        console.log(chalk12.gray(`  [${opType}] ${displayText}`));
                       }
                       currentPos = jsonEnd;
                     } catch {
                       if (!hasStartedResponse) {
-                        process.stdout.write(chalk10.green("Assistant> "));
+                        process.stdout.write(chalk12.green("Assistant> "));
                         hasStartedResponse = true;
                       }
                       process.stdout.write(content[currentPos]);
@@ -237629,7 +237629,7 @@ async function chatCommandEnhanced(agentIdInput, options) {
                     }
                   } else {
                     if (!hasStartedResponse) {
-                      process.stdout.write(chalk10.green("Assistant> "));
+                      process.stdout.write(chalk12.green("Assistant> "));
                       hasStartedResponse = true;
                     }
                     process.stdout.write(content[currentPos]);
@@ -237649,7 +237649,7 @@ async function chatCommandEnhanced(agentIdInput, options) {
     if (hasStartedResponse) {
       console.log("\n");
     } else {
-      console.log(`${chalk10.green("Assistant> ") + chalk10.gray("(no response)")}
+      console.log(`${chalk12.green("Assistant> ") + chalk12.gray("(no response)")}
 `);
     }
     return responseContent;
@@ -237658,49 +237658,49 @@ async function chatCommandEnhanced(agentIdInput, options) {
     const trimmedInput = input.trim();
     const command = trimmedInput.toLowerCase().replace(/^\//, "");
     if (command === "exit") {
-      console.log(chalk10.gray("Goodbye! \u{1F44B}"));
+      console.log(chalk12.gray("Goodbye! \u{1F44B}"));
       rl.close();
       process.exit(0);
     }
     if (command === "clear") {
       console.clear();
-      console.log(chalk10.gray("Screen cleared. Conversation context preserved.\n"));
+      console.log(chalk12.gray("Screen cleared. Conversation context preserved.\n"));
       rl.prompt();
       return;
     }
     if (command === "help") {
-      console.log(chalk10.cyan("\n\u{1F4DA} Available commands:"));
-      console.log(chalk10.gray("  \u2022 exit     - End the chat session"));
-      console.log(chalk10.gray("  \u2022 clear    - Clear the screen (preserves context)"));
-      console.log(chalk10.gray("  \u2022 history  - Show conversation history"));
-      console.log(chalk10.gray("  \u2022 reset    - Reset conversation context"));
+      console.log(chalk12.cyan("\n\u{1F4DA} Available commands:"));
+      console.log(chalk12.gray("  \u2022 exit     - End the chat session"));
+      console.log(chalk12.gray("  \u2022 clear    - Clear the screen (preserves context)"));
+      console.log(chalk12.gray("  \u2022 history  - Show conversation history"));
+      console.log(chalk12.gray("  \u2022 reset    - Reset conversation context"));
       console.log(
-        chalk10.gray("  \u2022 operations - Toggle emit operations (show/hide data operations)")
+        chalk12.gray("  \u2022 operations - Toggle emit operations (show/hide data operations)")
       );
-      console.log(chalk10.gray("  \u2022 help     - Show this help message"));
-      console.log(chalk10.gray("\n  Commands can be prefixed with / (e.g., /help)\n"));
+      console.log(chalk12.gray("  \u2022 help     - Show this help message"));
+      console.log(chalk12.gray("\n  Commands can be prefixed with / (e.g., /help)\n"));
       rl.prompt();
       return;
     }
     if (command === "operations") {
       emitOperations = !emitOperations;
-      console.log(chalk10.yellow(`
+      console.log(chalk12.yellow(`
 \u{1F527} Data operations: ${emitOperations ? "ON" : "OFF"}`));
       if (emitOperations) {
-        console.log(chalk10.gray("Data operations will be shown during responses.\n"));
+        console.log(chalk12.gray("Data operations will be shown during responses.\n"));
       } else {
-        console.log(chalk10.gray("Data operations are hidden.\n"));
+        console.log(chalk12.gray("Data operations are hidden.\n"));
       }
       rl.prompt();
       return;
     }
     if (command === "history") {
-      console.log(chalk10.cyan("\n\u{1F4DC} Conversation History:"));
+      console.log(chalk12.cyan("\n\u{1F4DC} Conversation History:"));
       if (messages2.length === 0) {
-        console.log(chalk10.gray("  (No messages yet)\n"));
+        console.log(chalk12.gray("  (No messages yet)\n"));
       } else {
         messages2.forEach((msg, idx) => {
-          const role = msg.role === "user" ? chalk10.blue("You") : chalk10.green("Assistant");
+          const role = msg.role === "user" ? chalk12.blue("You") : chalk12.green("Assistant");
           const preview = msg.content.substring(0, 100);
           const suffix = msg.content.length > 100 ? "..." : "";
           console.log(`  ${idx + 1}. ${role}: ${preview}${suffix}`);
@@ -237712,7 +237712,7 @@ async function chatCommandEnhanced(agentIdInput, options) {
     }
     if (command === "reset") {
       messages2.length = 0;
-      console.log(chalk10.yellow("\u26A0\uFE0F  Conversation context has been reset.\n"));
+      console.log(chalk12.yellow("\u26A0\uFE0F  Conversation context has been reset.\n"));
       rl.prompt();
       return;
     }
@@ -237731,23 +237731,23 @@ async function chatCommandEnhanced(agentIdInput, options) {
       );
       let assistantResponse;
       if (typeof response === "string") {
-        console.log(chalk10.green("Assistant>"), response);
+        console.log(chalk12.green("Assistant>"), response);
         assistantResponse = response;
       } else {
         assistantResponse = await handleStreamingResponse(response, emitOperations);
       }
       messages2.push({ role: "assistant", content: assistantResponse });
     } catch (error) {
-      console.error(chalk10.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(chalk12.red("Error:"), error instanceof Error ? error.message : error);
     }
     rl.prompt();
   });
   rl.on("close", () => {
-    console.log(chalk10.gray("\n\u{1F4CA} Session Summary:"));
-    console.log(chalk10.gray(`  \u2022 Agent: ${agentId}`));
-    console.log(chalk10.gray(`  \u2022 Messages: ${messages2.length}`));
-    console.log(chalk10.gray(`  \u2022 Duration: ${(/* @__PURE__ */ new Date()).toLocaleTimeString()}`));
-    console.log(chalk10.gray("\nChat session ended."));
+    console.log(chalk12.gray("\n\u{1F4CA} Session Summary:"));
+    console.log(chalk12.gray(`  \u2022 Agent: ${agentId}`));
+    console.log(chalk12.gray(`  \u2022 Messages: ${messages2.length}`));
+    console.log(chalk12.gray(`  \u2022 Duration: ${(/* @__PURE__ */ new Date()).toLocaleTimeString()}`));
+    console.log(chalk12.gray("\nChat session ended."));
     process.exit(0);
   });
   rl.prompt();
@@ -237792,9 +237792,9 @@ ${error.message}`
 var env2 = parseEnv2();
 
 // src/index.ts
-import { readFileSync as readFileSync6 } from "fs";
-import { dirname as dirname5, join as join12 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { readFileSync as readFileSync7 } from "fs";
+import { dirname as dirname6, join as join13 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 import { Command } from "commander";
 
 // src/commands/add.ts
@@ -237998,24 +237998,24 @@ var defaultGoogleModelConfigurations = {
 };
 var defaultOpenaiModelConfigurations = {
   base: {
-    model: OPENAI_MODELS.GPT_4_1_20250414
+    model: OPENAI_MODELS.GPT_4_1
   },
   structuredOutput: {
-    model: OPENAI_MODELS.GPT_4_1_MINI_20250414
+    model: OPENAI_MODELS.GPT_4_1_MINI
   },
   summarizer: {
-    model: OPENAI_MODELS.GPT_4_1_NANO_20250414
+    model: OPENAI_MODELS.GPT_4_1_NANO
   }
 };
 var defaultAnthropicModelConfigurations = {
   base: {
-    model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5_20250929
+    model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5
   },
   structuredOutput: {
-    model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5_20250929
+    model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5
   },
   summarizer: {
-    model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5_20250929
+    model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5
   }
 };
 async function addCommand(options) {
@@ -238643,9 +238643,9 @@ ${table.toString()}`);
 init_esm_shims();
 init_src();
 init_api();
-import { existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "fs";
-import { dirname as dirname4, join as join9, resolve as resolve4 } from "path";
-import chalk8 from "chalk";
+import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
+import { dirname as dirname5, join as join10, resolve as resolve4 } from "path";
+import chalk9 from "chalk";
 import ora5 from "ora";
 import prompts from "prompts";
 init_config();
@@ -238685,29 +238685,117 @@ async function findProjectDirectory(projectId, configPath) {
 
 // src/commands/pull.ts
 init_tsx_loader();
+
+// src/utils/background-version-check.ts
+init_esm_shims();
+import chalk7 from "chalk";
+
+// src/utils/version-check.ts
+init_esm_shims();
+import { existsSync as existsSync6, readFileSync as readFileSync2 } from "fs";
+import { dirname as dirname4, join as join6 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __filename2 = fileURLToPath2(import.meta.url);
+var __dirname2 = dirname4(__filename2);
+var DEFAULT_PACKAGE_NAME = "@inkeep/agents-cli";
+function getCurrentVersion() {
+  let packageJsonPath2 = join6(__dirname2, "..", "package.json");
+  if (!existsSync6(packageJsonPath2)) {
+    packageJsonPath2 = join6(__dirname2, "..", "..", "package.json");
+  }
+  const packageJson2 = JSON.parse(readFileSync2(packageJsonPath2, "utf-8"));
+  return packageJson2.version;
+}
+async function getLatestVersion(packageName = DEFAULT_PACKAGE_NAME) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), 1e4);
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`, {
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to fetch latest version: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.version;
+  } catch (error) {
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new Error("Unable to check for updates: Request timed out after 10 seconds");
+    }
+    throw new Error(
+      `Unable to check for updates: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+function compareVersions(v1, v2) {
+  const cleanV1 = v1.split("-")[0].split("+")[0];
+  const cleanV2 = v2.split("-")[0].split("+")[0];
+  const parts1 = cleanV1.split(".").map(Number);
+  const parts2 = cleanV2.split(".").map(Number);
+  for (let i2 = 0; i2 < Math.max(parts1.length, parts2.length); i2++) {
+    const part1 = parts1[i2] || 0;
+    const part2 = parts2[i2] || 0;
+    if (part1 < part2) return -1;
+    if (part1 > part2) return 1;
+  }
+  return 0;
+}
+async function checkForUpdate() {
+  const current = getCurrentVersion();
+  const latest = await getLatestVersion();
+  const needsUpdate = compareVersions(current, latest) < 0;
+  return {
+    current,
+    latest,
+    needsUpdate
+  };
+}
+function getChangelogUrl() {
+  return `https://github.com/inkeep/agents/blob/main/agents-cli/CHANGELOG.md`;
+}
+
+// src/utils/background-version-check.ts
+function performBackgroundVersionCheck() {
+  checkForUpdate().then((versionInfo) => {
+    if (versionInfo.needsUpdate) {
+      console.log(
+        chalk7.yellow(
+          `
+\u26A0\uFE0F  A new version of @inkeep/agents-cli is available: ${versionInfo.latest} (current: ${versionInfo.current})`
+        )
+      );
+      console.log(chalk7.gray("   Run `inkeep update` to upgrade to the latest version\n"));
+    }
+  }).catch(() => {
+  });
+}
+
+// src/commands/pull.ts
 init_pull_llm_generate();
 async function detectCurrentProject(debug = false) {
-  const indexPath = join9(process.cwd(), "index.ts");
+  const indexPath = join10(process.cwd(), "index.ts");
   if (debug) {
-    console.log(chalk8.gray(`
+    console.log(chalk9.gray(`
 [DEBUG] Detecting project in current directory...`));
-    console.log(chalk8.gray(`  \u2022 Current directory: ${process.cwd()}`));
-    console.log(chalk8.gray(`  \u2022 Looking for: ${indexPath}`));
+    console.log(chalk9.gray(`  \u2022 Current directory: ${process.cwd()}`));
+    console.log(chalk9.gray(`  \u2022 Looking for: ${indexPath}`));
   }
-  if (!existsSync8(indexPath)) {
+  if (!existsSync9(indexPath)) {
     if (debug) {
-      console.log(chalk8.gray(`  \u2022 index.ts not found`));
+      console.log(chalk9.gray(`  \u2022 index.ts not found`));
     }
     return null;
   }
   if (debug) {
-    console.log(chalk8.gray(`  \u2022 index.ts found, attempting to import...`));
+    console.log(chalk9.gray(`  \u2022 index.ts found, attempting to import...`));
   }
   try {
     const module = await importWithTypeScriptSupport(indexPath);
     if (debug) {
-      console.log(chalk8.gray(`  \u2022 Module imported successfully`));
-      console.log(chalk8.gray(`  \u2022 Exports found: ${Object.keys(module).join(", ")}`));
+      console.log(chalk9.gray(`  \u2022 Module imported successfully`));
+      console.log(chalk9.gray(`  \u2022 Exports found: ${Object.keys(module).join(", ")}`));
     }
     const exports = Object.keys(module);
     for (const exportKey of exports) {
@@ -238717,7 +238805,7 @@ async function detectCurrentProject(debug = false) {
           const projectId = value.getId();
           if (debug) {
             console.log(
-              chalk8.gray(`  \u2022 Project detected: ${projectId} (from export: ${exportKey})`)
+              chalk9.gray(`  \u2022 Project detected: ${projectId} (from export: ${exportKey})`)
             );
           }
           return projectId;
@@ -238725,31 +238813,31 @@ async function detectCurrentProject(debug = false) {
       }
     }
     if (debug) {
-      console.log(chalk8.gray(`  \u2022 No project export found in module`));
+      console.log(chalk9.gray(`  \u2022 No project export found in module`));
     }
     return null;
   } catch (error) {
     if (debug) {
-      console.log(chalk8.gray(`  \u2022 Failed to import: ${error.message}`));
-      console.log(chalk8.gray(`  \u2022 Falling back to static file parsing...`));
+      console.log(chalk9.gray(`  \u2022 Failed to import: ${error.message}`));
+      console.log(chalk9.gray(`  \u2022 Falling back to static file parsing...`));
     }
     try {
-      const content = readFileSync5(indexPath, "utf-8");
+      const content = readFileSync6(indexPath, "utf-8");
       const projectIdMatch = content.match(/project\s*\(\s*\{\s*id\s*:\s*['"]([^'"]+)['"]/);
       if (projectIdMatch?.[1]) {
         const projectId = projectIdMatch[1];
         if (debug) {
-          console.log(chalk8.gray(`  \u2022 Project ID extracted from static parse: ${projectId}`));
+          console.log(chalk9.gray(`  \u2022 Project ID extracted from static parse: ${projectId}`));
         }
         return projectId;
       }
       if (debug) {
-        console.log(chalk8.gray(`  \u2022 Could not find project ID in file content`));
+        console.log(chalk9.gray(`  \u2022 Could not find project ID in file content`));
       }
       return null;
     } catch (parseError) {
       if (debug) {
-        console.log(chalk8.gray(`  \u2022 Static parsing failed: ${parseError.message}`));
+        console.log(chalk9.gray(`  \u2022 Static parsing failed: ${parseError.message}`));
       }
       return null;
     }
@@ -238759,12 +238847,12 @@ async function verifyGeneratedFiles(projectDir, originalProjectData, debug = fal
   const errors = [];
   const warnings = [];
   try {
-    const indexPath = join9(projectDir, "index.ts");
-    if (!existsSync8(indexPath)) {
+    const indexPath = join10(projectDir, "index.ts");
+    if (!existsSync9(indexPath)) {
       errors.push("Generated index.ts file not found");
       return { success: false, errors, warnings };
     }
-    const indexContent = readFileSync5(indexPath, "utf-8");
+    const indexContent = readFileSync6(indexPath, "utf-8");
     if (!indexContent.includes("project(")) {
       errors.push("index.ts does not contain a project() call");
     }
@@ -238777,78 +238865,78 @@ async function verifyGeneratedFiles(projectDir, originalProjectData, debug = fal
         );
       }
       if (debug) {
-        console.log(chalk8.gray(`
+        console.log(chalk9.gray(`
 \u2713 Project ID verified: ${extractedProjectId}`));
       }
     } else {
       warnings.push("Could not extract project ID from index.ts");
     }
-    const agentsDir = join9(projectDir, "agents");
+    const agentsDir = join10(projectDir, "agents");
     const expectedAgents = Object.keys(originalProjectData.agents || {});
     for (const agentId of expectedAgents) {
       const kebabCaseId = agentId.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
-      const agentPath = join9(agentsDir, `${kebabCaseId}.ts`);
-      if (!existsSync8(agentPath)) {
+      const agentPath = join10(agentsDir, `${kebabCaseId}.ts`);
+      if (!existsSync9(agentPath)) {
         errors.push(`Agent file not found: agents/${kebabCaseId}.ts`);
       } else if (debug) {
-        console.log(chalk8.gray(`  \u2713 Agent file exists: agents/${kebabCaseId}.ts`));
+        console.log(chalk9.gray(`  \u2713 Agent file exists: agents/${kebabCaseId}.ts`));
       }
     }
-    const toolsDir = join9(projectDir, "tools");
+    const toolsDir = join10(projectDir, "tools");
     const expectedTools = Object.keys(originalProjectData.tools || {});
     for (const toolId of expectedTools) {
       const kebabCaseId = toolId.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
-      const toolPath = join9(toolsDir, `${kebabCaseId}.ts`);
-      if (!existsSync8(toolPath)) {
+      const toolPath = join10(toolsDir, `${kebabCaseId}.ts`);
+      if (!existsSync9(toolPath)) {
         errors.push(`Tool file not found: tools/${kebabCaseId}.ts`);
       } else if (debug) {
-        console.log(chalk8.gray(`  \u2713 Tool file exists: tools/${kebabCaseId}.ts`));
+        console.log(chalk9.gray(`  \u2713 Tool file exists: tools/${kebabCaseId}.ts`));
       }
     }
-    const dataComponentsDir = join9(projectDir, "data-components");
+    const dataComponentsDir = join10(projectDir, "data-components");
     const expectedDataComponents = Object.keys(originalProjectData.dataComponents || {});
     for (const componentId of expectedDataComponents) {
       const kebabCaseId = componentId.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
-      const componentPath = join9(dataComponentsDir, `${kebabCaseId}.ts`);
-      if (!existsSync8(componentPath)) {
+      const componentPath = join10(dataComponentsDir, `${kebabCaseId}.ts`);
+      if (!existsSync9(componentPath)) {
         errors.push(`Data component file not found: data-components/${kebabCaseId}.ts`);
       } else if (debug) {
         console.log(
-          chalk8.gray(`  \u2713 Data component file exists: data-components/${kebabCaseId}.ts`)
+          chalk9.gray(`  \u2713 Data component file exists: data-components/${kebabCaseId}.ts`)
         );
       }
     }
-    const environmentsDir = join9(projectDir, "environments");
+    const environmentsDir = join10(projectDir, "environments");
     const hasCredentials = Object.keys(originalProjectData.credentialReferences || {}).length > 0;
-    if (!existsSync8(environmentsDir)) {
+    if (!existsSync9(environmentsDir)) {
       if (hasCredentials) {
         errors.push("Environments directory not found (expected with credentials)");
       } else {
         warnings.push("Environments directory not found (no credentials defined)");
       }
     } else {
-      const envIndexPath = join9(environmentsDir, "index.ts");
-      if (!existsSync8(envIndexPath)) {
+      const envIndexPath = join10(environmentsDir, "index.ts");
+      if (!existsSync9(envIndexPath)) {
         if (hasCredentials) {
           errors.push("Environment index.ts not found (expected with credentials)");
         } else {
           if (debug) {
-            console.log(chalk8.gray(`  \u2022 Environments directory exists but empty (no credentials)`));
+            console.log(chalk9.gray(`  \u2022 Environments directory exists but empty (no credentials)`));
           }
         }
       }
     }
     if (debug) {
-      console.log(chalk8.gray("\n\u{1F50D} Verification Summary:"));
-      console.log(chalk8.gray(`  \u2022 index.ts: ${existsSync8(indexPath) ? "\u2713" : "\u2717"}`));
+      console.log(chalk9.gray("\n\u{1F50D} Verification Summary:"));
+      console.log(chalk9.gray(`  \u2022 index.ts: ${existsSync9(indexPath) ? "\u2713" : "\u2717"}`));
       console.log(
-        chalk8.gray(`  \u2022 Agent files: ${expectedAgents.length}/${expectedAgents.length} found`)
+        chalk9.gray(`  \u2022 Agent files: ${expectedAgents.length}/${expectedAgents.length} found`)
       );
       console.log(
-        chalk8.gray(`  \u2022 Tool files: ${expectedTools.length}/${expectedTools.length} found`)
+        chalk9.gray(`  \u2022 Tool files: ${expectedTools.length}/${expectedTools.length} found`)
       );
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `  \u2022 Data component files: ${expectedDataComponents.length}/${expectedDataComponents.length} found`
         )
       );
@@ -238860,8 +238948,8 @@ async function verifyGeneratedFiles(projectDir, originalProjectData, debug = fal
   }
 }
 async function loadProjectConfig(projectDir, configPathOverride) {
-  const configPath = configPathOverride ? resolve4(process.cwd(), configPathOverride) : join9(projectDir, "inkeep.config.ts");
-  if (!existsSync8(configPath)) {
+  const configPath = configPathOverride ? resolve4(process.cwd(), configPathOverride) : join10(projectDir, "inkeep.config.ts");
+  if (!existsSync9(configPath)) {
     throw new Error(`Configuration file not found: ${configPath}`);
   }
   try {
@@ -238886,7 +238974,7 @@ async function loadProjectConfig(projectDir, configPathOverride) {
   }
 }
 function ensureDirectoryExists(dirPath) {
-  if (!existsSync8(dirPath)) {
+  if (!existsSync9(dirPath)) {
     mkdirSync2(dirPath, { recursive: true });
   }
 }
@@ -238896,14 +238984,14 @@ function createProjectStructure(projectDir, projectId, useCurrentDirectory = fal
     projectRoot = projectDir;
   } else {
     const dirName = projectDir.split("/").pop() || projectDir;
-    projectRoot = dirName === projectId ? projectDir : join9(projectDir, projectId);
+    projectRoot = dirName === projectId ? projectDir : join10(projectDir, projectId);
   }
-  const agentsDir = join9(projectRoot, "agents");
-  const toolsDir = join9(projectRoot, "tools");
-  const dataComponentsDir = join9(projectRoot, "data-components");
-  const artifactComponentsDir = join9(projectRoot, "artifact-components");
-  const statusComponentsDir = join9(projectRoot, "status-components");
-  const environmentsDir = join9(projectRoot, "environments");
+  const agentsDir = join10(projectRoot, "agents");
+  const toolsDir = join10(projectRoot, "tools");
+  const dataComponentsDir = join10(projectRoot, "data-components");
+  const artifactComponentsDir = join10(projectRoot, "artifact-components");
+  const statusComponentsDir = join10(projectRoot, "status-components");
+  const environmentsDir = join10(projectRoot, "environments");
   ensureDirectoryExists(projectRoot);
   ensureDirectoryExists(agentsDir);
   ensureDirectoryExists(toolsDir);
@@ -238922,13 +239010,14 @@ function createProjectStructure(projectDir, projectId, useCurrentDirectory = fal
   };
 }
 async function pullProjectCommand(options) {
+  performBackgroundVersionCheck();
   if (!env2.ANTHROPIC_API_KEY) {
     console.error(
-      chalk8.red("Error: ANTHROPIC_API_KEY environment variable is required for the pull command.")
+      chalk9.red("Error: ANTHROPIC_API_KEY environment variable is required for the pull command.")
     );
-    console.error(chalk8.gray("Please set your Anthropic API key:"));
-    console.error(chalk8.gray("  export ANTHROPIC_API_KEY=your_api_key_here"));
-    console.error(chalk8.gray("  or add it to your .env file"));
+    console.error(chalk9.gray("Please set your Anthropic API key:"));
+    console.error(chalk9.gray("  export ANTHROPIC_API_KEY=your_api_key_here"));
+    console.error(chalk9.gray("  or add it to your .env file"));
     process.exit(1);
   }
   const spinner = ora5("Loading configuration...").start();
@@ -238939,15 +239028,15 @@ async function pullProjectCommand(options) {
     const searchDir = process.cwd();
     if (options.config) {
       const configPath = resolve4(process.cwd(), options.config);
-      if (existsSync8(configPath)) {
+      if (existsSync9(configPath)) {
         try {
-          config = await loadProjectConfig(dirname4(configPath), options.config);
+          config = await loadProjectConfig(dirname5(configPath), options.config);
           configFound = true;
           configLocation = configPath;
         } catch (error) {
           spinner.fail("Failed to load specified configuration file");
           console.error(
-            chalk8.red(`Error: ${error instanceof Error ? error.message : String(error)}`)
+            chalk9.red(`Error: ${error instanceof Error ? error.message : String(error)}`)
           );
           process.exit(1);
         }
@@ -238957,8 +239046,8 @@ async function pullProjectCommand(options) {
       }
     }
     if (!configFound) {
-      const currentConfigPath = join9(searchDir, "inkeep.config.ts");
-      if (existsSync8(currentConfigPath)) {
+      const currentConfigPath = join10(searchDir, "inkeep.config.ts");
+      if (existsSync9(currentConfigPath)) {
         try {
           config = await loadProjectConfig(searchDir);
           configFound = true;
@@ -238968,10 +239057,10 @@ async function pullProjectCommand(options) {
         }
       }
       if (!configFound) {
-        const parentConfigPath = join9(searchDir, "..", "inkeep.config.ts");
-        if (existsSync8(parentConfigPath)) {
+        const parentConfigPath = join10(searchDir, "..", "inkeep.config.ts");
+        if (existsSync9(parentConfigPath)) {
           try {
-            config = await loadProjectConfig(join9(searchDir, ".."));
+            config = await loadProjectConfig(join10(searchDir, ".."));
             configFound = true;
             configLocation = parentConfigPath;
           } catch (_error) {
@@ -238984,7 +239073,7 @@ async function pullProjectCommand(options) {
         const foundConfigPath = await findUp2("inkeep.config.ts", { cwd: searchDir });
         if (foundConfigPath) {
           try {
-            config = await loadProjectConfig(dirname4(foundConfigPath));
+            config = await loadProjectConfig(dirname5(foundConfigPath));
             configFound = true;
             configLocation = foundConfigPath;
           } catch (_error) {
@@ -238995,14 +239084,14 @@ async function pullProjectCommand(options) {
     }
     if (!configFound || !config) {
       spinner.fail("No inkeep.config.ts found");
-      console.error(chalk8.red("Configuration file is required for pull command"));
+      console.error(chalk9.red("Configuration file is required for pull command"));
       console.log(
-        chalk8.yellow("Please create an inkeep.config.ts file with your tenantId and API settings")
+        chalk9.yellow("Please create an inkeep.config.ts file with your tenantId and API settings")
       );
-      console.log(chalk8.gray("Searched in:"));
-      console.log(chalk8.gray(`  \u2022 Current directory: ${searchDir}`));
-      console.log(chalk8.gray(`  \u2022 Parent directory: ${join9(searchDir, "..")}`));
-      console.log(chalk8.gray(`  \u2022 Parent directories up to root`));
+      console.log(chalk9.gray("Searched in:"));
+      console.log(chalk9.gray(`  \u2022 Current directory: ${searchDir}`));
+      console.log(chalk9.gray(`  \u2022 Parent directory: ${join10(searchDir, "..")}`));
+      console.log(chalk9.gray(`  \u2022 Parent directories up to root`));
       process.exit(1);
     }
     spinner.succeed(`Configuration loaded from ${configLocation}`);
@@ -239015,8 +239104,8 @@ async function pullProjectCommand(options) {
     } else {
       const projectRoot = await findProjectDirectory();
       if (projectRoot) {
-        const srcPath = join9(projectRoot, "src");
-        baseDir = existsSync8(srcPath) ? srcPath : projectRoot;
+        const srcPath = join10(projectRoot, "src");
+        baseDir = existsSync9(srcPath) ? srcPath : projectRoot;
       } else {
         baseDir = process.cwd();
       }
@@ -239036,14 +239125,14 @@ async function pullProjectCommand(options) {
       if (currentProjectId) {
         spinner.fail("Conflicting project specification");
         console.error(
-          chalk8.red("Error: Cannot specify --project argument when in a project directory")
+          chalk9.red("Error: Cannot specify --project argument when in a project directory")
         );
-        console.error(chalk8.yellow(`  \u2022 Current directory project: ${currentProjectId}`));
-        console.error(chalk8.yellow(`  \u2022 Specified project argument: ${options.project}`));
-        console.error(chalk8.gray("\nTo pull to this directory, run without --project argument:"));
-        console.error(chalk8.gray("  inkeep pull"));
+        console.error(chalk9.yellow(`  \u2022 Current directory project: ${currentProjectId}`));
+        console.error(chalk9.yellow(`  \u2022 Specified project argument: ${options.project}`));
+        console.error(chalk9.gray("\nTo pull to this directory, run without --project argument:"));
+        console.error(chalk9.gray("  inkeep pull"));
         console.error(
-          chalk8.gray("\nTo pull a different project, run from a non-project directory.")
+          chalk9.gray("\nTo pull a different project, run from a non-project directory.")
         );
         process.exit(1);
       }
@@ -239054,7 +239143,7 @@ async function pullProjectCommand(options) {
       useCurrentDirectory = true;
       baseDir = process.cwd();
       spinner.succeed(`Detected project in current directory: ${currentProjectId}`);
-      console.log(chalk8.gray(`  \u2022 Will pull to current directory (directory-aware mode)`));
+      console.log(chalk9.gray(`  \u2022 Will pull to current directory (directory-aware mode)`));
     } else {
       spinner.stop();
       const response = await prompts({
@@ -239064,17 +239153,17 @@ async function pullProjectCommand(options) {
         validate: (value) => value ? true : "Project ID is required"
       });
       if (!response.projectId) {
-        console.error(chalk8.red("Project ID is required"));
+        console.error(chalk9.red("Project ID is required"));
         process.exit(1);
       }
       finalConfig.projectId = response.projectId;
       spinner.start("Configuration loaded");
     }
     spinner.succeed("Configuration loaded");
-    console.log(chalk8.gray("Configuration:"));
-    console.log(chalk8.gray(`  \u2022 Tenant ID: ${finalConfig.tenantId}`));
-    console.log(chalk8.gray(`  \u2022 Project ID: ${finalConfig.projectId}`));
-    console.log(chalk8.gray(`  \u2022 API URL: ${finalConfig.agentsManageApiUrl}`));
+    console.log(chalk9.gray("Configuration:"));
+    console.log(chalk9.gray(`  \u2022 Tenant ID: ${finalConfig.tenantId}`));
+    console.log(chalk9.gray(`  \u2022 Project ID: ${finalConfig.projectId}`));
+    console.log(chalk9.gray(`  \u2022 API URL: ${finalConfig.agentsManageApiUrl}`));
     spinner.start("Fetching project data from backend...");
     const apiClient = await ManagementApiClient.create(
       finalConfig.agentsManageApiUrl,
@@ -239099,30 +239188,30 @@ async function pullProjectCommand(options) {
       const statusComponents = agentObj.statusUpdates?.statusComponents || [];
       return total + statusComponents.length;
     }, 0);
-    console.log(chalk8.cyan("\n\u{1F4CA} Project Summary:"));
-    console.log(chalk8.gray(`  \u2022 Name: ${projectData.name}`));
-    console.log(chalk8.gray(`  \u2022 Description: ${projectData.description || "No description"}`));
-    console.log(chalk8.gray(`  \u2022 Agents: ${agentCount}`));
-    console.log(chalk8.gray(`  \u2022 Tools: ${toolCount}`));
-    console.log(chalk8.gray(`  \u2022 SubAgents: ${subAgentCount}`));
+    console.log(chalk9.cyan("\n\u{1F4CA} Project Summary:"));
+    console.log(chalk9.gray(`  \u2022 Name: ${projectData.name}`));
+    console.log(chalk9.gray(`  \u2022 Description: ${projectData.description || "No description"}`));
+    console.log(chalk9.gray(`  \u2022 Agents: ${agentCount}`));
+    console.log(chalk9.gray(`  \u2022 Tools: ${toolCount}`));
+    console.log(chalk9.gray(`  \u2022 SubAgents: ${subAgentCount}`));
     if (dataComponentCount > 0) {
-      console.log(chalk8.gray(`  \u2022 Data Components: ${dataComponentCount}`));
+      console.log(chalk9.gray(`  \u2022 Data Components: ${dataComponentCount}`));
     }
     if (artifactComponentCount > 0) {
-      console.log(chalk8.gray(`  \u2022 Artifact Components: ${artifactComponentCount}`));
+      console.log(chalk9.gray(`  \u2022 Artifact Components: ${artifactComponentCount}`));
     }
     if (statusComponentCount > 0) {
-      console.log(chalk8.gray(`  \u2022 Status Components: ${statusComponentCount}`));
+      console.log(chalk9.gray(`  \u2022 Status Components: ${statusComponentCount}`));
     }
     const credentialReferences2 = projectData.credentialReferences || {};
     const credentialCount = Object.keys(credentialReferences2).length;
     if (credentialCount > 0) {
-      console.log(chalk8.cyan("\n\u{1F510} Credentials Found:"));
-      console.log(chalk8.gray(`  \u2022 Total credentials: ${credentialCount}`));
+      console.log(chalk9.cyan("\n\u{1F510} Credentials Found:"));
+      console.log(chalk9.gray(`  \u2022 Total credentials: ${credentialCount}`));
       for (const [credId, credData] of Object.entries(credentialReferences2)) {
         const credType = credData.type || "unknown";
         const storeId = credData.credentialStoreId || "unknown";
-        console.log(chalk8.gray(`  \u2022 ${credId} (${credType}, store: ${storeId})`));
+        console.log(chalk9.gray(`  \u2022 ${credId} (${credType}, store: ${storeId})`));
         const usageInfo = credData.usedBy;
         if (usageInfo && Array.isArray(usageInfo) && usageInfo.length > 0) {
           const usageByType = {};
@@ -239130,11 +239219,11 @@ async function pullProjectCommand(options) {
             usageByType[usage.type] = (usageByType[usage.type] || 0) + 1;
           }
           const usageSummary = Object.entries(usageByType).map(([type, count16]) => `${count16} ${type}${count16 > 1 ? "s" : ""}`).join(", ");
-          console.log(chalk8.gray(`      Used by: ${usageSummary}`));
+          console.log(chalk9.gray(`      Used by: ${usageSummary}`));
         }
       }
       console.log(
-        chalk8.yellow(
+        chalk9.yellow(
           `  \u26A0\uFE0F  Environment file (${options.env || "development"}.env.ts) will be generated with credential references`
         )
       );
@@ -239143,10 +239232,10 @@ async function pullProjectCommand(options) {
     const dirs = createProjectStructure(baseDir, finalConfig.projectId, useCurrentDirectory);
     spinner.succeed("Project structure created");
     if (options.json) {
-      const jsonFilePath = join9(dirs.projectRoot, `${finalConfig.projectId}.json`);
+      const jsonFilePath = join10(dirs.projectRoot, `${finalConfig.projectId}.json`);
       writeFileSync6(jsonFilePath, JSON.stringify(projectData, null, 2));
       spinner.succeed(`Project data saved to ${jsonFilePath}`);
-      console.log(chalk8.green(`\u2705 JSON file created: ${jsonFilePath}`));
+      console.log(chalk9.green(`\u2705 JSON file created: ${jsonFilePath}`));
     }
     spinner.start("Analyzing existing code patterns...");
     const { analyzeExistingPatterns: analyzeExistingPatterns2 } = await Promise.resolve().then(() => (init_pattern_analyzer(), pattern_analyzer_exports));
@@ -239191,7 +239280,7 @@ async function pullProjectCommand(options) {
     const { generatePlan: generatePlan2 } = await Promise.resolve().then(() => (init_plan_builder(), plan_builder_exports));
     const { createModel: createModel2 } = await Promise.resolve().then(() => (init_pull_llm_generate(), pull_llm_generate_exports));
     const modelSettings = {
-      model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_20250514
+      model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5
     };
     const plan = await generatePlan2(projectData, patterns, modelSettings, createModel2);
     spinner.succeed("Generation plan created");
@@ -239210,7 +239299,7 @@ async function pullProjectCommand(options) {
     savePlan2(dirs.projectRoot, plan);
     ensureGitignore2(dirs.projectRoot);
     if (options.debug) {
-      console.log(chalk8.gray("\n\u{1F4CD} Plan saved to .inkeep/generation-plan.json"));
+      console.log(chalk9.gray("\n\u{1F4CD} Plan saved to .inkeep/generation-plan.json"));
     }
     const statusComponentsCount = Object.values(projectData.agents || {}).reduce((total, agent) => {
       const agentObj = agent;
@@ -239236,86 +239325,86 @@ async function pullProjectCommand(options) {
       if (verificationResult.success) {
         spinner.succeed("Generated files verified successfully");
         if (options.debug && verificationResult.warnings.length > 0) {
-          console.log(chalk8.yellow("\n\u26A0\uFE0F  Verification warnings:"));
+          console.log(chalk9.yellow("\n\u26A0\uFE0F  Verification warnings:"));
           verificationResult.warnings.forEach((warning) => {
-            console.log(chalk8.gray(`  \u2022 ${warning}`));
+            console.log(chalk9.gray(`  \u2022 ${warning}`));
           });
         }
       } else {
         spinner.fail("Generated files verification failed");
-        console.error(chalk8.red("\n\u274C Verification errors:"));
+        console.error(chalk9.red("\n\u274C Verification errors:"));
         verificationResult.errors.forEach((error) => {
-          console.error(chalk8.red(`  \u2022 ${error}`));
+          console.error(chalk9.red(`  \u2022 ${error}`));
         });
         if (verificationResult.warnings.length > 0) {
-          console.log(chalk8.yellow("\n\u26A0\uFE0F  Verification warnings:"));
+          console.log(chalk9.yellow("\n\u26A0\uFE0F  Verification warnings:"));
           verificationResult.warnings.forEach((warning) => {
-            console.log(chalk8.gray(`  \u2022 ${warning}`));
+            console.log(chalk9.gray(`  \u2022 ${warning}`));
           });
         }
         console.log(
-          chalk8.gray("\nThe generated files may not accurately represent the pulled project.")
+          chalk9.gray("\nThe generated files may not accurately represent the pulled project.")
         );
         console.log(
-          chalk8.gray("This could indicate an issue with the LLM generation or schema mappings.")
+          chalk9.gray("This could indicate an issue with the LLM generation or schema mappings.")
         );
       }
     } catch (error) {
       spinner.fail("Verification failed");
-      console.error(chalk8.red("Verification error:"), error.message);
-      console.log(chalk8.gray("Proceeding without verification..."));
+      console.error(chalk9.red("Verification error:"), error.message);
+      console.log(chalk9.gray("Proceeding without verification..."));
     }
-    console.log(chalk8.green("\n\u2728 Project pulled successfully!"));
-    console.log(chalk8.cyan("\n\u{1F4C1} Generated structure:"));
-    console.log(chalk8.gray(`  ${dirs.projectRoot}/`));
-    console.log(chalk8.gray(`  \u251C\u2500\u2500 index.ts`));
+    console.log(chalk9.green("\n\u2728 Project pulled successfully!"));
+    console.log(chalk9.cyan("\n\u{1F4C1} Generated structure:"));
+    console.log(chalk9.gray(`  ${dirs.projectRoot}/`));
+    console.log(chalk9.gray(`  \u251C\u2500\u2500 index.ts`));
     if (fileCount.agents > 0) {
-      console.log(chalk8.gray(`  \u251C\u2500\u2500 agents/ (${fileCount.agents} files)`));
+      console.log(chalk9.gray(`  \u251C\u2500\u2500 agents/ (${fileCount.agents} files)`));
     }
     if (fileCount.tools > 0) {
-      console.log(chalk8.gray(`  \u251C\u2500\u2500 tools/ (${fileCount.tools} files)`));
+      console.log(chalk9.gray(`  \u251C\u2500\u2500 tools/ (${fileCount.tools} files)`));
     }
     if (fileCount.dataComponents > 0) {
-      console.log(chalk8.gray(`  \u251C\u2500\u2500 data-components/ (${fileCount.dataComponents} files)`));
+      console.log(chalk9.gray(`  \u251C\u2500\u2500 data-components/ (${fileCount.dataComponents} files)`));
     }
     if (fileCount.artifactComponents > 0) {
-      console.log(chalk8.gray(`  \u251C\u2500\u2500 artifact-components/ (${fileCount.artifactComponents} files)`));
+      console.log(chalk9.gray(`  \u251C\u2500\u2500 artifact-components/ (${fileCount.artifactComponents} files)`));
     }
     if (fileCount.statusComponents > 0) {
-      console.log(chalk8.gray(`  \u251C\u2500\u2500 status-components/ (${fileCount.statusComponents} files)`));
+      console.log(chalk9.gray(`  \u251C\u2500\u2500 status-components/ (${fileCount.statusComponents} files)`));
     }
-    console.log(chalk8.gray("  \u2514\u2500\u2500 environments/ (4 files)"));
-    console.log(chalk8.cyan("\n\u{1F4DD} Next steps:"));
-    console.log(chalk8.gray(`  \u2022 cd ${dirs.projectRoot}`));
-    console.log(chalk8.gray("  \u2022 Review the generated files"));
-    console.log(chalk8.gray("  \u2022 Test locally: inkeep push"));
+    console.log(chalk9.gray("  \u2514\u2500\u2500 environments/ (4 files)"));
+    console.log(chalk9.cyan("\n\u{1F4DD} Next steps:"));
+    console.log(chalk9.gray(`  \u2022 cd ${dirs.projectRoot}`));
+    console.log(chalk9.gray("  \u2022 Review the generated files"));
+    console.log(chalk9.gray("  \u2022 Test locally: inkeep push"));
     console.log(
-      chalk8.gray('  \u2022 Commit changes: git add . && git commit -m "Add project from pull"')
+      chalk9.gray('  \u2022 Commit changes: git add . && git commit -m "Add project from pull"')
     );
   } catch (error) {
     spinner.fail("Failed to pull project");
-    console.error(chalk8.red("Error:"), error.message);
+    console.error(chalk9.red("Error:"), error.message);
     process.exit(1);
   }
 }
 
 // src/commands/push.ts
 init_esm_shims();
-import { existsSync as existsSync10 } from "fs";
-import { join as join11, resolve as resolve5 } from "path";
-import chalk9 from "chalk";
+import { existsSync as existsSync11 } from "fs";
+import { join as join12, resolve as resolve5 } from "path";
+import chalk10 from "chalk";
 import ora6 from "ora";
 init_cli_pipeline();
 
 // src/utils/environment-loader.ts
 init_esm_shims();
 init_tsx_loader();
-import { existsSync as existsSync9 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync10 } from "fs";
+import { join as join11 } from "path";
 async function loadEnvironmentCredentials(projectDir, env3) {
-  const environmentsDir = join10(projectDir, "environments");
-  const envFilePath = join10(environmentsDir, `${env3}.env.ts`);
-  if (!existsSync9(envFilePath)) {
+  const environmentsDir = join11(projectDir, "environments");
+  const envFilePath = join11(environmentsDir, `${env3}.env.ts`);
+  if (!existsSync10(envFilePath)) {
     throw new Error(
       `Environment file not found: ${envFilePath}
 Make sure you have a ${env3}.env.ts file in the environments directory.`
@@ -239343,8 +239432,8 @@ Make sure you have a ${env3}.env.ts file in the environments directory.`
 // src/commands/push.ts
 init_tsx_loader();
 async function loadProject(projectDir) {
-  const indexPath = join11(projectDir, "index.ts");
-  if (!existsSync10(indexPath)) {
+  const indexPath = join12(projectDir, "index.ts");
+  if (!existsSync11(indexPath)) {
     throw new Error(`index.ts not found in project directory: ${projectDir}`);
   }
   const module = await importWithTypeScriptSupport(indexPath);
@@ -239360,6 +239449,7 @@ async function loadProject(projectDir) {
   );
 }
 async function pushCommand(options) {
+  performBackgroundVersionCheck();
   const { config } = await initializeCommand({
     configPath: options.config,
     showSpinner: true,
@@ -239372,18 +239462,18 @@ async function pushCommand(options) {
     let projectDir;
     if (options.project) {
       projectDir = resolve5(process.cwd(), options.project);
-      if (!existsSync10(join11(projectDir, "index.ts"))) {
+      if (!existsSync11(join12(projectDir, "index.ts"))) {
         spinner.fail(`No index.ts found in specified project directory: ${projectDir}`);
         process.exit(1);
       }
     } else {
       const currentDir = process.cwd();
-      if (existsSync10(join11(currentDir, "index.ts"))) {
+      if (existsSync11(join12(currentDir, "index.ts"))) {
         projectDir = currentDir;
       } else {
         spinner.fail("No index.ts found in current directory");
         console.error(
-          chalk9.yellow(
+          chalk10.yellow(
             "Please run this command from a directory containing index.ts or use --project <path>"
           )
         );
@@ -239427,11 +239517,11 @@ async function pushCommand(options) {
         const credentials = await loadEnvironmentCredentials(projectDir, options.env);
         project.setCredentials(credentials);
         spinner.text = "Project loaded with credentials";
-        console.log(chalk9.gray(`  \u2022 Environment: ${options.env}`));
-        console.log(chalk9.gray(`  \u2022 Credentials loaded: ${Object.keys(credentials).length}`));
+        console.log(chalk10.gray(`  \u2022 Environment: ${options.env}`));
+        console.log(chalk10.gray(`  \u2022 Credentials loaded: ${Object.keys(credentials).length}`));
       } catch (error) {
         spinner.fail("Failed to load environment credentials");
-        console.error(chalk9.red("Error:"), error.message);
+        console.error(chalk10.red("Error:"), error.message);
         process.exit(1);
       }
     }
@@ -239439,12 +239529,12 @@ async function pushCommand(options) {
       spinner.text = "Generating project data JSON...";
       try {
         const projectDefinition = await project.getFullDefinition();
-        const jsonFilePath = join11(projectDir, `project.json`);
+        const jsonFilePath = join12(projectDir, `project.json`);
         const fs5 = await import("fs/promises");
         await fs5.writeFile(jsonFilePath, JSON.stringify(projectDefinition, null, 2));
         spinner.succeed(`Project data saved to ${jsonFilePath}`);
-        console.log(chalk9.gray(`  \u2022 File: ${jsonFilePath}`));
-        console.log(chalk9.gray(`  \u2022 Size: ${JSON.stringify(projectDefinition).length} bytes`));
+        console.log(chalk10.gray(`  \u2022 File: ${jsonFilePath}`));
+        console.log(chalk10.gray(`  \u2022 Size: ${JSON.stringify(projectDefinition).length} bytes`));
         const agentCount = Object.keys(projectDefinition.agents || {}).length;
         const toolCount = Object.keys(projectDefinition.tools || {}).length;
         const subAgentCount = Object.values(projectDefinition.agents || {}).reduce(
@@ -239453,15 +239543,15 @@ async function pushCommand(options) {
           },
           0
         );
-        console.log(chalk9.cyan("\n\u{1F4CA} Project Data Summary:"));
-        console.log(chalk9.gray(`  \u2022 Agent: ${agentCount}`));
-        console.log(chalk9.gray(`  \u2022 Tools: ${toolCount}`));
-        console.log(chalk9.gray(`  \u2022 SubAgent: ${subAgentCount}`));
-        console.log(chalk9.green("\n\u2728 JSON file generated successfully!"));
+        console.log(chalk10.cyan("\n\u{1F4CA} Project Data Summary:"));
+        console.log(chalk10.gray(`  \u2022 Agent: ${agentCount}`));
+        console.log(chalk10.gray(`  \u2022 Tools: ${toolCount}`));
+        console.log(chalk10.gray(`  \u2022 SubAgent: ${subAgentCount}`));
+        console.log(chalk10.green("\n\u2728 JSON file generated successfully!"));
         process.exit(0);
       } catch (error) {
         spinner.fail("Failed to generate JSON file");
-        console.error(chalk9.red("Error:"), error.message);
+        console.error(chalk10.red("Error:"), error.message);
         process.exit(1);
       }
     }
@@ -239471,18 +239561,18 @@ async function pushCommand(options) {
     const projectName = project.getName();
     const stats = project.getStats();
     spinner.succeed(`Project "${projectName}" (${projectId}) pushed successfully`);
-    console.log(chalk9.cyan("\n\u{1F4CA} Project Summary:"));
-    console.log(chalk9.gray(`  \u2022 Project ID: ${projectId}`));
-    console.log(chalk9.gray(`  \u2022 Name: ${projectName}`));
-    console.log(chalk9.gray(`  \u2022 Agent: ${stats.agentCount}`));
-    console.log(chalk9.gray(`  \u2022 Tenant: ${stats.tenantId}`));
+    console.log(chalk10.cyan("\n\u{1F4CA} Project Summary:"));
+    console.log(chalk10.gray(`  \u2022 Project ID: ${projectId}`));
+    console.log(chalk10.gray(`  \u2022 Name: ${projectName}`));
+    console.log(chalk10.gray(`  \u2022 Agent: ${stats.agentCount}`));
+    console.log(chalk10.gray(`  \u2022 Tenant: ${stats.tenantId}`));
     const agents2 = project.getAgents();
     if (agents2.length > 0) {
-      console.log(chalk9.cyan("\n\u{1F4CA} Agent Details:"));
+      console.log(chalk10.cyan("\n\u{1F4CA} Agent Details:"));
       for (const agent of agents2) {
         const agentStats = agent.getStats();
         console.log(
-          chalk9.gray(`  \u2022 ${agent.getName()} (${agent.getId()}): ${agentStats.agentCount} agents`)
+          chalk10.gray(`  \u2022 ${agent.getName()} (${agent.getId()}): ${agentStats.agentCount} agents`)
         );
       }
     }
@@ -239490,50 +239580,195 @@ async function pushCommand(options) {
       const credentialTracking = await project.getCredentialTracking();
       const credentialCount = Object.keys(credentialTracking.credentials).length;
       if (credentialCount > 0) {
-        console.log(chalk9.cyan("\n\u{1F510} Credentials:"));
-        console.log(chalk9.gray(`  \u2022 Total credentials: ${credentialCount}`));
+        console.log(chalk10.cyan("\n\u{1F510} Credentials:"));
+        console.log(chalk10.gray(`  \u2022 Total credentials: ${credentialCount}`));
         for (const [credId, credData] of Object.entries(credentialTracking.credentials)) {
           const usageInfo = credentialTracking.usage[credId] || [];
           const credType = credData.type || "unknown";
           const storeId = credData.credentialStoreId || "unknown";
-          console.log(chalk9.gray(`  \u2022 ${credId} (${credType}, store: ${storeId})`));
+          console.log(chalk10.gray(`  \u2022 ${credId} (${credType}, store: ${storeId})`));
           if (usageInfo.length > 0) {
             const usageByType = {};
             for (const usage of usageInfo) {
               usageByType[usage.type] = (usageByType[usage.type] || 0) + 1;
             }
             const usageSummary = Object.entries(usageByType).map(([type, count16]) => `${count16} ${type}${count16 > 1 ? "s" : ""}`).join(", ");
-            console.log(chalk9.gray(`      Used by: ${usageSummary}`));
+            console.log(chalk10.gray(`      Used by: ${usageSummary}`));
           }
         }
       }
     } catch (_error) {
       if (env2.DEBUG) {
-        console.error(chalk9.yellow("Could not retrieve credential tracking information"));
+        console.error(chalk10.yellow("Could not retrieve credential tracking information"));
       }
     }
-    console.log(chalk9.green("\n\u2728 Next steps:"));
-    console.log(chalk9.gray(`  \u2022 Test your project: inkeep chat`));
-    console.log(chalk9.gray(`  \u2022 View all agent: inkeep list-agent`));
+    console.log(chalk10.green("\n\u2728 Next steps:"));
+    console.log(chalk10.gray(`  \u2022 Test your project: inkeep chat`));
+    console.log(chalk10.gray(`  \u2022 View all agent: inkeep list-agent`));
     process.exit(0);
   } catch (_error) {
     if (spinner) {
       spinner.fail("Failed to push project");
     }
     const error = _error;
-    console.error(chalk9.red("Error:"), error.message);
+    console.error(chalk10.red("Error:"), error.message);
     if (error.stack && env2.DEBUG) {
-      console.error(chalk9.gray(error.stack));
+      console.error(chalk10.gray(error.stack));
+    }
+    process.exit(1);
+  }
+}
+
+// src/commands/update.ts
+init_esm_shims();
+import chalk11 from "chalk";
+import ora7 from "ora";
+import prompts2 from "prompts";
+
+// src/utils/package-manager.ts
+init_esm_shims();
+import { exec } from "child_process";
+import { promisify as promisify2 } from "util";
+var execAsync = promisify2(exec);
+async function detectPackageManager() {
+  const managers = ["pnpm", "bun", "npm", "yarn"];
+  for (const manager of managers) {
+    try {
+      if (manager === "npm") {
+        const { stdout } = await execAsync(`npm list -g ${DEFAULT_PACKAGE_NAME} --depth=0`);
+        if (stdout.includes(DEFAULT_PACKAGE_NAME)) {
+          return "npm";
+        }
+      } else if (manager === "pnpm") {
+        const { stdout } = await execAsync(`pnpm list -g ${DEFAULT_PACKAGE_NAME} --depth=0`);
+        if (stdout.includes(DEFAULT_PACKAGE_NAME)) {
+          return "pnpm";
+        }
+      } else if (manager === "bun") {
+        const { stdout } = await execAsync("bun pm ls -g");
+        if (stdout.includes(DEFAULT_PACKAGE_NAME)) {
+          return "bun";
+        }
+      } else if (manager === "yarn") {
+        const { stdout } = await execAsync("yarn global list");
+        if (stdout.includes(DEFAULT_PACKAGE_NAME)) {
+          return "yarn";
+        }
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function getUpdateCommand(manager, packageName = DEFAULT_PACKAGE_NAME) {
+  switch (manager) {
+    case "npm":
+      return `npm install -g ${packageName}@latest`;
+    case "pnpm":
+      return `pnpm add -g ${packageName}@latest`;
+    case "bun":
+      return `bun add -g ${packageName}@latest`;
+    case "yarn":
+      return `yarn global add ${packageName}@latest`;
+  }
+}
+async function executeUpdate(manager) {
+  const allowedManagers = ["npm", "pnpm", "bun", "yarn"];
+  if (!allowedManagers.includes(manager)) {
+    throw new Error(`Unsupported package manager: ${manager}`);
+  }
+  const command = getUpdateCommand(manager);
+  await execAsync(command);
+}
+
+// src/commands/update.ts
+async function updateCommand(options = {}) {
+  const spinner = ora7("Checking for updates...").start();
+  try {
+    const versionInfo = await checkForUpdate();
+    spinner.stop();
+    console.log(chalk11.cyan("\n\u{1F4E6} Version Information:"));
+    console.log(chalk11.gray(`  \u2022 Current version: ${versionInfo.current}`));
+    console.log(chalk11.gray(`  \u2022 Latest version:  ${versionInfo.latest}`));
+    if (options.check) {
+      if (versionInfo.needsUpdate) {
+        console.log(chalk11.yellow("\n\u26A0\uFE0F  An update is available!"));
+        console.log(chalk11.gray(`  \u2022 Run ${chalk11.cyan("inkeep update")} to update`));
+      } else {
+        console.log(chalk11.green("\n\u2705 You are on the latest version"));
+      }
+      return;
+    }
+    if (!versionInfo.needsUpdate && !options.force) {
+      console.log(chalk11.green("\n\u2705 You are already on the latest version"));
+      return;
+    }
+    if (!versionInfo.needsUpdate && options.force) {
+      console.log(chalk11.yellow("\n\u26A0\uFE0F  Forcing reinstall of current version..."));
+    }
+    console.log(chalk11.cyan("\n\u{1F4D6} Changelog:"));
+    console.log(chalk11.gray(`  \u2022 ${getChangelogUrl()}`));
+    spinner.start("Detecting package manager...");
+    const detectedManager = await detectPackageManager();
+    spinner.stop();
+    let packageManager;
+    if (!detectedManager) {
+      console.log(chalk11.yellow("\n\u26A0\uFE0F  Could not auto-detect package manager"));
+      const response = await prompts2({
+        type: "select",
+        name: "manager",
+        message: "Which package manager did you use to install the CLI?",
+        choices: [
+          { title: "npm", value: "npm" },
+          { title: "pnpm", value: "pnpm" },
+          { title: "bun", value: "bun" },
+          { title: "yarn", value: "yarn" }
+        ]
+      });
+      if (!response.manager) {
+        console.log(chalk11.red("\n\u274C Update cancelled"));
+        process.exit(1);
+      }
+      packageManager = response.manager;
+    } else {
+      packageManager = detectedManager;
+      console.log(chalk11.gray(`
+\u{1F50D} Detected package manager: ${chalk11.cyan(packageManager)}`));
+    }
+    if (!options.force) {
+      const response = await prompts2({
+        type: "confirm",
+        name: "confirm",
+        message: `Update @inkeep/agents-cli from ${versionInfo.current} to ${versionInfo.latest}?`,
+        initial: true
+      });
+      if (!response.confirm) {
+        console.log(chalk11.red("\n\u274C Update cancelled"));
+        process.exit(1);
+      }
+    }
+    spinner.start(`Updating @inkeep/agents-cli to ${versionInfo.latest}...`);
+    await executeUpdate(packageManager);
+    spinner.succeed(`Updated to version ${versionInfo.latest}`);
+    console.log(chalk11.green("\n\u2728 Update completed successfully!"));
+    console.log(chalk11.gray(`  \u2022 New version: ${versionInfo.latest}`));
+    console.log(chalk11.gray(`  \u2022 Package manager: ${packageManager}`));
+  } catch (error) {
+    spinner.fail("Update failed");
+    console.error(chalk11.red("\n\u274C Error:"), error.message);
+    if (error.message.includes("EACCES") || error.message.includes("permission")) {
+      console.log(chalk11.yellow("\n\u{1F4A1} Tip: Try running the command with elevated permissions:"));
+      console.log(chalk11.gray("  \u2022 sudo inkeep update"));
     }
     process.exit(1);
   }
 }
 
 // src/index.ts
-var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = dirname5(__filename2);
-var packageJsonPath = join12(__dirname2, "..", "package.json");
-var packageJson = JSON.parse(readFileSync6(packageJsonPath, "utf-8"));
+var __filename3 = fileURLToPath3(import.meta.url);
+var __dirname3 = dirname6(__filename3);
+var packageJsonPath = join13(__dirname3, "..", "package.json");
+var packageJson = JSON.parse(readFileSync7(packageJsonPath, "utf-8"));
 var program = new Command();
 program.name("inkeep").description("CLI tool for Inkeep Agent Framework").version(packageJson.version);
 program.command("add [template]").description("Add a new template to the project").option("--target-path <path>", "Target path to add the template to").option("--config <path>", "Path to configuration file").action(async (template, options) => {
@@ -239588,6 +239823,9 @@ program.command("dev").description("Start the Inkeep dashboard server").option("
     export: options.export
   });
 });
+program.command("update").description("Update @inkeep/agents-cli to the latest version").option("--check", "Check for updates without installing").option("--force", "Force update even if already on latest version").action(async (options) => {
+  await updateCommand(options);
+});
 program.parse();
 /*! Bundled license information: