@timurproko/a1 0.2.6 → 0.2.7-dev.1221

package/dist/cli/version-stats.js

@@ -12,19 +12,26 @@ export async function runVersionStats(options) {
     const output = options.output ?? defaultOutput;
     const runner = options.runner ?? createVersionProcessRunner();
     let installed;
+    let installedPullRequest;
     try {
         const manifest = JSON.parse(await readFile(resolve(options.packageRoot, "package.json"), "utf8"));
         installed = parseVersion(manifest.version, "installed package");
+        installedPullRequest = recordedPullRequest(manifest);
     }
     catch (error) {
         output.stderr(`${PRODUCT_TEXT.diagnostic(`could not read its installed version: ${message(error)}`)}\n`);
         return 1;
     }
     // Rationale: unlike Pi, stable builds also show the release channel head so users can see they are
-    // behind without starting a session. Only development builds show the preview channel.
+    // behind without starting a session. Only development builds show the preview channel, and only
+    // they carry the pull request a preview's manifest records; a missing record is silently omitted.
     const remote = await queryDistTags(runner, options.fetcher ?? defaultRegistryFetcher);
-    const develop = prerelease(installed) === null ? "" : `Develop: ${remote.develop ?? "unavailable"}\n`;
-    output.stdout(`Current: ${installed}\n${develop}Release: ${remote.release ?? "unavailable"}\n`);
+    const developmentBuild = prerelease(installed) !== null;
+    const headPullRequest = developmentBuild && remote.develop !== null ? await queryRecordedPullRequest(runner, remote.develop) : null;
+    const develop = developmentBuild
+        ? `Develop: ${remote.develop === null ? "unavailable" : withPullRequest(remote.develop, headPullRequest)}\n`
+        : "";
+    output.stdout(`Current: ${withPullRequest(installed, developmentBuild ? installedPullRequest : null)}\n${develop}Release: ${remote.release ?? "unavailable"}\n`);
     if (remote.error)
         output.stderr(`${PRODUCT_TEXT.diagnostic(`could not resolve npm dist-tags: ${remote.error}`)}\n`);
     return 0;
@@ -88,6 +95,34 @@ function parseDistTags(metadata, source) {
 function unavailable(error) {
     return { release: null, develop: null, error };
 }
+function withPullRequest(version, pullRequest) {
+    return pullRequest === null ? version : `${version} (#${pullRequest})`;
+}
+/** The pull request a manifest records under `publication.pullRequest`, when it is a positive integer. */
+function recordedPullRequest(manifest) {
+    if (typeof manifest !== "object" || manifest === null)
+        return null;
+    const publication = manifest.publication;
+    if (typeof publication !== "object" || publication === null)
+        return null;
+    const value = publication.pullRequest;
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : null;
+}
+/** The pull request the published head records, read through npm; any failure means no record. */
+async function queryRecordedPullRequest(runner, version) {
+    try {
+        const result = await runner("npm", ["view", `${PRODUCT_TEXT.packageName}@${version}`, "publication.pullRequest", "--json"]);
+        if (result.code !== 0 || result.stdout.trim().length === 0)
+            return null;
+        const parsed = JSON.parse(result.stdout);
+        // Compatibility: npm 12 wraps single-field `npm view --json` output in a one-element array.
+        const value = Array.isArray(parsed) && parsed.length === 1 ? parsed[0] : parsed;
+        return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
 const defaultRegistryFetcher = async (url) => await fetch(url, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(10_000) });
 function createVersionProcessRunner() {
     return async (command, arguments_) => await new Promise((resolvePromise, rejectPromise) => {

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

@@ -0,0 +1,12 @@
+import type { AgentSettingsPort } from "../contracts/agent-engine/index.js";
+import { OwnedSettingsManager } from "../ui/settings/manager.js";
+export interface OwnedSettingsManagerFactoryOptions {
+    readonly profileId: string;
+    readonly hideTabSettings?: boolean;
+    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;
+/** Rereads the shared settings document whenever its stat changes; returns the stop. */
+export declare function watchSharedSettings(settings: Pick<OwnedSettingsManager, "file" | "refresh">): () => void;

package/dist/composition/owned-settings.js

@@ -0,0 +1,36 @@
+import { unwatchFile, watchFile } from "node:fs";
+import { resolveLaunchProfilePaths } from "../features/launch/profile-paths.js";
+import { resolveProductPaths } from "../foundation/lifecycle/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) {
+    const profilePaths = resolveLaunchProfilePaths();
+    const productPaths = resolveProductPaths();
+    return new OwnedSettingsManager({
+        profileDir: profilePaths.agentProfile,
+        profileId: options.profileId,
+        namespace: PRODUCT_IDENTITY.commandName,
+        legacyConfigDir: productPaths.configDir,
+        ...(options.agent === undefined ? {} : { agent: options.agent }),
+        ...(options.agentProvider === undefined ? {} : { agentProvider: options.agentProvider }),
+        ...(options.hideTabSettings ? { hiddenOwnedSettingIds: ["tabsAutoName", "tabsPosition", "tabBarPlusMenu"] } : {}),
+        hiddenAgentSettingIds: ["fullscreenWheelScrollLines"],
+        agentSettingLabelOverrides: { fullscreenCopyOnSelect: "Copy on select" },
+    });
+}
+const SHARED_SETTINGS_POLL_MS = 250;
+/** Rereads the shared settings document whenever its stat changes; returns the stop. */
+export function watchSharedSettings(settings) {
+    const file = settings.file;
+    const listener = () => {
+        try {
+            settings.refresh();
+        }
+        catch {
+            // Compatibility: an unreadable peer write resolves on the next stat change.
+        }
+    };
+    watchFile(file, { interval: SHARED_SETTINGS_POLL_MS, persistent: false }, listener);
+    return () => unwatchFile(file, listener);
+}

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

@@ -1,29 +1,16 @@
 import type { AvailableRelease, StartupReleaseCheckOptions } from "../foundation/release/latest-release.js";
 import type { NativeProcessIdentity } from "../foundation/lifecycle/model.js";
 import type { SessionSelection } from "../foundation/lifecycle/session-selection.js";
-import { type PiEngineHostOptions, type PiEngineSessionRequest } from "../integrations/pi/engine/host.js";
-import { type PiSessionPresenterBackend } from "../integrations/pi/session-presenters/index.js";
+import { type PiEngineHostOptions } from "../integrations/pi/engine/host.js";
 import type { PiProjectTrustPreflightPrompt } from "../integrations/pi/engine/project-trust-preflight.js";
 import type { PiSessionForkPrompt } from "../integrations/pi/engine/session-selection.js";
-import { OwnedSettingsManager } from "../ui/settings/manager.js";
+import type { OwnedSettingsManager } from "../ui/settings/manager.js";
 import type { OwnedUiApplicationPort, PresentationTerminalPort } from "../contracts/presentation/index.js";
-import type { AgentSettingsPort } from "../contracts/agent-engine/index.js";
-import type { OwnedUiPromptSuggestionGeneratorPort, UiAccentColor } from "../contracts/owned-ui/index.js";
 import type { ReleaseNoteCatalog } from "../features/owned-ui/release-notes.js";
-/**
- * The session backend composition wires: the owned-UI port, the prompt-suggestion generator, and
- * the agent settings port. `settingsPort` stays outside the owned-UI contract because its type
- * belongs to the agent-engine contracts, which the owned-UI contract may not import.
- */
-export interface ComposedSessionBackend extends PiSessionPresenterBackend, OwnedUiPromptSuggestionGeneratorPort {
-    settingsPort(): AgentSettingsPort | null;
-}
-/** The process-level engine host as composition drives it: sessions, the live accent, and disposal. */
-export interface ComposedEngineHost {
-    create(request: PiEngineSessionRequest): Promise<ComposedSessionBackend>;
-    setAccentColor(color: UiAccentColor): void;
-    dispose(): Promise<void>;
-}
+import type { TabBridgeClient } from "../foundation/resident-tabs/bridge-client.js";
+import type { ComposedEngineHost } from "./session-backend.js";
+export type { ComposedEngineHost, ComposedSessionBackend } from "./session-backend.js";
+export { bindResidentTabBridge, correlateResidentTabSubmission } from "./resident-tab-bridge.js";
 export interface OwnedUiCompositionOptions {
     readonly cwd?: string;
     readonly terminal?: PresentationTerminalPort;
@@ -33,15 +20,11 @@ export interface OwnedUiCompositionOptions {
     readonly sessionPath?: string;
     readonly sessionSelection?: SessionSelection;
     readonly sessionForkPrompt?: PiSessionForkPrompt;
-    /**
-     * A1 profile whose settings this session reads and writes. Omitted keeps the
-     * session settings-free, which is what the pinned comparison paths use.
-     */
+    /** A1 settings profile; comparison paths omit it. */
     readonly profileId?: string;
-    /**
-     * Whether A1's product-specific surfaces are reachable. Comparison profiles
-     * use the same composition with those surfaces withheld.
-     */
+    /** Hide resident-only tab controls for the explicit direct single-agent launch. */
+    readonly hideTabSettings?: boolean;
+    /** `off` withholds A1-specific surfaces from comparison profiles. */
     readonly ownedSurfaces?: "on" | "off";
     readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;
     /** Explicit local diagnostic destination; ignored by comparison/settings-free compositions. */
@@ -50,16 +33,32 @@ export interface OwnedUiCompositionOptions {
     readonly clipboardDiagnosticsPath?: string;
     /** Deterministic release-note seams for composition tests. */
     readonly packageVersion?: string;
+    readonly notificationVersion?: string | undefined;
     readonly releaseNotes?: ReleaseNoteCatalog;
     /** Startup release-availability seam; defaults to the throttled registry check. */
     readonly checkForNewerRelease?: (options: StartupReleaseCheckOptions) => Promise<AvailableRelease | null>;
-    /** Exact native process inspection injected by the shipped entry; absent SDK seams do not publish claims. */
     readonly inspectProcess?: (pid: number) => Promise<NativeProcessIdentity | null>;
+    readonly tab?: {
+        readonly bridge: TabBridgeClient;
+        readonly dataDir: string;
+        readonly incarnation: number;
+    };
+    readonly residentFallbackNotice?: string;
 }
 export interface OwnedUiComposition {
     readonly application: OwnedUiApplicationPort;
     /** Present when a profile was supplied, so the caller can resolve settings before start. */
     readonly settings: OwnedSettingsManager | null;
 }
+export declare function residentStartupPresentation(resident: boolean, fallbackNotice?: string): {
+    readonly startup?: {
+        readonly quiet?: boolean;
+        readonly notices?: readonly [{
+            readonly kind: "warning";
+            readonly message: string;
+        }];
+    };
+};
 export declare function composeOwnedUiApplication(options?: OwnedUiCompositionOptions): Promise<OwnedUiApplicationPort>;
 export declare function composeOwnedUi(options?: OwnedUiCompositionOptions): Promise<OwnedUiComposition>;
+export { watchSharedSettings } from "./owned-settings.js";