@inkeep/agents-cli 0.33.2 → 0.34.1

package/dist/config.d.ts

@@ -1,5 +1,11 @@
 interface ApiConfig {
+    /**
+     * API endpoint URL
+     */
     url: string;
+    /**
+     * API key
+     */
     apiKey?: string;
 }
 interface FlatInkeepConfig {
@@ -16,10 +22,28 @@ interface FlatInkeepConfig {
     outputDirectory?: string;
 }
 interface NestedInkeepConfig {
+    /**
+     * Tenant identifier
+     */
     tenantId: string;
+    /**
+     * Management API configuration
+     * @default http://localhost:3002
+     */
     agentsManageApi: ApiConfig;
+    /**
+     * Runtime API configuration
+     * @default http://localhost:3002
+     */
     agentsRunApi: ApiConfig;
+    /**
+     * Management UI URL
+     * @default http://localhost:3000
+     */
     manageUiUrl?: string;
+    /**
+     * Output directory for generated files
+     */
     outputDirectory?: string;
 }
 type InkeepConfig = FlatInkeepConfig | NestedInkeepConfig;

package/dist/index.js

@@ -304,6 +304,7 @@ var init_models = __esm({
       CLAUDE_3_5_HAIKU_20241022: "anthropic/claude-3-5-haiku-20241022"
     };
     OPENAI_MODELS = {
+      GPT_5_1: "openai/gpt-5.1",
       GPT_5: "openai/gpt-5",
       GPT_5_20250807: "openai/gpt-5-2025-08-07",
       GPT_5_MINI: "openai/gpt-5-mini",
@@ -318,6 +319,7 @@ var init_models = __esm({
       GPT_4_1_NANO_20250414: "openai/gpt-4.1-nano-2025-04-14"
     };
     GOOGLE_MODELS = {
+      GEMINI_3_PRO_PREVIEW: "google/gemini-3-pro-preview",
       GEMINI_2_5_PRO: "google/gemini-2.5-pro",
       GEMINI_2_5_FLASH: "google/gemini-2.5-flash",
       GEMINI_2_5_FLASH_LITE: "google/gemini-2.5-flash-lite"
@@ -1694,7 +1696,7 @@ var init_schema = __esm({
         ...agentScoped,
         ...uiProperties,
         prompt: text("prompt").notNull(),
-        conversationHistoryConfig: jsonb("conversation_history_config").$type().notNull().default({
+        conversationHistoryConfig: jsonb("conversation_history_config").$type().default({
           mode: "full",
           limit: 50,
           maxOutputTokens: 4e3,
@@ -3425,7 +3427,8 @@ var init_schemas = __esm({
       version: z5.string().optional(),
       createdAt: z5.date(),
       updatedAt: z5.date(),
-      expiresAt: z5.date().optional()
+      expiresAt: z5.date().optional(),
+      relationshipId: z5.string().optional()
     }).openapi("McpTool");
     MCPToolConfigSchema = McpToolSchema.omit({
       config: true,
@@ -239997,7 +240000,7 @@ function getAvailableModel() {
     }
   }
   throw new Error(
-    "No API keys detected. Please set ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_API_KEY"
+    "No API keys detected. Please set ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_GENERATIVE_AI_API_KEY"
   );
 }
 var PROVIDER_CONFIGS;
@@ -240014,11 +240017,11 @@ var init_model_provider_detector = __esm({
       {
         name: "openai",
         envVars: ["OPENAI_API_KEY"],
-        model: "gpt-4.1"
+        model: "gpt-5.1"
       },
       {
         name: "google",
-        envVars: ["GOOGLE_API_KEY", "GOOGLE_GENERATIVE_AI_API_KEY"],
+        envVars: ["GOOGLE_GENERATIVE_AI_API_KEY"],
         model: "gemini-2.5-flash"
       }
     ];
@@ -241730,42 +241733,68 @@ async function pullV3Command(options) {
     });
     s4.start("Detecting project...");
     let projectDir;
-    if (options.project) {
-      projectDir = resolve4(process.cwd(), options.project);
-      if (!existsSync12(join15(projectDir, "index.ts"))) {
-        s4.stop(`No index.ts found in specified project directory: ${projectDir}`);
-        console.error(
-          chalk14.yellow("The specified project directory must contain an index.ts file")
+    let projectId;
+    let localProjectForId = null;
+    const currentDir = process.cwd();
+    const hasIndexInCurrent = existsSync12(join15(currentDir, "index.ts"));
+    if (hasIndexInCurrent) {
+      projectDir = currentDir;
+      s4.start("Loading local project...");
+      try {
+        localProjectForId = await loadProject(projectDir);
+        const localProjectId = localProjectForId.getId();
+        if (options.project) {
+          if (localProjectId !== options.project) {
+            s4.stop("Project ID mismatch");
+            console.error(
+              chalk14.red(
+                `Local project ID "${localProjectId}" doesn't match --project "${options.project}"`
+              )
+            );
+            console.error(
+              chalk14.yellow("Either remove --project flag or ensure it matches the local project ID")
+            );
+            process.exit(1);
+          }
+        }
+        projectId = localProjectId;
+        s4.stop(`Using local project: ${projectId}`);
+      } catch (error) {
+        s4.stop("Failed to load local project");
+        throw new Error(
+          `Could not load local project: ${error instanceof Error ? error.message : String(error)}`
         );
-        process.exit(1);
       }
     } else {
-      const currentDir = process.cwd();
-      if (existsSync12(join15(currentDir, "index.ts"))) {
-        projectDir = currentDir;
-      } else {
+      if (!options.project) {
         s4.stop("No index.ts found in current directory");
         console.error(
           chalk14.yellow(
-            "Please run this command from a directory containing index.ts or use --project <path>"
+            "Please run this command from a directory containing index.ts or use --project <project-id>"
           )
         );
         process.exit(1);
       }
-    }
-    s4.stop(`Project found: ${projectDir}`);
-    s4.start("Loading local project to get project ID...");
-    let localProjectForId;
-    let projectId;
-    try {
-      localProjectForId = await loadProject(projectDir);
-      projectId = localProjectForId.getId();
-      s4.stop(`Project ID: ${projectId}`);
-    } catch (error) {
-      s4.stop("Failed to load local project");
-      throw new Error(
-        `Could not determine project ID. Local project failed to load: ${error instanceof Error ? error.message : String(error)}`
-      );
+      const projectPath = resolve4(currentDir, options.project);
+      const hasIndexInPath = existsSync12(join15(projectPath, "index.ts"));
+      if (hasIndexInPath) {
+        projectDir = projectPath;
+        s4.start("Loading project from specified path...");
+        try {
+          localProjectForId = await loadProject(projectDir);
+          projectId = localProjectForId.getId();
+          s4.stop(`Using project from path: ${projectId}`);
+        } catch (error) {
+          s4.stop("Failed to load project from path");
+          throw new Error(
+            `Could not load project from ${projectPath}: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      } else {
+        projectId = options.project;
+        projectDir = join15(currentDir, projectId);
+        s4.stop(`Creating new project directory: ${projectDir}`);
+      }
     }
     s4.start(`Fetching project: ${projectId}`);
     const apiClient = await ManagementApiClient.create(
@@ -242039,7 +242068,7 @@ var envSchema2 = z15.object({
   // Secrets loaded from .env files (relative to where CLI is executed)
   ANTHROPIC_API_KEY: z15.string().optional(),
   OPENAI_API_KEY: z15.string().optional(),
-  GOOGLE_API_KEY: z15.string().optional(),
+  GOOGLE_GENERATIVE_AI_API_KEY: z15.string().optional(),
   // Langfuse configuration for LLM observability
   LANGFUSE_SECRET_KEY: z15.string().optional(),
   LANGFUSE_PUBLIC_KEY: z15.string().optional(),
@@ -242314,13 +242343,29 @@ async function getAvailableTemplates(templatePath = "template-projects", local)
       }
     }
     return directories;
-  } else {
-    const response = await fetch(
-      `https://api.github.com/repos/inkeep/agents/contents/agents-cookbook/${templatePath}`
+  }
+  const response = await fetch(
+    `https://api.github.com/repos/inkeep/agents/contents/agents-cookbook/${templatePath}`
+  );
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch templates. Please check your internet connection and try again.`
     );
-    const contents = await response.json();
-    return contents.filter((item) => item.type === "dir" && item.name !== "weather-project").map((item) => item.name);
   }
+  let contents;
+  try {
+    contents = await response.json();
+  } catch (error) {
+    throw new Error(
+      `Failed to parse templates response. Please check your internet connection and try again. ${error}`
+    );
+  }
+  if (!Array.isArray(contents)) {
+    throw new Error(
+      "Unexpected response format from templates. Please check your internet connection and try again"
+    );
+  }
+  return contents.filter((item) => item.type === "dir" && item.name !== "weather-project").map((item) => item.name);
 }
 
 // src/commands/add.ts
@@ -242361,10 +242406,15 @@ async function addCommand(options) {
   const projectTemplates = await getAvailableTemplates("template-projects", options.localPrefix);
   const mcpTemplates = await getAvailableTemplates("template-mcps", options.localPrefix);
   if (!options.project && !options.mcp) {
+    console.log(chalk.cyan("\nUsage:\n"));
+    console.log(chalk.white("Add a project with: inkeep add --project <project-template>"));
+    console.log(chalk.gray("  Example: inkeep add --project docs-assistant\n"));
     console.log(chalk.yellow("Available project templates:"));
     for (const template of projectTemplates) {
       console.log(chalk.gray(`  \u2022 ${template}`));
     }
+    console.log(chalk.white("\nAdd an MCP server with: inkeep add --mcp <mcp-template>"));
+    console.log(chalk.gray("  Example: inkeep add --mcp slack\n"));
     console.log(chalk.yellow("Available MCP templates:"));
     for (const template of mcpTemplates) {
       console.log(chalk.gray(`  \u2022 ${template}`));
@@ -242379,31 +242429,53 @@ async function addCommand(options) {
       console.error(`\u274C MCP template "${options.mcp}" not found`);
       process.exit(1);
     }
-    const s4 = p4.spinner();
-    s4.start("Adding template...");
     if (options.project) {
-      await addProjectTemplate(options.project, options.targetPath, options.localPrefix);
-      s4.stop();
+      await addProjectTemplate(
+        projectTemplates,
+        options.project,
+        options.targetPath,
+        options.localPrefix
+      );
     }
     if (options.mcp) {
-      await addMcpTemplate(options.mcp, options.targetPath, s4, options.localPrefix);
+      await addMcpTemplate(mcpTemplates, options.mcp, options.targetPath, options.localPrefix);
     }
     return;
   }
 }
-async function addProjectTemplate(template, targetPath, localPrefix) {
-  const templates = await getAvailableTemplates("template-projects", localPrefix);
+async function checkTemplateDir(templateDir, commandType) {
+  const s4 = p4.spinner();
+  if (await fs4.pathExists(templateDir)) {
+    const overwrite = await p4.confirm({
+      message: `Directory "${templateDir}" already exists. Do you want to overwrite it?`
+    });
+    if (!overwrite) {
+      p4.cancel(
+        `You can specify a different target path like: \`inkeep add --${commandType} <${commandType}-template> --target-path <path>\``
+      );
+      process.exit(0);
+    }
+    s4.start("Cleaning existing directory...");
+    await fs4.emptyDir(templateDir);
+    s4.stop();
+  }
+}
+function buildTemplateUrl(templateType, templateName) {
+  return `https://github.com/inkeep/agents/agents-cookbook/${templateType}/${templateName}`;
+}
+async function addProjectTemplate(availableTemplates, template, targetPath, localPrefix) {
   if (!template) {
     console.log(chalk.yellow("Available templates:"));
-    for (const template2 of templates) {
+    for (const template2 of availableTemplates) {
       console.log(chalk.gray(`  \u2022 ${template2}`));
     }
     process.exit(0);
   } else {
-    if (!templates.includes(template)) {
+    if (!availableTemplates.includes(template)) {
       console.error(`\u274C Template "${template}" not found`);
       process.exit(1);
     }
+    const s4 = p4.spinner();
     const anthropicKey = process.env.ANTHROPIC_API_KEY;
     const openAiKey = process.env.OPENAI_API_KEY;
     const googleKey = process.env.GOOGLE_GENERATIVE_AI_API_KEY;
@@ -242428,12 +242500,10 @@ async function addProjectTemplate(template, targetPath, localPrefix) {
         "\u274C No AI provider key found in environment variables. Please set one of: ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_GENERATIVE_AI_API_KEY"
       );
     }
-    const baseDir = targetPath || process.cwd();
-    const templateDir = `${baseDir}/${template}`;
-    if (await fs4.pathExists(templateDir)) {
-      console.error(`\u274C Directory "${templateDir}" already exists`);
-      process.exit(1);
-    }
+    const projectDirectory = await findAppDirectory("project");
+    const baseDir = targetPath || projectDirectory;
+    const templateDir = path4.join(baseDir, template);
+    await checkTemplateDir(templateDir, "project");
     if (targetPath && !await fs4.pathExists(baseDir)) {
       try {
         await fs4.mkdir(baseDir, { recursive: true });
@@ -242444,45 +242514,47 @@ async function addProjectTemplate(template, targetPath, localPrefix) {
         process.exit(1);
       }
     }
-    const s4 = p4.spinner();
     s4.start("Adding template...");
     if (localPrefix && localPrefix.length > 0) {
       const fullTemplatePath = path4.join(localPrefix, "template-projects", template);
       await cloneTemplateLocal(fullTemplatePath, templateDir, contentReplacements);
     } else {
-      const fullTemplatePath = `https://github.com/inkeep/agents/agents-cookbook/template-projects/${template}`;
+      const fullTemplatePath = buildTemplateUrl("template-projects", template);
       await cloneTemplate(fullTemplatePath, templateDir, contentReplacements);
     }
     s4.stop(`Template "${template}" added to ${templateDir}`);
     return;
   }
 }
-async function addMcpTemplate(template, targetPath, spinner8, localPrefix) {
-  const templates = await getAvailableTemplates("template-mcps", localPrefix);
+async function addMcpTemplate(availableTemplates, template, targetPath, localPrefix) {
   if (!template) {
     console.log(chalk.yellow("Available templates:"));
-    for (const template2 of templates) {
+    for (const template2 of availableTemplates) {
       console.log(chalk.gray(`  \u2022 ${template2}`));
     }
     process.exit(0);
   }
   if (!targetPath) {
-    const foundPath = await findAppDirectory();
-    targetPath = `${foundPath}/${template}`;
+    const foundPath = await findAppDirectory("mcp");
+    targetPath = path4.join(foundPath, template);
   }
+  await checkTemplateDir(targetPath, "mcp");
+  const s4 = p4.spinner();
+  s4.start("Adding template...");
   if (localPrefix && localPrefix.length > 0) {
     const fullTemplatePath = path4.join(localPrefix, "template-mcps", template);
     await cloneTemplateLocal(fullTemplatePath, targetPath);
   } else {
-    const fullTemplatePath = `https://github.com/inkeep/agents/agents-cookbook/template-mcps/${template}`;
+    const fullTemplatePath = buildTemplateUrl("template-mcps", template);
     await cloneTemplate(fullTemplatePath, targetPath);
   }
-  spinner8.stop(`MCP template "${template}" added to ${targetPath}`);
+  s4.stop(`MCP template "${template}" added to ${targetPath}`);
 }
-async function findAppDirectory() {
-  const appDirectory = await findUp("apps/mcp/app", { type: "directory" });
-  if (!appDirectory || !appDirectory.includes("apps/mcp/app")) {
-    console.log(chalk.yellow(`\u26A0\uFE0F  No app directory found.`));
+async function findAppDirectory(type) {
+  const searchPath = type === "project" ? "src/projects" : "apps/mcp/app";
+  const directory = await findUp(searchPath, { type: "directory" });
+  if (!directory || !directory.includes(searchPath)) {
+    console.log(chalk.yellow(`\u26A0\uFE0F  No ${type} directory found.`));
     const continueAnyway = await p4.confirm({
       message: `Do you want to add to ${process.cwd()} instead?`
     });
@@ -242490,9 +242562,8 @@ async function findAppDirectory() {
       p4.cancel("Operation cancelled");
       process.exit(0);
     }
-    return process.cwd();
   }
-  return appDirectory;
+  return directory || process.cwd();
 }
 
 // src/commands/config.ts
@@ -243510,7 +243581,7 @@ program.command("push").description("Push a project configuration to the backend
 });
 program.command("pull").description("Pull project configuration with clean, efficient code generation").option(
   "--project <project-id>",
-  "Override project ID (defaults to local project ID from index.ts)"
+  "Project ID to pull (or path to project directory). If in project directory, validates against local project ID."
 ).option("--config <path>", "Path to configuration file").option(
   "--env <environment>",
   "Environment file to generate (development, staging, production). Defaults to development"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-cli",
-  "version": "0.33.2",
+  "version": "0.34.1",
   "description": "Inkeep CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,8 +49,8 @@
     "ts-morph": "^26.0.0",
     "tsx": "^4.20.5",
     "open": "^10.2.0",
-    "@inkeep/agents-core": "^0.33.2",
-    "@inkeep/agents-sdk": "^0.33.2"
+    "@inkeep/agents-core": "^0.34.1",
+    "@inkeep/agents-sdk": "^0.34.1"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",