@timurproko/a1 0.2.7-dev.1249 → 0.2.7-dev.1255

package/package.json

@@ -1,16 +1,12 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.2.7-dev.1249",
-  "description": "Standalone terminal workspace for supervised native and managed agents",
+  "version": "0.2.7-dev.1255",
+  "description": "Standalone single-agent terminal UI on pinned Pi",
   "type": "module",
   "privateLaunchContract": "neutral-launch-v1",
   "updateActivationContracts": [
     "activate-v1"
   ],
-  "residentControlContracts": [
-    "resident-control-v1",
-    "resident-workspace-v1"
-  ],
   "updateCommandContracts": [
     "update-release-v1"
   ],
@@ -32,12 +28,10 @@
     "clean": "node scripts/clean.mjs",
     "build": "node scripts/development/run-build.mjs",
     "build:core": "node scripts/development/run-build.mjs --core",
-    "build:managed": "npm run clean && tsc -p tsconfig.build.json && node scripts/release/generate-release-notes-resource.mjs && node scripts/pi/build-pi-settings-metadata.mjs && node scripts/pi/build-startup-public.mjs && node scripts/development/build-process-guardian.mjs",
-    "build:process-guardian": "node scripts/development/build-process-guardian.mjs",
-    "build:terminal-host": "node scripts/development/build-terminal-host.mjs",
+    "build:managed": "npm run clean && tsc -p tsconfig.build.json && node scripts/release/generate-release-notes-resource.mjs && node scripts/pi/build-pi-settings-metadata.mjs && node scripts/pi/build-startup-public.mjs",
     "typecheck": "tsgo -p tsconfig.json --noEmit && tsgo -p tsconfig.bin.json",
-    "check:local": "npm run typecheck && npm run check:architecture && npm run check:names && vitest run test/repository-governance/native-ci-workflows.test.ts",
-    "check:architecture": "node scripts/governance/check-architecture.mjs && node scripts/governance/check-session-writer-guard.mjs && node scripts/governance/check-product-identity-boundaries.mjs && node scripts/governance/check-package-identity.mjs && node scripts/governance/check-pinned-pi-source-ledger.mjs && node scripts/governance/check-terminal-host-provenance.mjs",
+    "check:local": "npm run typecheck && npm run check:architecture && npm run check:names",
+    "check:architecture": "node scripts/governance/check-architecture.mjs && node scripts/governance/check-session-writer-guard.mjs && node scripts/governance/check-product-identity-boundaries.mjs && node scripts/governance/check-package-identity.mjs && node scripts/governance/check-pinned-pi-source-ledger.mjs",
     "preflight": "node scripts/development/run-preflight.mjs",
     "check:names": "node scripts/governance/product-identifier-policy.mjs --check",
     "check:names:changed": "node scripts/governance/product-identifier-policy.mjs --check --selection .artifacts/validation/impact.json",
@@ -60,9 +54,6 @@
     "test:scope": "node scripts/release/run-validation-tier.mjs",
     "test:full": "node scripts/release/run-validation-tier.mjs full-release",
     "test:release": "node scripts/release/run-release-gates.mjs",
-    "test:terminal-host": "node scripts/development/run-terminal-host-probe.mjs",
-    "test:resident-parallel-progress": "node scripts/development/verify-resident-parallel-progress.mjs",
-    "test:resident-chaos": "node scripts/development/run-resident-chaos.mjs --build",
     "test:pi-engine-conformance": "vitest run test/integrations/pi/engine/conformance.test.ts test/integrations/pi/engine/runtime-integration.test.ts test/integrations/pi/engine/session-integration.test.ts",
     "report:pi-engine-conformance": "npm run build --silent && node scripts/pi/run-pi-engine-conformance.mjs",
     "report:rendering-stability": "tsx scripts/pi/report-rendering-stability.ts",
@@ -70,8 +61,6 @@
     "sync:pi-ui": "npm run update:pi-component-parity && npm run update:pi-event-frame-parity",
     "update:pi-component-parity": "tsx scripts/pi/update-pi-component-parity.ts",
     "update:pi-event-frame-parity": "tsx scripts/pi/update-pi-event-frame-parity.ts",
-    "proof:terminal-host": "node scripts/development/run-terminal-host.mjs",
-    "proof:terminal-host:ci": "node scripts/development/certify-ci-terminal-host.mjs",
     "start": "npm run build && node scripts/development/dev-launch.mjs",
     "start:pi": "npm run build && node scripts/development/dev-launch.mjs pi",
     "prepack": "node scripts/release/validate-packaged-release-note.mjs && node scripts/release/prepack-gate.mjs",
@@ -100,7 +89,6 @@
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "@xterm/headless": "6.0.0",
     "esbuild": "0.25.10",
-    "node-pty": "1.1.0",
     "tsx": "4.20.3",
     "typescript": "5.9.2",
     "vitest": "3.2.7",
@@ -110,7 +98,6 @@
     "cli",
     "tui",
     "terminal",
-    "multiplexer",
     "agents"
   ],
   "author": "Timur Prokopiev",
@@ -126,7 +113,7 @@
     "@mariozechner/clipboard": "^0.3.9"
   },
   "publication": {
-    "source": "fdbfddae64dfff5140ae471515eace2208be9246",
-    "pullRequest": 872
+    "source": "c42a37a9eb7e1c01d121f82a7be42376aaa7c542",
+    "pullRequest": 879
   }
 }

package/bin/guardian.js

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-
-const startup = await import("../dist/foundation/startup/startup-runtime.js");
-startup.enableEnvironmentCompileCache(process.env);
-await startup.markStartupPhase(process.env, "guardian-start");
-const { resolve } = await import("node:path");
-const { parseSessionSelection } = await import("../dist/foundation/lifecycle/session-selection.js");
-const { runLaunchGuardian } = await import("../dist/foundation/launch-guardian/main.js");
-
-const { readLaunchContext } = await import("../dist/foundation/launch-context/index.js");
-const launchContext = readLaunchContext(process.env, "release");
-const releaseRoot = launchContext.releaseRoot;
-const profileId = readLaunchContext(process.env, "profile").launchProfile;
-// Invariant: the "release" and "profile" requirements above already refused an environment without
-// these values; the checks give the type checker the same certainty.
-if (releaseRoot === undefined || profileId === undefined) throw new Error("A1 launch context is incomplete");
-
-const sessionSelection = parseSessionSelection(process.argv.slice(2));
-const rootCommand = launchContext.residentRootExecutable === undefined ? undefined : {
-  executable: launchContext.residentRootExecutable,
-  arguments: JSON.parse(launchContext.residentRootArguments ?? "[]"),
-};
-Promise.resolve().then(() => runLaunchGuardian({
-  ...(sessionSelection === undefined ? {} : { sessionSelection }),
-  ...(rootCommand === undefined ? {} : { rootCommand }),
-  profileId,
-  releaseRoot,
-  uiEntry: resolve(releaseRoot, "bin", "ui.js"),
-  environment: process.env,
-  cwd: process.cwd(),
-})).then(
-  code => { process.exitCode = code; },
-  error => {
-    if (error instanceof Error && "code" in error && error.code === "release-superseded" && typeof process.send === "function") {
-      process.send({ type: "a1-release-reselection" });
-      process.exitCode = 1;
-      return;
-    }
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exitCode = 1;
-  },
-);

package/bin/supervisor.js

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-import { runSupervisor } from "../dist/foundation/supervision/index.js";
-
-runSupervisor(process.argv.slice(2)).catch(error => {
-  console.error(error instanceof Error ? error.stack ?? error.message : String(error));
-  process.exitCode = 1;
-});

package/bin/tab-launch-context.d.ts

@@ -1,27 +0,0 @@
-export interface TabLaunchCredentials {
-  readonly tabId: string;
-  readonly token: string;
-  readonly endpoint: string;
-  readonly releaseId?: string;
-}
-
-export function formatResidentFallbackNotice(reason: string): string;
-
-export function assignFreshSessionRuntimeId(
-  environment: Record<string, string | undefined>,
-  name: string,
-  createId: () => string,
-): string;
-
-export function waitForStandbyPromotion(input: NodeJS.ReadStream, promotionFile?: string): Promise<void>;
-
-export function consumeTabLaunchContext(
-  arguments_: readonly string[],
-  environment: Record<string, string | undefined>,
-): {
-  readonly uiArguments: string[];
-  readonly tabCredentials: TabLaunchCredentials | undefined;
-  readonly tabDataDir?: string;
-  readonly tabIncarnation?: number;
-  readonly tabStandby: boolean;
-};

package/bin/tab-launch-context.js

@@ -1,94 +0,0 @@
-import { existsSync } from "node:fs";
-
-const TAB_ENVIRONMENT_NAMES = ["A1_TAB_ID", "A1_TAB_TOKEN", "A1_TAB_ENDPOINT", "A1_TAB_RELEASE_ID"];
-
-/** @param {string} reason */
-export function formatResidentFallbackNotice(reason) {
-  // Protocol: a host of another generation is never replaced automatically; only the user stops it.
-  if (reason === "incompatible generation") {
-    return "A1 normal mode unavailable (running tabs use another version); running in single agent mode. Run `a1 tabs host stop` to restart them on this version.";
-  }
-  return `A1 normal mode unavailable (${reason}); running in single agent mode.`;
-}
-
-/**
- * @param {Record<string, string | undefined>} environment
- * @param {string} name
- * @param {() => string} createId
- */
-export function assignFreshSessionRuntimeId(environment, name, createId) {
-  const id = createId();
-  if (typeof id !== "string" || id.length === 0 || id.includes("\0")) throw new Error("Session runtime identity generation failed");
-  environment[name] = id;
-  return id;
-}
-
-/**
- * Keep the standby below the session/runtime boundary until its authenticated holder promotes it.
- * Platform: Windows ConPTY may drop the in-band marker, so the holder also creates the promotion
- * file inside the tab's private data directory; whichever arrives first promotes the standby.
- * @param {NodeJS.ReadStream} input
- * @param {string} [promotionFile]
- */
-export function waitForStandbyPromotion(input, promotionFile) {
-  return /** @type {Promise<void>} */ (new Promise((resolve, reject) => {
-    const marker = Buffer.from("\x1b]a1;standby-promote\x07");
-    let buffered = Buffer.alloc(0);
-    /** @type {NodeJS.Timeout | undefined} */
-    let poll;
-    const cleanup = () => {
-      if (poll !== undefined) clearInterval(poll);
-      input.off("data", onData);
-      input.off("error", onError);
-      input.pause();
-      if (input.isTTY) input.setRawMode(false);
-    };
-    /** @param {Error} error */
-    const onError = error => { cleanup(); reject(error); };
-    /** @param {Buffer | string} chunk */
-    const onData = chunk => {
-      const bytes = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
-      buffered = Buffer.concat([buffered, bytes]).subarray(-marker.length);
-      if (buffered.equals(marker)) { cleanup(); resolve(undefined); }
-    };
-    if (input.isTTY) input.setRawMode(true);
-    input.on("data", onData);
-    input.on("error", onError);
-    input.resume();
-    if (promotionFile !== undefined) {
-      poll = setInterval(() => {
-        if (existsSync(promotionFile)) { cleanup(); resolve(undefined); }
-      }, 10);
-    }
-  }));
-}
-
-/**
- * Security: consume bridge credentials into caller-private memory and erase their inheritable
- * environment entries before any extension-capable module loads.
- * @param {readonly string[]} arguments_
- * @param {Record<string, string | undefined>} environment
- */
-export function consumeTabLaunchContext(arguments_, environment) {
-  const uiArguments = [...arguments_];
-  const tabArgument = uiArguments.indexOf("--tab");
-  const tabMode = tabArgument !== -1;
-  if (tabMode) uiArguments.splice(tabArgument, 1);
-  const standbyArgument = uiArguments.indexOf("--tab-standby");
-  const tabStandby = standbyArgument !== -1;
-  if (tabStandby) uiArguments.splice(standbyArgument, 1);
-  const dataArgument = uiArguments.indexOf("--tab-data-dir");
-  const tabDataDir = dataArgument === -1 ? undefined : uiArguments[dataArgument + 1];
-  if (dataArgument !== -1) uiArguments.splice(dataArgument, 2);
-  const incarnationArgument = uiArguments.indexOf("--tab-incarnation");
-  const tabIncarnation = incarnationArgument === -1 ? undefined : Number(uiArguments[incarnationArgument + 1]);
-  if (incarnationArgument !== -1) uiArguments.splice(incarnationArgument, 2);
-  const [tabId, token, endpoint, releaseId] = TAB_ENVIRONMENT_NAMES.map(name => environment[name]);
-  for (const name of TAB_ENVIRONMENT_NAMES) delete environment[name];
-  if (!tabMode) return { uiArguments, tabCredentials: undefined, tabStandby: false };
-  if (!tabId || !token || !endpoint || !tabDataDir || tabDataDir.includes("\0")
-    || typeof tabIncarnation !== "number" || !Number.isSafeInteger(tabIncarnation) || tabIncarnation < 1) {
-    throw new Error("A1 tab mode requires bridge credentials, recovery directory, and incarnation");
-  }
-  return { uiArguments, tabCredentials: { tabId, token, endpoint, ...(releaseId === undefined ? {} : { releaseId }) }, tabDataDir, tabIncarnation, tabStandby };
-}

package/dist/app/session-shell/resident-tab-coordinator.d.ts

@@ -1,38 +0,0 @@
-import type { OwnedUiEvent, PromptHistoryImageSidecarPort } from "../../contracts/owned-ui/index.js";
-import type { SessionConcern } from "./session-concern.js";
-import type { OwnedUiShellEngineOptions, OwnedUiSessionShellRoot } from "./session-shell-root.js";
-export type ResidentTabOptions = NonNullable<OwnedUiShellEngineOptions["residentTab"]>;
-export interface ResidentTabCoordinatorPorts {
-    readonly root: Pick<OwnedUiSessionShellRoot, "appendWorkflowStatus" | "rehydrateHistoryText" | "editor">;
-}
-/**
- * The session presenter's side of a resident tab: recovered input, the idle status it reports to
- * the strip, prompt admission and correlation through the recovery journal, draft checkpoints,
- * detach on quit, and the graceful stop when the presenter is released. Outside a resident tab
- * every operation is a no-op.
- */
-export declare class ResidentTabCoordinator implements SessionConcern {
-    #private;
-    constructor(options: ResidentTabOptions | undefined, ports: ResidentTabCoordinatorPorts);
-    /** True inside a resident tab, where Settings and the session name live in the global strip. */
-    get active(): boolean;
-    checkpoint(text: string): void;
-    closeOwnedRoute(route: string): void;
-    /** Puts the prompts and draft a previous tab process left unfinished back into the editor. */
-    restoreInput(imageSidecar?: PromptHistoryImageSidecarPort): void;
-    /** Reports idle to the strip whenever the session leaves its busy lifecycle. */
-    observeLifecycle(event: OwnedUiEvent): void;
-    /** Journals a prompt before it is sent; undefined outside a resident tab. Rejects when the journal cannot sync. */
-    admit(input: Parameters<NonNullable<ResidentTabOptions["admit"]>>[0]): Promise<{
-        readonly id: string;
-    } | undefined>;
-    /** The admitted prompt reached the engine; its journal entry is correlated with the engine's entry. */
-    dispatched(submissionId: string, entryId: string): Promise<void>;
-    /**
-     * Leaves the tab without stopping its engine. Returns undefined outside a resident tab, true when
-     * the client detached, or the notice to show when detaching is unavailable.
-     */
-    detach(): Promise<true | string | undefined>;
-    gracefulStop(sessionFile: string | null): Promise<void>;
-    dispose(): void;
-}

package/dist/app/session-shell/resident-tab-coordinator.js

@@ -1,77 +0,0 @@
-/**
- * The session presenter's side of a resident tab: recovered input, the idle status it reports to
- * the strip, prompt admission and correlation through the recovery journal, draft checkpoints,
- * detach on quit, and the graceful stop when the presenter is released. Outside a resident tab
- * every operation is a no-op.
- */
-export class ResidentTabCoordinator {
-    #options;
-    #ports;
-    constructor(options, ports) {
-        this.#options = options;
-        this.#ports = ports;
-    }
-    /** True inside a resident tab, where Settings and the session name live in the global strip. */
-    get active() {
-        return this.#options !== undefined;
-    }
-    checkpoint(text) {
-        this.#options?.checkpoint?.(text);
-    }
-    closeOwnedRoute(route) {
-        this.#options?.closeOwnedRoute?.(route);
-    }
-    /** Puts the prompts and draft a previous tab process left unfinished back into the editor. */
-    restoreInput(imageSidecar) {
-        const recovered = this.#options?.recovered;
-        if (recovered === undefined)
-            return;
-        const { root } = this.#ports;
-        const prompts = recovered.prompts
-            .map(prompt => root.rehydrateHistoryText(prompt.text, id => imageSidecar?.readAttachment(id) ?? null))
-            .filter(Boolean);
-        if (prompts.length > 0) {
-            root.editor.setText(prompts[0]);
-            if (recovered.draft)
-                root.editor.addToHistory(recovered.draft);
-            for (const additional of prompts.slice(1))
-                root.editor.addToHistory(additional);
-            root.appendWorkflowStatus(recovered.draft
-                ? `Recovered an unfinished prompt; the prior draft and ${Math.max(0, prompts.length - 1)} additional prompt${prompts.length === 2 ? "" : "s"} are in editor history.`
-                : `Recovered an unfinished prompt${prompts.length > 1 ? `; ${prompts.length - 1} additional prompts are in editor history` : ""}.`);
-        }
-        else if (recovered.draft) {
-            root.editor.setText(recovered.draft);
-            root.appendWorkflowStatus("Recovered the editor draft from the previous tab process.");
-        }
-    }
-    /** Reports idle to the strip whenever the session leaves its busy lifecycle. */
-    observeLifecycle(event) {
-        if (event.type === "session-lifecycle" && event.lifecycle !== "busy")
-            this.#options?.reportStatus?.("idle");
-    }
-    /** Journals a prompt before it is sent; undefined outside a resident tab. Rejects when the journal cannot sync. */
-    admit(input) {
-        return this.#options?.admit?.(input) ?? Promise.resolve(undefined);
-    }
-    /** The admitted prompt reached the engine; its journal entry is correlated with the engine's entry. */
-    async dispatched(submissionId, entryId) {
-        this.#options?.dispatched?.();
-        await this.#options?.correlated?.(submissionId, entryId).catch(() => undefined);
-    }
-    /**
-     * Leaves the tab without stopping its engine. Returns undefined outside a resident tab, true when
-     * the client detached, or the notice to show when detaching is unavailable.
-     */
-    async detach() {
-        const resident = this.#options;
-        if (resident === undefined)
-            return undefined;
-        const detached = await resident.requestDetach().catch(() => false);
-        return detached ? true : resident.unavailableNotice ?? "Press Ctrl+C twice to leave; this agent keeps running.";
-    }
-    gracefulStop(sessionFile) {
-        return this.#options?.gracefulStop?.(sessionFile) ?? Promise.resolve();
-    }
-    dispose() { }
-}

package/dist/cli/tabs-request.d.ts

@@ -1,7 +0,0 @@
-export type TabsAction = "list" | "stop" | "stop-all" | "host-status" | "host-stop" | "doctor";
-/** One parsed `a1 tabs` form. Parsing finishes before any host is contacted. */
-export interface TabsRequest {
-    readonly action: TabsAction;
-    readonly tabId?: string;
-    readonly json: boolean;
-}

package/dist/cli/tabs.d.ts

@@ -1,14 +0,0 @@
-import { runTerminalHostMaintenance, writeDoctorBundle } from "../foundation/resident-tabs/index.js";
-import type { TabsRequest } from "./tabs-request.js";
-export type { TabsRequest } from "./tabs-request.js";
-export interface TabsCommandOptions {
-    /** The invoking package, never a different active or retained release. */
-    readonly packageRoot?: string;
-    readonly environment?: NodeJS.ProcessEnv;
-    readonly stdout?: (message: string) => void;
-    readonly stderr?: (message: string) => void;
-    readonly maintenance?: typeof runTerminalHostMaintenance;
-    readonly doctor?: typeof writeDoctorBundle;
-}
-/** `a1 tabs`: inspect or stop resident tabs without attaching, and never start a host to report state. */
-export declare function runTabsCommand(request: TabsRequest, options?: TabsCommandOptions): Promise<number>;

package/dist/cli/tabs.js

@@ -1,151 +0,0 @@
-import { resolveProductPaths } from "../foundation/lifecycle/index.js";
-import { materializeRelease } from "../foundation/release/index.js";
-import { readResidentTabLaunchSettings, runTerminalHostMaintenance, writeDoctorBundle, } from "../foundation/resident-tabs/index.js";
-import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../product-identity.js";
-/** `a1 tabs`: inspect or stop resident tabs without attaching, and never start a host to report state. */
-export async function runTabsCommand(request, options = {}) {
-    const environment = options.environment ?? process.env;
-    const stdout = options.stdout ?? (message => process.stdout.write(message));
-    const stderr = options.stderr ?? (message => process.stderr.write(message));
-    const paths = resolveProductPaths(environment);
-    const profileRoot = environment[PRODUCT_IDENTITY.environment.profileHome] ?? paths.configDir;
-    const releaseRoots = await invokingReleaseRoots(paths.dataDir, options.packageRoot, environment);
-    const maintenance = options.maintenance ?? runTerminalHostMaintenance;
-    const report = await maintenance({
-        action: request.action === "doctor" ? "host-status" : request.action,
-        ...(request.tabId === undefined ? {} : { tabId: request.tabId }),
-        profileRoot,
-        dataDir: paths.dataDir,
-        runtimeDir: paths.runtimeDir,
-        releaseRoots,
-        environment,
-    });
-    if (request.action === "doctor") {
-        if (!report.stateDir) {
-            stderr(`${PRODUCT_TEXT.diagnostic(`tabs doctor could not locate resident state: ${report.message ?? report.host}`)}\n`);
-            return 1;
-        }
-        const settings = await readResidentTabLaunchSettings(environment.PI_CODING_AGENT_DIR ?? paths.configDir, PRODUCT_IDENTITY.commandName, paths.configDir, "a1");
-        const bundle = await (options.doctor ?? writeDoctorBundle)({
-            stateDir: report.stateDir,
-            hostStatus: report,
-            releaseRoots,
-            settings: { tabsAutoName: settings.tabsAutoName },
-        });
-        if (request.json)
-            stdout(`${JSON.stringify({ schema: "a1-tabs-doctor-v1", path: bundle.path, bytes: bundle.bytes, dropped: bundle.dropped })}\n`);
-        else
-            stdout(`Wrote ${bundle.path}\n`);
-        return 0;
-    }
-    if (request.json) {
-        const { exitCode: _exitCode, ...printed } = report;
-        stdout(`${JSON.stringify(printed)}\n`);
-    }
-    else {
-        const text = describe(request, report);
-        if (report.exitCode === 0)
-            stdout(text);
-        else
-            stderr(text);
-    }
-    return report.exitCode === 0 ? 0 : 1;
-}
-async function invokingReleaseRoots(dataDir, packageRoot, environment) {
-    if (!packageRoot)
-        return [];
-    if (environment[PRODUCT_IDENTITY.environment.developmentInstanceId])
-        return [packageRoot];
-    try {
-        // Invariant: immutable materialization selects exact payload bytes without activating or starting a host.
-        return [(await materializeRelease(packageRoot, dataDir)).releaseRoot];
-    }
-    catch {
-        return [];
-    }
-}
-const NO_TABS = "No resident tabs are running.\n";
-function describe(request, report) {
-    const command = PRODUCT_TEXT.commandName;
-    if (report.host === "none")
-        return NO_TABS;
-    if (report.host === "unavailable")
-        return `${PRODUCT_TEXT.diagnostic(`tabs could not run maintenance: ${report.message ?? "terminal host unavailable"}`)}\n`;
-    if (report.host === "unresponsive") {
-        return `The resident host (pid ${report.pid ?? "unknown"}) is not responding. Run \`${command} tabs host stop\` to stop it.\n`;
-    }
-    if (report.host === "incompatible") {
-        return `${PRODUCT_TEXT.diagnostic(report.message ?? "running tabs use another version")} Run \`${command} tabs host stop\` from that version.\n`;
-    }
-    if (report.host === "unverifiable" || report.host === "refused") {
-        return `${PRODUCT_TEXT.diagnostic(report.message ?? "the resident host could not be verified; nothing was changed")}\n`;
-    }
-    const result = report.result ?? {};
-    if (request.action === "list")
-        return listing(result);
-    if (request.action === "host-status")
-        return status(result);
-    if (request.action === "host-stop") {
-        if (report.host === "stopped")
-            return "Stopped every tab and the resident host.\n";
-        return `Could not stop every tab: ${remaining(result)}. The host is still running.\n`;
-    }
-    if (result.accepted === false && typeof result.message === "string") {
-        return `${PRODUCT_TEXT.diagnostic(`tabs stop: ${result.message === "unknown tab" ? `no tab ${request.tabId ?? ""}` : result.message}`)}\n`;
-    }
-    const stopped = Array.isArray(result.stopped) ? result.stopped.length : 0;
-    if (result.accepted === false)
-        return `Could not stop: ${remaining(result)}.\n`;
-    if (request.action === "stop")
-        return `Stopped tab ${request.tabId ?? ""}; its session can be resumed.\n`;
-    return stopped === 0 ? NO_TABS : `Stopped ${stopped} tab${stopped === 1 ? "" : "s"}; their sessions can be resumed.\n`;
-}
-function remaining(result) {
-    return Array.isArray(result.remaining) && result.remaining.length > 0 ? result.remaining.join(", ") : "unknown tabs";
-}
-function listing(result) {
-    const tabs = Array.isArray(result.tabs) ? result.tabs : [];
-    if (tabs.length === 0)
-        return NO_TABS;
-    const rows = [
-        ["ID", "NAME", "STATUS", "CWD", "RELEASE", "HOLDER"],
-        ...tabs.map(tab => [tab.tabId, tab.name, tab.status, tab.cwd, tab.release, tab.holderPid ?? "-"].map(value => String(value ?? "-"))),
-    ];
-    const widths = rows[0].map((_, column) => Math.max(...rows.map(row => row[column].length)));
-    return `${rows.map(row => row.map((cell, column) => column === row.length - 1 ? cell : cell.padEnd(widths[column])).join("  ")).join("\n")}\n`;
-}
-function status(result) {
-    const limits = (result.limits ?? {});
-    const counters = (result.counters ?? {});
-    const byStatus = (result.tabsByStatus ?? {});
-    const lines = [
-        `pid: ${String(result.pid ?? "-")}`,
-        `build: ${String(result.build ?? "-")}`,
-        `release: ${String(result.release ?? "-")}`,
-        `generation: ${String(result.generation ?? "-")}`,
-        `epoch: ${String(result.epoch ?? "-")}`,
-        `uptime: ${String(result.uptimeSeconds ?? "-")}s`,
-        `detachment: ${String(result.detachmentMode ?? "unknown")}${result.detachmentVerified === false ? " (not verified)" : ""}`,
-        `tabs: ${String(result.tabs ?? 0)}${Object.keys(byStatus).length > 0 ? ` (${Object.entries(byStatus).map(([key, value]) => `${key} ${String(value)}`).join(", ")})` : ""}`,
-        `clients: ${String(result.clients ?? 0)}`,
-        ...startsAndLifecycle(result),
-        `limits: ${Object.entries(limits).map(([key, value]) => `${key} ${String(value)}`).join(", ")}`,
-        `counters: ${Object.entries(counters).map(([key, value]) => `${key} ${String(value)}`).join(", ")}`,
-        ...(Array.isArray(result.logs) ? result.logs.map(path => `log: ${String(path)}`) : []),
-    ];
-    return `${lines.join("\n")}\n`;
-}
-/** Lifecycle work running this long means a terminal's tab requests are stuck. */
-const LIFECYCLE_STALL_MS = 10_000;
-function startsAndLifecycle(result) {
-    const lines = [];
-    const starts = result.starts;
-    if (starts)
-        lines.push(`starts: active ${String(starts.active ?? 0)}, waiting ${String(starts.interactiveWaiting ?? 0)}, recovering ${String(starts.recoverySlots ?? 0)}`);
-    const lifecycle = result.lifecycle;
-    if (lifecycle) {
-        const oldest = typeof lifecycle.oldestMs === "number" ? lifecycle.oldestMs : 0;
-        lines.push(`lifecycle: pending ${String(lifecycle.pending ?? 0)}, oldest ${oldest}ms${oldest > LIFECYCLE_STALL_MS ? " (stalled)" : ""}`);
-    }
-    return lines;
-}

package/dist/composition/resident-tab-bridge.d.ts

@@ -1,41 +0,0 @@
-import type { OwnedUiReleaseUpdate } from "../contracts/owned-ui/index.js";
-import type { TabBridgeClient } from "../foundation/resident-tabs/bridge-client.js";
-import { type ResidentTabRoute } from "../foundation/resident-tabs/routes.js";
-import type { ResidentTabRecovery } from "../foundation/resident-tabs/recovery.js";
-import type { PiKeybindingsHost } from "../integrations/pi/components/shell-shared-facade.js";
-import type { ComposedSessionBackend } from "./session-backend.js";
-import type { OwnedRouteHostOptions } from "./settings-route-host.js";
-/**
- * The keybindings the shells borrow. Inside a resident tab the host dispatches and labels the tab
- * shortcuts this child projects from its effective declarations, so the projection is published now
- * and again after every customization reload.
- */
-export declare function residentTabKeybindings(tabBridge: TabBridgeClient | null, agentDir: string, keybindingsHost: PiKeybindingsHost): PiKeybindingsHost;
-/**
- * How owned screens are presented in a resident tab: a Settings or Changelog tab's screen is the tab, and the Plus menu entry opens
- * the tab bar's own Plus Menu dialog while this tab's controlling client can show it.
- */
-export declare function residentRouteHostOptions(tabBridge: TabBridgeClient | null): OwnedRouteHostOptions;
-/** Closes a utility tab when its own screen closes. Invariant: a utility tab's screen is the tab. */
-export declare function closeResidentUtilityRoute(tabBridge: Pick<TabBridgeClient, "tabId" | "requestClose">, route: string): void;
-export declare function bindResidentTabBridge(tabBridge: TabBridgeClient, backend: Pick<ComposedSessionBackend, "identity" | "session" | "workflows" | "generateResidentTabName">, recovery?: Pick<ResidentTabRecovery, "settled"> | null, options?: {
-    readonly autoName?: boolean;
-    readonly openRoute?: (route: ResidentTabRoute) => void;
-    readonly onClientVersion?: (version: string) => void;
-}): Promise<() => void>;
-export declare function createResidentClientIdentity(announce: (update: OwnedUiReleaseUpdate) => void): {
-    current: () => string | null;
-    onChange: (listener: () => void) => void;
-    observe: (next: string) => void;
-};
-/** Input ownership is established before the presenter starts, and released if bridge binding fails. */
-export declare function bindResidentPresentation(bridge: TabBridgeClient | null, backend: Parameters<typeof bindResidentTabBridge>[1], recovery: Parameters<typeof bindResidentTabBridge>[2], options: Parameters<typeof bindResidentTabBridge>[3], input: {
-    addPreInputListener(listener: (data: string) => {
-        data: string;
-    }): () => void;
-}): Promise<{
-    unsubscribeTabBridge: () => void;
-    removeControllerBoundaryInput: () => void;
-}>;
-export declare function correlateResidentTabSubmission(recovery: Pick<ResidentTabRecovery, "correlated" | "settled">, backend: Pick<ComposedSessionBackend, "identity" | "session">, submissionId: string, entryId: string): Promise<void>;
-export declare function currentBackendSessionFile(backend: Pick<ComposedSessionBackend, "identity">): string | null;