@inkeep/create-agents 0.0.0-dev-20250910232631

package/README.md

@@ -0,0 +1,158 @@
+# create-agents
+
+Create an Inkeep Agent Framework directory with multi-service architecture.
+
+## Quick Start
+
+```bash
+# Interactive mode
+npx @inkeep/create-agents
+
+# With directory name
+npx @inkeep/create-agents my-agent-directory
+
+# With options
+npx @inkeep/create-agents my-agent-directory --tenant-id default --project-id my-project --openai-key sk-... --anthropic-key sk-ant-...
+```
+
+## Usage
+
+`@inkeep/create-agents` is a wrapper around the Inkeep CLI's `create` command that sets up a complete Agent Framework directory with:
+
+### Interactive Mode
+Run without arguments for an interactive setup experience:
+```bash
+npx @inkeep/create-agents
+```
+
+You'll be prompted for:
+- Directory name
+- Tenant ID
+- Project ID  
+- Anthropic API key (recommended)
+- OpenAI API key (optional)
+
+### Direct Mode
+Specify options directly:
+```bash
+npx @inkeep/create-agents my-agent-directory --tenant-id my-tenant --project-id my-project-id --anthropic-key sk-ant-... --openai-key sk-...
+```
+
+## Options
+
+- `--tenant-id <tenant-id>` - Your Inkeep tenant ID
+- `--project-id <project-id>` - Project identifier for your agents
+- `--openai-key <openai-key>` - OpenAI API key (optional)
+- `--anthropic-key <anthropic-key>` - Anthropic API key (recommended)
+- `--manage-api-port <port>` - Management API port (default: 3002)
+- `--run-api-port <port>` - Run API port (default: 3003)
+
+## What's Created
+
+After running `@inkeep/create-agents`, you'll have a complete Agent Framework Directory:
+
+```
+my-agent-directory/
+├── src/
+│   └── <project-id>/           # Agent configurations
+│       ├── hello.graph.ts      # Example agent graph
+│       ├── inkeep.config.ts    # Inkeep CLI configuration
+│       └── .env                # CLI environment variables
+├── apps/
+│   ├── manage-api/             # Management API service
+│   │   ├── src/index.ts        # API server entry point
+│   │   ├── package.json        # Service dependencies
+│   │   ├── tsconfig.json       # TypeScript config
+│   │   └── .env                # Service environment
+│   ├── run-api/                # Execution API service  
+│   │   ├── src/index.ts        # API server entry point
+│   │   ├── package.json        # Service dependencies
+│   │   ├── tsconfig.json       # TypeScript config
+│   │   └── .env                # Service environment
+│   └── shared/                 # Shared code
+│       └── credential-stores.ts # Credential store config
+├── package.json                # Root package with workspaces
+├── turbo.json                  # Turbo build configuration
+├── drizzle.config.ts           # Database configuration
+├── biome.json                  # Linting and formatting
+├── .env                        # Root environment variables
+├── .env.example                # Environment template
+├── .gitignore                  # Git ignore rules
+└── README.md                   # Project documentation
+```
+
+## Next Steps
+
+1. **Navigate to your directory:**
+   ```bash
+   cd my-agent-directory
+   ```
+
+2. **Start the services:**
+   ```bash
+   # Start both Management and Run APIs
+   npm run dev
+   ```
+
+3. **In a new terminal, start the Management Dashboard:**
+   ```bash
+   npx inkeep dev
+   ```
+
+4. **Deploy your first agent graph:**
+   ```bash
+   cd src/<project-id>/
+   npx inkeep push hello.graph.ts
+   ```
+
+5. **Test your agents:**
+   ```bash
+   npx inkeep chat
+   ```
+
+## Available Services
+
+After setup, you'll have access to:
+
+- **Management API** (Port 3002): Agent configuration and management
+- **Run API** (Port 3003): Agent execution and chat processing  
+- **Management Dashboard** (Port 3000): Visual agent builder (via `npx inkeep dev`)
+
+## Commands Available in Your Directory
+
+- `npm run dev` - Start both API services with hot reload
+- `npm run db:push` - Apply database schema changes
+- `npx inkeep dev` - Start the Management Dashboard
+- `npx inkeep push <graph-file>` - Deploy agent configurations
+- `npx inkeep chat` - Interactive chat with your agents
+
+## Environment Variables
+
+The directory includes multiple environment files:
+
+### Root `.env` (shared configuration)
+```bash
+# AI Provider Keys
+ANTHROPIC_API_KEY=your-anthropic-key-here
+OPENAI_API_KEY=your-openai-key-here
+
+# Service Ports
+MANAGE_API_PORT=3002
+RUN_API_PORT=3003
+
+# Database
+DB_FILE_NAME=file:./local.db
+
+# Environment
+ENVIRONMENT=development
+LOG_LEVEL=debug
+```
+
+### Service-specific `.env` files
+- `apps/manage-api/.env` - Management API configuration
+- `apps/run-api/.env` - Run API configuration  
+- `src/<project-id>/.env` - CLI configuration
+
+## Learn More
+
+- 📚 [Documentation](https://docs.inkeep.com)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { createAgents } from '@inkeep/agents-cli/commands/create';
+program
+    .name('create-agents')
+    .description('Create an Inkeep Agent Framework directory')
+    .version('0.1.0')
+    .argument('[directory-name]', 'Name of the directory')
+    .option('--tenant-id <tenant-id>', 'Tenant ID')
+    .option('--project-id <project-id>', 'Project ID')
+    .option('--openai-key <openai-key>', 'OpenAI API key')
+    .option('--anthropic-key <anthropic-key>', 'Anthropic API key')
+    .option('--manage-api-port <port>', 'Management API port', '3002')
+    .option('--run-api-port <port>', 'Run API port', '3003')
+    .parse();
+async function main() {
+    const options = program.opts();
+    const directoryName = program.args[0];
+    try {
+        await createAgents({
+            dirName: directoryName,
+            openAiKey: options.openaiKey,
+            anthropicKey: options.anthropicKey,
+            tenantId: options.tenantId,
+            projectId: options.projectId,
+            manageApiPort: options.manageApiPort,
+            runApiPort: options.runApiPort,
+        });
+    }
+    catch (error) {
+        console.error('Failed to create directory:', error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('An unexpected error occurred:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@inkeep/create-agents",
+  "version": "0.0.0-dev-20250910232631",
+  "description": "Create an Inkeep Agent Framework project",
+  "type": "module",
+  "bin": {
+    "create-agents": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "test": "vitest --run --passWithNoTests",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "inkeep",
+    "agents",
+    "ai",
+    "framework",
+    "boilerplate",
+    "typescript",
+    "project",
+    "starter",
+    "cli",
+    "create",
+    "init"
+  ],
+  "author": "Inkeep <support@inkeep.com>",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "dependencies": {
+    "@inkeep/agents-cli": "workspace:^",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.8.0",
+    "@types/node": "^20.12.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/inkeep/agents.git",
+    "directory": "packages/create-agents"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}