@inkeep/agents-cli 0.6.4 → 0.6.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-cli",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Inkeep CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,8 +45,8 @@
     "recast": "^0.23.0",
     "ts-morph": "^26.0.0",
     "tsx": "^4.20.5",
-    "@inkeep/agents-core": "^0.6.4",
-    "@inkeep/agents-manage-ui": "^0.6.4"
+    "@inkeep/agents-core": "^0.6.5",
+    "@inkeep/agents-manage-ui": "^0.6.5"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",

package/dist/commands/create.d.ts

@@ -1,12 +0,0 @@
-declare const createAgents: (args?: {
-    tenantId?: string;
-    projectId?: string;
-    dirName?: string;
-    openAiKey?: string;
-    anthropicKey?: string;
-    manageApiPort?: string;
-    runApiPort?: string;
-}) => Promise<void>;
-declare function createCommand(dirName?: string, options?: any): Promise<void>;
-
-export { createAgents, createCommand };

package/dist/commands/create.js

@@ -1,869 +0,0 @@
-#!/usr/bin/env node
-
-// src/commands/create.ts
-import color from "picocolors";
-import * as p from "@clack/prompts";
-import fs from "fs-extra";
-import { exec } from "child_process";
-import { promisify } from "util";
-import path from "path";
-
-// src/utils/model-config.ts
-import inquirer from "inquirer";
-var defaultDualModelConfigurations = {
-  base: {
-    model: "anthropic/claude-sonnet-4-20250514"
-  },
-  structuredOutput: {
-    model: "openai/gpt-4.1-mini-2025-04-14"
-  },
-  summarizer: {
-    model: "openai/gpt-4.1-nano-2025-04-14"
-  }
-};
-var defaultOpenaiModelConfigurations = {
-  base: {
-    model: "openai/gpt-5-2025-08-07"
-  },
-  structuredOutput: {
-    model: "openai/gpt-4.1-mini-2025-04-14"
-  },
-  summarizer: {
-    model: "openai/gpt-4.1-nano-2025-04-14"
-  }
-};
-var defaultAnthropicModelConfigurations = {
-  base: {
-    model: "anthropic/claude-sonnet-4-20250514"
-  },
-  structuredOutput: {
-    model: "anthropic/claude-sonnet-4-20250514"
-  },
-  summarizer: {
-    model: "anthropic/claude-sonnet-4-20250514"
-  }
-};
-
-// src/commands/create.ts
-var execAsync = promisify(exec);
-var createAgents = async (args = {}) => {
-  let { tenantId, projectId, dirName, openAiKey, anthropicKey, manageApiPort, runApiPort } = args;
-  p.intro(color.inverse(" Create Agents Directory "));
-  if (!dirName) {
-    const dirResponse = await p.text({
-      message: "What do you want to name your agents directory?",
-      placeholder: "agents",
-      defaultValue: "agents",
-      validate: (value) => {
-        if (!value || value.trim() === "") {
-          return "Directory name is required";
-        }
-        return void 0;
-      }
-    });
-    if (p.isCancel(dirResponse)) {
-      p.cancel("Operation cancelled");
-      process.exit(0);
-    }
-    dirName = dirResponse;
-  }
-  if (!tenantId) {
-    const tenantIdResponse = await p.text({
-      message: "Enter your tenant ID :",
-      placeholder: "(default)",
-      defaultValue: "default"
-    });
-    if (p.isCancel(tenantIdResponse)) {
-      p.cancel("Operation cancelled");
-      process.exit(0);
-    }
-    tenantId = tenantIdResponse;
-  }
-  if (!projectId) {
-    const projectIdResponse = await p.text({
-      message: "Enter your project ID:",
-      placeholder: "(default)",
-      defaultValue: "default"
-    });
-    if (p.isCancel(projectIdResponse)) {
-      p.cancel("Operation cancelled");
-      process.exit(0);
-    }
-    projectId = projectIdResponse;
-  }
-  if (!anthropicKey && !openAiKey) {
-    const providerChoice = await p.select({
-      message: "Which AI provider(s) would you like to use?",
-      options: [
-        { value: "both", label: "Both Anthropic and OpenAI (recommended)" },
-        { value: "anthropic", label: "Anthropic only" },
-        { value: "openai", label: "OpenAI only" }
-      ]
-    });
-    if (p.isCancel(providerChoice)) {
-      p.cancel("Operation cancelled");
-      process.exit(0);
-    }
-    if (providerChoice === "anthropic" || providerChoice === "both") {
-      const anthropicKeyResponse = await p.text({
-        message: "Enter your Anthropic API key:",
-        placeholder: "sk-ant-...",
-        validate: (value) => {
-          if (!value || value.trim() === "") {
-            return "Anthropic API key is required";
-          }
-          return void 0;
-        }
-      });
-      if (p.isCancel(anthropicKeyResponse)) {
-        p.cancel("Operation cancelled");
-        process.exit(0);
-      }
-      anthropicKey = anthropicKeyResponse;
-    }
-    if (providerChoice === "openai" || providerChoice === "both") {
-      const openAiKeyResponse = await p.text({
-        message: "Enter your OpenAI API key:",
-        placeholder: "sk-...",
-        validate: (value) => {
-          if (!value || value.trim() === "") {
-            return "OpenAI API key is required";
-          }
-          return void 0;
-        }
-      });
-      if (p.isCancel(openAiKeyResponse)) {
-        p.cancel("Operation cancelled");
-        process.exit(0);
-      }
-      openAiKey = openAiKeyResponse;
-    }
-  } else {
-    if (!anthropicKey) {
-      const anthropicKeyResponse = await p.text({
-        message: "Enter your Anthropic API key (optional):",
-        placeholder: "sk-ant-...",
-        defaultValue: ""
-      });
-      if (p.isCancel(anthropicKeyResponse)) {
-        p.cancel("Operation cancelled");
-        process.exit(0);
-      }
-      anthropicKey = anthropicKeyResponse || void 0;
-    }
-    if (!openAiKey) {
-      const openAiKeyResponse = await p.text({
-        message: "Enter your OpenAI API key (optional):",
-        placeholder: "sk-...",
-        defaultValue: ""
-      });
-      if (p.isCancel(openAiKeyResponse)) {
-        p.cancel("Operation cancelled");
-        process.exit(0);
-      }
-      openAiKey = openAiKeyResponse || void 0;
-    }
-  }
-  let defaultModelSettings = {};
-  if (anthropicKey && openAiKey) {
-    defaultModelSettings = defaultDualModelConfigurations;
-  } else if (anthropicKey) {
-    defaultModelSettings = defaultAnthropicModelConfigurations;
-  } else if (openAiKey) {
-    defaultModelSettings = defaultOpenaiModelConfigurations;
-  }
-  const s = p.spinner();
-  s.start("Creating directory structure...");
-  try {
-    const directoryPath = path.resolve(process.cwd(), dirName);
-    if (await fs.pathExists(directoryPath)) {
-      s.stop();
-      const overwrite = await p.confirm({
-        message: `Directory ${dirName} already exists. Do you want to overwrite it?`
-      });
-      if (p.isCancel(overwrite) || !overwrite) {
-        p.cancel("Operation cancelled");
-        process.exit(0);
-      }
-      s.start("Cleaning existing directory...");
-      await fs.emptyDir(directoryPath);
-    }
-    await fs.ensureDir(directoryPath);
-    process.chdir(directoryPath);
-    const config = {
-      dirName,
-      tenantId,
-      projectId,
-      openAiKey,
-      anthropicKey,
-      manageApiPort: manageApiPort || "3002",
-      runApiPort: runApiPort || "3003",
-      modelSettings: defaultModelSettings
-    };
-    s.message("Setting up workspace structure...");
-    await createWorkspaceStructure(projectId);
-    s.message("Creating package configurations...");
-    await setupPackageConfigurations(dirName);
-    s.message("Setting up environment files...");
-    await createEnvironmentFiles(config);
-    s.message("Creating service files...");
-    await createServiceFiles(config);
-    s.message("Creating documentation...");
-    await createDocumentation(config);
-    s.message("Setting up Turbo...");
-    await createTurboConfig();
-    s.message("Installing dependencies (this may take a while)...");
-    await installDependencies();
-    s.message("Setting up database...");
-    await setupDatabase();
-    s.stop();
-    p.note(
-      `${color.green("\u2713")} Project created at: ${color.cyan(directoryPath)}
-
-${color.yellow("Next steps:")}
-  cd ${dirName}
-  pnpm run dev (for APIs only)
-  inkeep dev (for APIs + Manage UI)
-
-${color.yellow("Available services:")}
-  \u2022 Manage API: http://localhost:${manageApiPort || "3002"}
-  \u2022 Run API: http://localhost:${runApiPort || "3003"}
-  \u2022 Manage UI: Available with 'inkeep dev'
-
-${color.yellow("Configuration:")}
-  \u2022 Edit .env for environment variables
-  \u2022 Edit src/${projectId}/weather.graph.ts for agent definitions
-  \u2022 Use 'inkeep push' to deploy agents to the platform
-  \u2022 Use 'inkeep chat' to test your agents locally
-`,
-      "Ready to go!"
-    );
-  } catch (error) {
-    s.stop();
-    p.cancel(
-      `Error creating directory: ${error instanceof Error ? error.message : "Unknown error"}`
-    );
-    process.exit(1);
-  }
-};
-async function createWorkspaceStructure(projectId) {
-  await fs.ensureDir(`src/${projectId}`);
-  await fs.ensureDir("apps/manage-api/src");
-  await fs.ensureDir("apps/run-api/src");
-  await fs.ensureDir("apps/shared");
-}
-async function setupPackageConfigurations(dirName) {
-  const rootPackageJson = {
-    name: dirName,
-    version: "0.1.0",
-    description: "An Inkeep Agent Framework directory",
-    private: true,
-    type: "module",
-    scripts: {
-      dev: "turbo dev",
-      "db:push": "drizzle-kit push"
-    },
-    dependencies: {},
-    devDependencies: {
-      "@biomejs/biome": "^1.8.0",
-      "@inkeep/agents-cli": "^0.1.1",
-      "drizzle-kit": "^0.31.4",
-      tsx: "^4.19.0",
-      turbo: "^2.5.5"
-    },
-    engines: {
-      node: ">=22.x"
-    },
-    packageManager: "pnpm@10.10.0"
-  };
-  await fs.writeJson("package.json", rootPackageJson, { spaces: 2 });
-  const pnpmWorkspace = `packages:
-  - "apps/*"
-`;
-  await fs.writeFile("pnpm-workspace.yaml", pnpmWorkspace);
-  rootPackageJson.dependencies = {
-    "@inkeep/agents-core": "^0.1.0",
-    "@inkeep/agents-sdk": "^0.1.0",
-    zod: "^4.1.5"
-  };
-  await fs.writeJson("package.json", rootPackageJson, { spaces: 2 });
-  const manageApiPackageJson = {
-    name: `@${dirName}/manage-api`,
-    version: "0.1.0",
-    description: "Manage API for agents",
-    type: "module",
-    scripts: {
-      build: "tsc",
-      dev: "tsx watch src/index.ts",
-      start: "node dist/index.js"
-    },
-    dependencies: {
-      "@inkeep/agents-manage-api": "^0.1.1",
-      "@inkeep/agents-core": "^0.1.0",
-      "@hono/node-server": "^1.14.3"
-    },
-    devDependencies: {
-      "@types/node": "^20.12.0",
-      tsx: "^4.19.0",
-      typescript: "^5.4.0"
-    },
-    engines: {
-      node: ">=22.x"
-    }
-  };
-  await fs.writeJson("apps/manage-api/package.json", manageApiPackageJson, { spaces: 2 });
-  const runApiPackageJson = {
-    name: `@${dirName}/run-api`,
-    version: "0.1.0",
-    description: "Run API for agents",
-    type: "module",
-    scripts: {
-      dev: "tsx watch src/index.ts",
-      start: "node dist/index.js"
-    },
-    dependencies: {
-      "@inkeep/agents-run-api": "^0.1.1",
-      "@inkeep/agents-core": "^0.1.0",
-      "@hono/node-server": "^1.14.3"
-    },
-    devDependencies: {
-      "@types/node": "^20.12.0",
-      tsx: "^4.19.0",
-      typescript: "^5.4.0"
-    },
-    engines: {
-      node: ">=22.x"
-    }
-  };
-  await fs.writeJson("apps/run-api/package.json", runApiPackageJson, { spaces: 2 });
-  const apiTsConfig = {
-    compilerOptions: {
-      target: "ES2022",
-      module: "ESNext",
-      moduleResolution: "bundler",
-      strict: true,
-      esModuleInterop: true,
-      skipLibCheck: true,
-      forceConsistentCasingInFileNames: true,
-      declaration: true,
-      outDir: "./dist",
-      rootDir: "..",
-      allowImportingTsExtensions: false,
-      resolveJsonModule: true,
-      isolatedModules: true,
-      noEmit: false
-    },
-    include: ["src/**/*", "../shared/**/*"],
-    exclude: ["node_modules", "dist", "**/*.test.ts"]
-  };
-  await fs.writeJson("apps/manage-api/tsconfig.json", apiTsConfig, { spaces: 2 });
-  await fs.writeJson("apps/run-api/tsconfig.json", apiTsConfig, { spaces: 2 });
-}
-async function createEnvironmentFiles(config) {
-  const envContent = `# Environment
-ENVIRONMENT=development
-
-# Database
-DB_FILE_NAME=file:./local.db
-
-# AI Provider Keys  
-ANTHROPIC_API_KEY=${config.anthropicKey || "your-anthropic-key-here"}
-OPENAI_API_KEY=${config.openAiKey || "your-openai-key-here"}
-
-# Logging
-LOG_LEVEL=debug
-
-# Service Ports
-MANAGE_API_PORT=${config.manageApiPort}
-RUN_API_PORT=${config.runApiPort}
-
-# UI Configuration (for dashboard)
-NEXT_PUBLIC_INKEEP_AGENTS_MANAGE_API_URL=http://localhost:${config.manageApiPort}
-NEXT_PUBLIC_INKEEP_AGENTS_RUN_API_URL=http://localhost:${config.runApiPort}
-`;
-  await fs.writeFile(".env", envContent);
-  const envExample = envContent.replace(/=.+$/gm, "=");
-  await fs.writeFile(".env.example", envExample);
-  const runApiEnvContent = `# Environment
-ENVIRONMENT=development
-
-# Database (relative path from API directory)
-DB_FILE_NAME=file:../../local.db
-
-# AI Provider Keys  
-ANTHROPIC_API_KEY=${config.anthropicKey || "your-anthropic-key-here"}
-OPENAI_API_KEY=${config.openAiKey || "your-openai-key-here"}
-
-AGENTS_RUN_API_URL=http://localhost:${config.runApiPort}
-`;
-  const manageApiEnvContent = `# Environment
-ENVIRONMENT=development
-
-# Database (relative path from API directory)
-DB_FILE_NAME=file:../../local.db
-
-AGENTS_MANAGE_API_URL=http://localhost:${config.manageApiPort}
-`;
-  await fs.writeFile("apps/manage-api/.env", manageApiEnvContent);
-  await fs.writeFile("apps/run-api/.env", runApiEnvContent);
-  const gitignore = `# Dependencies
-node_modules/
-.pnpm-store/
-
-# Environment variables
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-
-# Build outputs
-dist/
-build/
-.next/
-.turbo/
-
-# Logs
-*.log
-logs/
-
-# Database
-*.db
-*.sqlite
-*.sqlite3
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Coverage
-coverage/
-.nyc_output/
-
-# Temporary files
-*.tmp
-*.temp
-.cache/
-
-# Runtime data
-pids/
-*.pid
-*.seed
-*.pid.lock
-`;
-  await fs.writeFile(".gitignore", gitignore);
-  const biomeConfig = {
-    linter: {
-      enabled: true,
-      rules: {
-        recommended: true
-      }
-    },
-    formatter: {
-      enabled: true,
-      indentStyle: "space",
-      indentWidth: 2
-    },
-    organizeImports: {
-      enabled: true
-    },
-    javascript: {
-      formatter: {
-        semicolons: "always",
-        quoteStyle: "single"
-      }
-    }
-  };
-  await fs.writeJson("biome.json", biomeConfig, { spaces: 2 });
-}
-async function createServiceFiles(config) {
-  const agentsGraph = `import { agent, agentGraph, mcpTool } from '@inkeep/agents-sdk';
-
-// MCP Tools
-const forecastWeatherTool = mcpTool({
-  id: 'fUI2riwrBVJ6MepT8rjx0',
-  name: 'Forecast weather',
-  serverUrl: 'https://weather-forecast-mcp.vercel.app/mcp',
-});
-
-const geocodeAddressTool = mcpTool({
-  id: 'fdxgfv9HL7SXlfynPx8hf',
-  name: 'Geocode address',
-  serverUrl: 'https://geocoder-mcp.vercel.app/mcp',
-});
-
-// Agents
-const weatherAssistant = agent({
-  id: 'weather-assistant',
-  name: 'Weather assistant',
-  description: 'Responsible for routing between the geocoder agent and weather forecast agent',
-  prompt:
-    'You are a helpful assistant. When the user asks about the weather in a given location, first ask the geocoder agent for the coordinates, and then pass those coordinates to the weather forecast agent to get the weather forecast',
-  canDelegateTo: () => [weatherForecaster, geocoderAgent],
-});
-
-const weatherForecaster = agent({
-  id: 'weather-forecaster',
-  name: 'Weather forecaster',
-  description:
-    'This agent is responsible for taking in coordinates and returning the forecast for the weather at that location',
-  prompt:
-    'You are a helpful assistant responsible for taking in coordinates and returning the forecast for that location using your forecasting tool',
-  canUse: () => [forecastWeatherTool],
-});
-
-const geocoderAgent = agent({
-  id: 'geocoder-agent',
-  name: 'Geocoder agent',
-  description: 'Responsible for converting location or address into coordinates',
-  prompt:
-    'You are a helpful assistant responsible for converting location or address into coordinates using your geocode tool',
-  canUse: () => [geocodeAddressTool],
-});
-
-// Agent Graph
-export const weatherGraph = agentGraph({
-  id: 'weather-graph',
-  name: 'Weather graph',
-  defaultAgent: weatherAssistant,
-  agents: () => [weatherAssistant, weatherForecaster, geocoderAgent],
-});`;
-  await fs.writeFile(`src/${config.projectId}/weather.graph.ts`, agentsGraph);
-  const inkeepConfig = `import { defineConfig } from '@inkeep/agents-cli/config';
-
-const config = defineConfig({
-  tenantId: "${config.tenantId}",
-  projectId: "${config.projectId}",
-  agentsManageApiUrl: \`http://localhost:\${process.env.MANAGE_API_PORT || '3002'}\`,
-  agentsRunApiUrl: \`http://localhost:\${process.env.RUN_API_PORT || '3003'}\`,
-  modelSettings: ${JSON.stringify(config.modelSettings, null, 2)},
-});
-    
-export default config;`;
-  await fs.writeFile(`src/${config.projectId}/inkeep.config.ts`, inkeepConfig);
-  const projectEnvContent = `# Environment
-ENVIRONMENT=development
-
-# Database (relative path from project directory)
-DB_FILE_NAME=file:../../local.db
-
-# UI Configuration (for dashboard)
-NEXT_PUBLIC_INKEEP_AGENTS_MANAGE_API_URL=http://localhost:${config.manageApiPort}
-NEXT_PUBLIC_INKEEP_AGENTS_RUN_API_URL=http://localhost:${config.runApiPort}
-
-`;
-  await fs.writeFile(`src/${config.projectId}/.env`, projectEnvContent);
-  const credentialStoresFile = `import {
-  InMemoryCredentialStore,
-  createNangoCredentialStore,
-  createKeyChainStore,
-} from '@inkeep/agents-core';
-
-// Shared credential stores configuration for all services
-export const credentialStores = [
-  new InMemoryCredentialStore('memory-default'),
-  ...(process.env.NANGO_SECRET_KEY
-    ? [
-        createNangoCredentialStore('nango-default', {
-          apiUrl: process.env.NANGO_HOST || 'https://api.nango.dev',
-          secretKey: process.env.NANGO_SECRET_KEY,
-        }),
-      ]
-    : []),
-  createKeyChainStore('keychain-default'),
-];
-`;
-  await fs.writeFile("apps/shared/credential-stores.ts", credentialStoresFile);
-  const manageApiIndex = `import { serve } from '@hono/node-server';
-import { createManagementApp } from '@inkeep/agents-manage-api';
-import { getLogger } from '@inkeep/agents-core';
-import { credentialStores } from '../../shared/credential-stores.js';
-
-const logger = getLogger('management-api');
-
-// Create the Hono app
-const app = createManagementApp({
-  serverConfig: {
-    port: Number(process.env.MANAGE_API_PORT) || 3002,
-    serverOptions: {
-      requestTimeout: 60000,
-      keepAliveTimeout: 60000,
-      keepAlive: true,
-    },
-  },
-  credentialStores,
-});
-
-const port = Number(process.env.MANAGE_API_PORT) || 3002;
-
-// Start the server using @hono/node-server
-serve(
-  {
-    fetch: app.fetch,
-    port,
-  },
-  (info) => {
-    logger.info({}, \`\u{1F4DD} Management API running on http://localhost:\${info.port}\`);
-    logger.info({}, \`\u{1F4DD} OpenAPI documentation available at http://localhost:\${info.port}/openapi.json\`);
-  }
-);`;
-  await fs.writeFile("apps/manage-api/src/index.ts", manageApiIndex);
-  const runApiIndex = `import { serve } from '@hono/node-server';
-import { createExecutionApp } from '@inkeep/agents-run-api';
-import { credentialStores } from '../../shared/credential-stores.js';
-import { getLogger } from '@inkeep/agents-core';
-
-const logger = getLogger('execution-api');
-
-
-// Create the Hono app
-const app = createExecutionApp({
-  serverConfig: {
-    port: Number(process.env.RUN_API_PORT) || 3003,
-    serverOptions: {
-      requestTimeout: 120000,
-      keepAliveTimeout: 60000,
-      keepAlive: true,
-    },
-  },
-  credentialStores,
-});
-
-const port = Number(process.env.RUN_API_PORT) || 3003;
-
-// Start the server using @hono/node-server
-serve(
-  {
-    fetch: app.fetch,
-    port,
-  },
-  (info) => {
-    logger.info({}, \`\u{1F4DD} Run API running on http://localhost:\${info.port}\`);
-    logger.info({}, \`\u{1F4DD} OpenAPI documentation available at http://localhost:\${info.port}/openapi.json\`);
-  }
-);`;
-  await fs.writeFile("apps/run-api/src/index.ts", runApiIndex);
-  const drizzleConfig = `import { defineConfig } from 'drizzle-kit';
-
-export default defineConfig({
-  schema: 'node_modules/@inkeep/agents-core/dist/db/schema.js',
-  dialect: 'sqlite',
-  dbCredentials: {
-    url: process.env.DB_FILE_NAME || 'file:./local.db'
-  },
-});`;
-  await fs.writeFile("drizzle.config.ts", drizzleConfig);
-}
-async function createTurboConfig() {
-  const turboConfig = {
-    $schema: "https://turbo.build/schema.json",
-    ui: "tui",
-    globalDependencies: ["**/.env", "**/.env.local", "**/.env.*"],
-    globalEnv: [
-      "NODE_ENV",
-      "CI",
-      "ANTHROPIC_API_KEY",
-      "OPENAI_API_KEY",
-      "ENVIRONMENT",
-      "DB_FILE_NAME",
-      "MANAGE_API_PORT",
-      "RUN_API_PORT",
-      "LOG_LEVEL",
-      "NANGO_SECRET_KEY"
-    ],
-    tasks: {
-      build: {
-        dependsOn: ["^build"],
-        inputs: ["$TURBO_DEFAULT$", ".env*"],
-        outputs: ["dist/**", "build/**", ".next/**", "!.next/cache/**"]
-      },
-      dev: {
-        cache: false,
-        persistent: true
-      },
-      start: {
-        dependsOn: ["build"],
-        cache: false
-      },
-      "db:push": {
-        cache: false,
-        inputs: ["drizzle.config.ts", "src/data/db/schema.ts"]
-      }
-    }
-  };
-  await fs.writeJson("turbo.json", turboConfig, { spaces: 2 });
-}
-async function createDocumentation(config) {
-  const readme = `# ${config.dirName}
-
-An Inkeep Agent Framework project with multi-service architecture.
-
-## Architecture
-
-This project follows a workspace structure with the following services:
-
-- **Agents Manage API** (Port 3002): Agent configuration and managemen
-  - Handles entity management and configuration endpoints.
-- **Agents Run API** (Port 3003): Agent execution and chat processing  
-  - Handles agent communication. You can interact with your agents either over MCP from an MCP client or through our React UI components library
-- **Agents Manage UI** (Port 3000): Web interface available via \`inkeep dev\`
-  - The agent framework visual builder. From the builder you can create, manage and visualize all your graphs.
-
-## Quick Start
-1. **Install the Inkeep CLI:**
-   \`\`\`bash
-   pnpm install -g @inkeep/agents-cli
-   \`\`\`
-
-1. **Start services:**
-   \`\`\`bash
-   # Start Agents Manage API and Agents Run API
-   pnpm dev
-   
-   # Start the Dashboard
-   inkeep dev
-   \`\`\`
-
-3. **Deploy your first agent graph:**
-   \`\`\`bash
-   # Navigate to your project's graph directory
-   cd src/${config.projectId}/
-   
-   # Push the weather graph to create it
-   inkeep push weather.graph.ts
-   \`\`\`
-  - Follow the prompts to create the project and graph
-  - Click on the "View graph in UI:" link to see the graph in the management dashboard
-
-## Project Structure
-
-\`\`\`
-${config.dirName}/
-\u251C\u2500\u2500 src/
-\u2502   \u251C\u2500\u2500 /${config.projectId}              # Agent configurations
-\u251C\u2500\u2500 apps/
-\u2502   \u251C\u2500\u2500 manage-api/          # Agents Manage API service
-\u2502   \u251C\u2500\u2500 run-api/             # Agents Run API service
-\u2502   \u2514\u2500\u2500 shared/              # Shared code between API services
-\u2502       \u2514\u2500\u2500 credential-stores.ts  # Shared credential store configuration
-\u251C\u2500\u2500 turbo.json               # Turbo configuration
-\u251C\u2500\u2500 pnpm-workspace.yaml      # pnpm workspace configuration
-\u2514\u2500\u2500 package.json             # Root package configuration
-\`\`\`
-
-## Configuration
-
-### Environment Variables
-
-Environment variables are defined in the following places:
-
-- \`apps/manage-api/.env\`: Agents Manage API environment variables
-- \`apps/run-api/.env\`: Agents Run API environment variables
-- \`src/${config.projectId}/.env\`: Inkeep CLI environment variables
-- \`.env\`: Root environment variables 
-
-To change the API keys used by your agents modify \`apps/run-api/.env\`. You are required to define at least one LLM provider key.
-
-\`\`\`bash
-# AI Provider Keys
-ANTHROPIC_API_KEY=your-anthropic-key-here
-OPENAI_API_KEY=your-openai-key-here
-\`\`\`
-
-To change the ports used by your services modify \`apps/manage-api/.env\` and \`apps/run-api/.env\` respectively:
-
-\`\`\`bash
-# Service port for apps/run-api 
-RUN_API_PORT=3003
-
-# Service port for apps/manage-api
-MANAGE_API_PORT=3002
-\`\`\`
-
-After changing the API Service ports make sure that you modify the dashboard API urls from whichever directory you are running \`inkeep dev\`:
-
-\`\`\`bash
-# UI Configuration (for dashboard)
-NEXT_PUBLIC_INKEEP_AGENTS_MANAGE_API_URL=http://localhost:${config.manageApiPort}
-NEXT_PUBLIC_INKEEP_AGENTS_RUN_API_URL=http://localhost:${config.runApiPort}
-\`\`\`
-
-### Agent Configuration
-
-Your graphs are defined in \`src/${config.projectId}/weather.graph.ts\`. The default setup includes:
-
-- **Weather Graph**: A graph that can forecast the weather in a given location.
-
-Your inkeep configuration is defined in \`src/${config.projectId}/inkeep.config.ts\`. The inkeep configuration is used to configure defaults for the inkeep CLI. The configuration includes:
-
-- \`tenantId\`: The tenant ID
-- \`projectId\`: The project ID
-- \`agentsManageApiUrl\`: The Manage API URL
-- \`agentsRunApiUrl\`: The Run API URL
-
-
-## Development
-
-### Updating Your Agents
-
-1. Edit \`src/${config.projectId}/weather.graph.ts\`
-2. Push the graph to the platform to update: \`inkeep pus weather.graph.ts\` 
-
-### API Documentation
-
-Once services are running, view the OpenAPI documentation:
-
-- Manage API: http://localhost:${config.manageApiPort}/docs
-- Run API: http://localhost:${config.runApiPort}/docs
-
-## Learn More
-
-- [Inkeep Documentation](https://docs.inkeep.com)
-
-## Troubleshooting
-
-## Inkeep CLI commands
-
-- Ensure you are runnning commands from \`cd src/${config.projectId}\`.
-- Validate the \`inkeep.config.ts\` file has the correct api urls.
-- Validate that the \`.env\` file in \`src/${config.projectId}\` has the correct \`DB_FILE_NAME\`.
-
-### Services won't start
-
-1. Ensure all dependencies are installed: \`pnpm install\`
-2. Check that ports 3000-3003 are available
-
-### Agents won't respond
-
-1. Ensure that the Agents Run API is running and includes a valid Anthropic or OpenAI API key in its .env file
-`;
-  await fs.writeFile("README.md", readme);
-}
-async function installDependencies() {
-  await execAsync("pnpm install");
-}
-async function setupDatabase() {
-  try {
-    await execAsync("pnpm db:push");
-  } catch (error) {
-    throw new Error(
-      `Failed to setup database: ${error instanceof Error ? error.message : "Unknown error"}`
-    );
-  }
-}
-async function createCommand(dirName, options) {
-  await createAgents({
-    dirName,
-    ...options
-  });
-}
-export {
-  createAgents,
-  createCommand
-};