@agent-api/cli 0.0.1 → 0.0.3

package/README.md

@@ -73,6 +73,17 @@ Launch the first-class TUI from your current directory:
 agent-tui
 ```
 
+Open a specific local workdir and expose local tools to the agent:
+
+```bash
+agent-tui .
+agent-tui ./my-workdir
+agent-tui /absolute/path/to/my-workdir
+```
+
+The workdir argument must point to an existing directory. When provided, the
+workbench automatically turns on local workdir and shell tools in approval mode.
+
 The workbench opens with auth as the first gate. If the active profile is valid,
 it enters the conversation UI automatically. If not, it shows an in-terminal
 auth picker for browser session or API key login.

package/dist/index.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import { Command, Option } from "commander";
+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";
@@ -15,15 +17,17 @@ program
     .alias("agentsway")
     .alias("agent-tui")
     .description("First-class command line interface for Agent API")
+    .argument("[workdir]", "local workdir to open and expose to the agent")
     .version(cliVersion)
     .showHelpAfterError()
     .showSuggestionAfterError();
-program.action(async () => {
+program.action(async (workdir) => {
+    const launchWorkdir = workdir ? await validateLaunchWorkdir(workdir) : undefined;
     if (!process.stdin.isTTY) {
         program.help();
         return;
     }
-    const options = normalizeChatOptions([], {});
+    const options = normalizeChatOptions([], launchWorkdir ? { workdir: launchWorkdir } : {});
     const app = render(React.createElement(ChatApp, { options }));
     await app.waitUntilExit();
 });
@@ -306,3 +310,17 @@ function optionalNumber(value, label) {
         throw new Error(`${label} must be a number`);
     return parsed;
 }
+async function validateLaunchWorkdir(path) {
+    const resolved = resolve(path);
+    let info;
+    try {
+        info = await stat(resolved);
+    }
+    catch {
+        throw new Error(`Workdir does not exist: ${path}`);
+    }
+    if (!info.isDirectory()) {
+        throw new Error(`Workdir is not a directory: ${path}`);
+    }
+    return resolved;
+}

package/dist/runtime/index.d.ts

@@ -1,5 +1,5 @@
 export declare const cliName = "agent-api-cli";
 export declare const cliAuthor = "AgentsWay";
-export declare const cliVersion = "0.0.1";
+export declare const cliVersion = "0.0.3";
 export declare const runtime: import("@agent-api/sdk/local").LocalRuntime;
 export declare function ensureRuntime(): Promise<import("@agent-api/sdk/local").LocalRuntime>;

package/dist/runtime/index.js

@@ -1,7 +1,7 @@
 import { createLocalRuntime } from "@agent-api/sdk/local";
 export const cliName = "agent-api-cli";
 export const cliAuthor = "AgentsWay";
-export const cliVersion = "0.0.1";
+export const cliVersion = "0.0.3";
 export const runtime = createLocalRuntime({
     appName: cliName,
     appAuthor: cliAuthor,

package/dist/tui/chat.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
-import { type AgentRunOptions } from "../agent.js";
+import { listAvailablePresets, type AgentRunOptions } from "../agent.js";
 export declare function ChatApp({ options }: {
     options: AgentRunOptions;
 }): React.JSX.Element;
+export declare function formatPresetList(presets: Awaited<ReturnType<typeof listAvailablePresets>>, currentPreset?: string): string[];

package/dist/tui/chat.js

@@ -5,7 +5,7 @@ import { defaultBaseURL, loadWorkbenchPreferences, updateWorkbenchPreferences, }
 import { conversationSummary, clearPresetToolCatalogCache, deleteConversation, isAvailablePreset, listAvailablePresets, listConversations, resumeAgentAfterLocalApproval, runAgentTurn, } from "../agent.js";
 import { openWorkdir, } from "../workdir/index.js";
 import { createLocalShellToolRegistry, createLocalWorkdirToolRegistry } from "@agent-api/sdk/local";
-import { activityColor, createInitialWorkbenchState, formatBytes, helpText, parsePendingApprovalCommand, parseWorkbenchCommand, workbenchReducer, workdirText, } from "./workbench.js";
+import { activityColor, createInputHistory, createInitialWorkbenchState, formatBytes, helpText, parsePendingApprovalCommand, parseWorkbenchCommand, workbenchReducer, workdirText, } from "./workbench.js";
 import { deleteProfile, formatDeviceUserCode, getAuthStatus, loginWithAPIKey, openBrowserURL, refreshActiveProfileIfNeeded, resolveRuntimeProfile, saveBrowserProfile, startBrowserAuthChallenge, waitForBrowserAuthChallenge, } from "../profile.js";
 import { checkForUpdate, formatUpdateNotice } from "../update.js";
 export function ChatApp({ options }) {
@@ -254,6 +254,7 @@ function WorkbenchApp({ onLogin, onLogout, onDeleteProfile, onSwitchProfile, opt
     const activeResponseIDRef = useRef(null);
     const cancelledResponseIDsRef = useRef(new Set());
     const updateNoticeShownRef = useRef(false);
+    const inputHistoryRef = useRef(createInputHistory());
     const [draft, setDraft] = useState("");
     const [spinnerFrame, setSpinnerFrame] = useState(0);
     const [runPreset, setRunPreset] = useState(options.preset);
@@ -371,6 +372,14 @@ function WorkbenchApp({ onLogin, onLogout, onDeleteProfile, onSwitchProfile, opt
             app.exit();
             return;
         }
+        if (key.upArrow) {
+            setDraft((current) => inputHistoryRef.current.previous(current));
+            return;
+        }
+        if (key.downArrow) {
+            setDraft((current) => inputHistoryRef.current.next(current));
+            return;
+        }
         if (state.busy) {
             if (key.escape) {
                 void abortActiveTurn("Abort requested.");
@@ -378,6 +387,7 @@ function WorkbenchApp({ onLogin, onLogout, onDeleteProfile, onSwitchProfile, opt
             }
             if (key.return) {
                 const command = draft.trim();
+                inputHistoryRef.current.record(command);
                 setDraft("");
                 if (command === "/abort" || command === "/cancel") {
                     void abortActiveTurn("Abort requested.");
@@ -390,10 +400,12 @@ function WorkbenchApp({ onLogin, onLogout, onDeleteProfile, onSwitchProfile, opt
                 return;
             }
             if (key.backspace || key.delete) {
+                inputHistoryRef.current.reset();
                 setDraft((current) => current.slice(0, -1));
                 return;
             }
             if (input && !key.ctrl && !key.meta) {
+                inputHistoryRef.current.reset();
                 setDraft((current) => current + input);
             }
             return;
@@ -402,15 +414,18 @@ function WorkbenchApp({ onLogin, onLogout, onDeleteProfile, onSwitchProfile, opt
             const prompt = draft.trim();
             if (!prompt)
                 return;
+            inputHistoryRef.current.record(prompt);
             setDraft("");
             void submit(prompt);
             return;
         }
         if (key.backspace || key.delete) {
+            inputHistoryRef.current.reset();
             setDraft((current) => current.slice(0, -1));
             return;
         }
         if (input && !key.ctrl && !key.meta) {
+            inputHistoryRef.current.reset();
             setDraft((current) => current + input);
         }
     });
@@ -699,7 +714,7 @@ function WorkbenchApp({ onLogin, onLogout, onDeleteProfile, onSwitchProfile, opt
                 prefix,
                 "",
                 "Available presets:",
-                ...formatPresetList(presets),
+                ...formatPresetList(presets, runPreset),
             ].join("\n");
         }
         catch (error) {
@@ -1208,12 +1223,13 @@ function effectiveDefaultPreset(preferences, builtInPreset) {
         return preferences.defaultPreset ?? undefined;
     return builtInPreset;
 }
-function formatPresetList(presets) {
+export function formatPresetList(presets, currentPreset) {
     if (presets.length === 0)
         return ["- none returned by this endpoint"];
     return presets.map((preset) => {
         const description = preset.description ? ` - ${preset.description}` : "";
-        return `- ${preset.preset}${description}`;
+        const current = currentPreset && preset.preset === currentPreset;
+        return `${current ? "*" : "-"} ${preset.preset}${current ? " (current)" : ""}${description}`;
     });
 }
 function authStatusText(status) {

package/dist/tui/workbench.d.ts

@@ -34,6 +34,13 @@ export interface WorkbenchState {
     accessMode: WorkdirAccessMode;
     currentConversation: string;
 }
+export interface InputHistory {
+    record(value: string): void;
+    previous(currentDraft: string): string;
+    next(currentDraft: string): string;
+    reset(): void;
+    values(): string[];
+}
 export type WorkbenchAction = {
     type: "message.add";
     role: WorkbenchRole;
@@ -145,6 +152,7 @@ export declare function createInitialWorkbenchState(options: {
     accessMode?: WorkdirAccessMode;
     conversation?: string;
 }): WorkbenchState;
+export declare function createInputHistory(limit?: number): InputHistory;
 export declare function workbenchReducer(state: WorkbenchState, action: WorkbenchAction): WorkbenchState;
 export declare function parseWorkbenchCommand(input: string): WorkbenchCommand | null;
 export declare function parsePendingApprovalCommand(input: string): WorkbenchCommand | null;

package/dist/tui/workbench.js

@@ -16,6 +16,56 @@ export function createInitialWorkbenchState(options) {
         currentConversation: options.conversation || "default",
     };
 }
+export function createInputHistory(limit = 100) {
+    const entries = [];
+    let cursor = null;
+    let draftBeforeBrowse = "";
+    return {
+        record(value) {
+            const trimmed = value.trim();
+            if (!trimmed)
+                return;
+            if (entries.at(-1) !== trimmed) {
+                entries.push(trimmed);
+                if (entries.length > limit)
+                    entries.splice(0, entries.length - limit);
+            }
+            cursor = null;
+            draftBeforeBrowse = "";
+        },
+        previous(currentDraft) {
+            if (entries.length === 0)
+                return currentDraft;
+            if (cursor === null) {
+                draftBeforeBrowse = currentDraft;
+                cursor = entries.length - 1;
+            }
+            else {
+                cursor = Math.max(0, cursor - 1);
+            }
+            return entries[cursor] ?? currentDraft;
+        },
+        next(currentDraft) {
+            if (entries.length === 0 || cursor === null)
+                return currentDraft;
+            if (cursor < entries.length - 1) {
+                cursor += 1;
+                return entries[cursor] ?? currentDraft;
+            }
+            cursor = null;
+            const restored = draftBeforeBrowse;
+            draftBeforeBrowse = "";
+            return restored;
+        },
+        reset() {
+            cursor = null;
+            draftBeforeBrowse = "";
+        },
+        values() {
+            return [...entries];
+        },
+    };
+}
 export function workbenchReducer(state, action) {
     switch (action.type) {
         case "message.add":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/cli",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "First-class command line interface for Agent API",
   "license": "MIT",
   "homepage": "https://github.com/scalebox-dev/agent-tui#readme",
@@ -20,7 +20,7 @@
   "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",
+    "build": "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",