@agent-api/cli 0.2.1 → 0.3.0

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

@@ -1,32 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { deleteConversation, listConversations } from "../agent.js";
-export interface WorkbenchConversationController {
-    startNewConversation(name: string | undefined, profileName?: string): Promise<{
-        name: string;
-        message: string;
-    }>;
-    switchConversation(name: string): {
-        name: string;
-        message: string;
-    };
-    listConversations(profileName?: string): Promise<string>;
-    exportTranscript(input: {
-        path?: string;
-        transcript: string;
-        conversation: string;
-    }): Promise<string>;
-}
-export interface WorkbenchConversationControllerOptions {
-    deleteConversationImpl?: typeof deleteConversation;
-    listConversationsImpl?: typeof listConversations;
-    mkdirImpl?: typeof mkdir;
-    writeFileImpl?: typeof writeFile;
-    now?: () => Date;
-    dataDir?: string;
-}
-export declare function createWorkbenchConversationController(options?: WorkbenchConversationControllerOptions): WorkbenchConversationController;
-export declare function defaultTranscriptExportPath(conversation: string, options?: {
-    dataDir?: string;
-    now?: () => Date;
-}): string;
-export declare function createConversationName(now?: Date): string;

package/dist/workbench/conversation-controller.js

@@ -1,53 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { conversationSummary, deleteConversation, listConversations, } from "../agent.js";
-import { runtime } from "../runtime/index.js";
-export function createWorkbenchConversationController(options = {}) {
-    const deleteConversationImpl = options.deleteConversationImpl ?? deleteConversation;
-    const listConversationsImpl = options.listConversationsImpl ?? listConversations;
-    const mkdirImpl = options.mkdirImpl ?? mkdir;
-    const writeFileImpl = options.writeFileImpl ?? writeFile;
-    const now = options.now ?? (() => new Date());
-    return {
-        async startNewConversation(name, profileName) {
-            const conversation = name || createConversationName(now());
-            await deleteConversationImpl(conversation, profileName);
-            return {
-                name: conversation,
-                message: `Started fresh conversation "${conversation}".`,
-            };
-        },
-        switchConversation(name) {
-            return {
-                name,
-                message: `Switched to conversation "${name}". Future turns will continue this handle when history exists.`,
-            };
-        },
-        async listConversations(profileName) {
-            const conversations = await listConversationsImpl(profileName);
-            return conversations.length === 0
-                ? "No saved conversations yet."
-                : conversations.map(conversationSummary).join("\n");
-        },
-        async exportTranscript(input) {
-            const file = input.path?.trim()
-                ? path.resolve(process.cwd(), input.path.trim())
-                : defaultTranscriptExportPath(input.conversation, {
-                    dataDir: options.dataDir,
-                    now,
-                });
-            await mkdirImpl(path.dirname(file), { recursive: true });
-            await writeFileImpl(file, input.transcript, "utf8");
-            return file;
-        },
-    };
-}
-export function defaultTranscriptExportPath(conversation, options = {}) {
-    const safeConversation = conversation.replace(/[^a-z0-9._-]+/gi, "-").replace(/^-+|-+$/g, "") || "conversation";
-    const stamp = (options.now?.() ?? new Date()).toISOString().replace(/[:.]/g, "-");
-    return path.join(options.dataDir ?? runtime.dirs.data, "transcripts", `${safeConversation}-${stamp}.txt`);
-}
-export function createConversationName(now = new Date()) {
-    const stamp = now.toISOString().replace(/[-:]/g, "").replace(/\..+$/, "").replace("T", "-");
-    return `thread-${stamp}`;
-}

package/dist/workbench/engine.d.ts

@@ -1,66 +0,0 @@
-import { type RenderMode, type WorkbenchAction, type WorkbenchCommand, type WorkbenchState } from "../tui/workbench.js";
-import type { AgentTurnEvent, WorkdirAccessMode } from "../agent.js";
-export interface WorkbenchEngineOptions {
-    contextEnabled: boolean;
-    accessMode?: WorkdirAccessMode;
-    conversation?: string;
-    preset?: string;
-    model?: string;
-    renderMode?: RenderMode;
-    defaultPreset?: string | null;
-}
-export interface WorkbenchEngine {
-    snapshot(): WorkbenchState;
-    subscribe(listener: () => void): () => void;
-    dispatch(action: WorkbenchAction): void;
-    submit(input: string): WorkbenchSubmission;
-    handleCommand(command: WorkbenchCommand): WorkbenchCommandResult;
-    handleAgentEvent(event: AgentTurnEvent): WorkbenchEventResult;
-}
-export type WorkbenchSubmission = {
-    kind: "command";
-    command: WorkbenchCommand;
-} | {
-    kind: "prompt";
-    prompt: string;
-} | {
-    kind: "handled";
-};
-export type WorkbenchEffect = {
-    type: "exit";
-} | {
-    type: "login";
-} | {
-    type: "logout";
-} | {
-    type: "delete_profile";
-} | {
-    type: "switch_profile";
-    name?: string;
-} | {
-    type: "show_auth_status";
-} | {
-    type: "export_transcript";
-    path?: string;
-    transcript: string;
-    conversation: string;
-} | {
-    type: "clear_preset_tool_catalog_cache";
-};
-export type WorkbenchRuntimeEffect = {
-    type: "append_text_delta";
-    delta: string;
-} | {
-    type: "set_active_response_id";
-    responseID: string;
-} | {
-    type: "flush_text_delta_buffer";
-};
-export interface WorkbenchCommandResult {
-    handled: boolean;
-    effects: WorkbenchEffect[];
-}
-export interface WorkbenchEventResult {
-    effects: WorkbenchRuntimeEffect[];
-}
-export declare function createWorkbenchEngine(options: WorkbenchEngineOptions): WorkbenchEngine;

package/dist/workbench/engine.js

@@ -1,291 +0,0 @@
-import { createInitialWorkbenchState, formatTranscript, formatTranscriptPreview, helpText, parsePendingApprovalCommand, parseWorkbenchCommand, workbenchReducer, workdirText, } from "../tui/workbench.js";
-export function createWorkbenchEngine(options) {
-    let state = createInitialWorkbenchState(options);
-    let pendingApprovalInvalidInputs = 0;
-    const listeners = new Set();
-    const notify = () => {
-        for (const listener of listeners)
-            listener();
-    };
-    const dispatch = (action) => {
-        if (action.type === "local_tool.pending.set" || action.type === "local_tool.pending.clear") {
-            pendingApprovalInvalidInputs = 0;
-        }
-        const next = workbenchReducer(state, action);
-        if (Object.is(next, state))
-            return;
-        state = next;
-        notify();
-    };
-    return {
-        snapshot() {
-            return state;
-        },
-        subscribe(listener) {
-            listeners.add(listener);
-            return () => {
-                listeners.delete(listener);
-            };
-        },
-        dispatch,
-        handleCommand(command) {
-            switch (command.kind) {
-                case "quit":
-                    return handled({ type: "exit" });
-                case "login":
-                    return handled({ type: "login" });
-                case "logout":
-                    return handled({ type: "logout" });
-                case "delete_profile":
-                    return handled({ type: "delete_profile" });
-                case "switch_profile":
-                    return handled({ type: "switch_profile", name: command.name });
-                case "auth_status":
-                    return handled({ type: "show_auth_status" });
-                case "export":
-                    return handled({
-                        type: "export_transcript",
-                        path: command.path,
-                        transcript: formatTranscript(state.messages),
-                        conversation: state.currentConversation,
-                    });
-                case "refresh_catalog":
-                    dispatch({ type: "activity.add", level: "success", text: "Preset and tool catalogs refreshed" });
-                    dispatch({ type: "message.add", role: "system", text: "Cleared cached preset and server tool catalogs. The next agent turn will fetch fresh platform configuration." });
-                    return handled({ type: "clear_preset_tool_catalog_cache" });
-                case "invalid":
-                    dispatch({
-                        type: "message.add",
-                        role: "system",
-                        text: `Unknown command: /${command.command}\nType /help for supported commands.`,
-                    });
-                    dispatch({ type: "activity.add", level: "warning", text: `Unknown command: /${command.command}` });
-                    return handled();
-                case "help":
-                    dispatch({ type: "message.add", role: "system", text: helpText() });
-                    return handled();
-                case "clear":
-                    dispatch({ type: "messages.clear" });
-                    return handled();
-                case "render":
-                    if (!command.mode) {
-                        dispatch({ type: "message.add", role: "system", text: `Render mode: ${state.renderMode}. Use /render markdown or /render raw.` });
-                        return handled();
-                    }
-                    dispatch({ type: "settings.set", settings: { renderMode: command.mode } });
-                    dispatch({ type: "activity.add", level: "success", text: `Render mode: ${command.mode}` });
-                    dispatch({ type: "message.add", role: "system", text: `Render mode set to ${command.mode}.` });
-                    return handled();
-                case "transcript":
-                    dispatch({ type: "message.add", role: "system", text: formatTranscriptPreview(state.messages) });
-                    dispatch({ type: "activity.add", level: "success", text: "Transcript preview ready" });
-                    return handled();
-                case "context":
-                    dispatch({ type: "context.set", enabled: command.enabled ?? !state.contextEnabled });
-                    return handled();
-                case "access":
-                    if (!command.mode) {
-                        dispatch({ type: "message.add", role: "system", text: `Local access: ${state.accessMode}. Use /access off, /access approval, or /access full.` });
-                        return handled();
-                    }
-                    dispatch({ type: "access.set", mode: command.mode });
-                    return handled();
-                case "model":
-                    if (!command.value) {
-                        dispatch({ type: "message.add", role: "system", text: `Model: ${state.runModel || "auto"}. Use /model <name> or /model auto.` });
-                        return handled();
-                    }
-                    dispatch({ type: "settings.set", settings: { runModel: normalizeOptionalSetting(command.value, ["auto", "none", "off", "clear"]) } });
-                    dispatch({ type: "activity.add", text: `Model: ${normalizeOptionalSetting(command.value, ["auto", "none", "off", "clear"]) || "auto"}` });
-                    return handled();
-                case "workdir":
-                    if (command.enabled === undefined) {
-                        dispatch({
-                            type: "message.add",
-                            role: "system",
-                            text: [
-                                workdirText(state.workdir),
-                                "",
-                                `local_workdir tool: ${state.contextEnabled ? "on" : "off"}`,
-                                `local_shell tool: ${state.contextEnabled ? "on" : "off"}`,
-                                "Use /access approval or /access full to expose local tools, or /access off to hide them.",
-                            ].join("\n"),
-                        });
-                        return handled();
-                    }
-                    dispatch({ type: "context.set", enabled: command.enabled });
-                    dispatch({
-                        type: "activity.add",
-                        level: command.enabled ? "success" : "warning",
-                        text: `local tools ${command.enabled ? "enabled" : "disabled"}`,
-                    });
-                    dispatch({
-                        type: "message.add",
-                        role: "system",
-                        text: command.enabled
-                            ? "local_workdir and local_shell are now available to the model in approval mode. Use /access full to allow execution without prompts."
-                            : "local tools are now hidden from the model.",
-                    });
-                    return handled();
-                default:
-                    return unhandled();
-            }
-        },
-        handleAgentEvent(event) {
-            switch (event.type) {
-                case "text.delta":
-                    return event.delta ? eventResult({ type: "append_text_delta", delta: event.delta }) : eventResult();
-                case "response.started":
-                    if (event.responseID) {
-                        dispatch({ type: "activity.add", text: `Response started: ${event.responseID}` });
-                        return eventResult({ type: "set_active_response_id", responseID: event.responseID });
-                    }
-                    dispatch({ type: "activity.add", text: "Response started" });
-                    return eventResult();
-                case "response.completed":
-                    dispatch({ type: "activity.add", level: "success", text: event.responseID ? `Response completed: ${event.responseID}` : "Response completed" });
-                    return eventResult({ type: "flush_text_delta_buffer" });
-                case "response.failed":
-                    dispatch({ type: "activity.add", level: "error", text: event.message });
-                    return eventResult({ type: "flush_text_delta_buffer" });
-                case "reasoning.started":
-                    dispatch({ type: "activity.add", text: "Reasoning started" });
-                    return eventResult();
-                case "reasoning.stopped":
-                    dispatch({ type: "activity.add", text: event.thought ? `Reasoning stopped: ${event.thought}` : "Reasoning stopped" });
-                    return eventResult();
-                case "reasoning.search_queries":
-                    dispatch({ type: "activity.add", text: `Search queries: ${event.queries.join(", ") || "none"}` });
-                    return eventResult();
-                case "reasoning.search_results":
-                    dispatch({ type: "activity.add", text: `Search results: ${event.count}` });
-                    return eventResult();
-                case "reasoning.fetch_url_queries":
-                    dispatch({ type: "activity.add", text: `Fetch URLs: ${event.urls.join(", ") || "none"}` });
-                    return eventResult();
-                case "reasoning.fetch_url_results":
-                    dispatch({ type: "activity.add", text: `Fetched URL results: ${event.count}` });
-                    return eventResult();
-                case "tool.completed":
-                    dispatch({ type: "activity.add", level: event.status === "failed" ? "error" : "success", text: `Tool completed: ${event.name}${event.status ? ` (${event.status})` : ""}` });
-                    return eventResult();
-                case "local_tool.completed":
-                    dispatch({
-                        type: "activity.add",
-                        level: event.requiresApproval ? "warning" : "success",
-                        text: `Local tool: ${event.name}${event.action ? `.${event.action}` : ""}${event.requiresApproval ? " (approval required)" : ""}`,
-                    });
-                    return eventResult();
-                case "local_tool.approval_requested":
-                    dispatch({
-                        type: "local_tool.pending.set",
-                        approval: {
-                            name: event.name,
-                            action: event.action,
-                            arguments: event.arguments,
-                            preview: event.preview,
-                            callID: event.callID,
-                            responseID: event.responseID,
-                        },
-                    });
-                    dispatch({ type: "message.add", role: "system", text: formatLocalToolApproval(event) });
-                    return eventResult();
-                case "model.requested":
-                    dispatch({ type: "activity.add", text: `Model requested: ${modelLabel(event.model, event.provider)}` });
-                    return eventResult();
-                case "model.completed":
-                    dispatch({ type: "activity.add", level: "success", text: `Model completed: ${modelLabel(event.model, event.provider)}` });
-                    return eventResult();
-                case "model.failed":
-                    dispatch({ type: "activity.add", level: "error", text: `Model failed: ${modelLabel(event.model, event.provider)}` });
-                    return eventResult();
-                case "step.completed":
-                    dispatch({ type: "activity.add", level: "success", text: `Step completed: ${event.stepType || "step"}` });
-                    return eventResult();
-                case "step.failed":
-                    dispatch({ type: "activity.add", level: "error", text: `Step failed: ${event.stepType || "step"}` });
-                    return eventResult();
-                case "raw":
-                    return eventResult();
-            }
-        },
-        submit(input) {
-            const trimmed = input.trim();
-            if (!trimmed)
-                return { kind: "handled" };
-            if (state.pendingLocalTool) {
-                const command = parsePendingApprovalCommand(trimmed);
-                if (command) {
-                    pendingApprovalInvalidInputs = 0;
-                    return { kind: "command", command };
-                }
-                handleInvalidPendingApprovalInput();
-                return { kind: "handled" };
-            }
-            const command = parseWorkbenchCommand(trimmed);
-            if (command)
-                return { kind: "command", command };
-            return { kind: "prompt", prompt: trimmed };
-        },
-    };
-    function handleInvalidPendingApprovalInput() {
-        pendingApprovalInvalidInputs += 1;
-        const attempts = pendingApprovalInvalidInputs;
-        const maxAttempts = 3;
-        if (attempts >= maxAttempts) {
-            dispatch({
-                type: "message.add",
-                role: "system",
-                text: "Local approval aborted after too many invalid inputs. The pending action was not executed.",
-            });
-            dispatch({ type: "activity.add", level: "warning", text: "Local approval aborted" });
-            dispatch({ type: "local_tool.pending.clear" });
-            pendingApprovalInvalidInputs = 0;
-            return;
-        }
-        dispatch({
-            type: "message.add",
-            role: "system",
-            text: `Local approval is pending. Enter /apply or /yes to execute once, /apply-all or /yes-all to allow future local actions, or /reject or /no to discard. Invalid input ${attempts}/${maxAttempts}.`,
-        });
-        dispatch({ type: "activity.add", level: "warning", text: "Waiting for local approval command" });
-    }
-}
-function handled(...effects) {
-    return { handled: true, effects };
-}
-function unhandled() {
-    return { handled: false, effects: [] };
-}
-function eventResult(...effects) {
-    return { effects };
-}
-function modelLabel(model, provider) {
-    if (model && provider)
-        return `${provider}/${model}`;
-    return model || provider || "unknown";
-}
-function formatLocalToolApproval(event) {
-    const label = `${event.name}${event.action ? `.${event.action}` : ""}`;
-    return [
-        `Local action requires approval: ${label}.`,
-        event.preview ? `Preview:\n${formatPreview(event.preview)}` : undefined,
-        "Review it in the workbench, then use /apply to execute once, /apply-all to allow future local actions, or /reject to discard it.",
-    ].filter(Boolean).join("\n\n");
-}
-function formatPreview(preview) {
-    if (typeof preview === "string")
-        return preview;
-    try {
-        return JSON.stringify(preview, null, 2);
-    }
-    catch {
-        return String(preview);
-    }
-}
-function normalizeOptionalSetting(value, clearValues) {
-    const trimmed = value.trim();
-    if (!trimmed)
-        return undefined;
-    return clearValues.includes(trimmed.toLowerCase()) ? undefined : trimmed;
-}

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

@@ -1,44 +0,0 @@
-export interface WorkbenchInputKey {
-    backspace?: boolean;
-    ctrl?: boolean;
-    delete?: boolean;
-    downArrow?: boolean;
-    end?: boolean;
-    escape?: boolean;
-    home?: boolean;
-    meta?: boolean;
-    pageDown?: boolean;
-    pageUp?: boolean;
-    return?: boolean;
-    upArrow?: boolean;
-}
-export type WorkbenchInputEffect = {
-    type: "exit";
-} | {
-    type: "scroll";
-    delta: number;
-} | {
-    type: "scroll_top";
-} | {
-    type: "scroll_bottom";
-} | {
-    type: "abort";
-} | {
-    type: "submit";
-    input: string;
-} | {
-    type: "ignored_busy";
-};
-export interface WorkbenchInputResult {
-    draft: string;
-    effects: WorkbenchInputEffect[];
-}
-export interface WorkbenchInputContext {
-    busy: boolean;
-    draft: string;
-    viewportHeight: number;
-}
-export interface WorkbenchInputController {
-    handle(input: string, key: WorkbenchInputKey, context: WorkbenchInputContext): WorkbenchInputResult;
-}
-export declare function createWorkbenchInputController(): WorkbenchInputController;

package/dist/workbench/input-controller.js

@@ -1,71 +0,0 @@
-import { createInputHistory } from "../tui/workbench.js";
-export function createWorkbenchInputController() {
-    const history = createInputHistory();
-    return {
-        handle(input, key, context) {
-            if (key.ctrl && input === "c")
-                return result(context.draft, { type: "exit" });
-            if (key.pageUp || (key.ctrl && input === "u")) {
-                return result(context.draft, { type: "scroll", delta: Math.max(1, Math.floor(context.viewportHeight / 2)) });
-            }
-            if (key.pageDown || (key.ctrl && input === "d")) {
-                return result(context.draft, { type: "scroll", delta: -Math.max(1, Math.floor(context.viewportHeight / 2)) });
-            }
-            if (key.home)
-                return result(context.draft, { type: "scroll_top" });
-            if (key.end)
-                return result(context.draft, { type: "scroll_bottom" });
-            if (key.upArrow)
-                return result(history.previous(context.draft));
-            if (key.downArrow)
-                return result(history.next(context.draft));
-            if (context.busy) {
-                return handleBusyInput(input, key, context.draft, history);
-            }
-            return handleReadyInput(input, key, context.draft, history);
-        },
-    };
-}
-function handleBusyInput(input, key, draft, history) {
-    if (key.escape)
-        return result(draft, { type: "abort" });
-    if (key.return) {
-        const command = draft.trim();
-        history.record(command);
-        if (command === "/abort" || command === "/cancel")
-            return result("", { type: "abort" });
-        if (command)
-            return result("", { type: "ignored_busy" });
-        return result("");
-    }
-    if (key.backspace || key.delete) {
-        history.reset();
-        return result(draft.slice(0, -1));
-    }
-    if (input && !key.ctrl && !key.meta) {
-        history.reset();
-        return result(draft + input);
-    }
-    return result(draft);
-}
-function handleReadyInput(input, key, draft, history) {
-    if (key.return) {
-        const prompt = draft.trim();
-        if (!prompt)
-            return result(draft);
-        history.record(prompt);
-        return result("", { type: "submit", input: prompt });
-    }
-    if (key.backspace || key.delete) {
-        history.reset();
-        return result(draft.slice(0, -1));
-    }
-    if (input && !key.ctrl && !key.meta) {
-        history.reset();
-        return result(draft + input);
-    }
-    return result(draft);
-}
-function result(draft, ...effects) {
-    return { draft, effects };
-}

package/dist/workbench/isolator-installer.d.ts

@@ -1,29 +0,0 @@
-export interface IsolatorInstallConfig {
-    sourceURL?: string | null;
-    executablePath?: string | null;
-    sha256?: string | null;
-}
-export interface IsolatorInstallResult {
-    executablePath: string;
-    sourceURL: string;
-    bytes: number;
-    sha256: string;
-    replaced: boolean;
-}
-export interface IsolatorEnsureResult {
-    executablePath: string;
-    sourceURL: string;
-    sha256?: string | null;
-    repaired: boolean;
-}
-export interface IsolatorInstallOptions {
-    fetchImpl?: typeof fetch;
-    probeTimeoutMs?: number;
-}
-export declare function installConfiguredIsolator(config: IsolatorInstallConfig, options?: IsolatorInstallOptions): Promise<IsolatorInstallResult>;
-export declare function validateInstalledIsolator(executablePath: string, options?: Pick<IsolatorInstallOptions, "probeTimeoutMs">): Promise<string>;
-export declare function ensureConfiguredIsolator(config: IsolatorInstallConfig, options?: IsolatorInstallOptions): Promise<IsolatorEnsureResult>;
-export declare function relocateInstalledIsolator(fromPath: string, toPath: string, options?: Pick<IsolatorInstallOptions, "probeTimeoutMs">): Promise<string>;
-export declare function defaultIsolatorInstallPath(): string;
-export declare function normalizeSourceURL(value: string | null | undefined): string;
-export declare function normalizeInstallPath(value: string | null | undefined): string;