@oharness/server 0.1.0

package/dist/server.d.ts

@@ -0,0 +1,50 @@
+import type { Agent } from "@oharness/engine/agent/agent.ts";
+import type { Session } from "@oharness/engine/agent/session.ts";
+import { Harness } from "@oharness/engine/harness.ts";
+import type { PermissionRequest } from "@oharness/engine/agent/permissions.ts";
+import type { SettingsScope } from "@oharness/engine/agent/settings.ts";
+/**
+ * A browser frontend for the same agent the terminal drives.
+ *
+ * **Reaching this port is equivalent to a shell on this machine.** The agent
+ * behind it writes files and runs commands, so the server binds to loopback by
+ * default and requires a token that is generated per run and never persisted.
+ * Both matter: loopback alone still exposes the agent to every other user and
+ * every other process on a shared machine, and a token alone would not stop a
+ * network neighbour from finding the port.
+ */
+export interface WebServerOptions {
+    harness: Harness;
+    session: Session;
+    agent: Agent;
+    port?: number;
+    /** Defaults to loopback. Changing it publishes agent control to the network. */
+    host?: string;
+    /**
+     * How the harness for another project is built.
+     *
+     * A session names the tree it runs in and the page can start one anywhere,
+     * so this is reached whenever a directory is asked for that has no harness
+     * yet. The default is the real thing; it is an option because building one
+     * reads the disk, discovers plugins and connects every MCP server the
+     * project declares, which a test asking where a session landed should not
+     * have to pay for.
+     */
+    openProject?: (cwd: string) => Promise<Harness>;
+}
+export interface WebServer {
+    readonly url: string;
+    readonly token: string;
+    close(): Promise<void>;
+    /** Answers the prompt the engine is waiting on, used by the HTTP layer. */
+    readonly permissionPrompt: (request: PermissionRequest) => Promise<{
+        allow: boolean;
+        remember?: boolean | "session" | SettingsScope;
+    }>;
+}
+export declare function startWebServer(opts: WebServerOptions): Promise<WebServer>;
+/** One thing the composer's + menu attached to a message. */
+export interface Reference {
+    kind: "file" | "folder" | "connector" | "plugin";
+    value: string;
+}