@agimon-ai/doompi-core 0.0.1-alpha.70

package/dist/headless-hub.d.cts

@@ -0,0 +1,96 @@
+import { DoomDirectEventBus, DoomHubChannel, DoomHubSessionApiRequest, DoomHubSessionCreateRequest, DoomHubSessionScope, DoomHubSessionService } from "./schemas/hubChannel.cjs";
+import { DoomApiContext, DoomApiMount, DoomWebComposition } from "./schemas/packageApi.cjs";
+import { DoomPluginCaller, DoomPluginDirection } from "./schemas/pluginProtocol.cjs";
+import { DoomServerFacet } from "./schemas/serverFacet.cjs";
+import { LoadedServerFacet } from "./server/serverFacetLoader.cjs";
+import "./server-facet.cjs";
+import "./package-api.cjs";
+import { HeadlessSessionHost, HeadlessSessionHostOptions } from "./headless-session-host.cjs";
+import { HeadlessSessionManager } from "./runtime-headless-session-manager.cjs";
+import "./plugin-protocol.cjs";
+//#region src/server/headlessHub.d.ts
+export interface HeadlessHubSession {
+  readonly id: string;
+  readonly workspaceId?: string;
+  webComposition?: DoomWebComposition;
+  readonly name: string;
+  readonly cwd: string;
+  readonly createdAt: string;
+  readonly parentSessionId?: string;
+  readonly sessionProvenance?: string;
+  readonly updatedAt?: string;
+  readonly phase?: 'idle' | 'turn' | 'compaction' | 'retry';
+  readonly phaseSince?: string;
+  readonly pendingMessageCount?: number;
+  readonly everPrompted?: boolean;
+  readonly awaitingInput?: boolean;
+  readonly lastSettledAt?: string;
+  /** Environment admitted for this session, when supplied by the host. */
+  readonly environment?: Readonly<Record<string, string | undefined>>;
+  readonly host: HeadlessSessionHost;
+}
+export interface HeadlessWorkspace {
+  readonly id: string;
+  readonly root: string;
+}
+export type HeadlessHubEvent = {
+  kind: 'upsert';
+  session: HeadlessHubSession;
+} | {
+  kind: 'removed';
+  sessionId: string;
+} | {
+  kind: 'channel';
+  frameType: string;
+  sessionId: string;
+  payload: unknown;
+  connectionId?: string;
+};
+export interface HeadlessHubOptions {
+  manager: HeadlessSessionManager;
+  hubToken?: string;
+  /** Creates a session through the canonical cockpit lifecycle for hub channels. */
+  createSession?: (request: DoomHubSessionCreateRequest) => Promise<DoomHubSessionScope>;
+  onNotice?: (message: string) => void;
+  requestSessionApi?: (scope: DoomHubSessionScope, request: DoomHubSessionApiRequest) => Promise<Response>;
+  admitWorkspace?: (root: string) => Promise<HeadlessWorkspace>;
+  onWorkspaceRemoved?: (workspaceId: string) => void;
+}
+export interface HeadlessHub {
+  /** Canonical direct lifecycle shared by hub channels, APIs, and sessions. */
+  readonly sessionService: DoomHubSessionService;
+  /** Lifecycle-owned event path shared by session facets and hub channels. */
+  readonly directEvents: DoomDirectEventBus;
+  snapshot(): readonly HeadlessHubSession[];
+  session(sessionId: string): HeadlessHubSession | undefined;
+  runtime(sessionId: string): HeadlessSessionHost['runtime'] | undefined;
+  onEvent(listener: (event: HeadlessHubEvent) => void): () => void;
+  register(session: HeadlessHubSession): void;
+  create(options: HeadlessSessionHostOptions): Promise<HeadlessHubSession>;
+  closeSession(sessionId: string): Promise<void>;
+  /** Dispatches an authenticated package API request inside the owning process. */
+  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;
+  /** Mounts the selected hub facets once, before the headless server accepts clients. */
+  mountFacets(facets: readonly (DoomServerFacet | LoadedServerFacet)[], context?: DoomApiContext): Promise<void>;
+  workspaces(): readonly HeadlessWorkspace[];
+  admitWorkspace(root: string): Promise<HeadlessWorkspace>;
+  removeWorkspace(workspaceId: string): Promise<void>;
+  requestApi(mount: DoomApiMount, basePath: string, request: Request): Promise<Response>;
+  invokePlugin(call: unknown, direction: DoomPluginDirection, caller?: DoomPluginCaller): Promise<unknown>;
+  registerChannel(channel: DoomHubChannel, mount?: DoomApiMount): () => void;
+  channelTypes(): readonly string[];
+  channelFrames(sessionId: string): Array<{
+    type: string;
+    sessionId: string;
+    payload: unknown;
+  }>;
+  /** Resolves a channel-owned child journal for the browser thread projection. */
+  threadJournal(sessionId: string, threadId: string): string | undefined;
+  receiveChannel(sessionId: string, frameType: string, payload: unknown, connectionId: string): void;
+  disconnectChannels(connectionId: string): void;
+  close(): Promise<void>;
+}
+/** Owns direct, same-process session and channel state for presentation adapters. */
+export declare function createHeadlessHub(options: HeadlessHubOptions): HeadlessHub;
+//#endregion
+//# sourceMappingURL=headless-hub.d.cts.map

package/dist/headless-hub.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-hub.d.cts","names":[],"sources":["../src/server/headlessHub.ts"],"mappings":";;;;;;;;;;;iBAwBiB;WACN;WACA;EACT,iBAAiB;WACR;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;WAEA,cAAc,SAAS;WACvB,MAAM;;iBAGA;WACN;WACA;;YAGC;EACN;EAAgB,SAAS;;EACzB;EAAiB;;EACjB;EAAiB;EAAmB;EAAmB;EAAkB;;iBAE9D;EACf,SAAS;EACT;;EAEA,iBAAiB,SAAS,gCAAgC,QAAQ;EAClE,YAAY;EACZ,qBAAqB,OAAO,qBAAqB,SAAS,6BAA6B,QAAQ;EAC/F,kBAAkB,iBAAiB,QAAQ;EAC3C,sBAAsB;;iBAGP;;WAEN,gBAAgB;;WAEhB,cAAc;EACvB,qBAAqB;EACrB,QAAQ,oBAAoB;EAC5B,QAAQ,oBAAoB;EAC5B,QAAQ,WAAW,OAAO;EAC1B,SAAS,SAAS;EAClB,OAAO,SAAS,6BAA6B,QAAQ;EACrD,aAAa,oBAAoB;;EAEjC,kBAAkB,OAAO,qBAAqB,SAAS,2BAA2B,QAAQ;;EAE1F,YAAY,kBAAkB,kBAAkB,sBAAsB,UAAU,iBAAiB;EACjG,uBAAuB;EACvB,eAAe,eAAe,QAAQ;EACtC,gBAAgB,sBAAsB;EACtC,WAAW,OAAO,cAAc,kBAAkB,SAAS,UAAU,QAAQ;EAC7E,aAAa,eAAe,WAAW,qBAAqB,SAAS,mBAAmB;EACxF,gBAAgB,SAAS,gBAAgB,QAAQ;EACjD;EACA,cAAc,oBAAoB;IAAQ;IAAc;IAAmB;;;EAE3E,cAAc,mBAAmB;EACjC,eAAe,mBAAmB,mBAAmB,kBAAkB;EACvE,mBAAmB;EACnB,SAAS;;;wBAmBK,kBAAkB,SAAS,qBAAqB"}

package/dist/headless-hub.d.mts

@@ -0,0 +1,96 @@
+import { DoomDirectEventBus, DoomHubChannel, DoomHubSessionApiRequest, DoomHubSessionCreateRequest, DoomHubSessionScope, DoomHubSessionService } from "./schemas/hubChannel.mjs";
+import { DoomApiContext, DoomApiMount, DoomWebComposition } from "./schemas/packageApi.mjs";
+import { DoomPluginCaller, DoomPluginDirection } from "./schemas/pluginProtocol.mjs";
+import { DoomServerFacet } from "./schemas/serverFacet.mjs";
+import { LoadedServerFacet } from "./server/serverFacetLoader.mjs";
+import "./server-facet.mjs";
+import "./package-api.mjs";
+import { HeadlessSessionHost, HeadlessSessionHostOptions } from "./headless-session-host.mjs";
+import { HeadlessSessionManager } from "./runtime-headless-session-manager.mjs";
+import "./plugin-protocol.mjs";
+//#region src/server/headlessHub.d.ts
+export interface HeadlessHubSession {
+  readonly id: string;
+  readonly workspaceId?: string;
+  webComposition?: DoomWebComposition;
+  readonly name: string;
+  readonly cwd: string;
+  readonly createdAt: string;
+  readonly parentSessionId?: string;
+  readonly sessionProvenance?: string;
+  readonly updatedAt?: string;
+  readonly phase?: 'idle' | 'turn' | 'compaction' | 'retry';
+  readonly phaseSince?: string;
+  readonly pendingMessageCount?: number;
+  readonly everPrompted?: boolean;
+  readonly awaitingInput?: boolean;
+  readonly lastSettledAt?: string;
+  /** Environment admitted for this session, when supplied by the host. */
+  readonly environment?: Readonly<Record<string, string | undefined>>;
+  readonly host: HeadlessSessionHost;
+}
+export interface HeadlessWorkspace {
+  readonly id: string;
+  readonly root: string;
+}
+export type HeadlessHubEvent = {
+  kind: 'upsert';
+  session: HeadlessHubSession;
+} | {
+  kind: 'removed';
+  sessionId: string;
+} | {
+  kind: 'channel';
+  frameType: string;
+  sessionId: string;
+  payload: unknown;
+  connectionId?: string;
+};
+export interface HeadlessHubOptions {
+  manager: HeadlessSessionManager;
+  hubToken?: string;
+  /** Creates a session through the canonical cockpit lifecycle for hub channels. */
+  createSession?: (request: DoomHubSessionCreateRequest) => Promise<DoomHubSessionScope>;
+  onNotice?: (message: string) => void;
+  requestSessionApi?: (scope: DoomHubSessionScope, request: DoomHubSessionApiRequest) => Promise<Response>;
+  admitWorkspace?: (root: string) => Promise<HeadlessWorkspace>;
+  onWorkspaceRemoved?: (workspaceId: string) => void;
+}
+export interface HeadlessHub {
+  /** Canonical direct lifecycle shared by hub channels, APIs, and sessions. */
+  readonly sessionService: DoomHubSessionService;
+  /** Lifecycle-owned event path shared by session facets and hub channels. */
+  readonly directEvents: DoomDirectEventBus;
+  snapshot(): readonly HeadlessHubSession[];
+  session(sessionId: string): HeadlessHubSession | undefined;
+  runtime(sessionId: string): HeadlessSessionHost['runtime'] | undefined;
+  onEvent(listener: (event: HeadlessHubEvent) => void): () => void;
+  register(session: HeadlessHubSession): void;
+  create(options: HeadlessSessionHostOptions): Promise<HeadlessHubSession>;
+  closeSession(sessionId: string): Promise<void>;
+  /** Dispatches an authenticated package API request inside the owning process. */
+  requestSessionApi(scope: DoomHubSessionScope, request: DoomHubSessionApiRequest): Promise<Response>;
+  /** Mounts the selected hub facets once, before the headless server accepts clients. */
+  mountFacets(facets: readonly (DoomServerFacet | LoadedServerFacet)[], context?: DoomApiContext): Promise<void>;
+  workspaces(): readonly HeadlessWorkspace[];
+  admitWorkspace(root: string): Promise<HeadlessWorkspace>;
+  removeWorkspace(workspaceId: string): Promise<void>;
+  requestApi(mount: DoomApiMount, basePath: string, request: Request): Promise<Response>;
+  invokePlugin(call: unknown, direction: DoomPluginDirection, caller?: DoomPluginCaller): Promise<unknown>;
+  registerChannel(channel: DoomHubChannel, mount?: DoomApiMount): () => void;
+  channelTypes(): readonly string[];
+  channelFrames(sessionId: string): Array<{
+    type: string;
+    sessionId: string;
+    payload: unknown;
+  }>;
+  /** Resolves a channel-owned child journal for the browser thread projection. */
+  threadJournal(sessionId: string, threadId: string): string | undefined;
+  receiveChannel(sessionId: string, frameType: string, payload: unknown, connectionId: string): void;
+  disconnectChannels(connectionId: string): void;
+  close(): Promise<void>;
+}
+/** Owns direct, same-process session and channel state for presentation adapters. */
+export declare function createHeadlessHub(options: HeadlessHubOptions): HeadlessHub;
+//#endregion
+//# sourceMappingURL=headless-hub.d.mts.map

package/dist/headless-hub.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-hub.d.mts","names":[],"sources":["../src/server/headlessHub.ts"],"mappings":";;;;;;;;;;;iBAwBiB;WACN;WACA;EACT,iBAAiB;WACR;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;WAEA,cAAc,SAAS;WACvB,MAAM;;iBAGA;WACN;WACA;;YAGC;EACN;EAAgB,SAAS;;EACzB;EAAiB;;EACjB;EAAiB;EAAmB;EAAmB;EAAkB;;iBAE9D;EACf,SAAS;EACT;;EAEA,iBAAiB,SAAS,gCAAgC,QAAQ;EAClE,YAAY;EACZ,qBAAqB,OAAO,qBAAqB,SAAS,6BAA6B,QAAQ;EAC/F,kBAAkB,iBAAiB,QAAQ;EAC3C,sBAAsB;;iBAGP;;WAEN,gBAAgB;;WAEhB,cAAc;EACvB,qBAAqB;EACrB,QAAQ,oBAAoB;EAC5B,QAAQ,oBAAoB;EAC5B,QAAQ,WAAW,OAAO;EAC1B,SAAS,SAAS;EAClB,OAAO,SAAS,6BAA6B,QAAQ;EACrD,aAAa,oBAAoB;;EAEjC,kBAAkB,OAAO,qBAAqB,SAAS,2BAA2B,QAAQ;;EAE1F,YAAY,kBAAkB,kBAAkB,sBAAsB,UAAU,iBAAiB;EACjG,uBAAuB;EACvB,eAAe,eAAe,QAAQ;EACtC,gBAAgB,sBAAsB;EACtC,WAAW,OAAO,cAAc,kBAAkB,SAAS,UAAU,QAAQ;EAC7E,aAAa,eAAe,WAAW,qBAAqB,SAAS,mBAAmB;EACxF,gBAAgB,SAAS,gBAAgB,QAAQ;EACjD;EACA,cAAc,oBAAoB;IAAQ;IAAc;IAAmB;;;EAE3E,cAAc,mBAAmB;EACjC,eAAe,mBAAmB,mBAAmB,kBAAkB;EACvE,mBAAmB;EACnB,SAAS;;;wBAmBK,kBAAkB,SAAS,qBAAqB"}