@agent-api/cli 0.2.1 → 0.3.0

package/dist/tui/workbench.js

@@ -1,392 +0,0 @@
-export function createInitialWorkbenchState(options) {
-    const accessMode = options.accessMode ?? (options.contextEnabled ? "approval" : "off");
-    return {
-        messages: [
-            newMessage("system", "Agent API Workbench is ready. Type /help for commands."),
-        ],
-        activities: [
-            newActivity("info", "Workbench started"),
-        ],
-        busy: false,
-        contextEnabled: options.contextEnabled || accessMode === "approval" || accessMode === "full",
-        workdir: null,
-        activeAssistantMessageId: null,
-        pendingLocalTool: null,
-        accessMode,
-        currentConversation: options.conversation || "default",
-        runPreset: options.preset,
-        runModel: options.model,
-        renderMode: options.renderMode ?? "markdown",
-        defaultPreset: options.defaultPreset,
-        shellIsolation: options.shellIsolation,
-    };
-}
-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":
-            return {
-                ...state,
-                messages: [...state.messages, newMessage(action.role, action.text, action.id)],
-            };
-        case "message.append":
-            return {
-                ...state,
-                messages: state.messages.map((message) => message.id === action.id ? { ...message, text: message.text + action.delta } : message),
-            };
-        case "messages.clear":
-            return {
-                ...state,
-                messages: [newMessage("system", "Cleared. Type /help for commands.")],
-            };
-        case "activity.add":
-            return {
-                ...state,
-                activities: [...state.activities, newActivity(action.level ?? "info", action.text)].slice(-20),
-            };
-        case "busy.set":
-            return { ...state, busy: action.busy };
-        case "context.toggle":
-            return setLocalAccess(state, state.contextEnabled ? "off" : "approval");
-        case "context.set":
-            return setLocalAccess(state, action.enabled ? "approval" : "off");
-        case "workdir.set":
-            return {
-                ...state,
-                workdir: action.workdir,
-                activities: [...state.activities, newActivity("success", `Workdir loaded: ${action.workdir.name}`)].slice(-20),
-            };
-        case "assistant.active":
-            return { ...state, activeAssistantMessageId: action.id };
-        case "local_tool.pending.set": {
-            const pending = {
-                ...action.approval,
-                id: `local-${Date.now()}`,
-                createdAt: Date.now(),
-            };
-            return {
-                ...state,
-                pendingLocalTool: pending,
-                activities: [
-                    ...state.activities,
-                    newActivity("warning", `Local approval ready: ${pending.name}${pending.action ? `.${pending.action}` : ""}`),
-                ].slice(-20),
-            };
-        }
-        case "local_tool.pending.clear":
-            return {
-                ...state,
-                pendingLocalTool: null,
-            };
-        case "access.set":
-            return setLocalAccess(state, action.mode);
-        case "conversation.set":
-            return {
-                ...state,
-                currentConversation: action.name,
-                activities: [...state.activities, newActivity("info", `Conversation: ${action.name}`)].slice(-20),
-            };
-        case "settings.set":
-            return {
-                ...state,
-                ...action.settings,
-            };
-        default:
-            return state;
-    }
-}
-function setLocalAccess(state, mode) {
-    return {
-        ...state,
-        accessMode: mode,
-        contextEnabled: mode !== "off",
-        pendingLocalTool: mode === "off" ? null : state.pendingLocalTool,
-        activities: [...state.activities, newActivity(mode === "off" ? "warning" : "success", `Local access: ${mode}`)].slice(-20),
-    };
-}
-export function parseWorkbenchCommand(input) {
-    const trimmed = input.trim();
-    if (!trimmed.startsWith("/"))
-        return null;
-    const [name = "", ...rest] = trimmed.slice(1).split(/\s+/);
-    switch (name) {
-        case "abort":
-        case "cancel":
-            return { kind: "abort" };
-        case "quit":
-            return { kind: "quit" };
-        case "exit":
-            return { kind: "quit" };
-        case "help":
-            return { kind: "help" };
-        case "clear":
-            return { kind: "clear" };
-        case "login":
-        case "signin":
-            return { kind: "login" };
-        case "logout":
-        case "signout":
-            return { kind: "logout" };
-        case "delete-profile":
-        case "delete_profile":
-            return { kind: "delete_profile" };
-        case "switch-profile":
-        case "switch_profile":
-            return { kind: "switch_profile", name: rest.join(" ").trim() || undefined };
-        case "auth":
-            return { kind: "auth_status" };
-        case "config":
-        case "settings": {
-            const [field, ...valueParts] = rest;
-            if (!field)
-                return { kind: "config" };
-            if (field === "preset" || field === "isolation" || field === "isolator") {
-                return { kind: "config", field, value: valueParts.join(" ").trim() || undefined };
-            }
-            return { kind: "invalid", command: `${name} ${field}` };
-        }
-        case "render":
-        case "display":
-        case "view": {
-            const mode = rest[0];
-            if (mode === "raw" || mode === "markdown")
-                return { kind: "render", mode };
-            return { kind: "render" };
-        }
-        case "transcript":
-            return { kind: "transcript" };
-        case "export":
-            return { kind: "export", path: rest.join(" ").trim() || undefined };
-        case "context":
-            return { kind: "context", enabled: parseOnOff(rest[0]) };
-        case "access": {
-            const mode = rest[0];
-            if (mode === "off" || mode === "approval" || mode === "full")
-                return { kind: "access", mode };
-            return { kind: "access" };
-        }
-        case "preset": {
-            const value = rest.join(" ").trim();
-            return { kind: "preset", value: value || undefined };
-        }
-        case "model": {
-            const value = rest.join(" ").trim();
-            return { kind: "model", value: value || undefined };
-        }
-        case "workdir":
-        case "local":
-            return { kind: "workdir", enabled: parseOnOff(rest[0]) };
-        case "summary":
-            return { kind: "summary" };
-        case "new":
-        case "thread":
-            return { kind: "new_conversation", name: rest.join(" ").trim() || undefined };
-        case "conversation":
-        case "switch":
-        case "use":
-            if (rest.length === 0)
-                return { kind: "list_conversations" };
-            return { kind: "switch_conversation", name: rest.join(" ").trim() };
-        case "conversations":
-        case "threads":
-            return { kind: "list_conversations" };
-        case "refresh":
-        case "reload":
-        case "refresh-catalog":
-            return { kind: "refresh_catalog" };
-        case "search":
-        case "grep":
-            return { kind: "search", query: rest.join(" ").trim() };
-        case "preview":
-            return { kind: "preview" };
-        case "apply":
-            return { kind: "apply" };
-        case "apply-all":
-        case "yes-all":
-            return { kind: "apply_all" };
-        case "reject":
-            return { kind: "reject" };
-        default:
-            return { kind: "invalid", command: name };
-    }
-}
-export function parsePendingApprovalCommand(input) {
-    const trimmed = input.trim().toLowerCase();
-    if (!trimmed.startsWith("/"))
-        return null;
-    const [name = ""] = trimmed.slice(1).split(/\s+/);
-    switch (name) {
-        case "apply":
-        case "yes":
-            return { kind: "apply" };
-        case "apply-all":
-        case "yes-all":
-            return { kind: "apply_all" };
-        case "reject":
-        case "no":
-            return { kind: "reject" };
-        default:
-            return null;
-    }
-}
-export function helpText() {
-    return [
-        "Commands:",
-        "/auth            show current auth profile",
-        "/login           return to auth gate without deleting profiles",
-        "/logout          leave current session and return to auth gate",
-        "/switch-profile  switch/sign in with a different profile",
-        "/delete-profile  delete current saved profile and return to auth",
-        "/config          show current run configuration and saved defaults",
-        "/render [mode]   show or set output rendering: markdown or raw",
-        "/transcript      show a plain-text transcript preview",
-        "/export [file]   save the plain-text transcript to a file",
-        "/config preset   save default preset; use none/off for no preset, reset for built-in",
-        "/config isolation save shell isolation mode: none, auto, or required",
-        "/config isolator save agent-isolator path; use none/off to clear",
-        "/preset [name]   show or set preset; use none/off to clear",
-        "/model [name]    show or set explicit model; use auto/none/off to clear",
-        "/access [mode]   show or set local tool access: off, approval, or full",
-        "/workdir       show local workdir status",
-        "/workdir on    shortcut for /access approval; /workdir off hides local tools",
-        "/new [name]      start a fresh conversation in this workbench",
-        "/switch <name>   switch to an existing/new conversation handle",
-        "/conversations   list saved local conversation handles",
-        "/summary         show local workdir summary previews",
-        "/search <query>  search text in the local workdir",
-        "/preview         show pending local action preview",
-        "/apply           apply pending local action",
-        "/apply-all       apply pending action and allow future local actions",
-        "/reject          reject pending local action",
-        "/abort           cancel the in-flight agent turn",
-        "/context         toggle local context packaging for each agent turn",
-        "/clear           clear the visible terminal transcript",
-        "/quit            leave the workbench",
-    ].join("\n");
-}
-export function formatTranscript(messages) {
-    return messages
-        .map((message) => {
-        const body = message.text.trimEnd();
-        return body ? `${roleLabel(message.role)}:\n${body}` : `${roleLabel(message.role)}:`;
-    })
-        .join("\n\n")
-        .trimEnd() + "\n";
-}
-export function formatTranscriptPreview(messages, maxLines = 80) {
-    const lines = formatTranscript(messages).trimEnd().split(/\r?\n/);
-    if (lines.length <= maxLines) {
-        return ["Transcript preview:", "", ...lines].join("\n");
-    }
-    return [
-        `Transcript preview: showing last ${maxLines} lines of ${lines.length}. Use /export [file] for the full transcript.`,
-        "",
-        ...lines.slice(-maxLines),
-    ].join("\n");
-}
-function parseOnOff(value) {
-    if (!value)
-        return undefined;
-    const normalized = value.toLowerCase();
-    if (["on", "enable", "enabled", "yes", "true"].includes(normalized))
-        return true;
-    if (["off", "disable", "disabled", "no", "false"].includes(normalized))
-        return false;
-    return undefined;
-}
-export function workdirText(status) {
-    if (!status)
-        return "Workdir summary is still loading.";
-    return [
-        `Workdir: ${status.root}`,
-        `Files: ${status.fileCount}`,
-        `Size: ${formatBytes(status.totalBytes)}`,
-        `Scan truncated: ${status.scanTruncated ? "yes" : "no"}`,
-    ].join("\n");
-}
-export function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes} B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} KB`;
-    return `${(bytes / 1024 / 1024).toFixed(2)} MB`;
-}
-export function activityColor(level) {
-    if (level === "success")
-        return "green";
-    if (level === "warning")
-        return "yellow";
-    if (level === "error")
-        return "red";
-    return "gray";
-}
-function newMessage(role, text, id = randomId()) {
-    return { id, role, text };
-}
-function roleLabel(role) {
-    if (role === "user")
-        return "You";
-    if (role === "assistant")
-        return "Agent";
-    return "System";
-}
-function newActivity(level, text) {
-    return {
-        id: randomId(),
-        level,
-        text,
-        timestamp: Date.now(),
-    };
-}
-function randomId() {
-    return Math.random().toString(36).slice(2);
-}

package/dist/update.d.ts

@@ -1,16 +0,0 @@
-export interface UpdateCheckResult {
-    current: string;
-    latest: string;
-    packageName: string;
-    updateAvailable: boolean;
-}
-export interface UpdateCheckOptions {
-    currentVersion?: string;
-    packageName?: string;
-    registryURL?: string;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-}
-export declare function checkForUpdate(options?: UpdateCheckOptions): Promise<UpdateCheckResult | null>;
-export declare function formatUpdateNotice(result: UpdateCheckResult): string;
-export declare function compareVersions(a: string, b: string): number;

package/dist/update.js

@@ -1,74 +0,0 @@
-import { cliVersion } from "./runtime/index.js";
-const defaultPackageName = "@agent-api/cli";
-const defaultRegistryURL = "https://registry.npmjs.org";
-export async function checkForUpdate(options = {}) {
-    const packageName = options.packageName || process.env.AGENT_TUI_UPDATE_PACKAGE || defaultPackageName;
-    const current = options.currentVersion || cliVersion;
-    const registryURL = (options.registryURL || process.env.AGENT_TUI_NPM_REGISTRY || defaultRegistryURL).replace(/\/+$/, "");
-    const timeoutMs = options.timeoutMs ?? 1500;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    const signal = combineSignals(options.signal, controller.signal);
-    try {
-        const response = await fetch(`${registryURL}/${encodeURIComponent(packageName).replace(/^%40/, "@")}/latest`, {
-            headers: { Accept: "application/json" },
-            signal,
-        });
-        if (!response.ok)
-            return null;
-        const payload = await response.json().catch(() => undefined);
-        const latest = typeof payload?.version === "string" ? payload.version : "";
-        if (!latest)
-            return null;
-        return {
-            current,
-            latest,
-            packageName,
-            updateAvailable: compareVersions(latest, current) > 0,
-        };
-    }
-    catch {
-        return null;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-export function formatUpdateNotice(result) {
-    return `Update available: ${result.packageName} ${result.current} -> ${result.latest}. Run: npm install -g ${result.packageName}@latest`;
-}
-export function compareVersions(a, b) {
-    const left = parseVersion(a);
-    const right = parseVersion(b);
-    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
-        const delta = (left[index] ?? 0) - (right[index] ?? 0);
-        if (delta !== 0)
-            return delta > 0 ? 1 : -1;
-    }
-    return 0;
-}
-function parseVersion(version) {
-    return version
-        .replace(/^[^\d]*/, "")
-        .split(/[.-]/)
-        .slice(0, 3)
-        .map((part) => {
-        const parsed = Number.parseInt(part, 10);
-        return Number.isFinite(parsed) ? parsed : 0;
-    });
-}
-function combineSignals(...signals) {
-    const active = signals.filter((signal) => Boolean(signal));
-    if (active.length === 1)
-        return active[0];
-    const controller = new AbortController();
-    const abort = () => controller.abort();
-    for (const signal of active) {
-        if (signal.aborted) {
-            controller.abort();
-            break;
-        }
-        signal.addEventListener("abort", abort, { once: true });
-    }
-    return controller.signal;
-}

package/dist/workbench/auth-controller.d.ts

@@ -1,43 +0,0 @@
-import { deleteProfile, getAuthStatus, loginWithAPIKey, openBrowserURL, refreshActiveProfileIfNeeded, saveBrowserProfile, startBrowserAuthChallenge, waitForBrowserAuthChallenge, type AuthStatus } from "../profile.js";
-export interface WorkbenchAuthController {
-    check(profile?: string, refreshWindowMs?: number): Promise<{
-        profileName: string;
-        refreshed: boolean;
-    }>;
-    loginAPIKey(input: {
-        profile: string;
-        baseURL: string;
-        apiKey: string;
-    }): Promise<{
-        profileName: string;
-    }>;
-    loginBrowser(input: {
-        profile: string;
-        baseURL: string;
-        clientName?: string;
-        onChallenge?: (challenge: {
-            url: string;
-            code: string;
-        }) => void;
-        onStatus?: (status: string) => void;
-    }): Promise<{
-        profileName: string;
-    }>;
-    deleteProfile(name: string): Promise<void>;
-    statusText(profile?: string): Promise<string>;
-    refresh(profile?: string, refreshWindowMs?: number): Promise<{
-        refreshed: boolean;
-    }>;
-}
-export interface WorkbenchAuthControllerOptions {
-    refreshActiveProfileIfNeededImpl?: typeof refreshActiveProfileIfNeeded;
-    loginWithAPIKeyImpl?: typeof loginWithAPIKey;
-    startBrowserAuthChallengeImpl?: typeof startBrowserAuthChallenge;
-    openBrowserURLImpl?: typeof openBrowserURL;
-    waitForBrowserAuthChallengeImpl?: typeof waitForBrowserAuthChallenge;
-    saveBrowserProfileImpl?: typeof saveBrowserProfile;
-    deleteProfileImpl?: typeof deleteProfile;
-    getAuthStatusImpl?: typeof getAuthStatus;
-}
-export declare function createWorkbenchAuthController(options?: WorkbenchAuthControllerOptions): WorkbenchAuthController;
-export declare function authStatusText(status: AuthStatus): string;

package/dist/workbench/auth-controller.js

@@ -1,84 +0,0 @@
-import { deleteProfile, formatDeviceUserCode, getAuthStatus, loginWithAPIKey, openBrowserURL, refreshActiveProfileIfNeeded, saveBrowserProfile, startBrowserAuthChallenge, waitForBrowserAuthChallenge, } from "../profile.js";
-export function createWorkbenchAuthController(options = {}) {
-    const refreshActiveProfileIfNeededImpl = options.refreshActiveProfileIfNeededImpl ?? refreshActiveProfileIfNeeded;
-    const loginWithAPIKeyImpl = options.loginWithAPIKeyImpl ?? loginWithAPIKey;
-    const startBrowserAuthChallengeImpl = options.startBrowserAuthChallengeImpl ?? startBrowserAuthChallenge;
-    const openBrowserURLImpl = options.openBrowserURLImpl ?? openBrowserURL;
-    const waitForBrowserAuthChallengeImpl = options.waitForBrowserAuthChallengeImpl ?? waitForBrowserAuthChallenge;
-    const saveBrowserProfileImpl = options.saveBrowserProfileImpl ?? saveBrowserProfile;
-    const deleteProfileImpl = options.deleteProfileImpl ?? deleteProfile;
-    const getAuthStatusImpl = options.getAuthStatusImpl ?? getAuthStatus;
-    return {
-        async check(profile, refreshWindowMs = 5 * 60_000) {
-            const result = await refreshActiveProfileIfNeededImpl(profile, refreshWindowMs);
-            return { profileName: result.profile.name, refreshed: result.refreshed };
-        },
-        async loginAPIKey(input) {
-            const saved = await loginWithAPIKeyImpl(input);
-            return { profileName: saved.name };
-        },
-        async loginBrowser(input) {
-            const challenge = await startBrowserAuthChallengeImpl({
-                baseURL: input.baseURL,
-                clientName: input.clientName || "Agent API TUI",
-            });
-            input.onChallenge?.({
-                url: challenge.verification_uri_complete,
-                code: formatDeviceUserCode(challenge.user_code),
-            });
-            await openBrowserURLImpl(challenge.verification_uri_complete).catch(() => undefined);
-            const session = await waitForBrowserAuthChallengeImpl({
-                baseURL: input.baseURL,
-                challenge,
-                on_poll(result) {
-                    if (result.status && result.status !== "pending") {
-                        input.onStatus?.(result.status);
-                    }
-                },
-            });
-            const saved = await saveBrowserProfileImpl(input.profile, input.baseURL, session);
-            return { profileName: saved.name };
-        },
-        async deleteProfile(name) {
-            await deleteProfileImpl(name);
-        },
-        async statusText(profile) {
-            return authStatusText(await getAuthStatusImpl(profile));
-        },
-        async refresh(profile, refreshWindowMs = 5 * 60_000) {
-            const result = await refreshActiveProfileIfNeededImpl(profile, refreshWindowMs);
-            return { refreshed: result.refreshed };
-        },
-    };
-}
-export function authStatusText(status) {
-    return [
-        `Profile: ${status.profile}`,
-        `Endpoint: ${status.baseURL}`,
-        `Auth: ${status.authType === "api_key" ? "API key" : "Browser session"}`,
-        `Account: ${summarizeMe(status.me)}`,
-    ].join("\n");
-}
-function summarizeMe(me) {
-    if (!me || typeof me !== "object")
-        return "available";
-    const obj = me;
-    const candidates = [
-        obj.email,
-        obj.name,
-        obj.username,
-        obj.user_id,
-        obj.id,
-        nestedString(obj.user, "email"),
-        nestedString(obj.user, "name"),
-        nestedString(obj.user, "id"),
-    ];
-    const picked = candidates.find((value) => typeof value === "string" && value.trim() !== "");
-    return picked || "available";
-}
-function nestedString(value, key) {
-    if (!value || typeof value !== "object")
-        return undefined;
-    const nested = value[key];
-    return typeof nested === "string" ? nested : undefined;
-}

package/dist/workbench/auth-gate-controller.d.ts

@@ -1,62 +0,0 @@
-import { type WorkbenchAuthController } from "./auth-controller.js";
-export type AuthMethod = "browser" | "api_key" | "exit";
-export type AuthGateState = {
-    status: "checking" | "select" | "api_profile" | "api_base_url" | "api_key" | "browser_profile" | "browser_base_url" | "browser_waiting" | "ready";
-    selectedMethod: number;
-    profile: string;
-    baseURL: string;
-    apiKey: string;
-    message: string;
-    error: string;
-    browserURL: string;
-    browserCode: string;
-};
-export interface AuthGateInputKey {
-    backspace?: boolean;
-    ctrl?: boolean;
-    delete?: boolean;
-    downArrow?: boolean;
-    meta?: boolean;
-    return?: boolean;
-    upArrow?: boolean;
-}
-export type AuthGateInputEffect = {
-    type: "exit";
-} | {
-    type: "submit";
-};
-export interface AuthGateInputResult {
-    state: AuthGateState;
-    effects: AuthGateInputEffect[];
-}
-export interface AuthGateSubmitResult {
-    state: AuthGateState;
-    profileName?: string;
-}
-export interface WorkbenchAuthGateController {
-    authMethods: typeof authMethods;
-    initialState(input: {
-        profile?: string;
-        baseURL?: string;
-        apiKey?: string;
-    }): AuthGateState;
-    check(profile?: string): Promise<AuthGateSubmitResult>;
-    handleInput(input: string, key: AuthGateInputKey, state: AuthGateState): AuthGateInputResult;
-    submit(state: AuthGateState, options?: {
-        onState?: (state: AuthGateState) => void;
-    }): Promise<AuthGateSubmitResult>;
-    requestLogin(state: AuthGateState, profileName: string): AuthGateState;
-    requestLogout(state: AuthGateState, profileName: string): AuthGateState;
-    requestSwitchProfile(state: AuthGateState, currentProfile: string, nextProfile?: string): AuthGateState;
-    deletedProfile(state: AuthGateState, profileName: string): AuthGateState;
-}
-export interface WorkbenchAuthGateControllerOptions {
-    authController?: WorkbenchAuthController;
-    formatError?: (error: unknown) => string;
-}
-export declare const authMethods: Array<{
-    method: AuthMethod;
-    label: string;
-    description: string;
-}>;
-export declare function createWorkbenchAuthGateController(options?: WorkbenchAuthGateControllerOptions): WorkbenchAuthGateController;