@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/schemas/hubChannel.d.mts

@@ -1,18 +1,20 @@
-import { DoomBackgroundWorkSnapshot } from "./backgroundWork.mjs";
+import { PoBackgroundWorkSnapshot } from "./backgroundWork.mjs";
+import { PoSessionStorageService } from "./platform.mjs";
+import { HomeProjection } from "./home.mjs";
 //#region src/schemas/hubChannel.d.ts
-export interface DoomHubChannelFrame {
+export interface PoHubChannelFrame {
   type: string;
   sessionId: string;
   payload: unknown;
 }
 /** Same-process lifecycle bus shared by a host's session APIs and hub channels. */
-export interface DoomDirectEventSubscriptionOptions {
+export interface PoDirectEventSubscriptionOptions {
   /** Replay the most recent value published for this frame and session, when one exists. */
   readonly replayLatest?: boolean;
 }
-export interface DoomDirectEventBus {
+export interface PoDirectEventBus {
   publish(frameType: string, sessionId: string, payload: unknown): void;
-  subscribe(frameType: string, sessionId: string, listener: (payload: unknown) => void, options?: DoomDirectEventSubscriptionOptions): () => void;
+  subscribe(frameType: string, sessionId: string, listener: (payload: unknown) => void, options?: PoDirectEventSubscriptionOptions): () => void;
   /** Drop retained state for a session after its lifecycle ends. */
   clearSession?(sessionId: string): void;
   close(): void;
@@ -21,7 +23,7 @@ export interface DoomDirectEventBus {
  * The extension-agnostic baseline every surface gets for one session, computed once by the
  * session host. Extensions build on it instead of re-deriving roots and relations from cwd.
  */
-export interface DoomSessionContext {
+export interface PoSessionContext {
   readonly sessionId: string;
   /** Persisted workspace id, shared by every session and member checkout of the workspace. */
   readonly workspaceId: string;
@@ -37,23 +39,23 @@ export interface DoomSessionContext {
   /** The spawner's label for the session. Opaque: hosts never interpret it. */
   readonly provenance?: string;
 }
-export interface DoomHubSessionScope {
+export interface PoHubSessionScope {
   sessionId: string;
   workspaceId?: string;
   cwd: string;
   /** Environment admitted for this session, when supplied by the host. */
   environment?: Readonly<Record<string, string | undefined>>;
   /** The session's baseline context, when its host knows its workspace. */
-  sessionContext?: DoomSessionContext;
+  sessionContext?: PoSessionContext;
 }
-export interface DoomHubReservedWorktreeRequest {
+export interface PoHubReservedWorktreeRequest {
   readonly reservationId: string;
   readonly parentSessionId: string;
   readonly signal?: AbortSignal;
 }
-export type DoomHubReservedWorktreeProvisioner = (request: DoomHubReservedWorktreeRequest) => Promise<DoomHubSessionScope>;
+export type PoHubReservedWorktreeProvisioner = (request: PoHubReservedWorktreeRequest) => Promise<PoHubSessionScope>;
 /** Selection axes a caller pins for a new session instead of the workspace defaults. */
-export interface DoomHubSessionSelection {
+export interface PoHubSessionSelection {
   readonly majorMode?: string;
   readonly minorModes?: readonly string[];
   readonly profile?: string;
@@ -74,7 +76,9 @@ export declare const WORKFLOW_STEP_SESSION_PROVENANCE = "workflow";
  * parent. Like a detached helper, it takes no row in the session rail.
  */
 export declare const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = "workflow-dispatcher";
-export interface DoomHubSessionCreateRequest {
+/** Provenance of a conversation an external MCP client opened and drives. */
+export declare const REMOTE_CONVERSATION_SESSION_PROVENANCE = "remote-conversation";
+export interface PoHubSessionCreateRequest {
   readonly cwd: string;
   readonly name: string;
   readonly parentSessionId?: string;
@@ -83,7 +87,7 @@ export interface DoomHubSessionCreateRequest {
   /** Host-issued reservation, not a caller-chosen target session id. */
   readonly reservationId?: string;
   /** Pinned axes stay put when the workspace defaults change between turns. */
-  readonly selection?: DoomHubSessionSelection;
+  readonly selection?: PoHubSessionSelection;
   /** Pi model selector, `provider/id`, validated like `--model`. */
   readonly model?: string;
   /** Pi thinking level, validated like `--thinking`. */
@@ -95,24 +99,36 @@ export interface DoomHubSessionCreateRequest {
   /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */
   readonly tools?: readonly string[];
 }
-export interface DoomHubSessionPromptOptions {
+export interface PoHubSessionPromptOptions {
   readonly signal?: AbortSignal;
   /** Refuses the prompt unless the target is a direct child of this session. */
   readonly parentSessionId?: string;
 }
 /** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */
-export interface DoomHubSessionPromptReceipt {
+export interface PoHubSessionPromptReceipt {
   readonly settled: Promise<void>;
 }
 /** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */
-export interface DoomSessionCommunicationEndpoint {
+export interface PoSessionCommunicationEndpoint {
   readonly sessionId: string;
+  /** Current human-readable session name, read live so renames are reflected. */
+  readonly sessionName?: string;
   publish(targetSessionId: string, type: string, payload: unknown): boolean;
   subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;
   onPeerReady(listener: (peerSessionId: string) => void): () => void;
+  /** Describes a live peer authorized to communicate, including same-checkout peers. */
+  describePeer?(peerSessionId: string): PoSessionPeerDescription | undefined;
   close(): void;
 }
-export interface DoomPendingSessionSetup {
+/** How a session sees a peer it may message, so an agent can address it by the name a person uses. */
+export interface PoSessionPeerDescription {
+  readonly sessionId: string;
+  readonly name: string;
+  readonly profile?: string;
+  /** Groups both sessions belong to; empty when related through parentage or checkout. */
+  readonly sharedGroups: readonly string[];
+}
+export interface PoPendingSessionSetup {
   readonly id: string;
   readonly name: string;
   readonly createdAt: string;
@@ -126,7 +142,7 @@ export interface DoomPendingSessionSetup {
  * session, such as a background job. The host shows it on the session's rail
  * card but never interprets it.
  */
-export interface DoomSessionActivity {
+export interface PoSessionActivity {
   readonly label: string;
   /** The work needs the reader: the rail marks the card the way it marks a pending question. */
   readonly attention?: boolean;
@@ -134,7 +150,7 @@ export interface DoomSessionActivity {
   readonly since?: string;
 }
 /** A host-owned setup can be fulfilled by any execution-directory provider. */
-export interface DoomHubSessionReservations {
+export interface PoHubSessionReservations {
   read(id: string, parentSessionId: string): {
     sessionId: string;
     cwd?: string;
@@ -143,47 +159,50 @@ export interface DoomHubSessionReservations {
     sessionId: string;
     cwd: string;
   }>;
-  complete(id: string, parentSessionId: string): Promise<DoomHubSessionScope>;
+  complete(id: string, parentSessionId: string): Promise<PoHubSessionScope>;
 }
 /** Authoritative execution state. Missing background coordination is unknown, not empty. */
-export interface DoomHubSessionExecutionState {
+export interface PoHubSessionExecutionState {
   readonly isIdle: boolean;
   readonly hasPendingMessages: boolean;
-  readonly backgroundWork?: DoomBackgroundWorkSnapshot;
+  readonly backgroundWork?: PoBackgroundWorkSnapshot;
 }
 /** Direct lifecycle owned by the canonical headless hub, never by a package transport. */
-export interface DoomHubSessionService {
-  create(request: DoomHubSessionCreateRequest): Promise<DoomHubSessionScope>;
+export interface PoHubSessionService {
+  create(request: PoHubSessionCreateRequest): Promise<PoHubSessionScope>;
   close(sessionId: string): Promise<void>;
   isLive(sessionId: string): boolean;
   /** Reads a live child's ownership without starting a turn. */
-  readExecutionState?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<DoomHubSessionExecutionState>;
+  readExecutionState?(sessionId: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<PoHubSessionExecutionState>;
   /** Starts a turn in a live session, as if its user had submitted `text`. */
-  prompt?(sessionId: string, text: string, options?: DoomHubSessionPromptOptions): Promise<DoomHubSessionPromptReceipt>;
+  prompt?(sessionId: string, text: string, options?: PoHubSessionPromptOptions): Promise<PoHubSessionPromptReceipt>;
   /** Aborts the live session's current turn. The session stays open. */
-  abort?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
+  abort?(sessionId: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
   /**
    * Adds guidance to a live session's running turn. A session with no turn in
    * progress takes it as its next message instead.
    */
-  steer?(sessionId: string, message: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
+  steer?(sessionId: string, message: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
   /**
    * Stops a live session's runtime and keeps it dormant: its history stays
    * readable where it is shown, and it can be woken later. A session that has
    * done its work no longer holds a model, tools and extensions in the host.
    */
-  release?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
-  readonly reservations?: DoomHubSessionReservations;
+  release?(sessionId: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;
+  readonly reservations?: PoHubSessionReservations;
   /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */
-  provisionReservedWorktree?(request: DoomHubReservedWorktreeRequest): Promise<DoomHubSessionScope>;
+  provisionReservedWorktree?(request: PoHubReservedWorktreeRequest): Promise<PoHubSessionScope>;
   /** Core host hook. A Git provider registers its implementation while its channel is mounted. */
-  registerReservedWorktreeProvisioner?(provisioner: DoomHubReservedWorktreeProvisioner): () => void;
-  /** True only when both live sessions have a direct parent-child relationship. */
+  registerReservedWorktreeProvisioner?(provisioner: PoHubReservedWorktreeProvisioner): () => void;
+  /**
+   * True when both live sessions have a direct parent-child relationship, or execute in the same
+   * checkout. Remote conversations only qualify through the parent-child relationship.
+   */
   canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;
   /** Core host hook. Session API construction removes this method before exposing the service to extensions. */
-  bindCommunication?(sessionId: string): DoomSessionCommunicationEndpoint;
+  bindCommunication?(sessionId: string): PoSessionCommunicationEndpoint;
 }
-export interface DoomHubSessionApiRequest {
+export interface PoHubSessionApiRequest {
   basePath: string;
   path: string;
   method: string;
@@ -192,17 +211,17 @@ export interface DoomHubSessionApiRequest {
   /** Forwarded by the authenticated host, including content type and trace context. */
   headers?: RequestInit['headers'];
 }
-export type DoomComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';
-export interface DoomComputerUseHostRequest {
-  readonly operation: DoomComputerUseHostOperation;
+export type PoComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';
+export interface PoComputerUseHostRequest {
+  readonly operation: PoComputerUseHostOperation;
   readonly payload?: unknown;
   readonly signal?: AbortSignal;
 }
-export interface DoomComputerUseHostBinding {
+export interface PoComputerUseHostBinding {
   readonly available: boolean;
   /** Global opt-in, separate from the presence of a native host. */
   readonly enabled?: boolean;
-  request(scope: DoomHubSessionScope, request: DoomComputerUseHostRequest): Promise<unknown>;
+  request(scope: PoHubSessionScope, request: PoComputerUseHostRequest): Promise<unknown>;
   /** Checks a proof injected by the owning Desktop process, never a renderer marker. */
   authorize?(headers: Headers): boolean;
   /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */
@@ -215,13 +234,14 @@ export interface DoomComputerUseHostBinding {
   /** Own pending activation only, never general session control. */
   authorizePending?(sessionId: string, headers: Headers): boolean;
   revokeDevice?(deviceId: string): void;
-  readRecording?(scope: DoomHubSessionScope, artifactId: string, range: string): Promise<Response>;
+  readRecording?(scope: PoHubSessionScope, artifactId: string, range: string): Promise<Response>;
   forgetSession?(sessionId: string): void;
+  /** Without `sessionId` the listener hears every session's ownership change. */
   subscribe?(listener: () => void, sessionId?: string): () => void;
   close?(): void;
 }
 /** Narrow, host-bound access. An extension cannot select another session's identity. */
-export interface DoomComputerUseSessionAccess {
+export interface PoComputerUseSessionAccess {
   readonly available: boolean;
   readonly enabled?: boolean;
   authorize(headers: Headers): boolean;
@@ -232,40 +252,44 @@ export interface DoomComputerUseSessionAccess {
   fetchRecording?(artifactId: string, range: string): Promise<Response>;
   subscribe(listener: () => void): () => void;
 }
-export interface DoomHubChannelConnection {
+export interface PoHubChannelConnection {
   connectionId: string;
   /** Host-verified native renderer proof, never copied from a channel payload. */
   desktopAuthorized?: boolean;
   /** Live session authorization evaluated by the host, never a client frame. */
   computerUseAuthorized?: boolean;
 }
-export interface DoomHubChannelHost {
-  sessions(): readonly DoomHubSessionScope[];
+export interface PoHubChannelHost {
+  sessions(): readonly PoHubSessionScope[];
+  /** Host facts and storage for trusted in-process channels, never client-supplied roots. */
+  readonly homeDirectory?: string;
+  readonly sessionStorage?: PoSessionStorageService;
   /** Canonical hub lifecycle for sessions created by channel commands. */
-  sessionService?: DoomHubSessionService;
-  /** Same-process events emitted by session facets. */
-  readonly directEvents: DoomDirectEventBus;
+  sessionService?: PoHubSessionService;
+  /** Same-process events emitted by session packages. */
+  readonly directEvents: PoDirectEventBus;
   publish(sessionId: string, payload: unknown): void;
   publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;
-  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;
-  computerUse?: DoomComputerUseHostBinding;
+  requestSessionApi(scope: PoHubSessionScope, request: PoHubSessionApiRequest): Promise<Response>;
+  computerUse?: PoComputerUseHostBinding;
   onNotice(message: string): void;
 }
-export interface DoomHubChannelSource {
-  payloadFor(scope: DoomHubSessionScope): unknown;
-  sessionAdded?(scope: DoomHubSessionScope): void;
+export interface PoHubChannelSource {
+  payloadFor(scope: PoHubSessionScope): unknown;
+  /** Read-only compact projection of already-owned state. Must not start work or add watchers. */
+  homeFor?(scope: PoHubSessionScope): HomeProjection;
+  sessionAdded?(scope: PoHubSessionScope): void;
   sessionRemoved?(sessionId: string): void;
-  threadJournal?(scope: DoomHubSessionScope, threadId: string): string | undefined;
   close(): void;
 }
-export type DoomHubChannelLifecycle = 'session' | 'hub';
-export interface DoomHubChannel {
+export type PoHubChannelLifecycle = 'session' | 'hub';
+export interface PoHubChannel {
   frameType: string;
-  lifecycle?: DoomHubChannelLifecycle;
-  start(host: DoomHubChannelHost): DoomHubChannelSource;
+  lifecycle?: PoHubChannelLifecycle;
+  start(host: PoHubChannelHost): PoHubChannelSource;
   receiveWithoutSubscription?: boolean;
-  receive?(scope: DoomHubSessionScope, payload: unknown, connection: DoomHubChannelConnection): void;
-  disconnected?(connection: DoomHubChannelConnection): void;
+  receive?(scope: PoHubSessionScope, payload: unknown, connection: PoHubChannelConnection): void;
+  disconnected?(connection: PoHubChannelConnection): void;
 }
 //#endregion
 //# sourceMappingURL=hubChannel.d.mts.map

package/dist/src/schemas/hubChannel.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"hubChannel.d.mts","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"mappings":";;iBAEiB;EACf;EACA;EACA;;;iBAIe;;WAEN;;iBAGM;EACf,QAAQ,mBAAmB,mBAAmB;EAC9C,UACE,mBACA,mBACA,WAAW,2BACX,UAAU;;EAGZ,cAAc;EACd;;;;;;iBAOe;WACN;;WAEA;;WAEA;;;;;WAKA;WACA;WACA;;WAEA;;iBAGM;EACf;EACA;EACA;;EAEA,cAAc,SAAS;;EAEvB,iBAAiB;;iBAGF;WACN;WACA;WACA,SAAS;;YAGR,sCACV,SAAS,mCACN,QAAQ;;iBAGI;WACN;WACA;WACA;;WAEA;;;;;;;;qBASE;;;;;;;qBAQA;iBAEI;WACN;WACA;WACA;WACA;WACA,SAAS;;WAET;;WAEA,YAAY;;WAEZ;;WAEA;;WAEA;;WAEA,cAAc,SAAS;;WAEvB;;iBAGM;WACN,SAAS;;WAET;;;iBAIM;WACN,SAAS;;;iBAIH;WACN;EACT,QAAQ,yBAAyB,cAAc;EAC/C,UAAU,cAAc,WAAW,yBAAyB;EAC5D,YAAY,WAAW;EACvB;;iBAEe;WACN;WACA;WACA;WACA;WACA;WACA;WACA;;;;;;;iBAQM;WACN;;WAEA;;WAEA;;;iBAGM;EACf,KAAK,YAAY;IAA4B;IAAmB;;EAChE,QAAQ,YAAY,yBAAyB,cAAc;IAAU;IAAmB;;EACxF,SAAS,YAAY,0BAA0B,QAAQ;;;iBAIxC;WACN;WACA;WACA,iBAAiB;;;iBAIX;EACf,OAAO,SAAS,8BAA8B,QAAQ;EACtD,MAAM,oBAAoB;EAC1B,OAAO;;EAEP,oBACE,mBACA,UAAU,KAAK,kDACd,QAAQ;;EAEX,QAAQ,mBAAmB,cAAc,UAAU,8BAA8B,QAAQ;;EAEzF,OAAO,mBAAmB,UAAU,KAAK,kDAAkD;;;;;EAK3F,OACE,mBACA,iBACA,UAAU,KAAK,kDACd;;;;;;EAMH,SAAS,mBAAmB,UAAU,KAAK,kDAAkD;WACpF,eAAe;;EAExB,2BAA2B,SAAS,iCAAiC,QAAQ;;EAE7E,qCAAqC,aAAa;;EAElD,gBAAgB,yBAAyB;;EAEzC,mBAAmB,oBAAoB;;iBAGxB;EACf;EACA;EACA;EACA,gBAAgB,WAAW;EAC3B,SAAS;;EAET,UAAU;;YAGA;iBAEK;WACN,WAAW;WACX;WACA,SAAS;;iBAGH;WACN;;WAEA;EACT,QAAQ,OAAO,qBAAqB,SAAS,6BAA6B;;EAE1E,WAAW,SAAS;;EAEpB,cAAc,mBAAmB,UAAU;EAC3C,aAAa;;EAEb,kBAAkB,mBAAmB,SAAS;EAC9C,oBAAoB,mBAAmB,SAAS;EAChD,qBAAqB,SAAS;;EAE9B,kBAAkB,mBAAmB,SAAS;EAC9C,cAAc;EACd,eAAe,OAAO,qBAAqB,oBAAoB,gBAAgB,QAAQ;EACvF,eAAe;EACf,WAAW,sBAAsB;EACjC;;;iBAIe;WACN;WACA;EACT,UAAU,SAAS;EACnB,oBAAoB,SAAS;EAC7B,qBAAqB,SAAS;EAC9B,kBAAkB,SAAS;EAC3B,MAAM,UAAU;EAChB,gBAAgB,oBAAoB,gBAAgB,QAAQ;EAC5D,UAAU;;iBAGK;EACf;;EAEA;;EAEA;;iBAGe;EACf,qBAAqB;;EAErB,iBAAiB;;WAER,cAAc;EACvB,QAAQ,mBAAmB;EAC3B,qBAAqB,sBAAsB,mBAAmB;EAC9D,kBAAkB,OAAO,qBAAqB,SAAS,2BAA2B,QAAQ;EAC1F,cAAc;EACd,SAAS;;iBAGM;EACf,WAAW,OAAO;EAClB,cAAc,OAAO;EACrB,gBAAgB;EAChB,eAAe,OAAO,qBAAqB;EAC3C;;YAGU;iBAEK;EACf;EACA,YAAY;EACZ,MAAM,MAAM,qBAAqB;EACjC;EACA,SAAS,OAAO,qBAAqB,kBAAkB,YAAY;EACnE,cAAc,YAAY"}
+{"version":3,"file":"hubChannel.d.mts","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"mappings":"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"}

package/dist/src/schemas/hubChannel.mjs

@@ -13,7 +13,9 @@ const WORKFLOW_STEP_SESSION_PROVENANCE = "workflow";
 * parent. Like a detached helper, it takes no row in the session rail.
 */
 const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = "workflow-dispatcher";
+/** Provenance of a conversation an external MCP client opened and drives. */
+const REMOTE_CONVERSATION_SESSION_PROVENANCE = "remote-conversation";
 //#endregion
-export { WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE };
+export { REMOTE_CONVERSATION_SESSION_PROVENANCE, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE };
 
 //# sourceMappingURL=hubChannel.mjs.map

package/dist/src/schemas/hubChannel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hubChannel.mjs","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"sourcesContent":["import type { DoomBackgroundWorkSnapshot } from './backgroundWork';\n\nexport interface DoomHubChannelFrame {\n  type: string;\n  sessionId: string;\n  payload: unknown;\n}\n\n/** Same-process lifecycle bus shared by a host's session APIs and hub channels. */\nexport interface DoomDirectEventSubscriptionOptions {\n  /** Replay the most recent value published for this frame and session, when one exists. */\n  readonly replayLatest?: boolean;\n}\n\nexport interface DoomDirectEventBus {\n  publish(frameType: string, sessionId: string, payload: unknown): void;\n  subscribe(\n    frameType: string,\n    sessionId: string,\n    listener: (payload: unknown) => void,\n    options?: DoomDirectEventSubscriptionOptions,\n  ): () => void;\n  /** Drop retained state for a session after its lifecycle ends. */\n  clearSession?(sessionId: string): void;\n  close(): void;\n}\n\n/**\n * The extension-agnostic baseline every surface gets for one session, computed once by the\n * session host. Extensions build on it instead of re-deriving roots and relations from cwd.\n */\nexport interface DoomSessionContext {\n  readonly sessionId: string;\n  /** Persisted workspace id, shared by every session and member checkout of the workspace. */\n  readonly workspaceId: string;\n  /** The admitted workspace root. It owns configuration, composition and settings. */\n  readonly workspaceRoot: string;\n  /**\n   * The checkout the session executes in. Equals workspaceRoot unless the session runs in a\n   * member checkout, such as a worktree, which may live outside the workspace folder.\n   */\n  readonly checkoutRoot: string;\n  readonly cwd: string;\n  readonly parentSessionId?: string;\n  /** The spawner's label for the session. Opaque: hosts never interpret it. */\n  readonly provenance?: string;\n}\n\nexport interface DoomHubSessionScope {\n  sessionId: string;\n  workspaceId?: string;\n  cwd: string;\n  /** Environment admitted for this session, when supplied by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** The session's baseline context, when its host knows its workspace. */\n  sessionContext?: DoomSessionContext;\n}\n\nexport interface DoomHubReservedWorktreeRequest {\n  readonly reservationId: string;\n  readonly parentSessionId: string;\n  readonly signal?: AbortSignal;\n}\n\nexport type DoomHubReservedWorktreeProvisioner = (\n  request: DoomHubReservedWorktreeRequest,\n) => Promise<DoomHubSessionScope>;\n\n/** Selection axes a caller pins for a new session instead of the workspace defaults. */\nexport interface DoomHubSessionSelection {\n  readonly majorMode?: string;\n  readonly minorModes?: readonly string[];\n  readonly profile?: string;\n  /** An empty list starts the session with no domains. */\n  readonly domains?: readonly string[];\n}\n\n/**\n * Provenance of a session a workflow step opened.\n *\n * The step's conversation belongs to the workflow that ran it and is read in\n * that workflow's view, so the session rail leaves such sessions out.\n */\nexport const WORKFLOW_STEP_SESSION_PROVENANCE = 'workflow';\n\n/**\n * Provenance of a session opened to launch workflows for its parent.\n *\n * It picks and starts work, then closes; the runs it started belong to its\n * parent. Like a detached helper, it takes no row in the session rail.\n */\nexport const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = 'workflow-dispatcher';\n\nexport interface DoomHubSessionCreateRequest {\n  readonly cwd: string;\n  readonly name: string;\n  readonly parentSessionId?: string;\n  readonly sessionProvenance?: string;\n  readonly signal?: AbortSignal;\n  /** Host-issued reservation, not a caller-chosen target session id. */\n  readonly reservationId?: string;\n  /** Pinned axes stay put when the workspace defaults change between turns. */\n  readonly selection?: DoomHubSessionSelection;\n  /** Pi model selector, `provider/id`, validated like `--model`. */\n  readonly model?: string;\n  /** Pi thinking level, validated like `--thinking`. */\n  readonly thinking?: string;\n  /** Text appended to the session's system prompt, like `--append-system-prompt`. */\n  readonly appendSystemPrompt?: string;\n  /** Variables layered over the host environment for the new session and the tools it runs. */\n  readonly environment?: Readonly<Record<string, string>>;\n  /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */\n  readonly tools?: readonly string[];\n}\n\nexport interface DoomHubSessionPromptOptions {\n  readonly signal?: AbortSignal;\n  /** Refuses the prompt unless the target is a direct child of this session. */\n  readonly parentSessionId?: string;\n}\n\n/** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */\nexport interface DoomHubSessionPromptReceipt {\n  readonly settled: Promise<void>;\n}\n\n/** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */\nexport interface DoomSessionCommunicationEndpoint {\n  readonly sessionId: string;\n  publish(targetSessionId: string, type: string, payload: unknown): boolean;\n  subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;\n  onPeerReady(listener: (peerSessionId: string) => void): () => void;\n  close(): void;\n}\nexport interface DoomPendingSessionSetup {\n  readonly id: string;\n  readonly name: string;\n  readonly createdAt: string;\n  readonly cwd?: string;\n  readonly setupKind?: 'managed-worktree' | 'existing-directory';\n  readonly status?: 'provisioning' | 'failed' | 'interrupted';\n  readonly errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';\n}\n\n/**\n * One short line a session's extension publishes about work it runs for that\n * session, such as a background job. The host shows it on the session's rail\n * card but never interprets it.\n */\nexport interface DoomSessionActivity {\n  readonly label: string;\n  /** The work needs the reader: the rail marks the card the way it marks a pending question. */\n  readonly attention?: boolean;\n  /** ISO 8601 start of the work; the rail appends the elapsed time. */\n  readonly since?: string;\n}\n/** A host-owned setup can be fulfilled by any execution-directory provider. */\nexport interface DoomHubSessionReservations {\n  read(id: string, parentSessionId: string): { sessionId: string; cwd?: string };\n  prepare(id: string, parentSessionId: string, cwd: string): Promise<{ sessionId: string; cwd: string }>;\n  complete(id: string, parentSessionId: string): Promise<DoomHubSessionScope>;\n}\n\n/** Authoritative execution state. Missing background coordination is unknown, not empty. */\nexport interface DoomHubSessionExecutionState {\n  readonly isIdle: boolean;\n  readonly hasPendingMessages: boolean;\n  readonly backgroundWork?: DoomBackgroundWorkSnapshot;\n}\n\n/** Direct lifecycle owned by the canonical headless hub, never by a package transport. */\nexport interface DoomHubSessionService {\n  create(request: DoomHubSessionCreateRequest): Promise<DoomHubSessionScope>;\n  close(sessionId: string): Promise<void>;\n  isLive(sessionId: string): boolean;\n  /** Reads a live child's ownership without starting a turn. */\n  readExecutionState?(\n    sessionId: string,\n    options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<DoomHubSessionExecutionState>;\n  /** Starts a turn in a live session, as if its user had submitted `text`. */\n  prompt?(sessionId: string, text: string, options?: DoomHubSessionPromptOptions): Promise<DoomHubSessionPromptReceipt>;\n  /** Aborts the live session's current turn. The session stays open. */\n  abort?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  /**\n   * Adds guidance to a live session's running turn. A session with no turn in\n   * progress takes it as its next message instead.\n   */\n  steer?(\n    sessionId: string,\n    message: string,\n    options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<void>;\n  /**\n   * Stops a live session's runtime and keeps it dormant: its history stays\n   * readable where it is shown, and it can be woken later. A session that has\n   * done its work no longer holds a model, tools and extensions in the host.\n   */\n  release?(sessionId: string, options?: Pick<DoomHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  readonly reservations?: DoomHubSessionReservations;\n  /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */\n  provisionReservedWorktree?(request: DoomHubReservedWorktreeRequest): Promise<DoomHubSessionScope>;\n  /** Core host hook. A Git provider registers its implementation while its channel is mounted. */\n  registerReservedWorktreeProvisioner?(provisioner: DoomHubReservedWorktreeProvisioner): () => void;\n  /** True only when both live sessions have a direct parent-child relationship. */\n  canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;\n  /** Core host hook. Session API construction removes this method before exposing the service to extensions. */\n  bindCommunication?(sessionId: string): DoomSessionCommunicationEndpoint;\n}\n\nexport interface DoomHubSessionApiRequest {\n  basePath: string;\n  path: string;\n  method: string;\n  body?: string | Uint8Array<ArrayBuffer> | null;\n  signal?: AbortSignal;\n  /** Forwarded by the authenticated host, including content type and trace context. */\n  headers?: RequestInit['headers'];\n}\n\nexport type DoomComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';\n\nexport interface DoomComputerUseHostRequest {\n  readonly operation: DoomComputerUseHostOperation;\n  readonly payload?: unknown;\n  readonly signal?: AbortSignal;\n}\n\nexport interface DoomComputerUseHostBinding {\n  readonly available: boolean;\n  /** Global opt-in, separate from the presence of a native host. */\n  readonly enabled?: boolean;\n  request(scope: DoomHubSessionScope, request: DoomComputerUseHostRequest): Promise<unknown>;\n  /** Checks a proof injected by the owning Desktop process, never a renderer marker. */\n  authorize?(headers: Headers): boolean;\n  /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */\n  claimSession?(sessionId: string, headers?: Headers): void;\n  ownsSession?(sessionId: string): boolean;\n  /** Server-authenticated paired identity, checked against live native approval for this session. */\n  authorizeSession?(sessionId: string, headers: Headers): boolean;\n  authorizeRecording?(sessionId: string, headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  /** Own pending activation only, never general session control. */\n  authorizePending?(sessionId: string, headers: Headers): boolean;\n  revokeDevice?(deviceId: string): void;\n  readRecording?(scope: DoomHubSessionScope, artifactId: string, range: string): Promise<Response>;\n  forgetSession?(sessionId: string): void;\n  subscribe?(listener: () => void, sessionId?: string): () => void;\n  close?(): void;\n}\n\n/** Narrow, host-bound access. An extension cannot select another session's identity. */\nexport interface DoomComputerUseSessionAccess {\n  readonly available: boolean;\n  readonly enabled?: boolean;\n  authorize(headers: Headers): boolean;\n  authorizeRecording?(headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  authorizePending?(headers: Headers): boolean;\n  claim(headers?: Headers): void;\n  fetchRecording?(artifactId: string, range: string): Promise<Response>;\n  subscribe(listener: () => void): () => void;\n}\n\nexport interface DoomHubChannelConnection {\n  connectionId: string;\n  /** Host-verified native renderer proof, never copied from a channel payload. */\n  desktopAuthorized?: boolean;\n  /** Live session authorization evaluated by the host, never a client frame. */\n  computerUseAuthorized?: boolean;\n}\n\nexport interface DoomHubChannelHost {\n  sessions(): readonly DoomHubSessionScope[];\n  /** Canonical hub lifecycle for sessions created by channel commands. */\n  sessionService?: DoomHubSessionService;\n  /** Same-process events emitted by session facets. */\n  readonly directEvents: DoomDirectEventBus;\n  publish(sessionId: string, payload: unknown): void;\n  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;\n  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;\n  computerUse?: DoomComputerUseHostBinding;\n  onNotice(message: string): void;\n}\n\nexport interface DoomHubChannelSource {\n  payloadFor(scope: DoomHubSessionScope): unknown;\n  sessionAdded?(scope: DoomHubSessionScope): void;\n  sessionRemoved?(sessionId: string): void;\n  threadJournal?(scope: DoomHubSessionScope, threadId: string): string | undefined;\n  close(): void;\n}\n\nexport type DoomHubChannelLifecycle = 'session' | 'hub';\n\nexport interface DoomHubChannel {\n  frameType: string;\n  lifecycle?: DoomHubChannelLifecycle;\n  start(host: DoomHubChannelHost): DoomHubChannelSource;\n  receiveWithoutSubscription?: boolean;\n  receive?(scope: DoomHubSessionScope, payload: unknown, connection: DoomHubChannelConnection): void;\n  disconnected?(connection: DoomHubChannelConnection): void;\n}\n"],"mappings":";;;;;;;AAmFA,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,yCAAyC"}
+{"version":3,"file":"hubChannel.mjs","names":[],"sources":["../../../src/schemas/hubChannel.ts"],"sourcesContent":["import type { PoBackgroundWorkSnapshot } from './backgroundWork';\nimport type { HomeProjection } from './home';\nimport type { PoSessionStorageService } from './platform';\n\nexport interface PoHubChannelFrame {\n  type: string;\n  sessionId: string;\n  payload: unknown;\n}\n\n/** Same-process lifecycle bus shared by a host's session APIs and hub channels. */\nexport interface PoDirectEventSubscriptionOptions {\n  /** Replay the most recent value published for this frame and session, when one exists. */\n  readonly replayLatest?: boolean;\n}\n\nexport interface PoDirectEventBus {\n  publish(frameType: string, sessionId: string, payload: unknown): void;\n  subscribe(\n    frameType: string,\n    sessionId: string,\n    listener: (payload: unknown) => void,\n    options?: PoDirectEventSubscriptionOptions,\n  ): () => void;\n  /** Drop retained state for a session after its lifecycle ends. */\n  clearSession?(sessionId: string): void;\n  close(): void;\n}\n\n/**\n * The extension-agnostic baseline every surface gets for one session, computed once by the\n * session host. Extensions build on it instead of re-deriving roots and relations from cwd.\n */\nexport interface PoSessionContext {\n  readonly sessionId: string;\n  /** Persisted workspace id, shared by every session and member checkout of the workspace. */\n  readonly workspaceId: string;\n  /** The admitted workspace root. It owns configuration, composition and settings. */\n  readonly workspaceRoot: string;\n  /**\n   * The checkout the session executes in. Equals workspaceRoot unless the session runs in a\n   * member checkout, such as a worktree, which may live outside the workspace folder.\n   */\n  readonly checkoutRoot: string;\n  readonly cwd: string;\n  readonly parentSessionId?: string;\n  /** The spawner's label for the session. Opaque: hosts never interpret it. */\n  readonly provenance?: string;\n}\n\nexport interface PoHubSessionScope {\n  sessionId: string;\n  workspaceId?: string;\n  cwd: string;\n  /** Environment admitted for this session, when supplied by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** The session's baseline context, when its host knows its workspace. */\n  sessionContext?: PoSessionContext;\n}\n\nexport interface PoHubReservedWorktreeRequest {\n  readonly reservationId: string;\n  readonly parentSessionId: string;\n  readonly signal?: AbortSignal;\n}\n\nexport type PoHubReservedWorktreeProvisioner = (request: PoHubReservedWorktreeRequest) => Promise<PoHubSessionScope>;\n\n/** Selection axes a caller pins for a new session instead of the workspace defaults. */\nexport interface PoHubSessionSelection {\n  readonly majorMode?: string;\n  readonly minorModes?: readonly string[];\n  readonly profile?: string;\n  /** An empty list starts the session with no domains. */\n  readonly domains?: readonly string[];\n}\n\n/**\n * Provenance of a session a workflow step opened.\n *\n * The step's conversation belongs to the workflow that ran it and is read in\n * that workflow's view, so the session rail leaves such sessions out.\n */\nexport const WORKFLOW_STEP_SESSION_PROVENANCE = 'workflow';\n\n/**\n * Provenance of a session opened to launch workflows for its parent.\n *\n * It picks and starts work, then closes; the runs it started belong to its\n * parent. Like a detached helper, it takes no row in the session rail.\n */\nexport const WORKFLOW_DISPATCHER_SESSION_PROVENANCE = 'workflow-dispatcher';\n\n/** Provenance of a conversation an external MCP client opened and drives. */\nexport const REMOTE_CONVERSATION_SESSION_PROVENANCE = 'remote-conversation';\n\nexport interface PoHubSessionCreateRequest {\n  readonly cwd: string;\n  readonly name: string;\n  readonly parentSessionId?: string;\n  readonly sessionProvenance?: string;\n  readonly signal?: AbortSignal;\n  /** Host-issued reservation, not a caller-chosen target session id. */\n  readonly reservationId?: string;\n  /** Pinned axes stay put when the workspace defaults change between turns. */\n  readonly selection?: PoHubSessionSelection;\n  /** Pi model selector, `provider/id`, validated like `--model`. */\n  readonly model?: string;\n  /** Pi thinking level, validated like `--thinking`. */\n  readonly thinking?: string;\n  /** Text appended to the session's system prompt, like `--append-system-prompt`. */\n  readonly appendSystemPrompt?: string;\n  /** Variables layered over the host environment for the new session and the tools it runs. */\n  readonly environment?: Readonly<Record<string, string>>;\n  /** The only tools the new session's agent may see or call, like a Team agent's `tools:` list. */\n  readonly tools?: readonly string[];\n}\n\nexport interface PoHubSessionPromptOptions {\n  readonly signal?: AbortSignal;\n  /** Refuses the prompt unless the target is a direct child of this session. */\n  readonly parentSessionId?: string;\n}\n\n/** A prompt the session admitted. `settled` resolves once the agent settles and rejects on a harness fault. */\nexport interface PoHubSessionPromptReceipt {\n  readonly settled: Promise<void>;\n}\n\n/** Host-bound inter-session events. The source identity is attached by the hub, never by payload data. */\nexport interface PoSessionCommunicationEndpoint {\n  readonly sessionId: string;\n  /** Current human-readable session name, read live so renames are reflected. */\n  readonly sessionName?: string;\n  publish(targetSessionId: string, type: string, payload: unknown): boolean;\n  subscribe(type: string, listener: (sourceSessionId: string, payload: unknown) => void): () => void;\n  onPeerReady(listener: (peerSessionId: string) => void): () => void;\n  /** Describes a live peer authorized to communicate, including same-checkout peers. */\n  describePeer?(peerSessionId: string): PoSessionPeerDescription | undefined;\n  close(): void;\n}\n\n/** How a session sees a peer it may message, so an agent can address it by the name a person uses. */\nexport interface PoSessionPeerDescription {\n  readonly sessionId: string;\n  readonly name: string;\n  readonly profile?: string;\n  /** Groups both sessions belong to; empty when related through parentage or checkout. */\n  readonly sharedGroups: readonly string[];\n}\nexport interface PoPendingSessionSetup {\n  readonly id: string;\n  readonly name: string;\n  readonly createdAt: string;\n  readonly cwd?: string;\n  readonly setupKind?: 'managed-worktree' | 'existing-directory';\n  readonly status?: 'provisioning' | 'failed' | 'interrupted';\n  readonly errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';\n}\n\n/**\n * One short line a session's extension publishes about work it runs for that\n * session, such as a background job. The host shows it on the session's rail\n * card but never interprets it.\n */\nexport interface PoSessionActivity {\n  readonly label: string;\n  /** The work needs the reader: the rail marks the card the way it marks a pending question. */\n  readonly attention?: boolean;\n  /** ISO 8601 start of the work; the rail appends the elapsed time. */\n  readonly since?: string;\n}\n/** A host-owned setup can be fulfilled by any execution-directory provider. */\nexport interface PoHubSessionReservations {\n  read(id: string, parentSessionId: string): { sessionId: string; cwd?: string };\n  prepare(id: string, parentSessionId: string, cwd: string): Promise<{ sessionId: string; cwd: string }>;\n  complete(id: string, parentSessionId: string): Promise<PoHubSessionScope>;\n}\n\n/** Authoritative execution state. Missing background coordination is unknown, not empty. */\nexport interface PoHubSessionExecutionState {\n  readonly isIdle: boolean;\n  readonly hasPendingMessages: boolean;\n  readonly backgroundWork?: PoBackgroundWorkSnapshot;\n}\n\n/** Direct lifecycle owned by the canonical headless hub, never by a package transport. */\nexport interface PoHubSessionService {\n  create(request: PoHubSessionCreateRequest): Promise<PoHubSessionScope>;\n  close(sessionId: string): Promise<void>;\n  isLive(sessionId: string): boolean;\n  /** Reads a live child's ownership without starting a turn. */\n  readExecutionState?(\n    sessionId: string,\n    options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<PoHubSessionExecutionState>;\n  /** Starts a turn in a live session, as if its user had submitted `text`. */\n  prompt?(sessionId: string, text: string, options?: PoHubSessionPromptOptions): Promise<PoHubSessionPromptReceipt>;\n  /** Aborts the live session's current turn. The session stays open. */\n  abort?(sessionId: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  /**\n   * Adds guidance to a live session's running turn. A session with no turn in\n   * progress takes it as its next message instead.\n   */\n  steer?(\n    sessionId: string,\n    message: string,\n    options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>,\n  ): Promise<void>;\n  /**\n   * Stops a live session's runtime and keeps it dormant: its history stays\n   * readable where it is shown, and it can be woken later. A session that has\n   * done its work no longer holds a model, tools and extensions in the host.\n   */\n  release?(sessionId: string, options?: Pick<PoHubSessionPromptOptions, 'parentSessionId'>): Promise<void>;\n  readonly reservations?: PoHubSessionReservations;\n  /** Provisions a host-reserved Git worktree child. This is not exposed to remote MCP clients. */\n  provisionReservedWorktree?(request: PoHubReservedWorktreeRequest): Promise<PoHubSessionScope>;\n  /** Core host hook. A Git provider registers its implementation while its channel is mounted. */\n  registerReservedWorktreeProvisioner?(provisioner: PoHubReservedWorktreeProvisioner): () => void;\n  /**\n   * True when both live sessions have a direct parent-child relationship, or execute in the same\n   * checkout. Remote conversations only qualify through the parent-child relationship.\n   */\n  canCommunicate?(sourceSessionId: string, targetSessionId: string): boolean;\n  /** Core host hook. Session API construction removes this method before exposing the service to extensions. */\n  bindCommunication?(sessionId: string): PoSessionCommunicationEndpoint;\n}\n\nexport interface PoHubSessionApiRequest {\n  basePath: string;\n  path: string;\n  method: string;\n  body?: string | Uint8Array<ArrayBuffer> | null;\n  signal?: AbortSignal;\n  /** Forwarded by the authenticated host, including content type and trace context. */\n  headers?: RequestInit['headers'];\n}\n\nexport type PoComputerUseHostOperation = 'status' | 'targets' | 'activate' | 'observe' | 'act' | 'stop';\n\nexport interface PoComputerUseHostRequest {\n  readonly operation: PoComputerUseHostOperation;\n  readonly payload?: unknown;\n  readonly signal?: AbortSignal;\n}\n\nexport interface PoComputerUseHostBinding {\n  readonly available: boolean;\n  /** Global opt-in, separate from the presence of a native host. */\n  readonly enabled?: boolean;\n  request(scope: PoHubSessionScope, request: PoComputerUseHostRequest): Promise<unknown>;\n  /** Checks a proof injected by the owning Desktop process, never a renderer marker. */\n  authorize?(headers: Headers): boolean;\n  /** Pins a session to Desktop before asking for a native grant. Ownership is not persisted. */\n  claimSession?(sessionId: string, headers?: Headers): void;\n  ownsSession?(sessionId: string): boolean;\n  /** Server-authenticated paired identity, checked against live native approval for this session. */\n  authorizeSession?(sessionId: string, headers: Headers): boolean;\n  authorizeRecording?(sessionId: string, headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  /** Own pending activation only, never general session control. */\n  authorizePending?(sessionId: string, headers: Headers): boolean;\n  revokeDevice?(deviceId: string): void;\n  readRecording?(scope: PoHubSessionScope, artifactId: string, range: string): Promise<Response>;\n  forgetSession?(sessionId: string): void;\n  /** Without `sessionId` the listener hears every session's ownership change. */\n  subscribe?(listener: () => void, sessionId?: string): () => void;\n  close?(): void;\n}\n\n/** Narrow, host-bound access. An extension cannot select another session's identity. */\nexport interface PoComputerUseSessionAccess {\n  readonly available: boolean;\n  readonly enabled?: boolean;\n  authorize(headers: Headers): boolean;\n  authorizeRecording?(headers: Headers): boolean;\n  authorizeActivation?(headers: Headers): boolean;\n  authorizePending?(headers: Headers): boolean;\n  claim(headers?: Headers): void;\n  fetchRecording?(artifactId: string, range: string): Promise<Response>;\n  subscribe(listener: () => void): () => void;\n}\n\nexport interface PoHubChannelConnection {\n  connectionId: string;\n  /** Host-verified native renderer proof, never copied from a channel payload. */\n  desktopAuthorized?: boolean;\n  /** Live session authorization evaluated by the host, never a client frame. */\n  computerUseAuthorized?: boolean;\n}\n\nexport interface PoHubChannelHost {\n  sessions(): readonly PoHubSessionScope[];\n  /** Host facts and storage for trusted in-process channels, never client-supplied roots. */\n  readonly homeDirectory?: string;\n  readonly sessionStorage?: PoSessionStorageService;\n  /** Canonical hub lifecycle for sessions created by channel commands. */\n  sessionService?: PoHubSessionService;\n  /** Same-process events emitted by session packages. */\n  readonly directEvents: PoDirectEventBus;\n  publish(sessionId: string, payload: unknown): void;\n  publishToConnection?(connectionId: string, sessionId: string, payload: unknown): boolean;\n  requestSessionApi(scope: PoHubSessionScope, request: PoHubSessionApiRequest): Promise<Response>;\n  computerUse?: PoComputerUseHostBinding;\n  onNotice(message: string): void;\n}\n\nexport interface PoHubChannelSource {\n  payloadFor(scope: PoHubSessionScope): unknown;\n  /** Read-only compact projection of already-owned state. Must not start work or add watchers. */\n  homeFor?(scope: PoHubSessionScope): HomeProjection;\n  sessionAdded?(scope: PoHubSessionScope): void;\n  sessionRemoved?(sessionId: string): void;\n  close(): void;\n}\n\nexport type PoHubChannelLifecycle = 'session' | 'hub';\n\nexport interface PoHubChannel {\n  frameType: string;\n  lifecycle?: PoHubChannelLifecycle;\n  start(host: PoHubChannelHost): PoHubChannelSource;\n  receiveWithoutSubscription?: boolean;\n  receive?(scope: PoHubSessionScope, payload: unknown, connection: PoHubChannelConnection): void;\n  disconnected?(connection: PoHubChannelConnection): void;\n}\n"],"mappings":";;;;;;;AAmFA,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,yCAAyC;;AAGtD,MAAa,yCAAyC"}

package/dist/src/schemas/leader.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"leader.cjs","names":["Type"],"sources":["../../../src/schemas/leader.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nimport type { DoomExtensionContext } from './config';\n\n/**\n * How the key badge is painted. `exit` marks the row that leaves an active minor\n * mode, which the panel colours differently so the reader can tell which way the\n * key flips without checking the mode line first.\n */\nexport const LeaderToneSchema = Type.Union([Type.Literal('default'), Type.Literal('exit')]);\nexport type LeaderTone = Static<typeof LeaderToneSchema>;\n\nexport const LeaderSegmentSchema = Type.Object(\n  {\n    key: Type.String({ minLength: 1, maxLength: 1 }),\n    label: Type.String({ minLength: 1 }),\n    detail: Type.Optional(Type.String()),\n    order: Type.Optional(Type.Integer()),\n    tone: Type.Optional(LeaderToneSchema),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderSegment = Static<typeof LeaderSegmentSchema>;\n\nexport const LeaderCommandSchema = Type.Object(\n  { name: Type.String({ minLength: 1 }), args: Type.Optional(Type.String()) },\n  { additionalProperties: false },\n);\nexport type LeaderCommand = Static<typeof LeaderCommandSchema>;\n\nexport const LeaderActionSchema = Type.Object(\n  {\n    name: Type.String({ minLength: 1, maxLength: 128, pattern: '^[a-z0-9][a-z0-9._:-]*$' }),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderAction = Static<typeof LeaderActionSchema>;\n\nconst LeaderBindingBase = {\n  id: Type.String({ minLength: 1 }),\n  path: Type.Array(LeaderSegmentSchema, { minItems: 1 }),\n};\n\nexport const LeaderBindingSchema = Type.Union([\n  Type.Object({ ...LeaderBindingBase, command: LeaderCommandSchema }, { additionalProperties: false }),\n  Type.Object({ ...LeaderBindingBase, action: LeaderActionSchema }, { additionalProperties: false }),\n]);\nexport type LeaderBinding =\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      command: LeaderCommand;\n    }\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      action: LeaderAction;\n    };\n\nexport const LeaderSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const LeaderContributionSchema = Type.Object(\n  {\n    source: LeaderSourceSchema,\n    bindings: Type.Array(LeaderBindingSchema),\n  },\n  { additionalProperties: false },\n);\nexport interface LeaderContribution {\n  source: string;\n  bindings: readonly LeaderBinding[];\n}\n\nexport interface DoomLeaderContributionHandle {\n  update(bindings: readonly LeaderBinding[]): void;\n  dispose(): void;\n}\n\nexport interface DoomLeaderActionHandlerOptions<ExtensionContext extends DoomExtensionContext = DoomExtensionContext> {\n  source: string;\n  handlers: Readonly<Record<string, (context: ExtensionContext) => void | Promise<void>>>;\n  onError: (error: unknown, actionName: string, context: ExtensionContext) => void;\n}\n"],"mappings":";;;;;;;AASA,MAAa,mBAAmBA,QAAAA,KAAK,MAAM,CAACA,QAAAA,KAAK,QAAQ,SAAS,GAAGA,QAAAA,KAAK,QAAQ,MAAM,CAAC,CAAC;AAG1F,MAAa,sBAAsBA,QAAAA,KAAK,OACtC;CACE,KAAKA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAE,CAAC;CAC/C,OAAOA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CACnC,QAAQA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO,CAAC;CACnC,OAAOA,QAAAA,KAAK,SAASA,QAAAA,KAAK,QAAQ,CAAC;CACnC,MAAMA,QAAAA,KAAK,SAAS,gBAAgB;AACtC,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,sBAAsBA,QAAAA,KAAK,OACtC;CAAE,MAAMA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAAG,MAAMA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO,CAAC;AAAE,GAC1E,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,qBAAqBA,QAAAA,KAAK,OACrC,EACE,MAAMA,QAAAA,KAAK,OAAO;CAAE,WAAW;CAAG,WAAW;CAAK,SAAS;AAA0B,CAAC,EACxF,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAM,oBAAoB;CACxB,IAAIA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAChC,MAAMA,QAAAA,KAAK,MAAM,qBAAqB,EAAE,UAAU,EAAE,CAAC;AACvD;AAEA,MAAa,sBAAsBA,QAAAA,KAAK,MAAM,CAC5CA,QAAAA,KAAK,OAAO;CAAE,GAAG;CAAmB,SAAS;AAAoB,GAAG,EAAE,sBAAsB,MAAM,CAAC,GACnGA,QAAAA,KAAK,OAAO;CAAE,GAAG;CAAmB,QAAQ;AAAmB,GAAG,EAAE,sBAAsB,MAAM,CAAC,CACnG,CAAC;AAaD,MAAa,qBAAqBA,QAAAA,KAAK,OAAO;CAC5C,WAAW;CACX,WAAW;CACX,SAAS;AACX,CAAC;AAED,MAAa,2BAA2BA,QAAAA,KAAK,OAC3C;CACE,QAAQ;CACR,UAAUA,QAAAA,KAAK,MAAM,mBAAmB;AAC1C,GACA,EAAE,sBAAsB,MAAM,CAChC"}
+{"version":3,"file":"leader.cjs","names":["Type"],"sources":["../../../src/schemas/leader.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nimport type { PoExtensionContext } from './config';\n\n/**\n * How the key badge is painted. `exit` marks the row that leaves an active minor\n * mode, which the panel colours differently so the reader can tell which way the\n * key flips without checking the mode line first.\n */\nexport const LeaderToneSchema = Type.Union([Type.Literal('default'), Type.Literal('exit')]);\nexport type LeaderTone = Static<typeof LeaderToneSchema>;\n\nexport const LeaderSegmentSchema = Type.Object(\n  {\n    key: Type.String({ minLength: 1, maxLength: 1 }),\n    label: Type.String({ minLength: 1 }),\n    detail: Type.Optional(Type.String()),\n    order: Type.Optional(Type.Integer()),\n    tone: Type.Optional(LeaderToneSchema),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderSegment = Static<typeof LeaderSegmentSchema>;\n\nexport const LeaderCommandSchema = Type.Object(\n  { name: Type.String({ minLength: 1 }), args: Type.Optional(Type.String()) },\n  { additionalProperties: false },\n);\nexport type LeaderCommand = Static<typeof LeaderCommandSchema>;\n\nexport const LeaderActionSchema = Type.Object(\n  {\n    name: Type.String({ minLength: 1, maxLength: 128, pattern: '^[a-z0-9][a-z0-9._:-]*$' }),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderAction = Static<typeof LeaderActionSchema>;\n\nconst LeaderBindingBase = {\n  id: Type.String({ minLength: 1 }),\n  path: Type.Array(LeaderSegmentSchema, { minItems: 1 }),\n};\n\nexport const LeaderBindingSchema = Type.Union([\n  Type.Object({ ...LeaderBindingBase, command: LeaderCommandSchema }, { additionalProperties: false }),\n  Type.Object({ ...LeaderBindingBase, action: LeaderActionSchema }, { additionalProperties: false }),\n]);\nexport type LeaderBinding =\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      command: LeaderCommand;\n    }\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      action: LeaderAction;\n    };\n\nexport const LeaderSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const LeaderContributionSchema = Type.Object(\n  {\n    source: LeaderSourceSchema,\n    bindings: Type.Array(LeaderBindingSchema),\n  },\n  { additionalProperties: false },\n);\nexport interface LeaderContribution {\n  source: string;\n  bindings: readonly LeaderBinding[];\n}\n\nexport interface PoLeaderContributionHandle {\n  update(bindings: readonly LeaderBinding[]): void;\n  dispose(): void;\n}\n\nexport interface PoLeaderActionHandlerOptions<ExtensionContext extends PoExtensionContext = PoExtensionContext> {\n  source: string;\n  handlers: Readonly<Record<string, (context: ExtensionContext) => void | Promise<void>>>;\n  onError: (error: unknown, actionName: string, context: ExtensionContext) => void;\n}\n"],"mappings":";;;;;;;AASA,MAAa,mBAAmBA,QAAAA,KAAK,MAAM,CAACA,QAAAA,KAAK,QAAQ,SAAS,GAAGA,QAAAA,KAAK,QAAQ,MAAM,CAAC,CAAC;AAG1F,MAAa,sBAAsBA,QAAAA,KAAK,OACtC;CACE,KAAKA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAE,CAAC;CAC/C,OAAOA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CACnC,QAAQA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO,CAAC;CACnC,OAAOA,QAAAA,KAAK,SAASA,QAAAA,KAAK,QAAQ,CAAC;CACnC,MAAMA,QAAAA,KAAK,SAAS,gBAAgB;AACtC,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,sBAAsBA,QAAAA,KAAK,OACtC;CAAE,MAAMA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAAG,MAAMA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO,CAAC;AAAE,GAC1E,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,qBAAqBA,QAAAA,KAAK,OACrC,EACE,MAAMA,QAAAA,KAAK,OAAO;CAAE,WAAW;CAAG,WAAW;CAAK,SAAS;AAA0B,CAAC,EACxF,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAM,oBAAoB;CACxB,IAAIA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAChC,MAAMA,QAAAA,KAAK,MAAM,qBAAqB,EAAE,UAAU,EAAE,CAAC;AACvD;AAEA,MAAa,sBAAsBA,QAAAA,KAAK,MAAM,CAC5CA,QAAAA,KAAK,OAAO;CAAE,GAAG;CAAmB,SAAS;AAAoB,GAAG,EAAE,sBAAsB,MAAM,CAAC,GACnGA,QAAAA,KAAK,OAAO;CAAE,GAAG;CAAmB,QAAQ;AAAmB,GAAG,EAAE,sBAAsB,MAAM,CAAC,CACnG,CAAC;AAaD,MAAa,qBAAqBA,QAAAA,KAAK,OAAO;CAC5C,WAAW;CACX,WAAW;CACX,SAAS;AACX,CAAC;AAED,MAAa,2BAA2BA,QAAAA,KAAK,OAC3C;CACE,QAAQ;CACR,UAAUA,QAAAA,KAAK,MAAM,mBAAmB;AAC1C,GACA,EAAE,sBAAsB,MAAM,CAChC"}

package/dist/src/schemas/leader.d.mts

@@ -1,4 +1,4 @@
-import { DoomExtensionContext } from "../../runtimeConfig.mjs";
+import { PoExtensionContext } from "../../runtimeConfig.mjs";
 import { Static, Type } from "typebox";
 //#region src/schemas/leader.d.ts
 /**
@@ -94,11 +94,11 @@ export interface LeaderContribution {
   source: string;
   bindings: readonly LeaderBinding[];
 }
-export interface DoomLeaderContributionHandle {
+export interface PoLeaderContributionHandle {
   update(bindings: readonly LeaderBinding[]): void;
   dispose(): void;
 }
-export interface DoomLeaderActionHandlerOptions<ExtensionContext extends DoomExtensionContext = DoomExtensionContext> {
+export interface PoLeaderActionHandlerOptions<ExtensionContext extends PoExtensionContext = PoExtensionContext> {
   source: string;
   handlers: Readonly<Record<string, (context: ExtensionContext) => void | Promise<void>>>;
   onError: (error: unknown, actionName: string, context: ExtensionContext) => void;

package/dist/src/schemas/leader.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"leader.d.mts","names":[],"sources":["../../../src/schemas/leader.ts"],"mappings":";;;;;;;;qBASa,kBAAgB,KAAA,QAAA,KAAA,qBAAA,KAAA;YACjB,aAAa,cAAc;qBAE1B,qBAAmB,KAAA;;;;;;;YAUpB,gBAAgB,cAAc;qBAE7B,qBAAmB,KAAA;;;;YAIpB,gBAAgB,cAAc;qBAE7B,oBAAkB,KAAA;;;YAMnB,eAAe,cAAc;qBAO5B,qBAAmB,KAAA,QAAA,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;YAIpB;EAEN;EACA,gBAAgB,kBAAkB;EAClC,SAAS;;EAGT;EACA,gBAAgB,kBAAkB;EAClC,QAAQ;;qBAGD,oBAAkB,KAAA;qBAMlB,0BAAwB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOpB;EACf;EACA,mBAAmB;;iBAGJ;EACf,OAAO,mBAAmB;EAC1B;;iBAGe,+BAA+B,yBAAyB,uBAAuB;EAC9F;EACA,UAAU,SAAS,gBAAgB,SAAS,4BAA4B;EACxE,UAAU,gBAAgB,oBAAoB,SAAS"}
+{"version":3,"file":"leader.d.mts","names":[],"sources":["../../../src/schemas/leader.ts"],"mappings":";;;;;;;;qBASa,kBAAgB,KAAA,QAAA,KAAA,qBAAA,KAAA;YACjB,aAAa,cAAc;qBAE1B,qBAAmB,KAAA;;;;;;;YAUpB,gBAAgB,cAAc;qBAE7B,qBAAmB,KAAA;;;;YAIpB,gBAAgB,cAAc;qBAE7B,oBAAkB,KAAA;QAAlB,KAAA;;YAMD,eAAe,cAAc;qBAO5B,qBAAmB,KAAA,QAAA,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;YAIpB;EAEN;EACA,gBAAgB,kBAAkB;EAClC,SAAS;;EAGT;EACA,gBAAgB,kBAAkB;EAClC,QAAQ;;qBAGD,oBAAkB,KAAA;qBAMlB,0BAAwB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOpB;EACf;EACA,mBAAmB;;iBAGJ;EACf,OAAO,mBAAmB;EAC1B;;iBAGe,6BAA6B,yBAAyB,qBAAqB;EAC1F;EACA,UAAU,SAAS,gBAAgB,SAAS,4BAA4B;EACxE,UAAU,gBAAgB,oBAAoB,SAAS"}

package/dist/src/schemas/leader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"leader.mjs","names":[],"sources":["../../../src/schemas/leader.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nimport type { DoomExtensionContext } from './config';\n\n/**\n * How the key badge is painted. `exit` marks the row that leaves an active minor\n * mode, which the panel colours differently so the reader can tell which way the\n * key flips without checking the mode line first.\n */\nexport const LeaderToneSchema = Type.Union([Type.Literal('default'), Type.Literal('exit')]);\nexport type LeaderTone = Static<typeof LeaderToneSchema>;\n\nexport const LeaderSegmentSchema = Type.Object(\n  {\n    key: Type.String({ minLength: 1, maxLength: 1 }),\n    label: Type.String({ minLength: 1 }),\n    detail: Type.Optional(Type.String()),\n    order: Type.Optional(Type.Integer()),\n    tone: Type.Optional(LeaderToneSchema),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderSegment = Static<typeof LeaderSegmentSchema>;\n\nexport const LeaderCommandSchema = Type.Object(\n  { name: Type.String({ minLength: 1 }), args: Type.Optional(Type.String()) },\n  { additionalProperties: false },\n);\nexport type LeaderCommand = Static<typeof LeaderCommandSchema>;\n\nexport const LeaderActionSchema = Type.Object(\n  {\n    name: Type.String({ minLength: 1, maxLength: 128, pattern: '^[a-z0-9][a-z0-9._:-]*$' }),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderAction = Static<typeof LeaderActionSchema>;\n\nconst LeaderBindingBase = {\n  id: Type.String({ minLength: 1 }),\n  path: Type.Array(LeaderSegmentSchema, { minItems: 1 }),\n};\n\nexport const LeaderBindingSchema = Type.Union([\n  Type.Object({ ...LeaderBindingBase, command: LeaderCommandSchema }, { additionalProperties: false }),\n  Type.Object({ ...LeaderBindingBase, action: LeaderActionSchema }, { additionalProperties: false }),\n]);\nexport type LeaderBinding =\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      command: LeaderCommand;\n    }\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      action: LeaderAction;\n    };\n\nexport const LeaderSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const LeaderContributionSchema = Type.Object(\n  {\n    source: LeaderSourceSchema,\n    bindings: Type.Array(LeaderBindingSchema),\n  },\n  { additionalProperties: false },\n);\nexport interface LeaderContribution {\n  source: string;\n  bindings: readonly LeaderBinding[];\n}\n\nexport interface DoomLeaderContributionHandle {\n  update(bindings: readonly LeaderBinding[]): void;\n  dispose(): void;\n}\n\nexport interface DoomLeaderActionHandlerOptions<ExtensionContext extends DoomExtensionContext = DoomExtensionContext> {\n  source: string;\n  handlers: Readonly<Record<string, (context: ExtensionContext) => void | Promise<void>>>;\n  onError: (error: unknown, actionName: string, context: ExtensionContext) => void;\n}\n"],"mappings":";;;;;;;AASA,MAAa,mBAAmB,KAAK,MAAM,CAAC,KAAK,QAAQ,SAAS,GAAG,KAAK,QAAQ,MAAM,CAAC,CAAC;AAG1F,MAAa,sBAAsB,KAAK,OACtC;CACE,KAAK,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAE,CAAC;CAC/C,OAAO,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CACnC,QAAQ,KAAK,SAAS,KAAK,OAAO,CAAC;CACnC,OAAO,KAAK,SAAS,KAAK,QAAQ,CAAC;CACnC,MAAM,KAAK,SAAS,gBAAgB;AACtC,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,sBAAsB,KAAK,OACtC;CAAE,MAAM,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAAG,MAAM,KAAK,SAAS,KAAK,OAAO,CAAC;AAAE,GAC1E,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,qBAAqB,KAAK,OACrC,EACE,MAAM,KAAK,OAAO;CAAE,WAAW;CAAG,WAAW;CAAK,SAAS;AAA0B,CAAC,EACxF,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAM,oBAAoB;CACxB,IAAI,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAChC,MAAM,KAAK,MAAM,qBAAqB,EAAE,UAAU,EAAE,CAAC;AACvD;AAEA,MAAa,sBAAsB,KAAK,MAAM,CAC5C,KAAK,OAAO;CAAE,GAAG;CAAmB,SAAS;AAAoB,GAAG,EAAE,sBAAsB,MAAM,CAAC,GACnG,KAAK,OAAO;CAAE,GAAG;CAAmB,QAAQ;AAAmB,GAAG,EAAE,sBAAsB,MAAM,CAAC,CACnG,CAAC;AAaD,MAAa,qBAAqB,KAAK,OAAO;CAC5C,WAAW;CACX,WAAW;CACX,SAAS;AACX,CAAC;AAED,MAAa,2BAA2B,KAAK,OAC3C;CACE,QAAQ;CACR,UAAU,KAAK,MAAM,mBAAmB;AAC1C,GACA,EAAE,sBAAsB,MAAM,CAChC"}
+{"version":3,"file":"leader.mjs","names":[],"sources":["../../../src/schemas/leader.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nimport type { PoExtensionContext } from './config';\n\n/**\n * How the key badge is painted. `exit` marks the row that leaves an active minor\n * mode, which the panel colours differently so the reader can tell which way the\n * key flips without checking the mode line first.\n */\nexport const LeaderToneSchema = Type.Union([Type.Literal('default'), Type.Literal('exit')]);\nexport type LeaderTone = Static<typeof LeaderToneSchema>;\n\nexport const LeaderSegmentSchema = Type.Object(\n  {\n    key: Type.String({ minLength: 1, maxLength: 1 }),\n    label: Type.String({ minLength: 1 }),\n    detail: Type.Optional(Type.String()),\n    order: Type.Optional(Type.Integer()),\n    tone: Type.Optional(LeaderToneSchema),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderSegment = Static<typeof LeaderSegmentSchema>;\n\nexport const LeaderCommandSchema = Type.Object(\n  { name: Type.String({ minLength: 1 }), args: Type.Optional(Type.String()) },\n  { additionalProperties: false },\n);\nexport type LeaderCommand = Static<typeof LeaderCommandSchema>;\n\nexport const LeaderActionSchema = Type.Object(\n  {\n    name: Type.String({ minLength: 1, maxLength: 128, pattern: '^[a-z0-9][a-z0-9._:-]*$' }),\n  },\n  { additionalProperties: false },\n);\nexport type LeaderAction = Static<typeof LeaderActionSchema>;\n\nconst LeaderBindingBase = {\n  id: Type.String({ minLength: 1 }),\n  path: Type.Array(LeaderSegmentSchema, { minItems: 1 }),\n};\n\nexport const LeaderBindingSchema = Type.Union([\n  Type.Object({ ...LeaderBindingBase, command: LeaderCommandSchema }, { additionalProperties: false }),\n  Type.Object({ ...LeaderBindingBase, action: LeaderActionSchema }, { additionalProperties: false }),\n]);\nexport type LeaderBinding =\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      command: LeaderCommand;\n    }\n  | {\n      id: string;\n      path: readonly [LeaderSegment, ...LeaderSegment[]];\n      action: LeaderAction;\n    };\n\nexport const LeaderSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const LeaderContributionSchema = Type.Object(\n  {\n    source: LeaderSourceSchema,\n    bindings: Type.Array(LeaderBindingSchema),\n  },\n  { additionalProperties: false },\n);\nexport interface LeaderContribution {\n  source: string;\n  bindings: readonly LeaderBinding[];\n}\n\nexport interface PoLeaderContributionHandle {\n  update(bindings: readonly LeaderBinding[]): void;\n  dispose(): void;\n}\n\nexport interface PoLeaderActionHandlerOptions<ExtensionContext extends PoExtensionContext = PoExtensionContext> {\n  source: string;\n  handlers: Readonly<Record<string, (context: ExtensionContext) => void | Promise<void>>>;\n  onError: (error: unknown, actionName: string, context: ExtensionContext) => void;\n}\n"],"mappings":";;;;;;;AASA,MAAa,mBAAmB,KAAK,MAAM,CAAC,KAAK,QAAQ,SAAS,GAAG,KAAK,QAAQ,MAAM,CAAC,CAAC;AAG1F,MAAa,sBAAsB,KAAK,OACtC;CACE,KAAK,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAE,CAAC;CAC/C,OAAO,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CACnC,QAAQ,KAAK,SAAS,KAAK,OAAO,CAAC;CACnC,OAAO,KAAK,SAAS,KAAK,QAAQ,CAAC;CACnC,MAAM,KAAK,SAAS,gBAAgB;AACtC,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,sBAAsB,KAAK,OACtC;CAAE,MAAM,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAAG,MAAM,KAAK,SAAS,KAAK,OAAO,CAAC;AAAE,GAC1E,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,qBAAqB,KAAK,OACrC,EACE,MAAM,KAAK,OAAO;CAAE,WAAW;CAAG,WAAW;CAAK,SAAS;AAA0B,CAAC,EACxF,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAM,oBAAoB;CACxB,IAAI,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAChC,MAAM,KAAK,MAAM,qBAAqB,EAAE,UAAU,EAAE,CAAC;AACvD;AAEA,MAAa,sBAAsB,KAAK,MAAM,CAC5C,KAAK,OAAO;CAAE,GAAG;CAAmB,SAAS;AAAoB,GAAG,EAAE,sBAAsB,MAAM,CAAC,GACnG,KAAK,OAAO;CAAE,GAAG;CAAmB,QAAQ;AAAmB,GAAG,EAAE,sBAAsB,MAAM,CAAC,CACnG,CAAC;AAaD,MAAa,qBAAqB,KAAK,OAAO;CAC5C,WAAW;CACX,WAAW;CACX,SAAS;AACX,CAAC;AAED,MAAa,2BAA2B,KAAK,OAC3C;CACE,QAAQ;CACR,UAAU,KAAK,MAAM,mBAAmB;AAC1C,GACA,EAAE,sBAAsB,MAAM,CAChC"}

package/dist/src/schemas/mcpBundle.d.mts

@@ -1,11 +1,11 @@
-import { DoomServerBundleOwner } from "./serverBundle.mjs";
+import { PoServerBundleOwner } from "./serverBundle.mjs";
 //#region src/schemas/mcpBundle.d.ts
-export interface DoomMcpBundleEntry {
+export interface PoMcpBundleEntry {
   readonly packageName: string;
   readonly entry: string;
   readonly module: string;
   readonly sha256: string;
-  readonly owners: readonly DoomServerBundleOwner[];
+  readonly owners: readonly PoServerBundleOwner[];
   /** Package-owned component keys generated from frontend tool declarations. */
   readonly widgets?: readonly string[];
 }

package/dist/src/schemas/mcpFacet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcpFacet.cjs","names":[],"sources":["../../../src/schemas/mcpFacet.ts"],"sourcesContent":["import type { TSchema } from 'typebox';\n\nimport type {\n  DoomHeadlessExecutionContext,\n  DoomHeadlessSelection,\n  DoomHeadlessSelectionChange,\n  DoomHeadlessTool,\n} from './headless';\n\n/** Repository-scoped instructions and applied selection safe to disclose to a remote MCP client. */\nexport interface DoomMcpContextSnapshot {\n  readonly session: { readonly id: string; readonly revision: number };\n  readonly repository: { readonly root: string; readonly cwd: string };\n  readonly selection: {\n    readonly profile: string | null;\n    readonly domains: readonly string[];\n    readonly majorMode: string;\n    readonly activeLayers: readonly string[];\n    readonly minorModes?: readonly string[];\n  };\n  readonly instructions: readonly { readonly path: string; readonly content: string }[];\n  readonly persona: string | null;\n}\n\n/** A lazy Markdown resource available only to remote MCP clients. */\nexport interface DoomMcpSkill {\n  readonly name: string;\n  readonly description: string;\n  read(context: DoomHeadlessExecutionContext): string | Promise<string>;\n}\n\n/** A package-owned, immutable UI template. Session data belongs in tool results, never in this HTML. */\nexport interface DoomMcpUiResource {\n  readonly uri: string;\n  readonly name: string;\n  readonly description?: string;\n  readonly mimeType: 'text/html;profile=mcp-app';\n  readonly _meta?: Record<string, unknown> & {\n    ui?: {\n      csp?: {\n        connectDomains?: string[];\n        resourceDomains?: string[];\n        frameDomains?: string[];\n        baseUriDomains?: string[];\n      };\n      domain?: string;\n      prefersBorder?: boolean;\n    };\n  };\n  /** Loads static packaged HTML without an execution context. */\n  read(): string | Promise<string>;\n}\n\n/** A dedicated remote surface, deliberately separate from local agent registrations. */\nexport interface DoomMcpSessionPlugin {\n  readonly tools?: readonly DoomHeadlessTool<TSchema>[];\n  readonly skills?: readonly DoomMcpSkill[];\n  readonly uiResources?: readonly DoomMcpUiResource[];\n}\n\nexport interface DoomMcpServiceScope {\n  /** Reads a service already mounted in this session without exposing host registration APIs. */\n  get<T>(name: string): T | undefined;\n}\n\nexport interface DoomMcpPluginContext {\n  readonly execution: DoomHeadlessExecutionContext;\n  readonly services: DoomMcpServiceScope;\n  readonly selection: {\n    read(): DoomHeadlessSelection;\n    change(change: DoomHeadlessSelectionChange): Promise<void>;\n  };\n  /** Reads the allowlisted repository context from the current applied session selection. */\n  loadContext(): DoomMcpContextSnapshot;\n  /** Aborted when this plugin surface is replaced or the session closes. */\n  readonly signal: AbortSignal;\n  /** Rebuilds the remote surface after a live MCP catalog changes. */\n  refresh(): void;\n}\n\nexport interface DoomMcpPluginDefinition {\n  readonly name: string;\n  readonly session:\n    | DoomMcpSessionPlugin\n    | ((context: DoomMcpPluginContext) => DoomMcpSessionPlugin | Promise<DoomMcpSessionPlugin>);\n}\n\n/** Makes an MCP declaration's contract explicit without registering it locally. */\nexport function defineMcpPlugin(definition: DoomMcpPluginDefinition): DoomMcpPluginDefinition {\n  return definition;\n}\n\n/** `tool/[name].mcp.ts`. Keeps the declaration independently typed. */\nexport function defineMcpTool<TParameters extends TSchema = TSchema, TContext = unknown>(\n  tool: DoomHeadlessTool<TParameters> | ((context: TContext) => DoomHeadlessTool<TParameters>),\n): DoomHeadlessTool<TParameters> | ((context: TContext) => DoomHeadlessTool<TParameters>) {\n  return tool;\n}\n\n/** `skill/[name].mcp.ts`. Keeps remote guidance out of the local prompt surface. */\nexport function defineMcpSkill<TContext = unknown>(\n  skill: DoomMcpSkill | ((context: TContext) => DoomMcpSkill),\n): DoomMcpSkill | ((context: TContext) => DoomMcpSkill) {\n  return skill;\n}\n\n/** `resource/[name].mcp.ts`. Static UI resources stay separate from session guidance. */\nexport function defineMcpUiResource(resource: DoomMcpUiResource): DoomMcpUiResource {\n  return resource;\n}\n"],"mappings":";;AAwFA,SAAgB,gBAAgB,YAA8D;CAC5F,OAAO;AACT;;AAGA,SAAgB,cACd,MACwF;CACxF,OAAO;AACT;;AAGA,SAAgB,eACd,OACsD;CACtD,OAAO;AACT;;AAGA,SAAgB,oBAAoB,UAAgD;CAClF,OAAO;AACT"}
+{"version":3,"file":"mcpFacet.cjs","names":[],"sources":["../../../src/schemas/mcpFacet.ts"],"sourcesContent":["import type { TSchema } from 'typebox';\n\nimport type {\n  PoHeadlessExecutionContext,\n  PoHeadlessSelection,\n  PoHeadlessSelectionChange,\n  PoHeadlessTool,\n} from './headless';\n\n/** Repository-scoped instructions and applied selection safe to disclose to a remote MCP client. */\nexport interface PoMcpContextSnapshot {\n  readonly session: { readonly id: string; readonly revision: number };\n  readonly repository: { readonly root: string; readonly cwd: string };\n  readonly selection: {\n    readonly profile: string | null;\n    readonly domains: readonly string[];\n    readonly majorMode: string;\n    readonly activeLayers: readonly string[];\n    readonly minorModes?: readonly string[];\n  };\n  readonly instructions: readonly { readonly path: string; readonly content: string }[];\n  readonly persona: string | null;\n}\n\n/** A lazy Markdown resource available only to remote MCP clients. */\nexport interface PoMcpSkill {\n  readonly name: string;\n  readonly description: string;\n  read(context: PoHeadlessExecutionContext): string | Promise<string>;\n}\n\n/** A package-owned, immutable UI template. Session data belongs in tool results, never in this HTML. */\nexport interface PoMcpUiResource {\n  readonly uri: string;\n  readonly name: string;\n  readonly description?: string;\n  readonly mimeType: 'text/html;profile=mcp-app';\n  readonly _meta?: Record<string, unknown> & {\n    ui?: {\n      csp?: {\n        connectDomains?: string[];\n        resourceDomains?: string[];\n        frameDomains?: string[];\n        baseUriDomains?: string[];\n      };\n      domain?: string;\n      prefersBorder?: boolean;\n    };\n  };\n  /** Loads static packaged HTML without an execution context. */\n  read(): string | Promise<string>;\n}\n\n/** A dedicated remote surface, deliberately separate from local agent registrations. */\nexport interface PoMcpSessionPlugin {\n  readonly tools?: readonly PoHeadlessTool<TSchema>[];\n  readonly skills?: readonly PoMcpSkill[];\n  readonly uiResources?: readonly PoMcpUiResource[];\n}\n\nexport interface PoMcpServiceScope {\n  /** Reads a service already mounted in this session without exposing host registration APIs. */\n  get<T>(name: string): T | undefined;\n}\n\nexport interface PoMcpPluginContext {\n  readonly execution: PoHeadlessExecutionContext;\n  readonly services: PoMcpServiceScope;\n  readonly selection: {\n    read(): PoHeadlessSelection;\n    change(change: PoHeadlessSelectionChange): Promise<void>;\n  };\n  /** Reads the allowlisted repository context from the current applied session selection. */\n  loadContext(): PoMcpContextSnapshot;\n  /** Aborted when this plugin surface is replaced or the session closes. */\n  readonly signal: AbortSignal;\n  /** Rebuilds the remote surface after a live MCP catalog changes. */\n  refresh(): void;\n}\n\nexport interface PoMcpPluginDefinition {\n  readonly name: string;\n  readonly session:\n    | PoMcpSessionPlugin\n    | ((context: PoMcpPluginContext) => PoMcpSessionPlugin | Promise<PoMcpSessionPlugin>);\n}\n\n/** Makes an MCP declaration's contract explicit without registering it locally. */\nexport function defineMcpPlugin(definition: PoMcpPluginDefinition): PoMcpPluginDefinition {\n  return definition;\n}\n\n/** `tool/[name].mcp.ts`. Keeps the declaration independently typed. */\nexport function defineMcpTool<TParameters extends TSchema = TSchema, TContext = unknown>(\n  tool: PoHeadlessTool<TParameters> | ((context: TContext) => PoHeadlessTool<TParameters>),\n): PoHeadlessTool<TParameters> | ((context: TContext) => PoHeadlessTool<TParameters>) {\n  return tool;\n}\n\n/** `skill/[name].mcp.ts`. Keeps remote guidance out of the local prompt surface. */\nexport function defineMcpSkill<TContext = unknown>(\n  skill: PoMcpSkill | ((context: TContext) => PoMcpSkill),\n): PoMcpSkill | ((context: TContext) => PoMcpSkill) {\n  return skill;\n}\n\n/** `resource/[name].mcp.ts`. Static UI resources stay separate from session guidance. */\nexport function defineMcpUiResource(resource: PoMcpUiResource): PoMcpUiResource {\n  return resource;\n}\n"],"mappings":";;AAwFA,SAAgB,gBAAgB,YAA0D;CACxF,OAAO;AACT;;AAGA,SAAgB,cACd,MACoF;CACpF,OAAO;AACT;;AAGA,SAAgB,eACd,OACkD;CAClD,OAAO;AACT;;AAGA,SAAgB,oBAAoB,UAA4C;CAC9E,OAAO;AACT"}

package/dist/src/schemas/mcpFacet.d.mts

@@ -1,8 +1,8 @@
-import { DoomHeadlessExecutionContext, DoomHeadlessSelection, DoomHeadlessSelectionChange, DoomHeadlessTool } from "./headless.mjs";
+import { PoHeadlessExecutionContext, PoHeadlessSelection, PoHeadlessSelectionChange, PoHeadlessTool } from "./headless.mjs";
 import { TSchema } from "typebox";
 //#region src/schemas/mcpFacet.d.ts
 /** Repository-scoped instructions and applied selection safe to disclose to a remote MCP client. */
-export interface DoomMcpContextSnapshot {
+export interface PoMcpContextSnapshot {
   readonly session: {
     readonly id: string;
     readonly revision: number;
@@ -25,13 +25,13 @@ export interface DoomMcpContextSnapshot {
   readonly persona: string | null;
 }
 /** A lazy Markdown resource available only to remote MCP clients. */
-export interface DoomMcpSkill {
+export interface PoMcpSkill {
   readonly name: string;
   readonly description: string;
-  read(context: DoomHeadlessExecutionContext): string | Promise<string>;
+  read(context: PoHeadlessExecutionContext): string | Promise<string>;
 }
 /** A package-owned, immutable UI template. Session data belongs in tool results, never in this HTML. */
-export interface DoomMcpUiResource {
+export interface PoMcpUiResource {
   readonly uri: string;
   readonly name: string;
   readonly description?: string;
@@ -52,40 +52,40 @@ export interface DoomMcpUiResource {
   read(): string | Promise<string>;
 }
 /** A dedicated remote surface, deliberately separate from local agent registrations. */
-export interface DoomMcpSessionPlugin {
-  readonly tools?: readonly DoomHeadlessTool<TSchema>[];
-  readonly skills?: readonly DoomMcpSkill[];
-  readonly uiResources?: readonly DoomMcpUiResource[];
+export interface PoMcpSessionPlugin {
+  readonly tools?: readonly PoHeadlessTool<TSchema>[];
+  readonly skills?: readonly PoMcpSkill[];
+  readonly uiResources?: readonly PoMcpUiResource[];
 }
-export interface DoomMcpServiceScope {
+export interface PoMcpServiceScope {
   /** Reads a service already mounted in this session without exposing host registration APIs. */
   get<T>(name: string): T | undefined;
 }
-export interface DoomMcpPluginContext {
-  readonly execution: DoomHeadlessExecutionContext;
-  readonly services: DoomMcpServiceScope;
+export interface PoMcpPluginContext {
+  readonly execution: PoHeadlessExecutionContext;
+  readonly services: PoMcpServiceScope;
   readonly selection: {
-    read(): DoomHeadlessSelection;
-    change(change: DoomHeadlessSelectionChange): Promise<void>;
+    read(): PoHeadlessSelection;
+    change(change: PoHeadlessSelectionChange): Promise<void>;
   };
   /** Reads the allowlisted repository context from the current applied session selection. */
-  loadContext(): DoomMcpContextSnapshot;
+  loadContext(): PoMcpContextSnapshot;
   /** Aborted when this plugin surface is replaced or the session closes. */
   readonly signal: AbortSignal;
   /** Rebuilds the remote surface after a live MCP catalog changes. */
   refresh(): void;
 }
-export interface DoomMcpPluginDefinition {
+export interface PoMcpPluginDefinition {
   readonly name: string;
-  readonly session: DoomMcpSessionPlugin | ((context: DoomMcpPluginContext) => DoomMcpSessionPlugin | Promise<DoomMcpSessionPlugin>);
+  readonly session: PoMcpSessionPlugin | ((context: PoMcpPluginContext) => PoMcpSessionPlugin | Promise<PoMcpSessionPlugin>);
 }
 /** Makes an MCP declaration's contract explicit without registering it locally. */
-export declare function defineMcpPlugin(definition: DoomMcpPluginDefinition): DoomMcpPluginDefinition;
+export declare function defineMcpPlugin(definition: PoMcpPluginDefinition): PoMcpPluginDefinition;
 /** `tool/[name].mcp.ts`. Keeps the declaration independently typed. */
-export declare function defineMcpTool<TParameters extends TSchema = TSchema, TContext = unknown>(tool: DoomHeadlessTool<TParameters> | ((context: TContext) => DoomHeadlessTool<TParameters>)): DoomHeadlessTool<TParameters> | ((context: TContext) => DoomHeadlessTool<TParameters>);
+export declare function defineMcpTool<TParameters extends TSchema = TSchema, TContext = unknown>(tool: PoHeadlessTool<TParameters> | ((context: TContext) => PoHeadlessTool<TParameters>)): PoHeadlessTool<TParameters> | ((context: TContext) => PoHeadlessTool<TParameters>);
 /** `skill/[name].mcp.ts`. Keeps remote guidance out of the local prompt surface. */
-export declare function defineMcpSkill<TContext = unknown>(skill: DoomMcpSkill | ((context: TContext) => DoomMcpSkill)): DoomMcpSkill | ((context: TContext) => DoomMcpSkill);
+export declare function defineMcpSkill<TContext = unknown>(skill: PoMcpSkill | ((context: TContext) => PoMcpSkill)): PoMcpSkill | ((context: TContext) => PoMcpSkill);
 /** `resource/[name].mcp.ts`. Static UI resources stay separate from session guidance. */
-export declare function defineMcpUiResource(resource: DoomMcpUiResource): DoomMcpUiResource;
+export declare function defineMcpUiResource(resource: PoMcpUiResource): PoMcpUiResource;
 //#endregion
 //# sourceMappingURL=mcpFacet.d.mts.map