@agent-creator/cli 0.4.2

package/README.md

@@ -0,0 +1,9 @@
+# agent-creator-cli
+
+CLI for creating package or service projects powered by `@agent-creator/core`.
+
+```bash
+agent create my-agent --mode package
+agent create my-agent-service --mode service
+agent add skill calendar
+```

package/dist/package.json

@@ -0,0 +1,36 @@
+{
+    "name": "agent-creator-cli",
+    "version": "0.4.2",
+    "description": "CLI for creating projects powered by @agent-creator/core.",
+    "type": "module",
+    "bin": {
+        "agent": "./dist/src/index.js"
+    },
+    "main": "./dist/src/index.js",
+    "files": [
+        "dist",
+        "README.md",
+        "package.json"
+    ],
+    "scripts": {
+        "build": "node ../../scripts/clean-cli.mjs && tsc -p tsconfig.json && node ../../scripts/copy-capabilities.mjs",
+        "dev": "tsx src/index.ts",
+        "test": "vitest run",
+        "validate": "tsx src/index.ts validate",
+        "check:package": "npm pack --dry-run --json"
+    },
+    "dependencies": {
+        "@agent-creator/core": "file:../core",
+        "commander": "^12.1.0",
+        "typescript": "^5.9.3",
+        "zod": "^3.23.8"
+    },
+    "devDependencies": {
+        "@types/node": "^20.14.12",
+        "tsx": "^4.16.2",
+        "vitest": "^2.0.5"
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}

package/dist/src/capabilities/agent-core/capability.config.d.ts

@@ -0,0 +1,2 @@
+import type { AgentCapabilityDefinition } from '../../types/capability.js';
+export declare const agentCoreCapability: AgentCapabilityDefinition;

package/dist/src/capabilities/agent-core/capability.config.js

@@ -0,0 +1,6 @@
+import { loadAgentCoreFiles } from './fileLoader.js';
+export const agentCoreCapability = {
+    name: 'agent-core',
+    description: 'A complete runnable Agent runtime with tools, trace, validation, and tests.',
+    files: loadAgentCoreFiles,
+};

package/dist/src/capabilities/agent-core/fileLoader.d.ts

@@ -0,0 +1,3 @@
+import type { CreateOptions } from '../../types/cli.js';
+import type { AgentCapabilityFile } from '../../types/capability.js';
+export declare function loadAgentCoreFiles(projectName: string, options?: CreateOptions): Promise<AgentCapabilityFile[]>;

package/dist/src/capabilities/agent-core/fileLoader.js

@@ -0,0 +1,40 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { normalizePath } from '../../utils/path.js';
+import { AGENT_CORE_CAPABILITY_VERSION, CLI_VERSION, CURRENT_CONFIG_VERSION } from '../../version.js';
+const capabilityDir = path.join(path.dirname(fileURLToPath(import.meta.url)), 'files');
+export async function loadAgentCoreFiles(projectName, options = {}) {
+    const mode = options.mode === 'package' ? 'package' : 'service';
+    const baseFiles = await readCapabilityFiles(path.join(capabilityDir, 'base'));
+    const serviceFiles = mode === 'service' ? await readCapabilityFiles(path.join(capabilityDir, 'service')) : [];
+    const files = mergeFiles([...baseFiles, ...serviceFiles]);
+    return files.map((file) => ({
+        path: file.path,
+        content: file.content
+            .replaceAll('{{projectName}}', projectName)
+            .replaceAll('{{cliVersion}}', CLI_VERSION)
+            .replaceAll('{{configVersion}}', CURRENT_CONFIG_VERSION)
+            .replaceAll('{{capabilityVersion}}', AGENT_CORE_CAPABILITY_VERSION)
+            .replaceAll('{{coreVersion}}', AGENT_CORE_CAPABILITY_VERSION)
+            .replaceAll('{{serviceEnabled}}', mode === 'service' ? 'true' : 'false')
+            .replaceAll('{{serviceFramework}}', mode === 'service' ? "'next'" : 'undefined'),
+    }));
+}
+function mergeFiles(files) {
+    const byPath = new Map();
+    for (const file of files)
+        byPath.set(file.path, file);
+    return [...byPath.values()];
+}
+async function readCapabilityFiles(directory, baseDir = directory) {
+    const entries = await fs.readdir(directory, { withFileTypes: true });
+    const files = await Promise.all(entries.map(async (entry) => {
+        const entryPath = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            return readCapabilityFiles(entryPath, baseDir);
+        const relativePath = normalizePath(path.relative(baseDir, entryPath));
+        return [{ path: relativePath, content: await fs.readFile(entryPath, 'utf8') }];
+    }));
+    return files.flat();
+}

package/dist/src/capabilities/agent-core/files/base/.env.example

@@ -0,0 +1,4 @@
+LLM_BASE_URL=https://api.openai.com/v1
+OPENAI_API_KEY=
+# Optional. Defaults to gpt-4o-mini in agent.config.ts.
+LLM_MODEL=gpt-4o-mini

package/dist/src/capabilities/agent-core/files/base/README.md

@@ -0,0 +1,69 @@
+# {{projectName}}
+
+Generated by Agent Creator v{{cliVersion}}.
+
+Capability: `agent-core` v{{capabilityVersion}}  
+Core: `@agent-creator/core` v{{coreVersion}}  
+Config schema: `{{configVersion}}`
+
+This is an independent runnable Agent project powered by `@agent-creator/core`.
+
+## Configure The Agent
+
+Open `agent.config.ts` and set the minimum model configuration:
+
+```ts
+model: {
+  baseUrl: 'https://api.openai.com/v1',
+  apiKey: 'your-key',
+  model: 'gpt-4o-mini', // optional; defaults to gpt-4o-mini
+}
+```
+
+You can also keep the generated environment-variable reads and set:
+
+```bash
+export LLM_BASE_URL=https://api.openai.com/v1
+export OPENAI_API_KEY=your-key
+# Optional override. Defaults to gpt-4o-mini.
+export LLM_MODEL=gpt-4o-mini
+```
+
+## Run
+
+Package mode starts a command-line chat:
+
+```bash
+npm install
+npm run dev
+```
+
+After build:
+
+```bash
+npm run build
+npm start
+```
+
+Service mode starts a Next.js web chat:
+
+```bash
+npm install
+npm run dev
+```
+
+Then open the printed local URL and chat in the browser. Service mode also keeps a CLI debug entry:
+
+```bash
+npm run dev:agent
+```
+
+## Customize Capabilities
+
+Add skills and compose the Agent in `src/index.ts`:
+
+```bash
+agent add skill calendar
+```
+
+`src/index.ts` creates the Builder, registers every Skill from `src/skills/index.ts`, and calls `build()`.

package/dist/src/capabilities/agent-core/files/base/agent.config.ts

@@ -0,0 +1,31 @@
+const config = {
+  name: '{{projectName}}',
+  capability: 'agent-core',
+  version: '{{capabilityVersion}}',
+  configVersion: '{{configVersion}}',
+  capabilityVersion: '{{capabilityVersion}}',
+  generatedBy: {
+    name: 'agent-creator',
+    version: '{{cliVersion}}',
+  },
+  service: {
+    enabled: {{serviceEnabled}},
+    framework: {{serviceFramework}},
+  },
+  model: {
+    // Minimum required configuration: baseUrl and apiKey.
+    // You can hardcode local values here, or keep reading from environment variables.
+    baseUrl: process.env.LLM_BASE_URL ?? '',
+    apiKey: process.env.OPENAI_API_KEY ?? '',
+    model: process.env.LLM_MODEL ?? 'gpt-4o-mini',
+    timeoutMs: 30000,
+    maxRetries: 1,
+  },
+  skills: {
+    enabled: [
+      // agent-creator:skills
+    ],
+  },
+};
+
+export default config;

package/dist/src/capabilities/agent-core/files/base/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "{{projectName}}",
+  "version": "{{capabilityVersion}}",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "bin": {
+    "{{projectName}}": "./dist/src/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc",
+    "start": "node dist/src/cli.js",
+    "test": "vitest run",
+    "validate": "agent validate"
+  },
+  "dependencies": {
+    "@agent-creator/core": "^{{coreVersion}}",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.12",
+    "tsx": "^4.16.2",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  }
+}

package/dist/src/capabilities/agent-core/files/base/src/cli.ts

@@ -0,0 +1,46 @@
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import type { AgentProgressEvent } from '@agent-creator/core';
+import { loadDotEnv } from './env.js';
+
+export async function runCli(): Promise<void> {
+  loadDotEnv();
+  const { default: config } = await import('../agent.config.js');
+  const { runAgent } = await import('./index.js');
+  const rl = readline.createInterface({ input, output });
+  const sessionId = `session_${Date.now()}`;
+
+  console.log(`${config.name} CLI started.`);
+  if (!config.model.baseUrl || !config.model.apiKey) {
+    console.error('Set model.baseUrl and model.apiKey in agent.config.ts before running the Agent.');
+    process.exitCode = 1;
+    rl.close();
+    return;
+  }
+  console.log('Type "exit" or "quit" to quit.\n');
+
+  while (true) {
+    const text = await rl.question('User: ');
+    if (['exit', 'quit'].includes(text.trim().toLowerCase())) break;
+    const result = await runAgent({
+      input: text,
+      sessionId,
+      metadata: {
+        onProgress(event: AgentProgressEvent) {
+          console.log(formatProgress(event));
+        },
+      },
+    });
+    console.log('Agent:');
+    console.log(JSON.stringify(result, null, 2));
+  }
+
+  rl.close();
+}
+
+await runCli();
+
+function formatProgress(event: AgentProgressEvent): string {
+  const prefix = event.type.endsWith('.completed') ? '✓' : event.type.endsWith('.failed') ? '✗' : '…';
+  return `${prefix} ${event.message}`;
+}

package/dist/src/capabilities/agent-core/files/base/src/dev.ts

@@ -0,0 +1 @@
+import './cli.js';

package/dist/src/capabilities/agent-core/files/base/src/env.ts

@@ -0,0 +1,23 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+export function loadDotEnv(filePath = path.resolve(process.cwd(), '.env')): void {
+  if (!fs.existsSync(filePath)) return;
+  const source = fs.readFileSync(filePath, 'utf8');
+  for (const line of source.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const separator = trimmed.indexOf('=');
+    if (separator <= 0) continue;
+    const key = trimmed.slice(0, separator).trim();
+    const value = unquote(trimmed.slice(separator + 1).trim());
+    process.env[key] ??= value;
+  }
+}
+
+function unquote(value: string): string {
+  if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+    return value.slice(1, -1);
+  }
+  return value;
+}

package/dist/src/capabilities/agent-core/files/base/src/index.ts

@@ -0,0 +1,31 @@
+import { createAgent, type Agent } from '@agent-creator/core';
+import config from '../agent.config.js';
+import { skills } from './skills/index.js';
+
+let configuredAgent: Agent | undefined;
+
+export function getAgent(): Agent {
+  if (configuredAgent) return configuredAgent;
+  const builder = createAgent({ model: config.model });
+  for (const skill of skills) builder.useSkill(skill);
+  configuredAgent = builder.build();
+  return configuredAgent;
+}
+
+export function runAgent(input: Parameters<Agent['run']>[0]) {
+  return getAgent().run(input);
+}
+
+export { createAgent } from '@agent-creator/core';
+export type {
+  Agent,
+  AgentInput,
+  AgentOutput,
+  Executor,
+  Guard,
+  MemoryProvider,
+  ModelProvider,
+  Planner,
+  Skill,
+  TraceProvider,
+} from '@agent-creator/core';

package/dist/src/capabilities/agent-core/files/base/src/skills/index.ts

@@ -0,0 +1,9 @@
+import type { Skill } from '@agent-creator/core';
+
+export const skills: Skill[] = [
+  // agent-creator:skill-imports
+];
+
+export const enabledSkillNames = [
+  // agent-creator:skill-exports
+];

package/dist/src/capabilities/agent-core/files/base/tests/agent.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest';
+import { createAgent } from '@agent-creator/core';
+
+describe('generated agent', () => {
+  it('runs with a custom model provider', async () => {
+    const agent = createAgent({
+      model: {
+        baseUrl: 'https://example.test/v1/',
+        apiKey: 'test-key',
+        model: 'test-model',
+      },
+    })
+      .useModel({
+        async generate() {
+          return { text: 'hello from generated agent' };
+        },
+      })
+      .build();
+
+    await expect(agent.run({ input: 'hello' })).resolves.toMatchObject({
+      success: true,
+      message: 'hello from generated agent',
+    });
+  });
+});

package/dist/src/capabilities/agent-core/files/base/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022"],
+    "strict": true,
+    "declaration": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "."
+  },
+  "include": ["agent.config.ts", "src/**/*.ts", "tests/**/*.ts"],
+  "exclude": ["dist", "node_modules"]
+}

package/dist/src/capabilities/agent-core/files/service/next.config.ts

@@ -0,0 +1,15 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  webpack(config) {
+    config.resolve ??= {};
+    config.resolve.extensionAlias = {
+      ...config.resolve.extensionAlias,
+      '.js': ['.ts', '.tsx', '.js'],
+      '.mjs': ['.mts', '.mjs'],
+    };
+    return config;
+  },
+};
+
+export default nextConfig;

package/dist/src/capabilities/agent-core/files/service/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "{{projectName}}",
+  "version": "{{capabilityVersion}}",
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "dev:agent": "tsx src/cli.ts",
+    "build": "next build",
+    "start": "next start",
+    "test": "vitest run",
+    "validate": "agent validate"
+  },
+  "dependencies": {
+    "@agent-creator/core": "^{{coreVersion}}",
+    "@ant-design/nextjs-registry": "^1.0.2",
+    "antd": "^5.21.6",
+    "next": "^15.0.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.12",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "tsx": "^4.16.2",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  }
+}

package/dist/src/capabilities/agent-core/files/service/src/app/api/agent/route.ts

@@ -0,0 +1,10 @@
+import { NextResponse } from 'next/server';
+import { runAgent } from '../../../index';
+
+export async function POST(request: Request) {
+  const body = await request.json().catch(() => ({})) as Record<string, unknown>;
+  const input = typeof body.input === 'string' ? body.input : '';
+  const sessionId = typeof body.sessionId === 'string' ? body.sessionId : undefined;
+  const output = await runAgent({ input, sessionId });
+  return NextResponse.json(output);
+}

package/dist/src/capabilities/agent-core/files/service/src/app/api/agent/stream/route.ts

@@ -0,0 +1,53 @@
+import type { AgentOutput, AgentProgressEvent } from '@agent-creator/core';
+import { runAgent } from '../../../../index';
+
+type StreamEvent =
+  | { type: 'progress'; event: AgentProgressEvent }
+  | { type: 'final'; output: AgentOutput };
+
+export async function POST(request: Request) {
+  const body = await request.json().catch(() => ({})) as Record<string, unknown>;
+  const input = typeof body.input === 'string' ? body.input : '';
+  const sessionId = typeof body.sessionId === 'string' ? body.sessionId : undefined;
+  const encoder = new TextEncoder();
+
+  const stream = new ReadableStream<Uint8Array>({
+    async start(controller) {
+      function send(event: StreamEvent) {
+        controller.enqueue(encoder.encode(`${JSON.stringify(event)}\n`));
+      }
+
+      try {
+        const output = await runAgent({
+          input,
+          sessionId,
+          metadata: {
+            onProgress(event: AgentProgressEvent) {
+              send({ type: 'progress', event });
+            },
+          },
+        });
+        send({ type: 'final', output });
+      } catch (error) {
+        send({
+          type: 'final',
+          output: {
+            success: false,
+            intent: 'stream_error',
+            message: 'Agent stream failed.',
+            errors: [error instanceof Error ? error.message : String(error)],
+          },
+        });
+      } finally {
+        controller.close();
+      }
+    },
+  });
+
+  return new Response(stream, {
+    headers: {
+      'content-type': 'application/x-ndjson; charset=utf-8',
+      'cache-control': 'no-cache',
+    },
+  });
+}

package/dist/src/capabilities/agent-core/files/service/src/app/globals.css

@@ -0,0 +1,34 @@
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  background: #f5f7fb;
+  color: #172033;
+  font-family: Arial, Helvetica, sans-serif;
+}
+
+a {
+  color: inherit;
+}
+
+.appShell {
+  min-height: 100vh;
+  padding: 24px;
+}
+
+.content {
+  max-width: 1120px;
+  margin: 0 auto;
+}
+
+.jsonBlock {
+  max-height: 520px;
+  overflow: auto;
+  padding: 12px;
+  border-radius: 6px;
+  background: #0f172a;
+  color: #dbeafe;
+  font-size: 12px;
+}

package/dist/src/capabilities/agent-core/files/service/src/app/layout.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from 'next';
+import type { ReactNode } from 'react';
+import { AntdRegistry } from '@ant-design/nextjs-registry';
+import './globals.css';
+
+export const metadata: Metadata = {
+  title: '{{projectName}} Agent',
+  description: 'Agent Creator service example shell',
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <AntdRegistry>{children}</AntdRegistry>
+      </body>
+    </html>
+  );
+}

package/dist/src/capabilities/agent-core/files/service/src/app/page.tsx

@@ -0,0 +1,7 @@
+'use client';
+
+import { AgentChat } from '../components/AgentChat';
+
+export default function HomePage() {
+  return <AgentChat />;
+}