@inkeep/create-agents 0.1.10 → 0.2.1

package/README.md

@@ -96,10 +96,10 @@ my-agent-directory/
    inkeep dev
    ```
 
-4. **Deploy your first agent graph:**
+4. **Deploy your project:**
    ```bash
    cd src/<project-id>/
-   pnpm inkeep push hello.graph.ts
+   pnpm inkeep push
    ```
 
 5. **Test your agents:**
@@ -120,7 +120,7 @@ After setup, you'll have access to:
 - `pnpm dev` - Start both API services with hot reload
 - `pnpm db:push` - Apply database schema changes
 - `inkeep dev` - Start the Manage UI
-- `inkeep push <graph-file>` - Deploy agent configurations
+- `inkeep push` - Deploy project configurations
 - `inkeep chat` - Interactive chat with your agents
 
 ## Environment Variables

package/dist/__tests__/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/utils.test.js

@@ -0,0 +1,237 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import fs from 'fs-extra';
+import { createAgents } from '../utils';
+import { getAvailableTemplates, cloneTemplate } from '../templates';
+import * as p from '@clack/prompts';
+// Mock all dependencies
+vi.mock('fs-extra');
+vi.mock('../templates');
+vi.mock('@clack/prompts');
+vi.mock('child_process');
+vi.mock('util');
+// Setup default mocks
+const mockSpinner = {
+    start: vi.fn().mockReturnThis(),
+    stop: vi.fn().mockReturnThis(),
+    message: vi.fn().mockReturnThis(),
+};
+describe('createAgents - Template and Project ID Logic', () => {
+    let processExitSpy;
+    let processChdirSpy;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // Mock process methods
+        processExitSpy = vi.spyOn(process, 'exit').mockImplementation((code) => {
+            // Only throw for exit(0) which is expected behavior in some tests
+            // Let exit(1) pass so we can see the actual error
+            if (code === 0) {
+                throw new Error('process.exit called');
+            }
+            // Don't actually exit for exit(1) in tests
+            return undefined;
+        });
+        processChdirSpy = vi.spyOn(process, 'chdir').mockImplementation(() => { });
+        // Setup default mocks for @clack/prompts
+        vi.mocked(p.intro).mockImplementation(() => { });
+        vi.mocked(p.outro).mockImplementation(() => { });
+        vi.mocked(p.cancel).mockImplementation(() => { });
+        vi.mocked(p.note).mockImplementation(() => { });
+        vi.mocked(p.text).mockResolvedValue('test-dir');
+        vi.mocked(p.select).mockResolvedValue('dual');
+        vi.mocked(p.confirm).mockResolvedValue(false);
+        vi.mocked(p.spinner).mockReturnValue(mockSpinner);
+        vi.mocked(p.isCancel).mockReturnValue(false);
+        // Mock fs-extra
+        vi.mocked(fs.pathExists).mockResolvedValue(false);
+        vi.mocked(fs.ensureDir).mockResolvedValue(undefined);
+        vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+        vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+        vi.mocked(fs.remove).mockResolvedValue(undefined);
+        // Mock templates
+        vi.mocked(getAvailableTemplates).mockResolvedValue(['weather-graph', 'chatbot', 'data-analysis']);
+        vi.mocked(cloneTemplate).mockResolvedValue(undefined);
+        // Mock util.promisify to return a mock exec function
+        const mockExecAsync = vi.fn().mockResolvedValue({ stdout: '', stderr: '' });
+        const util = require('util');
+        util.promisify = vi.fn(() => mockExecAsync);
+        // Mock child_process.spawn
+        const childProcess = require('child_process');
+        childProcess.spawn = vi.fn(() => ({
+            pid: 12345,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            on: vi.fn(),
+            kill: vi.fn(),
+        }));
+    });
+    afterEach(() => {
+        processExitSpy.mockRestore();
+        processChdirSpy.mockRestore();
+    });
+    describe('Default behavior (no template or customProjectId)', () => {
+        it('should use weather-graph as default template and project ID', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                openAiKey: 'test-openai-key',
+                anthropicKey: 'test-anthropic-key'
+            });
+            // Should clone base template and weather-graph template
+            expect(cloneTemplate).toHaveBeenCalledTimes(2);
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/templates/weather-graph', 'src/weather-graph');
+            // Should not call getAvailableTemplates since no template validation needed
+            expect(getAvailableTemplates).not.toHaveBeenCalled();
+        });
+        it('should create project with weather-graph as project ID', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                openAiKey: 'test-openai-key',
+                anthropicKey: 'test-anthropic-key'
+            });
+            // Check that .env file is created with correct project ID path
+            expect(fs.writeFile).toHaveBeenCalledWith('src/weather-graph/.env', expect.any(String));
+            // Check that inkeep.config.ts is created with correct project ID
+            expect(fs.writeFile).toHaveBeenCalledWith('src/weather-graph/inkeep.config.ts', expect.stringContaining('projectId: "weather-graph"'));
+        });
+    });
+    describe('Template provided', () => {
+        it('should use template name as project ID when template is provided', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                template: 'chatbot',
+                openAiKey: 'test-openai-key',
+                anthropicKey: 'test-anthropic-key'
+            });
+            // Should validate template exists
+            expect(getAvailableTemplates).toHaveBeenCalled();
+            // Should clone base template and the specified template
+            expect(cloneTemplate).toHaveBeenCalledTimes(2);
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/templates/chatbot', 'src/chatbot');
+            // Should create config files with template name as project ID
+            expect(fs.writeFile).toHaveBeenCalledWith('src/chatbot/.env', expect.any(String));
+            expect(fs.writeFile).toHaveBeenCalledWith('src/chatbot/inkeep.config.ts', expect.stringContaining('projectId: "chatbot"'));
+        });
+        it('should exit with error when template does not exist', async () => {
+            vi.mocked(getAvailableTemplates).mockResolvedValue(['weather-graph', 'chatbot']);
+            await expect(createAgents({
+                dirName: 'test-dir',
+                template: 'non-existent-template',
+                openAiKey: 'test-openai-key'
+            })).rejects.toThrow('process.exit called');
+            expect(p.cancel).toHaveBeenCalledWith(expect.stringContaining('Template "non-existent-template" not found'));
+            expect(processExitSpy).toHaveBeenCalledWith(0);
+        });
+        it('should show available templates when invalid template is provided', async () => {
+            vi.mocked(getAvailableTemplates).mockResolvedValue(['weather-graph', 'chatbot', 'data-analysis']);
+            await expect(createAgents({
+                dirName: 'test-dir',
+                template: 'invalid',
+                openAiKey: 'test-openai-key'
+            })).rejects.toThrow('process.exit called');
+            const cancelCall = vi.mocked(p.cancel).mock.calls[0][0];
+            expect(cancelCall).toContain('weather-graph');
+            expect(cancelCall).toContain('chatbot');
+            expect(cancelCall).toContain('data-analysis');
+        });
+    });
+    describe('Custom Project ID provided', () => {
+        it('should use custom project ID and not clone any template', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                customProjectId: 'my-custom-project',
+                openAiKey: 'test-openai-key',
+                anthropicKey: 'test-anthropic-key'
+            });
+            // Should clone base template but NOT project template
+            expect(cloneTemplate).toHaveBeenCalledTimes(1);
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
+            // Should NOT validate templates
+            expect(getAvailableTemplates).not.toHaveBeenCalled();
+            // Should create empty project directory
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/my-custom-project');
+            // Should create config files with custom project ID
+            expect(fs.writeFile).toHaveBeenCalledWith('src/my-custom-project/.env', expect.any(String));
+            expect(fs.writeFile).toHaveBeenCalledWith('src/my-custom-project/inkeep.config.ts', expect.stringContaining('projectId: "my-custom-project"'));
+        });
+        it('should prioritize custom project ID over template if both are provided', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                template: 'chatbot',
+                customProjectId: 'my-custom-project',
+                openAiKey: 'test-openai-key',
+                anthropicKey: 'test-anthropic-key'
+            });
+            // Should only clone base template, not project template
+            expect(cloneTemplate).toHaveBeenCalledTimes(1);
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
+            expect(getAvailableTemplates).not.toHaveBeenCalled();
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/my-custom-project');
+            // Config should use custom project ID
+            expect(fs.writeFile).toHaveBeenCalledWith('src/my-custom-project/inkeep.config.ts', expect.stringContaining('projectId: "my-custom-project"'));
+        });
+    });
+    describe('Edge cases and validation', () => {
+        it('should handle template names with hyphens correctly', async () => {
+            vi.mocked(getAvailableTemplates).mockResolvedValue(['my-complex-template', 'another-template']);
+            await createAgents({
+                dirName: 'test-dir',
+                template: 'my-complex-template',
+                openAiKey: 'test-key',
+                anthropicKey: 'test-key'
+            });
+            expect(cloneTemplate).toHaveBeenCalledTimes(2);
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/templates/my-complex-template', 'src/my-complex-template');
+        });
+        it('should handle custom project IDs with special characters', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                customProjectId: 'my_project-123',
+                openAiKey: 'test-key',
+                anthropicKey: 'test-key'
+            });
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/my_project-123');
+            expect(fs.writeFile).toHaveBeenCalledWith('src/my_project-123/inkeep.config.ts', expect.stringContaining('projectId: "my_project-123"'));
+        });
+        it('should create correct folder structure for all scenarios', async () => {
+            // Test default
+            await createAgents({
+                dirName: 'dir1',
+                openAiKey: 'key',
+                anthropicKey: 'key'
+            });
+            expect(fs.ensureDir).toHaveBeenCalledWith('src');
+            // Reset mocks
+            vi.clearAllMocks();
+            setupDefaultMocks();
+            // Test with template
+            await createAgents({
+                dirName: 'dir2',
+                template: 'chatbot',
+                openAiKey: 'key',
+                anthropicKey: 'key'
+            });
+            expect(fs.ensureDir).toHaveBeenCalledWith('src');
+            // Reset mocks
+            vi.clearAllMocks();
+            setupDefaultMocks();
+            // Test with custom ID
+            await createAgents({
+                dirName: 'dir3',
+                customProjectId: 'custom',
+                openAiKey: 'key',
+                anthropicKey: 'key'
+            });
+            expect(fs.ensureDir).toHaveBeenCalledWith('src');
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/custom');
+        });
+    });
+});
+// Helper to setup default mocks
+function setupDefaultMocks() {
+    vi.mocked(p.spinner).mockReturnValue(mockSpinner);
+    vi.mocked(fs.pathExists).mockResolvedValue(false);
+    vi.mocked(fs.ensureDir).mockResolvedValue(undefined);
+    vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+    vi.mocked(getAvailableTemplates).mockResolvedValue(['weather-graph', 'chatbot', 'data-analysis']);
+    vi.mocked(cloneTemplate).mockResolvedValue(undefined);
+}

package/dist/index.js

@@ -6,9 +6,10 @@ program
     .description('Create an Inkeep Agent Framework directory')
     .version('0.1.0')
     .argument('[directory-name]', 'Name of the directory')
-    .option('--project-id <project-id>', 'Project ID')
+    .option('--template <template>', 'Template to use')
     .option('--openai-key <openai-key>', 'OpenAI API key')
     .option('--anthropic-key <anthropic-key>', 'Anthropic API key')
+    .option('--custom-project-id <custom-project-id>', 'Custom project id for experienced users who want an empty project directory')
     .parse();
 async function main() {
     const options = program.opts();
@@ -18,7 +19,8 @@ async function main() {
             dirName: directoryName,
             openAiKey: options.openaiKey,
             anthropicKey: options.anthropicKey,
-            projectId: options.projectId,
+            customProjectId: options.customProjectId,
+            template: options.template,
         });
     }
     catch (error) {

package/dist/templates.d.ts

@@ -0,0 +1,2 @@
+export declare function cloneTemplate(templatePath: string, targetPath: string): Promise<void>;
+export declare function getAvailableTemplates(): Promise<string[]>;

package/dist/templates.js

@@ -0,0 +1,22 @@
+import fs from 'fs-extra';
+import degit from 'degit';
+//Duplicating function here so we dont have to add a dependency on the agents-cli package
+export async function cloneTemplate(templatePath, targetPath) {
+    await fs.mkdir(targetPath, { recursive: true });
+    const templatePathSuffix = templatePath.replace('https://github.com/', '');
+    const emitter = degit(templatePathSuffix);
+    try {
+        await emitter.clone(targetPath);
+    }
+    catch (error) {
+        process.exit(1);
+    }
+}
+export async function getAvailableTemplates() {
+    // Fetch the list of templates from your repo
+    const response = await fetch('https://api.github.com/repos/inkeep/agents-cookbook/contents/templates');
+    const contents = await response.json();
+    return contents
+        .filter((item) => item.type === 'dir')
+        .map((item) => item.name);
+}

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-export declare const defaultDualModelConfigurations: {
+export declare const defaultGoogleModelConfigurations: {
     base: {
         model: string;
     };
@@ -32,9 +32,12 @@ export declare const defaultAnthropicModelConfigurations: {
     };
 };
 export declare const createAgents: (args?: {
-    projectId?: string;
     dirName?: string;
+    templateName?: string;
     openAiKey?: string;
     anthropicKey?: string;
+    googleKey?: string;
+    template?: string;
+    customProjectId?: string;
 }) => Promise<void>;
 export declare function createCommand(dirName?: string, options?: any): Promise<void>;