acrylblends 1.0.4 → 1.0.6

package/lib/cordis/door.d.ts

@@ -1,10 +1,87 @@
-import { f as UiActionResult, y as UiSnapshot } from "../protocol-C37gPePD.js";
-import { i as UiChannel, t as AuditLog } from "../audit-D5z9uwOP.js";
+import { f as UiActionResult, y as UiSnapshot } from "../protocol-CR31M7K_.js";
+import { i as UiChannel, r as PageStream, t as AuditLog } from "../audit-GcLtvNLV.js";
 import { Context } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
 
+//#region ../../plugins/acryl-door/src/shell/protocol.d.ts
+type ShellRequest = {
+  readonly op: 'window-list';
+} | {
+  readonly op: 'window-open';
+  readonly path?: string;
+} | {
+  readonly op: 'window-focus';
+  readonly id: number;
+} /** `force`: the window may be the last, and closing the last one ends the desktop app (and with it the server it started). */ | {
+  readonly op: 'window-close';
+  readonly id: number;
+  readonly force?: boolean;
+} | {
+  readonly op: 'window-resize';
+  readonly id: number;
+  readonly width: number;
+  readonly height: number;
+} | {
+  readonly op: 'menu-list';
+} /** `force`: the item may end the desktop app (Quit, or Close Window on the last window). */ | {
+  readonly op: 'menu-click';
+  readonly path: string;
+  readonly force?: boolean;
+};
+interface ShellWindow {
+  /** Electron's own window id: the number `window list` prints and `--window` takes. */
+  readonly id: number;
+  readonly title: string;
+  /** The path (with query) the window shows, never the origin. */
+  readonly path: string;
+  readonly focused: boolean;
+  readonly width: number;
+  readonly height: number;
+}
+interface ShellMenuItem {
+  /** Labels from the top of the menu, joined with `>`: `File>New Note`. */
+  readonly path: string;
+  readonly label: string;
+  readonly enabled: boolean;
+  /** True for an item that ends the desktop app (Quit, or Close Window): `menu click` presses it only with `force`. */
+  readonly ends?: boolean;
+}
+type ShellResult = {
+  readonly windows: readonly ShellWindow[];
+} | {
+  readonly items: readonly ShellMenuItem[];
+} | {
+  readonly ok: true;
+  readonly detail: string;
+  readonly id?: number;
+};
+type ShellErrorCode = 'invalid' | 'no-desktop' | 'no-such-window' | 'last-window' | 'no-such-menu-item' | 'disabled' | 'quits-app' | 'timeout' | 'disconnected' | 'unloaded' | 'aborted' | 'failed';
+//#endregion
+//#region ../../plugins/acryl-door/src/host/shell.d.ts
+declare class ShellChannel {
+  private current;
+  private readonly pending;
+  private nextId;
+  private closed;
+  private readonly attachWaiters;
+  get connected(): boolean;
+  /** @returns the function to call when this stream ends. */
+  attach(stream: PageStream): () => void;
+  /** A promise for the shell connecting (it reconnects after the dev server restarted). */
+  waitForShell(timeoutMs: number): Promise<boolean>;
+  receive(body: unknown): void;
+  /** @throws ShellError `no-desktop` when no shell is attached, else what the shell refused with. */
+  call(request: ShellRequest, options?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+  }): Promise<ShellResult>;
+  close(): void;
+  private failAll;
+  private settle;
+}
+//#endregion
 //#region ../../plugins/acryl-door/src/host/door.d.ts
-type DoorErrorCode = 'invalid' | 'unknown-verb' | 'unavailable' | 'not-exposed' | 'outside-app' | 'failed';
+type DoorErrorCode = 'invalid' | 'unknown-verb' | 'unavailable' | 'not-exposed' | 'outside-app' | 'failed' | ShellErrorCode;
 declare class DoorError extends Error {
   readonly code: DoorErrorCode;
   constructor(code: DoorErrorCode, message: string);
@@ -21,6 +98,7 @@ interface ToolsPort {
   /** @returns the function that removes the tool. @throws when the name is taken. */
   register(name: string, tool: {
     readonly description: string;
+    readonly parameters?: Readonly<Record<string, unknown>>;
     run(input: unknown): unknown;
   }): () => void;
   list(): ReadonlyArray<{
@@ -31,6 +109,8 @@ interface ToolsPort {
 }
 interface DoorDeps {
   readonly channel: UiChannel;
+  /** The desktop shell (the Electron main process of `npm run desktop`), when the app can have one. */
+  readonly shell?: ShellChannel;
   readonly audit: AuditLog;
   /** The app's name, folder and, when it listens, its address (what `brief` prints so an agent can curl the running app). */
   readonly app: {
@@ -61,6 +141,18 @@ declare class Door {
   brief(): VerbAnswer;
   look(input: Record<string, unknown>, signal: AbortSignal): Promise<UiSnapshot>;
   act(input: Record<string, unknown>, signal: AbortSignal): Promise<UiActionResult>;
+  /**
+   * What the app answers at a path the page was sent to, so an agent that mistyped one is told ("404 at /nope") and not left to find out from a page it did not expect.
+   * A second GET of the same path (a page is read-only); nothing when the app has no address or does not answer in time.
+   */
+  private statusAt;
+  /**
+   * The windows and the menu of the desktop app, through the shell. Every call is audited with the window it was about; a call with no shell attached answers one line that says what to run;
+   * closing the last window is refused unless the call says `force` (it ends the desktop app, and the session an agent works in with it).
+   */
+  private desktop;
+  /** `window` on look and act: the desktop window (the number `window list` prints) whose page the call is for; without it, the page used last. */
+  private windowOf;
   private parse;
   /** Run one call on the page and record it. The audit holds which control was touched and how it ended, never what was typed. */
   private callPage;
@@ -77,7 +169,7 @@ declare class Door {
  * MCP (`tools/list`) and the built-in chat (the `tools` registry). A verb added here is in all three, or the comparison test fails.
  */
 /** Every verb, in the order `brief` lists them. */
-declare const VERBS: readonly ["brief", "look", "act", "plugin-list", "plugin-add", "plugin-remove", "plugin-reload", "tool-list", "tool-call"];
+declare const VERBS: readonly ["brief", "look", "act", "plugin-list", "plugin-add", "plugin-remove", "plugin-reload", "tool-list", "tool-call", "window-list", "window-open", "window-focus", "window-close", "window-resize", "menu-list", "menu-click"];
 type Verb = (typeof VERBS)[number];
 /** The JSON Schema of a verb's arguments, as MCP lists it. */
 interface ArgumentsSchema {
@@ -166,6 +258,8 @@ interface Config {
   reloadOnChange?: boolean;
 }
 declare const Config: z<Config>;
+/** The page of a path the app does not serve, development only: what is missing, a way back, and the door's script. */
+declare function notFoundPage(path: string, scriptTag: string): string;
 declare function apply(ctx: Context, rawConfig?: Config): void;
 //#endregion
-export { type CallResponse, Config, DOOR_PREFIX, Door, DoorError, type DoorFile, STATE_DIR, VERBS, VERB_SPECS, type Verb, type VerbAnswer, type VerbSpec, apply, chatToolName, doorFilePath, inject, mcpTools, name, readDoorFile };
+export { type CallResponse, Config, DOOR_PREFIX, Door, DoorError, type DoorFile, STATE_DIR, VERBS, VERB_SPECS, type Verb, type VerbAnswer, type VerbSpec, apply, chatToolName, doorFilePath, inject, mcpTools, name, notFoundPage, readDoorFile };