@timurproko/a1 0.1.8-dev.472 → 0.1.8-dev.508

package/dist/composition/owned-ui.js

@@ -7,10 +7,9 @@ import { resolvePromptHistoryDataDir } from "../features/launch/profile-paths.js
 import { resolveProductPaths } from "../foundation/lifecycle/paths.js";
 import { applyConfiguredPiTheme, getAvailablePiThemes } from "../integrations/pi/components/upstream/theme/theme.js";
 import { createPiEngineAdapter } from "../integrations/pi/engine/adapter.js";
-import { ClipboardDiagnosticCapture } from "../integrations/pi/session-ui/clipboard-diagnostics.js";
-import { OwnedUiSessionShell } from "../integrations/pi/session-ui/session-shell.js";
-import { OwnedUiSettingsSession } from "../ui/settings/session.js";
-import { OwnedUiSettingsStore } from "../ui/settings/store.js";
+import { ClipboardDiagnosticCapture } from "../app/session-shell/clipboard-diagnostics.js";
+import { OwnedUiSessionShell } from "../app/session-shell/session-shell.js";
+import { OwnedSettingsManager } from "../ui/settings/manager.js";
 import { createPiTerminalBridge } from "../integrations/pi/tui-runtime/presentation-adapter.js";
 import { createOwnedRouteHost } from "./settings-route-host.js";
 export async function composeOwnedUiApplication(options = {}) {
@@ -32,8 +31,9 @@ export async function composeOwnedUi(options = {}) {
     const ownedSurfaces = options.ownedSurfaces !== "off";
     const settings = options.profileId === undefined
         ? null
-        : new OwnedUiSettingsSession({
-            store: new OwnedUiSettingsStore({ configDir: resolveProductPaths().configDir, profileId: options.profileId }),
+        : new OwnedSettingsManager({
+            configDir: resolveProductPaths().configDir,
+            profileId: options.profileId,
             agentProvider: () => adapter.settingsPort(),
         });
     // Compatibility: bare A1 intentionally ships one visual target while its UI is being completed:
@@ -51,11 +51,11 @@ export async function composeOwnedUi(options = {}) {
     const promptSuggestions = settings === null || !ownedSurfaces ? null : {
         ...(suggestionDiagnostics === null ? {} : { diagnostics: suggestionDiagnostics }),
         generator: adapter,
-        enabled: () => settings.value("promptSuggestions") !== false,
-        onChange: (listener) => settings.onChange(() => listener(settings.value("promptSuggestions") !== false)),
+        enabled: () => settings.value("promptSuggestions"),
+        onChange: (listener) => settings.onChange(() => listener(settings.value("promptSuggestions"))),
     };
     const historyLimit = settings?.value("promptHistoryMaxItems");
-    const historyProfileLocation = settings === null || !ownedSurfaces || settings.value("promptHistoryEnabled") === false
+    const historyProfileLocation = settings === null || !ownedSurfaces || !settings.value("promptHistoryEnabled")
         ? null
         : resolvePromptHistoryPath(resolvePromptHistoryDataDir(), adapter.agentDir);
     const promptHistory = historyProfileLocation === null ? null : {
@@ -73,22 +73,26 @@ export async function composeOwnedUi(options = {}) {
     let shell;
     try {
         shell = new OwnedUiSessionShell({
-            backend: adapter,
-            cwd: adapter.cwd,
-            ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-            ...(routeHost === null ? {} : { routeHost }),
-            ...(ownedSurfaces ? { sessionLayout: "custom-viewport" } : {}),
-            ...(clipboardDiagnostics === null ? {} : {
-                responseCopy: { onEvent: event => clipboardDiagnostics.copy(event) },
-                pasteDiagnostics: event => clipboardDiagnostics.paste(event),
-                inputPresentation: { onEvent: event => clipboardDiagnostics.runtime(event) },
-            }),
-            ...(viewportSettings === null ? {} : { viewportSettings }),
-            ...(settings === null || !ownedSurfaces ? {} : {
-                quitOutro: { snapshot: () => quitOutroSettingsSnapshot(settings), interactive: process.stdout.isTTY === true },
-            }),
-            ...(promptSuggestions === null ? {} : { promptSuggestions }),
-            ...(promptHistory === null ? {} : { promptHistory: {
+            engine: {
+                backend: adapter,
+                cwd: adapter.cwd,
+                ...(routeHost === null ? {} : { routeHost }),
+                ...(ownedSurfaces ? { sessionLayout: "custom-viewport" } : {}),
+            },
+            presentation: {
+                ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
+                ...(clipboardDiagnostics === null ? {} : { input: { onEvent: event => clipboardDiagnostics.runtime(event) } }),
+                ...(viewportSettings === null ? {} : { viewportSettings }),
+                ...(settings === null || !ownedSurfaces ? {} : {
+                    quitOutro: { snapshot: () => quitOutroSettingsSnapshot(settings), interactive: process.stdout.isTTY === true },
+                }),
+            },
+            ...(clipboardDiagnostics === null ? {} : { diagnostics: {
+                    responseCopy: { onEvent: event => clipboardDiagnostics.copy(event) },
+                    paste: event => clipboardDiagnostics.paste(event),
+                } }),
+            ...(promptSuggestions === null ? {} : { suggestions: promptSuggestions }),
+            ...(promptHistory === null ? {} : { history: {
                     ...promptHistory,
                     editor: await import("../integrations/pi/components/history-editor-loader.js").then(module => module.loadHistoryEditor()),
                 } }),
@@ -117,21 +121,16 @@ export async function composeOwnedUi(options = {}) {
     return { application, settings };
 }
 function quitOutroSettingsSnapshot(settings) {
-    const effect = settings.value("quitEffect");
-    const durationMs = settings.value("quitEffectDurationMs");
     return {
-        enabled: settings.value("quitAnimation") !== false,
-        effect: effect === "dissolve" || effect === "starburst" || effect === "waves" ? effect : "fall",
-        durationMs: typeof durationMs === "number" ? durationMs : 800,
+        enabled: settings.value("quitAnimation"),
+        effect: settings.value("quitEffect"),
+        durationMs: settings.value("quitEffectDurationMs"),
     };
 }
 function viewportSettingsSnapshot(settings) {
-    const appearance = settings.value("scrollbarAppearance");
-    const style = settings.value("scrollbarStyle");
-    const speed = settings.value("scrollbarSpeed");
     return {
-        scrollbarAppearance: appearance === "always" || appearance === "hidden" ? appearance : "auto",
-        scrollbarStyle: style === "thick" ? "thick" : "thin",
-        scrollbarSpeed: speed === "high" ? "high" : speed === "fast" ? "fast" : "normal",
+        scrollbarAppearance: settings.value("scrollbarAppearance"),
+        scrollbarStyle: settings.value("scrollbarStyle"),
+        scrollbarSpeed: settings.value("scrollbarSpeed"),
     };
 }

package/dist/composition/settings-route-host.d.ts

@@ -1,7 +1,7 @@
-import type { OwnedUiSettingsSession } from "../ui/settings/session.js";
+import type { OwnedSettingsManager } from "../ui/settings/manager.js";
 import type { UiRouteHost } from "../ui/apps/contracts.js";
 /**
  * Declares the A1-owned settings route without evaluating its presentation graph
  * during startup. Opening the route retains input while the optional module loads.
  */
-export declare function createOwnedRouteHost(settings: OwnedUiSettingsSession): UiRouteHost;
+export declare function createOwnedRouteHost(settings: OwnedSettingsManager): UiRouteHost;

package/dist/contracts/agent-engine/domain.d.ts

@@ -95,7 +95,12 @@ export interface AgentSettingFlag {
     readonly label: string;
     readonly description: string;
     /** Value to show when the stored object says nothing about this flag. */
-    readonly fallback: boolean;
+    readonly fallback: boolean | string;
+    /**
+     * The values a keyed part may take, when it is a choice rather than a toggle. The first
+     * choice equal to `fallback` means "unset": writing it removes the key from the record.
+     */
+    readonly choices?: readonly string[];
 }
 export interface AgentResourceDescriptor {
     readonly id: string;

package/dist/contracts/agent-engine/index.d.ts

@@ -1,8 +1,11 @@
-export * from "./capability-ports.js";
-export * from "./domain.js";
-export * from "./domain-validation.js";
-export * from "./model.js";
-export * from "./package-ports.js";
-export * from "./ports.js";
-export * from "./validation.js";
-export * from "./serialization.js";
+export { assertAgentServicePorts } from "./capability-ports.js";
+export type { AgentAuthenticationPort, AgentExtensionBinding, AgentExtensionCommand, AgentExtensionFailure, AgentExtensionPort, AgentModelPort, AgentResourcesPort, AgentServicePorts, AgentSessionMetadata, AgentSettingsPort, AgentWorkflowDescriptor, AgentWorkflowPort, } from "./capability-ports.js";
+export type { AgentDomainCapabilities, AgentFailure, AgentFailureCategory, AgentJsonValue, AgentMessage, AgentMessageContent, AgentModelDescriptor, AgentResourceDescriptor, AgentSettingApplicationBoundary, AgentSettingChangeOutcome, AgentSettingDescriptor, AgentSettingFlag, AgentSettingOwner, AgentThemeDescriptor, AgentToolDescriptor, AgentUiContribution, AgentUsage, } from "./domain.js";
+export { assertAgentDomainCapabilities, assertAgentFailure, assertAgentMessage, assertAgentMessageContent, assertAgentModelDescriptor, assertAgentResourceDescriptor, assertAgentSettingDescriptor, assertAgentThemeDescriptor, assertAgentToolDescriptor, assertAgentUiContribution, assertAgentUsage, } from "./domain-validation.js";
+export { AGENT_ENGINE_CONTRACT_VERSION } from "./model.js";
+export type { AgentCapabilityContract, AgentCommand, AgentCommandCapability, AgentCommandId, AgentCommandOutcome, AgentEvent, AgentEventCapability, AgentEventSequence, AgentSessionId, AgentSessionLifecycle, AgentSnapshot, } from "./model.js";
+export { agentPackageOutcome, assertAgentPackagesPort } from "./package-ports.js";
+export type { AgentPackageDescriptor, AgentPackageDiagnostic, AgentPackageOperation, AgentPackageOutcome, AgentPackageProgress, AgentPackageStatus, AgentPackagesPort, AgentPackagesPortInput, } from "./package-ports.js";
+export type { AgentEnginePort, AgentSessionPort } from "./ports.js";
+export { assertAgentCapabilityContract, assertAgentCommand, assertAgentEvent, assertAgentSnapshot } from "./validation.js";
+export { decodeAgentCommand, decodeAgentEvent, decodeAgentSnapshot, encodeAgentCommand, encodeAgentEvent, encodeAgentSnapshot } from "./serialization.js";

package/dist/contracts/agent-engine/index.js

@@ -1,8 +1,6 @@
-export * from "./capability-ports.js";
-export * from "./domain.js";
-export * from "./domain-validation.js";
-export * from "./model.js";
-export * from "./package-ports.js";
-export * from "./ports.js";
-export * from "./validation.js";
-export * from "./serialization.js";
+export { assertAgentServicePorts } from "./capability-ports.js";
+export { assertAgentDomainCapabilities, assertAgentFailure, assertAgentMessage, assertAgentMessageContent, assertAgentModelDescriptor, assertAgentResourceDescriptor, assertAgentSettingDescriptor, assertAgentThemeDescriptor, assertAgentToolDescriptor, assertAgentUiContribution, assertAgentUsage, } from "./domain-validation.js";
+export { AGENT_ENGINE_CONTRACT_VERSION } from "./model.js";
+export { agentPackageOutcome, assertAgentPackagesPort } from "./package-ports.js";
+export { assertAgentCapabilityContract, assertAgentCommand, assertAgentEvent, assertAgentSnapshot } from "./validation.js";
+export { decodeAgentCommand, decodeAgentEvent, decodeAgentSnapshot, encodeAgentCommand, encodeAgentEvent, encodeAgentSnapshot } from "./serialization.js";

package/dist/contracts/owned-ui/extension-ui.d.ts

@@ -180,6 +180,14 @@ export interface OwnedUiExtensionOverlayHandle {
         readonly target: OwnedUiExtensionComponent | null;
     }): void;
     isFocused(): boolean;
+    /** The most recently rendered terminal-relative rectangle of a visible overlay. */
+    getBounds(): OwnedUiExtensionOverlayBounds | undefined;
+}
+export interface OwnedUiExtensionOverlayBounds {
+    readonly row: number;
+    readonly col: number;
+    readonly width: number;
+    readonly height: number;
 }
 export interface OwnedUiExtensionCustomOptions {
     readonly overlay?: boolean;

package/dist/contracts/owned-ui/index.d.ts

@@ -1,8 +1,12 @@
-export * from "./extension-ui.js";
-export * from "./model.js";
-export * from "./transcript-lifecycle.js";
-export * from "./image-attachments.js";
-export * from "./prompt-suggestions.js";
-export * from "./suggestion-diagnostics.js";
-export * from "./prompt-history.js";
-export * from "./validation.js";
+export { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, assertOwnedUiExtensionUiPort, } from "./extension-ui.js";
+export type { OwnedUiExtensionAutocompleteItem, OwnedUiExtensionAutocompleteProvider, OwnedUiExtensionAutocompleteProviderFactory, OwnedUiExtensionAutocompleteSuggestions, OwnedUiExtensionComponent, OwnedUiExtensionComponentFactory, OwnedUiExtensionComponentFactoryContext, OwnedUiExtensionCustomFactory, OwnedUiExtensionCustomOptions, OwnedUiExtensionDialogOptions, OwnedUiExtensionEditorComponent, OwnedUiExtensionEditorFactory, OwnedUiExtensionEditorThemePort, OwnedUiExtensionEntryRenderInput, OwnedUiExtensionFooterDataPort, OwnedUiExtensionFooterFactory, OwnedUiExtensionInputListener, OwnedUiExtensionKeybindingsPort, OwnedUiExtensionMessageRenderInput, OwnedUiExtensionNotificationSeverity, OwnedUiExtensionOverlayAnchor, OwnedUiExtensionOverlayHandle, OwnedUiExtensionOverlayMargin, OwnedUiExtensionOverlayOptions, OwnedUiExtensionRenderCallback, OwnedUiExtensionRendererPort, OwnedUiExtensionRuntimePort, OwnedUiExtensionSelectListThemePort, OwnedUiExtensionSizeValue, OwnedUiExtensionTerminalPort, OwnedUiExtensionThemeBackground, OwnedUiExtensionThemeColor, OwnedUiExtensionThemeInfo, OwnedUiExtensionThemePort, OwnedUiExtensionToolRenderContext, OwnedUiExtensionUiCallback, OwnedUiExtensionUiPort, OwnedUiExtensionUiProperty, OwnedUiExtensionWidgetOptions, OwnedUiExtensionWidgetPlacement, OwnedUiExtensionWorkingIndicatorOptions, } from "./extension-ui.js";
+export { OWNED_UI_CONTRACT_VERSION } from "./model.js";
+export type { OwnedUiBlockStatus, OwnedUiCommand, OwnedUiCommandOutcome, OwnedUiCorrelationId, OwnedUiCustomization, OwnedUiDiagnostics, OwnedUiDialog, OwnedUiEditorState, OwnedUiEntityId, OwnedUiEvent, OwnedUiFooterView, OwnedUiImageAttachment, OwnedUiLifecycle, OwnedUiModelInfo, OwnedUiOverlay, OwnedUiPromptSuggestionGeneratorPort, OwnedUiPromptSuggestionIdentity, OwnedUiPromptSuggestionReasoning, OwnedUiPromptSuggestionRequest, OwnedUiPromptSuggestionResult, OwnedUiPromptSuggestionState, OwnedUiQuitEffect, OwnedUiQuitOutroSettings, OwnedUiQuitOutroSettingsPort, OwnedUiSessionId, OwnedUiSessionViewModel, OwnedUiSeverity, OwnedUiSlotId, OwnedUiSnapshot, OwnedUiStatusView, OwnedUiTerminalSurface, OwnedUiThinkingLevel, OwnedUiToolRendering, OwnedUiToolResultPart, OwnedUiToolState, OwnedUiTranscriptBlock, OwnedUiTranscriptBlockKind, OwnedUiTranscriptImageReference, OwnedUiUsageView, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, } from "./model.js";
+export { acceptsTranscriptUpdate, transcriptToolState } from "./transcript-lifecycle.js";
+export { ImageAttachmentError, MAX_CLIPBOARD_TEXT_BYTES, MAX_IMAGE_DATA_BYTES, MAX_PROMPT_IMAGES, assertImageEncodedSize, assertPromptImages, } from "./image-attachments.js";
+export { CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, normalizePromptSuggestionCandidate } from "./prompt-suggestions.js";
+export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
+export type { SuggestionDecision, SuggestionDecisionReason, SuggestionDiagnosticEvent, SuggestionDiagnosticObserver, SuggestionDiagnosticRecord, } from "./suggestion-diagnostics.js";
+export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";
+export type { PromptHistoryFailure, PromptHistoryImageSidecarAttachment, PromptHistoryImageSidecarPort, PromptHistoryImageSidecarRecord, PromptHistoryKind, PromptHistoryPort, PromptHistoryResult, PromptHistorySnapshot, PromptHistorySubmission, } from "./prompt-history.js";
+export { assertOwnedUiCommand, assertOwnedUiCustomization, assertOwnedUiDiagnostics, assertOwnedUiEditorState, assertOwnedUiEvent, assertOwnedUiPromptSuggestionIdentity, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiPromptSuggestionState, assertOwnedUiSessionViewModel, assertOwnedUiSnapshot, assertOwnedUiStatusView, assertOwnedUiTerminalSurface, assertOwnedUiTranscriptBlock, } from "./validation.js";

package/dist/contracts/owned-ui/index.js

@@ -1,8 +1,8 @@
-export * from "./extension-ui.js";
-export * from "./model.js";
-export * from "./transcript-lifecycle.js";
-export * from "./image-attachments.js";
-export * from "./prompt-suggestions.js";
-export * from "./suggestion-diagnostics.js";
-export * from "./prompt-history.js";
-export * from "./validation.js";
+export { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, assertOwnedUiExtensionUiPort, } from "./extension-ui.js";
+export { OWNED_UI_CONTRACT_VERSION } from "./model.js";
+export { acceptsTranscriptUpdate, transcriptToolState } from "./transcript-lifecycle.js";
+export { ImageAttachmentError, MAX_CLIPBOARD_TEXT_BYTES, MAX_IMAGE_DATA_BYTES, MAX_PROMPT_IMAGES, assertImageEncodedSize, assertPromptImages, } from "./image-attachments.js";
+export { CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, normalizePromptSuggestionCandidate } from "./prompt-suggestions.js";
+export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
+export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";
+export { assertOwnedUiCommand, assertOwnedUiCustomization, assertOwnedUiDiagnostics, assertOwnedUiEditorState, assertOwnedUiEvent, assertOwnedUiPromptSuggestionIdentity, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiPromptSuggestionState, assertOwnedUiSessionViewModel, assertOwnedUiSnapshot, assertOwnedUiStatusView, assertOwnedUiTerminalSurface, assertOwnedUiTranscriptBlock, } from "./validation.js";

package/dist/features/launch/index.d.ts

@@ -1,6 +1,12 @@
-export * from "./development-launch.js";
-export * from "./initialize-profile.js";
-export * from "./intent.js";
-export * from "./profile-paths.js";
-export * from "./prepare-launch.js";
-export * from "./runtime-selection.js";
+export { resolveDevelopmentLaunchEnvironment } from "./development-launch.js";
+export type { DevelopmentLaunchEnvironment } from "./development-launch.js";
+export { PI_PROFILE_RESOURCE_DIRECTORIES, initializeProductProfile } from "./initialize-profile.js";
+export type { InitializedProfile } from "./initialize-profile.js";
+export { interactiveLaunchIntent, parseSessionSelection } from "./intent.js";
+export type { InteractiveLaunchIntent, LaunchIntent, LaunchProfileId, SessionSelection } from "./intent.js";
+export { configurationRootForProfile, resolveLaunchProfilePaths, resolvePromptHistoryDataDir } from "./profile-paths.js";
+export type { LaunchProfilePathOptions, LaunchProfilePaths } from "./profile-paths.js";
+export { prepareInteractiveLaunch } from "./prepare-launch.js";
+export type { PrepareInteractiveLaunchOptions, PreparedInteractiveLaunch } from "./prepare-launch.js";
+export { runSelectedInteractiveRuntime, selectInteractiveRuntime } from "./runtime-selection.js";
+export type { InteractiveRuntimeRunners, InteractiveRuntimeSelection, OwnedUiProfileId } from "./runtime-selection.js";

package/dist/features/launch/index.js

@@ -1,6 +1,6 @@
-export * from "./development-launch.js";
-export * from "./initialize-profile.js";
-export * from "./intent.js";
-export * from "./profile-paths.js";
-export * from "./prepare-launch.js";
-export * from "./runtime-selection.js";
+export { resolveDevelopmentLaunchEnvironment } from "./development-launch.js";
+export { PI_PROFILE_RESOURCE_DIRECTORIES, initializeProductProfile } from "./initialize-profile.js";
+export { interactiveLaunchIntent, parseSessionSelection } from "./intent.js";
+export { configurationRootForProfile, resolveLaunchProfilePaths, resolvePromptHistoryDataDir } from "./profile-paths.js";
+export { prepareInteractiveLaunch } from "./prepare-launch.js";
+export { runSelectedInteractiveRuntime, selectInteractiveRuntime } from "./runtime-selection.js";

package/dist/features/launch/intent.d.ts

@@ -1,8 +1,8 @@
-import { type SessionSelection } from "../../foundation/lifecycle/session-selection.js";
-import type { LaunchProfileId } from "../../foundation/lifecycle/model.js";
-export { parseSessionSelection } from "../../foundation/lifecycle/session-selection.js";
-export type { SessionSelection } from "../../foundation/lifecycle/session-selection.js";
-export type { LaunchProfileId } from "../../foundation/lifecycle/model.js";
+import { type SessionSelection } from "../../foundation/lifecycle/index.js";
+import type { LaunchProfileId } from "../../foundation/lifecycle/index.js";
+export { parseSessionSelection } from "../../foundation/lifecycle/index.js";
+export type { SessionSelection } from "../../foundation/lifecycle/index.js";
+export type { LaunchProfileId } from "../../foundation/lifecycle/index.js";
 export interface InteractiveLaunchIntent {
     readonly kind: "interactive";
     readonly profileId: LaunchProfileId;

package/dist/features/launch/intent.js

@@ -1,5 +1,5 @@
-import { sessionSelectionArguments } from "../../foundation/lifecycle/session-selection.js";
-export { parseSessionSelection } from "../../foundation/lifecycle/session-selection.js";
+import { sessionSelectionArguments } from "../../foundation/lifecycle/index.js";
+export { parseSessionSelection } from "../../foundation/lifecycle/index.js";
 export function interactiveLaunchIntent(profileId, sessionSelection) {
     if (sessionSelection !== undefined && profileId !== "a1")
         throw new Error("session selection requires the normal A1 profile");

package/dist/features/owned-ui/index.d.ts

@@ -1,6 +1,6 @@
-export * from "./customization.js";
-export * from "./diagnostics.js";
-export * from "./run.js";
-export * from "./project-trust-prompt.js";
-export * from "./session-fork-prompt.js";
-export * from "./settings-app.js";
+export { runOwnedUi, terminateOwnedUiProcess } from "./run.js";
+export type { OwnedUiRunOptions } from "./run.js";
+export { createConsoleProjectTrustPrompt } from "./project-trust-prompt.js";
+export type { ConsoleProjectTrustPromptOptions, OwnedProjectTrustPrompt, OwnedProjectTrustPromptRequest } from "./project-trust-prompt.js";
+export { createConsoleSessionForkPrompt } from "./session-fork-prompt.js";
+export { SETTINGS_APP_ID, SETTINGS_ROUTE, SETTINGS_SHORTCUTS, SettingsApp } from "./settings-app.js";

package/dist/features/owned-ui/index.js

@@ -1,6 +1,4 @@
-export * from "./customization.js";
-export * from "./diagnostics.js";
-export * from "./run.js";
-export * from "./project-trust-prompt.js";
-export * from "./session-fork-prompt.js";
-export * from "./settings-app.js";
+export { runOwnedUi, terminateOwnedUiProcess } from "./run.js";
+export { createConsoleProjectTrustPrompt } from "./project-trust-prompt.js";
+export { createConsoleSessionForkPrompt } from "./session-fork-prompt.js";
+export { SETTINGS_APP_ID, SETTINGS_ROUTE, SETTINGS_SHORTCUTS, SettingsApp } from "./settings-app.js";

package/dist/features/owned-ui/run.d.ts

@@ -1,12 +1,12 @@
 import type { OwnedUiApplicationPort } from "../../contracts/presentation/index.js";
-import type { OwnedUiSettingsSession } from "../../ui/settings/index.js";
+import type { OwnedSettingsManager } from "../../ui/settings/index.js";
 export interface OwnedUiRunOptions {
     readonly application: OwnedUiApplicationPort;
     /**
      * Resolved once before the application starts, so every surface reads the same
      * values for the life of the session. Omitted when the caller runs without settings.
      */
-    readonly settings?: OwnedUiSettingsSession;
+    readonly settings?: OwnedSettingsManager;
 }
 /**
  * Completes the interactive executable only after runOwnedUi has restored its terminal.

package/dist/features/owned-ui/settings-app.d.ts

@@ -1,6 +1,6 @@
 import type { AppHostServices, UiApp } from "../../ui/apps/index.js";
 import { ShortcutRegistry, type PaneInputResult, type PaneMouseEvent, type PaneRect } from "../../ui/components/index.js";
-import type { OwnedUiSettingsSession } from "../../ui/settings/index.js";
+import type { OwnedSettingsManager } from "../../ui/settings/index.js";
 export { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
 type Action = "move-up" | "move-down" | "block-up" | "block-down" | "first" | "last" | "page-up" | "page-down" | "previous-value" | "next-value" | "activate" | "open-filter" | "close" | "part-previous" | "part-next" | "part-change";
 export declare const SETTINGS_SHORTCUTS: ShortcutRegistry<Action>;
@@ -12,7 +12,7 @@ export declare const SETTINGS_SHORTCUTS: ShortcutRegistry<Action>;
 export declare class SettingsApp implements UiApp {
     #private;
     readonly id = "settings";
-    constructor(session: OwnedUiSettingsSession);
+    constructor(session: OwnedSettingsManager);
     onActivate(host: AppHostServices): void;
     onClose(_host: AppHostServices): void;
     render(rect: PaneRect, host: AppHostServices): readonly string[];

package/dist/features/owned-ui/settings-app.js

@@ -440,7 +440,9 @@ export class SettingsApp {
         const record = {};
         for (const flag of entry.flags) {
             const value = stored[flag.key];
-            record[flag.key] = typeof value === "boolean" ? value : flag.fallback;
+            record[flag.key] = flag.choices === undefined
+                ? (typeof value === "boolean" ? value : flag.fallback)
+                : (typeof value === "string" && flag.choices.includes(value) ? value : flag.fallback);
         }
         // Invariant: the dialog takes the screen: the row it was opened from stops being the
         // thing under the pointer, so it stops looking like it.
@@ -475,8 +477,19 @@ export class SettingsApp {
         const flag = open?.flags[index];
         if (open === null || open === undefined || flag === undefined)
             return;
-        open.record[flag] = !(open.record[flag] ?? false);
-        const next = { ...open.record };
+        const declared = open.entry.flags.find(candidate => candidate.key === flag);
+        if (declared?.choices === undefined)
+            open.record[flag] = !(open.record[flag] ?? false);
+        else {
+            // Rationale: Enter walks the offered choices in order and wraps, like the pinned value menu.
+            const at = declared.choices.indexOf(String(open.record[flag] ?? declared.fallback));
+            open.record[flag] = declared.choices[(at + 1) % declared.choices.length] ?? declared.fallback;
+        }
+        // Invariant: a choice part at its fallback is unset: it is not written, so the engine's default applies.
+        const next = Object.fromEntries(Object.entries(open.record).filter(([key, value]) => {
+            const part = open.entry.flags.find(candidate => candidate.key === key);
+            return part?.choices === undefined || value !== part.fallback;
+        }));
         void this.#session.changeStructured(open.entry.backend, open.entry.id, next).then(outcome => {
             this.#notice = outcome.failure === null ? null : `Could not save ${labelOf(open.entry)}: ${outcome.failure}`;
         });
@@ -727,8 +740,8 @@ export class SettingsApp {
             const declared = open.entry.flags.find(flag => flag.key === key);
             return {
                 label: declared?.label ?? humanizeLabel(key),
-                // Protocol: the engine writes these as the booleans they are rather than as yes/no.
-                value: (open.record[key] ?? false) ? "true" : "false",
+                // Protocol: the engine writes toggles as the booleans they are rather than as yes/no; a choice shows its word.
+                value: declared?.choices === undefined ? ((open.record[key] ?? false) ? "true" : "false") : String(open.record[key] ?? declared.fallback),
                 ...(declared?.description === undefined ? {} : { description: declared.description }),
             };
         });

package/dist/features/prompt-history/service.d.ts

@@ -37,9 +37,9 @@ export declare class PromptHistoryService implements PromptHistoryPort {
         timers: number;
         failures: {
             schema?: number;
-            shutdown?: number;
             unavailable?: number;
             busy?: number;
+            shutdown?: number;
             capacity?: number;
             oversized?: number;
             corrupt?: number;

package/dist/features/prompt-history/service.js

@@ -5,7 +5,6 @@ const RETENTION_MS = 30_000;
 const LIVENESS_MS = 10_000;
 /** One generation owns storage work; only proven non-commits may be retried. No default output sink. */
 export class PromptHistoryService {
-    options;
     #snapshots = new Set();
     #failures = new Set();
     #counts = {};
@@ -30,6 +29,7 @@ export class PromptHistoryService {
     #recoveries = 0;
     #closePromise;
     #resolveClose;
+    options;
     constructor(options) {
         this.options = options;
         this.#clock = options.clock ?? clock;

package/dist/features/prompt-history/store.js

@@ -7,18 +7,14 @@ import { collectImageChipIdentifiers, PromptImageSidecar } from "./image-sidecar
 export class HistoryStorageError extends Error {
     code;
     certainty;
-    constructor(code, certainty = "uncommitted") {
-        super(`Prompt history ${code}`);
-        this.code = code;
-        this.certainty = certainty;
-    }
+    constructor(code, certainty = "uncommitted") { super(`Prompt history ${code}`); this.code = code; this.certainty = certainty; }
 }
 const MAX_STORAGE_BYTES = 64 * 1024 * 1024;
 export class PromptHistoryStore {
-    path;
-    profileId;
     #database;
     #sidecar;
+    path;
+    profileId;
     constructor(path, profileId, limit, imagesDir) {
         this.path = path;
         this.profileId = profileId;

package/dist/features/prompt-suggestions/diagnostics.js

@@ -2,12 +2,12 @@ import { writeFile } from "node:fs/promises";
 import { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS, } from "../../contracts/owned-ui/index.js";
 /** Bounded metadata snapshots; one in-flight write and one replaceable latest snapshot. */
 export class SuggestionDiagnosticCapture {
-    options;
     #records = [];
     #pending;
     #writing;
     #disposed = false;
     #write;
+    options;
     constructor(options = {}) {
         this.options = options;
         this.#write = options.writeSnapshot ?? (options.destination === undefined ? undefined

package/dist/features/prompt-suggestions/index.d.ts

@@ -1 +1,2 @@
-export * from "./diagnostics.js";
+export { SuggestionDiagnosticCapture } from "./diagnostics.js";
+export type { SuggestionDiagnosticCaptureOptions } from "./diagnostics.js";

package/dist/features/prompt-suggestions/index.js

@@ -1 +1 @@
-export * from "./diagnostics.js";
+export { SuggestionDiagnosticCapture } from "./diagnostics.js";

package/dist/foundation/launch-guardian/index.d.ts

@@ -1 +1,2 @@
-export * from "./main.js";
+export { runLaunchGuardian } from "./main.js";
+export type { LaunchGuardianOptions } from "./main.js";

package/dist/foundation/launch-guardian/index.js

@@ -1 +1 @@
-export * from "./main.js";
+export { runLaunchGuardian } from "./main.js";

package/dist/foundation/lifecycle/index.d.ts

@@ -1,6 +1,11 @@
-export * from "./commands.js";
-export * from "./launch-instance.js";
-export * from "./model.js";
-export * from "./paths.js";
-export * from "./session-selection.js";
-export * from "./supervisor-startup.js";
+export type { LaunchInstanceStopIntent, SupervisorCommand } from "./commands.js";
+export { assertLaunchInstance, assertLaunchInstanceOutcome, assertLaunchInstanceTransition, assertProcessContainmentIdentity } from "./launch-instance.js";
+export type { LaunchInstance, LaunchInstanceId, LaunchInstanceOutcome, LaunchInstanceShutdownPolicy, LaunchInstanceState, LaunchInstanceStopReason, ProcessContainmentIdentity, } from "./launch-instance.js";
+export { assertDimensions, assertLaunchProfileId, assertNativeProcessIdentity, assertTransparentTerminalLaunchProfile } from "./model.js";
+export type { CommandResult, DriverProfileId, GenerationId, LaunchProfileId, NativeProcessIdentity, RequestId, SupervisorSnapshot, TerminalDimensions, TransparentTerminalLaunchProfile, TransparentTerminalLifecycleOutcome, } from "./model.js";
+export { resolveCohortEndpoint, resolveProductPaths } from "./paths.js";
+export type { CohortEndpointPaths, ProductPaths } from "./paths.js";
+export { parseSessionSelection, sessionSelectionArguments } from "./session-selection.js";
+export type { SessionSelection } from "./session-selection.js";
+export { createSupervisorStartupAttempt, publishSupervisorStartupResult, readSupervisorStartupResult, supervisorStartupFailure, supervisorStartupReady, supervisorStartupResultPath, } from "./supervisor-startup.js";
+export type { SupervisorStartupAttemptIdentity, SupervisorStartupResult } from "./supervisor-startup.js";

package/dist/foundation/lifecycle/index.js

@@ -1,6 +1,5 @@
-export * from "./commands.js";
-export * from "./launch-instance.js";
-export * from "./model.js";
-export * from "./paths.js";
-export * from "./session-selection.js";
-export * from "./supervisor-startup.js";
+export { assertLaunchInstance, assertLaunchInstanceOutcome, assertLaunchInstanceTransition, assertProcessContainmentIdentity } from "./launch-instance.js";
+export { assertDimensions, assertLaunchProfileId, assertNativeProcessIdentity, assertTransparentTerminalLaunchProfile } from "./model.js";
+export { resolveCohortEndpoint, resolveProductPaths } from "./paths.js";
+export { parseSessionSelection, sessionSelectionArguments } from "./session-selection.js";
+export { createSupervisorStartupAttempt, publishSupervisorStartupResult, readSupervisorStartupResult, supervisorStartupFailure, supervisorStartupReady, supervisorStartupResultPath, } from "./supervisor-startup.js";

package/dist/foundation/process-containment/index.d.ts

@@ -1,6 +1,8 @@
-export * from "./artifact.js";
-export * from "./contracts.js";
-export * from "./darwin-process-inspector.js";
-export * from "./linux-process-inspector.js";
-export * from "./native-guardian-containment.js";
-export * from "./windows-process-inspector.js";
+export { verifyProcessGuardianArtifact } from "./artifact.js";
+export { closeVerifiedContainment } from "./contracts.js";
+export type { ContainedProcessHandle, ContainedSpawnOptions, ContainmentCloseResult, NativeProcessInspector, ProcessContainment, ProcessContainmentFactory, } from "./contracts.js";
+export { DarwinNativeProcessInspector } from "./darwin-process-inspector.js";
+export { LinuxNativeProcessInspector } from "./linux-process-inspector.js";
+export { NativeGuardianContainment, resolveProcessGuardianPath } from "./native-guardian-containment.js";
+export { WindowsNativeProcessInspector } from "./windows-process-inspector.js";
+export type { InspectorCommandResult, InspectorCommandRunner } from "./windows-process-inspector.js";

package/dist/foundation/process-containment/index.js

@@ -1,6 +1,6 @@
-export * from "./artifact.js";
-export * from "./contracts.js";
-export * from "./darwin-process-inspector.js";
-export * from "./linux-process-inspector.js";
-export * from "./native-guardian-containment.js";
-export * from "./windows-process-inspector.js";
+export { verifyProcessGuardianArtifact } from "./artifact.js";
+export { closeVerifiedContainment } from "./contracts.js";
+export { DarwinNativeProcessInspector } from "./darwin-process-inspector.js";
+export { LinuxNativeProcessInspector } from "./linux-process-inspector.js";
+export { NativeGuardianContainment, resolveProcessGuardianPath } from "./native-guardian-containment.js";
+export { WindowsNativeProcessInspector } from "./windows-process-inspector.js";

package/dist/foundation/process-containment/native-guardian-containment.js

@@ -4,13 +4,13 @@ import { dirname, resolve } from "node:path";
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
 /** Delegates one root runtime to the native guardian and exposes its verified containment identity. */
 export class NativeGuardianContainment {
-    instanceId;
-    helperPath;
-    statusPath;
     #identity;
     #helper = null;
     #rootIdentity = null;
     #outcome = null;
+    instanceId;
+    helperPath;
+    statusPath;
     constructor(instanceId, helperPath, statusPath) {
         this.instanceId = instanceId;
         this.helperPath = helperPath;

package/dist/foundation/protocol/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./client.js";
-export * from "./messages.js";
+export { SupervisorClient } from "./client.js";
+export { CONTROL_ENVELOPE, CONTROL_ENVELOPE_REVISION, GENERATED_CONTRACT_DIGEST, LineFrameDecoder, MAX_CONTROL_FRAME_BYTES, OPTIONAL_CONTROL_FEATURES, REQUIRED_CONTROL_FEATURES, encodeFrame, isCommandMessage, isControlHello, localControlHello, negotiateControlFeatures, } from "./messages.js";
+export type { ClientMessage, ControlFeature, ControlHello, ControlNegotiation, ServerMessage } from "./messages.js";

package/dist/foundation/protocol/index.js

@@ -1,2 +1,2 @@
-export * from "./client.js";
-export * from "./messages.js";
+export { SupervisorClient } from "./client.js";
+export { CONTROL_ENVELOPE, CONTROL_ENVELOPE_REVISION, GENERATED_CONTRACT_DIGEST, LineFrameDecoder, MAX_CONTROL_FRAME_BYTES, OPTIONAL_CONTROL_FEATURES, REQUIRED_CONTROL_FEATURES, encodeFrame, isCommandMessage, isControlHello, localControlHello, negotiateControlFeatures, } from "./messages.js";