mindwire 0.1.42 → 0.1.44

package/dist/index.d.ts

@@ -40,7 +40,7 @@ export type { Conversation, ConversationQuery, ConversationPage, ConversationOpe
 export { ProjectSyncApi, ProjectSyncError } from "./project-sync.js";
 export type { ProjectSyncEntry, ProjectSyncCheckpoint, ProjectSyncRequest, ProjectSyncOperation, ProjectSyncConflict, ProjectSyncProgress, ProjectSyncPreview, ProjectSyncPreviewRequest, ProjectSyncIgnoredPath } from "./project-sync.js";
 export type { ProjectRequest, ProjectAuth, ProjectOperation, ProjectRemoveRequest, GitConnection, GitAccessState, ProjectGitState, GitAction, GitIdentity, GitIdentityScope, GitIdentitySettings, GitIdentityUpdate, GitOperationRequest, GitOperation } from "./workspace.js";
-export type { WorkspaceRecord, WorkspaceAgent, WorkspaceProject, WorkspaceChat, WorkspaceKind, WorkspaceInput, WorkspaceImport, WorkspaceSnapshot, ProjectIcon } from "./workspace.js";
+export type { WorkspaceRecord, WorkspaceAgent, WorkspaceProject, WorkspaceChat, WorkspaceKind, WorkspaceInput, WorkspaceImport, WorkspaceSnapshot, ProjectIcon, ProjectFolder, ProjectLibrary, ProjectLibraryEdit } from "./workspace.js";
 export * from "./surfaces.js";
 export * from "./execution.js";
 export * from "./computer.js";

package/dist/index.js

@@ -1,5 +1,5 @@
-import { MindwireError, TimeoutError, ApiError, RunFailedError } from './chunk-T6TD76UA.js';
-export { ApiError, MindwireError, RunFailedError, TimeoutError } from './chunk-T6TD76UA.js';
+import { MindwireError, TimeoutError, ApiError, RunFailedError, executableChecksum } from './chunk-PFYKJ6LX.js';
+export { ApiError, MindwireError, RunFailedError, TimeoutError } from './chunk-PFYKJ6LX.js';
 
 // src/http.ts
 var DEFAULT_TIMEOUT_MS = 12e4;
@@ -341,8 +341,8 @@ var Run = class _Run {
    * Steer a follow-up message into the running turn without cancelling it. Requires the agent's
    * `input` capability.
    */
-  async sendInput(text) {
-    await this.http.request("POST", `/runs/${encodeURIComponent(this.id)}/input`, { body: { text } });
+  async sendInput(text, options = {}) {
+    await this.http.request("POST", `/runs/${encodeURIComponent(this.id)}/input`, { body: { text, ...options } });
   }
   /**
    * Soft-stop the running turn (ask the agent to halt current work) without the hard process kill
@@ -720,6 +720,12 @@ var WorkspaceApi = class {
   snapshot(options = {}) {
     return this.mw.http.request("GET", "/workspace", { query: options });
   }
+  library() {
+    return this.mw.http.request("GET", "/workspace/project-library");
+  }
+  editLibrary(edit) {
+    return this.mw.http.request("PATCH", "/workspace/project-library", { body: edit });
+  }
   /** Read the saved icon, or preview a candidate relative path within the project. Requires projectIconsVersion >= 1. */
   projectIcon(projectId, path) {
     return this.mw.http.request("GET", `/workspace/projects/${encodeURIComponent(projectId)}/icon`, { query: { path } });
@@ -825,18 +831,61 @@ var GitAccessApi = class {
 };
 
 // src/surfaces.ts
-var SurfacesApi = class {
-  constructor(mw) {
+function savedDesktopID(id) {
+  if (!/^(console|ds_[a-f0-9]{16})$/.test(id)) throw new Error("Invalid saved desktop ID.");
+  return id;
+}
+var SurfacesApi = class _SurfacesApi {
+  constructor(mw, desktopId) {
     this.mw = mw;
+    this.desktopId = desktopId;
   }
   mw;
+  desktopId;
+  /** Select a saved display for status, events, captures and input receipts. */
+  desktop(id) {
+    return new _SurfacesApi(this.mw, savedDesktopID(id));
+  }
+  scoped(path) {
+    return this.desktopId ? `${path}?desktopId=${encodeURIComponent(this.desktopId)}` : path;
+  }
+  bindRuntime(binding) {
+    return this.mw.http.request("PUT", "/surfaces/desktop/runtime", { body: binding });
+  }
+  listDesktops(projectId) {
+    return this.mw.http.request("GET", "/surfaces/desktop/catalog", { query: { projectId } });
+  }
+  createDesktop(request) {
+    return this.mw.http.request("POST", "/surfaces/desktop/catalog", { body: request });
+  }
+  ensureProjectDesktop(projectId) {
+    return this.mw.http.request("POST", `/surfaces/desktop/projects/${encodeURIComponent(projectId)}/ensure`);
+  }
+  getDesktop(id) {
+    return this.mw.http.request("GET", `/surfaces/desktop/catalog/${savedDesktopID(id)}`);
+  }
+  updateDesktop(id, request) {
+    return this.mw.http.request("PATCH", `/surfaces/desktop/catalog/${savedDesktopID(id)}`, { body: request });
+  }
+  startDesktop(id) {
+    return this.mw.http.request("POST", `/surfaces/desktop/catalog/${savedDesktopID(id)}/start`);
+  }
+  /** Stops this desktop's apps; keeps its profile and files. */
+  stopDesktop(id) {
+    return this.mw.http.request("POST", `/surfaces/desktop/catalog/${savedDesktopID(id)}/stop`);
+  }
+  /** Deletes the desktop's private profile. Closing a viewer uses close(), never this method. */
+  deleteDesktop(id) {
+    return this.mw.http.request("DELETE", `/surfaces/desktop/catalog/${savedDesktopID(id)}`);
+  }
   list() {
     return this.mw.http.request("GET", "/surfaces");
   }
   status(refresh = false) {
-    return this.mw.http.request("GET", "/surfaces/desktop", { query: { refresh } });
+    return this.mw.http.request("GET", this.scoped("/surfaces/desktop"), { query: { refresh } });
   }
   bind(binding) {
+    if (this.desktopId && binding.desktopId !== this.desktopId) throw new Error("The desktop grant belongs to another saved desktop.");
     return this.mw.http.request("PUT", "/surfaces/desktop/binding", { body: binding });
   }
   localStatus() {
@@ -851,22 +900,23 @@ var SurfacesApi = class {
     });
   }
   open(request) {
-    return this.mw.http.request("POST", "/surfaces/desktop/sessions", { body: request });
+    if (this.desktopId && request.desktopId && request.desktopId !== this.desktopId) throw new Error("Select the matching saved desktop.");
+    return this.mw.http.request("POST", this.scoped("/surfaces/desktop/sessions"), { body: request });
   }
   control(id, request) {
-    return this.mw.http.request("POST", `/surfaces/desktop/sessions/${encodeURIComponent(id)}/control`, { body: request });
+    return this.mw.http.request("POST", this.scoped(`/surfaces/desktop/sessions/${encodeURIComponent(id)}/control`), { body: request });
   }
   close(id) {
-    return this.mw.http.request("DELETE", `/surfaces/desktop/sessions/${encodeURIComponent(id)}`);
+    return this.mw.http.request("DELETE", this.scoped(`/surfaces/desktop/sessions/${encodeURIComponent(id)}`));
   }
   capture(id) {
-    return this.mw.http.request("POST", `/surfaces/desktop/sessions/${encodeURIComponent(id)}/captures`);
+    return this.mw.http.request("POST", this.scoped(`/surfaces/desktop/sessions/${encodeURIComponent(id)}/captures`));
   }
   action(request) {
-    return this.mw.http.request("POST", "/surfaces/desktop/actions", { body: request });
+    return this.mw.http.request("POST", this.scoped("/surfaces/desktop/actions"), { body: request });
   }
   receipt(id) {
-    return this.mw.http.request("GET", `/surfaces/desktop/actions/${encodeURIComponent(id)}`);
+    return this.mw.http.request("GET", this.scoped(`/surfaces/desktop/actions/${encodeURIComponent(id)}`));
   }
   artifact(id) {
     return this.mw.http.request("GET", `/artifacts/${encodeURIComponent(id)}`);
@@ -878,7 +928,7 @@ var SurfacesApi = class {
     opts.signal?.addEventListener("abort", abort, { once: true });
     if (opts.signal?.aborted) controller.abort();
     try {
-      const response = await this.mw.http.open("GET", "/surfaces/desktop/events", { signal: controller.signal });
+      const response = await this.mw.http.open("GET", this.scoped("/surfaces/desktop/events"), { signal: controller.signal });
       let instance;
       let revision = -1;
       for await (const snapshot of readSSE(response.body, controller.signal)) {
@@ -1064,7 +1114,7 @@ function computerPairingURI(invitation) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.42" ;
+var SDK_VERSION = "0.1.44" ;
 function versionAtLeast(actual, desired) {
   if (actual === desired) return true;
   if (!actual || !/^\d+\.\d+\.\d+$/.test(actual) || !/^\d+\.\d+\.\d+$/.test(desired)) return false;
@@ -1103,7 +1153,7 @@ async function ensureDaemonBinary(opts = {}) {
     throw new MindwireError(`mindwire: cannot download daemon for non-release SDK version ${version}`);
   }
   const path = await import('path');
-  const { binaryCacheDirectory, cachedExecutable, cacheExecutable } = await import('./binary-cache-ZTEYICUF.js');
+  const { binaryCacheDirectory, cachedExecutable, cacheExecutable } = await import('./binary-cache-CG52TXCZ.js');
   const dir = path.join(opts.cacheDir ?? await binaryCacheDirectory(daemonPlatform), version, `${daemonPlatform}-${daemonArch}`);
   const asset = assetName(version, daemonPlatform, daemonArch);
   const bin = path.join(dir, asset);
@@ -1493,6 +1543,45 @@ var Mindwire = class _Mindwire {
       body: { title }
     });
   }
+  /** Resumable upload over the same connection as chat. Retrying an identical chunk is safe. */
+  uploadAttachmentChunk(chatId, id, chunk, signal) {
+    return this.http.request("PUT", `/chats/${encodeURIComponent(chatId)}/attachments/${encodeURIComponent(id)}`, { body: chunk, signal });
+  }
+  /** Store a file with its conversation, then pass the returned reference in turn options. */
+  async uploadAttachment(chatId, file, options = {}) {
+    if (file.data.byteLength > 16 * 1024 * 1024) throw new RangeError("Attachments must be at most 16 MiB");
+    const data = new Uint8Array(file.data);
+    const hash = async (bytes) => {
+      if (!globalThis.crypto?.subtle) return executableChecksum(bytes);
+      const digest = new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", bytes));
+      return Array.from(digest, (b) => b.toString(16).padStart(2, "0")).join("");
+    };
+    const sha256 = await hash(data);
+    const id = (await hash(new TextEncoder().encode(`${chatId}\0${file.name}\0${sha256}`))).slice(0, 32);
+    let offset = 0;
+    for (; ; ) {
+      options.signal?.throwIfAborted();
+      const end = Math.min(data.length, offset + 384 * 1024);
+      let binary = "";
+      for (let start = offset; start < end; start += 16384) {
+        binary += String.fromCharCode(...data.subarray(start, Math.min(end, start + 16384)));
+      }
+      const state = await this.uploadAttachmentChunk(chatId, id, {
+        name: file.name,
+        mime: file.mime ?? "application/octet-stream",
+        bytes: data.length,
+        sha256,
+        offset,
+        data: btoa(binary)
+      }, options.signal);
+      if (state.id !== id || state.bytes !== data.length || state.offset < end || state.offset > data.length || state.complete && state.offset !== data.length || !state.complete && state.offset <= offset) {
+        throw new Error("Invalid attachment upload acknowledgement");
+      }
+      options.onProgress?.(data.length === 0 ? 1 : state.offset / data.length);
+      if (state.complete) return { artifactId: id, name: state.name, mime: state.mime, bytes: state.bytes };
+      offset = state.offset;
+    }
+  }
   /**
    * `DELETE /chats/{id}` — a true, irreversible delete: purges ALL of the chat's mindwire
    * bookkeeping and, for every session the chat mapped to, removes that agent's native transcript
@@ -1574,6 +1663,7 @@ var Mindwire = class _Mindwire {
       message: input.message
     };
     if (input.requestId !== void 0) body.requestId = input.requestId;
+    if (input.queueIfRunning !== void 0) body.queueIfRunning = input.queueIfRunning;
     if (input.cwd !== void 0) body.cwd = input.cwd;
     if (input.options !== void 0) body.options = input.options;
     if (input.mode !== void 0) body.mode = input.mode;