@persistmemory/sdk 0.3.0 → 0.4.1

package/dist/index.js

@@ -613,6 +613,14 @@ var Spaces = class {
    * `delete` never destroys a memory that is filed in another Space as well —
    * that one is detached and left alone. `deleted` and `kept` come back so you
    * can say what actually happened.
+   *
+   * `moveTo` NAMES WHERE THE STRANDED ONES GO, and is refused-into rather than
+   * required: most deletions strand nothing, because everything in the Space
+   * is also filed elsewhere, and demanding a destination for those would be a
+   * question about nothing. When something WOULD be left in no Space at all,
+   * the server answers 400 naming this field. It used to file them into the
+   * account's default, which no longer exists — nothing picks a Space on
+   * anybody's behalf, so "keep these" has no answer unless you say where.
    */
   async delete(id, params, options) {
     return this.#http.delete(
@@ -636,21 +644,55 @@ var Spaces = class {
       options
     );
   }
+  /* ------------------------- where this is working ------------------------- */
+  /*
+      `getDefault` AND `setDefault` ARE GONE, with the endpoints they called.
+  
+      They read and wrote the account-wide Space a capture fell into when nobody
+      named one. Nothing falls anywhere now: a Space is chosen for the context
+      doing the capturing, or `remember` answers 400. Keeping the methods would
+      mean keeping two calls that 404, which is a worse break than removing them
+      because it looks like a server fault rather than a change.
+    */
   /**
-   * The Space this account files into when a capture names none.
+   * Which Space a context is working in.
+   *
+   * `chosen` absent means NOTHING sent from that context is kept — there is no
+   * default behind it and nothing picks one. The reply used to carry a
+   * `fallback` for that case and no longer can.
    *
-   * `{}` — an object with no `space` — means there is no default, which is the
-   * normal state rather than a gap. It is also what comes back after the Space
-   * somebody chose has been deleted.
+   * `profile` is the command line's own profile name, and `surface` says which
+   * context is being asked about: `cli` for this profile, `email` for the
+   * account's ingest address. Between them they are the whole of what a caller
+   * may say about where it is working — the server builds the scope key
+   * itself, so this can never read or move where a chat is filing.
    */
-  async getDefault(options) {
-    return this.#http.get("/api/v1/spaces/default", void 0, options);
+  async working(params = {}, options) {
+    return this.#http.get(
+      "/api/v1/spaces/working",
+      {
+        ...params.profile !== void 0 ? { profile: params.profile } : {},
+        ...params.surface !== void 0 ? { surface: params.surface } : {}
+      },
+      options
+    );
   }
-  /** `null` clears it. Not the same as omitting it, which is why the type says so. */
-  async setDefault(spaceId, options) {
+  /**
+   * Works in one from here on. `null` stops working in any.
+   *
+   * Takes an id or a NAME, because that is how a person says it. `null` rather
+   * than an omitted field: "clear this" and "I did not mention it" are
+   * different instructions, and clearing means this context keeps nothing
+   * until a Space is chosen again.
+   */
+  async chooseWorking(space, params = {}, options) {
     return this.#http.patch(
-      "/api/v1/spaces/default",
-      { spaceId },
+      "/api/v1/spaces/working",
+      {
+        space,
+        ...params.profile !== void 0 ? { profile: params.profile } : {},
+        ...params.surface !== void 0 ? { surface: params.surface } : {}
+      },
       options
     );
   }