@timurproko/a1 0.2.7-dev.1245 → 0.2.7-dev.1252

package/dist/composition/startup-route.d.ts

@@ -17,7 +17,6 @@ type UpdateObservationModule = Pick<typeof import("./release-update-observation.
 export declare function deferStartupReleaseUpdateObservation(options: StartupReleaseUpdateObservationOptions, load?: () => Promise<UpdateObservationModule>): {
     start(): void;
     stop(): void;
-    clientChanged(): void;
 };
 /**
  * The release notes bare A1 ships and the one note this version shows once per profile on startup:

package/dist/composition/startup-route.js

@@ -23,7 +23,6 @@ export function deferStartupReleaseUpdateObservation(options, load = () => impor
             }).catch(() => { });
         },
         stop() { stopped = true; observation?.stop(); },
-        clientChanged() { observation?.clientChanged(); },
     };
 }
 /**

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

@@ -3,7 +3,7 @@ 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 { 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, OwnedUiTimeFormat, 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";

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

@@ -53,10 +53,7 @@ export interface OwnedUiPromptSuggestionGeneratorPort {
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
 }
 export type OwnedUiThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
-export type OwnedUiTimeFormat = "20:00" | "8:00 PM";
 export interface OwnedUiViewportSettings {
-    /** Omitted by older SDK callers; bare A1 composition always supplies the owned default. */
-    readonly timeFormat?: OwnedUiTimeFormat;
     readonly scrollbarAppearance: "auto" | "always" | "hidden";
     readonly scrollbarStyle: "thin" | "thick";
     /** normal is baseline; fast is 2x normal; high is normal plus fast. */

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

@@ -339,14 +339,11 @@ export interface OwnedUiVisualExtensionSupport {
 }
 /** A newer release found by the startup check, or one installed for the next restart. */
 export type OwnedUiReleaseUpdate = {
-    readonly status: "client-connected";
-    readonly version: string;
-} | {
     readonly status?: "available";
     readonly version: string;
     readonly command: string;
     readonly changelogUrl: string | null;
 } | {
-    readonly status: "blocked" | "blocked-cleared" | "installed";
+    readonly status: "installed";
     readonly version: string;
 };

package/dist/features/launch/development-launch.js

@@ -36,7 +36,6 @@ export function resolveDevelopmentLaunchEnvironment(canonicalPackageRoot, releas
             [PRODUCT_IDENTITY.environment.configDir]: resolve(source[PRODUCT_IDENTITY.environment.configDir] ?? persistentConfigDir),
             [PRODUCT_IDENTITY.environment.dataDir]: dataDir,
             [PRODUCT_IDENTITY.environment.runtimeDir]: resolve(source[PRODUCT_IDENTITY.environment.runtimeDir] ?? join(developmentRoot, "runtime")),
-            [PRODUCT_IDENTITY.environment.databasePath]: resolve(source[PRODUCT_IDENTITY.environment.databasePath] ?? join(dataDir, PRODUCT_IDENTITY.endpoint.databaseFilename)),
         },
     };
 }

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

@@ -3,7 +3,7 @@ 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, InteractiveLaunchMode, LaunchIntent, LaunchProfileId, SessionSelection } 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";

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

@@ -3,12 +3,10 @@ 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 type InteractiveLaunchMode = "tabs" | "solo";
 export interface InteractiveLaunchIntent {
     readonly kind: "interactive";
     readonly profileId: LaunchProfileId;
-    readonly launchMode: InteractiveLaunchMode;
     readonly sessionSelection?: SessionSelection;
 }
 export type LaunchIntent = InteractiveLaunchIntent;
-export declare function interactiveLaunchIntent(profileId: LaunchProfileId, sessionSelection?: SessionSelection, launchMode?: InteractiveLaunchMode): InteractiveLaunchIntent;
+export declare function interactiveLaunchIntent(profileId: LaunchProfileId, sessionSelection?: SessionSelection): InteractiveLaunchIntent;

package/dist/features/launch/intent.js

@@ -1,11 +1,9 @@
 import { sessionSelectionArguments } from "../../foundation/lifecycle/index.js";
 export { parseSessionSelection } from "../../foundation/lifecycle/index.js";
-export function interactiveLaunchIntent(profileId, sessionSelection, launchMode = profileId === "a1" ? "tabs" : "solo") {
+export function interactiveLaunchIntent(profileId, sessionSelection) {
     if (sessionSelection !== undefined && profileId !== "a1") {
         throw new Error("session selection requires the A1 profile");
     }
-    if (profileId === "pi" && launchMode !== "solo")
-        throw new Error("the Pi comparison launch is always solo");
     sessionSelectionArguments(sessionSelection);
-    return Object.freeze({ kind: "interactive", profileId, launchMode, ...(sessionSelection === undefined ? {} : { sessionSelection }) });
+    return Object.freeze({ kind: "interactive", profileId, ...(sessionSelection === undefined ? {} : { sessionSelection }) });
 }

package/dist/features/launch/session-context.d.ts

@@ -1,4 +1,4 @@
-import { type NativeProcessIdentity, type SessionRepositoryIdentity, type SessionWorktreeInventoryEntry } from "../../foundation/lifecycle/index.js";
+import { type ProcessIdentity, type SessionRepositoryIdentity, type SessionWorktreeInventoryEntry } from "../../foundation/lifecycle/index.js";
 export { PRIMARY_SESSION_AGENT_ID } from "../../foundation/lifecycle/index.js";
 export type SessionContextRequest = {
     readonly action: "link-worktree";
@@ -19,6 +19,6 @@ export type SessionContextOutcome = {
 };
 export interface SessionContextRuntime {
     readonly runtimeId: string;
-    readonly inspectProcess: (pid: number) => Promise<NativeProcessIdentity | null>;
+    readonly inspectProcess: (pid: number) => Promise<ProcessIdentity | null>;
 }
 export declare function updateSessionRepositoryContext(identity: SessionRepositoryIdentity, request: SessionContextRequest, runtime: SessionContextRuntime): Promise<SessionContextOutcome>;

package/dist/features/owned-ui/reference-screen-app.d.ts

@@ -25,8 +25,6 @@ export interface ReferenceScreenOptions {
     readonly document: ReferenceDocumentProvider;
     /** The reader's scroll settings, read on every frame so a live change is honored. */
     readonly scrollSettings: () => OwnedUiViewportSettings;
-    /** The screen is a resident tab, such as the Changelog tab: it offers no screen-level close. */
-    readonly pinned?: boolean;
     /** Enables owned text selection for document routes that explicitly opt in. */
     readonly selection?: ReferenceDocumentSelectionOptions;
 }

package/dist/features/owned-ui/reference-screen-app.js

@@ -49,7 +49,6 @@ export class ReferenceScreenApp {
     #title;
     #document;
     #scrollSettings;
-    #pinned;
     #selection;
     #scroll = 0;
     #interruptArmed = false;
@@ -69,7 +68,6 @@ export class ReferenceScreenApp {
         this.#title = options.title;
         this.#document = options.document;
         this.#scrollSettings = options.scrollSettings;
-        this.#pinned = options.pinned === true;
         this.#selection = options.selection === undefined ? undefined : new ReferenceDocumentSelection(options.selection);
     }
     onActivate(host) {
@@ -178,8 +176,7 @@ export class ReferenceScreenApp {
         switch (action) {
             case "close":
                 this.#selection?.handleInput(data);
-                if (!this.#pinned)
-                    host.close();
+                host.close();
                 return { consumed: true };
             case "up":
                 this.#scrollBy(-1);
@@ -250,12 +247,8 @@ export class ReferenceScreenApp {
         }
         return { owned: true, changed: true };
     }
-    // Invariant: a pinned screen is its tab and `Esc` does not close it, so it shows no close hint.
     #hintEntries() {
-        const entries = REFERENCE_SCREEN_SHORTCUTS.hintEntries(SCOPE);
-        if (!this.#pinned)
-            return entries;
-        return entries.filter(entry => entry.key !== DIALOG_CLOSE_SHORTCUT_HINT.key || entry.action !== DIALOG_CLOSE_SHORTCUT_HINT.action);
+        return REFERENCE_SCREEN_SHORTCUTS.hintEntries(SCOPE);
     }
     // Invariant: the title is the first document row, as in v2, so it scrolls with the document.
     #content(width, theme) {

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

@@ -13,15 +13,9 @@ export declare const SETTINGS_SHORTCUTS: ShortcutRegistry<Action>;
 export declare class SettingsApp implements UiApp {
     #private;
     readonly id = "settings";
-    /**
-     * `pinned` presents the screen as a resident Settings tab, which offers no screen-level close;
-     * `configurePlusMenu` opens the tab bar's Plus Menu dialog in place of this screen's own.
-     */
     constructor(session: OwnedSettingsManager, options: {
-        readonly pinned?: boolean;
         readonly searchInputFactory: SettingsSearchInputFactory;
         readonly copyText?: (text: string) => void;
-        readonly configurePlusMenu?: (() => boolean) | null;
         readonly dialogPanel?: (text: string) => string;
     });
     onActivate(host: AppHostServices): void;

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

@@ -1,6 +1,5 @@
 import { DIALOG_BACK_SHORTCUT_HINT, DIALOG_CLOSE_SHORTCUT_HINT } from "../../contracts/presentation/index.js";
-import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, numericValues, RAIL_COLUMNS, renderCenteredDialogOverlay, renderDialogPanel, renderSteppedDialogPanel, renderEmptyState, renderGroupHeader, renderListRow, renderNote, renderShortcutHintsWithClose, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, truncateToWidth, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, formatLocalTime, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, layoutList, moveSelection, rowKey, scrollForSelection, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, ScrollbarRails, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
-import { FlagToggleDialog, PLUS_MENU_SETTING_ID, PlusMenuDialog } from "./plus-menu-dialog.js";
+import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, numericValues, RAIL_COLUMNS, renderCenteredDialogOverlay, renderDialogPanel, renderSteppedDialogPanel, renderEmptyState, renderGroupHeader, renderListRow, renderNote, renderShortcutHintsWithClose, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, truncateToWidth, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, layoutList, moveSelection, rowKey, scrollForSelection, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, ScrollbarRails, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
 import { SETTINGS_APP_ID } from "./settings-route.js";
 export { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
 const SCOPE = SETTINGS_APP_ID;
@@ -22,7 +21,6 @@ const SCROLL_LINGER_MS = 900;
 const SCROLL_LINGER_REPAINT_MS = 925;
 /** What a structured value offers instead of printing itself. */
 const CONFIGURE = "configure";
-const TAB_BAR_RIGHT_ITEMS_SETTING_ID = "tabBarRightItems";
 export const SETTINGS_SHORTCUTS = new ShortcutRegistry();
 SETTINGS_SHORTCUTS.declare({ key: "edit", scope: SCOPE, description: "Search settings", section: "Change", hint: { keys: "Type", does: "search" } }, "edit-filter");
 SETTINGS_SHORTCUTS.declare({ key: "up", scope: SCOPE, description: "Previous setting", section: "Navigate", hint: { keys: "↑↓", does: "navigate" } }, "move-up");
@@ -120,15 +118,9 @@ export class SettingsApp {
     #activityTimer;
     #renderedScroll;
     #options;
-    /**
-     * `pinned` presents the screen as a resident Settings tab, which offers no screen-level close;
-     * `configurePlusMenu` opens the tab bar's Plus Menu dialog in place of this screen's own.
-     */
     constructor(session, options) {
         this.#session = session;
         this.#options = {
-            pinned: options.pinned === true,
-            configurePlusMenu: options.configurePlusMenu ?? null,
             dialogPanel: options.dialogPanel ?? null,
         };
         this.#search = {
@@ -275,8 +267,7 @@ export class SettingsApp {
         const selected = indexOfKey(rows, this.#selectedKey);
         switch (action) {
             case "close":
-                if (!this.#options.pinned)
-                    host.close();
+                host.close();
                 return { consumed: true };
             case "edit-filter":
                 return { consumed: false };
@@ -517,9 +508,6 @@ export class SettingsApp {
         // selector may open empty so it can truthfully report that no authenticated models exist.
         if (entry.flags.length === 0 && modelDialog !== "default")
             return;
-        // Rationale: beside a tab bar, its own Plus Menu dialog configures `+`, so both ways look the same.
-        if (entry.backend === "a1" && entry.id === PLUS_MENU_SETTING_ID && this.#options.configurePlusMenu?.() === true)
-            return;
         const stored = typeof entry.rawValue === "object" && entry.rawValue !== null && !Array.isArray(entry.rawValue)
             ? entry.rawValue
             : {};
@@ -540,13 +528,6 @@ export class SettingsApp {
             entry,
             flags: entry.flags.map(flag => flag.key),
             modelDialog,
-            flagDialog: entry.backend !== "a1" ? null
-                : entry.id === PLUS_MENU_SETTING_ID ? new PlusMenuDialog(entry.flags)
-                    : entry.id === TAB_BAR_RIGHT_ITEMS_SETTING_ID ? new FlagToggleDialog(entry.flags, {
-                        title: "Right Side",
-                        description: "Choose what the right side of the tab bar shows.",
-                        empty: "No items match",
-                    }) : null,
             filter: modelDialog === null ? null : new LineInput(""),
             step: "model",
             modelKey: null,
@@ -562,12 +543,6 @@ export class SettingsApp {
             return { consumed: false };
         if (open.modelDialog !== null)
             return this.#modelDialogKey(open, data);
-        if (open.flagDialog !== null) {
-            const outcome = open.flagDialog.handle(KEYS[data] ?? data, data, key => this.#toggleFlag(open.flags.indexOf(key)));
-            if (outcome === "close")
-                this.#structured = null;
-            return { consumed: true };
-        }
         switch (SETTINGS_SHORTCUTS.resolve(KEYS[data] ?? data, DIALOG_SCOPE)) {
             case "close":
                 this.#structured = null;
@@ -1036,8 +1011,6 @@ export class SettingsApp {
     #dialogLines(open, width, height, theme) {
         if (open.modelDialog !== null)
             return this.#modelDialogLines(open, width, height, theme);
-        if (open.flagDialog !== null)
-            return open.flagDialog.lines(open.record, width, theme);
         const rows = open.flags.map(key => {
             const declared = open.entry.flags.find(flag => flag.key === key);
             return {
@@ -1111,8 +1084,7 @@ export class SettingsApp {
     #footerLines(width, theme) {
         // Rationale: standing guidance is more useful than transient feedback; failures still
         // roll back without displacing the Settings interaction contract.
-        const entries = SETTINGS_SHORTCUTS.hintEntries(SCOPE).filter(entry => !this.#options.pinned
-            || entry.key !== DIALOG_CLOSE_SHORTCUT_HINT.key || entry.action !== DIALOG_CLOSE_SHORTCUT_HINT.action);
+        const entries = SETTINGS_SHORTCUTS.hintEntries(SCOPE);
         const status = renderShortcutHintsWithClose(entries, theme, width, width > 0 ? 1 : 0);
         const input = this.#search.input;
         if (input === null)
@@ -1224,11 +1196,8 @@ function labelOf(entry) {
 function rangeOf(entry) {
     return { minimum: entry.minimum, maximum: entry.maximum, values: numericValues(entry.choices) };
 }
-/** Booleans read as yes and no; time-format choices preview the current local time. */
-function displaySettingValue(entry, value) {
-    if (entry.backend === "a1" && entry.id === "timeFormat" && (value === "20:00" || value === "8:00 PM")) {
-        return formatLocalTime(new Date(), value) ?? value;
-    }
+/** Booleans read as yes and no. */
+function displaySettingValue(_entry, value) {
     if (typeof value === "boolean")
         return value ? "yes" : "no";
     return String(value);

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

@@ -6,12 +6,7 @@ export declare const PRIVATE_ENVIRONMENT: Readonly<{
     releaseDigest: "LAUNCH_CONTEXT_RELEASE_DIGEST";
     releaseLayers: "LAUNCH_CONTEXT_RELEASE_LAYERS";
     launchProfile: "LAUNCH_CONTEXT_PROFILE";
-    launchMode: "LAUNCH_CONTEXT_MODE";
-    updateVersion: "LAUNCH_CONTEXT_UPDATE_VERSION";
     immutableWarmup: "LAUNCH_CONTEXT_WARMUP";
-    residentRootExecutable: "LAUNCH_CONTEXT_RESIDENT_ROOT_EXECUTABLE";
-    residentRootArguments: "LAUNCH_CONTEXT_RESIDENT_ROOT_ARGUMENTS";
-    residentFallback: "LAUNCH_CONTEXT_RESIDENT_FALLBACK";
 }>;
 /**
  * Keys published by releases that predate the neutral cutover. They are read when
@@ -35,15 +30,8 @@ export interface LaunchContext {
     readonly releaseDigest?: string;
     readonly releaseLayers?: string;
     readonly launchProfile?: "a1" | "pi";
-    readonly launchMode?: "tabs" | "solo";
-    readonly updateVersion?: string;
     readonly immutableWarmup?: "1";
-    readonly residentRootExecutable?: string;
-    readonly residentRootArguments?: string;
-    readonly residentFallback?: string;
 }
-/** The Tabs settings configure resident tabs; a direct-route launch, by `a1 solo` or by a fallback, hides them. */
-export declare function hidesTabSettings(context: Pick<LaunchContext, "launchMode" | "residentFallback">): boolean;
 export type LaunchContextRequirement = "optional" | "profile" | "release" | "warmup";
 /** Read current keys, fall back to superseded keys per field, with bounded diagnostics. */
 export declare function readLaunchContext(environment: NodeJS.ProcessEnv, requirement?: LaunchContextRequirement, platform?: NodeJS.Platform): LaunchContext;

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

@@ -6,12 +6,7 @@ export const PRIVATE_ENVIRONMENT = Object.freeze({
     releaseDigest: "LAUNCH_CONTEXT_RELEASE_DIGEST",
     releaseLayers: "LAUNCH_CONTEXT_RELEASE_LAYERS",
     launchProfile: "LAUNCH_CONTEXT_PROFILE",
-    launchMode: "LAUNCH_CONTEXT_MODE",
-    updateVersion: "LAUNCH_CONTEXT_UPDATE_VERSION",
     immutableWarmup: "LAUNCH_CONTEXT_WARMUP",
-    residentRootExecutable: "LAUNCH_CONTEXT_RESIDENT_ROOT_EXECUTABLE",
-    residentRootArguments: "LAUNCH_CONTEXT_RESIDENT_ROOT_ARGUMENTS",
-    residentFallback: "LAUNCH_CONTEXT_RESIDENT_FALLBACK",
 });
 /**
  * Keys published by releases that predate the neutral cutover. They are read when
@@ -32,10 +27,6 @@ const SUPERSEDED_ENTRIES = Object.entries(SUPERSEDED_ENVIRONMENT);
 const PRIVATE_KEYS = new Set([...Object.values(PRIVATE_ENVIRONMENT), ...Object.values(SUPERSEDED_ENVIRONMENT)]);
 const LOGICAL_KEYS = new Map(PRIVATE_ENTRIES.map(([logical, key]) => [key, logical]));
 const SUPERSEDED_LOGICAL_KEYS = new Map(SUPERSEDED_ENTRIES.map(([logical, key]) => [key, logical]));
-/** The Tabs settings configure resident tabs; a direct-route launch, by `a1 solo` or by a fallback, hides them. */
-export function hidesTabSettings(context) {
-    return context.launchMode === "solo" || context.residentFallback !== undefined;
-}
 /** Read current keys, fall back to superseded keys per field, with bounded diagnostics. */
 export function readLaunchContext(environment, requirement = "optional", platform = process.platform) {
     const values = {};
@@ -70,25 +61,8 @@ export function readLaunchContext(environment, requirement = "optional", platfor
     if (values.launchProfile !== undefined && values.launchProfile !== "a1" && values.launchProfile !== "pi") {
         throw invalidContext("launchProfile", "unsupported profile");
     }
-    if (values.launchMode !== undefined && values.launchMode !== "tabs" && values.launchMode !== "solo") {
-        throw invalidContext("launchMode", "unsupported launch mode");
-    }
-    if (values.launchProfile === "pi" && values.launchMode === "tabs")
-        throw invalidContext("launchMode", "Pi comparison cannot use tabs");
     if (values.immutableWarmup !== undefined && values.immutableWarmup !== "1")
         throw invalidContext("immutableWarmup", "invalid permission flag");
-    if ((values.residentRootExecutable === undefined) !== (values.residentRootArguments === undefined))
-        throw invalidContext("residentRootExecutable", "resident root command is incomplete");
-    if (values.residentRootArguments !== undefined) {
-        try {
-            const argumentsValue = JSON.parse(values.residentRootArguments);
-            if (!Array.isArray(argumentsValue) || argumentsValue.some(value => typeof value !== "string"))
-                throw new Error("not string arguments");
-        }
-        catch {
-            throw invalidContext("residentRootArguments", "invalid JSON argument list");
-        }
-    }
     if (values.releaseDigest !== undefined && !/^[a-f0-9]{64}$/.test(values.releaseDigest))
         throw invalidContext("releaseDigest", "invalid digest");
     if (requirement === "profile")

package/dist/foundation/lifecycle/claim-gate.d.ts

@@ -0,0 +1,8 @@
+export interface ClaimGateHandle {
+    release(): void;
+}
+/**
+ * Try once to hold the worktree mutation gate. The gate is a lock directory beside the authority
+ * file; contention returns null so the caller keeps its own bounded retry.
+ */
+export declare function tryAcquireClaimGate(path: string): ClaimGateHandle | null;

package/dist/foundation/lifecycle/claim-gate.js

@@ -0,0 +1,37 @@
+import lockfile from "proper-lockfile";
+/** A stalled mutation loses the gate after this bound instead of holding it until the process ends. */
+const CLAIM_GATE_STALE_MS = 10_000;
+/**
+ * Try once to hold the worktree mutation gate. The gate is a lock directory beside the authority
+ * file; contention returns null so the caller keeps its own bounded retry.
+ */
+export function tryAcquireClaimGate(path) {
+    let release;
+    try {
+        release = lockfile.lockSync(path, {
+            realpath: false,
+            lockfilePath: `${path}.gate`,
+            stale: CLAIM_GATE_STALE_MS,
+            onCompromised: () => { },
+        });
+    }
+    catch (cause) {
+        if (cause instanceof Error && "code" in cause && cause.code === "ELOCKED")
+            return null;
+        throw Object.assign(new Error("cannot access the worktree mutation gate; check A1 data-directory permissions and filesystem availability", { cause }), {
+            code: "worktree-coordination-io",
+        });
+    }
+    let released = false;
+    return {
+        release() {
+            if (released)
+                return;
+            released = true;
+            try {
+                release();
+            }
+            catch { /* Compatibility: a reclaimed stale gate is already gone. */ }
+        },
+    };
+}

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

@@ -1,13 +1,9 @@
-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 { assertLaunchProfileId } from "./model.js";
+export type { LaunchProfileId, ProcessIdentity } from "./model.js";
+export { PID_LIVENESS_IDENTITY, inspectLiveProcess } from "./process-liveness.js";
+export { resolveProductPaths } from "./paths.js";
+export type { ProductPaths } from "./paths.js";
 export { parseSessionSelection, sessionSelectionArguments } from "./session-selection.js";
 export type { SessionSelection } from "./session-selection.js";
 export { PRIMARY_SESSION_AGENT_ID, activateSessionRepositoryContext, clearSessionRepositoryContext, listSessionRepositoryWorktrees, readSessionRepositoryContext, registerSessionRepositoryRuntime, releaseSessionRepositoryRuntime, setSessionRepositoryContext, } from "./session-repository-context.js";
 export type { SessionRepositoryContext, SessionRepositoryContextOptions, SessionRepositoryIdentity, SessionWorktreeInventoryEntry, SessionWorktreeStatus, } from "./session-repository-context.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 { assertLaunchInstance, assertLaunchInstanceOutcome, assertLaunchInstanceTransition, assertProcessContainmentIdentity } from "./launch-instance.js";
-export { assertDimensions, assertLaunchProfileId, assertNativeProcessIdentity, assertTransparentTerminalLaunchProfile } from "./model.js";
-export { resolveCohortEndpoint, resolveProductPaths } from "./paths.js";
+export { assertLaunchProfileId } from "./model.js";
+export { PID_LIVENESS_IDENTITY, inspectLiveProcess } from "./process-liveness.js";
+export { resolveProductPaths } from "./paths.js";
 export { parseSessionSelection, sessionSelectionArguments } from "./session-selection.js";
 export { PRIMARY_SESSION_AGENT_ID, activateSessionRepositoryContext, clearSessionRepositoryContext, listSessionRepositoryWorktrees, readSessionRepositoryContext, registerSessionRepositoryRuntime, releaseSessionRepositoryRuntime, setSessionRepositoryContext, } from "./session-repository-context.js";
-export { createSupervisorStartupAttempt, publishSupervisorStartupResult, readSupervisorStartupResult, supervisorStartupFailure, supervisorStartupReady, supervisorStartupResultPath, } from "./supervisor-startup.js";

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

@@ -1,64 +1,7 @@
 export type LaunchProfileId = "a1" | "pi";
-export type GenerationId = string;
-export type DriverProfileId = string;
-export type RequestId = string;
-export interface TerminalDimensions {
-    readonly columns: number;
-    readonly rows: number;
-}
-export interface TransparentTerminalLaunchProfile {
-    readonly id: DriverProfileId;
-    readonly terminalCapability: "transparent";
-    readonly executable: string;
-    readonly arguments: readonly string[];
-    readonly cwd: string;
-    readonly environment: Readonly<Record<string, string>>;
-    readonly terminalType: string;
-    readonly dimensions: TerminalDimensions;
-    readonly ownerDisconnect: "stop" | "detach";
-    readonly recovery: "detach-only" | "none";
-    readonly surface: "none";
-    readonly visualReconnection: "none";
-}
-export interface NativeProcessIdentity {
+/** A process as session coordination records it: a pid plus the identity its writer observed. */
+export interface ProcessIdentity {
     readonly pid: number;
     readonly startIdentity: string;
 }
-export type TransparentTerminalLifecycleOutcome = {
-    readonly kind: "exited";
-    readonly exitCode: number;
-} | {
-    readonly kind: "signaled";
-    readonly signal: string;
-} | {
-    readonly kind: "stopped";
-    readonly reason: "owner-disconnect" | "user-request" | "update";
-} | {
-    readonly kind: "detached";
-    readonly reason: "owner-disconnect";
-} | {
-    readonly kind: "spawn-error" | "broker-error";
-    readonly message: string;
-    readonly code: string | null;
-};
-export interface SupervisorSnapshot {
-    readonly revision: number;
-    readonly activeInstances: readonly {
-        readonly id: string;
-        readonly profileId: LaunchProfileId;
-        readonly state: "requested" | "active" | "stopping";
-    }[];
-}
-export interface CommandResult {
-    readonly requestId: RequestId;
-    readonly ok: boolean;
-    readonly revision: number;
-    readonly error?: {
-        readonly code: "invalid-command" | "not-found" | "stale-generation" | "capability-error" | "containment-unsupported" | "ownership-error" | "release-superseded" | "driver-error";
-        readonly message: string;
-    };
-}
 export declare function assertLaunchProfileId(value: unknown): asserts value is LaunchProfileId;
-export declare function assertDimensions(dimensions: TerminalDimensions): void;
-export declare function assertTransparentTerminalLaunchProfile(profile: TransparentTerminalLaunchProfile): void;
-export declare function assertNativeProcessIdentity(identity: NativeProcessIdentity): void;

package/dist/foundation/lifecycle/model.js

@@ -3,38 +3,3 @@ export function assertLaunchProfileId(value) {
     if (value !== "a1" && value !== "pi")
         throw new TypeError(PRODUCT_TEXT.diagnostic(`launch profile is invalid: ${String(value)}`));
 }
-export function assertDimensions(dimensions) {
-    if (!Number.isInteger(dimensions.columns) || dimensions.columns < 2 || dimensions.columns > 500) {
-        throw new RangeError("terminal columns must be an integer from 2 to 500");
-    }
-    if (!Number.isInteger(dimensions.rows) || dimensions.rows < 1 || dimensions.rows > 300) {
-        throw new RangeError("terminal rows must be an integer from 1 to 300");
-    }
-}
-export function assertTransparentTerminalLaunchProfile(profile) {
-    if (!profile.id || profile.terminalCapability !== "transparent")
-        throw new TypeError("invalid transparent terminal profile identity");
-    if (!profile.executable || profile.executable.includes("\0"))
-        throw new TypeError("transparent executable must be non-empty and contain no null byte");
-    if (!profile.cwd || profile.cwd.includes("\0"))
-        throw new TypeError("transparent working directory must be non-empty and contain no null byte");
-    if (profile.arguments.some(value => typeof value !== "string" || value.includes("\0")))
-        throw new TypeError("transparent arguments must contain no null byte");
-    if (Object.entries(profile.environment).some(([name, value]) => !name || name.includes("=") || name.includes("\0") || value.includes("\0"))) {
-        throw new TypeError("transparent environment contains an invalid name or value");
-    }
-    if (!profile.terminalType || profile.terminalType.includes("\0"))
-        throw new TypeError("transparent terminal type is invalid");
-    assertDimensions(profile.dimensions);
-    if (profile.surface !== "none" || profile.visualReconnection !== "none")
-        throw new TypeError("transparent profiles cannot declare a surface or visual reconnection");
-    if (profile.ownerDisconnect === "detach" && profile.recovery !== "detach-only")
-        throw new TypeError("transparent detach policy requires detach-only recovery");
-    if (profile.ownerDisconnect === "stop" && profile.recovery !== "none")
-        throw new TypeError("transparent stop policy requires no recovery claim");
-}
-export function assertNativeProcessIdentity(identity) {
-    if (!Number.isSafeInteger(identity.pid) || identity.pid <= 0 || !identity.startIdentity || identity.startIdentity.includes("\0")) {
-        throw new TypeError("invalid native process identity");
-    }
-}

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

@@ -2,29 +2,5 @@ export interface ProductPaths {
     readonly configDir: string;
     readonly dataDir: string;
     readonly runtimeDir: string;
-    readonly databasePath: string;
-    /** The endpoint written by releases that predate cohort-scoped identity. */
-    readonly endpoint: string;
-    /** The metadata written by releases that predate cohort-scoped identity. */
-    readonly endpointMetadataPath: string;
-    readonly endpointsDir: string;
-    /** A short, A1-managed socket directory when the host imposes a small Unix-path limit. */
-    readonly endpointDirectory?: string | null;
-    readonly supervisorLogPath: string;
 }
-/** Where one cohort listens, and where it records that it is listening. */
-export interface CohortEndpointPaths {
-    readonly endpoint: string;
-    readonly endpointMetadataPath: string;
-}
-/**
- * Endpoint identity for one release cohort. Two cohorts can be live at once — an update
- * leaves a working session on the release it started on — so the name a supervisor listens
- * on has to name the release as well as the runtime directory, or the two contend for one
- * endpoint and replacing one means ending the other.
- *
- * An explicit endpoint override keeps its single endpoint: it is how an isolated run pins
- * the address it is going to talk to.
- */
-export declare function resolveCohortEndpoint(paths: ProductPaths, releaseId: string, environment?: NodeJS.ProcessEnv, hostPlatform?: NodeJS.Platform): CohortEndpointPaths;
 export declare function resolveProductPaths(environment?: NodeJS.ProcessEnv, hostPlatform?: NodeJS.Platform, fallbackHome?: string): ProductPaths;