@timurproko/a1 0.1.8-dev.112 → 0.1.8-dev.121

package/dist/{src/foundation → foundation}/supervision/server.js

@@ -14,6 +14,8 @@ export class SupervisorServer {
     terminateProcess;
     reconciliationDeadlineMs;
     shutdownDeadlineMs;
+    readActiveReleaseId;
+    supersededPollMs;
     id = randomUUID();
     bootNonce;
     pidStartIdentity = `${process.pid}:${Math.floor(Date.now() - process.uptime() * 1_000)}`;
@@ -31,12 +33,22 @@ export class SupervisorServer {
     #results = new Map();
     #metadataWrites = Promise.resolve();
     #closing = false;
-    constructor(store, paths = resolveProductPaths(), release, bootNonce = randomUUID(), terminateProcess = code => process.exit(code), reconciliationDeadlineMs = 3_000, shutdownDeadlineMs = 1_500) {
+    #superseded = false;
+    #supersededPoll = null;
+    constructor(store, paths = resolveProductPaths(), release, bootNonce = randomUUID(), terminateProcess = code => process.exit(code), reconciliationDeadlineMs = 3_000, shutdownDeadlineMs = 1_500, 
+    /**
+     * Which release new sessions start on. A cohort that is no longer that release keeps
+     * serving the instances it already has, takes no new ones, and exits when its last one
+     * leaves. Absent, this supervisor never considers itself superseded.
+     */
+    readActiveReleaseId = null, supersededPollMs = 1_000) {
         this.store = store;
         this.release = release;
         this.terminateProcess = terminateProcess;
         this.reconciliationDeadlineMs = reconciliationDeadlineMs;
         this.shutdownDeadlineMs = shutdownDeadlineMs;
+        this.readActiveReleaseId = readActiveReleaseId;
+        this.supersededPollMs = supersededPollMs;
         this.bootNonce = bootNonce;
         this.paths = paths;
         for (const instance of store.loadActiveLaunchInstances())
@@ -56,6 +68,7 @@ export class SupervisorServer {
         if (this.#server)
             throw new Error("supervisor is already listening");
         await mkdir(this.paths.runtimeDir, { recursive: true, mode: 0o700 });
+        await mkdir(this.paths.endpointsDir, { recursive: true, mode: 0o700 });
         if (platform() !== "win32") {
             if (await endpointIsLive(this.paths.endpoint))
                 throw new Error(PRODUCT_TEXT.diagnostic(`supervisor already owns ${this.paths.endpoint}`));
@@ -71,12 +84,44 @@ export class SupervisorServer {
             });
         });
         await this.#writeEndpointMetadata();
+        if (this.readActiveReleaseId) {
+            const poll = setInterval(() => void this.#refreshCohortRole(), this.supersededPollMs);
+            poll.unref();
+            this.#supersededPoll = poll;
+        }
+    }
+    /**
+     * Notices that another release has become the one new sessions start on. Nothing is
+     * interrupted by that: this cohort finishes what it is holding and then leaves.
+     */
+    async #refreshCohortRole() {
+        if (this.#closing || !this.readActiveReleaseId)
+            return;
+        const active = await this.readActiveReleaseId().catch(() => null);
+        if (active === null)
+            return;
+        this.#superseded = active !== this.release.releaseId;
+        if (this.#superseded && this.#instances.size === 0)
+            await this.retire();
+    }
+    /** Whether new sessions start on some other release. */
+    get superseded() {
+        return this.#superseded;
+    }
+    /** Leaves, taking this cohort's own endpoint artifacts with it. */
+    async retire() {
+        if (this.#closing)
+            return;
+        await this.close(false);
     }
     async close(stopAgents = false) {
         if (stopAgents && !await this.#drainInstances("update", this.shutdownDeadlineMs)) {
             throw new Error("active launch instances did not release ownership within the shutdown deadline");
         }
         this.#closing = true;
+        if (this.#supersededPoll)
+            clearInterval(this.#supersededPoll);
+        this.#supersededPoll = null;
         for (const client of this.#clients)
             client.destroy();
         if (this.#server)
@@ -197,6 +242,9 @@ export class SupervisorServer {
     #createLaunchInstance(command, socket, clientId) {
         assertNativeProcessIdentity(command.guardianIdentity);
         const existing = this.store.loadLaunchInstance(command.instanceId);
+        if (this.#superseded && !existing) {
+            throw new Error(PRODUCT_TEXT.diagnostic(`release ${this.release.releaseId} is no longer the release new sessions start on`));
+        }
         if (existing) {
             if (existing.ownerClientId !== clientId
                 || existing.profileId !== command.profileId
@@ -279,6 +327,9 @@ export class SupervisorServer {
         this.#uncertainInstances.delete(stored.id);
         this.#unbindOwner(stored.id, socket);
         this.#mutated();
+        // The last session on a superseded cohort has left; there is nothing here to keep.
+        if (this.#superseded && this.#instances.size === 0)
+            void this.retire();
     }
     #ownedInstance(instanceId, socket, clientId) {
         const instance = this.#instances.get(instanceId) ?? this.store.loadLaunchInstance(instanceId);

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/components.d.ts

@@ -1,4 +1,4 @@
-import type { OwnedUiTranscriptBlock } from "../owned-ui-contracts/index.js";
+import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 export declare function adaptPiUserMessage(block: OwnedUiTranscriptBlock, width: number): readonly string[];
 export declare function adaptPiAssistantMessage(block: OwnedUiTranscriptBlock, width: number): readonly string[];
 export declare function adaptPiToolExecution(block: OwnedUiTranscriptBlock, width: number, cwd: string): readonly string[];

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/conformance.js

@@ -2,9 +2,9 @@ import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { AssistantMessageComponent, ExtensionSelectorComponent, initTheme, LoginDialogComponent, ModelSelectorComponent, SettingsSelectorComponent, ThemeSelectorComponent, ThinkingSelectorComponent, ToolExecutionComponent, UserMessageComponent, UserMessageSelectorComponent, VERSION, } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_CONTRACT_VERSION } from "../owned-ui-contracts/index.js";
+import { OWNED_UI_CONTRACT_VERSION } from "../../../contracts/owned-ui/index.js";
 import { createTuiFacade, validatedAssistantMessage } from "./shell-components.js";
-import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { PRODUCT_IDENTITY } from "../../../product-identity.js";
 export class PiComponentConformanceError extends Error {
     stage;
     constructor(stage, cause) {

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-extension-ui.d.ts

@@ -1,5 +1,5 @@
 import { type ExtensionUIContext } from "@earendil-works/pi-coding-agent";
-import type { OwnedUiExtensionOverlayHandle, OwnedUiExtensionOverlayOptions } from "../owned-ui-contracts/index.js";
+import type { OwnedUiExtensionOverlayHandle, OwnedUiExtensionOverlayOptions } from "../../../contracts/owned-ui/index.js";
 import { type PiShellComponentPort, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export interface PiExtensionUiBridgeHost {
     readonly runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">;

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-footer-status.d.ts

@@ -1,4 +1,4 @@
-import type { OwnedUiSessionViewModel } from "../owned-ui-contracts/index.js";
+import type { OwnedUiSessionViewModel } from "../../../contracts/owned-ui/index.js";
 import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellQueuedInputPort, type PiShellHeaderPort, type PiShellResourceEntry, type PiShellLoadedResourcesPort, type PiShellHeaderOptions, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-presenters-transcript.d.ts

@@ -1,5 +1,5 @@
 import { AssistantMessageComponent } from "@earendil-works/pi-coding-agent";
-import type { OwnedUiTranscriptBlock } from "../owned-ui-contracts/index.js";
+import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 import { type PiShellComponentPort, type PiShellExtensionRendererResolver, type PiShellTranscriptComponentPort } from "./shell-shared-facade.js";
 export interface PiShellSessionInfoPresentation {
     readonly sessionName?: string;

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-presenters-transcript.js

@@ -1,7 +1,7 @@
 import { AssistantMessageComponent, BashExecutionComponent, CompactionSummaryMessageComponent, CustomMessageComponent, DynamicBorder, getMarkdownTheme, parseSkillBlock, ToolExecutionComponent, UserMessageComponent, } from "@earendil-works/pi-coding-agent";
 import { SkillInvocationMessageComponent, } from "./upstream/components/skill-invocation-message.js";
 import { Container, Markdown, Spacer, Text, } from "#pi-tui";
-import { PRODUCT_TEXT } from "../../product-identity.js";
+import { PRODUCT_TEXT } from "../../../product-identity.js";
 import { KeybindingsManager, } from "./upstream/adjacent/core/keybindings.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { componentPort, createTuiFacade, ensureTheme, formatSessionTokens, isRecord, } from "./shell-shared-facade.js";

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-selectors-dialogs.d.ts

@@ -1,5 +1,5 @@
 import { ModelSelectorComponent, type SessionInfo, type SettingsCallbacks, type SettingsConfig } from "@earendil-works/pi-coding-agent";
-import type { OwnedUiDialog } from "../owned-ui-contracts/index.js";
+import type { OwnedUiDialog } from "../../../contracts/owned-ui/index.js";
 import { type TrustDecision, type TrustOption, type TrustUpdate } from "./upstream/components/trust-selector.js";
 import { type PiShellComponentPort, type PiShellEditorOptions, type PiShellSelectorOption, type PiShellSelectorOptions } from "./shell-shared-facade.js";
 export declare function createPiShellSelector(options: PiShellSelectorOptions): PiShellComponentPort;

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-shared-facade.d.ts

@@ -1,5 +1,5 @@
 import { type AutocompleteProvider, type Component, type TUI } from "#pi-tui";
-import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../owned-ui-contracts/index.js";
+import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 export interface PiShellComponentPort {
     render(width: number): readonly string[];
     handleInput?(data: string): void;

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/upstream/components/session-footer.d.ts

@@ -1,5 +1,5 @@
 import { type Component } from "#pi-tui";
-import type { OwnedUiSessionViewModel } from "../../../owned-ui-contracts/index.js";
+import type { OwnedUiSessionViewModel } from "../../../../../contracts/owned-ui/index.js";
 export declare class SessionFooter implements Component {
     private readonly getView;
     private readonly cwd;

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/adapter.d.ts

@@ -1,7 +1,7 @@
 import { type AgentSessionRuntime, type AgentSessionServices, type SessionInfo } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../owned-ui-contracts/index.js";
+import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../../../contracts/owned-ui/index.js";
 import { type PiAuthenticationProviderOption, type PiBashWorkflowResult, type PiPinnedSettingsCallback, type PiPinnedSettingsSnapshot, type PiWorkflowAutocompleteCommand, type PiWorkflowHost, type PiWorkflowInteractionHost, type PiWorkflowOption, type PiWorkflowRequest, type PiWorkflowResult } from "./workflows.js";
-import type { AgentSettingsPort } from "../agent-engine-contracts/index.js";
+import type { AgentSettingsPort } from "../../../contracts/agent-engine/index.js";
 export interface PiEngineRuntimeFactoryInput {
     readonly cwd: string;
     readonly agentDir: string;

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/adapter.js

@@ -3,9 +3,9 @@ import { mkdir, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { promisify } from "node:util";
-import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { PRODUCT_IDENTITY } from "../../../product-identity.js";
 import { copyToClipboard, DefaultPackageManager, getAgentDir, ProjectTrustStore, SessionManager, } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, assertOwnedUiCommand, assertOwnedUiExtensionUiPort, assertOwnedUiSnapshot, } from "../owned-ui-contracts/index.js";
+import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, assertOwnedUiCommand, assertOwnedUiExtensionUiPort, assertOwnedUiSnapshot, } from "../../../contracts/owned-ui/index.js";
 import { PINNED_PI_SETTINGS_CALLBACKS, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "./workflows.js";
 import { createPiRuntimeIntegration } from "./runtime-integration.js";
 import { PiSessionCommandIntegration } from "./session-integration.js";
@@ -17,6 +17,7 @@ const execFileAsync = promisify(execFile);
  * batch.
  */
 const EVENT_DELIVERY_BATCH = 16;
+const TOOL_UPDATE_COALESCE_MS = 50;
 const DEFAULT_SURFACE = {
     columns: 100,
     rows: 32,
@@ -64,6 +65,9 @@ export class PiEngineAdapter {
     #messageBlockIds = new WeakMap();
     #messageFallbackIds = new Map();
     #toolBlockIds = new Map();
+    #pendingToolUpdates = new Map();
+    #toolUpdateFlush = null;
+    #usageCache;
     #nextBlockSequence = 0;
     #diagnostics = [];
     #eventQueue = [];
@@ -162,6 +166,7 @@ export class PiEngineAdapter {
         return () => this.#listeners.delete(listener);
     }
     async flushEvents() {
+        this.#flushPendingToolUpdates();
         while (this.#eventQueueProcessing)
             await this.#eventQueueProcessing;
     }
@@ -742,7 +747,7 @@ export class PiEngineAdapter {
                 ...this.#status,
                 diagnostics: [...this.#status.diagnostics],
                 badges: [...this.#status.badges],
-                usage: this.#readUsage(),
+                usage: this.#usageCache ??= this.#readUsage(),
                 footer: {
                     branch: this.#gitBranch,
                     sessionName: this.#session?.sessionManager?.getSessionName() ?? null,
@@ -808,6 +813,11 @@ export class PiEngineAdapter {
         if (this.#disposed)
             return;
         this.#disposed = true;
+        if (this.#toolUpdateFlush !== null) {
+            clearTimeout(this.#toolUpdateFlush);
+            this.#toolUpdateFlush = null;
+        }
+        this.#pendingToolUpdates.clear();
         this.#extensionBound = false;
         this.#extensionUi = undefined;
         this.#extensionShutdown = undefined;
@@ -1467,6 +1477,10 @@ export class PiEngineAdapter {
     #handlePiEvent(event) {
         if (!isRecord(event) || typeof event.type !== "string")
             return;
+        // Usage moves at message and lifecycle boundaries, not with stream chunks, so the
+        // two streaming event kinds keep the memo and everything else drops it.
+        if (event.type !== "message_update" && event.type !== "tool_execution_update")
+            this.#usageCache = undefined;
         switch (event.type) {
             case "agent_start":
                 this.#agentRunActive = true;
@@ -1500,10 +1514,17 @@ export class PiEngineAdapter {
                 }
                 return;
             case "tool_execution_start":
-            case "tool_execution_update":
-            case "tool_execution_end":
+            case "tool_execution_end": {
+                // The end supersedes any update still waiting on the coalescing timer.
+                const toolCallId = stringValue(event.toolCallId);
+                if (toolCallId !== undefined)
+                    this.#pendingToolUpdates.delete(toolCallId);
                 this.#upsertToolExecutionBlock(event);
                 return;
+            }
+            case "tool_execution_update":
+                this.#coalesceToolExecutionUpdate(event);
+                return;
             case "agent_settled":
             case "agent_end": {
                 if (event.type === "agent_end" && event.willRetry === true)
@@ -1795,6 +1816,35 @@ export class PiEngineAdapter {
         }
         return blocks;
     }
+    /**
+     * A busy tool streams far more output chunks than a terminal frame can show, and every
+     * chunk restates the whole accumulated output. Keeping only the newest chunk per tool
+     * and applying it on a short timer bounds the per-command work by frames rather than
+     * by chunks, which is what keeps typed input and the spinner alive under the stream.
+     */
+    #coalesceToolExecutionUpdate(event) {
+        const toolCallId = stringValue(event.toolCallId);
+        if (!toolCallId)
+            return;
+        this.#pendingToolUpdates.set(toolCallId, event);
+        this.#toolUpdateFlush ??= setTimeout(() => {
+            this.#toolUpdateFlush = null;
+            if (!this.#disposed)
+                this.#flushPendingToolUpdates();
+        }, TOOL_UPDATE_COALESCE_MS);
+    }
+    #flushPendingToolUpdates() {
+        if (this.#toolUpdateFlush !== null) {
+            clearTimeout(this.#toolUpdateFlush);
+            this.#toolUpdateFlush = null;
+        }
+        if (this.#pendingToolUpdates.size === 0)
+            return;
+        const pending = [...this.#pendingToolUpdates.values()];
+        this.#pendingToolUpdates.clear();
+        for (const update of pending)
+            this.#upsertToolExecutionBlock(update);
+    }
     #upsertToolExecutionBlock(event) {
         const toolCallId = stringValue(event.toolCallId);
         if (!toolCallId)
@@ -1814,7 +1864,9 @@ export class PiEngineAdapter {
                 toolCallId,
                 toolName: stringValue(event.toolName) ?? "unknown",
                 arguments: jsonSummary(event.args),
-                result: jsonSummary(source),
+                // A partial result repeats the whole accumulated output on every chunk;
+                // summarizing it each time would cost quadratic work over the stream.
+                result: ended ? jsonSummary(source) : { summary: "", json: null },
                 partialResult: event.type === "tool_execution_update",
                 argsComplete: ended,
                 isError: event.isError === true,
@@ -1897,6 +1949,7 @@ export class PiEngineAdapter {
         this.#emitEvent({ type: "diagnostic", diagnostic });
     }
     #emitView() {
+        this.#usageCache = undefined;
         this.#viewRevision += 1;
         this.#emitEvent({ type: "session-view", view: this.view() });
     }

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/conformance.js

@@ -2,8 +2,8 @@ import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, ModelRuntime, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_CONTRACT_VERSION } from "../owned-ui-contracts/index.js";
-import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { OWNED_UI_CONTRACT_VERSION } from "../../../contracts/owned-ui/index.js";
+import { PRODUCT_IDENTITY } from "../../../product-identity.js";
 export const REQUIRED_PI_CAPABILITY_OPERATIONS = Object.freeze({
     "public-exports": ["services.create", "session.create", "runtime.create"],
     "session-lifecycle": ["session.new", "session.resume", "session.rebind", "session.dispose"],

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/model-auth-integration.d.ts

@@ -1,5 +1,5 @@
 import type { ModelRuntime } from "@earendil-works/pi-coding-agent";
-import type { AgentAuthenticationPort, AgentModelDescriptor, AgentModelPort } from "../agent-engine-contracts/index.js";
+import type { AgentAuthenticationPort, AgentModelDescriptor, AgentModelPort } from "../../../contracts/agent-engine/index.js";
 export type PiDocumentedModelRuntime = Pick<ModelRuntime, "getAvailableSnapshot" | "getModel" | "getProvider" | "hasConfiguredAuth" | "refresh" | "logout">;
 export interface PiModelAuthenticationOptions {
     readonly runtime: PiDocumentedModelRuntime;

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/package-integration.d.ts

@@ -1,4 +1,4 @@
-import { type AgentPackagesPort, type AgentPackagesPortInput } from "../agent-engine-contracts/index.js";
+import { type AgentPackagesPort, type AgentPackagesPortInput } from "../../../contracts/agent-engine/index.js";
 /**
  * Pinned Pi's package manager already takes the profile root as an argument, so
  * this binds it to the root A1 chose rather than to whatever the configuration-root

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/package-integration.js

@@ -1,6 +1,6 @@
 import { join } from "node:path";
 import { DefaultPackageManager, ModelRuntime, SettingsManager } from "@earendil-works/pi-coding-agent";
-import { agentPackageOutcome, } from "../agent-engine-contracts/index.js";
+import { agentPackageOutcome, } from "../../../contracts/agent-engine/index.js";
 const MODEL_REFRESH_TIMEOUT_MS = 15_000;
 /**
  * Pinned Pi's package manager already takes the profile root as an argument, so

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/resource-extension-integration.d.ts

@@ -1,5 +1,5 @@
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
-import type { AgentExtensionBinding, AgentExtensionFailure, AgentExtensionPort, AgentResourceDescriptor, AgentResourcesPort, AgentSessionMetadata } from "../agent-engine-contracts/index.js";
+import type { AgentExtensionBinding, AgentExtensionFailure, AgentExtensionPort, AgentResourceDescriptor, AgentResourcesPort, AgentSessionMetadata } from "../../../contracts/agent-engine/index.js";
 export interface PiResourceExtensionOptions {
     readonly session: AgentSession;
     readonly bindUi: () => Promise<void>;

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/session-integration.d.ts

@@ -1,5 +1,5 @@
 import type { AgentSession, AgentSessionEvent } from "@earendil-works/pi-coding-agent";
-import { type AgentCommandOutcome, type AgentEvent } from "../agent-engine-contracts/index.js";
+import { type AgentCommandOutcome, type AgentEvent } from "../../../contracts/agent-engine/index.js";
 export interface PiDocumentedSessionCommands {
     readonly isStreaming: AgentSession["isStreaming"];
     readonly isRetrying: AgentSession["isRetrying"];

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/session-integration.js

@@ -1,4 +1,4 @@
-import { AGENT_ENGINE_CONTRACT_VERSION, } from "../agent-engine-contracts/index.js";
+import { AGENT_ENGINE_CONTRACT_VERSION, } from "../../../contracts/agent-engine/index.js";
 export class PiSessionCommandIntegration {
     session;
     #lastPrompt = null;

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/settings-integration.d.ts

@@ -1,5 +1,5 @@
 import type { SettingsManager } from "@earendil-works/pi-coding-agent";
-import type { AgentJsonValue, AgentSettingDescriptor, AgentSettingsPort } from "../agent-engine-contracts/index.js";
+import type { AgentJsonValue, AgentSettingDescriptor, AgentSettingsPort } from "../../../contracts/agent-engine/index.js";
 /**
  * Values only the running engine knows: the themes installed on this machine and
  * the thinking levels this session supports. The boundary asks for them as it is

package/dist/{src/foundation/pi-engine-adapter → integrations/pi/engine}/workflow-controllers.d.ts

@@ -1,4 +1,4 @@
-import type { AgentJsonValue, AgentWorkflowDescriptor, AgentWorkflowPort } from "../agent-engine-contracts/index.js";
+import type { AgentJsonValue, AgentWorkflowDescriptor, AgentWorkflowPort } from "../../../contracts/agent-engine/index.js";
 import { type PiWorkflowRoute } from "./workflows.js";
 export type WorkflowCapability = "prompt" | "abort" | "compact" | "bash" | "models.read" | "models.write" | "auth.login" | "auth.logout" | "settings.read" | "settings.write" | "resources.read" | "resources.reload" | "session.read" | "session.new" | "session.resume" | "session.fork" | "session.tree" | "session.import" | "clipboard.write" | "export.write" | "share.write" | "process.quit" | "diagnostics.read";
 export interface WorkflowControllerResult {

package/dist/{src/foundation/pi-owned-ui-integration → integrations/pi/owned-ui}/route-host.d.ts

@@ -1,4 +1,4 @@
-import type { PaneMouseEvent } from "../ui-components/index.js";
+import type { PaneMouseEvent } from "../../../ui/components/index.js";
 /**
  * The seam between the pinned shell and A1-owned screens. The shell asks whether
  * a route is claimed, mounts whatever surface it is handed, and forwards keys to

package/dist/{src/foundation/pi-owned-ui-integration/session-shell.d.ts → integrations/pi/owned-ui/session-shell-root.d.ts}

@@ -1,10 +1,10 @@
-import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel } from "../owned-ui-contracts/index.js";
+import type { OwnedUiSessionViewModel } from "../../../contracts/owned-ui/index.js";
 import type { UiRouteHost } from "./route-host.js";
-import { type AdapterCommandResult, type PiEngineAdapter, type PiWorkflowRequest, type PiWorkflowResult } from "../pi-engine-adapter/index.js";
-import { type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellLoadedResourcesPort, type PiShellSelectorOption, type PiShellTranscriptComponentPort } from "../pi-component-adapter/index.js";
-import { PiTuiRuntimeAdapter, type PiTuiComponentPort, type PiTuiLayoutNode, type PiTuiOverlayHandle, type PiTuiTerminalPort } from "../pi-tui-runtime-adapter/index.js";
-type OwnedUiBackendPort = PiEngineAdapter;
-type OwnedUiTerminalPort = PiTuiTerminalPort;
+import { type PiEngineAdapter, type PiWorkflowResult } from "../engine/index.js";
+import { type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../components/index.js";
+import { type PiTuiComponentPort, type PiTuiLayoutNode, type PiTuiTerminalPort } from "../tui-runtime/index.js";
+export type OwnedUiBackendPort = PiEngineAdapter;
+export type OwnedUiTerminalPort = PiTuiTerminalPort;
 type OwnedUiStartupOptions = PiShellHeaderOptions;
 export interface OwnedUiSessionShellOptions {
     readonly backend: OwnedUiBackendPort;
@@ -69,44 +69,5 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     setFocused(focused: boolean): void;
     dispose(): void;
 }
-export declare class OwnedUiSessionShell {
-    #private;
-    readonly backend: OwnedUiBackendPort;
-    readonly root: OwnedUiSessionShellRoot;
-    readonly runtime: PiTuiRuntimeAdapter;
-    constructor(options: OwnedUiSessionShellOptions);
-    view(): OwnedUiSessionViewModel;
-    start(): void;
-    onView(listener: (view: OwnedUiSessionViewModel) => void): () => void;
-    waitUntilStopped(): Promise<void>;
-    submit(text: string): Promise<AdapterCommandResult>;
-    clearOrExit(now?: number): Promise<AdapterCommandResult>;
-    interrupt(): Promise<AdapterCommandResult>;
-    abort(): Promise<AdapterCommandResult>;
-    retry(): Promise<AdapterCommandResult>;
-    compact(): Promise<AdapterCommandResult>;
-    newSession(): Promise<AdapterCommandResult>;
-    resumeSession(sessionPath: string): Promise<AdapterCommandResult>;
-    setModel(providerId: string, modelId: string): Promise<AdapterCommandResult>;
-    setThinkingLevel(thinkingLevel: OwnedUiThinkingLevel): Promise<AdapterCommandResult>;
-    cycleThinkingLevel(): Promise<AdapterCommandResult>;
-    cycleModel(direction: "forward" | "backward"): Promise<AdapterCommandResult>;
-    queueFollowUp(): Promise<AdapterCommandResult>;
-    restoreQueuedInput(): void;
-    showSelector(title: string, options: readonly PiShellSelectorOption[], onSelect: (id: string) => void, onCancel?: () => void): PiTuiOverlayHandle;
-    showModelSelector(): void;
-    showForkSelector(): void;
-    showLogoutSelector(): Promise<void>;
-    showLoginMethodSelector(providerReference: string): void;
-    showTreeSelector(initialSelectedId?: string): void;
-    showLoginAuthTypeSelector(): void;
-    showLoginProviderSelector(authType: "oauth" | "api_key"): void;
-    showSessionSelector(): void;
-    showSettingsSelector(): void;
-    shutdown(): Promise<AdapterCommandResult>;
-    runWorkflow(request: PiWorkflowRequest): Promise<AdapterCommandResult>;
-    showTrustSelector(): void;
-    showScopedModelsSelector(): void;
-    dispose(): Promise<void>;
-}
+export declare function shellResourceEntries(backend: OwnedUiBackendPort): readonly PiShellResourceEntry[];
 export {};