mindwire 0.1.42 → 0.1.43

package/dist/surfaces.d.ts

@@ -4,6 +4,15 @@ export interface SurfaceGeometry {
     height: number;
     revision: number;
 }
+/** Actual remote cursor. The base64 PNG changes only with its shape, not its position. */
+export interface SurfaceCursor {
+    id: string;
+    width: number;
+    height: number;
+    hotspotX: number;
+    hotspotY: number;
+    png: string;
+}
 export interface SurfaceProblem {
     code: string;
     message: string;
@@ -33,6 +42,7 @@ export interface SurfaceSnapshot {
     workspaceId: string;
     kind: "desktop";
     provider: "oblien" | "macos";
+    desktopId?: string;
     version: number;
     revision: number;
     instanceId: string;
@@ -45,6 +55,7 @@ export interface SurfaceSnapshot {
     os?: string;
     capabilities: SurfaceCapabilities;
     geometry?: SurfaceGeometry;
+    cursor?: SurfaceCursor;
     controller?: SurfaceController;
     authorizationExpiresAt?: string;
     error?: SurfaceProblem;
@@ -70,8 +81,10 @@ export interface SurfaceBinding {
     registryId: string;
     workspaceId: string;
     gatewayToken?: string;
+    desktopId?: string;
     connection: {
         expires_at: string;
+        session_id?: string;
         ssh: {
             host: string;
             port: number;
@@ -91,6 +104,7 @@ export interface SurfaceSession {
     surfaceId: string;
     actor: "user" | "agent";
     name: string;
+    desktopId?: string;
     chatId?: string;
     runId?: string;
     mode: "view" | "control";
@@ -101,6 +115,7 @@ export interface SurfaceOpenRequest {
     requestId: string;
     name?: string;
     mode: "view" | "control";
+    desktopId?: string;
 }
 export interface SurfaceControlRequest {
     action: "acquire" | "takeover" | "release" | "renew";
@@ -136,7 +151,7 @@ export interface SurfaceReceipt {
     sessionId: string;
     surfaceId: string;
     kind: string;
-    status: "dispatching" | "dispatched" | "outcome_unknown";
+    status: "dispatching" | "dispatched" | "outcome_unknown" | "cancelled";
     createdAt: string;
     error?: SurfaceProblem;
     /** Transient clipboard output, not stored in the receipt. */
@@ -167,6 +182,7 @@ export interface SurfaceToolAction {
     sessionId?: string;
     receiptId?: string;
     status?: string;
+    desktopId?: string;
     capture?: {
         id: string;
         artifactId: string;
@@ -174,10 +190,86 @@ export interface SurfaceToolAction {
         height: number;
     };
 }
-/** Workspace-scoped API. One controller is shared by every harness and app client. */
+/** Private workspace runtime authorization, never an account/session credential. */
+export interface DesktopRuntimeBinding {
+    registryId: string;
+    workspaceId: string;
+    gatewayToken: string;
+    expiresAt?: string;
+}
+export interface DesktopResolution {
+    width: number;
+    height: number;
+}
+export interface SavedDesktop {
+    id: string;
+    name: string;
+    state: string;
+    managed: boolean;
+    available: boolean;
+    resolution?: DesktopResolution;
+    mode?: string;
+    can_resize?: boolean;
+    can_delete?: boolean;
+    deletion_pending?: boolean;
+    created_at?: string;
+    updated_at?: string;
+    error?: string;
+}
+export interface DesktopCatalog {
+    success: boolean;
+    projectId?: string;
+    sessions: SavedDesktop[];
+    capabilities: {
+        mode: "virtual" | "console";
+        max_sessions: number;
+        can_create: boolean;
+        resolution?: {
+            min: DesktopResolution;
+            max: DesktopResolution;
+            default: DesktopResolution;
+        };
+    };
+}
+export interface SavedDesktopResult {
+    success: boolean;
+    session: SavedDesktop;
+}
+export interface CreateSavedDesktop {
+    /** Reuse the same ID and body after an interrupted response. */
+    requestId: string;
+    projectId?: string;
+    name: string;
+    resolution?: DesktopResolution;
+}
+export interface UpdateSavedDesktop {
+    name?: string;
+    resolution?: DesktopResolution;
+}
+/** One controller per saved desktop, shared by every harness and app client. */
 export declare class SurfacesApi {
     private readonly mw;
-    constructor(mw: Mindwire);
+    private readonly desktopId?;
+    constructor(mw: Mindwire, desktopId?: string | undefined);
+    /** Select a saved display for status, events, captures and input receipts. */
+    desktop(id: string): SurfacesApi;
+    private scoped;
+    bindRuntime(binding: DesktopRuntimeBinding): Promise<{
+        configured: boolean;
+    }>;
+    listDesktops(projectId?: string): Promise<DesktopCatalog>;
+    createDesktop(request: CreateSavedDesktop): Promise<SavedDesktopResult>;
+    ensureProjectDesktop(projectId: string): Promise<SavedDesktopResult>;
+    getDesktop(id: string): Promise<SavedDesktopResult>;
+    updateDesktop(id: string, request: UpdateSavedDesktop): Promise<SavedDesktopResult>;
+    startDesktop(id: string): Promise<SavedDesktopResult>;
+    /** Stops this desktop's apps; keeps its profile and files. */
+    stopDesktop(id: string): Promise<SavedDesktopResult>;
+    /** Deletes the desktop's private profile. Closing a viewer uses close(), never this method. */
+    deleteDesktop(id: string): Promise<{
+        success: boolean;
+        session?: SavedDesktop;
+    }>;
     list(): Promise<SurfaceSnapshot[]>;
     status(refresh?: boolean): Promise<SurfaceSnapshot>;
     bind(binding: SurfaceBinding): Promise<SurfaceSnapshot>;

package/dist/types.d.ts

@@ -851,10 +851,12 @@ export interface HarnessSoftware {
     installedVersion: string;
     recommendedVersion?: string;
     latestVersion?: string;
-    compatibility: "supported" | "untested" | "incompatible" | "not_installed" | (string & {});
+    compatibility: "supported" | "untested" | "incompatible" | "unavailable" | "not_installed" | (string & {});
     managed: boolean;
     updateAvailable: boolean;
     requiresDaemonUpdate: boolean;
+    /** An explicitly requested update can repair this damaged managed installation. */
+    repairAvailable?: boolean;
     requiredDaemonVersion?: string;
     message?: string;
     catalogRevision: number;
@@ -1006,6 +1008,8 @@ export interface Health {
     localDesktopVersion?: number;
     /** Workspace registry protocol version; absent on daemons predating workspace metadata. */
     workspaceMetadataVersion?: number;
+    /** Durable project folders, membership and ordering, with conditional edits. */
+    projectLibraryVersion?: number;
     /** Durable project creation/clone operations; absent on older daemons. */
     projectOperationsVersion?: number;
     /** Project-relative icons and authenticated image previews. */

package/dist/workspace.d.ts

@@ -211,6 +211,32 @@ export interface WorkspaceImport {
         id: string;
     })[];
 }
+export interface ProjectFolder {
+    id: string;
+    name: string;
+}
+/** Daemon-owned grouping and manual order; all IDs refer to this workspace. */
+export interface ProjectLibrary {
+    version: number;
+    revision: number;
+    folders: ProjectFolder[];
+    membership: Record<string, string>;
+    order: string[];
+}
+/** Partial atomic edit. On 409, read the current library before deciding how to rebase. */
+export interface ProjectLibraryEdit {
+    expectedRevision: number;
+    folders?: ProjectFolder[];
+    deleteFolders?: string[];
+    placements?: {
+        projectId: string;
+        folderId: string | null;
+    }[];
+    order?: string[];
+    folderOrder?: string[];
+    /** Migration only: existing daemon organization always wins. */
+    importIfEmpty?: boolean;
+}
 export interface WorkspaceSnapshot {
     version: number;
     workspaceId: string;
@@ -231,6 +257,8 @@ export interface WorkspaceSnapshot {
         agent: string;
         message: string;
     }[];
+    /** Present on full snapshots, or when organization changed in a delta. */
+    projectLibrary?: ProjectLibrary;
 }
 export declare class WorkspaceCollection<T extends WorkspaceRecord> {
     private readonly mw;
@@ -257,6 +285,8 @@ export declare class WorkspaceApi {
     snapshot(options?: {
         refresh?: boolean;
     }): Promise<WorkspaceSnapshot>;
+    library(): Promise<ProjectLibrary>;
+    editLibrary(edit: ProjectLibraryEdit): Promise<ProjectLibrary>;
     /** Read the saved icon, or preview a candidate relative path within the project. Requires projectIconsVersion >= 1. */
     projectIcon(projectId: string, path?: string): Promise<ProjectIcon>;
     /** Start an operation owned by the daemon. The same ID/payload returns the existing operation. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindwire",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "bin": {