@timurproko/a1 0.2.7-dev.1287 → 0.2.7-dev.1290

package/README.md

@@ -99,6 +99,10 @@ a1 pi
 
 <p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 
+## Session colors
+
+Settings → Appearance separates a saved **Default color** (initially blue) from **Current color**, which affects only this session. Both offer blue, green, orange, pink, purple, cyan, and grey. External applications can read and change a targeted session through the [always-JSON local color API](docs/features/session-colors.md).
+
 ## Update
 
 Update on the channel you already use (release stays on release, develop stays on develop):

package/bin/cli.js

@@ -54,6 +54,10 @@ process.exitCode = await dispatchCli(process.argv.slice(2), {
     const { createPiPackagesPort } = await import("../dist/integrations/pi/engine/package-integration.js");
     return await runPackageCommand(request, { createPort: createPiPackagesPort });
   },
+  sessionColor: async arguments_ => {
+    const { runSessionColorCommand } = await import("../dist/cli/session-color.js");
+    return await runSessionColorCommand(arguments_);
+  },
   sessionContext: async request => {
     const { runSessionContextCommand } = await import("../dist/cli/session-context.js");
     return await runSessionContextCommand(request);

package/dist/cli/capabilities.d.ts

@@ -1,6 +1,7 @@
 /** The Pi comparison launch is a prerelease development instrument, not product. */
 export interface CliCapabilities {
     readonly developmentComparison: boolean;
+    readonly sessionColors?: boolean;
     /** Bare `update` stays on this build's channel; absent means stable. */
     readonly runningChannel?: "stable" | "next";
 }

package/dist/cli/capabilities.js

@@ -1,7 +1,7 @@
 import { prerelease } from "semver";
 export function cliCapabilities(version) {
     const development = isPrereleaseVersion(version);
-    return Object.freeze({ developmentComparison: development, runningChannel: development ? "next" : "stable" });
+    return Object.freeze({ developmentComparison: development, sessionColors: true, runningChannel: development ? "next" : "stable" });
 }
 export function isPrereleaseVersion(version) {
     return (prerelease(version)?.length ?? 0) > 0;

package/dist/cli/dispatch.d.ts

@@ -10,6 +10,7 @@ export interface CliHandlers {
     readonly update: (channel: UpdateChannel, target?: string) => Promise<number>;
     readonly packages: (request: PackageCommandRequest) => Promise<number>;
     readonly sessionContext: (request: SessionContextRequest) => Promise<number>;
+    readonly sessionColor?: (arguments_: readonly string[]) => Promise<number>;
     /** Removes A1 from the machine; absent in hosts that cannot uninstall. */
     readonly uninstall?: (request: {
         readonly yes: boolean;
@@ -51,6 +52,9 @@ export type CliCommand = {
 } | {
     readonly kind: "session-context";
     readonly request: SessionContextRequest;
+} | {
+    readonly kind: "session-color";
+    readonly arguments: readonly string[];
 } | {
     readonly kind: "uninstall";
     readonly request: {

package/dist/cli/dispatch.js

@@ -23,7 +23,9 @@ export function cliUsage(capabilities) {
         "worktree enter <branch> [--base <branch>]",
         "worktree attach <path>",
         "worktree detach",
+        "worktree complete [--change <id>] [--pr <number>]",
         "worktree list",
+        "session color list | get [--session <id>] | set <color> [--session <id>]",
         "session worktrees",
         "session link-worktree <path>",
         "session unlink-worktree",
@@ -59,8 +61,14 @@ export function cliHelp(capabilities) {
         `  ${command} worktree enter <branch> [--base <branch>]`,
         `  ${command} worktree attach <path>`,
         `  ${command} worktree detach`,
+        `  ${command} worktree complete [--change <id>] [--pr <number>]`,
         `  ${command} worktree list`,
         "",
+        "Session colors (always JSON; explicit session id required outside the session shell):",
+        `  ${command} session color list`,
+        `  ${command} session color get --session <id>`,
+        `  ${command} session color set <color> --session <id>`,
+        "",
         "Session context (compatibility aliases):",
         `  ${command} session worktrees`,
         `  ${command} session link-worktree <path>`,
@@ -97,6 +105,12 @@ export async function dispatchCli(arguments_, handlers, output, capabilities) {
         return await handlers.packages(command.request);
     if (command.kind === "session-context")
         return await handlers.sessionContext(command.request);
+    if (command.kind === "session-color") {
+        if (handlers.sessionColor)
+            return await handlers.sessionColor(command.arguments);
+        output.stdout(`${JSON.stringify({ error: { code: "control-unavailable", message: "Session color API is unavailable in this host." } })}\n`);
+        return 1;
+    }
     if (command.kind === "uninstall")
         return handlers.uninstall ? await handlers.uninstall(command.request) : 2;
     return await handlers.update(command.channel, command.target);
@@ -135,6 +149,8 @@ export function parseCliCommand(arguments_, capabilities) {
         return parseUpdate(rest, capabilities.runningChannel ?? "stable");
     if (command === "worktree")
         return parseWorktree(rest);
+    if (command === "session" && rest[0] === "color")
+        return { kind: "session-color", arguments: rest.slice(1) };
     if (command === "session")
         return parseSessionContext(rest);
     if (command?.startsWith("update:"))
@@ -155,7 +171,24 @@ function parseWorktree(rest) {
     if ((action === "detach" || action === "list") && value === undefined) {
         return { kind: "session-context", request: { action: action === "detach" ? "unlink-worktree" : "worktrees" } };
     }
-    return { kind: "error", message: PRODUCT_TEXT.diagnostic("worktree accepts enter <branch> [--base <branch>], attach <path>, detach, or list.") };
+    if (action === "complete") {
+        const selectors = rest.slice(1);
+        let change, pr;
+        let valid = selectors.length % 2 === 0;
+        for (let index = 0; valid && index < selectors.length; index += 2) {
+            const name = selectors[index], selected = selectors[index + 1] ?? "";
+            if (name === "--change" && change === undefined && /^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(selected))
+                change = selected;
+            else if (name === "--pr" && pr === undefined && /^[1-9][0-9]{0,8}$/u.test(selected))
+                pr = Number(selected);
+            else
+                valid = false;
+        }
+        if (valid) {
+            return { kind: "session-context", request: { action: "complete-worktree", ...(change === undefined ? {} : { change }), ...(pr === undefined ? {} : { pr }) } };
+        }
+    }
+    return { kind: "error", message: PRODUCT_TEXT.diagnostic("worktree accepts enter <branch> [--base <branch>], attach <path>, detach, complete [--change <id>] [--pr <number>], or list.") };
 }
 function parseSessionContext(rest) {
     const [action, value, extra] = rest;

package/dist/cli/session-color.d.ts

@@ -0,0 +1,6 @@
+interface ColorCommandOptions {
+    readonly environment?: NodeJS.ProcessEnv;
+    readonly stdout?: (message: string) => void;
+}
+export declare function runSessionColorCommand(arguments_: readonly string[], options?: ColorCommandOptions): Promise<number>;
+export {};

package/dist/cli/session-color.js

@@ -0,0 +1,44 @@
+import { UI_ACCENT_COLORS } from "../contracts/owned-ui/index.js";
+import { requestSessionControl, resolveProductPaths } from "../foundation/lifecycle/index.js";
+import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../product-identity.js";
+const failure = (code, message) => Object.assign(new Error(message), { code });
+export async function runSessionColorCommand(arguments_, options = {}) {
+    const stdout = options.stdout ?? (message => process.stdout.write(message));
+    const environment = options.environment ?? process.env;
+    try {
+        const [action, ...rest] = arguments_;
+        if (action === "help" || action === "--help" || action === "-h") {
+            stdout(`${PRODUCT_TEXT.commandName} session color list | get [--session <id>] | set <color> [--session <id>]\nAlways JSON; get/set target Current color only. Outside an A1 shell, --session is required.\n`);
+            return 0;
+        }
+        if (action === "list" && rest.length === 0) {
+            stdout(`${JSON.stringify({ colors: UI_ACCENT_COLORS })}\n`);
+            return 0;
+        }
+        if (action !== "get" && action !== "set")
+            throw failure("invalid-request", "Use session color list, get, or set <color>.");
+        const color = action === "set" ? rest.shift() : undefined;
+        if (action === "set" && !UI_ACCENT_COLORS.includes(color))
+            throw failure("invalid-color", "Choose blue, green, orange, pink, purple, cyan, or grey.");
+        if (rest.length !== 0 && (rest.length !== 2 || rest[0] !== "--session" || !rest[1]))
+            throw failure("invalid-request", "Expected only --session followed by a complete session id.");
+        const explicit = rest.length === 2;
+        const runtimeId = environment[PRODUCT_IDENTITY.environment.sessionRuntimeId];
+        const sessionId = explicit ? rest[1] : runtimeId && environment.PI_SESSION_FILE ? environment.PI_SESSION_ID : undefined;
+        if (!sessionId)
+            throw failure("session-required", "Supply --session <id> outside an exact A1 shell runtime.");
+        const result = await requestSessionControl({
+            runtimeDir: resolveProductPaths(environment).runtimeDir, sessionId,
+            ...(!explicit && runtimeId ? { runtimeId } : {}),
+            payload: { action, ...(color === undefined ? {} : { color }) },
+        });
+        stdout(`${JSON.stringify(result)}\n`);
+        return 0;
+    }
+    catch (error) {
+        const detail = error;
+        const code = detail.code ?? "control-failed";
+        stdout(`${JSON.stringify({ error: { code, message: detail.message } })}\n`);
+        return ["invalid-request", "invalid-color", "invalid-session", "session-required"].includes(code) ? 2 : 1;
+    }
+}

package/dist/cli/session-context.js

@@ -15,6 +15,9 @@ export async function runSessionContextCommand(request, options = {}) {
         const outcome = await updateSessionRepositoryContext({ sessionId: identity.sessionId, sessionFile: identity.sessionFile }, request, { runtimeId: identity.runtimeId, inspectProcess: options.inspectProcess ?? inspectLiveProcess });
         if (outcome.kind === "unlinked")
             stdout("Session worktree context cleared.\n");
+        if (outcome.kind === "completing") {
+            stdout(`Session returned to ${outcome.startupRoot}; left ${outcome.cwd} (${outcome.branch}). Repository cleanup runs when this command's shell exits and is reported with its result.\n`);
+        }
         if (outcome.kind === "linked")
             stdout(`Session worktree context linked: ${outcome.cwd} (${outcome.branch})\n`);
         if (outcome.kind === "worktrees") {
@@ -57,6 +60,8 @@ function recoveryDetail(code) {
         "worktree-primary-checkout": "attach a task worktree, not the primary checkout; use worktree enter to create one",
         "worktree-git-locked": "Git has locked this worktree; retain it and ask its owner to release the lock",
         "worktree-foreign-repository": "the selected worktree belongs to a different repository; the previous attachment was preserved",
+        "worktree-not-attached": "no task worktree is attached to this session; nothing was changed",
+        "worktree-attachment-invalid": "the attached worktree is no longer a valid Git worktree; run worktree detach to return to the startup checkout",
         "worktree-context-changed": "the attachment changed during the operation; no ownership was overridden",
     };
     return code === null ? undefined : details[code];

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

@@ -1,12 +1,12 @@
 import type { AgentSettingsPort } from "../contracts/agent-engine/index.js";
-import { OwnedSettingsManager } from "../ui/settings/manager.js";
+import type { OwnedSettingsManager } from "../ui/settings/manager.js";
 interface OwnedSettingsManagerFactoryOptions {
     readonly profileId: string;
     readonly agent?: AgentSettingsPort | null;
     readonly agentProvider?: () => AgentSettingsPort | null;
 }
 /** Builds the profile-global settings manager shared by the Agent and slim utility compositions. */
-export declare function createOwnedSettingsManager(options: OwnedSettingsManagerFactoryOptions): OwnedSettingsManager;
+export declare function createOwnedSettingsManager(options: OwnedSettingsManagerFactoryOptions): Promise<OwnedSettingsManager>;
 /** Rereads the shared settings document whenever its stat changes; returns the stop. */
 export declare function watchSharedSettings(settings: Pick<OwnedSettingsManager, "file" | "refresh">): () => void;
 export {};

package/dist/composition/owned-settings.js

@@ -1,9 +1,9 @@
 import { statSync } from "node:fs";
 import { resolveLaunchProfilePaths } from "../features/launch/profile-paths.js";
 import { PRODUCT_IDENTITY } from "../product-identity.js";
-import { OwnedSettingsManager } from "../ui/settings/manager.js";
 /** Builds the profile-global settings manager shared by the Agent and slim utility compositions. */
-export function createOwnedSettingsManager(options) {
+export async function createOwnedSettingsManager(options) {
+    const { OwnedSettingsManager } = await import("../ui/settings/manager.js");
     const profilePaths = resolveLaunchProfilePaths();
     return new OwnedSettingsManager({
         profileDir: profilePaths.agentProfile,

package/dist/composition/owned-ui.js

@@ -39,7 +39,7 @@ export async function composeOwnedUi(options = {}) {
     let backend;
     const settings = options.profileId === undefined
         ? null
-        : createOwnedSettingsManager({
+        : await createOwnedSettingsManager({
             profileId: options.profileId,
             agentProvider: () => backend.settingsPort(),
         });
@@ -72,18 +72,12 @@ export async function composeOwnedUi(options = {}) {
         ...(options.packageVersion === undefined ? {} : { packageVersion: options.packageVersion }),
         ...(options.profileId === undefined ? {} : { profileId: options.profileId }),
     });
-    const unsubscribeAccentChange = bareSettings === null
-        ? () => { }
-        : bareSettings.onChange(current => {
-            const accent = current.value("accentColor");
-            host.setAccentColor(accent);
-        });
-    // Rationale: separate A1 processes share one settings document; a live scope change saved in
-    // one reaches the others only by rereading that document.
+    const sessionColor = bindSessionColor(backend, bareSettings, color => host.setAccentColor(color), productPaths.runtimeDir);
+    // Rationale: peer refresh shares persisted preferences, never session-local Current color.
     const unwatchSharedSettings = bareSettings === null
         ? () => { }
         : watchSharedSettings(bareSettings);
-    const unsubscribeAccent = () => { unwatchSharedSettings(); unsubscribeAccentChange(); };
+    const unsubscribeAccent = async () => { unwatchSharedSettings(); await sessionColor.dispose(); };
     // Invariant: the Settings search and agent prompt borrow the same resolved Pi keybindings.
     const keybindingsHost = createPiKeybindingsHost({ profile: bare ? "a1" : "pi", agentDir: backend.identity.agentDir });
     // Rationale: Routes open only after shell construction.
@@ -118,7 +112,7 @@ export async function composeOwnedUi(options = {}) {
     const releaseShared = async () => {
         naming.dispose();
         clipboardServices?.dispose();
-        unsubscribeAccent();
+        await unsubscribeAccent();
         await sessionRuntimes.dispose();
         await releaseNote.releaseClaim();
         suggestionDiagnostics?.dispose();
@@ -184,6 +178,7 @@ export async function composeOwnedUi(options = {}) {
                 exitNotice = import("../app/session-shell/exit-notice.js")
                     .then(module => module.armExitNotice(backend, exitNoticePath), () => null);
             presenter.start();
+            sessionColor.start();
             releaseUpdates.start();
         },
         flush: () => backend.session.flushEvents(),
@@ -204,6 +199,31 @@ export async function composeOwnedUi(options = {}) {
     };
     return { application, settings };
 }
+function bindSessionColor(backend, settings, apply, runtimeDir) {
+    if (settings === null)
+        return { start() { }, async dispose() { } };
+    let control = Promise.resolve(null);
+    let started = false, stopped = false;
+    const unsubscribe = settings.onChange(current => apply(current.value("accentColor")));
+    let binding = backend.identity.sessionBindingGeneration;
+    const unbind = backend.session.onEvent(() => {
+        if (binding === backend.identity.sessionBindingGeneration)
+            return;
+        binding = backend.identity.sessionBindingGeneration;
+        settings.startSession();
+    });
+    return {
+        start() {
+            if (started || stopped)
+                return;
+            started = true;
+            control = import("./session-colors.js").then(module => stopped ? null
+                : module.startSessionColorControl(backend, settings, runtimeDir, process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId]))
+                .catch(() => null);
+        },
+        async dispose() { stopped = true; unbind(); unsubscribe(); await (await control)?.dispose(); },
+    };
+}
 function spinnerPresenterOptions(settings) {
     return settings === null ? {} : { spinner: {
             snapshot: () => settings.value("spinnerStyle"),

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

@@ -0,0 +1,5 @@
+import { type OwnedUiSessionBackend } from "../contracts/owned-ui/index.js";
+import type { OwnedSettingsManager } from "../ui/settings/manager.js";
+export declare function startSessionColorControl(backend: OwnedUiSessionBackend, settings: OwnedSettingsManager, runtimeDir: string, runtimeId?: string): Promise<{
+    dispose: () => Promise<void>;
+}>;

package/dist/composition/session-colors.js

@@ -0,0 +1,33 @@
+import { randomUUID } from "node:crypto";
+import { UI_ACCENT_COLORS } from "../contracts/owned-ui/index.js";
+import { serveSessionControl } from "../foundation/lifecycle/session-control.js";
+export async function startSessionColorControl(backend, settings, runtimeDir, runtimeId = randomUUID()) {
+    const identity = () => ({ sessionId: backend.identity.currentHistorySessionId() ?? backend.identity.sessionId, binding: backend.identity.sessionBindingGeneration });
+    const control = await serveSessionControl({ runtimeDir, runtimeId, identity, handle: async (payload) => {
+            if (backend.identity.disposed)
+                throw Object.assign(new Error("The session is stopped."), { code: "session-unavailable" });
+            if (!payload || typeof payload !== "object")
+                throw Object.assign(new Error("Invalid color request."), { code: "invalid-request" });
+            const request = payload;
+            const sessionId = identity().sessionId;
+            if (request.action === "set") {
+                if (!UI_ACCENT_COLORS.includes(request.color))
+                    throw Object.assign(new Error("Unknown color."), { code: "invalid-color" });
+                const result = await settings.change("a1", "accentColor", request.color);
+                if (!result.applied)
+                    throw Object.assign(new Error(result.failure ?? "Color could not be applied."), { code: "control-failed" });
+                return { sessionId, color: result.effectiveValue };
+            }
+            if (request.action !== "get")
+                throw Object.assign(new Error("Unknown color action."), { code: "invalid-request" });
+            return { sessionId, color: settings.value("accentColor") };
+        } });
+    let stopped = false, binding = backend.identity.sessionBindingGeneration, publication = Promise.resolve();
+    const unsubscribe = backend.session.onEvent(() => {
+        if (stopped || binding === backend.identity.sessionBindingGeneration)
+            return;
+        binding = backend.identity.sessionBindingGeneration;
+        publication = publication.then(() => control.publish()).catch(() => { });
+    });
+    return { dispose: async () => { stopped = true; unsubscribe(); await publication; await control.dispose(); } };
+}

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

@@ -17,7 +17,9 @@ export declare class SessionRuntimeRegistry {
         revision: string;
     } | null>;
     /** Strict tool cwd lookup: transient startup failure never redirects a write to primary. */
-    toolReaderFor(agentId: string | undefined): (sessionId: string, sessionFile: string, signal: AbortSignal) => Promise<string>;
+    toolReaderFor(agentId: string | undefined): ((sessionId: string, sessionFile: string, signal: AbortSignal) => Promise<string>) & {
+        settleShell: (sessionId: string, sessionFile: string, signal: AbortSignal) => Promise<string | null>;
+    };
     /** Drain publication before releasing claims; never republish after disposal. */
     dispose(): Promise<void>;
 }

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

@@ -3,6 +3,8 @@ export class SessionRuntimeRegistry {
     #options;
     #identities = new Map();
     #activated = new Map();
+    // Invariant: a released invalid attachment is reported by the agent's next tool call instead of running elsewhere.
+    #released = new Map();
     #abort = new AbortController();
     #owner = null;
     #timer = null;
@@ -26,7 +28,7 @@ export class SessionRuntimeRegistry {
                 const owner = await this.#ownerIdentity();
                 if (owner === null || !this.#current(agentId, identity))
                     return null;
-                const { activateSessionRepositoryContext, readActiveSessionRepositoryContext } = await import("../foundation/lifecycle/session-repository-context.js");
+                const { activateSessionRepositoryContext, readActiveSessionRepositoryContext, releaseInvalidSessionRepositoryContext } = await import("../foundation/lifecycle/session-repository-context.js");
                 if (!this.#current(agentId, identity))
                     return null;
                 const options = {
@@ -51,6 +53,14 @@ export class SessionRuntimeRegistry {
                 }
                 catch (error) {
                     const code = error instanceof Error && "code" in error ? error.code : null;
+                    if (code === "worktree-attachment-invalid") {
+                        const released = await releaseInvalidSessionRepositoryContext(identity, options);
+                        if (released !== null && this.#current(agentId, identity)) {
+                            this.#released.set(agentId, { identity, message: `attached worktree ${released.worktreeRoot} is no longer a valid Git worktree; `
+                                    + `this session was detached and now uses ${released.startupRoot}. Nothing was deleted and this call did not run; retry it from that directory.` });
+                            return null;
+                        }
+                    }
                     if ((code === "session-runtime-unavailable" || code === "worktree-context-changed") && this.#current(agentId, identity)) {
                         this.#activated.delete(agentId);
                     }
@@ -62,7 +72,18 @@ export class SessionRuntimeRegistry {
     /** Strict tool cwd lookup: transient startup failure never redirects a write to primary. */
     toolReaderFor(agentId) {
         const read = this.readerFor(agentId);
-        return async (sessionId, sessionFile, signal) => {
+        /** Run a completion the just-finished shell requested, from this stable process rather than that shell. */
+        const settleShell = async (sessionId, sessionFile, signal) => {
+            const { runtimeId, inspectProcess } = this.#options;
+            if (this.#disposed || runtimeId === undefined || inspectProcess === undefined)
+                return null;
+            const { describeWorktreeCompletion, settleSessionWorktreeCompletion } = await import("../foundation/lifecycle/session-worktree-completion.js");
+            const result = await settleSessionWorktreeCompletion({ sessionId, sessionFile }, {
+                runtimeId, inspectProcess, signal, ...(agentId === undefined ? {} : { agentId }),
+            });
+            return result === null ? null : describeWorktreeCompletion(result);
+        };
+        return Object.assign(async (sessionId, sessionFile, signal) => {
             const { retrySessionCoordination } = await import("../foundation/lifecycle/session-context-retry.js");
             return await retrySessionCoordination(async () => {
                 signal.throwIfAborted();
@@ -75,12 +96,20 @@ export class SessionRuntimeRegistry {
                 if (active?.sessionId !== sessionId || active.sessionFile !== sessionFile) {
                     throw Object.assign(new Error("worktree runtime registration is still recovering"), { code: "session-runtime-unavailable" });
                 }
+                const released = this.#released.get(agentId);
+                if (released !== undefined) {
+                    this.#released.delete(agentId);
+                    // Invariant: work addressed to the lost checkout fails once; it is never silently applied to the startup checkout.
+                    if (released.identity.sessionId === sessionId && released.identity.sessionFile === sessionFile) {
+                        throw Object.assign(new Error(released.message), { code: "worktree-attachment-invalid" });
+                    }
+                }
                 if (context !== null)
                     return context.cwd;
                 const { readSessionStartupRoot } = await import("../foundation/lifecycle/session-repository-context.js");
                 return await readSessionStartupRoot({ sessionId, sessionFile });
             }, 8_000, signal);
-        };
+        }, { settleShell });
     }
     /** Drain publication before releasing claims; never republish after disposal. */
     async dispose() {

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

@@ -1,6 +1,6 @@
 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 declare const UI_ACCENT_COLORS: readonly ["blue", "green", "orange", "pink", "purple", "cyan", "grey"];
+export type UiAccentColor = typeof UI_ACCENT_COLORS[number];
 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";

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

@@ -1,3 +1,4 @@
+export const UI_ACCENT_COLORS = Object.freeze(["blue", "green", "orange", "pink", "purple", "cyan", "grey"]);
 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";

package/dist/contracts/presentation/progress-palette.generated.d.ts

@@ -29,7 +29,7 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             };
         };
     };
-    purple: {
+    green: {
         dark: {
             truecolor: {
                 accent: string;
@@ -55,7 +55,7 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             };
         };
     };
-    cyan: {
+    orange: {
         dark: {
             truecolor: {
                 accent: string;
@@ -81,7 +81,7 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             };
         };
     };
-    green: {
+    pink: {
         dark: {
             truecolor: {
                 accent: string;
@@ -107,7 +107,7 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             };
         };
     };
-    orange: {
+    purple: {
         dark: {
             truecolor: {
                 accent: string;
@@ -133,7 +133,33 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             };
         };
     };
-    pink: {
+    cyan: {
+        dark: {
+            truecolor: {
+                accent: string;
+                border: string;
+                selectedBg: string;
+            };
+            "256color": {
+                accent: string;
+                border: string;
+                selectedBg: string;
+            };
+        };
+        light: {
+            truecolor: {
+                accent: string;
+                border: string;
+                selectedBg: string;
+            };
+            "256color": {
+                accent: string;
+                border: string;
+                selectedBg: string;
+            };
+        };
+    };
+    grey: {
         dark: {
             truecolor: {
                 accent: string;

package/dist/contracts/presentation/progress-palette.generated.js

@@ -2,5 +2,5 @@
  * Generated by scripts/pi/sync-progress-palette.ts from A1's named accent projection
  * over pinned Pi 1.5.2 (MIT), commit b4afdddf44e059c67ccf5097e5317d913521b470. Do not edit directly.
  */
-export const SHARED_PROGRESS_PALETTE = Object.freeze({ "blue": { "dark": { "truecolor": { "accent": "\u001b[38;2;130;160;241m", "border": "\u001b[38;2;116;102;197m", "selectedBg": "\u001b[48;2;52;57;69m" }, "256color": { "accent": "\u001b[38;5;111m", "border": "\u001b[38;5;98m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;63;96;226m", "border": "\u001b[38;2;83;67;154m", "selectedBg": "\u001b[48;2;243;244;246m" }, "256color": { "accent": "\u001b[38;5;62m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } }, "purple": { "dark": { "truecolor": { "accent": "\u001b[38;2;167;152;215m", "border": "\u001b[38;2;105;115;167m", "selectedBg": "\u001b[48;2;58;56;66m" }, "256color": { "accent": "\u001b[38;5;140m", "border": "\u001b[38;5;61m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;116;89;180m", "border": "\u001b[38;2;68;77;130m", "selectedBg": "\u001b[48;2;243;243;245m" }, "256color": { "accent": "\u001b[38;5;97m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } }, "cyan": { "dark": { "truecolor": { "accent": "\u001b[38;2;93;179;186m", "border": "\u001b[38;2;74;128;146m", "selectedBg": "\u001b[48;2;48;60;61m" }, "256color": { "accent": "\u001b[38;5;73m", "border": "\u001b[38;5;66m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;40;122;129m", "border": "\u001b[38;2;40;89;106m", "selectedBg": "\u001b[48;2;241;244;244m" }, "256color": { "accent": "\u001b[38;5;30m", "border": "\u001b[38;5;23m", "selectedBg": "\u001b[48;5;255m" } } }, "green": { "dark": { "truecolor": { "accent": "\u001b[38;2;104;183;141m", "border": "\u001b[38;2;75;132;120m", "selectedBg": "\u001b[48;2;50;60;54m" }, "256color": { "accent": "\u001b[38;5;72m", "border": "\u001b[38;5;66m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;51;126;88m", "border": "\u001b[38;2;41;93;82m", "selectedBg": "\u001b[48;2;242;244;243m" }, "256color": { "accent": "\u001b[38;5;65m", "border": "\u001b[38;5;23m", "selectedBg": "\u001b[48;5;255m" } } }, "orange": { "dark": { "truecolor": { "accent": "\u001b[38;2;231;135;83m", "border": "\u001b[38;2;178;89;79m", "selectedBg": "\u001b[48;2;67;54;48m" }, "256color": { "accent": "\u001b[38;5;173m", "border": "\u001b[38;5;131m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;174;80;16m", "border": "\u001b[38;2;133;57;49m", "selectedBg": "\u001b[48;2;245;243;242m" }, "256color": { "accent": "\u001b[38;5;130m", "border": "\u001b[38;5;95m", "selectedBg": "\u001b[48;5;255m" } } }, "pink": { "dark": { "truecolor": { "accent": "\u001b[38;2;223;122;199m", "border": "\u001b[38;2;150;91;171m", "selectedBg": "\u001b[48;2;65;53;62m" }, "256color": { "accent": "\u001b[38;5;176m", "border": "\u001b[38;5;97m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;178;56;153m", "border": "\u001b[38;2;114;61;131m", "selectedBg": "\u001b[48;2;245;243;245m" }, "256color": { "accent": "\u001b[38;5;132m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } } });
+export const SHARED_PROGRESS_PALETTE = Object.freeze({ "blue": { "dark": { "truecolor": { "accent": "\u001b[38;2;130;160;241m", "border": "\u001b[38;2;116;102;197m", "selectedBg": "\u001b[48;2;52;57;69m" }, "256color": { "accent": "\u001b[38;5;111m", "border": "\u001b[38;5;98m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;63;96;226m", "border": "\u001b[38;2;83;67;154m", "selectedBg": "\u001b[48;2;243;244;246m" }, "256color": { "accent": "\u001b[38;5;62m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } }, "green": { "dark": { "truecolor": { "accent": "\u001b[38;2;104;183;141m", "border": "\u001b[38;2;75;132;120m", "selectedBg": "\u001b[48;2;50;60;54m" }, "256color": { "accent": "\u001b[38;5;72m", "border": "\u001b[38;5;66m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;51;126;88m", "border": "\u001b[38;2;41;93;82m", "selectedBg": "\u001b[48;2;242;244;243m" }, "256color": { "accent": "\u001b[38;5;65m", "border": "\u001b[38;5;23m", "selectedBg": "\u001b[48;5;255m" } } }, "orange": { "dark": { "truecolor": { "accent": "\u001b[38;2;231;135;83m", "border": "\u001b[38;2;178;89;79m", "selectedBg": "\u001b[48;2;67;54;48m" }, "256color": { "accent": "\u001b[38;5;173m", "border": "\u001b[38;5;131m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;174;80;16m", "border": "\u001b[38;2;133;57;49m", "selectedBg": "\u001b[48;2;245;243;242m" }, "256color": { "accent": "\u001b[38;5;130m", "border": "\u001b[38;5;95m", "selectedBg": "\u001b[48;5;255m" } } }, "pink": { "dark": { "truecolor": { "accent": "\u001b[38;2;223;122;199m", "border": "\u001b[38;2;150;91;171m", "selectedBg": "\u001b[48;2;65;53;62m" }, "256color": { "accent": "\u001b[38;5;176m", "border": "\u001b[38;5;97m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;178;56;153m", "border": "\u001b[38;2;114;61;131m", "selectedBg": "\u001b[48;2;245;243;245m" }, "256color": { "accent": "\u001b[38;5;132m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } }, "purple": { "dark": { "truecolor": { "accent": "\u001b[38;2;167;152;215m", "border": "\u001b[38;2;105;115;167m", "selectedBg": "\u001b[48;2;58;56;66m" }, "256color": { "accent": "\u001b[38;5;140m", "border": "\u001b[38;5;61m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;116;89;180m", "border": "\u001b[38;2;68;77;130m", "selectedBg": "\u001b[48;2;243;243;245m" }, "256color": { "accent": "\u001b[38;5;97m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } }, "cyan": { "dark": { "truecolor": { "accent": "\u001b[38;2;93;179;186m", "border": "\u001b[38;2;74;128;146m", "selectedBg": "\u001b[48;2;48;60;61m" }, "256color": { "accent": "\u001b[38;5;73m", "border": "\u001b[38;5;66m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;40;122;129m", "border": "\u001b[38;2;40;89;106m", "selectedBg": "\u001b[48;2;241;244;244m" }, "256color": { "accent": "\u001b[38;5;30m", "border": "\u001b[38;5;23m", "selectedBg": "\u001b[48;5;255m" } } }, "grey": { "dark": { "truecolor": { "accent": "\u001b[38;2;163;163;163m", "border": "\u001b[38;2;119;119;119m", "selectedBg": "\u001b[48;2;57;57;57m" }, "256color": { "accent": "\u001b[38;5;247m", "border": "\u001b[38;5;243m", "selectedBg": "\u001b[48;5;237m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;111;111;111m", "border": "\u001b[38;2;84;84;84m", "selectedBg": "\u001b[48;2;244;244;244m" }, "256color": { "accent": "\u001b[38;5;242m", "border": "\u001b[38;5;240m", "selectedBg": "\u001b[48;5;255m" } } } });
 export const SHARED_PROGRESS_ACCENT_ANSI = SHARED_PROGRESS_PALETTE.blue.dark.truecolor.accent;

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

@@ -9,6 +9,10 @@ export type SessionContextRequest = {
     readonly base?: string;
 } | {
     readonly action: "unlink-worktree";
+} | {
+    readonly action: "complete-worktree";
+    readonly change?: string;
+    readonly pr?: number;
 } | {
     readonly action: "worktrees";
 };
@@ -18,6 +22,11 @@ export type SessionContextOutcome = {
     readonly branch: string;
 } | {
     readonly kind: "unlinked";
+} | {
+    readonly kind: "completing";
+    readonly cwd: string;
+    readonly branch: string;
+    readonly startupRoot: string;
 } | {
     readonly kind: "worktrees";
     readonly entries: readonly SessionWorktreeInventoryEntry[];

package/dist/features/launch/session-context.js

@@ -1,4 +1,4 @@
-import { clearSessionRepositoryContext, enterSessionRepositoryWorktree, listSessionRepositoryWorktrees, retrySessionCoordination, setSessionRepositoryContext, } from "../../foundation/lifecycle/index.js";
+import { clearSessionRepositoryContext, enterSessionRepositoryWorktree, listSessionRepositoryWorktrees, requestSessionWorktreeCompletion, retrySessionCoordination, setSessionRepositoryContext, } from "../../foundation/lifecycle/index.js";
 export { PRIMARY_SESSION_AGENT_ID } from "../../foundation/lifecycle/index.js";
 export async function updateSessionRepositoryContext(identity, request, runtime) {
     const options = {
@@ -14,6 +14,12 @@ export async function updateSessionRepositoryContext(identity, request, runtime)
             await clearSessionRepositoryContext(identity, options);
             return { kind: "unlinked" };
         }
+        if (request.action === "complete-worktree") {
+            return { kind: "completing", ...await requestSessionWorktreeCompletion(identity, {
+                    ...(request.change === undefined ? {} : { change: request.change }),
+                    ...(request.pr === undefined ? {} : { pr: request.pr }),
+                }, options) };
+        }
         if (request.action === "worktrees") {
             return { kind: "worktrees", entries: await listSessionRepositoryWorktrees(identity, options) };
         }

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

@@ -732,7 +732,7 @@ export class SettingsApp {
         const state = {
             choices: menu.choices.map(choice => displaySettingValue(menu.entry, choice)),
             ...(menu.preview !== null ? { previews: menu.preview.frames(menu.choices, menu.index, theme) }
-                : menu.entry.id === "accentColor" ? {
+                : ["accentColor", "defaultAccentColor"].includes(menu.entry.id) ? {
                     previews: menu.choices.map(choice => theme.accentPreview?.(String(choice), "■") ?? ""),
                 } : {}),
             current: this.#edits.shown(menu.entry) === null ? null : displaySettingValue(menu.entry, this.#edits.shown(menu.entry)),