@agentskit/cli 0.4.2 → 0.5.1

package/dist/index.d.cts

@@ -1,9 +1,57 @@
 import { Command } from 'commander';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { AgentsKitConfig, AdapterFactory } from '@agentskit/core';
+import { AdapterFactory } from '@agentskit/core';
+import { ChildProcess } from 'node:child_process';
 
 declare function createCli(): Command;
 
+interface AgentsKitConfig {
+    tools?: {
+        filesystem?: {
+            basePath?: string;
+        };
+        shell?: {
+            allowed?: string[];
+            timeout?: number;
+            maxOutput?: number;
+        };
+        webSearch?: {
+            provider?: string;
+            maxResults?: number;
+        };
+    };
+    defaults?: {
+        provider?: string;
+        model?: string;
+    };
+    runtime?: {
+        maxSteps?: number;
+        maxDelegationDepth?: number;
+    };
+    observability?: {
+        console?: boolean | {
+            format?: 'human' | 'json';
+        };
+        langsmith?: {
+            projectName?: string;
+        };
+    };
+}
+interface LoadConfigOptions {
+    cwd?: string;
+}
+/**
+ * Load an AgentsKit config file. Node-only — uses fs/promises.
+ *
+ * Tries in order:
+ *   1. `.agentskit.config.ts` (imported as a module)
+ *   2. `.agentskit.config.json`
+ *   3. `"agentskit"` field in `package.json`
+ *
+ * Returns `undefined` if none found.
+ */
+declare function loadConfig(options?: LoadConfigOptions): Promise<AgentsKitConfig | undefined>;
+
 interface ChatCommandOptions {
     provider: string;
     model?: string;
@@ -19,10 +67,18 @@ interface ChatCommandOptions {
 declare function ChatApp(options: ChatCommandOptions): react_jsx_runtime.JSX.Element;
 declare function renderChatHeader(options: ChatCommandOptions): string;
 
-type StarterKind = 'react' | 'ink';
+type StarterKind = 'react' | 'ink' | 'runtime' | 'multi-agent';
+type Provider = 'openai' | 'anthropic' | 'gemini' | 'ollama' | 'demo';
+type ToolKind = 'web_search' | 'filesystem' | 'shell';
+type MemoryKind = 'none' | 'file' | 'sqlite';
+type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
 interface InitCommandOptions {
     targetDir: string;
     template: StarterKind;
+    provider?: Provider;
+    tools?: ToolKind[];
+    memory?: MemoryKind;
+    packageManager?: PackageManager;
 }
 declare function writeStarterProject(options: InitCommandOptions): Promise<void>;
 
@@ -59,4 +115,120 @@ interface RunCommandOptions {
 }
 declare function runAgent(task: string, options: RunCommandOptions): Promise<void>;
 
-export { ChatApp, type ChatCommandOptions, type ChatProviderOptions, type InitCommandOptions, type ResolvedChatProvider, type RunCommandOptions, type StarterKind, createCli, renderChatHeader, resolveChatProvider, runAgent, writeStarterProject };
+type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
+interface CheckResult {
+    status: CheckStatus;
+    name: string;
+    detail?: string;
+    fix?: string;
+}
+interface DoctorReport {
+    results: CheckResult[];
+    pass: number;
+    warn: number;
+    fail: number;
+    skip: number;
+}
+interface DoctorOptions {
+    /** Provider names to check. Defaults to all known providers. */
+    providers?: string[];
+    /** Skip the network reachability checks. */
+    noNetwork?: boolean;
+    /** Custom fetch (for tests). */
+    fetchImpl?: typeof fetch;
+}
+declare function runDoctor(options?: DoctorOptions): Promise<DoctorReport>;
+declare function renderReport(report: DoctorReport, opts?: {
+    color?: boolean;
+}): string;
+
+interface DevOptions {
+    /** Entry file to run (relative or absolute). */
+    entry: string;
+    /** Globs to watch for changes. Defaults to common project files. */
+    watch?: string[];
+    /** Globs to ignore. */
+    ignore?: string[];
+    /** Args to pass through to the entry script. */
+    scriptArgs?: string[];
+    /** Debounce ms before restart after a change. */
+    debounceMs?: number;
+    /**
+     * Spawner override for tests. Defaults to spawning `tsx` (or `node` for
+     * .js entries) as a child process.
+     */
+    spawn?: (cmd: string, args: string[]) => ChildProcess;
+    /** Watch override for tests. Defaults to chokidar. */
+    watcher?: (paths: string[], opts: {
+        ignored?: string[];
+    }) => DevWatcher;
+    /** Stdout sink for tests. */
+    stdout?: NodeJS.WritableStream;
+    /** Stderr sink for tests. */
+    stderr?: NodeJS.WritableStream;
+}
+interface DevWatcher {
+    on(event: 'change' | 'add' | 'unlink', listener: (path: string) => void): this;
+    close(): Promise<void>;
+}
+/**
+ * Run an entry file via tsx, restart it on relevant file changes.
+ * Resolves when stop() is called or the watcher closes.
+ *
+ * Returns a controller so callers (and tests) can stop the loop and
+ * inspect activity counters.
+ */
+interface DevController {
+    /** Promise that resolves when the dev session ends. */
+    done: Promise<void>;
+    /** Stop the dev loop and clean up. */
+    stop: () => Promise<void>;
+    /** Number of times the entry has been (re)started. */
+    restarts: () => number;
+}
+declare function startDev(options: DevOptions): DevController;
+
+interface TunnelOptions {
+    /** Local port to expose. Required. */
+    port: number;
+    /** Optional subdomain hint (best-effort — provider may decline). */
+    subdomain?: string;
+    /** Local hostname (default: 'localhost'). */
+    host?: string;
+    /** Tunnel factory override for tests. Defaults to `localtunnel`. */
+    open?: (opts: {
+        port: number;
+        subdomain?: string;
+        local_host?: string;
+    }) => Promise<TunnelLike>;
+    /** Stdout/stderr sinks for tests. */
+    stdout?: NodeJS.WritableStream;
+    /** Called once the tunnel URL is known. */
+    onReady?: (url: string) => void;
+}
+interface TunnelLike {
+    url: string;
+    on(event: 'request' | 'error' | 'close', listener: (...args: unknown[]) => void): unknown;
+    close(): void;
+}
+interface TunnelController {
+    /** The public URL once ready. */
+    url: string;
+    /** Resolves when the tunnel closes (or stop() is called). */
+    done: Promise<void>;
+    /** Stop the tunnel and resolve done. */
+    stop: () => Promise<void>;
+    /** Number of requests proxied so far. */
+    requests: () => number;
+}
+/**
+ * Open a public tunnel to a local port.
+ *
+ * Uses `localtunnel` by default — no account required, free, URL is
+ * something like `https://word-word-12345.loca.lt`. First-time visitors
+ * may see a `loca.lt` interstitial click-through; that's a known
+ * provider quirk, not an AgentsKit issue.
+ */
+declare function startTunnel(options: TunnelOptions): Promise<TunnelController>;
+
+export { type AgentsKitConfig, ChatApp, type ChatCommandOptions, type ChatProviderOptions, type CheckResult, type CheckStatus, type DevController, type DevOptions, type DevWatcher, type DoctorOptions, type DoctorReport, type InitCommandOptions, type LoadConfigOptions, type ResolvedChatProvider, type RunCommandOptions, type StarterKind, type TunnelController, type TunnelLike, type TunnelOptions, createCli, loadConfig, renderChatHeader, renderReport, resolveChatProvider, runAgent, runDoctor, startDev, startTunnel, writeStarterProject };

package/dist/index.d.ts

@@ -1,9 +1,57 @@
 import { Command } from 'commander';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { AgentsKitConfig, AdapterFactory } from '@agentskit/core';
+import { AdapterFactory } from '@agentskit/core';
+import { ChildProcess } from 'node:child_process';
 
 declare function createCli(): Command;
 
+interface AgentsKitConfig {
+    tools?: {
+        filesystem?: {
+            basePath?: string;
+        };
+        shell?: {
+            allowed?: string[];
+            timeout?: number;
+            maxOutput?: number;
+        };
+        webSearch?: {
+            provider?: string;
+            maxResults?: number;
+        };
+    };
+    defaults?: {
+        provider?: string;
+        model?: string;
+    };
+    runtime?: {
+        maxSteps?: number;
+        maxDelegationDepth?: number;
+    };
+    observability?: {
+        console?: boolean | {
+            format?: 'human' | 'json';
+        };
+        langsmith?: {
+            projectName?: string;
+        };
+    };
+}
+interface LoadConfigOptions {
+    cwd?: string;
+}
+/**
+ * Load an AgentsKit config file. Node-only — uses fs/promises.
+ *
+ * Tries in order:
+ *   1. `.agentskit.config.ts` (imported as a module)
+ *   2. `.agentskit.config.json`
+ *   3. `"agentskit"` field in `package.json`
+ *
+ * Returns `undefined` if none found.
+ */
+declare function loadConfig(options?: LoadConfigOptions): Promise<AgentsKitConfig | undefined>;
+
 interface ChatCommandOptions {
     provider: string;
     model?: string;
@@ -19,10 +67,18 @@ interface ChatCommandOptions {
 declare function ChatApp(options: ChatCommandOptions): react_jsx_runtime.JSX.Element;
 declare function renderChatHeader(options: ChatCommandOptions): string;
 
-type StarterKind = 'react' | 'ink';
+type StarterKind = 'react' | 'ink' | 'runtime' | 'multi-agent';
+type Provider = 'openai' | 'anthropic' | 'gemini' | 'ollama' | 'demo';
+type ToolKind = 'web_search' | 'filesystem' | 'shell';
+type MemoryKind = 'none' | 'file' | 'sqlite';
+type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
 interface InitCommandOptions {
     targetDir: string;
     template: StarterKind;
+    provider?: Provider;
+    tools?: ToolKind[];
+    memory?: MemoryKind;
+    packageManager?: PackageManager;
 }
 declare function writeStarterProject(options: InitCommandOptions): Promise<void>;
 
@@ -59,4 +115,120 @@ interface RunCommandOptions {
 }
 declare function runAgent(task: string, options: RunCommandOptions): Promise<void>;
 
-export { ChatApp, type ChatCommandOptions, type ChatProviderOptions, type InitCommandOptions, type ResolvedChatProvider, type RunCommandOptions, type StarterKind, createCli, renderChatHeader, resolveChatProvider, runAgent, writeStarterProject };
+type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
+interface CheckResult {
+    status: CheckStatus;
+    name: string;
+    detail?: string;
+    fix?: string;
+}
+interface DoctorReport {
+    results: CheckResult[];
+    pass: number;
+    warn: number;
+    fail: number;
+    skip: number;
+}
+interface DoctorOptions {
+    /** Provider names to check. Defaults to all known providers. */
+    providers?: string[];
+    /** Skip the network reachability checks. */
+    noNetwork?: boolean;
+    /** Custom fetch (for tests). */
+    fetchImpl?: typeof fetch;
+}
+declare function runDoctor(options?: DoctorOptions): Promise<DoctorReport>;
+declare function renderReport(report: DoctorReport, opts?: {
+    color?: boolean;
+}): string;
+
+interface DevOptions {
+    /** Entry file to run (relative or absolute). */
+    entry: string;
+    /** Globs to watch for changes. Defaults to common project files. */
+    watch?: string[];
+    /** Globs to ignore. */
+    ignore?: string[];
+    /** Args to pass through to the entry script. */
+    scriptArgs?: string[];
+    /** Debounce ms before restart after a change. */
+    debounceMs?: number;
+    /**
+     * Spawner override for tests. Defaults to spawning `tsx` (or `node` for
+     * .js entries) as a child process.
+     */
+    spawn?: (cmd: string, args: string[]) => ChildProcess;
+    /** Watch override for tests. Defaults to chokidar. */
+    watcher?: (paths: string[], opts: {
+        ignored?: string[];
+    }) => DevWatcher;
+    /** Stdout sink for tests. */
+    stdout?: NodeJS.WritableStream;
+    /** Stderr sink for tests. */
+    stderr?: NodeJS.WritableStream;
+}
+interface DevWatcher {
+    on(event: 'change' | 'add' | 'unlink', listener: (path: string) => void): this;
+    close(): Promise<void>;
+}
+/**
+ * Run an entry file via tsx, restart it on relevant file changes.
+ * Resolves when stop() is called or the watcher closes.
+ *
+ * Returns a controller so callers (and tests) can stop the loop and
+ * inspect activity counters.
+ */
+interface DevController {
+    /** Promise that resolves when the dev session ends. */
+    done: Promise<void>;
+    /** Stop the dev loop and clean up. */
+    stop: () => Promise<void>;
+    /** Number of times the entry has been (re)started. */
+    restarts: () => number;
+}
+declare function startDev(options: DevOptions): DevController;
+
+interface TunnelOptions {
+    /** Local port to expose. Required. */
+    port: number;
+    /** Optional subdomain hint (best-effort — provider may decline). */
+    subdomain?: string;
+    /** Local hostname (default: 'localhost'). */
+    host?: string;
+    /** Tunnel factory override for tests. Defaults to `localtunnel`. */
+    open?: (opts: {
+        port: number;
+        subdomain?: string;
+        local_host?: string;
+    }) => Promise<TunnelLike>;
+    /** Stdout/stderr sinks for tests. */
+    stdout?: NodeJS.WritableStream;
+    /** Called once the tunnel URL is known. */
+    onReady?: (url: string) => void;
+}
+interface TunnelLike {
+    url: string;
+    on(event: 'request' | 'error' | 'close', listener: (...args: unknown[]) => void): unknown;
+    close(): void;
+}
+interface TunnelController {
+    /** The public URL once ready. */
+    url: string;
+    /** Resolves when the tunnel closes (or stop() is called). */
+    done: Promise<void>;
+    /** Stop the tunnel and resolve done. */
+    stop: () => Promise<void>;
+    /** Number of requests proxied so far. */
+    requests: () => number;
+}
+/**
+ * Open a public tunnel to a local port.
+ *
+ * Uses `localtunnel` by default — no account required, free, URL is
+ * something like `https://word-word-12345.loca.lt`. First-time visitors
+ * may see a `loca.lt` interstitial click-through; that's a known
+ * provider quirk, not an AgentsKit issue.
+ */
+declare function startTunnel(options: TunnelOptions): Promise<TunnelController>;
+
+export { type AgentsKitConfig, ChatApp, type ChatCommandOptions, type ChatProviderOptions, type CheckResult, type CheckStatus, type DevController, type DevOptions, type DevWatcher, type DoctorOptions, type DoctorReport, type InitCommandOptions, type LoadConfigOptions, type ResolvedChatProvider, type RunCommandOptions, type StarterKind, type TunnelController, type TunnelLike, type TunnelOptions, createCli, loadConfig, renderChatHeader, renderReport, resolveChatProvider, runAgent, runDoctor, startDev, startTunnel, writeStarterProject };

package/dist/index.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-export { ChatApp, createCli, renderChatHeader, resolveChatProvider, runAgent, writeStarterProject } from './chunk-RHXN45FL.js';
+export { ChatApp, createCli, loadConfig, renderChatHeader, renderReport, resolveChatProvider, runAgent, runDoctor, startDev, startTunnel, writeStarterProject } from './chunk-IMW4N7X2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/cli",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "CLI for AgentsKit chat and project scaffolding.",
   "keywords": [
     "agentskit",
@@ -11,7 +11,16 @@
     "typescript",
     "cli",
     "command-line",
-    "scaffolding"
+    "scaffolding",
+    "openai",
+    "anthropic",
+    "claude",
+    "gemini",
+    "chatgpt",
+    "ai-agents",
+    "autonomous-agents",
+    "create-app",
+    "terminal"
   ],
   "type": "module",
   "main": "./dist/index.cjs",
@@ -31,30 +40,40 @@
     "dist"
   ],
   "dependencies": {
+    "@inquirer/prompts": "^8.4.1",
+    "chokidar": "^5.0.0",
     "commander": "^14.0.1",
-    "ink": "^6.8.0",
-    "react": "^19.2.4",
-    "@agentskit/core": "0.4.2",
-    "@agentskit/ink": "0.4.2",
-    "@agentskit/tools": "0.4.2",
-    "@agentskit/memory": "0.4.2",
-    "@agentskit/adapters": "0.4.2",
-    "@agentskit/skills": "0.4.2",
-    "@agentskit/runtime": "0.4.2"
+    "ink": "^7.0.0",
+    "kleur": "^4.1.5",
+    "localtunnel": "^2.0.2",
+    "react": "^19.2.5",
+    "@agentskit/adapters": "0.5.1",
+    "@agentskit/core": "1.0.1",
+    "@agentskit/ink": "0.5.1",
+    "@agentskit/memory": "0.5.1",
+    "@agentskit/runtime": "0.4.4",
+    "@agentskit/skills": "0.4.4",
+    "@agentskit/tools": "0.4.4"
   },
   "devDependencies": {
-    "@types/node": "^25.5.2",
+    "@types/localtunnel": "^2.0.4",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "tsup": "^8.5.0",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.4"
   },
   "publishConfig": {
     "access": "public"
   },
+  "agentskit": {
+    "stability": "stable",
+    "stabilityNote": "chat, init, run commands stable."
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "lint": "tsc --noEmit",
     "dev": "tsup --watch"
   }