@orion-agents/orion-code 0.3.2 → 0.3.7

package/dist/web/workbench-controller.d.ts

@@ -5,28 +5,43 @@ import { WebEventHub } from './event-hub';
 import { FileReadServiceV1 } from './file-read-service';
 import { GitReadModelServiceV1 } from './git-read-model-service';
 import { type WebComposerActionResultV1, type WebComposerActionV1, type WebComposerControlStateV1, type WebBootstrapV1, type WebCommandResultV1, type WebContextActivateRequestV1, type WebContextGuardV1, type WebMcpServerSummaryV1, type WebPageV1, type WebSessionSnapshotV1, type WebSessionSummaryV1, type WebSettingsMutationResultV1, type WebSettingsSnapshotV1, type WebSettingsUpdateRequestV1, type WebSkillSummaryV1, type WebToolDetailPageV1, type WebToolDetailSummaryV1, type WebWorkspaceSummaryV1, type WebWorkspaceProjectSummaryV1 } from './protocol';
+import { type WebSessionRuntimeSummaryV1 } from './session-runtime-registry';
 import { TerminalManagerV1 } from './terminal-manager';
 export { WebWorkbenchError } from './errors';
 export interface WebWorkbenchControllerOptions {
     readonly cwd: string;
     readonly eventHub?: WebEventHub;
     readonly createRuntime?: (cwd: string) => Promise<OrionCodeUiRuntime>;
+    readonly createSessionRuntime?: (cwd: string) => Promise<OrionCodeUiRuntime>;
     readonly workspaceRegistry?: WorkspaceRegistryV1;
 }
-/** Owns the sole runtime/controller pair exposed through the local Web host. */
+/** Owns the Workspace surface plus the bounded Web Session actor registry. */
 export declare class WebWorkbenchController {
     readonly eventHub: WebEventHub;
     private workspaceValue;
     private runtimeValue;
     private controllerValue;
     private activeOrionRuntime?;
+    private readonly activeOrionRuntimes;
     private readonly createRuntime;
+    private readonly createSessionRuntime;
+    private sessionRegistry;
+    /**
+     * Workspace-scoped shared kernels owned by this Host. Control planes and
+     * Session actors both borrow from this pool, so a Workspace Context switch
+     * never tears down kernels that resident actors still reference. The pool is
+     * released only during Host shutdown.
+     */
+    private readonly workspaceKernels;
     private readonly workspaceRegistry;
     readonly terminalManager: TerminalManagerV1;
     private readonly mutationResults;
     private readonly sessionViews;
     private sessionViewBytes;
     private readonly toolDetails;
+    private readonly workspaceMutations;
+    private readonly workspaceMutationOwners;
+    private readonly pendingWorkspaceMutationStates;
     private fileService;
     private gitService;
     private reviewService;
@@ -40,8 +55,17 @@ export declare class WebWorkbenchController {
     private suppressContextEdges;
     private latestStatus;
     private transition;
-    private sessionTransition;
+    private activeMutationCount;
+    private contextTransitionReserved;
     private closed;
+    private shutdownResult?;
+    /**
+     * Host-observed Web activity counters. Exposed through diagnostics() so E2E
+     * and the diagnostics panel can prove that a pure Session selection issues
+     * no control-plane reinstall (controlPlaneInstalls delta 0) and that
+     * snapshots stay bounded and fast (snapshotTotalMs / snapshotLastMs).
+     */
+    private readonly sessionActivity;
     private workspaceWatchers;
     private resourceInvalidationTimer?;
     private constructor();
@@ -54,13 +78,19 @@ export declare class WebWorkbenchController {
     settings(): WebSettingsSnapshotV1;
     listWorkspaces(context?: WebContextGuardV1): readonly WebWorkspaceSummaryV1[];
     listWorkspaceSessions(workspaceId: string, context?: WebContextGuardV1): readonly WebSessionSummaryV1[];
+    /** Archived sessions of a Workspace (v0.3.7), newest archive first. */
+    listArchivedWorkspaceSessions(workspaceId: string, context?: WebContextGuardV1): readonly WebSessionSummaryV1[];
     workspaceProjectSummary(workspaceId: string, context?: WebContextGuardV1): Promise<WebWorkspaceProjectSummaryV1>;
     setWorkspacePinned(workspaceId: string, pinned: boolean, context: WebContextGuardV1): WebWorkspaceSummaryV1;
     removeWorkspace(workspaceId: string, context: WebContextGuardV1): void;
     listSessions(context?: WebContextGuardV1): readonly WebSessionSummaryV1[];
     sessionSnapshot(sessionId: string, cursor?: string, pageSize?: number, tail?: boolean, context?: WebContextGuardV1): WebSessionSnapshotV1;
+    private snapshotSessionV1;
+    private recordSessionSnapshotActivity;
     composerState(sessionId: string, context?: WebContextGuardV1): WebComposerControlStateV1;
-    private projectComposerState;
+    sessionRuntimeSummary(sessionId: string): WebSessionRuntimeSummaryV1;
+    waitForSessionIdle(sessionId: string): Promise<void>;
+    private projectActorComposerState;
     private projectComposerStateValue;
     modelCatalog(sessionId: string, context?: WebContextGuardV1): import("../runtime/session-composer-control").SessionModelCatalogV1;
     applyComposerAction(input: WebComposerActionV1): Promise<WebComposerActionResultV1>;
@@ -78,6 +108,22 @@ export declare class WebWorkbenchController {
     createSession(name?: string, context?: WebContextGuardV1): Promise<WebSessionSummaryV1>;
     activateSession(sessionId: string, context?: WebContextGuardV1): Promise<WebCommandResultV1>;
     renameSession(sessionId: string, name: string, context?: WebContextGuardV1): WebSessionSummaryV1;
+    setSessionTags(sessionId: string, tags: unknown, context?: WebContextGuardV1): WebSessionSummaryV1;
+    archiveSession(sessionId: string, context?: WebContextGuardV1): WebSessionSummaryV1;
+    restoreSession(sessionId: string, context?: WebContextGuardV1): WebSessionSummaryV1;
+    deleteSession(sessionId: string, context?: WebContextGuardV1): {
+        readonly deleted: boolean;
+    };
+    /**
+     * A busy Session (starting / queued / running / waiting approval / stopping)
+     * must not be archived or deleted while its actor is doing work.
+     */
+    private assertSessionNotBusy;
+    /**
+     * Deletion removes files under the Session while a resident actor may still
+     * hold them open — require that no actor exists at all (phase 'cold').
+     */
+    private assertSessionHasNoActor;
     switchWorkspace(path: string, context: WebContextGuardV1): Promise<void>;
     activateContext(input: Omit<WebContextActivateRequestV1, 'requestId'>): Promise<void>;
     dispatch(raw: unknown): Promise<WebCommandResultV1>;
@@ -89,6 +135,35 @@ export declare class WebWorkbenchController {
     executeMutation<T>(requestId: string, operation: string, payload: unknown, action: () => T | Promise<T>): Promise<T>;
     diagnostics(context?: WebContextGuardV1): Promise<Record<string, unknown>>;
     shutdown(): Promise<void>;
+    private shutdownOwnedResources;
+    /**
+     * Return the workspace kernel for `cwd`, creating and pooling one on first
+     * use. Control planes and Session actors borrow the same kernel instance per
+     * canonical Workspace; the pool is released only when the Host shuts down.
+     */
+    private workspaceKernelFor;
+    /**
+     * Settings invalidations from pooled kernels are only forwarded while their
+     * Workspace is the active Context. A background Workspace's coordinator
+     * keeps watching its own durable file; its next activation publishes a fresh
+     * Settings document through `emitSettingsWorkspaceChange()`.
+     */
+    private onWorkspaceKernelSettingsInvalidated;
+    /**
+     * Release the Host owner seat on every pooled kernel. Runtime shutdowns have
+     * already disposed their Settings participants (actors first, then the
+     * active control plane), so an unowned kernel with zero participants closes
+     * its Settings coordinator here. A kernel that still has a running actor
+     * participant survives until that actor actually terminates.
+     */
+    private releaseWorkspaceKernels;
+    private createSessionRegistry;
+    private createSessionActor;
+    private closeSessionActor;
+    private emitSessionActorRuntimeEvent;
+    private emitWorkspaceMutationState;
+    private scheduleActorComposerStateChanged;
+    private publishActorComposerState;
     private installRuntime;
     private emitState;
     private emitWorkspaceResourceInvalidation;
@@ -105,8 +180,12 @@ export declare class WebWorkbenchController {
     private rememberSessionView;
     private assertReadyForTransition;
     private assertMutationAdmission;
+    private reserveMutation;
+    private releaseMutation;
     private assertContextGuard;
     private assertCommandSession;
+    private assertSessionWorkspace;
+    private sessionActorKey;
     private assertSettingsAvailable;
     private initializeWorkspaceRegistry;
     private activeWorkspaceEntry;