@aigne/afs-ui 1.11.0-beta.12

package/dist/ui-provider.d.cts

@@ -0,0 +1,307 @@
+import { UIBackend } from "./backend.cjs";
+import { SessionManager } from "./session.cjs";
+import { TTYBackendOptions } from "./tty.cjs";
+import { TermBackendOptions } from "./term.cjs";
+import { WebBackendOptions } from "./web.cjs";
+import { AFSAccessMode, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSListResult, AFSRoot, AFSStatResult, AFSWriteResult, ProviderManifest, ProviderTreeSchema } from "@aigne/afs";
+import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
+import { z } from "zod";
+
+//#region src/ui-provider.d.ts
+interface AFSUIProviderOptions {
+  name?: string;
+  description?: string;
+  backend?: "tty" | "web" | "term" | UIBackend;
+  /** TTY backend options (only used when backend is "tty" and no web server needed) */
+  ttyOptions?: TTYBackendOptions;
+  /** Web backend options (only used when backend is "web") */
+  webOptions?: WebBackendOptions;
+  /** Term backend options (only used when backend is "term") */
+  termOptions?: TermBackendOptions;
+  /** Input timeout in ms (0 = no timeout) */
+  inputTimeout?: number;
+  /** Directory to persist pages (default: .afs-ui/pages). Set false to disable. */
+  pagesDir?: string | false;
+}
+declare class AFSUIProvider extends AFSBaseProvider {
+  readonly name: string;
+  readonly description: string;
+  readonly accessMode: AFSAccessMode;
+  private backend;
+  private inputTimeout;
+  private pages;
+  private pagesDir;
+  private initPromise;
+  private serverUrl;
+  /** Web sharing entries: slug -> SharingEntry */
+  private sharingEntries;
+  /** Session management */
+  readonly sessions: SessionManager;
+  /** Per-session AUP node stores */
+  private aupStores;
+  /** Per-session AUP scene managers (for stage-to-live dual buffer) */
+  private aupManagers;
+  /** AFS root reference for auto-dispatching AUP events to afs.exec() */
+  private afsRoot;
+  /** Endpoint type derived from backend (tty, web, term) */
+  readonly endpointType: string;
+  /** External callback for AUP events — allows app code to handle navigation etc. */
+  onAupEvent?: (sessionId: string, nodeId: string, event: string, config: {
+    exec: string;
+    args: Record<string, unknown>;
+  }) => Promise<unknown> | unknown;
+  constructor(options?: AFSUIProviderOptions);
+  /** Inject AFS root into AUP transport for browser AFS proxy + discover pages dir. */
+  onMount(root: AFSRoot, _mountPath?: string): void;
+  /** Discover workspace path from AFS root meta, then load persisted pages. */
+  private discoverAndLoadPages;
+  /** Load persisted page files from disk into the pages Map. */
+  private loadPagesFromDisk;
+  /** Persist a page to disk as a plain file (best-effort). */
+  private persistPageToDisk;
+  /** Remove a persisted page from disk (best-effort). */
+  private removePageFromDisk;
+  /** Assert the endpoint param matches this provider's type */
+  private assertEndpoint;
+  /** Resolve session from route params, throwing if not found */
+  private resolveSession;
+  /** Get or create AUP node store for a session */
+  private getAupStore;
+  /** Get or create AUP scene manager for a session */
+  private getAupManager;
+  /** Get the WM node from the AUP tree, or null if it doesn't exist yet. */
+  private getWmNode;
+  /**
+   * Ensure a WM node exists in the session's AUP tree.
+   * Creates a minimal root + wm node if the tree is empty.
+   */
+  private ensureWmNode;
+  /**
+   * Apply WM-related AUP patch ops and notify the client.
+   */
+  private applyWmPatch;
+  /** Find a WM surface child node by surface name. */
+  private findWmSurface;
+  /**
+   * Handle built-in WM events from client-side panel interactions.
+   * Returns undefined if the event is not a WM-specific event.
+   */
+  private handleWmEvent;
+  /**
+   * Apply WM patch directly without needing a RouteContext.
+   * Used for client-initiated WM events.
+   */
+  private applyWmPatchDirect;
+  /** AUP store key for a live channel */
+  private channelAupKey;
+  /** Get or create AUP node store for a live channel */
+  private getChannelAupStore;
+  /** Degrade an AUP root for a session's device capabilities (D14). */
+  private degradeForSession;
+  /** Count active live channels (stores with live: prefix that have content) */
+  private getActiveChannelCount;
+  /** List active channel IDs */
+  private getActiveChannelIds;
+  /** Handle an AUP event from a client — resolve exec path and call it */
+  private handleAupEvent;
+  static schema(): z.ZodObject<{
+    backend: z.ZodDefault<z.ZodEnum<{
+      tty: "tty";
+      term: "term";
+      web: "web";
+    }>>;
+    port: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  }, z.core.$strip>;
+  static manifest(): ProviderManifest;
+  static treeSchema(): ProviderTreeSchema;
+  readCapabilities(_ctx: RouteContext): Promise<AFSEntry>;
+  metaRoot(_ctx: RouteContext): Promise<AFSEntry>;
+  metaInput(_ctx: RouteContext): Promise<AFSEntry>;
+  metaOutput(_ctx: RouteContext): Promise<AFSEntry>;
+  metaPages(_ctx: RouteContext): Promise<AFSEntry>;
+  metaPage(ctx: RouteContext): Promise<AFSEntry>;
+  listInput(_ctx: RouteContext): Promise<AFSListResult>;
+  listOutput(_ctx: RouteContext): Promise<AFSListResult>;
+  listPages(_ctx: RouteContext): Promise<AFSListResult>;
+  listRoot(_ctx: RouteContext): Promise<AFSListResult>;
+  readRoot(_ctx: RouteContext): Promise<AFSEntry>;
+  readInput(_ctx: RouteContext): Promise<AFSEntry>;
+  readOutput(_ctx: RouteContext): Promise<AFSEntry>;
+  readPages(_ctx: RouteContext): Promise<AFSEntry>;
+  readPage(ctx: RouteContext): Promise<AFSEntry>;
+  listPrimitives(_ctx: RouteContext): Promise<AFSListResult>;
+  readPrimitivesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statPrimitivesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaPrimitivesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readPrimitive(ctx: RouteContext): Promise<AFSEntry>;
+  statPrimitive(ctx: RouteContext): Promise<AFSStatResult>;
+  metaPrimitive(ctx: RouteContext): Promise<AFSEntry>;
+  listThemes(_ctx: RouteContext): Promise<AFSListResult>;
+  readThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statThemesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readTheme(ctx: RouteContext): Promise<AFSEntry>;
+  statTheme(ctx: RouteContext): Promise<AFSStatResult>;
+  metaTheme(ctx: RouteContext): Promise<AFSEntry>;
+  listOverlayThemes(_ctx: RouteContext): Promise<AFSListResult>;
+  readOverlayThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statOverlayThemesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaOverlayThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readOverlayTheme(ctx: RouteContext): Promise<AFSEntry>;
+  statOverlayTheme(ctx: RouteContext): Promise<AFSStatResult>;
+  metaOverlayTheme(ctx: RouteContext): Promise<AFSEntry>;
+  listOverlayExamples(ctx: RouteContext): Promise<AFSListResult>;
+  readOverlayExample(ctx: RouteContext): Promise<AFSEntry>;
+  readSpec(_ctx: RouteContext): Promise<AFSEntry>;
+  statSpec(_ctx: RouteContext): Promise<AFSStatResult>;
+  listSpec(_ctx: RouteContext): Promise<AFSListResult>;
+  metaSpec(_ctx: RouteContext): Promise<AFSEntry>;
+  explainSpec(_ctx: RouteContext): Promise<AFSExplainResult>;
+  listExamples(_ctx: RouteContext): Promise<AFSListResult>;
+  readExamplesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statExamplesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaExamplesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readExample(ctx: RouteContext): Promise<AFSEntry>;
+  statExample(ctx: RouteContext): Promise<AFSStatResult>;
+  metaExample(ctx: RouteContext): Promise<AFSEntry>;
+  writeOutput(_ctx: RouteContext, payload: {
+    content?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  writePage(ctx: RouteContext, payload: {
+    content?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  deletePage(ctx: RouteContext): Promise<AFSDeleteResult>;
+  /** Validate and parse a sharing entry payload */
+  private parseSharingPayload;
+  writeSharingEntry(ctx: RouteContext, payload: {
+    content?: unknown;
+  }): Promise<AFSWriteResult>;
+  readSharingEntry(ctx: RouteContext): Promise<AFSEntry>;
+  readSharingDir(_ctx: RouteContext): Promise<AFSEntry>;
+  listSharingEntries(_ctx: RouteContext): Promise<AFSListResult>;
+  deleteSharingEntry(ctx: RouteContext): Promise<AFSDeleteResult>;
+  metaSharingDir(_ctx: RouteContext): Promise<AFSEntry>;
+  metaSharingEntry(ctx: RouteContext): Promise<AFSEntry>;
+  statSharingDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  statSharingEntry(ctx: RouteContext): Promise<AFSStatResult>;
+  listSharingActions(ctx: RouteContext): Promise<AFSListResult>;
+  execSharingSnapshot(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  statRoot(_ctx: RouteContext): Promise<AFSStatResult>;
+  statInput(_ctx: RouteContext): Promise<AFSStatResult>;
+  statOutput(_ctx: RouteContext): Promise<AFSStatResult>;
+  statPages(_ctx: RouteContext): Promise<AFSStatResult>;
+  statPage(ctx: RouteContext): Promise<AFSStatResult>;
+  explainRoot(_ctx: RouteContext): Promise<AFSExplainResult>;
+  explainInput(_ctx: RouteContext): Promise<AFSExplainResult>;
+  explainOutput(_ctx: RouteContext): Promise<AFSExplainResult>;
+  explainPages(_ctx: RouteContext): Promise<AFSExplainResult>;
+  readEndpoint(ctx: RouteContext): Promise<AFSEntry>;
+  statEndpoint(ctx: RouteContext): Promise<AFSStatResult>;
+  listEndpoint(ctx: RouteContext): Promise<AFSListResult>;
+  metaEndpoint(ctx: RouteContext): Promise<AFSEntry>;
+  readSessions(ctx: RouteContext): Promise<AFSEntry>;
+  metaSessions(ctx: RouteContext): Promise<AFSEntry>;
+  listSessions(_ctx: RouteContext): Promise<AFSListResult>;
+  listSession(ctx: RouteContext): Promise<AFSListResult>;
+  readSession(ctx: RouteContext): Promise<AFSEntry>;
+  metaSession(ctx: RouteContext): Promise<AFSEntry>;
+  statSession(ctx: RouteContext): Promise<AFSStatResult>;
+  listSessionMessages(ctx: RouteContext): Promise<AFSListResult>;
+  readSessionMessage(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionMessage(ctx: RouteContext, payload: {
+    content?: unknown;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  listSessionPages(ctx: RouteContext): Promise<AFSListResult>;
+  readSessionPage(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionPage(ctx: RouteContext, payload: {
+    content?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  readSessionCaps(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionCaps(ctx: RouteContext, payload: {
+    content?: unknown;
+  }): Promise<AFSWriteResult>;
+  readSessionTree(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionTree(ctx: RouteContext, payload: {
+    content?: unknown;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  readSessionWm(ctx: RouteContext): Promise<AFSEntry>;
+  listSessionWm(ctx: RouteContext): Promise<AFSListResult>;
+  readWmStrategy(ctx: RouteContext): Promise<AFSEntry>;
+  writeWmStrategy(ctx: RouteContext, payload: {
+    content?: unknown;
+  }): Promise<AFSWriteResult>;
+  readWmLayout(ctx: RouteContext): Promise<AFSEntry>;
+  listWmSurfaces(ctx: RouteContext): Promise<AFSListResult>;
+  readWmSurface(ctx: RouteContext): Promise<AFSEntry>;
+  listWmActions(ctx: RouteContext): Promise<AFSListResult>;
+  execWmOpenSurface(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetSurfaceContent(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmCloseSurface(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetStrategy(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetActive(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmPinToDock(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmUnpinFromDock(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetLayout(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmCollapsePanel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmExpandPanel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmMoveSurface(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmAddToPanel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetPanelActive(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmPopout(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmRedock(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmAutoArrange(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  explainSession(ctx: RouteContext): Promise<AFSExplainResult>;
+  /** Assert web endpoint and return channelId from params */
+  private assertLiveChannel;
+  listLiveChannels(ctx: RouteContext): Promise<AFSListResult>;
+  readLiveDirectory(ctx: RouteContext): Promise<AFSEntry>;
+  metaLiveDirectory(ctx: RouteContext): Promise<AFSEntry>;
+  readLiveChannel(ctx: RouteContext): Promise<AFSEntry>;
+  metaLiveChannel(ctx: RouteContext): Promise<AFSEntry>;
+  listLiveChannel(ctx: RouteContext): Promise<AFSListResult>;
+  readLiveChannelTree(ctx: RouteContext): Promise<AFSEntry>;
+  metaLiveChannelTree(ctx: RouteContext): Promise<AFSEntry>;
+  writeLiveChannelTree(ctx: RouteContext, payload: {
+    content?: unknown;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  listLiveChannelActions(ctx: RouteContext): Promise<AFSListResult>;
+  execLiveChannelAupRender(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execLiveChannelAupPatch(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  private sessionActionEntries;
+  listSessionActions(ctx: RouteContext): Promise<AFSListResult>;
+  execSessionPrompt(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionForm(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionDialog(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionTable(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionToast(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionProgress(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionClear(ctx: RouteContext, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionNavigate(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionNotify(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupRender(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupPatch(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupSave(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupLoad(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupStage(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupTake(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupRelease(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  listActions(_ctx: RouteContext): Promise<AFSListResult>;
+  execPrompt(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execClear(_ctx: RouteContext, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  execNotify(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execNavigate(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execDialog(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execProgress(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execForm(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execTable(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execToast(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+}
+//#endregion
+export { AFSUIProvider, AFSUIProviderOptions };
+//# sourceMappingURL=ui-provider.d.cts.map

package/dist/ui-provider.d.cts.map

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

package/dist/ui-provider.d.mts

@@ -0,0 +1,307 @@
+import { UIBackend } from "./backend.mjs";
+import { SessionManager } from "./session.mjs";
+import { TTYBackendOptions } from "./tty.mjs";
+import { TermBackendOptions } from "./term.mjs";
+import { WebBackendOptions } from "./web.mjs";
+import { AFSAccessMode, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSListResult, AFSRoot, AFSStatResult, AFSWriteResult, ProviderManifest, ProviderTreeSchema } from "@aigne/afs";
+import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
+import { z } from "zod";
+
+//#region src/ui-provider.d.ts
+interface AFSUIProviderOptions {
+  name?: string;
+  description?: string;
+  backend?: "tty" | "web" | "term" | UIBackend;
+  /** TTY backend options (only used when backend is "tty" and no web server needed) */
+  ttyOptions?: TTYBackendOptions;
+  /** Web backend options (only used when backend is "web") */
+  webOptions?: WebBackendOptions;
+  /** Term backend options (only used when backend is "term") */
+  termOptions?: TermBackendOptions;
+  /** Input timeout in ms (0 = no timeout) */
+  inputTimeout?: number;
+  /** Directory to persist pages (default: .afs-ui/pages). Set false to disable. */
+  pagesDir?: string | false;
+}
+declare class AFSUIProvider extends AFSBaseProvider {
+  readonly name: string;
+  readonly description: string;
+  readonly accessMode: AFSAccessMode;
+  private backend;
+  private inputTimeout;
+  private pages;
+  private pagesDir;
+  private initPromise;
+  private serverUrl;
+  /** Web sharing entries: slug -> SharingEntry */
+  private sharingEntries;
+  /** Session management */
+  readonly sessions: SessionManager;
+  /** Per-session AUP node stores */
+  private aupStores;
+  /** Per-session AUP scene managers (for stage-to-live dual buffer) */
+  private aupManagers;
+  /** AFS root reference for auto-dispatching AUP events to afs.exec() */
+  private afsRoot;
+  /** Endpoint type derived from backend (tty, web, term) */
+  readonly endpointType: string;
+  /** External callback for AUP events — allows app code to handle navigation etc. */
+  onAupEvent?: (sessionId: string, nodeId: string, event: string, config: {
+    exec: string;
+    args: Record<string, unknown>;
+  }) => Promise<unknown> | unknown;
+  constructor(options?: AFSUIProviderOptions);
+  /** Inject AFS root into AUP transport for browser AFS proxy + discover pages dir. */
+  onMount(root: AFSRoot, _mountPath?: string): void;
+  /** Discover workspace path from AFS root meta, then load persisted pages. */
+  private discoverAndLoadPages;
+  /** Load persisted page files from disk into the pages Map. */
+  private loadPagesFromDisk;
+  /** Persist a page to disk as a plain file (best-effort). */
+  private persistPageToDisk;
+  /** Remove a persisted page from disk (best-effort). */
+  private removePageFromDisk;
+  /** Assert the endpoint param matches this provider's type */
+  private assertEndpoint;
+  /** Resolve session from route params, throwing if not found */
+  private resolveSession;
+  /** Get or create AUP node store for a session */
+  private getAupStore;
+  /** Get or create AUP scene manager for a session */
+  private getAupManager;
+  /** Get the WM node from the AUP tree, or null if it doesn't exist yet. */
+  private getWmNode;
+  /**
+   * Ensure a WM node exists in the session's AUP tree.
+   * Creates a minimal root + wm node if the tree is empty.
+   */
+  private ensureWmNode;
+  /**
+   * Apply WM-related AUP patch ops and notify the client.
+   */
+  private applyWmPatch;
+  /** Find a WM surface child node by surface name. */
+  private findWmSurface;
+  /**
+   * Handle built-in WM events from client-side panel interactions.
+   * Returns undefined if the event is not a WM-specific event.
+   */
+  private handleWmEvent;
+  /**
+   * Apply WM patch directly without needing a RouteContext.
+   * Used for client-initiated WM events.
+   */
+  private applyWmPatchDirect;
+  /** AUP store key for a live channel */
+  private channelAupKey;
+  /** Get or create AUP node store for a live channel */
+  private getChannelAupStore;
+  /** Degrade an AUP root for a session's device capabilities (D14). */
+  private degradeForSession;
+  /** Count active live channels (stores with live: prefix that have content) */
+  private getActiveChannelCount;
+  /** List active channel IDs */
+  private getActiveChannelIds;
+  /** Handle an AUP event from a client — resolve exec path and call it */
+  private handleAupEvent;
+  static schema(): z.ZodObject<{
+    backend: z.ZodDefault<z.ZodEnum<{
+      tty: "tty";
+      term: "term";
+      web: "web";
+    }>>;
+    port: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  }, z.core.$strip>;
+  static manifest(): ProviderManifest;
+  static treeSchema(): ProviderTreeSchema;
+  readCapabilities(_ctx: RouteContext): Promise<AFSEntry>;
+  metaRoot(_ctx: RouteContext): Promise<AFSEntry>;
+  metaInput(_ctx: RouteContext): Promise<AFSEntry>;
+  metaOutput(_ctx: RouteContext): Promise<AFSEntry>;
+  metaPages(_ctx: RouteContext): Promise<AFSEntry>;
+  metaPage(ctx: RouteContext): Promise<AFSEntry>;
+  listInput(_ctx: RouteContext): Promise<AFSListResult>;
+  listOutput(_ctx: RouteContext): Promise<AFSListResult>;
+  listPages(_ctx: RouteContext): Promise<AFSListResult>;
+  listRoot(_ctx: RouteContext): Promise<AFSListResult>;
+  readRoot(_ctx: RouteContext): Promise<AFSEntry>;
+  readInput(_ctx: RouteContext): Promise<AFSEntry>;
+  readOutput(_ctx: RouteContext): Promise<AFSEntry>;
+  readPages(_ctx: RouteContext): Promise<AFSEntry>;
+  readPage(ctx: RouteContext): Promise<AFSEntry>;
+  listPrimitives(_ctx: RouteContext): Promise<AFSListResult>;
+  readPrimitivesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statPrimitivesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaPrimitivesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readPrimitive(ctx: RouteContext): Promise<AFSEntry>;
+  statPrimitive(ctx: RouteContext): Promise<AFSStatResult>;
+  metaPrimitive(ctx: RouteContext): Promise<AFSEntry>;
+  listThemes(_ctx: RouteContext): Promise<AFSListResult>;
+  readThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statThemesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readTheme(ctx: RouteContext): Promise<AFSEntry>;
+  statTheme(ctx: RouteContext): Promise<AFSStatResult>;
+  metaTheme(ctx: RouteContext): Promise<AFSEntry>;
+  listOverlayThemes(_ctx: RouteContext): Promise<AFSListResult>;
+  readOverlayThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statOverlayThemesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaOverlayThemesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readOverlayTheme(ctx: RouteContext): Promise<AFSEntry>;
+  statOverlayTheme(ctx: RouteContext): Promise<AFSStatResult>;
+  metaOverlayTheme(ctx: RouteContext): Promise<AFSEntry>;
+  listOverlayExamples(ctx: RouteContext): Promise<AFSListResult>;
+  readOverlayExample(ctx: RouteContext): Promise<AFSEntry>;
+  readSpec(_ctx: RouteContext): Promise<AFSEntry>;
+  statSpec(_ctx: RouteContext): Promise<AFSStatResult>;
+  listSpec(_ctx: RouteContext): Promise<AFSListResult>;
+  metaSpec(_ctx: RouteContext): Promise<AFSEntry>;
+  explainSpec(_ctx: RouteContext): Promise<AFSExplainResult>;
+  listExamples(_ctx: RouteContext): Promise<AFSListResult>;
+  readExamplesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  statExamplesDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  metaExamplesDir(_ctx: RouteContext): Promise<AFSEntry>;
+  readExample(ctx: RouteContext): Promise<AFSEntry>;
+  statExample(ctx: RouteContext): Promise<AFSStatResult>;
+  metaExample(ctx: RouteContext): Promise<AFSEntry>;
+  writeOutput(_ctx: RouteContext, payload: {
+    content?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  writePage(ctx: RouteContext, payload: {
+    content?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  deletePage(ctx: RouteContext): Promise<AFSDeleteResult>;
+  /** Validate and parse a sharing entry payload */
+  private parseSharingPayload;
+  writeSharingEntry(ctx: RouteContext, payload: {
+    content?: unknown;
+  }): Promise<AFSWriteResult>;
+  readSharingEntry(ctx: RouteContext): Promise<AFSEntry>;
+  readSharingDir(_ctx: RouteContext): Promise<AFSEntry>;
+  listSharingEntries(_ctx: RouteContext): Promise<AFSListResult>;
+  deleteSharingEntry(ctx: RouteContext): Promise<AFSDeleteResult>;
+  metaSharingDir(_ctx: RouteContext): Promise<AFSEntry>;
+  metaSharingEntry(ctx: RouteContext): Promise<AFSEntry>;
+  statSharingDir(_ctx: RouteContext): Promise<AFSStatResult>;
+  statSharingEntry(ctx: RouteContext): Promise<AFSStatResult>;
+  listSharingActions(ctx: RouteContext): Promise<AFSListResult>;
+  execSharingSnapshot(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  statRoot(_ctx: RouteContext): Promise<AFSStatResult>;
+  statInput(_ctx: RouteContext): Promise<AFSStatResult>;
+  statOutput(_ctx: RouteContext): Promise<AFSStatResult>;
+  statPages(_ctx: RouteContext): Promise<AFSStatResult>;
+  statPage(ctx: RouteContext): Promise<AFSStatResult>;
+  explainRoot(_ctx: RouteContext): Promise<AFSExplainResult>;
+  explainInput(_ctx: RouteContext): Promise<AFSExplainResult>;
+  explainOutput(_ctx: RouteContext): Promise<AFSExplainResult>;
+  explainPages(_ctx: RouteContext): Promise<AFSExplainResult>;
+  readEndpoint(ctx: RouteContext): Promise<AFSEntry>;
+  statEndpoint(ctx: RouteContext): Promise<AFSStatResult>;
+  listEndpoint(ctx: RouteContext): Promise<AFSListResult>;
+  metaEndpoint(ctx: RouteContext): Promise<AFSEntry>;
+  readSessions(ctx: RouteContext): Promise<AFSEntry>;
+  metaSessions(ctx: RouteContext): Promise<AFSEntry>;
+  listSessions(_ctx: RouteContext): Promise<AFSListResult>;
+  listSession(ctx: RouteContext): Promise<AFSListResult>;
+  readSession(ctx: RouteContext): Promise<AFSEntry>;
+  metaSession(ctx: RouteContext): Promise<AFSEntry>;
+  statSession(ctx: RouteContext): Promise<AFSStatResult>;
+  listSessionMessages(ctx: RouteContext): Promise<AFSListResult>;
+  readSessionMessage(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionMessage(ctx: RouteContext, payload: {
+    content?: unknown;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  listSessionPages(ctx: RouteContext): Promise<AFSListResult>;
+  readSessionPage(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionPage(ctx: RouteContext, payload: {
+    content?: string;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  readSessionCaps(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionCaps(ctx: RouteContext, payload: {
+    content?: unknown;
+  }): Promise<AFSWriteResult>;
+  readSessionTree(ctx: RouteContext): Promise<AFSEntry>;
+  writeSessionTree(ctx: RouteContext, payload: {
+    content?: unknown;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  readSessionWm(ctx: RouteContext): Promise<AFSEntry>;
+  listSessionWm(ctx: RouteContext): Promise<AFSListResult>;
+  readWmStrategy(ctx: RouteContext): Promise<AFSEntry>;
+  writeWmStrategy(ctx: RouteContext, payload: {
+    content?: unknown;
+  }): Promise<AFSWriteResult>;
+  readWmLayout(ctx: RouteContext): Promise<AFSEntry>;
+  listWmSurfaces(ctx: RouteContext): Promise<AFSListResult>;
+  readWmSurface(ctx: RouteContext): Promise<AFSEntry>;
+  listWmActions(ctx: RouteContext): Promise<AFSListResult>;
+  execWmOpenSurface(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetSurfaceContent(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmCloseSurface(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetStrategy(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetActive(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmPinToDock(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmUnpinFromDock(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetLayout(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmCollapsePanel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmExpandPanel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmMoveSurface(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmAddToPanel(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmSetPanelActive(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmPopout(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmRedock(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execWmAutoArrange(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  explainSession(ctx: RouteContext): Promise<AFSExplainResult>;
+  /** Assert web endpoint and return channelId from params */
+  private assertLiveChannel;
+  listLiveChannels(ctx: RouteContext): Promise<AFSListResult>;
+  readLiveDirectory(ctx: RouteContext): Promise<AFSEntry>;
+  metaLiveDirectory(ctx: RouteContext): Promise<AFSEntry>;
+  readLiveChannel(ctx: RouteContext): Promise<AFSEntry>;
+  metaLiveChannel(ctx: RouteContext): Promise<AFSEntry>;
+  listLiveChannel(ctx: RouteContext): Promise<AFSListResult>;
+  readLiveChannelTree(ctx: RouteContext): Promise<AFSEntry>;
+  metaLiveChannelTree(ctx: RouteContext): Promise<AFSEntry>;
+  writeLiveChannelTree(ctx: RouteContext, payload: {
+    content?: unknown;
+    meta?: Record<string, unknown>;
+  }): Promise<AFSWriteResult>;
+  listLiveChannelActions(ctx: RouteContext): Promise<AFSListResult>;
+  execLiveChannelAupRender(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execLiveChannelAupPatch(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  private sessionActionEntries;
+  listSessionActions(ctx: RouteContext): Promise<AFSListResult>;
+  execSessionPrompt(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionForm(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionDialog(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionTable(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionToast(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionProgress(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionClear(ctx: RouteContext, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionNavigate(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionNotify(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupRender(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupPatch(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupSave(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupLoad(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupStage(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupTake(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execSessionAupRelease(ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  listActions(_ctx: RouteContext): Promise<AFSListResult>;
+  execPrompt(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execClear(_ctx: RouteContext, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  execNotify(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execNavigate(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execDialog(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execProgress(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execForm(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execTable(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execToast(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
+}
+//#endregion
+export { AFSUIProvider, AFSUIProviderOptions };
+//# sourceMappingURL=ui-provider.d.mts.map