@timurproko/a1 0.2.6-dev.717 → 0.2.6-dev.734

package/dist/contracts/agent-engine/capability-ports.d.ts

@@ -1,24 +1,4 @@
-import type { AgentJsonValue, AgentModelDescriptor, AgentSettingChangeOutcome, AgentResourceDescriptor, AgentSettingDescriptor } from "./domain.js";
-export interface AgentModelPort {
-    readonly capabilities: {
-        readonly selection: boolean;
-        readonly refresh: boolean;
-        readonly scopedCatalog: boolean;
-    };
-    listModels(scope?: string): Promise<readonly AgentModelDescriptor[]>;
-    currentModel(): Promise<AgentModelDescriptor | null>;
-    selectModel?(providerId: string, modelId: string): Promise<void>;
-    refreshModels?(): Promise<void>;
-}
-export interface AgentAuthenticationPort {
-    readonly capabilities: {
-        readonly login: boolean;
-        readonly logout: boolean;
-    };
-    status(providerId: string): Promise<"authenticated" | "unauthenticated" | "unavailable">;
-    login?(providerId: string, signal?: AbortSignal): Promise<void>;
-    logout?(providerId: string): Promise<void>;
-}
+import type { AgentJsonValue, AgentSettingChangeOutcome, AgentSettingDescriptor } from "./domain.js";
 export interface AgentSettingsPort {
     readonly capabilities: {
         readonly write: boolean;
@@ -29,67 +9,3 @@ export interface AgentSettingsPort {
     writeSetting?(key: string, value: AgentJsonValue): Promise<AgentSettingChangeOutcome>;
     flush?(): Promise<void>;
 }
-export interface AgentResourcesPort {
-    readonly capabilities: {
-        readonly reload: boolean;
-        readonly extensionBinding: boolean;
-    };
-    discoverResources(): Promise<readonly AgentResourceDescriptor[]>;
-    reload?(): Promise<void>;
-    bindExtensions?(sessionId: string): Promise<AgentExtensionBinding>;
-}
-export interface AgentExtensionBinding {
-    readonly sessionId: string;
-    dispose(): Promise<void>;
-}
-export interface AgentExtensionCommand {
-    readonly name: string;
-    readonly description: string;
-}
-export interface AgentSessionMetadata {
-    readonly sessionId: string;
-    readonly sessionName: string | null;
-    readonly sessionPath: string | null;
-    readonly cwd: string;
-}
-export interface AgentExtensionFailure {
-    readonly extensionPath: string | null;
-    readonly operation: string;
-    readonly message: string;
-    readonly recoverable: boolean;
-}
-export interface AgentExtensionPort {
-    readonly capabilities: {
-        readonly reload: boolean;
-        readonly binding: boolean;
-        readonly renderers: boolean;
-    };
-    discoverCommands(): Promise<readonly AgentExtensionCommand[]>;
-    sessionMetadata(): Promise<AgentSessionMetadata>;
-    bind?(sessionId: string): Promise<AgentExtensionBinding>;
-    reload?(): Promise<void>;
-    resolveMessageRenderer?(customType: string): unknown;
-    resolveToolRenderer?(toolName: string): unknown;
-    subscribeFailures(listener: (failure: AgentExtensionFailure) => void): () => void;
-}
-export interface AgentWorkflowDescriptor {
-    readonly id: string;
-    readonly label: string;
-    readonly requiredCommands: readonly string[];
-}
-export interface AgentWorkflowPort {
-    readonly capabilities: {
-        readonly execute: boolean;
-    };
-    listWorkflows(): Promise<readonly AgentWorkflowDescriptor[]>;
-    executeWorkflow?(workflowId: string, input: AgentJsonValue, signal?: AbortSignal): Promise<AgentJsonValue>;
-}
-export interface AgentServicePorts {
-    readonly models: AgentModelPort;
-    readonly authentication: AgentAuthenticationPort;
-    readonly settings: AgentSettingsPort;
-    readonly resources: AgentResourcesPort;
-    readonly extensions: AgentExtensionPort;
-    readonly workflows: AgentWorkflowPort;
-}
-export declare function assertAgentServicePorts(ports: AgentServicePorts): void;

package/dist/contracts/agent-engine/capability-ports.js

@@ -1,35 +1 @@
-export function assertAgentServicePorts(ports) {
-    required(ports.models, ["listModels", "currentModel"], "model");
-    advertised(ports.models, "selection", "selectModel", "model");
-    advertised(ports.models, "refresh", "refreshModels", "model");
-    required(ports.authentication, ["status"], "authentication");
-    advertised(ports.authentication, "login", "login", "authentication");
-    advertised(ports.authentication, "logout", "logout", "authentication");
-    required(ports.settings, ["listSettings", "readSetting"], "settings");
-    advertised(ports.settings, "write", "writeSetting", "settings");
-    advertised(ports.settings, "flush", "flush", "settings");
-    required(ports.resources, ["discoverResources"], "resources");
-    advertised(ports.resources, "reload", "reload", "resources");
-    advertised(ports.resources, "extensionBinding", "bindExtensions", "resources");
-    required(ports.extensions, ["discoverCommands", "sessionMetadata", "subscribeFailures"], "extensions");
-    advertised(ports.extensions, "reload", "reload", "extensions");
-    advertised(ports.extensions, "binding", "bind", "extensions");
-    advertised(ports.extensions, "renderers", "resolveMessageRenderer", "extensions");
-    advertised(ports.extensions, "renderers", "resolveToolRenderer", "extensions");
-    required(ports.workflows, ["listWorkflows"], "workflow");
-    advertised(ports.workflows, "execute", "executeWorkflow", "workflow");
-}
-function required(port, operations, label) {
-    if (!port || typeof port.capabilities !== "object")
-        throw new TypeError(`${label} port and capabilities are required`);
-    for (const operation of operations)
-        if (typeof port[operation] !== "function")
-            throw new TypeError(`${label} port requires ${operation}`);
-}
-function advertised(port, capability, operation, label) {
-    const enabled = port.capabilities[capability];
-    if (typeof enabled !== "boolean")
-        throw new TypeError(`${label} capability ${capability} must be explicit`);
-    if (enabled && typeof port[operation] !== "function")
-        throw new TypeError(`${label} capability ${capability} requires ${operation}`);
-}
+export {};

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

@@ -1,11 +1,5 @@
-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 { AgentSettingsPort } 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,6 +1,2 @@
-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/index.d.ts

@@ -1,14 +1,20 @@
+/** Stable stored choices for bare A1's semantic UI accent. */
+export type UiAccentColor = "purple" | "blue" | "cyan" | "green" | "orange" | "pink";
 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, OwnedUiQuitOutroSettings, OwnedUiQuitOutroSettingsPort, OwnedUiSessionId, OwnedUiSessionViewModel, OwnedUiSeverity, OwnedUiSlotId, OwnedUiSnapshot, OwnedUiStatusView, OwnedUiTerminalSurface, OwnedUiThinkingLevel, OwnedUiToolRendering, OwnedUiToolResultPart, OwnedUiToolState, OwnedUiTranscriptBlock, OwnedUiTranscriptBlockKind, OwnedUiTranscriptImageReference, OwnedUiUsageView, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, } from "./model.js";
+export type { OwnedUiBackgroundSettingsPort, OwnedUiBackgroundStyle, OwnedUiBlockStatus, OwnedUiCommand, OwnedUiCommandOutcome, OwnedUiCorrelationId, OwnedUiCustomization, OwnedUiDiagnostics, OwnedUiDialog, OwnedUiEditorState, OwnedUiEntityId, OwnedUiEvent, OwnedUiFooterView, OwnedUiImageAttachment, OwnedUiLifecycle, OwnedUiModelInfo, OwnedUiOverlay, OwnedUiPromptSuggestionGeneratorPort, OwnedUiPromptSuggestionIdentity, OwnedUiPromptSuggestionReasoning, OwnedUiPromptSuggestionRequest, OwnedUiPromptSuggestionResult, OwnedUiPromptSuggestionState, OwnedUiQuitOutroSettings, OwnedUiQuitOutroSettingsPort, OwnedUiSessionId, OwnedUiSessionViewModel, OwnedUiSeverity, OwnedUiSlotId, OwnedUiSnapshot, OwnedUiStatusView, OwnedUiTerminalSurface, OwnedUiThinkingLevel, OwnedUiToolRendering, OwnedUiToolResultPart, OwnedUiToolState, OwnedUiTranscriptBlock, OwnedUiTranscriptBlockKind, OwnedUiTranscriptImageReference, OwnedUiUsageView, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, } from "./model.js";
+export type { OwnedUiExtensionPort, OwnedUiSessionBackend, OwnedUiSessionCatalogPort, OwnedUiSessionFactory, OwnedUiSessionIdentityPort, OwnedUiSessionPort, OwnedUiSessionRequest, OwnedUiSessionSettingsPort, OwnedUiWorkflowPort, } from "./session-backend.js";
+export type { OwnedUiDialogHost, OwnedUiInputSurface, OwnedUiSessionPresenters, OwnedUiShortcutDescription, OwnedUiTranscriptRendererPort, } from "./session-presenters.js";
+export { OWNED_UI_HIDDEN_COMMAND_NAMES, OWNED_UI_MODELS_COMMAND_NAME, OWNED_UI_WORKFLOW_COMMAND_NAMES, } from "./session-workflows.js";
+export type { OwnedUiAmbientAuthentication, OwnedUiAuthenticationProviderOption, OwnedUiAuthenticationProviderStatus, OwnedUiBashWorkflowResult, OwnedUiCacheWarmingPresentation, OwnedUiCommandResult, OwnedUiExtensionResourceSummary, OwnedUiExtensionSourceSummary, OwnedUiHiddenWorkflowCommandName, OwnedUiJsonValue, OwnedUiModelsCommandName, OwnedUiModelsContext, OwnedUiModelsRefreshResult, OwnedUiProjectTrustContext, OwnedUiProjectTrustUpdate, OwnedUiReleaseUpdate, OwnedUiResourceSummary, OwnedUiScopedModelDescriptor, OwnedUiScopedModelsContext, OwnedUiScopedModelsRefreshResult, OwnedUiSessionInfoPresentation, OwnedUiSessionProductMode, OwnedUiSessionResumeMetadata, OwnedUiSessionSettingKey, OwnedUiSessionSettingsSnapshot, OwnedUiSettingEffectHandler, OwnedUiSettingOwner, OwnedUiSettingOwnerHandlers, OwnedUiSettingsThinkingLevel, OwnedUiVisualExtensionSupport, OwnedUiWorkflowAutocompleteCommand, OwnedUiWorkflowCommandName, OwnedUiWorkflowInteractionHost, OwnedUiWorkflowInteractionRequest, OwnedUiWorkflowLoginNotification, OwnedUiWorkflowLoginStart, OwnedUiWorkflowMessage, OwnedUiWorkflowMessageKind, OwnedUiWorkflowOption, OwnedUiWorkflowOutcome, OwnedUiWorkflowPresentation, OwnedUiWorkflowRequest, OwnedUiWorkflowResult, OwnedUiWorkflowRoute, } from "./session-workflows.js";
 export { acceptsTranscriptUpdate, transcriptToolState } from "./transcript-lifecycle.js";
 export { DEFAULT_PROMPT_IMAGE_LIMIT, 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 { canonicalPromptChipMatches, protectPromptChipWrapping, replaceCanonicalPromptChips } from "./prompt-chips.js";
 export type { PromptChipTextMatch, PromptChipWrapProtection } from "./prompt-chips.js";
-export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
-export type { SuggestionDecision, SuggestionDecisionReason, SuggestionDiagnosticEvent, SuggestionDiagnosticObserver, SuggestionDiagnosticRecord, } from "./suggestion-diagnostics.js";
+export { SUGGESTION_ATTEMPT_TRIGGERS, SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
+export type { SuggestionAttemptTrigger, 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,9 +1,10 @@
 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 { OWNED_UI_HIDDEN_COMMAND_NAMES, OWNED_UI_MODELS_COMMAND_NAME, OWNED_UI_WORKFLOW_COMMAND_NAMES, } from "./session-workflows.js";
 export { acceptsTranscriptUpdate, transcriptToolState } from "./transcript-lifecycle.js";
 export { DEFAULT_PROMPT_IMAGE_LIMIT, 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 { canonicalPromptChipMatches, protectPromptChipWrapping, replaceCanonicalPromptChips } from "./prompt-chips.js";
-export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
+export { SUGGESTION_ATTEMPT_TRIGGERS, 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/contracts/owned-ui/model.d.ts

@@ -64,6 +64,12 @@ export interface OwnedUiViewportSettingsPort {
     snapshot(): OwnedUiViewportSettings;
     onChange(listener: (settings: OwnedUiViewportSettings) => void): () => void;
 }
+export type OwnedUiBackgroundStyle = "transparent" | "accent" | "dark";
+/** Narrow live canvas setting supplied only to the bare-A1 fullscreen presentation. */
+export interface OwnedUiBackgroundSettingsPort {
+    snapshot(): OwnedUiBackgroundStyle;
+    onChange(listener: (style: OwnedUiBackgroundStyle) => void): () => void;
+}
 /** Profile-local quit outro choice, read at the moment bare A1 quits. */
 export interface OwnedUiQuitOutroSettings {
     /** False leaves the terminal immediately; true plays the shell's fixed effect. */
@@ -336,6 +342,10 @@ export type OwnedUiEvent = {
     readonly model: OwnedUiModelInfo | null;
     readonly assistantMessageCount: number;
     readonly successful: boolean;
+    readonly stopReason: string | null;
+    readonly toolContinuation: boolean;
+    /** Pi 1.1 distinguishes user cancellation from an ordinary or failed settlement. */
+    readonly aborted: boolean;
 } | {
     readonly type: "editor-state";
     readonly sessionId: OwnedUiSessionId;

package/dist/contracts/owned-ui/session-backend.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The session backend the owned shell presents. The shell and composition depend on this port,
+ * never on an engine adapter class, so a per-tab or non-Pi backend can stand behind the shell.
+ */
+import type { OwnedUiExtensionUiPort } from "./extension-ui.js";
+import type { OwnedUiCommand, OwnedUiEvent, OwnedUiImageAttachment, OwnedUiSessionViewModel, OwnedUiSnapshot } from "./model.js";
+import type { OwnedUiAmbientAuthentication, OwnedUiAuthenticationProviderOption, OwnedUiBashWorkflowResult, OwnedUiCommandResult, OwnedUiExtensionResourceSummary, OwnedUiModelsContext, OwnedUiModelsRefreshResult, OwnedUiProjectTrustContext, OwnedUiProjectTrustUpdate, OwnedUiReleaseUpdate, OwnedUiResourceSummary, OwnedUiScopedModelsContext, OwnedUiScopedModelsRefreshResult, OwnedUiSessionProductMode, OwnedUiSessionResumeMetadata, OwnedUiSessionSettingsSnapshot, OwnedUiSettingOwner, OwnedUiSettingOwnerHandlers, OwnedUiSettingsThinkingLevel, OwnedUiVisualExtensionSupport, OwnedUiWorkflowAutocompleteCommand, OwnedUiWorkflowInteractionHost, OwnedUiWorkflowOption, OwnedUiWorkflowRequest, OwnedUiWorkflowResult } from "./session-workflows.js";
+export interface OwnedUiSessionBackend {
+    readonly identity: OwnedUiSessionIdentityPort;
+    readonly session: OwnedUiSessionPort;
+    readonly workflows: OwnedUiWorkflowPort;
+    readonly settings: OwnedUiSessionSettingsPort;
+    readonly catalog: OwnedUiSessionCatalogPort;
+    readonly extensions: OwnedUiExtensionPort;
+}
+/** What a caller states about the session it wants; everything process-wide stays with the factory. */
+export interface OwnedUiSessionRequest {
+    /** Unique within the process. Omitted means the factory assigns one that is. */
+    readonly sessionId?: string;
+    readonly cwd: string;
+}
+/**
+ * The one place sessions come from. The factory owns the state that is process-wide, so two
+ * sessions in one process never install, announce, or trace the same thing twice.
+ */
+export interface OwnedUiSessionFactory {
+    create(request: OwnedUiSessionRequest): Promise<OwnedUiSessionBackend>;
+}
+/** Which session this is, where it lives, and how often it has been replaced. */
+export interface OwnedUiSessionIdentityPort {
+    readonly sessionId: string;
+    readonly agentDir: string;
+    readonly cwd: string;
+    /** Advances on every session replacement and on delivery-only callback invalidation. */
+    readonly sessionGeneration: number;
+    /** Actual session replacements, excluding delivery-only invalidation of callbacks. */
+    readonly sessionBindingGeneration: number;
+    readonly disposed: boolean;
+    currentSessionResumeMetadata(): OwnedUiSessionResumeMetadata | null;
+}
+/** The session lifecycle, its view, its event stream, and command admission. */
+export interface OwnedUiSessionPort {
+    start(): Promise<OwnedUiSessionViewModel>;
+    view(): OwnedUiSessionViewModel;
+    snapshot(): OwnedUiSnapshot;
+    /** Subscribe to events; the listener first receives the current view. Returns the unsubscribe. */
+    onEvent(listener: (event: OwnedUiEvent) => void): () => void;
+    execute(command: OwnedUiCommand): Promise<OwnedUiCommandResult>;
+    /** Settle queued delivery; rejects when required delivery was interrupted. */
+    flushEvents(): Promise<void>;
+    dispose(): Promise<void>;
+}
+/** Slash-command workflows and the shell-side host their interactive steps call back into. */
+export interface OwnedUiWorkflowPort {
+    executeWorkflow(request: OwnedUiWorkflowRequest): Promise<OwnedUiWorkflowResult>;
+    executeBashWorkflow(command: string, excludeFromContext: boolean): Promise<OwnedUiBashWorkflowResult>;
+    cycleModelWorkflow(direction: "forward" | "backward"): Promise<OwnedUiWorkflowResult>;
+    workflowAutocompleteCommands(): readonly OwnedUiWorkflowAutocompleteCommand[];
+    /** Clear queued steering and follow-up submissions, returning their texts in order. */
+    clearQueuedWorkflows(): readonly string[];
+    /** The result a blocked `/reload` reported, or null when reload is available. */
+    reloadBlockedResult(): OwnedUiWorkflowResult | null;
+    /** Copy through the active clipboard owner; true means acknowledged delivery. */
+    copyWorkflowText(text: string): Promise<boolean>;
+    setWorkflowInteractionHost(interaction: OwnedUiWorkflowInteractionHost): void;
+}
+/**
+ * Engine settings the shell reads and the live effects it installs. Settings writes stay here
+ * rather than in `OwnedUiCommand`: commands are admitted per session, and a global default must
+ * not be gated by one session's admission or overload state.
+ */
+export interface OwnedUiSessionSettingsPort {
+    readonly productMode: OwnedUiSessionProductMode;
+    snapshot(): OwnedUiSessionSettingsSnapshot;
+    /** Bind live effects for one owner; returns the unbind. */
+    bindOwner(owner: OwnedUiSettingOwner, handlers: OwnedUiSettingOwnerHandlers): () => void;
+    /** Persist the global thinking default without changing the live session level. */
+    setDefaultThinkingLevel(level: OwnedUiSettingsThinkingLevel): void;
+    /**
+     * The theme the engine is configured with, in the engine's own grammar: a theme's name, or a
+     * `light/dark` pair meaning "follow the terminal".
+     */
+    configuredTheme(): string | undefined;
+}
+/** Models, scopes, project trust, and authentication choices. */
+export interface OwnedUiSessionCatalogPort {
+    modelsContext(): OwnedUiModelsContext;
+    setSessionModelScope(scopeIds: readonly string[]): void;
+    persistModelScope(scopeIds: readonly string[]): void;
+    refreshModels(signal: AbortSignal): Promise<OwnedUiModelsRefreshResult>;
+    pinnedScopedModelsContext(): OwnedUiScopedModelsContext;
+    updateScopedModels(enabledModelIds: readonly string[] | null): void;
+    persistScopedModels(enabledModelIds: readonly string[] | null): void;
+    refreshScopedModels(signal: AbortSignal): Promise<OwnedUiScopedModelsRefreshResult>;
+    pinnedProjectTrustContext(): OwnedUiProjectTrustContext;
+    persistProjectTrust(updates: readonly OwnedUiProjectTrustUpdate[]): void;
+    pinnedLoginOptions(authType?: "oauth" | "api_key"): readonly OwnedUiAuthenticationProviderOption[];
+    pinnedLoginMethodOptions(providerReference: string): {
+        readonly title: string;
+        readonly options: readonly OwnedUiWorkflowOption[];
+    };
+    pinnedAmbientAuthentication(selection: string): OwnedUiAmbientAuthentication | null;
+    pinnedLogoutOptions(): Promise<readonly OwnedUiAuthenticationProviderOption[]>;
+    pinnedForkOptions(): readonly OwnedUiWorkflowOption[];
+}
+/** Loaded resources, the extension UI bridge, transcript images, and clipboard binding. */
+export interface OwnedUiExtensionPort {
+    nonVisualResources(): readonly OwnedUiResourceSummary[];
+    extensionResources(): readonly OwnedUiExtensionResourceSummary[];
+    resolveTranscriptImage(assetId: string): OwnedUiImageAttachment | null;
+    visualExtensionSupport(): OwnedUiVisualExtensionSupport;
+    /** Attach the shell's extension UI and bind it to the current session. */
+    bindExtensionUi(ui: OwnedUiExtensionUiPort, shutdown?: () => void | Promise<void>): Promise<void>;
+    unbindExtensionUi(): Promise<void>;
+    /** Bind the owned UI's clipboard lifecycle; true from the writer means acknowledged delivery. Returns the unbind. */
+    bindClipboardWriter(writer: (text: string) => Promise<boolean>): () => void;
+    /** Report a newer release found by the startup check. */
+    announceReleaseUpdate(release: OwnedUiReleaseUpdate): void;
+}

package/dist/contracts/owned-ui/session-presenters.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Presenters for the selectors and transcript renderers whose inputs are engine objects. The shell opens them
+ * through this port and never holds those objects; the Pi session presenters owner implements it.
+ */
+import type { OwnedUiCommandResult, OwnedUiWorkflowRequest, OwnedUiWorkflowResult } from "./session-workflows.js";
+/** A component that replaces the prompt editor while a selector is open. */
+export interface OwnedUiInputSurface {
+    render(width: number): readonly string[];
+    invalidate(): void;
+    handleInput?(data: string): void;
+    setFocused?(focused: boolean): void;
+    dispose?(): void;
+}
+/** The shell's side of a presenter: where the selector is shown and how its choices reach the session. */
+export interface OwnedUiDialogHost {
+    /** True once the shell is disposed; a presenter that awaited stops before showing anything. */
+    readonly disposed: boolean;
+    setInputSurface(surface: OwnedUiInputSurface | null): void;
+    requestRender(): void;
+    viewport(): {
+        readonly columns: number;
+        readonly rows: number;
+    };
+    appendWorkflowStatus(text: string): void;
+    appendWorkflowResult(result: OwnedUiWorkflowResult): void;
+    runWorkflow(request: OwnedUiWorkflowRequest): Promise<OwnedUiCommandResult>;
+    /** Present only where the shell holds frames while an optional selector module loads. */
+    beginPresentationHold?(): () => void;
+    /** Present only where the surface can change TUI mode; false means overlays block the switch. */
+    switchTuiMode?(mode: "regular" | "fullscreen"): boolean;
+}
+/** One extension shortcut row in the hotkeys document. */
+export interface OwnedUiShortcutDescription {
+    readonly key: string;
+    readonly description: string;
+}
+/**
+ * Extension renderer lookups for transcript components. Renderers are opaque objects that only the component
+ * adapter inspects and validates; the shell passes this port through without reading them.
+ */
+export interface OwnedUiTranscriptRendererPort {
+    getMessageRenderer(customType: string): object | undefined;
+    getToolRenderers(toolName: string): object | undefined;
+    getShortcuts(bindings: Readonly<Record<string, string | readonly string[] | undefined>>): readonly OwnedUiShortcutDescription[];
+}
+export interface OwnedUiSessionPresenters {
+    transcriptRenderers(): OwnedUiTranscriptRendererPort;
+    openModelSelector(host: OwnedUiDialogHost, initialSearchInput?: string): void;
+    openSessionSelector(host: OwnedUiDialogHost, onExit: () => void): Promise<void>;
+    /** `navigate` completes a selection that leaves the current leaf, including any summary prompt. */
+    openTreeSelector(host: OwnedUiDialogHost, navigate: (entryId: string, skipSummaryPrompt: boolean) => void, initialSelectedId?: string): Promise<void>;
+    openSettingsSelector(host: OwnedUiDialogHost): void;
+    openModelsDialog(host: OwnedUiDialogHost, initialQuery?: string): void;
+    openScopedModelsSelector(host: OwnedUiDialogHost): void;
+}

package/dist/contracts/owned-ui/session-presenters.js

@@ -0,0 +1 @@
+export {};