@agent-api/app-engine 0.0.6 → 0.0.8

package/README.md

@@ -15,9 +15,9 @@ npm install @agent-api/app-engine
 ```ts
 import {
   configureAgentAppRuntime,
-  createAgentEngine,
-  createWorkbenchAuthController,
-} from "@agent-api/app-engine";
+  loginWithAPIKey,
+  runAgentTurn,
+} from "@agent-api/app-engine/core";
 
 configureAgentAppRuntime({
   appName: "my-agent-app",
@@ -25,17 +25,33 @@ configureAgentAppRuntime({
   appVersion: "1.0.0",
 });
 
-const engine = createAgentEngine();
-const auth = createWorkbenchAuthController();
+await loginWithAPIKey({
+  profile: "default",
+  baseURL: "https://api.agentsway.dev",
+  apiKey: process.env.AGENT_API_KEY!,
+});
+
+const result = await runAgentTurn({
+  profile: "default",
+  promptParts: ["Hello"],
+});
 ```
 
 Host applications should call `configureAgentAppRuntime()` during startup so config, profiles, and runtime files live under the host app's own platform config directory.
 
+## Import Layers
+
+- `@agent-api/app-engine/core`: UI-neutral APIs for auth, config, profiles, conversations, updates, local workdir setup, and agent turns.
+- `@agent-api/app-engine/workbench`: optional app/workbench state controllers for apps that want Agent API's conversation workflow.
+- `@agent-api/app-engine/terminal`: optional terminal-facing helpers for transcript wrapping, input viewport rendering, and spinner glyphs.
+- `@agent-api/app-engine`: compatibility barrel that re-exports the layers above.
+
 ## Boundaries
 
-- This package owns core application state and side effects.
-- Renderers own input widgets, layout, keyboard handling, and screen drawing.
-- The CLI/TUI package should import core behavior from this package rather than from private source paths.
+- Core APIs own application state and side effects.
+- Workbench APIs own reusable conversation/workbench semantics.
+- Terminal APIs are optional helpers for terminal renderers.
+- Renderers own widgets, native input controls, layout, keyboard mapping, and screen drawing.
 
 ## Local Development
 

package/dist/agent/runner.d.ts

@@ -115,3 +115,4 @@ export declare function agentResponseFailureMessage(response: AgentResponse): st
 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;
+export declare function localToolExecutionErrorResult(toolName: string, args: Record<string, unknown>, error: unknown): Record<string, unknown>;

package/dist/agent/runner.js

@@ -425,11 +425,19 @@ async function executeLocalFunctionCalls(response, registry, abortSignal, onEven
     const outputs = [];
     for (const call of pendingFunctionCalls(response)) {
         throwIfAborted(abortSignal);
-        if (!registry.has(call.name)) {
-            throw new Error(`no local handler registered for function ${call.name}`);
+        let args = {};
+        let result;
+        try {
+            args = call.arguments ? JSON.parse(call.arguments) : {};
+            if (!registry.has(call.name)) {
+                throw new Error(`no local handler registered for function ${call.name}`);
+            }
+            result = await registry.execute(call.name, args, abortSignal);
+        }
+        catch (error) {
+            throwIfAborted(abortSignal);
+            result = localToolExecutionErrorResult(call.name, args, error);
         }
-        const args = call.arguments ? JSON.parse(call.arguments) : {};
-        const result = await registry.execute(call.name, args, abortSignal);
         throwIfAborted(abortSignal);
         const action = typeof result.action === "string"
             ? result.action
@@ -461,11 +469,34 @@ async function executeLocalFunctionCalls(response, registry, abortSignal, onEven
     }
     return { outputs };
 }
+export function localToolExecutionErrorResult(toolName, args, error) {
+    return {
+        ok: false,
+        tool: toolName,
+        action: typeof args.action === "string" ? args.action : undefined,
+        error: {
+            message: userFacingError(error),
+            name: error instanceof Error ? error.name : undefined,
+            code: errorCode(error),
+        },
+    };
+}
 function throwIfAborted(signal) {
     if (!signal?.aborted)
         return;
     throw new Error("Agent turn aborted.");
 }
+function userFacingError(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function errorCode(error) {
+    if (typeof error !== "object" || error === null)
+        return undefined;
+    const code = error.code;
+    return typeof code === "string" || typeof code === "number" ? code : undefined;
+}
 function requestAbortOptions(signal) {
     return signal ? { signal } : undefined;
 }

package/dist/agent.d.ts

@@ -1,2 +1,2 @@
-export { type AgentRunOptions, type AgentTurnEvent, type AgentTurnResult, type LocalToolApprovalRequest, type WorkdirAccessMode, agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, isAvailablePreset, listAvailablePresets, resolveAgentRequestTools, resumeAgentAfterLocalApproval, runAgent, runAgentTurn, } from "./agent/runner.js";
+export { type AgentRunOptions, type AgentTurnEvent, type AgentTurnResult, type LocalToolApprovalRequest, type WorkdirAccessMode, agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, isAvailablePreset, listAvailablePresets, localToolExecutionErrorResult, resolveAgentRequestTools, resumeAgentAfterLocalApproval, runAgent, runAgentTurn, } from "./agent/runner.js";
 export { conversationSummary, deleteConversation, ensureConversation, getConversation, listConversations, startFreshConversation, } from "./conversation/index.js";

package/dist/agent.js

@@ -1,2 +1,2 @@
-export { agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, isAvailablePreset, listAvailablePresets, resolveAgentRequestTools, resumeAgentAfterLocalApproval, runAgent, runAgentTurn, } from "./agent/runner.js";
+export { agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, isAvailablePreset, listAvailablePresets, localToolExecutionErrorResult, resolveAgentRequestTools, resumeAgentAfterLocalApproval, runAgent, runAgentTurn, } from "./agent/runner.js";
 export { conversationSummary, deleteConversation, ensureConversation, getConversation, listConversations, startFreshConversation, } from "./conversation/index.js";

package/dist/core.d.ts

@@ -0,0 +1,17 @@
+export type { AgentEngineApp, AgentEngineAppOptions, AgentEngineLifecycleOptions, } from "./engine/agent-engine.js";
+export { createAgentEngine, } from "./engine/agent-engine.js";
+export type { AgentRunOptions, AgentTurnEvent, AgentTurnResult, LocalToolApprovalRequest, WorkdirAccessMode, } from "./agent.js";
+export { agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, conversationSummary, deleteConversation, ensureConversation, getConversation, isAvailablePreset, listAvailablePresets, listConversations, localToolExecutionErrorResult, resolveAgentRequestTools, resumeAgentAfterLocalApproval, runAgent, runAgentTurn, startFreshConversation, } from "./agent.js";
+export type { ChatOptions } from "./chat-options.js";
+export { normalizeChatOptions } from "./chat-options.js";
+export type { AgentEngineServices } from "./engine/services.js";
+export { defaultBaseURL } from "./config.js";
+export type { AuthProfile, ConversationState, Profile, WorkbenchPreferences, } from "./config.js";
+export { activeProfile, loadAppConfiguration, loadConfig, loadConversationConfiguration, loadWorkbenchPreferences, redactSecret, saveAppConfiguration, saveConfig, saveConversationConfiguration, updateWorkbenchPreferences, } from "./config.js";
+export type { AuthStatus, RuntimeProfile, } from "./profile.js";
+export { AuthSessionExpiredError, browserAccessTokenExpiresWithin, deleteProfile, formatDeviceUserCode, getAuthStatus, listProfiles, loginWithAPIKey, loginWithBrowser, openBrowserURL, profileSummary, refreshActiveProfileIfNeeded, refreshBrowserSession, refreshIfNeeded, resolveRuntimeProfile, saveBrowserProfile, startBrowserAuthChallenge, useProfile, waitForBrowserAuthChallenge, } from "./profile.js";
+export { appVersion, configureAgentAppRuntime, currentAgentAppRuntime, defaultAppAuthor, defaultAppName, defaultAppVersion, ensureRuntime, runtime, } from "./runtime/index.js";
+export type { AgentAppRuntimeContext, AgentAppRuntimeOptions, } from "./runtime/index.js";
+export { checkForUpdate, compareVersions, formatUpdateNotice, } from "./update.js";
+export type { WorkdirContextOptions, WorkdirOptions, WorkdirService, } from "./workdir/index.js";
+export { buildWorkdirContextBlock, openWorkdir, } from "./workdir/index.js";

package/dist/core.js

@@ -0,0 +1,9 @@
+export { createAgentEngine, } from "./engine/agent-engine.js";
+export { agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, conversationSummary, deleteConversation, ensureConversation, getConversation, isAvailablePreset, listAvailablePresets, listConversations, localToolExecutionErrorResult, resolveAgentRequestTools, resumeAgentAfterLocalApproval, runAgent, runAgentTurn, startFreshConversation, } from "./agent.js";
+export { normalizeChatOptions } from "./chat-options.js";
+export { defaultBaseURL } from "./config.js";
+export { activeProfile, loadAppConfiguration, loadConfig, loadConversationConfiguration, loadWorkbenchPreferences, redactSecret, saveAppConfiguration, saveConfig, saveConversationConfiguration, updateWorkbenchPreferences, } from "./config.js";
+export { AuthSessionExpiredError, browserAccessTokenExpiresWithin, deleteProfile, formatDeviceUserCode, getAuthStatus, listProfiles, loginWithAPIKey, loginWithBrowser, openBrowserURL, profileSummary, refreshActiveProfileIfNeeded, refreshBrowserSession, refreshIfNeeded, resolveRuntimeProfile, saveBrowserProfile, startBrowserAuthChallenge, useProfile, waitForBrowserAuthChallenge, } from "./profile.js";
+export { appVersion, configureAgentAppRuntime, currentAgentAppRuntime, defaultAppAuthor, defaultAppName, defaultAppVersion, ensureRuntime, runtime, } from "./runtime/index.js";
+export { checkForUpdate, compareVersions, formatUpdateNotice, } from "./update.js";
+export { buildWorkdirContextBlock, openWorkdir, } from "./workdir/index.js";

package/dist/engine/index.d.ts

@@ -1,50 +1,3 @@
-export type { AgentEngineApp, AgentEngineAppOptions, AgentEngineLifecycleOptions, } from "./agent-engine.js";
-export { createAgentEngine, } from "./agent-engine.js";
-export type { AgentRunOptions, AgentTurnEvent, LocalToolApprovalRequest, WorkdirAccessMode, } from "../agent.js";
-export { agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, conversationSummary, deleteConversation, ensureConversation, getConversation, isAvailablePreset, listAvailablePresets, listConversations, resumeAgentAfterLocalApproval, runAgent, resolveAgentRequestTools, runAgentTurn, startFreshConversation, } from "../agent.js";
-export type { ChatOptions } from "../chat-options.js";
-export { normalizeChatOptions } from "../chat-options.js";
-export type { AgentEngineServices } from "./services.js";
-export { defaultBaseURL } from "../config.js";
-export type { AuthProfile, ConversationState, Profile, WorkbenchPreferences, } from "../config.js";
-export { activeProfile, loadAppConfiguration, loadConfig, loadConversationConfiguration, loadWorkbenchPreferences, redactSecret, saveAppConfiguration, saveConfig, saveConversationConfiguration, updateWorkbenchPreferences, } from "../config.js";
-export type { AuthStatus, RuntimeProfile, } from "../profile.js";
-export { AuthSessionExpiredError, browserAccessTokenExpiresWithin, deleteProfile, formatDeviceUserCode, getAuthStatus, listProfiles, loginWithAPIKey, loginWithBrowser, openBrowserURL, profileSummary, refreshActiveProfileIfNeeded, refreshBrowserSession, refreshIfNeeded, resolveRuntimeProfile, saveBrowserProfile, startBrowserAuthChallenge, useProfile, waitForBrowserAuthChallenge, } from "../profile.js";
-export { appVersion, configureAgentAppRuntime, currentAgentAppRuntime, defaultAppAuthor, defaultAppName, defaultAppVersion, ensureRuntime, runtime, } from "../runtime/index.js";
-export type { AgentAppRuntimeContext, AgentAppRuntimeOptions, } from "../runtime/index.js";
-export { checkForUpdate, compareVersions, formatUpdateNotice, } from "../update.js";
-export type { WorkdirContextOptions, WorkdirOptions, WorkdirService, } from "../workdir/index.js";
-export { buildWorkdirContextBlock, openWorkdir, } from "../workdir/index.js";
-export type { WorkbenchAuthController } from "../workbench/auth-controller.js";
-export { authStatusText, createWorkbenchAuthController, } from "../workbench/auth-controller.js";
-export type { AuthGateState, WorkbenchAuthGateController, } from "../workbench/auth-gate-controller.js";
-export { authMethods, createWorkbenchAuthGateController, } from "../workbench/auth-gate-controller.js";
-export type { WorkbenchCommandController } from "../workbench/command-controller.js";
-export { createWorkbenchCommandController } from "../workbench/command-controller.js";
-export type { WorkbenchConversationController } from "../workbench/conversation-controller.js";
-export { createConversationName, createWorkbenchConversationController, defaultTranscriptExportPath, } from "../workbench/conversation-controller.js";
-export type { WorkbenchEngine, WorkbenchSubmission, } from "../workbench/engine.js";
-export { createWorkbenchEngine } from "../workbench/engine.js";
-export type { WorkbenchInputController } from "../workbench/input-controller.js";
-export { createWorkbenchInputController } from "../workbench/input-controller.js";
-export type { IsolatorInstallConfig, IsolatorInstallOptions, IsolatorInstallResult, } from "../workbench/isolator-installer.js";
-export { defaultIsolatorInstallPath, ensureConfiguredIsolator, installConfiguredIsolator, normalizeInstallTargetPath, normalizeInstallPath, normalizeSourceURL, relocateInstalledIsolator, validateIsolatorInstallTarget, validateInstalledIsolator, } from "../workbench/isolator-installer.js";
-export type { WorkbenchLifecycleController, WorkbenchLifecycleEffect, } from "../workbench/lifecycle-controller.js";
-export { createWorkbenchLifecycleController, updateNoticeEffects, } from "../workbench/lifecycle-controller.js";
-export type { WorkbenchLocalController } from "../workbench/local-controller.js";
-export { createWorkbenchLocalController } from "../workbench/local-controller.js";
-export type { WorkbenchRenderModel } from "../workbench/render-model.js";
-export { buildWorkbenchRenderModel, busySpinner, pendingLocalLabel, } from "../workbench/render-model.js";
-export type { WorkbenchRuntimeController } from "../workbench/runtime-controller.js";
-export { createWorkbenchRuntimeController } from "../workbench/runtime-controller.js";
-export type { WorkbenchSession, WorkbenchSessionOptions, } from "../workbench/session.js";
-export { createWorkbenchSession, sessionState, } from "../workbench/session.js";
-export type { WorkbenchSettingsController, WorkbenchSettingsSnapshot, } from "../workbench/settings-controller.js";
-export { createWorkbenchSettingsController, formatPresetList, UnknownPresetError, } from "../workbench/settings-controller.js";
-export type { ShellIsolationMode, ShellIsolationPreferences, } from "../workbench/shell-isolation.js";
-export { localShellIsolationOptions } from "../workbench/shell-isolation.js";
-export type { WorkbenchTurnController } from "../workbench/turn-controller.js";
-export { createWorkbenchTurnController } from "../workbench/turn-controller.js";
-export { buildTranscriptLines, buildTranscriptViewModel, elapsedDots, spinnerGlyph, } from "../workbench/view-model.js";
-export type { ActivityLevel, InputHistory, LocalToolApproval, RenderMode, WorkbenchAction, WorkbenchActivity, WorkbenchCommand, WorkbenchMessage, WorkbenchRole, WorkbenchState, WorkbenchWorkdirStatus, } from "../workbench/state.js";
-export { activityColor, createInitialWorkbenchState, createInputHistory, formatTranscript, formatTranscriptPreview, helpText, parsePendingApprovalCommand, parseWorkbenchCommand, workbenchReducer, workdirText, } from "../workbench/state.js";
+export * from "../core.js";
+export * from "../workbench.js";
+export * from "../terminal.js";

package/dist/engine/index.js

@@ -1,26 +1,3 @@
-export { createAgentEngine, } from "./agent-engine.js";
-export { agentResponseFailureMessage, agentTurnEventFromStreamEvent, clearPresetToolCatalogCache, conversationSummary, deleteConversation, ensureConversation, getConversation, isAvailablePreset, listAvailablePresets, listConversations, resumeAgentAfterLocalApproval, runAgent, resolveAgentRequestTools, runAgentTurn, startFreshConversation, } from "../agent.js";
-export { normalizeChatOptions } from "../chat-options.js";
-export { defaultBaseURL } from "../config.js";
-export { activeProfile, loadAppConfiguration, loadConfig, loadConversationConfiguration, loadWorkbenchPreferences, redactSecret, saveAppConfiguration, saveConfig, saveConversationConfiguration, updateWorkbenchPreferences, } from "../config.js";
-export { AuthSessionExpiredError, browserAccessTokenExpiresWithin, deleteProfile, formatDeviceUserCode, getAuthStatus, listProfiles, loginWithAPIKey, loginWithBrowser, openBrowserURL, profileSummary, refreshActiveProfileIfNeeded, refreshBrowserSession, refreshIfNeeded, resolveRuntimeProfile, saveBrowserProfile, startBrowserAuthChallenge, useProfile, waitForBrowserAuthChallenge, } from "../profile.js";
-export { appVersion, configureAgentAppRuntime, currentAgentAppRuntime, defaultAppAuthor, defaultAppName, defaultAppVersion, ensureRuntime, runtime, } from "../runtime/index.js";
-export { checkForUpdate, compareVersions, formatUpdateNotice, } from "../update.js";
-export { buildWorkdirContextBlock, openWorkdir, } from "../workdir/index.js";
-export { authStatusText, createWorkbenchAuthController, } from "../workbench/auth-controller.js";
-export { authMethods, createWorkbenchAuthGateController, } from "../workbench/auth-gate-controller.js";
-export { createWorkbenchCommandController } from "../workbench/command-controller.js";
-export { createConversationName, createWorkbenchConversationController, defaultTranscriptExportPath, } from "../workbench/conversation-controller.js";
-export { createWorkbenchEngine } from "../workbench/engine.js";
-export { createWorkbenchInputController } from "../workbench/input-controller.js";
-export { defaultIsolatorInstallPath, ensureConfiguredIsolator, installConfiguredIsolator, normalizeInstallTargetPath, normalizeInstallPath, normalizeSourceURL, relocateInstalledIsolator, validateIsolatorInstallTarget, validateInstalledIsolator, } from "../workbench/isolator-installer.js";
-export { createWorkbenchLifecycleController, updateNoticeEffects, } from "../workbench/lifecycle-controller.js";
-export { createWorkbenchLocalController } from "../workbench/local-controller.js";
-export { buildWorkbenchRenderModel, busySpinner, pendingLocalLabel, } from "../workbench/render-model.js";
-export { createWorkbenchRuntimeController } from "../workbench/runtime-controller.js";
-export { createWorkbenchSession, sessionState, } from "../workbench/session.js";
-export { createWorkbenchSettingsController, formatPresetList, UnknownPresetError, } from "../workbench/settings-controller.js";
-export { localShellIsolationOptions } from "../workbench/shell-isolation.js";
-export { createWorkbenchTurnController } from "../workbench/turn-controller.js";
-export { buildTranscriptLines, buildTranscriptViewModel, elapsedDots, spinnerGlyph, } from "../workbench/view-model.js";
-export { activityColor, createInitialWorkbenchState, createInputHistory, formatTranscript, formatTranscriptPreview, helpText, parsePendingApprovalCommand, parseWorkbenchCommand, workbenchReducer, workdirText, } from "../workbench/state.js";
+export * from "../core.js";
+export * from "../workbench.js";
+export * from "../terminal.js";

package/dist/terminal.d.ts

@@ -0,0 +1,6 @@
+export type { WorkbenchInputController } from "./workbench/input-controller.js";
+export { createWorkbenchInputController } from "./workbench/input-controller.js";
+export type { WorkbenchRenderModel } from "./workbench/render-model.js";
+export { buildWorkbenchRenderModel, busySpinner, pendingLocalLabel, } from "./workbench/render-model.js";
+export { buildTranscriptLines, buildTranscriptViewModel, elapsedDots, spinnerGlyph, } from "./workbench/view-model.js";
+export { activityColor } from "./workbench/state.js";

package/dist/terminal.js

@@ -0,0 +1,4 @@
+export { createWorkbenchInputController } from "./workbench/input-controller.js";
+export { buildWorkbenchRenderModel, busySpinner, pendingLocalLabel, } from "./workbench/render-model.js";
+export { buildTranscriptLines, buildTranscriptViewModel, elapsedDots, spinnerGlyph, } from "./workbench/view-model.js";
+export { activityColor } from "./workbench/state.js";

package/dist/workbench/render-model.d.ts

@@ -30,6 +30,7 @@ export interface WorkbenchRenderModel {
         draft: string;
         fullAccess: boolean;
         label: string;
+        viewportColumns: number;
         waitingText: string;
     };
     terminalColumns: number;

package/dist/workbench/render-model.js

@@ -16,9 +16,10 @@ export function buildWorkbenchRenderModel(input) {
         width: transcriptWidth,
     });
     const cursor = Math.max(0, Math.min(input.draft.length, input.cursor ?? input.draft.length));
-    const beforeCursor = input.draft.slice(0, cursor);
-    const cursorText = input.draft[cursor] ?? " ";
-    const afterCursor = input.draft.slice(cursor + (cursor < input.draft.length ? 1 : 0));
+    const fullAccess = input.state.accessMode === "full";
+    const label = input.state.busy ? "working" : "you";
+    const inputViewportColumns = Math.max(12, terminalColumns - 10 - label.length - (fullAccess ? 14 : 0));
+    const inputViewport = inputViewportText(input.draft, cursor, inputViewportColumns);
     return {
         activityHeight,
         footerText: [
@@ -43,14 +44,15 @@ export function buildWorkbenchRenderModel(input) {
             workdir: input.state.workdir?.root || input.workdirFallback,
         },
         input: {
-            afterCursor,
-            beforeCursor,
+            afterCursor: inputViewport.afterCursor,
+            beforeCursor: inputViewport.beforeCursor,
             busy: input.state.busy,
             cursor,
-            cursorText,
+            cursorText: inputViewport.cursorText,
             draft: input.draft,
-            fullAccess: input.state.accessMode === "full",
-            label: input.state.busy ? "working" : "you",
+            fullAccess,
+            label,
+            viewportColumns: inputViewportColumns,
             waitingText: `waiting for agent ${elapsedDots(input.spinnerFrame)}`,
         },
         terminalColumns,
@@ -70,3 +72,30 @@ export function pendingLocalLabel(state) {
 export function busySpinner(frame) {
     return spinnerGlyph(frame);
 }
+function inputViewportText(draft, cursor, maxColumns) {
+    if (draft.length === 0) {
+        return { beforeCursor: "", cursorText: " ", afterCursor: "" };
+    }
+    const fullWidth = Math.max(1, maxColumns - (cursor >= draft.length ? 1 : 0));
+    if (draft.length <= fullWidth) {
+        return {
+            beforeCursor: draft.slice(0, cursor),
+            cursorText: draft[cursor] ?? " ",
+            afterCursor: draft.slice(cursor + (cursor < draft.length ? 1 : 0)),
+        };
+    }
+    const windowColumns = Math.max(4, maxColumns - 3);
+    const maxStart = Math.max(0, draft.length - windowColumns);
+    const preferredStart = cursor >= draft.length
+        ? maxStart
+        : Math.max(0, cursor - Math.floor(windowColumns * 0.65));
+    const start = Math.min(preferredStart, maxStart);
+    const end = Math.min(draft.length, start + windowColumns);
+    const visibleCursor = Math.max(start, Math.min(cursor, end));
+    const hasLeft = start > 0;
+    const hasRight = end < draft.length;
+    const beforeCursor = `${hasLeft ? "‹" : ""}${draft.slice(start, visibleCursor)}`;
+    const cursorText = draft[visibleCursor] ?? " ";
+    const afterCursor = `${draft.slice(visibleCursor + (visibleCursor < draft.length ? 1 : 0), end)}${hasRight ? "›" : ""}`;
+    return { beforeCursor, cursorText, afterCursor };
+}

package/dist/workbench.d.ts

@@ -0,0 +1,28 @@
+export type { WorkbenchAuthController } from "./workbench/auth-controller.js";
+export { authStatusText, createWorkbenchAuthController, } from "./workbench/auth-controller.js";
+export type { AuthGateState, WorkbenchAuthGateController, } from "./workbench/auth-gate-controller.js";
+export { authMethods, createWorkbenchAuthGateController, } from "./workbench/auth-gate-controller.js";
+export type { WorkbenchCommandController } from "./workbench/command-controller.js";
+export { createWorkbenchCommandController } from "./workbench/command-controller.js";
+export type { WorkbenchConversationController } from "./workbench/conversation-controller.js";
+export { createConversationName, createWorkbenchConversationController, defaultTranscriptExportPath, } from "./workbench/conversation-controller.js";
+export type { WorkbenchEngine, WorkbenchSubmission, } from "./workbench/engine.js";
+export { createWorkbenchEngine } from "./workbench/engine.js";
+export type { IsolatorInstallConfig, IsolatorInstallOptions, IsolatorInstallResult, } from "./workbench/isolator-installer.js";
+export { defaultIsolatorInstallPath, ensureConfiguredIsolator, installConfiguredIsolator, normalizeInstallTargetPath, normalizeInstallPath, normalizeSourceURL, relocateInstalledIsolator, validateIsolatorInstallTarget, validateInstalledIsolator, } from "./workbench/isolator-installer.js";
+export type { WorkbenchLifecycleController, WorkbenchLifecycleEffect, } from "./workbench/lifecycle-controller.js";
+export { createWorkbenchLifecycleController, updateNoticeEffects, } from "./workbench/lifecycle-controller.js";
+export type { WorkbenchLocalController } from "./workbench/local-controller.js";
+export { createWorkbenchLocalController } from "./workbench/local-controller.js";
+export type { WorkbenchRuntimeController } from "./workbench/runtime-controller.js";
+export { createWorkbenchRuntimeController } from "./workbench/runtime-controller.js";
+export type { WorkbenchSession, WorkbenchSessionOptions, } from "./workbench/session.js";
+export { createWorkbenchSession, sessionState, } from "./workbench/session.js";
+export type { WorkbenchSettingsController, WorkbenchSettingsSnapshot, } from "./workbench/settings-controller.js";
+export { createWorkbenchSettingsController, formatPresetList, UnknownPresetError, } from "./workbench/settings-controller.js";
+export type { ShellIsolationMode, ShellIsolationPreferences, } from "./workbench/shell-isolation.js";
+export { localShellIsolationOptions } from "./workbench/shell-isolation.js";
+export type { WorkbenchTurnController } from "./workbench/turn-controller.js";
+export { createWorkbenchTurnController } from "./workbench/turn-controller.js";
+export type { ActivityLevel, InputHistory, LocalToolApproval, RenderMode, WorkbenchAction, WorkbenchActivity, WorkbenchCommand, WorkbenchMessage, WorkbenchRole, WorkbenchState, WorkbenchWorkdirStatus, } from "./workbench/state.js";
+export { createInitialWorkbenchState, createInputHistory, formatTranscript, formatTranscriptPreview, helpText, parsePendingApprovalCommand, parseWorkbenchCommand, workbenchReducer, workdirText, } from "./workbench/state.js";

package/dist/workbench.js

@@ -0,0 +1,14 @@
+export { authStatusText, createWorkbenchAuthController, } from "./workbench/auth-controller.js";
+export { authMethods, createWorkbenchAuthGateController, } from "./workbench/auth-gate-controller.js";
+export { createWorkbenchCommandController } from "./workbench/command-controller.js";
+export { createConversationName, createWorkbenchConversationController, defaultTranscriptExportPath, } from "./workbench/conversation-controller.js";
+export { createWorkbenchEngine } from "./workbench/engine.js";
+export { defaultIsolatorInstallPath, ensureConfiguredIsolator, installConfiguredIsolator, normalizeInstallTargetPath, normalizeInstallPath, normalizeSourceURL, relocateInstalledIsolator, validateIsolatorInstallTarget, validateInstalledIsolator, } from "./workbench/isolator-installer.js";
+export { createWorkbenchLifecycleController, updateNoticeEffects, } from "./workbench/lifecycle-controller.js";
+export { createWorkbenchLocalController } from "./workbench/local-controller.js";
+export { createWorkbenchRuntimeController } from "./workbench/runtime-controller.js";
+export { createWorkbenchSession, sessionState, } from "./workbench/session.js";
+export { createWorkbenchSettingsController, formatPresetList, UnknownPresetError, } from "./workbench/settings-controller.js";
+export { localShellIsolationOptions } from "./workbench/shell-isolation.js";
+export { createWorkbenchTurnController } from "./workbench/turn-controller.js";
+export { createInitialWorkbenchState, createInputHistory, formatTranscript, formatTranscriptPreview, helpText, parsePendingApprovalCommand, parseWorkbenchCommand, workbenchReducer, workdirText, } from "./workbench/state.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/app-engine",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Renderer-neutral application engine for Agent API apps",
   "license": "MIT",
   "homepage": "https://github.com/scalebox-dev/agent-tui#readme",
@@ -18,6 +18,18 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./workbench": {
+      "types": "./dist/workbench.d.ts",
+      "import": "./dist/workbench.js"
+    },
+    "./terminal": {
+      "types": "./dist/terminal.d.ts",
+      "import": "./dist/terminal.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -29,7 +41,7 @@
     "pack:local": "npm pack --pack-destination ./artifacts"
   },
   "dependencies": {
-    "@agent-api/sdk": "^1.3.0",
+    "@agent-api/sdk": "^1.3.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {