@agent-api/cli 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,11 @@
 # Agent API CLI
 
-First-class command line interface for Agent API. The CLI is built on `@agent-api/sdk@^1.2.2` with Commander for command routing and Ink for interactive terminal UI.
+First-class command line interface for Agent API. The CLI shell is built on `@agent-api/app-engine`, which wraps `@agent-api/sdk@^1.3.0` behind a renderer-neutral application core. Commander handles command routing, and Ink renders the current terminal UI.
+
+This repository publishes two packages:
+
+- `@agent-api/app-engine`: reusable application core for agent apps.
+- `@agent-api/cli`: command-line shell and Ink TUI renderer.
 
 ## Development
 
@@ -40,10 +45,11 @@ If your npm account requires two-factor auth for publish:
 npm run release:local -- --otp 123456
 ```
 
-The local release script runs `npm ci`, builds and tests the package, creates an
-npm tarball in `artifacts/`, installs that tarball into a temporary npm prefix,
-smoke-tests the published bin aliases, and then publishes the verified tarball
-with `npm publish --access public`.
+The local release script runs `npm ci`, builds and tests both packages, creates
+npm tarballs in `artifacts/`, installs the app-engine and CLI tarballs into a
+temporary npm prefix, smoke-tests the published bin aliases, and then publishes
+`@agent-api/app-engine` before `@agent-api/cli` with
+`npm publish --access public`.
 
 For a no-publish rehearsal:
 

package/dist/index.js

@@ -4,13 +4,15 @@ import { stat } from "node:fs/promises";
 import { resolve } from "node:path";
 import { render } from "ink";
 import React from "react";
-import { conversationSummary, deleteConversation, getConversation, listConversations, runAgent } from "./agent.js";
-import { normalizeChatOptions } from "./chat-options.js";
+import { activeProfile, configureAgentAppRuntime, conversationSummary, deleteConversation, deleteProfile, getConversation, listConversations, listProfiles, loadConfig, loadConversationConfiguration, loginWithAPIKey, loginWithBrowser, normalizeChatOptions, openWorkdir, profileSummary, redactSecret, resolveRuntimeProfile, runAgent, runtime, useProfile, } from "@agent-api/app-engine";
 import { ChatApp } from "./tui/chat.js";
-import { activeProfile, loadConfig, loadConversationConfiguration, redactSecret } from "./config.js";
-import { cliVersion, runtime } from "./runtime/index.js";
-import { openWorkdir } from "./workdir/index.js";
-import { deleteProfile, listProfiles, loginWithAPIKey, loginWithBrowser, profileSummary, resolveRuntimeProfile, useProfile, } from "./profile.js";
+import { cliAuthor, cliName, cliVersion, legacyCliName } from "./runtime.js";
+configureAgentAppRuntime({
+    appName: cliName,
+    appAuthor: cliAuthor,
+    appVersion: cliVersion,
+    legacyAppName: legacyCliName,
+});
 const program = new Command();
 program
     .name("agent-api")

package/dist/runtime.d.ts

@@ -0,0 +1,4 @@
+export declare const cliName = "agent-tui";
+export declare const cliAuthor = "AgentsWay";
+export declare const cliVersion = "0.3.0";
+export declare const legacyCliName = "agent-api-cli";

package/dist/runtime.js

@@ -0,0 +1,4 @@
+export const cliName = "agent-tui";
+export const cliAuthor = "AgentsWay";
+export const cliVersion = "0.3.0";
+export const legacyCliName = "agent-api-cli";

package/dist/tui/ink/app.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { type AgentRunOptions } from "../../agent.js";
+import { type AgentRunOptions } from "@agent-api/app-engine";
 export declare function ChatApp({ options }: {
     options: AgentRunOptions;
 }): React.JSX.Element;

package/dist/tui/ink/app.js

@@ -1,12 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { useApp, useInput, useStdout } from "ink";
-import { defaultBaseURL } from "../../config.js";
-import { createWorkbenchAuthController } from "../../workbench/auth-controller.js";
-import { createWorkbenchAuthGateController, } from "../../workbench/auth-gate-controller.js";
-import { createWorkbenchCommandController } from "../../workbench/command-controller.js";
-import { buildWorkbenchRenderModel, } from "../../workbench/render-model.js";
-import { createWorkbenchSession } from "../../workbench/session.js";
+import { buildWorkbenchRenderModel, createAgentEngine, createWorkbenchAuthController, createWorkbenchAuthGateController, defaultBaseURL, } from "@agent-api/app-engine";
 import { InkAuthGate, InkWorkbenchScreen } from "./components.js";
 export function ChatApp({ options }) {
     return _jsx(AuthenticatedChatApp, { options: options });
@@ -113,38 +108,24 @@ function WorkbenchApp({ authController, onLogin, onLogout, onDeleteProfile, onSw
     const [draft, setDraft] = useState("");
     const [spinnerFrame, setSpinnerFrame] = useState(0);
     const [transcriptOffset, setTranscriptOffset] = useState(0);
-    const sessionRef = useRef(null);
-    if (!sessionRef.current) {
-        sessionRef.current = createWorkbenchSession({
+    const agentEngineRef = useRef(null);
+    if (!agentEngineRef.current) {
+        agentEngineRef.current = createAgentEngine({
             authController,
             baseOptions: options,
+            profileName,
+            onDeleteProfile,
+            onExit: app.exit,
+            onLogin,
+            onLogout,
+            onSwitchProfile,
         });
     }
-    const session = sessionRef.current;
-    const engine = session.engine;
-    const conversationController = session.conversation;
+    const agentEngine = agentEngineRef.current;
+    const session = agentEngine.session;
     const inputController = session.input;
-    const lifecycleController = session.lifecycle;
-    const localController = session.local;
-    const settingsController = session.settings;
-    const turnController = session.turn;
-    const state = useSyncExternalStore(engine.subscribe, engine.snapshot, engine.snapshot);
-    const dispatch = engine.dispatch;
-    const commandController = createWorkbenchCommandController({
-        authController,
-        conversationController,
-        engine,
-        localController,
-        options,
-        profileName,
-        settingsController,
-        turnController,
-        onDeleteProfile,
-        onExit: app.exit,
-        onLogin,
-        onLogout,
-        onSwitchProfile,
-    });
+    const state = useSyncExternalStore(agentEngine.subscribe, agentEngine.snapshot, agentEngine.snapshot);
+    const dispatch = agentEngine.dispatch;
     const renderModel = useMemo(() => buildWorkbenchRenderModel({
         draft,
         profileName,
@@ -171,70 +152,27 @@ function WorkbenchApp({ authController, onLogin, onLogout, onDeleteProfile, onSw
     }
     useEffect(() => {
         let mounted = true;
-        lifecycleController.maybeCheckForUpdate()
-            .then((effects) => {
-            if (mounted)
-                runLifecycleEffects(effects, () => mounted);
-        });
-        settingsController.loadInitial({
-            modelExplicit: options.modelExplicit,
-            preset: options.preset,
-            presetExplicit: options.presetExplicit,
-        })
-            .then((settings) => {
-            if (!mounted)
-                return;
-            dispatch({ type: "settings.set", settings });
-            if (settings.activity) {
-                dispatch({ type: "activity.add", level: "success", text: settings.activity });
-            }
-            if (settings.warning) {
-                dispatch({ type: "activity.add", level: "warning", text: settings.warning });
-            }
-        })
-            .catch((error) => {
-            if (!mounted)
-                return;
-            dispatch({ type: "activity.add", level: "warning", text: `Config preferences unavailable: ${userFacingError(error)}` });
-        });
+        void agentEngine.maybeCheckForUpdate({ isMounted: () => mounted });
+        void agentEngine.loadInitialSettings({ isMounted: () => mounted });
         return () => {
             mounted = false;
         };
-    }, [dispatch, lifecycleController, options.modelExplicit, options.preset, options.presetExplicit, settingsController]);
+    }, [agentEngine]);
     useEffect(() => {
         if (!state.contextEnabled || state.workdir)
             return;
         let mounted = true;
-        dispatch({ type: "activity.add", text: "Loading workdir" });
-        localController.load(options.workdir || process.cwd())
-            .then((workdir) => {
-            if (!mounted)
-                return;
-            dispatch({
-                type: "workdir.set",
-                workdir,
-            });
-        })
-            .catch((error) => {
-            if (!mounted)
-                return;
-            dispatch({
-                type: "activity.add",
-                level: "error",
-                text: `Workdir unavailable: ${error instanceof Error ? error.message : String(error)}`,
-            });
-        });
+        void agentEngine.loadWorkdir(options.workdir || process.cwd(), { isMounted: () => mounted });
         return () => {
             mounted = false;
         };
-    }, [dispatch, localController, options.workdir, state.contextEnabled, state.workdir]);
+    }, [agentEngine, options.workdir, state.contextEnabled, state.workdir]);
     useEffect(() => {
         let mounted = true;
         const refreshIntervalMs = 60_000;
         const refreshAuth = async () => {
-            const effects = await lifecycleController.refreshAuth(options.profile);
             if (mounted)
-                runLifecycleEffects(effects, () => mounted);
+                await agentEngine.refreshAuth(options.profile, { isMounted: () => mounted });
         };
         void refreshAuth();
         const interval = setInterval(refreshAuth, refreshIntervalMs);
@@ -242,7 +180,7 @@ function WorkbenchApp({ authController, onLogin, onLogout, onDeleteProfile, onSw
             mounted = false;
             clearInterval(interval);
         };
-    }, [lifecycleController, options.profile]);
+    }, [agentEngine, options.profile]);
     useInput((input, key) => {
         const result = inputController.handle(input, key, {
             busy: state.busy,
@@ -266,10 +204,10 @@ function WorkbenchApp({ authController, onLogin, onLogout, onDeleteProfile, onSw
                     scrollTranscriptToBottom();
                     break;
                 case "abort":
-                    void turnController.abort("Abort requested.");
+                    void agentEngine.abortActiveTurn("Abort requested.");
                     break;
                 case "submit":
-                    void submit(effect.input);
+                    void agentEngine.submit(effect.input);
                     break;
                 case "ignored_busy":
                     dispatch({ type: "message.add", role: "system", text: "Agent turn is running. Use /abort or Esc to cancel it." });
@@ -279,15 +217,8 @@ function WorkbenchApp({ authController, onLogin, onLogout, onDeleteProfile, onSw
         }
     });
     useEffect(() => {
-        const initialPrompt = lifecycleController.initialPrompt({
-            busy: state.busy,
-            promptParts: options.promptParts,
-            requiresWorkdir: state.contextEnabled,
-            workdir: state.workdir,
-        });
-        if (initialPrompt)
-            void turnController.startPrompt(initialPrompt);
-    }, [lifecycleController, options.promptParts, state.busy, state.contextEnabled, state.workdir, turnController]);
+        void agentEngine.startInitialPrompt();
+    }, [agentEngine, state.busy, state.contextEnabled, state.workdir]);
     useEffect(() => {
         if (!state.busy) {
             setSpinnerFrame(0);
@@ -299,37 +230,7 @@ function WorkbenchApp({ authController, onLogin, onLogout, onDeleteProfile, onSw
         return () => clearInterval(interval);
     }, [state.busy]);
     useEffect(() => {
-        return () => session.runtime.dispose();
-    }, [session.runtime]);
-    function runLifecycleEffects(effects, isMounted) {
-        for (const effect of effects) {
-            switch (effect.type) {
-                case "dispatch":
-                    dispatch(effect.action);
-                    break;
-                case "close":
-                    setTimeout(() => {
-                        if (isMounted())
-                            app.exit();
-                    }, effect.delayMs);
-                    break;
-            }
-        }
-    }
-    async function submit(input) {
-        const submission = engine.submit(input);
-        if (submission.kind === "command") {
-            await commandController.run(submission.command);
-            return;
-        }
-        if (submission.kind === "prompt") {
-            await turnController.startPrompt(submission.prompt);
-        }
-    }
+        return () => agentEngine.dispose();
+    }, [agentEngine]);
     return _jsx(InkWorkbenchScreen, { renderModel: renderModel, spinnerFrame: spinnerFrame });
 }
-function userFacingError(error) {
-    if (error instanceof Error)
-        return error.message;
-    return String(error);
-}

package/dist/tui/ink/components.d.ts

@@ -1,6 +1,5 @@
 import React from "react";
-import { type AuthGateState } from "../../workbench/auth-gate-controller.js";
-import { type WorkbenchRenderModel } from "../../workbench/render-model.js";
+import { type AuthGateState, type WorkbenchRenderModel } from "@agent-api/app-engine";
 export declare function InkWorkbenchScreen({ renderModel, spinnerFrame, }: {
     renderModel: WorkbenchRenderModel;
     spinnerFrame: number;

package/dist/tui/ink/components.js

@@ -1,8 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from "ink";
-import { authMethods } from "../../workbench/auth-gate-controller.js";
-import { busySpinner } from "../../workbench/render-model.js";
-import { activityColor, } from "../workbench.js";
+import { activityColor, authMethods, busySpinner, } from "@agent-api/app-engine";
 export function InkWorkbenchScreen({ renderModel, spinnerFrame, }) {
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Header, { contextEnabled: renderModel.header.contextEnabled, conversation: renderModel.header.conversation, model: renderModel.header.model, accessMode: renderModel.header.accessMode, pendingLocalLabel: renderModel.header.pendingLocalLabel, preset: renderModel.header.preset, profile: renderModel.header.profile, renderMode: renderModel.header.renderMode, workdir: renderModel.header.workdir }), _jsxs(Box, { marginTop: 1, height: renderModel.viewportHeight, children: [_jsxs(Box, { flexDirection: "column", width: "72%", paddingRight: 1, children: [renderModel.transcript.visibleLines.map((line) => (_jsx(Text, { bold: line.bold, color: line.color, inverse: line.inverse, wrap: "truncate", children: line.text || " " }, line.id))), renderModel.transcript.visibleLines.length === 0 && _jsx(Text, { color: "gray", children: "No transcript lines." })] }), _jsxs(Box, { flexDirection: "column", width: "28%", height: renderModel.activityHeight, borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, wrap: "truncate", children: "Activity" }), renderModel.visibleActivities.map((activity) => (_jsxs(Text, { color: activityColor(activity.level), wrap: "truncate", children: [new Date(activity.timestamp).toLocaleTimeString(), " ", activity.text] }, activity.id)))] })] }), _jsxs(Box, { borderStyle: "single", borderColor: renderModel.input.busy ? "yellow" : "green", paddingX: 1, children: [renderModel.input.fullAccess && (_jsx(Text, { color: "red", bold: true, inverse: true, children: "FULL ACCESS" })), renderModel.input.fullAccess && _jsx(Text, { children: " " }), _jsxs(Text, { color: renderModel.input.busy ? "yellow" : "green", children: [renderModel.input.label, " "] }), renderModel.input.busy ? (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: "yellow", children: busySpinner(spinnerFrame) }), " ", renderModel.input.waitingText] })) : (_jsxs(Text, { wrap: "truncate", children: [renderModel.input.draft, _jsx(Cursor, { visible: true })] }))] }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { color: "gray", wrap: "truncate", children: renderModel.footerText }) })] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "First-class command line interface for Agent API",
   "license": "MIT",
   "homepage": "https://github.com/scalebox-dev/agent-tui#readme",
@@ -12,6 +12,9 @@
     "url": "https://github.com/scalebox-dev/agent-tui/issues"
   },
   "type": "module",
+  "workspaces": [
+    "packages/app-engine"
+  ],
   "bin": {
     "agent-api": "dist/index.js",
     "agentsway": "dist/index.js",
@@ -20,7 +23,8 @@
   "scripts": {
     "sync-version": "node scripts/sync-version.mjs",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "npm run clean && tsc -p tsconfig.json && node scripts/prepare-bin.mjs",
+    "build:app-engine": "npm run build -w @agent-api/app-engine",
+    "build": "npm run build:app-engine && npm run clean && tsc -p tsconfig.json && node scripts/prepare-bin.mjs",
     "dev": "npm run build && node dist/index.js",
     "dev:link": "node scripts/dev-link.mjs",
     "start": "node dist/index.js",
@@ -28,14 +32,13 @@
     "pack:local": "npm pack --pack-destination ./artifacts",
     "release:local": "node scripts/release-local.mjs",
     "prepack": "npm run sync-version && npm run build",
-    "test": "npm run sync-version && npm run build && node --test test/*.test.mjs"
+    "test": "npm run sync-version && npm run build && npm run smoke -w @agent-api/app-engine && node --test test/*.test.mjs"
   },
   "dependencies": {
-    "@agent-api/sdk": "^1.3.0",
+    "@agent-api/app-engine": "^0.0.1",
     "commander": "^14.0.3",
     "ink": "^6.8.0",
-    "react": "^19.2.7",
-    "zod": "^4.4.3"
+    "react": "^19.2.7"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/dist/agent/runner.d.ts

@@ -1,117 +0,0 @@
-import { type AgentResponse, type PresetToolCatalogClient, type ResponseStreamEvent, type Tool } from "@agent-api/sdk";
-import type { ShellIsolationPreferences } from "../workbench/shell-isolation.js";
-export interface AgentRunOptions {
-    profile?: string;
-    promptParts: string[];
-    file?: string;
-    stdin?: boolean;
-    preset?: string;
-    presetExplicit?: boolean;
-    model?: string;
-    modelExplicit?: boolean;
-    stream?: boolean;
-    conversation?: string;
-    continueConversation?: boolean;
-    restartConversation?: boolean;
-    previousResponseId?: string;
-    workdir?: string;
-    includeLocalContext?: boolean;
-    contextQuery?: string;
-    maxContextFiles?: number;
-    maxContextBytes?: number;
-    accessMode?: WorkdirAccessMode;
-    shellIsolation?: ShellIsolationPreferences;
-    abortSignal?: AbortSignal;
-}
-export type WorkdirAccessMode = "off" | "approval" | "full";
-export interface AgentTurnResult {
-    text: string;
-    responseID?: string;
-}
-export interface LocalToolApprovalRequest {
-    name: string;
-    action?: string;
-    arguments: Record<string, unknown>;
-    preview?: unknown;
-    callID: string;
-    responseID: string;
-}
-export type AgentTurnEvent = {
-    type: "text.delta";
-    delta: string;
-} | {
-    type: "response.started";
-    responseID?: string;
-} | {
-    type: "response.completed";
-    responseID?: string;
-} | {
-    type: "response.failed";
-    message: string;
-} | {
-    type: "reasoning.started";
-} | {
-    type: "reasoning.stopped";
-    thought?: string;
-} | {
-    type: "reasoning.search_queries";
-    queries: string[];
-} | {
-    type: "reasoning.search_results";
-    count: number;
-} | {
-    type: "reasoning.fetch_url_queries";
-    urls: string[];
-} | {
-    type: "reasoning.fetch_url_results";
-    count: number;
-} | {
-    type: "tool.completed";
-    name: string;
-    status?: string;
-} | {
-    type: "local_tool.completed";
-    name: string;
-    action?: string;
-    requiresApproval?: boolean;
-} | ({
-    type: "local_tool.approval_requested";
-} & LocalToolApprovalRequest) | {
-    type: "model.requested";
-    model?: string;
-    provider?: string;
-} | {
-    type: "model.completed";
-    model?: string;
-    provider?: string;
-} | {
-    type: "model.failed";
-    model?: string;
-    provider?: string;
-} | {
-    type: "step.completed";
-    stepType?: string;
-} | {
-    type: "step.failed";
-    stepType?: string;
-} | {
-    type: "raw";
-    eventType: string;
-};
-export interface ResolveAgentRequestToolsOptions {
-    baseURL?: string;
-    cacheTTLMS?: number;
-}
-export interface PresetSummary {
-    preset: string;
-    description?: string;
-}
-export declare function runAgent(options: AgentRunOptions): Promise<void>;
-export declare function runAgentTurn(options: AgentRunOptions, onEvent?: (event: AgentTurnEvent) => void): Promise<AgentTurnResult>;
-export declare function resumeAgentAfterLocalApproval(options: AgentRunOptions, approval: LocalToolApprovalRequest, output: string | Record<string, unknown>, onEvent?: (event: AgentTurnEvent) => void): Promise<AgentTurnResult>;
-export declare function listAvailablePresets(profileName?: string): Promise<PresetSummary[]>;
-export declare function isAvailablePreset(profileName: string | undefined, preset: string): Promise<boolean>;
-export declare function agentResponseFailureMessage(response: AgentResponse): string;
-export declare function agentTurnEventFromStreamEvent(event: ResponseStreamEvent): AgentTurnEvent | null;
-export declare function resolveAgentRequestTools(client: PresetToolCatalogClient, preset?: string, tools?: readonly Tool[], options?: ResolveAgentRequestToolsOptions): Promise<Tool[] | undefined>;
-export declare function clearPresetToolCatalogCache(baseURL?: string): void;