@timurproko/a1 0.2.7-dev.1265 → 0.2.7-dev.1268

package/README.md

@@ -67,6 +67,8 @@ a1 --session <id>
 
 When a session exits, A1 prints the `a1 --session <id>` command that resumes it; a custom session store is included in the printed command. Closing the terminal ends the agent, as it does for Pi.
 
+Bare A1 automatically names unnamed sessions from the first prompt and regenerates automatic names on the next prompt after a worktree-context change. Manual `/name` renames are preserved. Names appear after footer stats, with a secondary-accent reveal for automatic changes. Disable **Automatic session name** in Agent settings; see [session names](docs/features/session-naming.md) for details.
+
 Show all commands:
 
 ```text

package/dist/app/session-shell/session-name-reveal.d.ts

@@ -0,0 +1,17 @@
+import type { OwnedUiSessionViewModel } from "../../contracts/owned-ui/index.js";
+interface RevealPorts {
+    active(): boolean;
+    frame(value: {
+        readonly from: string;
+        readonly elapsed: number;
+    } | null): boolean;
+    requestRender(): void;
+}
+/** Presenter-owned short-lived animation clock; saved provenance never replays on activation. */
+export declare class SessionNameReveal {
+    #private;
+    constructor(ports: RevealPorts);
+    update(view: OwnedUiSessionViewModel, binding: number): void;
+    stop(): void;
+}
+export {};

package/dist/app/session-shell/session-name-reveal.js

@@ -0,0 +1,49 @@
+/** Presenter-owned short-lived animation clock; saved provenance never replays on activation. */
+export class SessionNameReveal {
+    #ports;
+    #binding;
+    #seen;
+    #timer;
+    #animation;
+    constructor(ports) { this.#ports = ports; }
+    update(view, binding) {
+        const reveal = view.status.footer?.sessionNameReveal;
+        if (this.#binding !== binding) {
+            this.stop();
+            this.#binding = binding;
+            this.#seen = reveal?.id;
+            return;
+        }
+        if (reveal?.id === this.#seen)
+            return;
+        this.stop();
+        this.#seen = reveal?.id;
+        if (!reveal || !this.#ports.active())
+            return;
+        this.#animation = { from: reveal.from, started: performance.now() };
+        this.#tick();
+    }
+    stop() {
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+        this.#animation = undefined;
+        this.#ports.frame(null);
+    }
+    #tick() {
+        this.#timer = undefined;
+        const animation = this.#animation;
+        if (!animation || !this.#ports.active()) {
+            this.stop();
+            return;
+        }
+        const active = this.#ports.frame({ from: animation.from, elapsed: performance.now() - animation.started });
+        this.#ports.requestRender();
+        if (!active) {
+            this.#animation = undefined;
+            return;
+        }
+        this.#timer = setTimeout(() => this.#tick(), 15);
+        this.#timer.unref?.();
+    }
+}

package/dist/app/session-shell/session-shell-root.d.ts

@@ -1,4 +1,4 @@
-import type { OwnedUiShellComponents, OwnedUiShellHotkeysPresentation, OwnedUiShellClipboardContent, OwnedUiShellComponentPort, OwnedUiShellEditorPort, OwnedUiShellHeaderOptions, OwnedUiShellHeaderPort, OwnedUiShellHistoryEditor, OwnedUiShellImageAssetResolver, OwnedUiShellKeybindingsHost, OwnedUiShellLoadedResourcesPort } from "../../contracts/owned-ui/index.js";
+import type { OwnedUiShellComponents, OwnedUiShellHotkeysPresentation, OwnedUiShellClipboardContent, OwnedUiShellComponentPort, OwnedUiShellEditorPort, OwnedUiShellHeaderOptions, OwnedUiShellHeaderPort, OwnedUiShellHistoryEditor, OwnedUiShellImageAssetResolver, OwnedUiShellKeybindingsHost, OwnedUiShellLoadedResourcesPort, OwnedUiShellViewComponentPort } from "../../contracts/owned-ui/index.js";
 import type { TerminalComponentPort, TerminalInputCoordinationScheduler, TerminalInputDiagnosticsEvent, TerminalInputSurfaceKind, TerminalLayoutNode, TerminalPort } from "../../contracts/presentation/index.js";
 import type { ShellPresentationPorts, ThemeSource } from "../../contracts/presentation/index.js";
 import type { OwnedUiBackgroundSettingsPort, OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionBackend, OwnedUiSessionPresenters, OwnedUiSessionViewModel, OwnedUiTranscriptRendererPort, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, OwnedUiQuitOutroSettingsPort, SuggestionDecision, SuggestionDiagnosticObserver } from "../../contracts/owned-ui/index.js";
@@ -193,6 +193,7 @@ export declare class OwnedUiSessionShellRoot implements TerminalComponentPort {
     readonly resources: OwnedUiShellLoadedResourcesPort;
     /** The transcript's semantic rows, caches, and engine-backed block renderers. */
     readonly transcript: TranscriptDocument;
+    readonly footer: OwnedUiShellViewComponentPort;
     readonly promptChips: PromptChipStore;
     readonly viewport: SessionViewportController;
     /** Workflow results, messages, and status lines appended to the transcript. */

package/dist/app/session-shell/session-shell-root.js

@@ -24,7 +24,7 @@ export class OwnedUiSessionShellRoot {
     #themeUnsubscribe;
     #view;
     #status;
-    #footer;
+    footer;
     #queued;
     #extensionRenderers;
     #imageAssets;
@@ -78,7 +78,12 @@ export class OwnedUiSessionShellRoot {
             frame: progressStatusFrame,
         }, handlers);
         this.#status.setProgressPresentation(this.#customViewport ? "custom-viewport" : "pinned");
-        this.#footer = handlers.components.chrome.footer(this.#extensions.withStatuses(view), cwd, this.#customViewport ? "a1" : "pi", () => this.#footerLevel);
+        const footer = handlers.components.chrome.footer(this.#extensions.withStatuses(view), cwd, this.#customViewport ? "a1" : "pi", () => this.#footerLevel);
+        this.footer = { ...footer, setNameReveal: frame => {
+                const active = footer.setNameReveal?.(frame) ?? false;
+                this.#invalidateChrome();
+                return active && this.#extensions.footer === null;
+            } };
         this.editor = createShellEditor({
             handlers, theme: handlers.presentation.theme, components: handlers.components,
             customViewport: this.#customViewport,
@@ -273,7 +278,7 @@ export class OwnedUiSessionShellRoot {
             this.#syncWorkingOverride();
         }
         this.#status.update(view);
-        this.#footer.update(this.#extensions.withStatuses(view));
+        this.footer.update(this.#extensions.withStatuses(view));
         this.#queued.update(view.editor.queuedSubmissions);
         this.transcript.sync(view.transcript);
         this.editor.setSubmitEnabled(view.lifecycle !== "stopping" && view.lifecycle !== "stopped" && view.lifecycle !== "failed");
@@ -379,7 +384,7 @@ export class OwnedUiSessionShellRoot {
             status: layoutPort(width => this.#renderStatus(width), () => this.#status.invalidate()),
             editor: layoutPort(width => this.#input.surface.render(width), () => this.#input.surface.invalidate(), data => this.#input.surface.handleInput?.(data)),
             belowWidgets: layoutPort(width => this.#extensions.renderWidgets("belowEditor", width), () => this.#extensions.invalidate()),
-            footer: layoutPort(width => this.#renderFooter(width), () => (this.#extensions.footer ?? this.#footer).invalidate()),
+            footer: layoutPort(width => this.#renderFooter(width), () => (this.#extensions.footer ?? this.footer).invalidate()),
         };
     }
     #renderDocument(width) {
@@ -409,7 +414,7 @@ export class OwnedUiSessionShellRoot {
     }
     setExtensionStatus(key, text) {
         this.#extensions.setStatus(key, text);
-        this.#footer.update(this.#extensions.withStatuses(this.#view));
+        this.footer.update(this.#extensions.withStatuses(this.#view));
         this.invalidate();
     }
     setExtensionWorking(message, visible = this.#extensions.working.visible) {
@@ -453,7 +458,7 @@ export class OwnedUiSessionShellRoot {
     resetExtensionUi() {
         this.#extensions.reset();
         this.#syncWorkingOverride();
-        this.#footer.update(this.#extensions.withStatuses(this.#view));
+        this.footer.update(this.#extensions.withStatuses(this.#view));
         // Invariant: an extension renderer may have drawn transcript blocks that are now unrendered by it.
         this.transcript.invalidate("extension-renderers");
         this.invalidate();
@@ -505,7 +510,7 @@ export class OwnedUiSessionShellRoot {
             this.#input.surface.invalidate();
         this.#extensions.invalidate();
         this.#status.invalidate();
-        this.#footer.invalidate();
+        this.footer.invalidate();
         this.#queued.invalidate();
     }
     setFocused(focused) {
@@ -525,7 +530,7 @@ export class OwnedUiSessionShellRoot {
         this.#extensions.dispose();
         this.editor.dispose?.();
         this.#status.dispose?.();
-        this.#footer.dispose?.();
+        this.footer.dispose?.();
         this.#queued.dispose?.();
     }
     #invalidateTranscriptPresentation() {
@@ -536,7 +541,7 @@ export class OwnedUiSessionShellRoot {
         return this.#customViewport ? this.#status.renderLive(width) : this.#status.render(width);
     }
     #renderFooter(width) {
-        const footer = this.#extensions.footer ?? this.#footer;
+        const footer = this.#extensions.footer ?? this.footer;
         if (!this.#customViewport)
             return footer.render(width);
         width = Math.max(0, width - 2);

package/dist/app/session-shell/session-shell.js

@@ -69,6 +69,8 @@ export class OwnedUiSessionPresenter {
         terminal: () => this.#terminal,
         programStatus: () => this.#programStatus,
         titleEnabled: () => this.#customViewport && this.#started && !this.#disposed,
+        binding: () => this.backend.identity.sessionBindingGeneration,
+        nameFrame: frame => this.root.footer.setNameReveal?.(frame) ?? false,
     });
     #programStatus;
     #fullscreenExitOutput = "transcript";
@@ -281,6 +283,8 @@ export class OwnedUiSessionPresenter {
     }
     setFocused(focused) {
         this.root.setFocused(focused);
+        if (!focused)
+            this.#terminalPresentation.nameReveal.stop();
     }
     inputCoordinationSurface() {
         return this.root.inputCoordinationSurface();
@@ -296,6 +300,7 @@ export class OwnedUiSessionPresenter {
         return this.#layoutParts[part];
     }
     activated() {
+        this.#terminalPresentation.nameReveal.stop();
         const view = this.view();
         this.#terminalPresentation.syncProgress(view);
         this.#terminalPresentation.syncTitle(view, true);
@@ -664,6 +669,7 @@ export class OwnedUiSessionPresenter {
         if (this.#released !== undefined)
             return { exitText: "", failures: [], settle: async () => [] };
         this.#disposed = true;
+        this.#terminalPresentation.nameReveal.stop();
         const failures = [];
         const attempt = (action) => { try {
             action();

package/dist/app/session-shell/session-terminal-presentation.d.ts

@@ -1,14 +1,21 @@
 import type { OwnedUiSessionViewModel, OwnedUiShellProgramStatusReporter } from "../../contracts/owned-ui/index.js";
 import type { OwnedUiPresenterTerminal } from "./shell-host.js";
+import { SessionNameReveal } from "./session-name-reveal.js";
 interface SessionTerminalPresentationPorts {
     terminal(): OwnedUiPresenterTerminal;
     programStatus(): OwnedUiShellProgramStatusReporter;
     titleEnabled(): boolean;
+    binding(): number;
+    nameFrame(frame: {
+        readonly from: string;
+        readonly elapsed: number;
+    } | null): boolean;
 }
 /** Session-derived terminal state, published only through the presenter's guarded handle. */
 export declare class SessionTerminalPresentation {
     #private;
     progressEnabled: boolean;
+    readonly nameReveal: SessionNameReveal;
     constructor(ports: SessionTerminalPresentationPorts);
     syncTitle(view: OwnedUiSessionViewModel, force?: boolean): void;
     syncProgress(view: OwnedUiSessionViewModel): void;

package/dist/app/session-shell/session-terminal-presentation.js

@@ -1,12 +1,22 @@
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { SessionNameReveal } from "./session-name-reveal.js";
 /** Session-derived terminal state, published only through the presenter's guarded handle. */
 export class SessionTerminalPresentation {
     #ports;
     progressEnabled = false;
+    nameReveal;
     // Invariant: extension titles never change this memo, so unrelated views leave them alone.
     #lastCoreTitle;
-    constructor(ports) { this.#ports = ports; }
+    constructor(ports) {
+        this.#ports = ports;
+        this.nameReveal = new SessionNameReveal({
+            active: () => ports.titleEnabled() && ports.terminal().running && ports.terminal().attached,
+            frame: frame => ports.nameFrame(frame),
+            requestRender: () => ports.terminal().requestRender(),
+        });
+    }
     syncTitle(view, force = false) {
+        this.nameReveal.update(view, this.#ports.binding());
         const terminal = this.#ports.terminal();
         if (!this.#ports.titleEnabled() || !terminal.running || !terminal.attached)
             return;

package/dist/app/session-shell/shell-host.js

@@ -126,8 +126,10 @@ export class OwnedUiTerminalHost {
     }
     /** Forgets a presenter whose construction failed before it could be attached or released. */
     disconnect(presenter) {
-        if (this.#active === presenter)
+        if (this.#active === presenter) {
+            presenter.setFocused(false);
             this.#active = null;
+        }
         this.#forget(presenter);
     }
     attach(presenter) {

package/dist/composition/owned-ui.js

@@ -18,8 +18,11 @@ import { createOwnedRouteHost } from "./settings-route-host.js";
 import { renderPiShellChangelogLines } from "../integrations/pi/components/shell-presenters-info.js";
 import { nativeHyperlinkStyle } from "../ui/components/spans.js";
 import { SessionRuntimeRegistry } from "./session-runtime-registry.js";
+import { bindAutomaticSessionNaming } from "./session-naming.js";
 import { deferStartupReleaseUpdateObservation, readPackageVersion, StartupReleaseNote } from "./startup-route.js";
 import { createOwnedSettingsManager, watchSharedSettings } from "./owned-settings.js";
+/** Production default: without an inspector the registry never registers; loaded lazily. */
+const inspectLiveProcessOnDemand = async (pid) => (await import("../foundation/lifecycle/process-liveness.js")).inspectLiveProcess(pid);
 export async function composeOwnedUiApplication(options = {}) {
     return (await composeOwnedUi(options)).application;
 }
@@ -28,7 +31,7 @@ export async function composeOwnedUi(options = {}) {
     const productMode = options.productMode ?? "bare", bare = productMode === "bare";
     const sessionRuntimes = new SessionRuntimeRegistry({
         runtimeId: bare ? process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId] : undefined,
-        inspectProcess: options.inspectProcess,
+        inspectProcess: options.inspectProcess ?? inspectLiveProcessOnDemand,
     });
     const productPaths = resolveProductPaths();
     // Rationale: the manager reads the engine's settings port lazily, after the session exists.
@@ -70,6 +73,7 @@ export async function composeOwnedUi(options = {}) {
         await host.dispose();
         throw error;
     }
+    const naming = bindAutomaticSessionNaming(backend, bareSettings, bare);
     const releaseNote = await StartupReleaseNote.load({
         productMode,
         configDir: productPaths.configDir,
@@ -112,7 +116,7 @@ export async function composeOwnedUi(options = {}) {
     const suggestionDiagnostics = bareSettings !== null && diagnosticDestination?.trim()
         ? await import("../features/prompt-suggestions/diagnostics.js").then(module => new module.SuggestionDiagnosticCapture({ enabled: true, destination: diagnosticDestination })) : null;
     const barePorts = bareSettings === null ? null : bareShellPorts(bareSettings, backend, suggestionDiagnostics);
-    const promptHistory = createPromptHistoryConfiguration(settings, backend, bare);
+    const promptHistory = await createPromptHistoryConfiguration(settings, backend, bare);
     const clipboardDestination = options.clipboardDiagnosticsPath ?? process.env[PRODUCT_IDENTITY.environment.clipboardDiagnostics];
     const clipboardDiagnostics = bareSettings !== null && clipboardDestination?.trim()
         ? new ClipboardDiagnosticCapture(clipboardDestination) : null;
@@ -121,6 +125,7 @@ export async function composeOwnedUi(options = {}) {
     // Invariant: one release order for a failed construction and for dispose. The shared spares outlive every
     // shell and stop only after the last one is disposed; the host outlives the application and is released last.
     const releaseShared = async () => {
+        naming.dispose();
         clipboardServices?.dispose();
         unsubscribeAccent();
         await sessionRuntimes.dispose();
@@ -153,10 +158,7 @@ export async function composeOwnedUi(options = {}) {
                 } }),
             ...(barePorts === null ? {} : { suggestions: barePorts.suggestions, promptImages: barePorts.promptImages, skills: barePorts.skills }),
             shared: { keybindings: keybindingsHost, ...(clipboardServices === null ? {} : { clipboard: clipboardServices }) },
-            ...(promptHistory === null ? {} : { history: {
-                    ...promptHistory,
-                    editor: await import("../integrations/pi/components/history-editor-loader.js").then(module => module.loadHistoryEditor()),
-                } }),
+            ...(promptHistory === null ? {} : { history: promptHistory }),
         };
         // Invariant: one terminal host owns the process terminal; the session presenter reaches it only through
         // the host and paints once attached.
@@ -196,6 +198,7 @@ export async function composeOwnedUi(options = {}) {
         flush: () => backend.session.flushEvents(),
         waitUntilStopped: () => presenter.waitUntilStopped(),
         dispose: async () => {
+            naming.dispose();
             releaseUpdates.stop();
             try {
                 await terminalHost.dispose();
@@ -244,7 +247,7 @@ function bareShellPorts(settings, generator, diagnostics) {
         },
     };
 }
-function createPromptHistoryConfiguration(settings, backend, bare) {
+async function createPromptHistoryConfiguration(settings, backend, bare) {
     const limit = settings?.value("promptHistoryMaxItems") ?? 100;
     const scope = settings?.value("promptHistoryScope") ?? "unique";
     const enabled = settings !== null && bare && settings.value("promptHistoryEnabled");
@@ -263,6 +266,7 @@ function createPromptHistoryConfiguration(settings, backend, bare) {
     };
     return {
         limit, scope,
+        editor: await import("../integrations/pi/components/history-editor-loader.js").then(module => module.loadHistoryEditor()),
         ...(sessionId === null ? {} : { sessionId }),
         forScope,
         onScopeChange: (listener) => settings.onChange(() => listener(settings.value("promptHistoryScope"))),

package/dist/composition/session-backend.d.ts

@@ -1,5 +1,5 @@
 import type { AgentSettingsPort } from "../contracts/agent-engine/index.js";
-import type { OwnedUiPromptSuggestionGeneratorPort, UiAccentColor } from "../contracts/owned-ui/index.js";
+import type { OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionNamingPort, UiAccentColor } from "../contracts/owned-ui/index.js";
 import type { PiEngineSessionRequest } from "../integrations/pi/engine/host.js";
 import type { PiSessionPresenterBackend } from "../integrations/pi/session-presenters/index.js";
 /**
@@ -9,6 +9,7 @@ import type { PiSessionPresenterBackend } from "../integrations/pi/session-prese
  */
 export interface ComposedSessionBackend extends PiSessionPresenterBackend, OwnedUiPromptSuggestionGeneratorPort {
     settingsPort(): AgentSettingsPort | null;
+    readonly naming?: OwnedUiSessionNamingPort;
 }
 /** The process-level engine host as composition drives it: sessions, the live accent, and disposal. */
 export interface ComposedEngineHost {

package/dist/composition/session-naming.d.ts

@@ -0,0 +1,6 @@
+import type { OwnedSettingsManager } from "../ui/settings/manager.js";
+import type { ComposedSessionBackend } from "./session-backend.js";
+/** Connect product policy to the engine and consume verified context under lifecycle coordination. */
+export declare function bindAutomaticSessionNaming(backend: ComposedSessionBackend, settings: OwnedSettingsManager | null, bare: boolean): {
+    dispose(): void;
+};

package/dist/composition/session-naming.js

@@ -0,0 +1,22 @@
+import { SessionNamingController } from "../features/session-naming/index.js";
+/** Connect product policy to the engine and consume verified context under lifecycle coordination. */
+export function bindAutomaticSessionNaming(backend, settings, bare) {
+    if (!bare || !backend.naming)
+        return { dispose() { } };
+    const naming = new SessionNamingController({
+        backend, naming: backend.naming,
+        enabled: () => settings?.value("sessionAutoName") ?? true,
+        withContext: async (consume, signal) => {
+            const sessionId = backend.identity.currentHistorySessionId();
+            const sessionFile = backend.identity.currentSessionFile();
+            if (!sessionId || !sessionFile)
+                throw new Error("session identity unavailable");
+            const { withSessionRepositoryObservation } = await import("../foundation/lifecycle/session-repository-context.js");
+            return await withSessionRepositoryObservation({ sessionId, sessionFile }, consume, { signal });
+        },
+    });
+    const unsubscribe = settings?.onChange(() => naming.settingsChanged()) ?? (() => { });
+    let disposed = false;
+    return { dispose() { if (disposed)
+            return; disposed = true; naming.dispose(); unsubscribe(); } };
+}

package/dist/composition/session-runtime-registry.d.ts

@@ -11,7 +11,11 @@ export declare class SessionRuntimeRegistry {
     #private;
     constructor(options: SessionRuntimeRegistryOptions);
     /** The repository context reader for one agent; undefined names the primary agent. */
-    readerFor(agentId: string | undefined): (sessionId: string, sessionFile: string, signal: AbortSignal) => Promise<import("../foundation/lifecycle/session-repository-context.js").SessionRepositoryContext | null>;
+    readerFor(agentId: string | undefined): (sessionId: string, sessionFile: string, signal: AbortSignal) => Promise<{
+        cwd: string;
+        branch: string;
+        revision: string;
+    } | null>;
     /** Drain publication before releasing claims; never republish after disposal. */
     dispose(): Promise<void>;
 }

package/dist/composition/session-runtime-registry.js

@@ -23,14 +23,22 @@ export class SessionRuntimeRegistry {
                 const owner = await this.#ownerIdentity();
                 if (owner === null || !this.#current(agentId, identity))
                     return null;
-                const { activateSessionRepositoryContext } = await import("../foundation/lifecycle/session-repository-context.js");
+                const { activateSessionRepositoryContext, withSessionRepositoryObservation } = await import("../foundation/lifecycle/session-repository-context.js");
                 if (!this.#current(agentId, identity))
                     return null;
-                return await activateSessionRepositoryContext(identity, runtimeId, owner, {
+                const options = {
                     signal: AbortSignal.any([signal, this.#abort.signal]),
                     inspectProcess,
                     ...(agentId === undefined ? {} : { agentId }),
-                });
+                };
+                const selected = await activateSessionRepositoryContext(identity, runtimeId, owner, options);
+                if (selected === null)
+                    return null;
+                return await withSessionRepositoryObservation(identity, context => {
+                    if (context.branch === null)
+                        throw new Error("associated branch unavailable");
+                    return { cwd: context.cwd, branch: context.branch, revision: context.revision };
+                }, options);
             });
         };
     }

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

@@ -1,3 +1,4 @@
+export type { OwnedUiSessionNameState, OwnedUiSessionNameCompletion, OwnedUiSessionNamingPort } from "./session-naming.js";
 /** 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";

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

@@ -122,6 +122,12 @@ export interface OwnedUiUsageView {
 export interface OwnedUiFooterView {
     readonly branch: string | null;
     readonly repositoryPath?: string | null;
+    readonly repositoryRevision?: string | null;
+    /** Ephemeral automatic-apply identity; absent when loading a saved or manually named session. */
+    readonly sessionNameReveal?: {
+        readonly id: string;
+        readonly from: string;
+    };
     readonly pullRequest?: {
         readonly number: number;
         readonly url: string;

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

@@ -0,0 +1,22 @@
+/** Durable naming ownership and optimistic guard for one bound session. */
+export interface OwnedUiSessionNameState {
+    readonly sessionFile: string;
+    readonly binding: number;
+    readonly name: string | null;
+    readonly nameEntryId: string | null;
+    readonly source: "auto" | "user" | "unnamed";
+    readonly completedContext: string | null;
+}
+/** An isolated naming completion: never a conversation turn or a tool-using request. */
+export interface OwnedUiSessionNameCompletion {
+    readonly prompt: string;
+    readonly maxTokens: number;
+    readonly signal: AbortSignal;
+}
+/** Engine operations; repository coordination and product policy belong to the caller. */
+export interface OwnedUiSessionNamingPort {
+    state(): OwnedUiSessionNameState | null;
+    complete(request: OwnedUiSessionNameCompletion): Promise<string | null>;
+    /** Synchronous compare-and-apply, called only inside the caller's repository-context guard. */
+    apply(expected: OwnedUiSessionNameState, name: string, context: string): boolean;
+}

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

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

package/dist/contracts/owned-ui/shell-components.d.ts

@@ -89,6 +89,11 @@ export interface OwnedUiShellAutocompleteCommand {
 }
 export interface OwnedUiShellViewComponentPort extends OwnedUiShellComponentPort {
     update(view: OwnedUiSessionViewModel): void;
+    /** Footer-only ephemeral frame; returns whether its clipped name still needs animation. */
+    setNameReveal?(frame: {
+        readonly from: string;
+        readonly elapsed: number;
+    } | null): boolean;
 }
 export type OwnedUiShellStatusPlacement = "live" | "dock" | "hidden";
 export type OwnedUiShellProgressPresentationMode = "pinned" | "custom-viewport";

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

@@ -313,6 +313,11 @@ function assertOwnedUiStatusView(status) {
     if (status.footer !== undefined) {
         assertOptionalText(status.footer.branch, "owned-UI footer branch", MAX_LABEL_LENGTH);
         assertOptionalText(status.footer.repositoryPath ?? null, "owned-UI footer repository path", MAX_MESSAGE_LENGTH);
+        assertOptionalText(status.footer.repositoryRevision ?? null, "owned-UI footer repository revision", MAX_LABEL_LENGTH);
+        if (status.footer.sessionNameReveal !== undefined) {
+            assertBoundedText(status.footer.sessionNameReveal.id, "owned-UI name reveal id", MAX_LABEL_LENGTH);
+            assertPossiblyEmptyText(status.footer.sessionNameReveal.from, "owned-UI previous session name", MAX_LABEL_LENGTH);
+        }
         if (status.footer.pullRequest !== undefined && status.footer.pullRequest !== null) {
             const pullRequest = status.footer.pullRequest;
             assertIntegerInRange(pullRequest.number, 1, Number.MAX_SAFE_INTEGER, "owned-UI footer pull request number");

package/dist/features/session-naming/controller.d.ts

@@ -0,0 +1,21 @@
+import type { OwnedUiSessionBackend, OwnedUiSessionNamingPort } from "../../contracts/owned-ui/index.js";
+export interface SessionNamingContext {
+    readonly cwd: string;
+    readonly branch: string | null;
+    readonly revision: string;
+}
+interface NamingOptions {
+    readonly backend: Pick<OwnedUiSessionBackend, "identity" | "session">;
+    readonly naming: OwnedUiSessionNamingPort;
+    /** Executes the synchronous callback under authoritative repository-context coordination. */
+    readonly withContext: <T>(consume: (context: SessionNamingContext) => T, signal: AbortSignal) => Promise<T>;
+    readonly enabled: () => boolean;
+}
+/** One background naming chain per eligible prompt/context; owns no timers or engine objects. */
+export declare class SessionNamingController {
+    #private;
+    constructor(options: NamingOptions);
+    settingsChanged(): void;
+    dispose(): void;
+}
+export {};