mindwire 0.1.13 → 0.1.14

package/dist/surfaces.d.ts

@@ -0,0 +1,177 @@
+import type { Mindwire } from "./client.js";
+export interface SurfaceGeometry {
+    width: number;
+    height: number;
+    revision: number;
+}
+export interface SurfaceProblem {
+    code: string;
+    message: string;
+}
+export interface SurfaceCapabilities {
+    view: boolean;
+    capture: boolean;
+    pointer: boolean;
+    keyboard: boolean;
+    text: boolean;
+    clipboardRead: boolean;
+    clipboardWrite: boolean;
+}
+export interface SurfaceController {
+    sessionId: string;
+    actor: "user" | "agent";
+    name: string;
+    runId?: string;
+    chatId?: string;
+    generation: number;
+    expiresAt: string;
+}
+export interface SurfaceSnapshot {
+    id: string;
+    workspaceId: string;
+    kind: "desktop";
+    provider: "oblien";
+    version: number;
+    revision: number;
+    instanceId: string;
+    state: string;
+    observedAt?: string;
+    supported: boolean;
+    enabled: boolean;
+    available: boolean;
+    credentials: boolean;
+    os?: string;
+    capabilities: SurfaceCapabilities;
+    geometry?: SurfaceGeometry;
+    controller?: SurfaceController;
+    authorizationExpiresAt?: string;
+    error?: SurfaceProblem;
+}
+/** Write-only, desktop-only, expiring provider grant. Never pass a user's session JWT. */
+export interface SurfaceBinding {
+    registryId: string;
+    workspaceId: string;
+    gatewayToken?: string;
+    connection: {
+        expires_at: string;
+        ssh: {
+            host: string;
+            port: number;
+            username: string;
+            password: string;
+            host_key_fingerprint: string;
+        };
+        vnc: {
+            host: string;
+            port: number;
+            authentication: "none";
+        };
+    };
+}
+export interface SurfaceSession {
+    id: string;
+    surfaceId: string;
+    actor: "user" | "agent";
+    name: string;
+    chatId?: string;
+    runId?: string;
+    mode: "view" | "control";
+    createdAt: string;
+    controller?: SurfaceController;
+}
+export interface SurfaceOpenRequest {
+    requestId: string;
+    name?: string;
+    mode: "view" | "control";
+}
+export interface SurfaceControlRequest {
+    action: "acquire" | "takeover" | "release" | "renew";
+    generation?: number;
+}
+export interface SurfaceAction {
+    kind: "pointer" | "click" | "drag" | "scroll" | "key" | "text" | "clipboard_read" | "clipboard_write" | "release";
+    x?: number;
+    y?: number;
+    toX?: number;
+    toY?: number;
+    buttons?: number;
+    button?: "left" | "middle" | "right";
+    count?: number;
+    deltaX?: number;
+    deltaY?: number;
+    keys?: string[];
+    text?: string;
+}
+export interface SurfaceActionRequest {
+    /** Reuse this ID to inspect/recover an uncertain acknowledgement. Do not replay with a new ID. */
+    requestId: string;
+    sessionId: string;
+    controlGeneration: number;
+    frameId?: string;
+    geometryRevision?: number;
+    action: SurfaceAction;
+}
+export interface SurfaceReceipt {
+    id: string;
+    sessionId: string;
+    surfaceId: string;
+    kind: string;
+    status: "dispatching" | "dispatched" | "outcome_unknown";
+    createdAt: string;
+    error?: SurfaceProblem;
+    /** Transient clipboard output, not stored in the receipt. */
+    text?: string;
+}
+export interface SurfaceCapture {
+    id: string;
+    surfaceId: string;
+    artifactId: string;
+    mime: string;
+    geometry: SurfaceGeometry;
+    createdAt: string;
+}
+export interface ArtifactContent {
+    id: string;
+    chatId?: string;
+    mime: string;
+    bytes: number;
+    width: number;
+    height: number;
+    createdAt: string;
+    /** Base64 bytes, compatible with every existing daemon transport. */
+    data: string;
+}
+export interface SurfaceToolAction {
+    surfaceId: string;
+    operation: string;
+    sessionId?: string;
+    receiptId?: string;
+    status?: string;
+    capture?: {
+        id: string;
+        artifactId: string;
+        width: number;
+        height: number;
+    };
+}
+/** Workspace-scoped API. One controller is shared by every harness and app client. */
+export declare class SurfacesApi {
+    private readonly mw;
+    constructor(mw: Mindwire);
+    list(): Promise<SurfaceSnapshot[]>;
+    status(refresh?: boolean): Promise<SurfaceSnapshot>;
+    bind(binding: SurfaceBinding): Promise<SurfaceSnapshot>;
+    open(request: SurfaceOpenRequest): Promise<SurfaceSession>;
+    control(id: string, request: SurfaceControlRequest): Promise<SurfaceSession>;
+    close(id: string): Promise<{
+        closed: boolean;
+    }>;
+    capture(id: string): Promise<SurfaceCapture>;
+    action(request: SurfaceActionRequest): Promise<SurfaceReceipt>;
+    receipt(id: string): Promise<SurfaceReceipt>;
+    artifact(id: string): Promise<ArtifactContent>;
+    /** Every connection starts with the current snapshot, then revisions. Never replays input. */
+    watch(opts?: {
+        signal?: AbortSignal;
+    }): AsyncGenerator<SurfaceSnapshot>;
+}

package/dist/target/host.d.ts

@@ -30,9 +30,9 @@ export interface EnsureDaemonConfig {
     /** `AGENT_CWD` — working directory agents run in, inside the sandbox. */
     agentCwd: string;
     /**
-     * Explicit path to a Linux `mindwired` to deploy (else downloaded from the matching GitHub Release).
-     * `{arch}` is expanded to the destination architecture (`amd64` or `arm64`), allowing a development
-     * launcher to build both artifacts without guessing the sandbox architecture in advance.
+     * Explicit path to a `mindwired` to deploy (else downloaded from the matching GitHub Release).
+     * `{os}` and `{arch}` expand to the destination (`linux`/`darwin` and `amd64`/`arm64`), allowing a
+     * development launcher to build artifacts without guessing the sandbox platform in advance.
      */
     daemonBin?: string;
     /** Redeploy when the running daemon's version differs from `desiredVersion`. Off by default. */
@@ -70,6 +70,8 @@ export interface EnsureEvent {
     version?: string;
     /** Target architecture the daemon was resolved for (on `upload`). */
     arch?: "amd64" | "arm64";
+    /** Destination operating system (on `download` / `upload`). */
+    platform?: "linux" | "darwin";
     /** Size of the uploaded daemon binary in bytes (on `upload`). */
     bytes?: number;
     /** Error message (on `error`). */

package/dist/target/oblien.d.ts

@@ -19,7 +19,7 @@ export interface OblienConfig {
     agentCwd?: string;
     /** Loopback port the in-workspace daemon listens on. */
     port?: number;
-    /** Explicit local Linux `mindwired` to deploy. `{arch}` expands to the workspace architecture. */
+    /** Explicit local `mindwired` to deploy. `{os}`/`{arch}` expand to the workspace platform. */
     daemonBin?: string;
     /** Redeploy the daemon when the running version differs from the SDK's bundled binary. Off by default. */
     autoUpdate?: boolean;

package/dist/target/ssh.d.ts

@@ -26,7 +26,7 @@ export interface SshOptions {
     agentType?: string;
     /** `AGENT_CWD` — working directory agents run in, on the remote. Defaults to `/root`. */
     agentCwd?: string;
-    /** Explicit path to a Linux `mindwired` to deploy (else resolved from the platform package). */
+    /** Explicit local `mindwired` to deploy; `{os}`/`{arch}` expand to the destination platform. Otherwise downloaded from GitHub Releases. */
     daemonBin?: string;
     /** Redeploy when the running daemon's version differs from the SDK's bundled binary. */
     autoUpdate?: boolean;

package/dist/types.d.ts

@@ -28,6 +28,7 @@ export type ToolKind = "file_edit" | "file_read" | "shell" | "search" | "web_sea
  * apply_patch/shell).
  */
 export interface ToolAction {
+    surface?: import("./surfaces.js").SurfaceToolAction;
     kind: ToolKind;
     /** Short human label (e.g. the command or the path). */
     title?: string;
@@ -521,6 +522,8 @@ export interface MCPServer {
     bearerTokenEnvVar?: string;
     /** HTTP transport: literal headers sent with each request. */
     httpHeaders?: Record<string, string>;
+    /** Codex's native approval behavior for this MCP server. */
+    defaultToolsApprovalMode?: "auto" | "prompt" | "writes" | "approve";
 }
 /**
  * One registered custom OpenAI-compatible LLM provider — a base URL + model ids an agent loads on every
@@ -825,6 +828,8 @@ export interface SetupStatus {
     steps: StepResult[];
     /** The shared job's operation, including when another client started it. Older daemons omit it. */
     operation?: "setup" | "update";
+    /** Current step phase, reported by the daemon rather than inferred from elapsed time. */
+    stage?: "checking" | "waiting" | "installing" | "verifying" | (string & {});
 }
 /** `GET /notify/config` — the token is never returned. */
 export interface NotifyConfigStatus {
@@ -908,6 +913,7 @@ export interface NotifyChannelTestResult {
 }
 /** `GET /healthz` — the daemon's liveness probe. */
 export interface Health {
+    surfaceProtocolVersion?: number;
     /** Workspace registry protocol version; absent on daemons predating workspace metadata. */
     workspaceMetadataVersion?: number;
     /** Durable project creation/clone operations; absent on older daemons. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindwire",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "devDependencies": {