@timurproko/a1 0.2.6-dev.727 → 0.2.6-dev.736

package/dist/composition/owned-ui.d.ts

@@ -1,16 +1,34 @@
 import type { AvailableRelease, StartupReleaseCheckOptions } from "../foundation/release/latest-release.js";
 import type { NativeProcessIdentity } from "../foundation/lifecycle/model.js";
 import type { SessionSelection } from "../foundation/lifecycle/session-selection.js";
-import type { PiEngineAdapter } from "../integrations/pi/engine/adapter.js";
+import { type PiEngineHostOptions, type PiEngineSessionRequest } from "../integrations/pi/engine/host.js";
+import { type PiSessionPresenterBackend } from "../integrations/pi/session-presenters/index.js";
 import type { PiProjectTrustPreflightPrompt } from "../integrations/pi/engine/project-trust-preflight.js";
 import type { PiSessionForkPrompt } from "../integrations/pi/engine/session-selection.js";
 import { OwnedSettingsManager } from "../ui/settings/manager.js";
 import type { OwnedUiApplicationPort, PresentationTerminalPort } from "../contracts/presentation/index.js";
+import type { AgentSettingsPort } from "../contracts/agent-engine/index.js";
+import type { OwnedUiPromptSuggestionGeneratorPort, UiAccentColor } from "../contracts/owned-ui/index.js";
 import type { ReleaseNoteCatalog } from "../features/owned-ui/release-notes.js";
+/**
+ * The session backend composition wires: the owned-UI port, the prompt-suggestion generator, and
+ * the agent settings port. `settingsPort` stays outside the owned-UI contract because its type
+ * belongs to the agent-engine contracts, which the owned-UI contract may not import.
+ */
+export interface ComposedSessionBackend extends PiSessionPresenterBackend, OwnedUiPromptSuggestionGeneratorPort {
+    settingsPort(): AgentSettingsPort | null;
+}
+/** The process-level engine host as composition drives it: sessions, the live accent, and disposal. */
+export interface ComposedEngineHost {
+    create(request: PiEngineSessionRequest): Promise<ComposedSessionBackend>;
+    setAccentColor(color: UiAccentColor): void;
+    dispose(): Promise<void>;
+}
 export interface OwnedUiCompositionOptions {
     readonly cwd?: string;
     readonly terminal?: PresentationTerminalPort;
-    readonly createPiAdapter?: () => Promise<PiEngineAdapter>;
+    /** Test seam standing in for the Pi engine host; receives the options composition resolved. */
+    readonly createEngineHost?: (options: PiEngineHostOptions) => Promise<ComposedEngineHost>;
     /** Explicit file selection retained for SDK callers. Public CLI uses sessionSelection. */
     readonly sessionPath?: string;
     readonly sessionSelection?: SessionSelection;

package/dist/composition/owned-ui.js

@@ -7,9 +7,12 @@ import { resolvePromptHistoryPath } from "../features/prompt-history/paths.js";
 import { resolvePromptHistoryDataDir } from "../features/launch/profile-paths.js";
 import { resolveProductPaths } from "../foundation/lifecycle/paths.js";
 import { applyConfiguredPiTheme, getAvailablePiThemes, setPiAccentColor, setPiPackageBorderProjectionEnabled } from "../integrations/pi/components/upstream/theme/theme.js";
-import { createPiEngineAdapter } from "../integrations/pi/engine/adapter.js";
+import { createPiEngineHost } from "../integrations/pi/engine/host.js";
+import { createPiSessionPresenters } from "../integrations/pi/session-presenters/index.js";
 import { ClipboardDiagnosticCapture } from "../app/session-shell/clipboard-diagnostics.js";
-import { OwnedUiSessionShell } from "../app/session-shell/session-shell.js";
+import { createOwnedUiClipboardServices } from "../app/session-shell/clipboard-services.js";
+import { createPiKeybindingsHost } from "../integrations/pi/components/shell-shared-facade.js";
+import { OwnedUiSessionPresenter, OwnedUiTerminalHost, sessionTerminalHostOptions, } 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";
@@ -25,7 +28,8 @@ export async function composeOwnedUi(options = {}) {
     const sessionRuntimeId = ownedSurfaces ? process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId] : undefined;
     const inspectSessionProcess = options.inspectProcess;
     let sessionRuntimeIdentity = null;
-    let activeSessionIdentity = null;
+    // Invariant: one entry per agent of this runtime; each agent holds its own claim, and the runtime's exit releases all.
+    const activeSessionIdentities = new Map();
     let sessionRuntimeRefreshTimer = null;
     let sessionRuntimeRefresh = Promise.resolve();
     let sessionRuntimeDisposed = false;
@@ -36,59 +40,86 @@ export async function composeOwnedUi(options = {}) {
         return await sessionRuntimeIdentity;
     };
     const queueSessionRuntimeRefresh = () => {
-        if (sessionRuntimeDisposed || activeSessionIdentity === null || sessionRuntimeId === undefined || inspectSessionProcess === undefined)
+        if (sessionRuntimeDisposed || activeSessionIdentities.size === 0 || sessionRuntimeId === undefined || inspectSessionProcess === undefined)
             return;
         sessionRuntimeRefresh = sessionRuntimeRefresh.then(async () => {
-            const identity = activeSessionIdentity;
-            if (sessionRuntimeDisposed || identity === null)
+            if (sessionRuntimeDisposed)
                 return;
             const owner = await runtimeIdentity();
             if (owner === null)
                 return;
             const { registerSessionRepositoryRuntime } = await import("../foundation/lifecycle/session-repository-context.js");
-            await registerSessionRepositoryRuntime(identity, sessionRuntimeId, owner, { inspectProcess: inspectSessionProcess });
+            for (const [agentId, identity] of activeSessionIdentities) {
+                if (sessionRuntimeDisposed)
+                    return;
+                await registerSessionRepositoryRuntime(identity, sessionRuntimeId, owner, {
+                    inspectProcess: inspectSessionProcess,
+                    ...(agentId === undefined ? {} : { agentId }),
+                }).catch(() => undefined);
+            }
         }).catch(() => undefined);
     };
+    /** The repository context reader for one agent; undefined names the primary agent, the only one composed today. */
+    const repositoryContextReaderFor = (agentId) => async (sessionId, sessionFile, signal) => {
+        const owner = await runtimeIdentity();
+        if (owner === null || sessionRuntimeId === undefined || inspectSessionProcess === undefined)
+            return null;
+        const identity = { sessionId, sessionFile };
+        activeSessionIdentities.set(agentId, identity);
+        const { activateSessionRepositoryContext } = await import("../foundation/lifecycle/session-repository-context.js");
+        const context = await activateSessionRepositoryContext(identity, sessionRuntimeId, owner, {
+            signal,
+            inspectProcess: inspectSessionProcess,
+            ...(agentId === undefined ? {} : { agentId }),
+        });
+        armSessionRuntimeRefresh();
+        return context;
+    };
     const armSessionRuntimeRefresh = () => {
         if (sessionRuntimeRefreshTimer !== null)
             return;
         sessionRuntimeRefreshTimer = setInterval(queueSessionRuntimeRefresh, SESSION_RUNTIME_REFRESH_MS);
         sessionRuntimeRefreshTimer.unref();
     };
-    const adapter = options.createPiAdapter
-        ? await options.createPiAdapter()
-        : await createPiEngineAdapter({
-            cwd,
-            availableThemes: () => getAvailablePiThemes().map(theme => theme.name),
-            settingsProductMode: ownedSurfaces ? "bare" : "comparison",
-            announceStartupChangelog: !ownedSurfaces,
-            ...(ownedSurfaces ? {
-                repositoryContextReader: async (sessionId, sessionFile, signal) => {
-                    const owner = await runtimeIdentity();
-                    if (owner === null || sessionRuntimeId === undefined || inspectSessionProcess === undefined)
-                        return null;
-                    activeSessionIdentity = { sessionId, sessionFile };
-                    const { activateSessionRepositoryContext } = await import("../foundation/lifecycle/session-repository-context.js");
-                    const context = await activateSessionRepositoryContext(activeSessionIdentity, sessionRuntimeId, owner, { signal, inspectProcess: inspectSessionProcess });
-                    armSessionRuntimeRefresh();
-                    return context;
-                },
-            } : {}),
-            ...(options.sessionPath === undefined ? {} : { sessionPath: options.sessionPath }),
-            ...(options.sessionSelection === undefined ? {} : { sessionSelection: options.sessionSelection }),
-            ...(options.sessionForkPrompt === undefined ? {} : { sessionForkPrompt: options.sessionForkPrompt }),
-            ...(options.projectTrustPrompt === undefined ? {} : { projectTrustPrompt: options.projectTrustPrompt }),
-        });
     const productPaths = resolveProductPaths();
+    // Rationale: the manager reads the engine's settings port lazily, after the session exists.
+    let backend;
     const settings = options.profileId === undefined
         ? null
         : new OwnedSettingsManager({
             configDir: resolveProductPaths().configDir,
             profileId: options.profileId,
-            agentProvider: () => adapter.settingsPort(),
+            agentProvider: () => backend.settingsPort(),
             hiddenAgentSettingIds: ["fullscreenWheelScrollLines"],
             agentSettingLabelOverrides: { fullscreenCopyOnSelect: "Copy on select" },
         });
+    // Invariant: process-wide engine state has one owner. The host installs the HTTP dispatcher, applies
+    // the theme singletons, and announces startup notices once; every session is created through it.
+    const host = await (options.createEngineHost ?? (async (hostOptions) => createPiEngineHost(hostOptions)))({
+        productMode: ownedSurfaces ? "bare" : "comparison",
+        availableThemes: () => getAvailablePiThemes().map(theme => theme.name),
+        announceStartupChangelog: !ownedSurfaces,
+        theme: {
+            base: ownedSurfaces ? "dark" : "engine-configured",
+            accentColor: settings !== null && ownedSurfaces ? settings.value("accentColor") : "purple",
+            packageBorderProjection: ownedSurfaces,
+            apply: { base: applyConfiguredPiTheme, accentColor: setPiAccentColor, packageBorderProjection: setPiPackageBorderProjectionEnabled },
+        },
+        ...(options.projectTrustPrompt === undefined ? {} : { projectTrustPrompt: options.projectTrustPrompt }),
+    });
+    try {
+        backend = await host.create({
+            cwd,
+            ...(ownedSurfaces ? { repositoryContextReader: repositoryContextReaderFor(undefined) } : {}),
+            ...(options.sessionPath === undefined ? {} : { sessionPath: options.sessionPath }),
+            ...(options.sessionSelection === undefined ? {} : { sessionSelection: options.sessionSelection }),
+            ...(options.sessionForkPrompt === undefined ? {} : { sessionForkPrompt: options.sessionForkPrompt }),
+        });
+    }
+    catch (error) {
+        await host.dispose();
+        throw error;
+    }
     let releaseNotes = null;
     let releaseNotesFailure;
     if (ownedSurfaces) {
@@ -109,15 +140,9 @@ export async function composeOwnedUi(options = {}) {
         : await import("../features/owned-ui/release-note-state.js").then(module => module.claimReleaseNote({
             configDir: productPaths.configDir, profileId: options.profileId, version: currentReleaseNote.version,
         }));
-    // Compatibility: bare A1 intentionally ships one base visual target while its UI is being completed:
-    // dark, regardless of terminal detection or a previously stored Pi theme. Its owned accent projects
-    // over that base; comparison keeps Pi's configured theme and unmodified semantic accent.
-    setPiPackageBorderProjectionEnabled(ownedSurfaces);
-    setPiAccentColor(settings !== null && ownedSurfaces ? settings.value("accentColor") : "purple");
-    applyConfiguredPiTheme(ownedSurfaces ? "dark" : adapter.configuredTheme());
     const unsubscribeAccent = settings === null || !ownedSurfaces
         ? () => { }
-        : settings.onChange(current => setPiAccentColor(current.value("accentColor")));
+        : settings.onChange(current => host.setAccentColor(current.value("accentColor")));
     // Rationale: Routes open only after shell construction.
     const references = {
         changelog: async (input) => {
@@ -127,23 +152,28 @@ export async function composeOwnedUi(options = {}) {
             return { rows: width => renderPiShellChangelogLines(markdown, width).map(row => nativeHyperlinkStyle(row)) };
         },
         hotkeys: async () => {
-            const presentation = shell.hotkeysPresentation();
+            const presentation = presenter.hotkeysPresentation();
             const { renderPiShellHotkeySections } = await import("../integrations/pi/components/shell-hotkey-sections.js");
             return { sections: width => renderPiShellHotkeySections(presentation, width) };
         },
-        session: () => import("./session-info-reference.js").then(m => m.loadSessionInfoReference(adapter)),
+        session: () => import("./session-info-reference.js").then(m => m.loadSessionInfoReference(backend)),
     };
     const routeHost = settings === null || !ownedSurfaces ? null : createOwnedRouteHost(settings, references);
     const viewportSettings = settings === null || !ownedSurfaces ? null : {
         snapshot: () => viewportSettingsSnapshot(settings),
         onChange: listener => settings.onChange(() => listener(viewportSettingsSnapshot(settings))),
     };
+    const backgroundSettings = settings === null || !ownedSurfaces ? null : {
+        snapshot: () => settings.value("backgroundStyle"),
+        // Rationale: one manager notification also recomputes an accent-derived canvas after accentColor changes.
+        onChange: listener => settings.onChange(current => listener(current.value("backgroundStyle"))),
+    };
     const diagnosticDestination = options.suggestionDiagnosticsPath ?? process.env[PRODUCT_IDENTITY.environment.suggestionDiagnostics];
     const suggestionDiagnostics = settings !== null && ownedSurfaces && diagnosticDestination?.trim()
         ? new SuggestionDiagnosticCapture({ enabled: true, destination: diagnosticDestination }) : null;
     const promptSuggestions = settings === null || !ownedSurfaces ? null : {
         ...(suggestionDiagnostics === null ? {} : { diagnostics: suggestionDiagnostics }),
-        generator: adapter,
+        generator: backend,
         enabled: () => settings.value("promptSuggestions"),
         onChange: (listener) => settings.onChange(() => listener(settings.value("promptSuggestions"))),
     };
@@ -159,12 +189,12 @@ export async function composeOwnedUi(options = {}) {
     const historyLimit = settings?.value("promptHistoryMaxItems");
     const historyProfileLocation = settings === null || !ownedSurfaces || !settings.value("promptHistoryEnabled")
         ? null
-        : resolvePromptHistoryPath(resolvePromptHistoryDataDir(), adapter.agentDir);
+        : resolvePromptHistoryPath(resolvePromptHistoryDataDir(), backend.identity.agentDir);
     const promptHistory = historyProfileLocation === null ? null : {
         limit: typeof historyLimit === "number" ? historyLimit : 100,
         store: new PromptHistoryService({
             dataDir: resolvePromptHistoryDataDir(),
-            profileRoot: adapter.agentDir,
+            profileRoot: backend.identity.agentDir,
             limit: typeof historyLimit === "number" ? historyLimit : 100,
         }),
         imageSidecar: new PromptImageSidecar(historyProfileLocation.imagesDir),
@@ -172,13 +202,20 @@ export async function composeOwnedUi(options = {}) {
     const clipboardDestination = options.clipboardDiagnosticsPath ?? process.env[PRODUCT_IDENTITY.environment.clipboardDiagnostics];
     const clipboardDiagnostics = settings !== null && ownedSurfaces && clipboardDestination?.trim()
         ? new ClipboardDiagnosticCapture(clipboardDestination) : null;
-    let shell;
+    // Invariant: process-wide services are created once here and borrowed by every session shell. The
+    // keybinding registry is applied before any presenter is built, so none of them reads Pi's defaults.
+    const keybindings = createPiKeybindingsHost({ profile: ownedSurfaces ? "a1" : "pi", agentDir: backend.identity.agentDir });
+    const clipboardServices = ownedSurfaces ? createOwnedUiClipboardServices() : null;
+    let createdTerminalHost;
+    let terminalHost;
+    let presenter;
     let releaseNoteAcknowledgement = null;
     try {
-        shell = new OwnedUiSessionShell({
+        const presenterOptions = {
+            presenters: createPiSessionPresenters(backend),
             engine: {
-                backend: adapter,
-                cwd: adapter.cwd,
+                backend,
+                cwd: backend.identity.cwd,
                 ...(routeHost === null ? {} : { routeHost }),
                 ...(currentReleaseNote === null || releaseNoteClaim === null ? {} : {
                     startupRoute: {
@@ -196,6 +233,7 @@ export async function composeOwnedUi(options = {}) {
                 ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
                 ...(clipboardDiagnostics === null ? {} : { input: { onEvent: event => clipboardDiagnostics.runtime(event) } }),
                 ...(viewportSettings === null ? {} : { viewportSettings }),
+                ...(backgroundSettings === null ? {} : { backgroundSettings }),
                 ...(settings === null || !ownedSurfaces ? {} : {
                     quitOutro: { snapshot: () => quitOutroSettingsSnapshot(settings), interactive: process.stdout.isTTY === true },
                 }),
@@ -207,17 +245,26 @@ export async function composeOwnedUi(options = {}) {
             ...(promptSuggestions === null ? {} : { suggestions: promptSuggestions }),
             ...(promptImages === null ? {} : { promptImages }),
             ...(skills === null ? {} : { skills }),
+            shared: { keybindings, ...(clipboardServices === null ? {} : { clipboard: clipboardServices }) },
             ...(promptHistory === null ? {} : { history: {
                     ...promptHistory,
                     editor: await import("../integrations/pi/components/history-editor-loader.js").then(module => module.loadHistoryEditor()),
                 } }),
-        });
+        };
+        // Invariant: one terminal host owns the process terminal; the session presenter reaches it only through
+        // the host and paints once attached.
+        terminalHost = createdTerminalHost = new OwnedUiTerminalHost(sessionTerminalHostOptions(presenterOptions));
+        presenter = new OwnedUiSessionPresenter(terminalHost, presenterOptions);
+        terminalHost.attach(presenter);
     }
     catch (error) {
+        await createdTerminalHost?.dispose().catch(() => undefined);
         unsubscribeAccent();
         await releaseNoteClaim?.release();
         clipboardDiagnostics?.dispose();
         suggestionDiagnostics?.dispose();
+        clipboardServices?.dispose();
+        await host.dispose();
         throw error;
     }
     // Rationale: pinned Pi's version check is unreachable because the owned shell never runs its
@@ -233,32 +280,34 @@ export async function composeOwnedUi(options = {}) {
             ...(settings === null || !ownedSurfaces ? {} : { settingEnabled: settings.value("updateCheck") }),
         });
         if (release !== null)
-            adapter.announceReleaseUpdate(release);
+            backend.extensions.announceReleaseUpdate(release);
     };
     const exitNoticePath = process.env[PRODUCT_IDENTITY.environment.exitNoticePath];
     // Security: tools the agent runs must never see, or rewrite, this instance's notice.
     delete process.env[PRODUCT_IDENTITY.environment.exitNoticePath];
     let exitNotice = Promise.resolve(null);
     const application = {
-        get disposed() { return adapter.disposed; },
+        get disposed() { return backend.identity.disposed; },
         start: () => {
             // Performance: the guardian notice loads beside first paint, never on the startup path.
             if (exitNoticePath)
                 exitNotice = import("../app/session-shell/exit-notice.js")
-                    .then(module => module.armExitNotice(adapter, exitNoticePath), () => null);
-            shell.start();
+                    .then(module => module.armExitNotice(backend, exitNoticePath), () => null);
+            presenter.start();
             void announceNewerRelease().catch(() => undefined);
         },
-        flush: () => adapter.flushEvents(),
-        waitUntilStopped: () => shell.waitUntilStopped(),
+        flush: () => backend.session.flushEvents(),
+        waitUntilStopped: () => presenter.waitUntilStopped(),
         dispose: async () => {
             try {
-                await shell.dispose();
+                await terminalHost.dispose();
                 // Invariant: cleared only once the terminal is restored; a failed dispose leaves it armed.
                 (await exitNotice)?.clear();
                 await releaseNoteAcknowledgement?.catch(() => undefined);
             }
             finally {
+                // Invariant: the shared spares outlive every shell and stop only after the last one is disposed.
+                clipboardServices?.dispose();
                 unsubscribeAccent();
                 sessionRuntimeDisposed = true;
                 if (sessionRuntimeRefreshTimer !== null)
@@ -274,6 +323,8 @@ export async function composeOwnedUi(options = {}) {
                 await releaseNoteClaim?.release();
                 suggestionDiagnostics?.dispose();
                 clipboardDiagnostics?.dispose();
+                // Invariant: the host outlives the application; disposing it cancels host-level probes last.
+                await host.dispose();
             }
         },
     };

package/dist/composition/session-info-reference.d.ts

@@ -1,4 +1,4 @@
 import type { ReferenceDocumentProvider } from "../features/owned-ui/reference-screen-app.js";
-import type { PiEngineAdapter } from "../integrations/pi/engine/adapter.js";
+import type { OwnedUiSessionBackend } from "../contracts/owned-ui/index.js";
 /** Captures one current session snapshot and adapts it to the neutral reference document. */
-export declare function loadSessionInfoReference(adapter: PiEngineAdapter): Promise<ReferenceDocumentProvider>;
+export declare function loadSessionInfoReference(backend: OwnedUiSessionBackend): Promise<ReferenceDocumentProvider>;

package/dist/composition/session-info-reference.js

@@ -1,7 +1,7 @@
 import { renderPiShellSessionInfoReferenceDocument } from "../integrations/pi/components/shell-session-info-reference.js";
 /** Captures one current session snapshot and adapts it to the neutral reference document. */
-export async function loadSessionInfoReference(adapter) {
-    const result = await adapter.executeWorkflow({ command: "session", argument: "" });
+export async function loadSessionInfoReference(backend) {
+    const result = await backend.workflows.executeWorkflow({ command: "session", argument: "" });
     if (result.outcome !== "completed")
         throw new Error(result.message);
     if (result.presentation?.kind !== "session-info")

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

@@ -3,7 +3,11 @@ export type UiAccentColor = "purple" | "blue" | "cyan" | "green" | "orange" | "p
 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, OwnedUiPresenterHost, OwnedUiSessionPresenter, OwnedUiSessionPresenters, OwnedUiShortcutDescription, OwnedUiTerminalHost, 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";

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

@@ -1,5 +1,6 @@
 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";

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. */