@agent-api/app-engine 0.0.7 → 0.1.0

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,34 @@ 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.
+
+The root `@agent-api/app-engine` entry is intentionally empty. Use an explicit subpath so your application depends on a clear API layer.
+
 ## 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/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, localToolExecutionErrorResult, 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, localToolExecutionErrorResult, 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/index.d.ts

@@ -1 +1 @@
-export * from "./engine/index.js";
+export {};

package/dist/index.js

@@ -1 +1 @@
-export * from "./engine/index.js";
+export {};

package/dist/terminal.d.ts

@@ -0,0 +1,7 @@
+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 type { TranscriptLine, TranscriptSpan, TranscriptViewModel, } from "./workbench/view-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/view-model.d.ts

@@ -5,6 +5,13 @@ export type TranscriptLine = {
     color?: string;
     bold?: boolean;
     inverse?: boolean;
+    spans?: TranscriptSpan[];
+};
+export type TranscriptSpan = {
+    text: string;
+    color?: string;
+    bold?: boolean;
+    inverse?: boolean;
 };
 export interface TranscriptViewModel {
     lines: TranscriptLine[];

package/dist/workbench/view-model.js

@@ -80,16 +80,85 @@ function markdownTranscriptLine(line, options) {
         return [{ text: "─".repeat(Math.min(48, options.width)), color: "gray" }];
     const bullet = /^(\s*)[-*]\s+(.+)$/.exec(line);
     if (bullet)
-        return wrapTranscriptText(`${bullet[1]}• ${bullet[2]}`, options.width).map((text) => ({ text }));
+        return wrapMarkdownInline(`${bullet[1]}• ${bullet[2]}`, options.width);
     const numbered = /^(\s*)(\d+\.)\s+(.+)$/.exec(line);
     if (numbered)
-        return wrapTranscriptText(`${numbered[1]}${numbered[2]} ${numbered[3]}`, options.width).map((text) => ({ text }));
+        return wrapMarkdownInline(`${numbered[1]}${numbered[2]} ${numbered[3]}`, options.width);
     const quote = /^\s*>\s?(.+)$/.exec(line);
     if (quote)
-        return wrapTranscriptText(`│ ${quote[1]}`, options.width).map((text) => ({ text, color: "gray" }));
-    return wrapTranscriptText(line, options.width).map((text) => ({ text }));
+        return wrapMarkdownInline(`│ ${quote[1]}`, options.width).map((item) => ({ ...item, color: "gray" }));
+    return wrapMarkdownInline(line, options.width);
 }
-function wrapTranscriptText(text, width) {
+function wrapMarkdownInline(text, width) {
+    return wrapTranscriptSpans(markdownInlineSpans(text), width);
+}
+function markdownInlineSpans(text) {
+    const spans = [];
+    const pattern = /(\*\*([^*]+)\*\*)|(\[([^\]]+)\]\(([^)]+)\))/g;
+    let lastIndex = 0;
+    for (const match of text.matchAll(pattern)) {
+        const index = match.index ?? 0;
+        if (index > lastIndex) {
+            spans.push({ text: text.slice(lastIndex, index) });
+        }
+        if (match[2]) {
+            spans.push({ text: match[2], bold: true });
+        }
+        else if (match[4]) {
+            spans.push({ text: match[4], color: "cyan" });
+            if (match[5])
+                spans.push({ text: ` (${match[5]})`, color: "gray" });
+        }
+        lastIndex = index + match[0].length;
+    }
+    if (lastIndex < text.length) {
+        spans.push({ text: text.slice(lastIndex) });
+    }
+    return spans.length > 0 ? spans : [{ text }];
+}
+function wrapTranscriptSpans(spans, width) {
+    const text = spans.map((span) => span.text).join("");
+    const wrapped = wrapTranscriptText(text, width, { trimStart: false });
+    const lines = [];
+    let offset = 0;
+    for (const line of wrapped) {
+        const lineSpans = sliceSpans(spans, offset, line.length);
+        offset += line.length;
+        while (text[offset] === " ")
+            offset += 1;
+        lines.push({
+            text: line,
+            spans: lineSpans.length > 0 ? lineSpans : undefined,
+        });
+    }
+    return lines;
+}
+function sliceSpans(spans, offset, length) {
+    const output = [];
+    let position = 0;
+    let remaining = length;
+    for (const span of spans) {
+        if (remaining <= 0)
+            break;
+        const spanEnd = position + span.text.length;
+        if (spanEnd <= offset) {
+            position = spanEnd;
+            continue;
+        }
+        if (position >= offset + length)
+            break;
+        const start = Math.max(0, offset - position);
+        const end = Math.min(span.text.length, start + remaining);
+        const text = span.text.slice(start, end);
+        if (text) {
+            output.push({ ...span, text });
+            remaining -= text.length;
+        }
+        position = spanEnd;
+    }
+    return output;
+}
+function wrapTranscriptText(text, width, options = {}) {
     const max = Math.max(12, width);
     if (text.length === 0)
         return [""];
@@ -105,7 +174,7 @@ function wrapTranscriptText(text, width) {
         const chunk = useSoftBreak ? soft : hard.text;
         const index = useSoftBreak ? softBreak : hard.length;
         lines.push(chunk.trimEnd());
-        rest = rest.slice(index).trimStart();
+        rest = options.trimStart === false ? rest.slice(index) : rest.slice(index).trimStart();
     }
     lines.push(rest);
     return lines;

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.7",
+  "version": "0.1.0",
   "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": {