acrylblends 0.8.1 → 0.9.0

package/lib/cordis/door.d.ts

@@ -0,0 +1,159 @@
+import { d as UiActionResult, v as UiSnapshot } from "../protocol-BizVt4J6.js";
+import { i as UiChannel, t as AuditLog } from "../audit-BXnYsLge.js";
+import { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+
+//#region ../../plugins/acryl-door/src/host/door.d.ts
+type DoorErrorCode = 'invalid' | 'unknown-verb' | 'unavailable' | 'not-exposed' | 'outside-app' | 'failed';
+declare class DoorError extends Error {
+  readonly code: DoorErrorCode;
+  constructor(code: DoorErrorCode, message: string);
+}
+/** The slice of acrylblends' `extensions` service the plugin verbs use, declared here so the door does not depend on that plugin. */
+interface ExtensionsPort {
+  install(source: string): Promise<unknown>;
+  remove(name: string): Promise<unknown>;
+  reload(): Promise<unknown>;
+  list(): readonly unknown[];
+}
+/** The slice of acrylblends' `tools` registry (the `agent` plugin's) the tool verbs use, and where the built-in chat finds the verbs. */
+interface ToolsPort {
+  /** @returns the function that removes the tool. @throws when the name is taken. */
+  register(name: string, tool: {
+    readonly description: string;
+    run(input: unknown): unknown;
+  }): () => void;
+  list(): ReadonlyArray<{
+    readonly name: string;
+    readonly description: string;
+  }>;
+  call(name: string, input: unknown): Promise<unknown>;
+}
+interface DoorDeps {
+  readonly channel: UiChannel;
+  readonly audit: AuditLog;
+  /** The app's name and folder. */
+  readonly app: {
+    readonly name: string;
+    readonly root: string;
+  };
+  /** Read at each call: the services may come and go while the door runs. */
+  readonly extensions: () => ExtensionsPort | undefined;
+  readonly tools: () => ToolsPort | undefined;
+  /** The app tools the door offers; anything else is refused before it reaches the registry. */
+  readonly expose: readonly string[];
+}
+/** What one verb answered: the value for `--json` and programs, the text for an agent reading a terminal. */
+interface VerbAnswer {
+  readonly value: unknown;
+  readonly text: string;
+}
+declare class Door {
+  private readonly deps;
+  constructor(deps: DoorDeps);
+  /** Run one verb. @throws DoorError or UiControlError. */
+  run(verb: string, args: unknown, signal: AbortSignal): Promise<VerbAnswer>;
+  brief(): VerbAnswer;
+  look(input: Record<string, unknown>, signal: AbortSignal): Promise<UiSnapshot>;
+  act(input: Record<string, unknown>, signal: AbortSignal): Promise<UiActionResult>;
+  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;
+  private plugin;
+  /** A folder named by an agent, resolved from the app folder; it must be inside the app. */
+  private insideApp;
+  private offeredTools;
+  private callTool;
+}
+//#endregion
+//#region ../../plugins/acryl-door/src/host/verbs.d.ts
+/**
+ * The one verb list (spec 049 slice 13). Every face of the door reads it: the operator client (`acryl <verb>`, its `verbs` and `brief`),
+ * 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"];
+type Verb = (typeof VERBS)[number];
+/** The JSON Schema of a verb's arguments, as MCP lists it. */
+interface ArgumentsSchema {
+  readonly type: 'object';
+  readonly properties: Readonly<Record<string, unknown>>;
+  readonly required?: readonly string[];
+  readonly additionalProperties: boolean;
+}
+interface VerbSpec {
+  /** The operator client's form, as `brief` prints it. */
+  readonly usage: string;
+  /** What the verb does, for a model choosing a tool. */
+  readonly description: string;
+  readonly arguments: ArgumentsSchema;
+}
+declare const VERB_SPECS: Readonly<Record<Verb, VerbSpec>>;
+/** A verb's name in the `tools` registry the built-in chat reads: prefixed, so it never meets an app tool's name. */
+declare const chatToolName: (verb: Verb) => string;
+//#endregion
+//#region ../../plugins/acryl-door/src/host/http.d.ts
+/** Every door route lives below this path. */
+declare const DOOR_PREFIX = "/api/acryl-door";
+//#endregion
+//#region ../../plugins/acryl-door/src/host/mcp-routes.d.ts
+/** The verbs as MCP tools. */
+declare function mcpTools(): Array<{
+  name: Verb;
+  description: string;
+  inputSchema: unknown;
+}>;
+//#endregion
+//#region ../../plugins/acryl-door/src/host/door-file.d.ts
+/**
+ * The door's connection file, `<app>/.acryl/door.json`: where the running app listens and this run's secret, for the operator client in
+ * the same folder. The secret is never on a command line or in an environment variable another process can read.
+ *
+ * Protection: on macOS and Linux the folder is `0700` and the file `0600`, so only the OS user who started the app can read it. On
+ * Windows file modes mean nothing; the file is protected by where it lives, the app folder in the user's profile, whose ACL gives access
+ * to that user, SYSTEM and Administrators only. The door does not widen it. The folder also carries its own `.gitignore` of `*`, so
+ * `git add -A` never stages the secret even in an app whose `.gitignore` lacks the `.acryl/` line.
+ */
+/** The folder of the door's state below the app folder. */
+declare const STATE_DIR = ".acryl";
+interface DoorFile {
+  readonly version: 1;
+  /** The origin the operator reaches, on a loopback address. */
+  readonly url: string;
+  readonly secret: string;
+  /** The process that wrote it; a file whose process is gone is stale. */
+  readonly pid: number;
+}
+declare function doorFilePath(appRoot: string): string;
+/** The connection file as written, or undefined when there is none or it does not parse. */
+declare function readDoorFile(appRoot: string): DoorFile | undefined;
+//#endregion
+//#region ../../plugins/acryl-door/src/host/operator-routes.d.ts
+type CallResponse = {
+  readonly ok: true;
+  readonly value: unknown;
+  readonly text: string;
+} | {
+  readonly ok: false;
+  readonly code: string;
+  readonly message: string;
+};
+//#endregion
+//#region ../../plugins/acryl-door/src/index.d.ts
+/** Stable Cordis plugin name, equal to the package name and the Loader row id. */
+declare const name = "acryl-door";
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    door: Door;
+  }
+}
+declare const inject: string[];
+interface Config {
+  tools?: {
+    expose?: string[];
+  };
+}
+declare const Config: z<Config>;
+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 };