@agimon-ai/po-web-dashboard 0.0.0-alpha.0

package/dist/types/hub.d.mts

@@ -0,0 +1,447 @@
+import { BridgeState, SessionFrame } from "./session.mjs";
+//#region src/types/hub.d.ts
+/**
+ * Wire vocabulary between the hub and its pages.
+ *
+ * One WebSocket carries every session: hub-level frames describe the set of
+ * sessions, and session-scoped traffic travels enveloped with the session id.
+ * Field naming follows @earendil-works/pi-protocol so a future swap to the
+ * upstream session server stays a transport change, not a rename.
+ */
+export declare const HUB_PROTOCOL_VERSION = 2;
+/** Role marker in the health payload; po-server probes for it before binding the port. */
+export declare const HUB_ROLE = "hub";
+/** REST endpoint for admitting and listing durable workspaces. */
+export declare const WORKSPACES_API_ROUTE = "/api/workspaces";
+/** REST endpoint for creating sessions and browsing resumable Pi history. */
+export declare const SESSIONS_API_ROUTE = "/api/workspaces/:workspaceId/sessions";
+/** One durable repository workspace shown in the rail, even while it has no sessions. */
+export interface WorkspaceSummary {
+  id: string;
+  root: string;
+  /** Display name chosen when the workspace was added; the folder basename stands in when absent. */
+  name?: string;
+  /** A remembered workspace whose root could not be mounted on this server start. */
+  available?: boolean;
+  error?: string;
+}
+/** One inactive Pi thread available to resume in a live session's workspace. */
+export interface PiSessionHistoryItem {
+  id: string;
+  name?: string;
+  firstMessage: string;
+  createdAt: string;
+  updatedAt: string;
+  messageCount: number;
+}
+/**
+ * REST endpoint behind the new-session directory picker; the page sends the
+ * typed path as ?q= and receives {directories}: the children of the parent
+ * directory whose names match the trailing segment as a regular expression.
+ */
+export declare const DIRECTORIES_API_ROUTE = "/api/directories";
+/** Lists the visible child folders of ?path= (home when absent) for the workspace folder browser. */
+export declare const DIRECTORY_CHILDREN_API_ROUTE = "/api/directories/children";
+/** One folder's visible child directories, as absolute paths. */
+export interface DirectoryListing {
+  path: string;
+  parent?: string;
+  directories: string[];
+}
+/**
+ * Query parameter that routes a package API request to one session's server.
+ * Without it the request is answered by a hub-scoped API in this process.
+ */
+export declare const API_SESSION_QUERY_PARAM = "session";
+/** What the agent is doing right now, derived from its frame stream. */
+export type SessionPhase = 'idle' | 'turn' | 'compaction' | 'retry';
+export interface SessionProfile {
+  name: string;
+  displayName?: string;
+  /** Changes whenever the icon does; absent when the profile has no icon. */
+  iconVersion?: string;
+}
+export interface SessionGitStatus {
+  branch: string;
+  /** True when the working tree has uncommitted changes; rendered as a star. */
+  dirty: boolean;
+}
+/** One immutable, signed client composition resolved for a session. */
+export interface SessionWebComposition {
+  /** Stable identity of the synchronized root and generation. */
+  id: string;
+  /** Monotonic signing revision advertised by the manifest. */
+  revision: number;
+  /** Same-origin signed-manifest route read by the trusted service worker. */
+  manifestUrl: string;
+  /** Same-origin prefix for the untrusted source bytes verified by the worker. */
+  rawAssetBaseUrl: string;
+  /** Worker-owned prefix from which the page may execute verified bytes. */
+  verifiedAssetBaseUrl: string;
+  /** `[slot, entry]` per plugin copy this mount runs, each entry an absolute path below both asset prefixes. */
+  pluginEntries: [string, string][];
+  /** Absolute paths below both asset prefixes of every file this mount's slots can load. */
+  assetPaths: string[];
+  /** Absolute paths below both asset prefixes, replaced when this session is focused. */
+  stylePaths: string[];
+  /** Frame types owned by the matching session-local hub composition. */
+  channels: string[];
+  /**
+   * The slots this mount runs out of a shared build. Absent means the composition
+   * holds only this mount's plugins, as in-memory test hosts publish it.
+   */
+  plugins?: string[];
+}
+/** One immutable, signed native composition resolved for a session; read by po-native, ignored by the web. */
+export interface SessionNativeComposition {
+  /** Stable identity of the synchronized root and generation. */
+  id: string;
+  scope: 'global' | 'workspace' | 'session';
+  /** Monotonic signing revision advertised by the manifest. */
+  revision: number;
+  manifestUrl: string;
+  rawAssetBaseUrl: string;
+  /** Always `/composition.js`. */
+  entryPath: string;
+  channels: string[];
+  /** The `poNative.pluginId` values resolved for this mount; the shell installs only these. */
+  plugins: string[];
+}
+/**
+ * Everything the rail needs to render one session without subscribing to it.
+ */
+export interface SessionSummary {
+  workspaceId?: string;
+  id: string;
+  name: string;
+  cwd: string;
+  /** ISO 8601, from the session's registry record. */
+  createdAt: string;
+  /** ISO 8601, bumped whenever the session's frame stream moves. */
+  updatedAt: string;
+  phase: SessionPhase;
+  /** ISO 8601 timestamp of the last phase change; drives "running · 12m". */
+  phaseSince: string;
+  /** The hub's own attachment to the session socket. */
+  attach: BridgeState;
+  /** Human-readable cause, present when attach is refused or closed. */
+  attachReason?: string;
+  pendingMessageCount: number;
+  /** False until the first prompt is forwarded; "fresh session · nothing sent yet". */
+  everPrompted: boolean;
+  /** True while the agent waits on a dialog answer; "waiting for your input". */
+  awaitingInput: boolean;
+  /** ISO 8601 of the last settled run, once one finished. */
+  lastSettledAt?: string;
+  /** Omitted when the cwd is not a git repository or git is unavailable. */
+  git?: SessionGitStatus;
+  /** Selected profile; the icon itself is served by the session avatar route. */
+  profile?: SessionProfile;
+  /** Signed plugin composition independently resolved for this session. */
+  webComposition?: SessionWebComposition;
+  /** Signed native composition for this session, when native targets were built. */
+  nativeComposition?: SessionNativeComposition;
+  /**
+   * The session this one was spawned from, recorded by the hub when it opened the session.
+   * The rail nests a session under its parent; absent means a top-level row.
+   */
+  parentSessionId?: string;
+  /**
+   * The spawning package's own label for the relationship, such as "worktree".
+   * The hub does not interpret it; the rail uses it to pick an affordance.
+   */
+  sessionProvenance?: string;
+  /** Host reservations awaiting a durable child runtime, not live sessions. */
+  pendingSetups?: Array<{
+    id: string;
+    name: string;
+    createdAt: string;
+    cwd?: string;
+    status?: 'provisioning' | 'failed' | 'interrupted';
+    setupKind?: 'managed-worktree' | 'existing-directory';
+    errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';
+  }>;
+  /**
+   * One line an extension published about background work it runs for this
+   * session, such as a workflow; the rail shows it in place of the idle copy.
+   */
+  activity?: {
+    label: string;
+    attention?: boolean;
+    since?: string;
+  };
+  /**
+   * The hub recorded this session but has not reopened it since its last
+   * restart. Its journal is on disk; nothing is running behind the card until
+   * the page asks for it.
+   */
+  dormant?: boolean;
+}
+export declare const HUB_HELLO_TYPE = "hub_hello";
+export declare const WORKSPACES_SNAPSHOT_TYPE = "workspaces_snapshot";
+export declare const WORKSPACE_UPSERT_TYPE = "workspace_upsert";
+export declare const WORKSPACE_REMOVED_TYPE = "workspace_removed";
+export declare const SESSIONS_SNAPSHOT_TYPE = "sessions_snapshot";
+export declare const SESSION_UPSERT_TYPE = "session_upsert";
+export declare const SESSION_REMOVED_TYPE = "session_removed";
+export declare const SESSION_BACKLOG_TYPE = "session_backlog";
+export declare const SESSION_FRAME_TYPE = "session_frame";
+/** Hub-synthesized close for an answered dialog; Pi itself never announces one. */
+export declare const DIALOG_ANSWERED_TYPE = "extension_ui_answered";
+/**
+ * Sync rebuilt the artifacts this page is running against.
+ *
+ * The plugin bundle the browser loaded is one of them, and a bundle only
+ * changes on disk: nothing about the running page notices. The page reloads
+ * itself rather than staying on surfaces the repository no longer describes.
+ */
+export declare const HUB_RESYNCED_TYPE = "hub_resynced";
+/**
+ * The custom session entry the Po runtime journals with its minor-mode
+ * catalog projection; it arrives inside Pi's entry_appended frames. The shape
+ * mirrors MinorModeProjection in po-minor-mode.
+ */
+export declare const MINOR_MODE_ENTRY_TYPE = "doom-minor-modes";
+/**
+ * The custom session entry the Po runtime journals when the agent's model
+ * changes without a client having asked for it. The shape mirrors
+ * AgentModelProjection in po-core.
+ *
+ * Pi reports a thinking-level switch on the wire, so that field follows from
+ * the frame alone. It has no wire event for the model, so plan mode applying
+ * its configured planning model would otherwise leave the chip naming the
+ * model the session left behind.
+ */
+export declare const AGENT_MODEL_ENTRY_TYPE = "doom-agent-model";
+/**
+ * The custom session entry Po journals describing what the session is
+ * composed of: which mode admitted each tool and skill, and what each costs.
+ *
+ * Schemas are deliberately absent. Only names, kinds, owners and integer token
+ * counts travel, so republishing the whole composition stays cheap.
+ */
+export declare const CONTEXT_ENTRY_TYPE = "doom-context";
+/**
+ * The custom session entry po-profile journals naming the persona the
+ * session speaks as. The shape mirrors ProfileIdentityProjection in
+ * po-core.
+ *
+ * Unlike the entries above, this one is transcript rather than projection: it
+ * stays in journal order and is never collapsed to the latest record, because a
+ * message keeps the persona it was written under. Adding it to
+ * PROJECTION_ENTRY_TYPES would repaint the whole transcript on every switch.
+ */
+export declare const PROFILE_IDENTITY_ENTRY_TYPE = "doom-profile-identity";
+/**
+ * The custom session entry po-domain journals once Pi has rebuilt its
+ * resource catalog for a reload; it mirrors DOOM_RESOURCE_CATALOG_ENTRY_TYPE in
+ * po-core.
+ *
+ * A reload is what changes the skills the composer offers under `$`, and Pi
+ * reports nothing else for one, so this entry is the cockpit's only notice that
+ * the command list it cached belongs to the previous selection.
+ */
+export declare const RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+export interface MinorModeActionProjection {
+  id: string;
+  label: string;
+  description: string;
+  enabled: boolean;
+  disabledReason?: string;
+  needsInput: boolean;
+}
+export interface MinorModeRecordProjection {
+  id: string;
+  label: string;
+  description: string;
+  order: number;
+  activation: 'inactive' | 'activating' | 'active' | 'deactivating';
+  condition: string;
+  detail?: string;
+  actions: MinorModeActionProjection[];
+}
+export interface MinorModeProjection {
+  version: 1;
+  revision: number;
+  modes: MinorModeRecordProjection[];
+}
+export type ContextGroupKind = 'major' | 'minor' | 'domain' | 'core';
+export type ContextItemSource = 'extension' | 'mcp' | 'plugin' | 'core';
+export interface ContextItemProjection {
+  name: string;
+  itemKind: 'tool' | 'skill';
+  source: ContextItemSource;
+  owner: string;
+  tokens: number;
+  active: boolean;
+}
+export interface ContextGroupProjection {
+  id: string;
+  label: string;
+  kind: ContextGroupKind;
+  items: ContextItemProjection[];
+  /** What the group costs now: active items only. */
+  tokens: number;
+  /** What its gated items would add if switched on. */
+  inactiveTokens: number;
+}
+export interface ContextProjection {
+  version: 1;
+  revision: number;
+  selection?: {
+    majorMode: string;
+    domains: string[];
+    profile?: string;
+  };
+  groups: ContextGroupProjection[];
+  totalTokens: number;
+  inactiveTokens: number;
+  /**
+   * What the assembled system prompt costs, deliberately outside the groups.
+   *
+   * Every tool's prose and every skill's listing already count inside
+   * `totalTokens`, and those are slices of this same text, so the two figures
+   * overlap and must not be added. `stage` is `base` when the session has sent
+   * nothing yet and the prompt shown is the one before packages patch it.
+   */
+  systemPrompt?: {
+    tokens: number;
+    stage: 'base' | 'effective';
+  };
+  /** Names the tokenizer, because the figures are indicative, not billed. */
+  estimator: string;
+}
+export declare const SUBSCRIBE_TYPE = "subscribe";
+export declare const UNSUBSCRIBE_TYPE = "unsubscribe";
+export declare const SESSION_COMMAND_TYPE = "session_command";
+/** A page follows one thread of a session: a journal a plugin's hub source names, such as a subagent run. */
+export declare const SUBSCRIBE_THREAD_TYPE = "subscribe_thread";
+export declare const UNSUBSCRIBE_THREAD_TYPE = "unsubscribe_thread";
+export declare const THREAD_BACKLOG_TYPE = "thread_backlog";
+export declare const THREAD_FRAME_TYPE = "thread_frame";
+/** A page asks for the transcript before what it already holds. */
+export declare const HISTORY_REQUEST_TYPE = "history_request";
+/** One older window, oldest first, answering a history_request. */
+export declare const HISTORY_PAGE_TYPE = "history_page";
+/**
+ * How many journalled messages one page carries. Small enough that prepending
+ * a window never blocks the reader's scroll, large enough that a flick through
+ * a long transcript does not turn into a hundred round trips.
+ */
+export declare const HISTORY_PAGE_SIZE = 100;
+export interface HistoryRequestFrame {
+  type: typeof HISTORY_REQUEST_TYPE;
+  sessionId: string;
+  /** Journal id of the oldest entry the page holds; absent asks for the newest window. */
+  before?: string;
+  limit?: number;
+}
+export interface HistoryPageFrame {
+  type: typeof HISTORY_PAGE_TYPE;
+  sessionId: string;
+  /** Entry frames, oldest first, to prepend above what the page holds. */
+  frames: Record<string, unknown>[];
+  /** The cursor for the next older window; null when the transcript starts here. */
+  cursor: string | null;
+  /** Whether anything older than this window exists. */
+  hasMore: boolean;
+  /** Echoed so a page can drop an answer to a question it has since abandoned. */
+  before?: string;
+}
+/** First frame on every page socket, before the snapshot. */
+export interface HubHelloFrame {
+  type: typeof HUB_HELLO_TYPE;
+  protocol: number;
+  /** Frame types of the hub's loaded data channels; lets a panel tell "plugin server not installed" from "no data". */
+  channels: string[];
+}
+export interface WorkspacesSnapshotFrame {
+  type: typeof WORKSPACES_SNAPSHOT_TYPE;
+  workspaces: WorkspaceSummary[];
+}
+export interface WorkspaceUpsertFrame {
+  type: typeof WORKSPACE_UPSERT_TYPE;
+  workspace: WorkspaceSummary;
+}
+export interface WorkspaceRemovedFrame {
+  type: typeof WORKSPACE_REMOVED_TYPE;
+  workspaceId: string;
+}
+export interface SessionsSnapshotFrame {
+  type: typeof SESSIONS_SNAPSHOT_TYPE;
+  sessions: SessionSummary[];
+}
+export interface SessionUpsertFrame {
+  type: typeof SESSION_UPSERT_TYPE;
+  session: SessionSummary;
+}
+export interface SessionRemovedFrame {
+  type: typeof SESSION_REMOVED_TYPE;
+  sessionId: string;
+}
+/**
+ * Reply to subscribe: this session's latest status and widget projections first,
+ * then its bounded transient history. Live frames follow.
+ */
+export interface SessionBacklogFrame {
+  type: typeof SESSION_BACKLOG_TYPE;
+  sessionId: string;
+  frames: SessionFrame[];
+  /** Transient frames the bounded ring discarded; projections do not contribute. */
+  dropped: number;
+}
+/** One live agent frame, addressed to subscribers of its session. */
+export interface SessionFrameEnvelope {
+  type: typeof SESSION_FRAME_TYPE;
+  sessionId: string;
+  frame: SessionFrame;
+}
+export interface SubscribeFrame {
+  type: typeof SUBSCRIBE_TYPE;
+  sessionId: string;
+}
+export interface UnsubscribeFrame {
+  type: typeof UNSUBSCRIBE_TYPE;
+  sessionId: string;
+}
+/** One command frame from the page, addressed to a session's agent. */
+export interface SessionCommandFrame {
+  type: typeof SESSION_COMMAND_TYPE;
+  sessionId: string;
+  frame: SessionFrame;
+}
+export declare function hubHello(channels: string[]): HubHelloFrame;
+export declare function sessionFrameEnvelope(sessionId: string, frame: SessionFrame): SessionFrameEnvelope;
+export declare function sessionCommand(sessionId: string, frame: SessionFrame): SessionCommandFrame;
+export declare function subscribeFrame(sessionId: string): SubscribeFrame;
+export declare function unsubscribeFrame(sessionId: string): UnsubscribeFrame;
+export interface SubscribeThreadFrame {
+  type: typeof SUBSCRIBE_THREAD_TYPE;
+  sessionId: string;
+  threadId: string;
+}
+export interface UnsubscribeThreadFrame {
+  type: typeof UNSUBSCRIBE_THREAD_TYPE;
+  sessionId: string;
+  threadId: string;
+}
+/** Reply to subscribe_thread: the journal's newest entries as entry_appended frames, then live ones follow. */
+export interface ThreadBacklogFrame {
+  type: typeof THREAD_BACKLOG_TYPE;
+  sessionId: string;
+  threadId: string;
+  frames: SessionFrame[];
+}
+/** One journal entry a followed thread gained, addressed to the pages following it. */
+export interface ThreadFrameEnvelope {
+  type: typeof THREAD_FRAME_TYPE;
+  sessionId: string;
+  threadId: string;
+  frame: SessionFrame;
+}
+export declare function subscribeThreadFrame(sessionId: string, threadId: string): SubscribeThreadFrame;
+export declare function unsubscribeThreadFrame(sessionId: string, threadId: string): UnsubscribeThreadFrame;
+export declare function threadBacklog(sessionId: string, threadId: string, frames: SessionFrame[]): ThreadBacklogFrame;
+export declare function threadFrameEnvelope(sessionId: string, threadId: string, frame: SessionFrame): ThreadFrameEnvelope;
+//#endregion
+//# sourceMappingURL=hub.d.mts.map

package/dist/types/hub.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.mts","names":[],"sources":["../../src/types/hub.ts"],"mappings":";;;;;;;;;;qBAUa;;qBAGA;;qBAGA;;qBAGA;;iBAGI;EACf;EACA;;EAEA;;EAEA;EACA;;;iBAIe;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;;qBAQW;;qBAGA;;iBAGI;EACf;EACA;EACA;;;;;;qBAOW;;YAGD;iBAEK;EACf;EACA;;EAEA;;iBAGe;EACf;;EAEA;;;iBAIe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;EAKA;;;iBAIe;;EAEf;EACA;;EAEA;EACA;EACA;;EAEA;EACA;;EAEA;;;;;iBAMe;EACf;EACA;EACA;EACA;;EAEA;;EAEA;EACA,OAAO;;EAEP;;EAEA,QAAQ;;EAER;EACA;;EAEA;;EAEA;;EAEA;;EAEA,MAAM;;EAEN,UAAU;;EAEV,iBAAiB;;EAEjB,oBAAoB;;;;;EAKpB;;;;;EAKA;;EAEA,gBAAgB;IACd;IACA;IACA;IACA;IACA;IACA;IACA;;;;;;EAMF;IAAa;IAAe;IAAqB;;;;;;;EAMjD;;qBAGW;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;;qBAEA;;;;;;;;qBAQA;;;;;;qBAOA;;;;;;;;;;;qBAYA;;;;;;;;qBAQA;;;;;;;;;;;qBAYA;;;;;;;;;;qBAUA;iBACI;EACf;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS;;iBAGM;EACf;EACA;EACA,OAAO;;YAGG;YACA;iBAEK;EACf;EACA;EACA,QAAQ;EACR;EACA;EACA;;iBAGe;EACf;EACA;EACA,MAAM;EACN,OAAO;;EAEP;;EAEA;;iBAGe;EACf;EACA;EACA;IAAc;IAAmB;IAAmB;;EACpD,QAAQ;EACR;EACA;;;;;;;;;EASA;IAAiB;IAAgB;;;EAEjC;;qBAEW;qBACA;qBACA;;qBAEA;qBACA;qBACA;qBACA;;qBAGA;;qBAEA;;;;;;qBAOA;iBAEI;EACf,aAAa;EACb;;EAEA;EACA;;iBAGe;EACf,aAAa;EACb;;EAEA,QAAQ;;EAER;;EAEA;;EAEA;;;iBAIe;EACf,aAAa;EACb;;EAEA;;iBAGe;EACf,aAAa;EACb,YAAY;;iBAGG;EACf,aAAa;EACb,WAAW;;iBAGI;EACf,aAAa;EACb;;iBAGe;EACf,aAAa;EACb,UAAU;;iBAGK;EACf,aAAa;EACb,SAAS;;iBAGM;EACf,aAAa;EACb;;;;;;iBAOe;EACf,aAAa;EACb;EACA,QAAQ;;EAER;;;iBAIe;EACf,aAAa;EACb;EACA,OAAO;;iBAGQ;EACf,aAAa;EACb;;iBAGe;EACf,aAAa;EACb;;;iBAIe;EACf,aAAa;EACb;EACA,OAAO;;wBAGO,SAAS,qBAAqB;wBAI9B,qBAAqB,mBAAmB,OAAO,eAAe;wBAI9D,eAAe,mBAAmB,OAAO,eAAe;wBAIxD,eAAe,oBAAoB;wBAInC,iBAAiB,oBAAoB;iBAIpC;EACf,aAAa;EACb;EACA;;iBAGe;EACf,aAAa;EACb;EACA;;;iBAIe;EACf,aAAa;EACb;EACA;EACA,QAAQ;;;iBAIO;EACf,aAAa;EACb;EACA;EACA,OAAO;;wBAGO,qBAAqB,mBAAmB,mBAAmB;wBAI3D,uBAAuB,mBAAmB,mBAAmB;wBAI7D,cAAc,mBAAmB,kBAAkB,QAAQ,iBAAiB;wBAI5E,oBAAoB,mBAAmB,kBAAkB,OAAO,eAAe"}

package/dist/types/hub.mjs

@@ -0,0 +1,179 @@
+//#region src/types/hub.ts
+/**
+* Wire vocabulary between the hub and its pages.
+*
+* One WebSocket carries every session: hub-level frames describe the set of
+* sessions, and session-scoped traffic travels enveloped with the session id.
+* Field naming follows @earendil-works/pi-protocol so a future swap to the
+* upstream session server stays a transport change, not a rename.
+*/
+const HUB_PROTOCOL_VERSION = 2;
+/** Role marker in the health payload; po-server probes for it before binding the port. */
+const HUB_ROLE = "hub";
+/** REST endpoint for admitting and listing durable workspaces. */
+const WORKSPACES_API_ROUTE = "/api/workspaces";
+/** REST endpoint for creating sessions and browsing resumable Pi history. */
+const SESSIONS_API_ROUTE = "/api/workspaces/:workspaceId/sessions";
+/**
+* REST endpoint behind the new-session directory picker; the page sends the
+* typed path as ?q= and receives {directories}: the children of the parent
+* directory whose names match the trailing segment as a regular expression.
+*/
+const DIRECTORIES_API_ROUTE = "/api/directories";
+/** Lists the visible child folders of ?path= (home when absent) for the workspace folder browser. */
+const DIRECTORY_CHILDREN_API_ROUTE = "/api/directories/children";
+/**
+* Query parameter that routes a package API request to one session's server.
+* Without it the request is answered by a hub-scoped API in this process.
+*/
+const API_SESSION_QUERY_PARAM = "session";
+const HUB_HELLO_TYPE = "hub_hello";
+const WORKSPACES_SNAPSHOT_TYPE = "workspaces_snapshot";
+const WORKSPACE_UPSERT_TYPE = "workspace_upsert";
+const WORKSPACE_REMOVED_TYPE = "workspace_removed";
+const SESSIONS_SNAPSHOT_TYPE = "sessions_snapshot";
+const SESSION_UPSERT_TYPE = "session_upsert";
+const SESSION_REMOVED_TYPE = "session_removed";
+const SESSION_BACKLOG_TYPE = "session_backlog";
+const SESSION_FRAME_TYPE = "session_frame";
+/** Hub-synthesized close for an answered dialog; Pi itself never announces one. */
+const DIALOG_ANSWERED_TYPE = "extension_ui_answered";
+/**
+* Sync rebuilt the artifacts this page is running against.
+*
+* The plugin bundle the browser loaded is one of them, and a bundle only
+* changes on disk: nothing about the running page notices. The page reloads
+* itself rather than staying on surfaces the repository no longer describes.
+*/
+const HUB_RESYNCED_TYPE = "hub_resynced";
+/**
+* The custom session entry the Po runtime journals with its minor-mode
+* catalog projection; it arrives inside Pi's entry_appended frames. The shape
+* mirrors MinorModeProjection in po-minor-mode.
+*/
+const MINOR_MODE_ENTRY_TYPE = "doom-minor-modes";
+/**
+* The custom session entry the Po runtime journals when the agent's model
+* changes without a client having asked for it. The shape mirrors
+* AgentModelProjection in po-core.
+*
+* Pi reports a thinking-level switch on the wire, so that field follows from
+* the frame alone. It has no wire event for the model, so plan mode applying
+* its configured planning model would otherwise leave the chip naming the
+* model the session left behind.
+*/
+const AGENT_MODEL_ENTRY_TYPE = "doom-agent-model";
+/**
+* The custom session entry Po journals describing what the session is
+* composed of: which mode admitted each tool and skill, and what each costs.
+*
+* Schemas are deliberately absent. Only names, kinds, owners and integer token
+* counts travel, so republishing the whole composition stays cheap.
+*/
+const CONTEXT_ENTRY_TYPE = "doom-context";
+/**
+* The custom session entry po-profile journals naming the persona the
+* session speaks as. The shape mirrors ProfileIdentityProjection in
+* po-core.
+*
+* Unlike the entries above, this one is transcript rather than projection: it
+* stays in journal order and is never collapsed to the latest record, because a
+* message keeps the persona it was written under. Adding it to
+* PROJECTION_ENTRY_TYPES would repaint the whole transcript on every switch.
+*/
+const PROFILE_IDENTITY_ENTRY_TYPE = "doom-profile-identity";
+/**
+* The custom session entry po-domain journals once Pi has rebuilt its
+* resource catalog for a reload; it mirrors DOOM_RESOURCE_CATALOG_ENTRY_TYPE in
+* po-core.
+*
+* A reload is what changes the skills the composer offers under `$`, and Pi
+* reports nothing else for one, so this entry is the cockpit's only notice that
+* the command list it cached belongs to the previous selection.
+*/
+const RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+const SUBSCRIBE_TYPE = "subscribe";
+const UNSUBSCRIBE_TYPE = "unsubscribe";
+const SESSION_COMMAND_TYPE = "session_command";
+/** A page follows one thread of a session: a journal a plugin's hub source names, such as a subagent run. */
+const SUBSCRIBE_THREAD_TYPE = "subscribe_thread";
+const UNSUBSCRIBE_THREAD_TYPE = "unsubscribe_thread";
+const THREAD_BACKLOG_TYPE = "thread_backlog";
+const THREAD_FRAME_TYPE = "thread_frame";
+/** A page asks for the transcript before what it already holds. */
+const HISTORY_REQUEST_TYPE = "history_request";
+/** One older window, oldest first, answering a history_request. */
+const HISTORY_PAGE_TYPE = "history_page";
+/**
+* How many journalled messages one page carries. Small enough that prepending
+* a window never blocks the reader's scroll, large enough that a flick through
+* a long transcript does not turn into a hundred round trips.
+*/
+const HISTORY_PAGE_SIZE = 100;
+function hubHello(channels) {
+	return {
+		type: HUB_HELLO_TYPE,
+		protocol: 2,
+		channels
+	};
+}
+function sessionFrameEnvelope(sessionId, frame) {
+	return {
+		type: SESSION_FRAME_TYPE,
+		sessionId,
+		frame
+	};
+}
+function sessionCommand(sessionId, frame) {
+	return {
+		type: SESSION_COMMAND_TYPE,
+		sessionId,
+		frame
+	};
+}
+function subscribeFrame(sessionId) {
+	return {
+		type: SUBSCRIBE_TYPE,
+		sessionId
+	};
+}
+function unsubscribeFrame(sessionId) {
+	return {
+		type: UNSUBSCRIBE_TYPE,
+		sessionId
+	};
+}
+function subscribeThreadFrame(sessionId, threadId) {
+	return {
+		type: SUBSCRIBE_THREAD_TYPE,
+		sessionId,
+		threadId
+	};
+}
+function unsubscribeThreadFrame(sessionId, threadId) {
+	return {
+		type: UNSUBSCRIBE_THREAD_TYPE,
+		sessionId,
+		threadId
+	};
+}
+function threadBacklog(sessionId, threadId, frames) {
+	return {
+		type: THREAD_BACKLOG_TYPE,
+		sessionId,
+		threadId,
+		frames
+	};
+}
+function threadFrameEnvelope(sessionId, threadId, frame) {
+	return {
+		type: THREAD_FRAME_TYPE,
+		sessionId,
+		threadId,
+		frame
+	};
+}
+//#endregion
+export { AGENT_MODEL_ENTRY_TYPE, API_SESSION_QUERY_PARAM, CONTEXT_ENTRY_TYPE, DIALOG_ANSWERED_TYPE, DIRECTORIES_API_ROUTE, DIRECTORY_CHILDREN_API_ROUTE, HISTORY_PAGE_SIZE, HISTORY_PAGE_TYPE, HISTORY_REQUEST_TYPE, HUB_HELLO_TYPE, HUB_PROTOCOL_VERSION, HUB_RESYNCED_TYPE, HUB_ROLE, MINOR_MODE_ENTRY_TYPE, PROFILE_IDENTITY_ENTRY_TYPE, RESOURCE_CATALOG_ENTRY_TYPE, SESSIONS_API_ROUTE, SESSIONS_SNAPSHOT_TYPE, SESSION_BACKLOG_TYPE, SESSION_COMMAND_TYPE, SESSION_FRAME_TYPE, SESSION_REMOVED_TYPE, SESSION_UPSERT_TYPE, SUBSCRIBE_THREAD_TYPE, SUBSCRIBE_TYPE, THREAD_BACKLOG_TYPE, THREAD_FRAME_TYPE, UNSUBSCRIBE_THREAD_TYPE, UNSUBSCRIBE_TYPE, WORKSPACES_API_ROUTE, WORKSPACES_SNAPSHOT_TYPE, WORKSPACE_REMOVED_TYPE, WORKSPACE_UPSERT_TYPE, hubHello, sessionCommand, sessionFrameEnvelope, subscribeFrame, subscribeThreadFrame, threadBacklog, threadFrameEnvelope, unsubscribeFrame, unsubscribeThreadFrame };
+
+//# sourceMappingURL=hub.mjs.map

package/dist/types/hub.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.mjs","names":[],"sources":["../../src/types/hub.ts"],"sourcesContent":["import type { BridgeState, SessionFrame } from './session';\n\n/**\n * Wire vocabulary between the hub and its pages.\n *\n * One WebSocket carries every session: hub-level frames describe the set of\n * sessions, and session-scoped traffic travels enveloped with the session id.\n * Field naming follows @earendil-works/pi-protocol so a future swap to the\n * upstream session server stays a transport change, not a rename.\n */\nexport const HUB_PROTOCOL_VERSION = 2;\n\n/** Role marker in the health payload; po-server probes for it before binding the port. */\nexport const HUB_ROLE = 'hub';\n\n/** REST endpoint for admitting and listing durable workspaces. */\nexport const WORKSPACES_API_ROUTE = '/api/workspaces';\n\n/** REST endpoint for creating sessions and browsing resumable Pi history. */\nexport const SESSIONS_API_ROUTE = '/api/workspaces/:workspaceId/sessions';\n\n/** One durable repository workspace shown in the rail, even while it has no sessions. */\nexport interface WorkspaceSummary {\n  id: string;\n  root: string;\n  /** Display name chosen when the workspace was added; the folder basename stands in when absent. */\n  name?: string;\n  /** A remembered workspace whose root could not be mounted on this server start. */\n  available?: boolean;\n  error?: string;\n}\n\n/** One inactive Pi thread available to resume in a live session's workspace. */\nexport interface PiSessionHistoryItem {\n  id: string;\n  name?: string;\n  firstMessage: string;\n  createdAt: string;\n  updatedAt: string;\n  messageCount: number;\n}\n\n/**\n * REST endpoint behind the new-session directory picker; the page sends the\n * typed path as ?q= and receives {directories}: the children of the parent\n * directory whose names match the trailing segment as a regular expression.\n */\nexport const DIRECTORIES_API_ROUTE = '/api/directories';\n\n/** Lists the visible child folders of ?path= (home when absent) for the workspace folder browser. */\nexport const DIRECTORY_CHILDREN_API_ROUTE = '/api/directories/children';\n\n/** One folder's visible child directories, as absolute paths. */\nexport interface DirectoryListing {\n  path: string;\n  parent?: string;\n  directories: string[];\n}\n\n/**\n * Query parameter that routes a package API request to one session's server.\n * Without it the request is answered by a hub-scoped API in this process.\n */\nexport const API_SESSION_QUERY_PARAM = 'session';\n\n/** What the agent is doing right now, derived from its frame stream. */\nexport type SessionPhase = 'idle' | 'turn' | 'compaction' | 'retry';\n\nexport interface SessionProfile {\n  name: string;\n  displayName?: string;\n  /** Changes whenever the icon does; absent when the profile has no icon. */\n  iconVersion?: string;\n}\n\nexport interface SessionGitStatus {\n  branch: string;\n  /** True when the working tree has uncommitted changes; rendered as a star. */\n  dirty: boolean;\n}\n\n/** One immutable, signed client composition resolved for a session. */\nexport interface SessionWebComposition {\n  /** Stable identity of the synchronized root and generation. */\n  id: string;\n  /** Monotonic signing revision advertised by the manifest. */\n  revision: number;\n  /** Same-origin signed-manifest route read by the trusted service worker. */\n  manifestUrl: string;\n  /** Same-origin prefix for the untrusted source bytes verified by the worker. */\n  rawAssetBaseUrl: string;\n  /** Worker-owned prefix from which the page may execute verified bytes. */\n  verifiedAssetBaseUrl: string;\n  /** `[slot, entry]` per plugin copy this mount runs, each entry an absolute path below both asset prefixes. */\n  pluginEntries: [string, string][];\n  /** Absolute paths below both asset prefixes of every file this mount's slots can load. */\n  assetPaths: string[];\n  /** Absolute paths below both asset prefixes, replaced when this session is focused. */\n  stylePaths: string[];\n  /** Frame types owned by the matching session-local hub composition. */\n  channels: string[];\n  /**\n   * The slots this mount runs out of a shared build. Absent means the composition\n   * holds only this mount's plugins, as in-memory test hosts publish it.\n   */\n  plugins?: string[];\n}\n\n/** One immutable, signed native composition resolved for a session; read by po-native, ignored by the web. */\nexport interface SessionNativeComposition {\n  /** Stable identity of the synchronized root and generation. */\n  id: string;\n  scope: 'global' | 'workspace' | 'session';\n  /** Monotonic signing revision advertised by the manifest. */\n  revision: number;\n  manifestUrl: string;\n  rawAssetBaseUrl: string;\n  /** Always `/composition.js`. */\n  entryPath: string;\n  channels: string[];\n  /** The `poNative.pluginId` values resolved for this mount; the shell installs only these. */\n  plugins: string[];\n}\n\n/**\n * Everything the rail needs to render one session without subscribing to it.\n */\nexport interface SessionSummary {\n  workspaceId?: string;\n  id: string;\n  name: string;\n  cwd: string;\n  /** ISO 8601, from the session's registry record. */\n  createdAt: string;\n  /** ISO 8601, bumped whenever the session's frame stream moves. */\n  updatedAt: string;\n  phase: SessionPhase;\n  /** ISO 8601 timestamp of the last phase change; drives \"running · 12m\". */\n  phaseSince: string;\n  /** The hub's own attachment to the session socket. */\n  attach: BridgeState;\n  /** Human-readable cause, present when attach is refused or closed. */\n  attachReason?: string;\n  pendingMessageCount: number;\n  /** False until the first prompt is forwarded; \"fresh session · nothing sent yet\". */\n  everPrompted: boolean;\n  /** True while the agent waits on a dialog answer; \"waiting for your input\". */\n  awaitingInput: boolean;\n  /** ISO 8601 of the last settled run, once one finished. */\n  lastSettledAt?: string;\n  /** Omitted when the cwd is not a git repository or git is unavailable. */\n  git?: SessionGitStatus;\n  /** Selected profile; the icon itself is served by the session avatar route. */\n  profile?: SessionProfile;\n  /** Signed plugin composition independently resolved for this session. */\n  webComposition?: SessionWebComposition;\n  /** Signed native composition for this session, when native targets were built. */\n  nativeComposition?: SessionNativeComposition;\n  /**\n   * The session this one was spawned from, recorded by the hub when it opened the session.\n   * The rail nests a session under its parent; absent means a top-level row.\n   */\n  parentSessionId?: string;\n  /**\n   * The spawning package's own label for the relationship, such as \"worktree\".\n   * The hub does not interpret it; the rail uses it to pick an affordance.\n   */\n  sessionProvenance?: string;\n  /** Host reservations awaiting a durable child runtime, not live sessions. */\n  pendingSetups?: Array<{\n    id: string;\n    name: string;\n    createdAt: string;\n    cwd?: string;\n    status?: 'provisioning' | 'failed' | 'interrupted';\n    setupKind?: 'managed-worktree' | 'existing-directory';\n    errorCode?: 'SESSION_WORKTREE_PROVISION_FAILED' | 'SESSION_UNAVAILABLE';\n  }>;\n  /**\n   * One line an extension published about background work it runs for this\n   * session, such as a workflow; the rail shows it in place of the idle copy.\n   */\n  activity?: { label: string; attention?: boolean; since?: string };\n  /**\n   * The hub recorded this session but has not reopened it since its last\n   * restart. Its journal is on disk; nothing is running behind the card until\n   * the page asks for it.\n   */\n  dormant?: boolean;\n}\n\nexport const HUB_HELLO_TYPE = 'hub_hello';\nexport const WORKSPACES_SNAPSHOT_TYPE = 'workspaces_snapshot';\nexport const WORKSPACE_UPSERT_TYPE = 'workspace_upsert';\nexport const WORKSPACE_REMOVED_TYPE = 'workspace_removed';\nexport const SESSIONS_SNAPSHOT_TYPE = 'sessions_snapshot';\nexport const SESSION_UPSERT_TYPE = 'session_upsert';\nexport const SESSION_REMOVED_TYPE = 'session_removed';\nexport const SESSION_BACKLOG_TYPE = 'session_backlog';\nexport const SESSION_FRAME_TYPE = 'session_frame';\n/** Hub-synthesized close for an answered dialog; Pi itself never announces one. */\nexport const DIALOG_ANSWERED_TYPE = 'extension_ui_answered';\n/**\n * Sync rebuilt the artifacts this page is running against.\n *\n * The plugin bundle the browser loaded is one of them, and a bundle only\n * changes on disk: nothing about the running page notices. The page reloads\n * itself rather than staying on surfaces the repository no longer describes.\n */\nexport const HUB_RESYNCED_TYPE = 'hub_resynced';\n\n/**\n * The custom session entry the Po runtime journals with its minor-mode\n * catalog projection; it arrives inside Pi's entry_appended frames. The shape\n * mirrors MinorModeProjection in po-minor-mode.\n */\nexport const MINOR_MODE_ENTRY_TYPE = 'doom-minor-modes';\n\n/**\n * The custom session entry the Po runtime journals when the agent's model\n * changes without a client having asked for it. The shape mirrors\n * AgentModelProjection in po-core.\n *\n * Pi reports a thinking-level switch on the wire, so that field follows from\n * the frame alone. It has no wire event for the model, so plan mode applying\n * its configured planning model would otherwise leave the chip naming the\n * model the session left behind.\n */\nexport const AGENT_MODEL_ENTRY_TYPE = 'doom-agent-model';\n/**\n * The custom session entry Po journals describing what the session is\n * composed of: which mode admitted each tool and skill, and what each costs.\n *\n * Schemas are deliberately absent. Only names, kinds, owners and integer token\n * counts travel, so republishing the whole composition stays cheap.\n */\nexport const CONTEXT_ENTRY_TYPE = 'doom-context';\n\n/**\n * The custom session entry po-profile journals naming the persona the\n * session speaks as. The shape mirrors ProfileIdentityProjection in\n * po-core.\n *\n * Unlike the entries above, this one is transcript rather than projection: it\n * stays in journal order and is never collapsed to the latest record, because a\n * message keeps the persona it was written under. Adding it to\n * PROJECTION_ENTRY_TYPES would repaint the whole transcript on every switch.\n */\nexport const PROFILE_IDENTITY_ENTRY_TYPE = 'doom-profile-identity';\n/**\n * The custom session entry po-domain journals once Pi has rebuilt its\n * resource catalog for a reload; it mirrors DOOM_RESOURCE_CATALOG_ENTRY_TYPE in\n * po-core.\n *\n * A reload is what changes the skills the composer offers under `$`, and Pi\n * reports nothing else for one, so this entry is the cockpit's only notice that\n * the command list it cached belongs to the previous selection.\n */\nexport const RESOURCE_CATALOG_ENTRY_TYPE = 'doom-resource-catalog';\nexport interface MinorModeActionProjection {\n  id: string;\n  label: string;\n  description: string;\n  enabled: boolean;\n  disabledReason?: string;\n  needsInput: boolean;\n}\n\nexport interface MinorModeRecordProjection {\n  id: string;\n  label: string;\n  description: string;\n  order: number;\n  activation: 'inactive' | 'activating' | 'active' | 'deactivating';\n  condition: string;\n  detail?: string;\n  actions: MinorModeActionProjection[];\n}\n\nexport interface MinorModeProjection {\n  version: 1;\n  revision: number;\n  modes: MinorModeRecordProjection[];\n}\n\nexport type ContextGroupKind = 'major' | 'minor' | 'domain' | 'core';\nexport type ContextItemSource = 'extension' | 'mcp' | 'plugin' | 'core';\n\nexport interface ContextItemProjection {\n  name: string;\n  itemKind: 'tool' | 'skill';\n  source: ContextItemSource;\n  owner: string;\n  tokens: number;\n  active: boolean;\n}\n\nexport interface ContextGroupProjection {\n  id: string;\n  label: string;\n  kind: ContextGroupKind;\n  items: ContextItemProjection[];\n  /** What the group costs now: active items only. */\n  tokens: number;\n  /** What its gated items would add if switched on. */\n  inactiveTokens: number;\n}\n\nexport interface ContextProjection {\n  version: 1;\n  revision: number;\n  selection?: { majorMode: string; domains: string[]; profile?: string };\n  groups: ContextGroupProjection[];\n  totalTokens: number;\n  inactiveTokens: number;\n  /**\n   * What the assembled system prompt costs, deliberately outside the groups.\n   *\n   * Every tool's prose and every skill's listing already count inside\n   * `totalTokens`, and those are slices of this same text, so the two figures\n   * overlap and must not be added. `stage` is `base` when the session has sent\n   * nothing yet and the prompt shown is the one before packages patch it.\n   */\n  systemPrompt?: { tokens: number; stage: 'base' | 'effective' };\n  /** Names the tokenizer, because the figures are indicative, not billed. */\n  estimator: string;\n}\nexport const SUBSCRIBE_TYPE = 'subscribe';\nexport const UNSUBSCRIBE_TYPE = 'unsubscribe';\nexport const SESSION_COMMAND_TYPE = 'session_command';\n/** A page follows one thread of a session: a journal a plugin's hub source names, such as a subagent run. */\nexport const SUBSCRIBE_THREAD_TYPE = 'subscribe_thread';\nexport const UNSUBSCRIBE_THREAD_TYPE = 'unsubscribe_thread';\nexport const THREAD_BACKLOG_TYPE = 'thread_backlog';\nexport const THREAD_FRAME_TYPE = 'thread_frame';\n\n/** A page asks for the transcript before what it already holds. */\nexport const HISTORY_REQUEST_TYPE = 'history_request';\n/** One older window, oldest first, answering a history_request. */\nexport const HISTORY_PAGE_TYPE = 'history_page';\n\n/**\n * How many journalled messages one page carries. Small enough that prepending\n * a window never blocks the reader's scroll, large enough that a flick through\n * a long transcript does not turn into a hundred round trips.\n */\nexport const HISTORY_PAGE_SIZE = 100;\n\nexport interface HistoryRequestFrame {\n  type: typeof HISTORY_REQUEST_TYPE;\n  sessionId: string;\n  /** Journal id of the oldest entry the page holds; absent asks for the newest window. */\n  before?: string;\n  limit?: number;\n}\n\nexport interface HistoryPageFrame {\n  type: typeof HISTORY_PAGE_TYPE;\n  sessionId: string;\n  /** Entry frames, oldest first, to prepend above what the page holds. */\n  frames: Record<string, unknown>[];\n  /** The cursor for the next older window; null when the transcript starts here. */\n  cursor: string | null;\n  /** Whether anything older than this window exists. */\n  hasMore: boolean;\n  /** Echoed so a page can drop an answer to a question it has since abandoned. */\n  before?: string;\n}\n\n/** First frame on every page socket, before the snapshot. */\nexport interface HubHelloFrame {\n  type: typeof HUB_HELLO_TYPE;\n  protocol: number;\n  /** Frame types of the hub's loaded data channels; lets a panel tell \"plugin server not installed\" from \"no data\". */\n  channels: string[];\n}\n\nexport interface WorkspacesSnapshotFrame {\n  type: typeof WORKSPACES_SNAPSHOT_TYPE;\n  workspaces: WorkspaceSummary[];\n}\n\nexport interface WorkspaceUpsertFrame {\n  type: typeof WORKSPACE_UPSERT_TYPE;\n  workspace: WorkspaceSummary;\n}\n\nexport interface WorkspaceRemovedFrame {\n  type: typeof WORKSPACE_REMOVED_TYPE;\n  workspaceId: string;\n}\n\nexport interface SessionsSnapshotFrame {\n  type: typeof SESSIONS_SNAPSHOT_TYPE;\n  sessions: SessionSummary[];\n}\n\nexport interface SessionUpsertFrame {\n  type: typeof SESSION_UPSERT_TYPE;\n  session: SessionSummary;\n}\n\nexport interface SessionRemovedFrame {\n  type: typeof SESSION_REMOVED_TYPE;\n  sessionId: string;\n}\n\n/**\n * Reply to subscribe: this session's latest status and widget projections first,\n * then its bounded transient history. Live frames follow.\n */\nexport interface SessionBacklogFrame {\n  type: typeof SESSION_BACKLOG_TYPE;\n  sessionId: string;\n  frames: SessionFrame[];\n  /** Transient frames the bounded ring discarded; projections do not contribute. */\n  dropped: number;\n}\n\n/** One live agent frame, addressed to subscribers of its session. */\nexport interface SessionFrameEnvelope {\n  type: typeof SESSION_FRAME_TYPE;\n  sessionId: string;\n  frame: SessionFrame;\n}\n\nexport interface SubscribeFrame {\n  type: typeof SUBSCRIBE_TYPE;\n  sessionId: string;\n}\n\nexport interface UnsubscribeFrame {\n  type: typeof UNSUBSCRIBE_TYPE;\n  sessionId: string;\n}\n\n/** One command frame from the page, addressed to a session's agent. */\nexport interface SessionCommandFrame {\n  type: typeof SESSION_COMMAND_TYPE;\n  sessionId: string;\n  frame: SessionFrame;\n}\n\nexport function hubHello(channels: string[]): HubHelloFrame {\n  return { type: HUB_HELLO_TYPE, protocol: HUB_PROTOCOL_VERSION, channels };\n}\n\nexport function sessionFrameEnvelope(sessionId: string, frame: SessionFrame): SessionFrameEnvelope {\n  return { type: SESSION_FRAME_TYPE, sessionId, frame };\n}\n\nexport function sessionCommand(sessionId: string, frame: SessionFrame): SessionCommandFrame {\n  return { type: SESSION_COMMAND_TYPE, sessionId, frame };\n}\n\nexport function subscribeFrame(sessionId: string): SubscribeFrame {\n  return { type: SUBSCRIBE_TYPE, sessionId };\n}\n\nexport function unsubscribeFrame(sessionId: string): UnsubscribeFrame {\n  return { type: UNSUBSCRIBE_TYPE, sessionId };\n}\n\nexport interface SubscribeThreadFrame {\n  type: typeof SUBSCRIBE_THREAD_TYPE;\n  sessionId: string;\n  threadId: string;\n}\n\nexport interface UnsubscribeThreadFrame {\n  type: typeof UNSUBSCRIBE_THREAD_TYPE;\n  sessionId: string;\n  threadId: string;\n}\n\n/** Reply to subscribe_thread: the journal's newest entries as entry_appended frames, then live ones follow. */\nexport interface ThreadBacklogFrame {\n  type: typeof THREAD_BACKLOG_TYPE;\n  sessionId: string;\n  threadId: string;\n  frames: SessionFrame[];\n}\n\n/** One journal entry a followed thread gained, addressed to the pages following it. */\nexport interface ThreadFrameEnvelope {\n  type: typeof THREAD_FRAME_TYPE;\n  sessionId: string;\n  threadId: string;\n  frame: SessionFrame;\n}\n\nexport function subscribeThreadFrame(sessionId: string, threadId: string): SubscribeThreadFrame {\n  return { type: SUBSCRIBE_THREAD_TYPE, sessionId, threadId };\n}\n\nexport function unsubscribeThreadFrame(sessionId: string, threadId: string): UnsubscribeThreadFrame {\n  return { type: UNSUBSCRIBE_THREAD_TYPE, sessionId, threadId };\n}\n\nexport function threadBacklog(sessionId: string, threadId: string, frames: SessionFrame[]): ThreadBacklogFrame {\n  return { type: THREAD_BACKLOG_TYPE, sessionId, threadId, frames };\n}\n\nexport function threadFrameEnvelope(sessionId: string, threadId: string, frame: SessionFrame): ThreadFrameEnvelope {\n  return { type: THREAD_FRAME_TYPE, sessionId, threadId, frame };\n}\n"],"mappings":";;;;;;;;;AAUA,MAAa,uBAAuB;;AAGpC,MAAa,WAAW;;AAGxB,MAAa,uBAAuB;;AAGpC,MAAa,qBAAqB;;;;;;AA4BlC,MAAa,wBAAwB;;AAGrC,MAAa,+BAA+B;;;;;AAa5C,MAAa,0BAA0B;AAgIvC,MAAa,iBAAiB;AAC9B,MAAa,2BAA2B;AACxC,MAAa,wBAAwB;AACrC,MAAa,yBAAyB;AACtC,MAAa,yBAAyB;AACtC,MAAa,sBAAsB;AACnC,MAAa,uBAAuB;AACpC,MAAa,uBAAuB;AACpC,MAAa,qBAAqB;;AAElC,MAAa,uBAAuB;;;;;;;;AAQpC,MAAa,oBAAoB;;;;;;AAOjC,MAAa,wBAAwB;;;;;;;;;;;AAYrC,MAAa,yBAAyB;;;;;;;;AAQtC,MAAa,qBAAqB;;;;;;;;;;;AAYlC,MAAa,8BAA8B;;;;;;;;;;AAU3C,MAAa,8BAA8B;AAqE3C,MAAa,iBAAiB;AAC9B,MAAa,mBAAmB;AAChC,MAAa,uBAAuB;;AAEpC,MAAa,wBAAwB;AACrC,MAAa,0BAA0B;AACvC,MAAa,sBAAsB;AACnC,MAAa,oBAAoB;;AAGjC,MAAa,uBAAuB;;AAEpC,MAAa,oBAAoB;;;;;;AAOjC,MAAa,oBAAoB;AAiGjC,SAAgB,SAAS,UAAmC;CAC1D,OAAO;EAAE,MAAM;EAAgB,UAAA;EAAgC;CAAS;AAC1E;AAEA,SAAgB,qBAAqB,WAAmB,OAA2C;CACjG,OAAO;EAAE,MAAM;EAAoB;EAAW;CAAM;AACtD;AAEA,SAAgB,eAAe,WAAmB,OAA0C;CAC1F,OAAO;EAAE,MAAM;EAAsB;EAAW;CAAM;AACxD;AAEA,SAAgB,eAAe,WAAmC;CAChE,OAAO;EAAE,MAAM;EAAgB;CAAU;AAC3C;AAEA,SAAgB,iBAAiB,WAAqC;CACpE,OAAO;EAAE,MAAM;EAAkB;CAAU;AAC7C;AA8BA,SAAgB,qBAAqB,WAAmB,UAAwC;CAC9F,OAAO;EAAE,MAAM;EAAuB;EAAW;CAAS;AAC5D;AAEA,SAAgB,uBAAuB,WAAmB,UAA0C;CAClG,OAAO;EAAE,MAAM;EAAyB;EAAW;CAAS;AAC9D;AAEA,SAAgB,cAAc,WAAmB,UAAkB,QAA4C;CAC7G,OAAO;EAAE,MAAM;EAAqB;EAAW;EAAU;CAAO;AAClE;AAEA,SAAgB,oBAAoB,WAAmB,UAAkB,OAA0C;CACjH,OAAO;EAAE,MAAM;EAAmB;EAAW;EAAU;CAAM;AAC/D"}