@timurproko/a1 0.2.7-dev.808 → 0.2.7-dev.809

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

@@ -0,0 +1,85 @@
+const SESSION_RUNTIME_REFRESH_MS = 30_000;
+/**
+ * The live worktree claims this runtime's agents hold: each agent's session identity, the heartbeat
+ * that keeps the claims fresh, and their release when the runtime is disposed.
+ */
+export class SessionRuntimeRegistry {
+    #options;
+    // Invariant: one entry per agent of this runtime; each agent holds its own claim, and the runtime's exit releases all.
+    #identities = new Map();
+    #owner = null;
+    #timer = null;
+    #refresh = Promise.resolve();
+    #disposed = false;
+    constructor(options) {
+        this.#options = options;
+    }
+    /** The repository context reader for one agent; undefined names the primary agent. */
+    readerFor(agentId) {
+        return async (sessionId, sessionFile, signal) => {
+            const { runtimeId, inspectProcess } = this.#options;
+            const owner = await this.#ownerIdentity();
+            if (owner === null || runtimeId === undefined || inspectProcess === undefined)
+                return null;
+            const identity = { sessionId, sessionFile };
+            this.#identities.set(agentId, identity);
+            const { activateSessionRepositoryContext } = await import("../foundation/lifecycle/session-repository-context.js");
+            const context = await activateSessionRepositoryContext(identity, runtimeId, owner, {
+                signal,
+                inspectProcess,
+                ...(agentId === undefined ? {} : { agentId }),
+            });
+            this.#arm();
+            return context;
+        };
+    }
+    /** Stops the heartbeat, waits for an in-flight refresh, and releases every claim this runtime holds. */
+    async dispose() {
+        this.#disposed = true;
+        if (this.#timer !== null)
+            clearInterval(this.#timer);
+        this.#timer = null;
+        await this.#refresh;
+        const { runtimeId } = this.#options;
+        const owner = await this.#ownerIdentity();
+        if (runtimeId === undefined || owner === null)
+            return;
+        await import("../foundation/lifecycle/session-repository-context.js")
+            .then(module => module.releaseSessionRepositoryRuntime(runtimeId, owner))
+            .catch(() => undefined);
+    }
+    async #ownerIdentity() {
+        const { runtimeId, inspectProcess } = this.#options;
+        if (runtimeId === undefined || inspectProcess === undefined)
+            return null;
+        this.#owner ??= inspectProcess(process.pid).catch(() => null);
+        return await this.#owner;
+    }
+    #arm() {
+        if (this.#timer !== null)
+            return;
+        this.#timer = setInterval(() => this.#queueRefresh(), this.#options.refreshMs ?? SESSION_RUNTIME_REFRESH_MS);
+        this.#timer.unref();
+    }
+    #queueRefresh() {
+        const { runtimeId, inspectProcess } = this.#options;
+        if (this.#disposed || this.#identities.size === 0 || runtimeId === undefined || inspectProcess === undefined)
+            return;
+        this.#refresh = this.#refresh.then(async () => {
+            if (this.#disposed)
+                return;
+            const owner = await this.#ownerIdentity();
+            if (owner === null)
+                return;
+            const { registerSessionRepositoryRuntime } = await import("../foundation/lifecycle/session-repository-context.js");
+            for (const [agentId, identity] of this.#identities) {
+                if (this.#disposed)
+                    return;
+                await registerSessionRepositoryRuntime(identity, runtimeId, owner, {
+                    inspectProcess,
+                    ...(agentId === undefined ? {} : { agentId }),
+                }).catch(() => undefined);
+            }
+        }).catch(() => undefined);
+    }
+}

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

@@ -0,0 +1,32 @@
+import type { OwnedUiShellEngineOptions } from "../app/session-shell/index.js";
+import type { ReleaseNoteCatalog } from "../features/owned-ui/release-notes.js";
+type StartupRoute = NonNullable<OwnedUiShellEngineOptions["startupRoute"]>;
+export interface StartupReleaseNoteOptions {
+    readonly ownedSurfaces: boolean;
+    /** Deterministic catalog and version seams for composition tests. */
+    readonly releaseNotes?: ReleaseNoteCatalog;
+    readonly packageVersion?: string;
+    /** Without a profile there is nowhere to remember the note as seen, so it is never shown on startup. */
+    readonly profileId?: string;
+    readonly configDir: string;
+}
+export declare function readPackageVersion(): Promise<string>;
+/**
+ * The release notes bare A1 ships and the one note this version shows once per profile on startup:
+ * the packaged catalog (or why it could not be read), the running version, and the claim that
+ * marks the note seen after its route closes.
+ */
+export declare class StartupReleaseNote {
+    #private;
+    readonly catalog: ReleaseNoteCatalog | null;
+    readonly failure: unknown;
+    readonly packageVersion: string | null;
+    static load(options: StartupReleaseNoteOptions): Promise<StartupReleaseNote>;
+    private constructor();
+    /** The changelog route to present after the first frame, or undefined when there is no unseen note to show. */
+    get startupRoute(): StartupRoute | undefined;
+    /** Waits for a pending acknowledgement; a failed one stays unseen and is never reported. */
+    settleAcknowledgement(): Promise<void>;
+    releaseClaim(): Promise<void>;
+}
+export {};

package/dist/composition/startup-route.js

@@ -0,0 +1,72 @@
+import { readFile } from "node:fs/promises";
+export async function readPackageVersion() {
+    const manifest = JSON.parse(await readFile(new URL("../../package.json", import.meta.url), "utf8"));
+    const version = manifest?.version;
+    if (typeof version !== "string")
+        throw new Error("A1 package version is unavailable");
+    return version;
+}
+/**
+ * The release notes bare A1 ships and the one note this version shows once per profile on startup:
+ * the packaged catalog (or why it could not be read), the running version, and the claim that
+ * marks the note seen after its route closes.
+ */
+export class StartupReleaseNote {
+    catalog;
+    failure;
+    packageVersion;
+    #current;
+    #claim;
+    #acknowledgement = null;
+    static async load(options) {
+        let catalog = null;
+        let failure;
+        if (options.ownedSurfaces) {
+            try {
+                catalog = options.releaseNotes
+                    ?? await import("../features/owned-ui/release-notes.js").then(module => module.readPackagedReleaseNotes());
+            }
+            catch (error) {
+                failure = error;
+            }
+        }
+        const packageVersion = options.ownedSurfaces ? options.packageVersion ?? await readPackageVersion() : null;
+        const current = packageVersion === null ? null : catalog?.current(packageVersion) ?? null;
+        const profileId = options.profileId;
+        const claim = current === null || profileId === undefined
+            ? null
+            : await import("../features/owned-ui/release-note-state.js").then(module => module.claimReleaseNote({
+                configDir: options.configDir, profileId, version: current.version,
+            }));
+        return new StartupReleaseNote(catalog, failure, packageVersion, current, claim);
+    }
+    constructor(catalog, failure, packageVersion, current, claim) {
+        this.catalog = catalog;
+        this.failure = failure;
+        this.packageVersion = packageVersion;
+        this.#current = current;
+        this.#claim = claim;
+    }
+    /** The changelog route to present after the first frame, or undefined when there is no unseen note to show. */
+    get startupRoute() {
+        const current = this.#current;
+        const claim = this.#claim;
+        if (current === null || claim === null)
+            return undefined;
+        return {
+            route: "changelog",
+            input: { document: current.markdown },
+            onClosed: () => {
+                this.#acknowledgement ??= claim.acknowledge();
+                return this.#acknowledgement;
+            },
+        };
+    }
+    /** Waits for a pending acknowledgement; a failed one stays unseen and is never reported. */
+    async settleAcknowledgement() {
+        await this.#acknowledgement?.catch(() => undefined);
+    }
+    async releaseClaim() {
+        await this.#claim?.release();
+    }
+}

package/dist/integrations/pi/engine/adapter.d.ts

@@ -1,38 +1,17 @@
-import { type AgentSession } from "../startup-public.js";
-import { type OwnedUiCommand, type OwnedUiExtensionPort, type OwnedUiExtensionUiPort, type OwnedUiImageAttachment, type OwnedUiPromptSuggestionGeneratorPort, type OwnedUiPromptSuggestionReasoning, type OwnedUiPromptSuggestionRequest, type OwnedUiPromptSuggestionResult, type OwnedUiEvent, type OwnedUiReleaseUpdate, type OwnedUiSessionBackend, type OwnedUiSessionCatalogPort, type OwnedUiSessionIdentityPort, type OwnedUiSessionPort, type OwnedUiSessionSettingsPort, type OwnedUiSessionViewModel, type OwnedUiSnapshot, type OwnedUiWorkflowPort } from "../../../contracts/owned-ui/index.js";
-import type { PiAuthenticationProviderOption, PiBashWorkflowResult, PiModelsContext, PiModelsRefreshResult, PiPinnedSettingsCallback, PiPinnedSettingsSnapshot, PiProjectTrustContext, PiProjectTrustUpdate, PiScopedModelsContext, PiScopedModelsRefreshResult, PiSessionResumeMetadata, PiSessionSelectorContext, PiTreeSelectorContext, PiWorkflowAutocompleteCommand, PiWorkflowHost, PiWorkflowInteractionHost, PiWorkflowOption, PiWorkflowRequest, PiWorkflowResult } from "./workflows.js";
+import { type OwnedUiCommand, type OwnedUiExtensionPort, type OwnedUiPromptSuggestionGeneratorPort, type OwnedUiPromptSuggestionReasoning, type OwnedUiPromptSuggestionRequest, type OwnedUiPromptSuggestionResult, type OwnedUiEvent, type OwnedUiSessionBackend, type OwnedUiSessionCatalogPort, type OwnedUiSessionIdentityPort, type OwnedUiSessionPort, type OwnedUiSessionSettingsPort, type OwnedUiSessionViewModel, type OwnedUiSnapshot, type OwnedUiWorkflowPort } from "../../../contracts/owned-ui/index.js";
+import type { PiPinnedSettingsSnapshot, PiWorkflowHost, PiWorkflowInteractionHost, PiWorkflowRequest, PiWorkflowResult } from "./workflows.js";
 import type { PiSettingsBridge } from "./settings-bridge.js";
-import type { PiSettingOwnerHandlers } from "./settings-bridge.js";
 import type { PiProjectTrustPreflightPrompt } from "./project-trust-preflight.js";
 import type { PiSessionForkPrompt, PiSessionSelection } from "./session-selection.js";
-import type { AgentSettingOwner } from "../../../contracts/agent-engine/index.js";
 import { type AdapterCommandResult } from "./command-dispatch.js";
-import { type OwnedPiVisualExtensionSupport } from "./extension-ui-binding.js";
-import { type OwnedPiExtensionResourceSummary, type OwnedPiResourceSummary } from "./resource-catalog.js";
 import { type PiEnginePackageUpdateProbe, type PiEngineRuntimeFactory, type PiRepositoryContextReader } from "./session-runtime.js";
 import { type PiEngineHostSessionPorts } from "./host-ports.js";
-import { PiWorkflowContexts } from "./workflow-contexts.js";
+import { type PiSessionPresentationSource } from "./ports.js";
 export type { OwnedPiExtensionResourceSummary, OwnedPiExtensionSourceSummary, OwnedPiResourceSummary } from "./resource-catalog.js";
 export type { PiEngineRuntimeFactory, PiEngineRuntimeFactoryInput } from "./session-runtime.js";
 export type { AdapterCommandResult } from "./command-dispatch.js";
 export type { OwnedPiVisualExtensionSupport } from "./extension-ui-binding.js";
-/**
- * The Pi objects pinned selectors and transcript renderers are built from. They are not part of the
- * session backend contract; only the session presenters owner reads them.
- */
-export interface PiSessionPresentationSource {
-    pinnedModelSelectorContext(): ReturnType<PiWorkflowContexts["pinnedModelSelectorContext"]>;
-    pinnedSessionSelectorContext(): PiSessionSelectorContext;
-    pinnedTreeSelectorContext(): PiTreeSelectorContext;
-    pinnedMessageRenderer(customType: string): unknown;
-    pinnedToolRenderers(toolName: string): unknown;
-    pinnedShortcutDescriptions(bindings: Parameters<AgentSession["extensionRunner"]["getShortcuts"]>[0]): readonly {
-        readonly key: string;
-        readonly description: string;
-    }[];
-    pinnedSettingsModels(): Pick<PiPinnedSettingsSnapshot, "currentModel" | "availableDefaultModels">;
-    applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): Promise<PiWorkflowResult>;
-}
+export type { PiSessionPresentationSource } from "./ports.js";
 /** Explicit flush failure when required delivery was interrupted rather than completed. */
 export declare class EngineDeliveryError extends Error {
     constructor();
@@ -80,22 +59,6 @@ export declare class PiEngineAdapter implements OwnedUiSessionBackend, OwnedUiPr
     /** The Pi objects behind pinned selectors and renderers, for the session presenters owner only. */
     presentationSource(): PiSessionPresentationSource;
     setWorkflowInteractionHost(interaction: PiWorkflowInteractionHost): void;
-    get sessionId(): string;
-    get sessionGeneration(): number;
-    /** Actual session replacements, excluding delivery-only invalidation of callbacks. */
-    get sessionBindingGeneration(): number;
-    get cwd(): string;
-    get agentDir(): string;
-    resolveTranscriptImage(assetId: string): OwnedUiImageAttachment | null;
-    currentSessionFile(): string | null;
-    currentSessionResumeMetadata(): PiSessionResumeMetadata | null;
-    get disposed(): boolean;
-    /**
-     * Report a newer A1 release found by the startup check. The shell renders the diagnostic as
-     * pinned Pi's `Update Available` notice; it arrives whenever the check resolves, so a late
-     * result is appended to the transcript like Pi's own fire-and-forget version check.
-     */
-    announceReleaseUpdate(release: OwnedUiReleaseUpdate): void;
     suggestionReasoningPolicy(): OwnedUiPromptSuggestionReasoning;
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
     generateResidentTabName(instruction: string, maxTokens: number, signal: AbortSignal): Promise<string | null>;
@@ -120,51 +83,15 @@ export declare class PiEngineAdapter implements OwnedUiSessionBackend, OwnedUiPr
         peakBytes: number;
     };
     flushEvents(): Promise<void>;
-    nonVisualResources(): readonly OwnedPiResourceSummary[];
-    extensionResources(): readonly OwnedPiExtensionResourceSummary[];
-    workflowAutocompleteCommands(): readonly PiWorkflowAutocompleteCommand[];
-    visualExtensionSupport(): OwnedPiVisualExtensionSupport;
-    bindExtensionUi(ui: OwnedUiExtensionUiPort, shutdown?: () => void | Promise<void>): Promise<void>;
-    unbindExtensionUi(): Promise<void>;
-    cycleModelWorkflow(direction: "forward" | "backward"): Promise<PiWorkflowResult>;
-    pinnedProjectTrustContext(): PiProjectTrustContext;
-    persistProjectTrust(updates: readonly PiProjectTrustUpdate[]): void;
-    pinnedScopedModelsContext(): PiScopedModelsContext;
-    updateScopedModels(enabledModelIds: readonly string[] | null): void;
-    persistScopedModels(enabledModelIds: readonly string[] | null): void;
-    refreshScopedModels(signal: AbortSignal): Promise<PiScopedModelsRefreshResult>;
-    modelsContext(): PiModelsContext;
-    setSessionModelScope(scopeIds: readonly string[]): void;
-    persistModelScope(scopeIds: readonly string[]): void;
-    refreshModels(signal: AbortSignal): Promise<PiModelsRefreshResult>;
-    pinnedLoginOptions(authType?: "oauth" | "api_key"): readonly PiAuthenticationProviderOption[];
-    pinnedLoginMethodOptions(providerReference: string): {
-        readonly title: string;
-        readonly options: readonly PiWorkflowOption[];
-    };
-    pinnedAmbientAuthentication(selection: string): ReturnType<PiWorkflowContexts["pinnedAmbientAuthentication"]>;
-    pinnedLogoutOptions(): Promise<readonly PiAuthenticationProviderOption[]>;
-    pinnedForkOptions(): readonly PiWorkflowOption[];
-    /** Bind the owned UI's clipboard lifecycle without changing the comparison host. True means acknowledged delivery. */
-    bindClipboardWriter(writer: (text: string) => Promise<boolean>): () => void;
-    /** Workflow and tree copying share the active owner's write fence and delivery acknowledgment. */
-    copyWorkflowText(text: string): Promise<boolean>;
     abortBashWorkflow(): void;
-    executeBashWorkflow(command: string, excludeFromContext: boolean): Promise<PiBashWorkflowResult>;
-    reloadBlockedResult(): PiWorkflowResult | null;
     executeWorkflow(request: PiWorkflowRequest): Promise<PiWorkflowResult>;
     /**
      * The theme the engine is configured with, in the engine's own grammar: a
      * theme's name, or a `light/dark` pair meaning "follow the terminal".
      */
     configuredTheme(): string | undefined;
-    /** Persist the global thinking default without changing the live session level. */
-    setDefaultThinkingLevel(level: PiPinnedSettingsSnapshot["defaultThinkingLevel"]): void;
     /** Settings port for the live runtime, or null before the runtime is available. */
     settingsPort(): PiSettingsBridge | null;
-    /** Which settings surface this adapter serves; hidden-in-bare effects are unbindable in bare mode. */
-    get settingsProductMode(): "bare" | "comparison";
-    bindSettingsOwner(owner: AgentSettingOwner, handlers: PiSettingOwnerHandlers): () => void;
     pinnedSettingsSnapshot(): PiPinnedSettingsSnapshot;
     clearQueuedWorkflows(): readonly string[];
     view(): OwnedUiSessionViewModel;