@timurproko/a1 0.1.1-dev.3 → 0.1.1-dev.5

package/dist/src/foundation/release/update.js

@@ -106,9 +106,7 @@ export function createUpdateLifecycleCoordinator(environment = process.env, file
             }
         },
         async activateInstalled(packageRoot, targetVersion, phase) {
-            const candidate = await materializeRelease(packageRoot, paths.dataDir, {
-                onProgress: progress => output.stdout(`${PRODUCT_TEXT.diagnostic(`installing ${progress.fileCount} files.`)}\n`),
-            });
+            const candidate = await materializeRelease(packageRoot, paths.dataDir);
             if (candidate.packageVersion !== targetVersion)
                 throw new Error(`installed ${PRODUCT_TEXT.displayName} version ${candidate.packageVersion} does not match target ${targetVersion}`);
             await stateStore.recordCandidate(candidate);
@@ -129,9 +127,19 @@ export async function runSelfUpdate(options) {
     const runner = options.runner ?? createNpmProcessRunner();
     const channel = options.channel ?? "stable";
     const distTag = UPDATE_DIST_TAGS[channel];
+    const now = options.now ?? (() => performance.now());
+    const measure = async (phase, operation) => {
+        const startedAt = now();
+        try {
+            return await operation();
+        }
+        finally {
+            options.onPhaseTiming?.({ phase, durationMs: Math.max(0, now() - startedAt) });
+        }
+    };
     let runningVersion;
     try {
-        const packageJson = JSON.parse(await fileSystem.readFile(resolve(options.packageRoot, "package.json")));
+        const packageJson = JSON.parse(await measure("package-version", async () => await fileSystem.readFile(resolve(options.packageRoot, "package.json"))));
         const parsedVersion = typeof packageJson.version === "string" ? validSemver(packageJson.version) : null;
         if (parsedVersion === null)
             throw new Error("package.json does not contain a valid semantic version");
@@ -141,7 +149,7 @@ export async function runSelfUpdate(options) {
         output.stderr(`${PRODUCT_TEXT.diagnostic(`could not read its running package version: ${errorMessage(error)}`)}\n`);
         return 1;
     }
-    const targetLookup = await runNpm(runner, ["view", `${PRODUCT_PACKAGE}@${distTag}`, "version"], true, output, `query the npm ${distTag} channel`);
+    const targetLookup = await measure("target-resolution", async () => await runNpm(runner, ["view", `${PRODUCT_PACKAGE}@${distTag}`, "version"], true, output, `query the npm ${distTag} channel`));
     if (targetLookup.result === null)
         return targetLookup.exitCode;
     const targetVersion = validSemver(targetLookup.result.stdout.trim());
@@ -150,7 +158,7 @@ export async function runSelfUpdate(options) {
         return 1;
     }
     output.stdout(`${PRODUCT_TEXT.diagnostic(`update (${channel}): ${runningVersion} → ${targetVersion}.`)}\n`);
-    const rootLookup = await runNpm(runner, ["root", "--global"], true, output, "resolve npm's global package root");
+    const rootLookup = await measure("global-root", async () => await runNpm(runner, ["root", "--global"], true, output, "resolve npm's global package root"));
     if (rootLookup.result === null)
         return rootLookup.exitCode;
     if (rootLookup.result.stdout.trim().length === 0) {
@@ -193,23 +201,39 @@ export async function runSelfUpdate(options) {
             priorActiveReleaseId: cohortState.references.active,
         });
         if (phaseBefore(transaction.phase, "ownership-released")) {
-            await lifecycle.shutdownVerifiedOwners(targetVersion);
-            await lifecycle.verifyPackageUnlocked(packageRoot);
+            await measure("ownership-release", async () => {
+                await lifecycle.shutdownVerifiedOwners(targetVersion);
+                await lifecycle.verifyPackageUnlocked(packageRoot);
+            });
             transaction = await transactionStore.advance("ownership-released");
         }
         if (phaseBefore(transaction.phase, "package-installed")) {
-            output.stdout(`${PRODUCT_TEXT.diagnostic(`is installing ${PRODUCT_TEXT.packageName}@${targetVersion}.`)}\n`);
-            const installation = await runNpm(runner, ["install", "--global", `${PRODUCT_PACKAGE}@${targetVersion}`], false, output, "start the global npm installation", false);
+            const installation = await measure("npm-install", async () => await runNpm(runner, ["install", "--global", "--loglevel=error", "--no-fund", "--no-audit", `${PRODUCT_PACKAGE}@${targetVersion}`], true, output, "start the global npm installation", false));
             if (installation.result === null)
                 throw new UpdateFailure(installation.exitCode, "npm process failed");
-            if (installation.result.code !== 0)
+            if (installation.result.code !== 0) {
+                if (installation.result.stdout.trim().length > 0)
+                    output.stderr(`${installation.result.stdout.trimEnd()}\n`);
                 throw new UpdateFailure(unsuccessfulCode(installation.result.code), `npm exited with status ${formatExitCode(installation.result.code)}`);
+            }
             transaction = await transactionStore.advance("package-installed");
         }
-        await lifecycle.activateInstalled(packageRoot, targetVersion, async (phase) => { transaction = await transactionStore.advance(phase); });
+        // Ownership can be reacquired after an interrupted installation (for
+        // example, if bare A1 is launched before the update is resumed). Recheck
+        // immediately before activation so recovery cannot start a second cohort.
+        await measure("ownership-release", async () => { await lifecycle.shutdownVerifiedOwners(targetVersion); });
+        let activationPhaseStartedAt = now();
+        await lifecycle.activateInstalled(packageRoot, targetVersion, async (phase) => {
+            options.onPhaseTiming?.({ phase, durationMs: Math.max(0, now() - activationPhaseStartedAt) });
+            transaction = await transactionStore.advance(phase);
+            activationPhaseStartedAt = now();
+        });
+        options.onPhaseTiming?.({ phase: "supervisor-verified", durationMs: Math.max(0, now() - activationPhaseStartedAt) });
+        const transactionStartedAt = now();
         await transactionStore.advance("supervisor-verified");
         await transactionStore.finish("completed");
         await transactionStore.clearCompleted();
+        options.onPhaseTiming?.({ phase: "transaction-complete", durationMs: Math.max(0, now() - transactionStartedAt) });
         output.stdout(`${PRODUCT_TEXT.diagnostic(`updated successfully: ${targetVersion} (${channel}).`)}\n`);
         return 0;
     }
@@ -224,6 +248,21 @@ export async function runSelfUpdate(options) {
         return error instanceof UpdateFailure ? error.exitCode : 1;
     }
 }
+export function assertUpdatePerformanceBudget(evidence, maximumPostNpmDurationMs = 30_000) {
+    const failures = [];
+    if (evidence.fileCount < 1)
+        failures.push("fixture contains no payload files");
+    if (evidence.sourceReads !== evidence.fileCount)
+        failures.push(`source payload read count is ${evidence.sourceReads} for ${evidence.fileCount} files`);
+    if (evidence.candidateWrites !== evidence.fileCount)
+        failures.push(`candidate payload write count is ${evidence.candidateWrites} for ${evidence.fileCount} files`);
+    if (evidence.verificationReads > 0)
+        failures.push(`fresh certification reread ${evidence.verificationReads} candidate files`);
+    if (evidence.postNpmDurationMs > maximumPostNpmDurationMs)
+        failures.push(`post-npm activation took ${Math.round(evidence.postNpmDurationMs)}ms; budget is ${maximumPostNpmDurationMs}ms`);
+    if (failures.length > 0)
+        throw new Error(`update performance budget failed: ${failures.join("; ")}`);
+}
 async function requestUpdateShutdown(metadata, targetVersion, timeoutMs) {
     if (!processIsAlive(metadata.pid))
         return { accepted: false, reason: "recorded owner is dead" };

package/docs/ci-release-runbook.md

@@ -0,0 +1,63 @@
+# CI and release operations
+
+This runbook is the operational source for scoped development validation, immutable npm candidates, stable certification, and branch enforcement. GitHub Actions is the only automation platform.
+
+## Stable status names
+
+Repository rules use job display names, not internal job keys. Keep these names stable:
+
+| Protected flow | Required check | Producer |
+| --- | --- | --- |
+| Pull request into `develop` | `Development validation required` | `.github/workflows/ci.yml` |
+| Accepted `develop` commit | `Development validation required` | `.github/workflows/ci.yml` push run |
+| Promotion into `master` | `Stable candidate required` | `.github/workflows/certify-stable.yml` |
+
+Matrix and tier job names are implementation details. Change a required name only by updating the reviewable ruleset definition, its governance tests, this runbook, and the live ruleset together.
+
+## Advisory rollout and widening validation
+
+New or materially changed selection rules run in advisory mode before their check becomes required. Compare at least one feature-only change and one cross-cutting change with a complete run. A selection miss is a policy defect: widen `config/validation-impact.json`, add a regression test, and rerun complete validation before enabling enforcement.
+
+The selector can only widen validation. To override an affected plan, dispatch **Development validation** at the exact `develop` ref with `full: true`. This selects `full-release`; it cannot suppress mandatory tiers. Dispatch **Full regression** for the complete non-physical package and clean-install path. Scheduled Full regression is also the backstop for impact-map mistakes.
+
+When selection is uncertain, deleted, renamed, unmapped, or based on an unavailable Git range, it must fail closed to full validation. Do not bypass this fallback with labels or edited workflow inputs.
+
+## Preview candidate and `next` publication
+
+1. Confirm `Development validation required` is green for the exact `develop` tip.
+2. Dispatch **Build npm next candidate** on `develop` with the exact source commit, a trusted ancestor base commit, and `confirm_candidate=build-uncertified-next-candidate`. Use `full: true` whenever ordinary affected coverage is not sufficient for the release decision.
+3. Review `candidate-evidence.json`, selected scopes, gate outcomes, package integrity, and source tree. The candidate remains explicitly stable-ineligible.
+4. Approve the protected `npm-next` environment and dispatch **Publish npm next** with the successful candidate run id and `confirm_next=publish-certified-next`.
+5. The publisher downloads and verifies the certified tarball, then publishes those bytes without checkout, installation, build, or tests. Verify its registry digest and `next` tag result.
+
+Preview candidates expire after 14 days. An expired, missing, failed, or mismatched artifact is never reconstructed in the publisher. Build and certify a new candidate.
+
+## Stable candidate, physical evidence, and `latest` publication
+
+1. Commit the final non-prerelease version to `develop`. Confirm it is clean, registry-unpublished, and `v<package-version>` is the intended tag.
+2. Dispatch **Build stable candidate** on that exact `develop` commit with `confirm_candidate=build-stable-candidate`. It packs once on Windows and fans the same verified digest to Windows, Linux, and macOS complete automated validation and clean installation.
+3. Review the `Stable automated candidate` artifact. It is not stable-eligible; physical evidence is still required.
+4. On dedicated isolated workers only, dispatch **Certify stable physical platforms** for the same source and automated-candidate run with `confirm_isolated=run-isolated-physical-certification`. Workers must carry `self-hosted`, `a1-physical`, and platform-specific labels, set `PHYSICAL_WORKER_ISOLATED=true`, and be protected by the `stable-physical` environment. Never run physical host probes on a developer workstation or ordinary hosted runner.
+5. Dispatch **Certify stable candidate** with the successful automated and physical run ids and `confirm_certification=certify-stable-candidate`. `Stable candidate required` passes only when all three automated and all three isolated physical verdicts bind the same commit, tree, version, integrity, and shasum.
+6. Promote that exact commit to `master` without source or package changes and create `v<version>` at the same commit. The protected `master` rule requires the existing `Stable candidate required` check on that commit.
+7. Dispatch **Publish npm stable** on the tag with the certification run id and `confirm_stable=publish-certified-stable-latest`, then approve `npm-stable`. It requires the current `master` and tag to equal the certified source, confirms the version is unpublished, publishes the exact tarball to `latest` with provenance, and verifies registry bytes.
+
+Stable automated and physical candidate artifacts expire after 30 days. Publication evidence is retained for 90 days. Artifact expiry requires a new pack and complete recertification; it does not permit repacking during publication.
+
+## Failure recovery
+
+- **Development failure:** inspect impact and outcome artifacts. Fix the source or mapping and rerun. Do not mark a failed tier optional.
+- **Candidate validation failure:** discard the candidate. Any source change, package change, or uncertain evidence requires a new candidate run.
+- **Physical failure:** quarantine the worker result, fix or replace the isolated worker, and rerun all evidence needed for one exact package. A hosted matrix cannot substitute for physical evidence.
+- **Approval or artifact expiry:** create and certify a new candidate. Never upload locally rebuilt bytes.
+- **Publisher failure before npm accepts bytes:** retain the candidate and diagnose identity, permissions, registry, or provenance. Retry only with the same candidate run if the registry still proves the version unpublished and the artifact has not expired.
+- **Publisher uncertainty after npm accepts bytes:** do not republish or rebuild. Query the registry for version, dist-tag, integrity, and shasum; repair a dist-tag only through a separately reviewed registry operation.
+- **Partial stable certification:** stable eligibility remains false. Missing, duplicated, failed, non-isolated, or mismatched platform evidence fails closed.
+
+## Enforcement rollout and rollback
+
+Ruleset mutation is a separate administrative operation. First run `node scripts/check-github-rulesets.mjs` in report mode and review the proposed diff. Apply only after workflows exist on the default branch, representative advisory runs pass, and a maintainer explicitly confirms the exact ruleset change. Capture the post-apply repository API response as evidence.
+
+If a required check is operationally broken, prefer correcting the workflow. Emergency rollback may disable only the affected required context after restoring the previous blocking validation path and recording maintainer approval. Never weaken force-push/deletion protection to release. Never route around certification by rebuilding inside a publisher.
+
+After rollback, publication still requires exact certified bytes. A failed or unavailable candidate workflow means release waits for a new candidate; it does not authorize an ad hoc npm upload.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.1.1-dev.3",
+  "version": "0.1.1-dev.5",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "packageManager": "npm@11.13.0",
@@ -21,16 +21,20 @@
     "clean": "node scripts/clean.mjs",
     "build": "npm run clean && tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "check:architecture": "node scripts/check-architecture.mjs && node scripts/product-identifier-policy.mjs --check && node scripts/check-product-identity-boundaries.mjs && node scripts/check-package-identity.mjs && node scripts/check-pinned-pi-source-ledger.mjs && node scripts/check-terminal-host-provenance.mjs",
+    "check:architecture": "node scripts/check-architecture.mjs && node scripts/product-identifier-policy.mjs --check && node scripts/check-product-identity-boundaries.mjs && node scripts/check-package-identity.mjs && node scripts/check-pinned-pi-source-ledger.mjs && node scripts/check-terminal-host-provenance.mjs && node scripts/check-validation-governance.mjs",
     "check:customization-ready": "node scripts/check-owned-ui-customization-prerequisites.mjs",
     "check:deprecated": "node scripts/check-deprecated-dependencies.mjs",
     "branches:prune": "node scripts/prune-merged-branches.mjs",
-    "check": "npm run typecheck && npm run check:architecture && npm run check:customization-ready && npm run check:deprecated && npm test && npm run test:release",
+    "report:validation-inventory": "node scripts/report-validation-inventory.mjs",
+    "check": "npm run test:release",
     "validate:agent": "npm run check",
     "publish:next": "tsx scripts/publish-next.ts",
-    "test": "vitest run",
-    "test:unit": "vitest run test/cli test/features test/foundation test/repository-governance --exclude '**/*.integration.test.ts'",
-    "test:integration": "vitest run test/foundation/release/update-transition.integration.test.ts test/features/launch/profile-isolation.integration.test.ts",
+    "test": "npm run test:fast",
+    "test:fast": "node scripts/run-validation-tier.mjs invariants fast",
+    "test:unit": "node scripts/run-validation-tier.mjs fast",
+    "test:integration": "node scripts/run-validation-tier.mjs launch-integration pi-engine-conformance release-update structured-runtime-integration",
+    "test:scope": "node scripts/run-validation-tier.mjs",
+    "test:full": "node scripts/run-validation-tier.mjs full-release",
     "test:release": "node scripts/run-release-gates.mjs",
     "test:terminal-host": "node scripts/run-terminal-host-probe.mjs",
     "test:pi-terminal-parity": "npm run build --silent && node scripts/run-pi-terminal-parity.mjs",

package/dist/src/composition/structured-workspace-application.d.ts

@@ -1,38 +0,0 @@
-import { OwnedUiSessionShellRoot } from "../foundation/pi-owned-ui-integration/index.js";
-import { PiTuiRuntimeAdapter, type PiTuiComponentPort } from "../foundation/pi-tui-runtime-adapter/index.js";
-import type { OwnedUiApplicationPort, PresentationTerminalPort } from "../foundation/presentation-contracts/index.js";
-import { type StructuredWorkspaceTabs } from "../features/workspace/index.js";
-export interface StructuredWorkspaceApplicationOptions {
-    readonly workspace: StructuredWorkspaceTabs;
-    readonly cwd: string;
-    readonly terminal?: PresentationTerminalPort;
-    readonly mode?: "regular" | "fullscreen";
-}
-export declare class StructuredWorkspaceApplication implements OwnedUiApplicationPort {
-    #private;
-    readonly workspace: StructuredWorkspaceTabs;
-    readonly root: OwnedUiSessionShellRoot;
-    readonly runtime: PiTuiRuntimeAdapter;
-    readonly component: StructuredWorkspaceRootComponent;
-    constructor(options: StructuredWorkspaceApplicationOptions);
-    get disposed(): boolean;
-    start(): void;
-    flush(): Promise<void>;
-    waitUntilStopped(): Promise<void>;
-    submit(raw: string): Promise<void>;
-    switchRelative(direction: -1 | 1): Promise<void>;
-    dispose(): Promise<void>;
-}
-export declare class StructuredWorkspaceRootComponent implements PiTuiComponentPort {
-    readonly workspace: StructuredWorkspaceTabs;
-    readonly sessionRoot: OwnedUiSessionShellRoot;
-    readonly onSwitch: (direction: -1 | 1) => void;
-    readonly onEditorChange: (text: string) => void;
-    readonly notice: () => string | null;
-    constructor(workspace: StructuredWorkspaceTabs, sessionRoot: OwnedUiSessionShellRoot, onSwitch: (direction: -1 | 1) => void, onEditorChange: (text: string) => void, notice: () => string | null);
-    render(width: number): readonly string[];
-    handleInput(data: string): void;
-    invalidate(): void;
-    setFocused(focused: boolean): void;
-    dispose(): void;
-}

package/dist/src/composition/structured-workspace-application.js

@@ -1,261 +0,0 @@
-import { OWNED_UI_CONTRACT_VERSION, } from "../foundation/owned-ui-contracts/index.js";
-import { OwnedUiSessionShellRoot } from "../foundation/pi-owned-ui-integration/index.js";
-import { createPiTerminalBridge, PiTuiRuntimeAdapter, } from "../foundation/pi-tui-runtime-adapter/index.js";
-import {} from "../features/workspace/index.js";
-export class StructuredWorkspaceApplication {
-    workspace;
-    root;
-    runtime;
-    component;
-    #unsubscribe;
-    #resolveStopped;
-    #stopped;
-    #notice = null;
-    #disposed = false;
-    #started = false;
-    #agentSequence;
-    constructor(options) {
-        this.workspace = options.workspace;
-        const initial = selectedPanel(options.workspace.view());
-        if (!initial)
-            throw new TypeError("structured workspace application requires an initial agent tab");
-        this.#agentSequence = options.workspace.view().panels.length;
-        this.#stopped = new Promise(resolve => { this.#resolveStopped = resolve; });
-        this.root = new OwnedUiSessionShellRoot(toOwnedView(options.workspace.view(), initial, null, 80, 24), options.cwd, {
-            getColumns: () => this.runtime?.viewport().columns ?? options.terminal?.columns ?? 80,
-            getRows: () => this.runtime?.viewport().rows ?? options.terminal?.rows ?? 24,
-            requestRender: () => this.runtime?.requestRender(),
-            onSubmit: text => { void this.submit(text); },
-            onInterrupt: () => { this.#notice = "Use /agent stop to stop the selected agent."; this.runtime?.requestRender(); },
-            onClear: () => { this.root.editor.setText(""); this.runtime?.requestRender(); },
-            onExit: () => { void this.dispose(); },
-            onModelSelect: () => { this.#notice = "Model selection remains scoped to each structured agent session."; this.runtime?.requestRender(); },
-            onThinkingCycle: () => { this.#notice = "Thinking settings remain scoped to each structured agent session."; this.runtime?.requestRender(); },
-        });
-        this.component = new StructuredWorkspaceRootComponent(this.workspace, this.root, direction => { void this.switchRelative(direction); }, text => this.#saveEditor(text), () => this.#notice);
-        this.runtime = new PiTuiRuntimeAdapter({
-            root: this.component,
-            mode: options.mode ?? "regular",
-            ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-            hardwareCursor: true,
-            mouse: false,
-        });
-        this.#unsubscribe = this.workspace.subscribe(view => this.#sync(view));
-    }
-    get disposed() { return this.#disposed; }
-    start() {
-        if (this.#started || this.#disposed)
-            return;
-        this.#started = true;
-        this.runtime.start();
-        this.#sync(this.workspace.view());
-    }
-    async flush() {
-        await this.workspace.flush();
-        this.#sync(this.workspace.view());
-    }
-    waitUntilStopped() { return this.#stopped; }
-    async submit(raw) {
-        const input = raw.trim();
-        if (!input)
-            return;
-        if (input === "/agent" || input.startsWith("/agent ")) {
-            await this.#agentCommand(input.slice("/agent".length).trim());
-            return;
-        }
-        const selected = selectedPanel(this.workspace.view());
-        if (!selected)
-            return;
-        this.workspace.setEditorText(selected.agentId, input);
-        const result = await this.workspace.sendPrompt(selected.agentId, input);
-        this.#notice = result.kind === "rejected" ? result.diagnostic : null;
-        this.#sync(this.workspace.view());
-    }
-    async switchRelative(direction) {
-        const view = this.workspace.view();
-        if (view.panels.length < 2)
-            return;
-        this.#saveEditor(this.root.editor.getText());
-        const current = Math.max(0, view.panels.findIndex(panel => panel.selected));
-        const next = (current + direction + view.panels.length) % view.panels.length;
-        const target = view.panels[next];
-        if (target)
-            await this.workspace.selectAgent(target.agentId);
-    }
-    async dispose() {
-        if (this.#disposed)
-            return;
-        this.#disposed = true;
-        this.#unsubscribe();
-        const failures = [];
-        await this.runtime.stop().catch(error => failures.push(error));
-        await this.workspace.dispose().catch(error => failures.push(error));
-        this.#resolveStopped?.();
-        if (failures.length > 0)
-            throw new AggregateError(failures, "structured workspace application disposal failed");
-    }
-    async #agentCommand(argument) {
-        const [command = "list", ...rest] = argument.split(/\s+/).filter(Boolean);
-        const view = this.workspace.view();
-        const selected = selectedPanel(view);
-        if (command === "new") {
-            this.#agentSequence += 1;
-            const id = `agent-${this.#agentSequence}`;
-            const displayName = rest.join(" ") || `Agent ${this.#agentSequence}`;
-            const created = await this.workspace.createAgent({ id, displayName });
-            if (created.kind === "applied")
-                await this.workspace.selectAgent(id);
-            this.#notice = created.kind === "rejected" ? created.diagnostic : `Created ${created.value.agentId}.`;
-        }
-        else if (command === "next" || command === "previous" || command === "prev") {
-            await this.switchRelative(command === "next" ? 1 : -1);
-            this.#notice = null;
-        }
-        else if (command === "select") {
-            const target = rest[0];
-            const selectedResult = target ? await this.workspace.selectAgent(target) : null;
-            this.#notice = selectedResult === null ? "Usage: /agent select <id>" : selectedResult.kind === "rejected" ? selectedResult.diagnostic : null;
-        }
-        else if (command === "stop") {
-            const result = selected ? await this.workspace.stopAgent(selected.agentId) : null;
-            this.#notice = result === null ? "No agent selected." : result.kind === "rejected" ? result.diagnostic : `Stopped ${selected.agentId}.`;
-        }
-        else if (command === "restart") {
-            const result = selected ? await this.workspace.restartAgent(selected.agentId) : null;
-            this.#notice = result === null ? "No agent selected." : result.kind === "rejected" ? result.diagnostic : `Restarted ${selected.agentId}.`;
-        }
-        else if (command === "remove") {
-            if (!selected)
-                this.#notice = "No agent selected.";
-            else {
-                if (selected.lifecycle !== "stopped" && selected.lifecycle !== "failed")
-                    await this.workspace.stopAgent(selected.agentId);
-                const result = await this.workspace.removeAgent(selected.agentId);
-                this.#notice = result.kind === "rejected" ? result.diagnostic : `Removed ${selected.agentId}.`;
-            }
-        }
-        else if (command === "list") {
-            this.#notice = view.tabs.length === 0 ? "No managed agents." : view.tabs.map(tab => `${tab.selected ? "*" : " "}${tab.agentId}:${tab.label}`).join("  ");
-        }
-        else {
-            this.#notice = "Usage: /agent [list|new [name]|next|prev|select <id>|stop|restart|remove]";
-        }
-        this.#sync(this.workspace.view());
-    }
-    #saveEditor(text) {
-        const selected = selectedPanel(this.workspace.view());
-        if (selected)
-            this.workspace.setEditorText(selected.agentId, text);
-    }
-    #sync(view) {
-        const selected = selectedPanel(view);
-        if (!selected)
-            return;
-        const viewport = this.runtime?.viewport() ?? { columns: 80, rows: 24 };
-        this.root.update(toOwnedView(view, selected, this.#notice, viewport.columns, viewport.rows));
-        if (this.root.editor.getText() !== selected.editorText)
-            this.root.editor.setText(selected.editorText);
-        this.component.invalidate();
-        this.runtime?.requestRender();
-    }
-}
-export class StructuredWorkspaceRootComponent {
-    workspace;
-    sessionRoot;
-    onSwitch;
-    onEditorChange;
-    notice;
-    constructor(workspace, sessionRoot, onSwitch, onEditorChange, notice) {
-        this.workspace = workspace;
-        this.sessionRoot = sessionRoot;
-        this.onSwitch = onSwitch;
-        this.onEditorChange = onEditorChange;
-        this.notice = notice;
-    }
-    render(width) {
-        const view = this.workspace.view();
-        const tabLine = truncate(view.tabs.map(tab => `${tab.selected ? "[" : " "}${tab.label}${tab.selected ? "]" : " "}`).join("  "), width);
-        const notice = this.notice();
-        return [tabLine, ...(notice ? [truncate(notice, width)] : []), ...this.sessionRoot.render(width)];
-    }
-    handleInput(data) {
-        if (data === "\x1b[6;5~" || data === "\x1b[1;3C") {
-            this.onEditorChange(this.sessionRoot.editor.getText());
-            this.onSwitch(1);
-            return;
-        }
-        if (data === "\x1b[5;5~" || data === "\x1b[1;3D") {
-            this.onEditorChange(this.sessionRoot.editor.getText());
-            this.onSwitch(-1);
-            return;
-        }
-        this.sessionRoot.editor.handleInput?.(data);
-    }
-    invalidate() { this.sessionRoot.invalidate(); }
-    setFocused(focused) { this.sessionRoot.editor.setFocused?.(focused); }
-    dispose() { this.sessionRoot.dispose?.(); }
-}
-function selectedPanel(view) {
-    return view.selectedPanel ?? view.panels[0] ?? null;
-}
-function toOwnedView(workspace, panel, notice, columns, rows) {
-    const agent = workspace.workspace.agents.find(candidate => candidate.id === panel.agentId);
-    return {
-        contractVersion: OWNED_UI_CONTRACT_VERSION,
-        sessionId: panel.sessionId,
-        revision: workspace.workspace.revision + panel.lastSequence,
-        lifecycle: ownedLifecycle(panel.lifecycle),
-        transcript: panel.transcript.flatMap(messageBlocks),
-        editor: {
-            text: panel.editorText,
-            queuedSubmissions: [],
-            selection: null,
-            cursorOffset: panel.editorText.length,
-            historyRevision: panel.lastSequence,
-            submitEnabled: panel.lifecycle !== "stopping" && panel.lifecycle !== "stopped" && panel.lifecycle !== "failed",
-        },
-        status: {
-            title: agent?.displayName ?? panel.agentId,
-            workingMessage: panel.lifecycle === "busy" ? "Working" : null,
-            diagnostics: panel.failure ? [panel.failure] : notice ? [notice] : [],
-            badges: [
-                `${workspace.panels.length} agents`,
-                ...(agent?.unreadActivity ? [`${agent.unreadActivity} unread`] : []),
-                ...(agent?.attention ? ["attention"] : []),
-            ],
-            footer: { branch: null, sessionName: agent?.displayName ?? null, availableProviderCount: 0, extensionStatuses: [] },
-        },
-        terminal: { columns, rows, focusedRegion: "editor", hardwareCursor: true },
-        activeModel: null,
-        thinkingLevel: "medium",
-        activeCommandIds: panel.activeCommandIds,
-        dialog: null,
-        overlay: null,
-        customizations: [],
-        diagnostics: panel.failure ? [{ sequence: panel.lastSequence, code: "structured-agent", severity: "error", message: panel.failure, recoverable: true }] : [],
-    };
-}
-function messageBlocks(message) {
-    return message.content.map((content, index) => {
-        const base = { id: `${message.id}.${index}`, status: message.status === "streaming" ? "live" : "finalized", revision: index + 1, title: null };
-        if (content.kind === "thinking")
-            return { ...base, kind: "thinking", text: content.text, payload: {} };
-        if (content.kind === "tool-call")
-            return { ...base, kind: "tool-call", title: content.toolName, text: JSON.stringify(content.input), payload: content };
-        if (content.kind === "tool-result")
-            return { ...base, kind: "tool-result", text: JSON.stringify(content.output), payload: content };
-        if (content.kind === "image")
-            return { ...base, kind: "custom", title: content.mediaType, text: "[image]", payload: content };
-        if (content.kind === "unknown")
-            return { ...base, kind: "custom", title: content.sourceType, text: JSON.stringify(content.payload), payload: content };
-        return { ...base, kind: message.role === "user" ? "user" : message.role === "system" ? "system" : message.role === "tool" ? "tool-result" : "assistant", text: content.text, payload: {} };
-    });
-}
-function ownedLifecycle(lifecycle) {
-    return lifecycle;
-}
-function truncate(value, width) {
-    if (width <= 0)
-        return "";
-    return value.length <= width ? value : width === 1 ? "…" : `${value.slice(0, width - 1)}…`;
-}

package/dist/src/features/workspace/structured-tabs.d.ts

@@ -1,83 +0,0 @@
-import { type AgentCommandOutcome, type AgentEnginePort, type AgentMessage, type AgentSessionLifecycle } from "../../foundation/agent-engine-contracts/index.js";
-import { type WorkspacePresentationModel } from "./presentation.js";
-import { type WorkspaceView } from "./reducer.js";
-import { WorkspaceRouter } from "./router.js";
-export interface StructuredWorkspaceLimits {
-    readonly maxAgents: number;
-    readonly maxMessagesPerAgent: number;
-    readonly maxMessageBytes: number;
-    readonly maxEditorBytes: number;
-}
-export interface StructuredWorkspaceTabsOptions {
-    readonly workspaceId?: string;
-    readonly cwd: string;
-    readonly createEngine: (agentId: string) => Promise<AgentEnginePort>;
-    readonly limits?: Partial<StructuredWorkspaceLimits>;
-    readonly now?: () => string;
-}
-export interface StructuredAgentTabView {
-    readonly role: "tabpanel";
-    readonly agentId: string;
-    readonly sessionId: string;
-    readonly selected: boolean;
-    readonly lifecycle: AgentSessionLifecycle;
-    readonly transcript: readonly AgentMessage[];
-    readonly toolMessages: readonly AgentMessage[];
-    readonly editorText: string;
-    readonly activeCommandIds: readonly string[];
-    readonly lastSequence: number;
-    readonly failure: string | null;
-    readonly accessibleDescription: string;
-}
-export interface StructuredWorkspaceTabSelector {
-    readonly role: "tab";
-    readonly agentId: string;
-    readonly label: string;
-    readonly selected: boolean;
-    readonly accessibleDescription: string;
-}
-export interface StructuredWorkspaceTabsView {
-    readonly role: "tablist";
-    readonly workspace: WorkspaceView;
-    readonly presentation: WorkspacePresentationModel;
-    readonly tabs: readonly StructuredWorkspaceTabSelector[];
-    readonly panels: readonly StructuredAgentTabView[];
-    readonly selectedPanel: StructuredAgentTabView | null;
-}
-export type StructuredWorkspaceTabsResult<T> = {
-    readonly kind: "applied";
-    readonly view: StructuredWorkspaceTabsView;
-    readonly value: T;
-} | {
-    readonly kind: "rejected";
-    readonly code: string;
-    readonly diagnostic: string;
-};
-export declare class StructuredWorkspaceTabs {
-    #private;
-    readonly router: WorkspaceRouter;
-    constructor(options: StructuredWorkspaceTabsOptions);
-    subscribe(listener: (view: StructuredWorkspaceTabsView) => void): () => void;
-    createAgent(input: {
-        readonly id: string;
-        readonly displayName: string;
-        readonly sessionId?: string;
-    }): Promise<StructuredWorkspaceTabsResult<StructuredAgentTabView>>;
-    selectAgent(agentId: string): Promise<StructuredWorkspaceTabsResult<StructuredAgentTabView>>;
-    setEditorText(agentId: string, text: string): StructuredWorkspaceTabsResult<StructuredAgentTabView>;
-    submitSelected(): Promise<StructuredWorkspaceTabsResult<{
-        readonly correlationId: string;
-        readonly outcome: AgentCommandOutcome;
-    }>>;
-    sendPrompt(agentId: string, text: string): Promise<StructuredWorkspaceTabsResult<{
-        readonly correlationId: string;
-        readonly outcome: AgentCommandOutcome;
-    }>>;
-    stopAgent(agentId: string): Promise<StructuredWorkspaceTabsResult<StructuredAgentTabView>>;
-    restartAgent(agentId: string): Promise<StructuredWorkspaceTabsResult<StructuredAgentTabView>>;
-    refreshAgent(agentId: string): Promise<StructuredWorkspaceTabsResult<StructuredAgentTabView>>;
-    removeAgent(agentId: string): Promise<StructuredWorkspaceTabsResult<string>>;
-    flush(): Promise<void>;
-    view(): StructuredWorkspaceTabsView;
-    dispose(): Promise<void>;
-}