mindwire 0.1.42 → 0.1.44

package/dist/index.cjs

@@ -471,8 +471,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
@@ -851,6 +851,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 } });
@@ -956,18 +962,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() {
@@ -982,22 +1031,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)}`);
@@ -1009,7 +1059,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)) {
@@ -1194,6 +1244,9 @@ function computerPairingURI(invitation) {
   return `mindwire://${action}?v=1#${encoded}`;
 }
 
+// src/client.ts
+init_binary_cache();
+
 // src/embedded.ts
 init_errors();
 
@@ -1201,7 +1254,7 @@ init_errors();
 init_errors();
 
 // 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;
@@ -1630,6 +1683,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
@@ -1711,6 +1803,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;