@aigne/afs-ui 1.11.0-beta.12

package/dist/web.d.cts

@@ -0,0 +1,144 @@
+import { PromptOptions, PromptResult, ReadOptions, UIBackend, ViewportInfo, WriteOptions } from "./backend.cjs";
+import { TTYInputSource } from "./tty.cjs";
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/web.d.ts
+interface WebBackendOptions {
+  /** Port to listen on (0 = OS-assigned random port) */
+  port?: number;
+  /** Host to bind to */
+  host?: string;
+  /** For testing: custom input source (bypasses WebSocket) */
+  inputSource?: TTYInputSource & {
+    push?: (line: string) => void;
+  };
+  /** For testing: custom output handler (bypasses WebSocket) */
+  stdout?: {
+    write(data: string): boolean;
+  };
+}
+/**
+ * WebBackend — HTTP + WebSocket based browser UI.
+ *
+ * Serves a web page and communicates with it via WebSocket.
+ * For agent code, this behaves identically to TTYBackend — pure text I/O.
+ *
+ * For testing, accepts an inputSource/stdout to bypass WebSocket entirely.
+ */
+declare class WebBackend implements UIBackend {
+  readonly type = "web";
+  readonly supportedFormats: string[];
+  readonly capabilities: string[];
+  private static readonly KNOWN_COMPONENTS;
+  private port;
+  private host;
+  private server;
+  private wss;
+  private clients;
+  /** Track all TCP sockets so we can force-destroy on close */
+  private sockets;
+  /** Input queue — fed by WebSocket messages or test inputSource */
+  private inputSource;
+  /** Output handler — sends to WebSocket clients or test stdout */
+  private outputHandler;
+  /** Queue for messages sent before any client connects */
+  private pendingMessages;
+  /** Pending prompt resolve — only one prompt at a time */
+  private promptResolve;
+  /** Pending prompt message — re-sent on client reconnect */
+  private pendingPromptMessage;
+  private testMode;
+  private _url;
+  /** Per-client session tracking */
+  private sessionForClient;
+  /** Per-client session token tracking */
+  private sessionTokenForClient;
+  private createSessionCallback;
+  /** AUP event handler callback */
+  private aupEventHandler;
+  /** Page resolver callback — returns page content for HTTP serving */
+  private pageResolver;
+  /** Snapshot resolver callback — returns snapshot HTML for a sharing slug */
+  private snapshotResolver;
+  /** AFS root instance — injected via setAFS() when provider is mounted */
+  private afs;
+  /** Per-client AFS event subscriptions: ws → subId → unsubscribe */
+  private clientSubscriptions;
+  /** Live channel subscribers: channelId → set of viewer WebSockets */
+  private channelSubscribers;
+  /** Reverse map: ws → channelId (only for channel viewers) */
+  private channelForClient;
+  /** Callback invoked when a viewer joins a channel — provider sends snapshot */
+  private channelJoinHandler;
+  /** Callback invoked when a client joins/reconnects a session — provider sends snapshot if stale */
+  private sessionJoinHandler;
+  constructor(options?: WebBackendOptions);
+  /** URL of the running server, or null if not started. */
+  get url(): string | null;
+  /** Register a factory that creates or reattaches a session for each new WebSocket client. */
+  setSessionFactory(fn: (endpoint: string, requestedSessionId?: string, requestedSessionToken?: string, caps?: Record<string, unknown>) => {
+    sessionId: string;
+    sessionToken?: string;
+  }): void;
+  /** Broadcast a raw JSON-serializable message to all connected clients. */
+  broadcastRaw(msg: Record<string, unknown>): void;
+  /** Send a raw JSON message to the client that owns a specific session. */
+  sendToSession(sessionId: string, msg: Record<string, unknown>): void;
+  /** Send a raw JSON message to all viewers of a live channel. */
+  sendToLiveChannel(channelId: string, msg: Record<string, unknown>): void;
+  /** Register a handler called when a viewer joins a channel (for snapshot delivery). */
+  setChannelJoinHandler(fn: (channelId: string, send: (msg: Record<string, unknown>) => void) => void): void;
+  /** Register a handler called when a client joins/reconnects a session (for snapshot replay). */
+  setSessionJoinHandler(fn: (sessionId: string, clientVersion: number, send: (msg: Record<string, unknown>) => void) => void): void;
+  /** Return the set of active channel IDs. */
+  getActiveChannelIds(): string[];
+  /** Register a handler for AUP events from clients. */
+  setAupEventHandler(fn: (msg: {
+    nodeId: string;
+    event: string;
+    data?: Record<string, unknown>;
+  }, sessionId?: string, channelId?: string) => Promise<unknown>): void;
+  /** Inject the AFS root for browser AFS proxy operations. */
+  setAFS(afs: AFSRoot): void;
+  /** Register a resolver for serving pages via HTTP (/p/:id). */
+  setPageResolver(fn: (pageId: string, sessionId?: string, sessionToken?: string) => Promise<{
+    content: string;
+    format: string;
+  } | null>): void;
+  /** Set the snapshot resolver for web sharing. */
+  setSnapshotResolver(fn: (slug: string) => string | null): void;
+  /** Start the HTTP + WebSocket server. */
+  listen(): Promise<{
+    port: number;
+    host: string;
+  }>;
+  /** Shut down the server and disconnect all clients. */
+  close(): Promise<void>;
+  write(content: string, options?: WriteOptions): Promise<void>;
+  read(options?: ReadOptions): Promise<string>;
+  prompt(options: PromptOptions): Promise<PromptResult>;
+  notify(message: string): Promise<void>;
+  navigate(pageId: string, content: string, format?: string, layout?: Record<string, string>): Promise<void>;
+  clear(): Promise<void>;
+  hasPendingInput(): boolean;
+  getViewport(): ViewportInfo;
+  dispose(): Promise<void>;
+  private onConnection;
+  /** Handle the first WS message as a typed handshake. */
+  private onHandshake;
+  private onMessage;
+  /** Handle AFS proxy messages from browser clients. */
+  private handleAfsMessage;
+  /** Serve a page as standalone HTML via /p/:id[?sid=xxx][&st=xxx][&bridge=1] */
+  private handlePageRequest;
+  /** Handle HTTP GET /s/:slug — serve snapshot HTML for a sharing entry */
+  private handleSnapshotRequest;
+  private broadcast;
+  private isLoopbackHost;
+  private isAllowedWsOrigin;
+  /** TTY-style prompt for test mode (reuses TTYBackend logic) */
+  private ttyStylePrompt;
+}
+//#endregion
+export { WebBackend, WebBackendOptions };
+//# sourceMappingURL=web.d.cts.map

package/dist/web.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.cts","names":[],"sources":["../src/web.ts"],"mappings":"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"}

package/dist/web.d.mts

@@ -0,0 +1,144 @@
+import { PromptOptions, PromptResult, ReadOptions, UIBackend, ViewportInfo, WriteOptions } from "./backend.mjs";
+import { TTYInputSource } from "./tty.mjs";
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/web.d.ts
+interface WebBackendOptions {
+  /** Port to listen on (0 = OS-assigned random port) */
+  port?: number;
+  /** Host to bind to */
+  host?: string;
+  /** For testing: custom input source (bypasses WebSocket) */
+  inputSource?: TTYInputSource & {
+    push?: (line: string) => void;
+  };
+  /** For testing: custom output handler (bypasses WebSocket) */
+  stdout?: {
+    write(data: string): boolean;
+  };
+}
+/**
+ * WebBackend — HTTP + WebSocket based browser UI.
+ *
+ * Serves a web page and communicates with it via WebSocket.
+ * For agent code, this behaves identically to TTYBackend — pure text I/O.
+ *
+ * For testing, accepts an inputSource/stdout to bypass WebSocket entirely.
+ */
+declare class WebBackend implements UIBackend {
+  readonly type = "web";
+  readonly supportedFormats: string[];
+  readonly capabilities: string[];
+  private static readonly KNOWN_COMPONENTS;
+  private port;
+  private host;
+  private server;
+  private wss;
+  private clients;
+  /** Track all TCP sockets so we can force-destroy on close */
+  private sockets;
+  /** Input queue — fed by WebSocket messages or test inputSource */
+  private inputSource;
+  /** Output handler — sends to WebSocket clients or test stdout */
+  private outputHandler;
+  /** Queue for messages sent before any client connects */
+  private pendingMessages;
+  /** Pending prompt resolve — only one prompt at a time */
+  private promptResolve;
+  /** Pending prompt message — re-sent on client reconnect */
+  private pendingPromptMessage;
+  private testMode;
+  private _url;
+  /** Per-client session tracking */
+  private sessionForClient;
+  /** Per-client session token tracking */
+  private sessionTokenForClient;
+  private createSessionCallback;
+  /** AUP event handler callback */
+  private aupEventHandler;
+  /** Page resolver callback — returns page content for HTTP serving */
+  private pageResolver;
+  /** Snapshot resolver callback — returns snapshot HTML for a sharing slug */
+  private snapshotResolver;
+  /** AFS root instance — injected via setAFS() when provider is mounted */
+  private afs;
+  /** Per-client AFS event subscriptions: ws → subId → unsubscribe */
+  private clientSubscriptions;
+  /** Live channel subscribers: channelId → set of viewer WebSockets */
+  private channelSubscribers;
+  /** Reverse map: ws → channelId (only for channel viewers) */
+  private channelForClient;
+  /** Callback invoked when a viewer joins a channel — provider sends snapshot */
+  private channelJoinHandler;
+  /** Callback invoked when a client joins/reconnects a session — provider sends snapshot if stale */
+  private sessionJoinHandler;
+  constructor(options?: WebBackendOptions);
+  /** URL of the running server, or null if not started. */
+  get url(): string | null;
+  /** Register a factory that creates or reattaches a session for each new WebSocket client. */
+  setSessionFactory(fn: (endpoint: string, requestedSessionId?: string, requestedSessionToken?: string, caps?: Record<string, unknown>) => {
+    sessionId: string;
+    sessionToken?: string;
+  }): void;
+  /** Broadcast a raw JSON-serializable message to all connected clients. */
+  broadcastRaw(msg: Record<string, unknown>): void;
+  /** Send a raw JSON message to the client that owns a specific session. */
+  sendToSession(sessionId: string, msg: Record<string, unknown>): void;
+  /** Send a raw JSON message to all viewers of a live channel. */
+  sendToLiveChannel(channelId: string, msg: Record<string, unknown>): void;
+  /** Register a handler called when a viewer joins a channel (for snapshot delivery). */
+  setChannelJoinHandler(fn: (channelId: string, send: (msg: Record<string, unknown>) => void) => void): void;
+  /** Register a handler called when a client joins/reconnects a session (for snapshot replay). */
+  setSessionJoinHandler(fn: (sessionId: string, clientVersion: number, send: (msg: Record<string, unknown>) => void) => void): void;
+  /** Return the set of active channel IDs. */
+  getActiveChannelIds(): string[];
+  /** Register a handler for AUP events from clients. */
+  setAupEventHandler(fn: (msg: {
+    nodeId: string;
+    event: string;
+    data?: Record<string, unknown>;
+  }, sessionId?: string, channelId?: string) => Promise<unknown>): void;
+  /** Inject the AFS root for browser AFS proxy operations. */
+  setAFS(afs: AFSRoot): void;
+  /** Register a resolver for serving pages via HTTP (/p/:id). */
+  setPageResolver(fn: (pageId: string, sessionId?: string, sessionToken?: string) => Promise<{
+    content: string;
+    format: string;
+  } | null>): void;
+  /** Set the snapshot resolver for web sharing. */
+  setSnapshotResolver(fn: (slug: string) => string | null): void;
+  /** Start the HTTP + WebSocket server. */
+  listen(): Promise<{
+    port: number;
+    host: string;
+  }>;
+  /** Shut down the server and disconnect all clients. */
+  close(): Promise<void>;
+  write(content: string, options?: WriteOptions): Promise<void>;
+  read(options?: ReadOptions): Promise<string>;
+  prompt(options: PromptOptions): Promise<PromptResult>;
+  notify(message: string): Promise<void>;
+  navigate(pageId: string, content: string, format?: string, layout?: Record<string, string>): Promise<void>;
+  clear(): Promise<void>;
+  hasPendingInput(): boolean;
+  getViewport(): ViewportInfo;
+  dispose(): Promise<void>;
+  private onConnection;
+  /** Handle the first WS message as a typed handshake. */
+  private onHandshake;
+  private onMessage;
+  /** Handle AFS proxy messages from browser clients. */
+  private handleAfsMessage;
+  /** Serve a page as standalone HTML via /p/:id[?sid=xxx][&st=xxx][&bridge=1] */
+  private handlePageRequest;
+  /** Handle HTTP GET /s/:slug — serve snapshot HTML for a sharing entry */
+  private handleSnapshotRequest;
+  private broadcast;
+  private isLoopbackHost;
+  private isAllowedWsOrigin;
+  /** TTY-style prompt for test mode (reuses TTYBackend logic) */
+  private ttyStylePrompt;
+}
+//#endregion
+export { WebBackend, WebBackendOptions };
+//# sourceMappingURL=web.d.mts.map

package/dist/web.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.mts","names":[],"sources":["../src/web.ts"],"mappings":"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"}