@persistmemory/sdk 0.3.0 → 0.4.0

package/dist/resources/spaces.d.ts

@@ -1,6 +1,6 @@
 import type { HttpClient, RequestOptions } from "../http.js";
 import { Paginated } from "../pagination.js";
-import type { CreateSpaceParams, ListSpacesParams, Memory, ShareSpaceParams, Space, SpaceCollaborator, GrantableSpaceRole, UpdateSpaceParams } from "../types.js";
+import type { CreateSpaceParams, ListSpacesParams, Memory, ShareSpaceParams, Space, SpaceCollaborator, GrantableSpaceRole, UpdateSpaceParams, WorkingSpace } from "../types.js";
 /**
  * Spaces: a boundary around a set of memories.
  *
@@ -36,12 +36,22 @@ export declare class Spaces {
      * `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.
      */
     delete(id: string, params: {
         readonly memories: "keep" | "delete";
+        readonly moveTo?: string;
     }, options?: RequestOptions): Promise<{
         deleted: number;
         kept: number;
+        rehomed?: number;
     }>;
     /**
      * Merges Spaces into a NEW one, leaving every source exactly as it was.
@@ -60,19 +70,34 @@ export declare class Spaces {
         added: number;
     }>;
     /**
-     * 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.
      */
-    getDefault(options?: RequestOptions): Promise<{
-        space?: Space;
-    }>;
-    /** `null` clears it. Not the same as omitting it, which is why the type says so. */
-    setDefault(spaceId: string | null, options?: RequestOptions): Promise<{
-        space?: Space;
-    }>;
+    working(params?: {
+        readonly profile?: string;
+        readonly surface?: "cli" | "email";
+    }, options?: RequestOptions): Promise<WorkingSpace>;
+    /**
+     * 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.
+     */
+    chooseWorking(space: string | null, params?: {
+        readonly profile?: string;
+        readonly surface?: "cli" | "email";
+    }, options?: RequestOptions): Promise<WorkingSpace>;
     /** Renaming, retention, and archiving - `archived` is a field, not a verb. */
     update(id: string, params: UpdateSpaceParams, options?: RequestOptions): Promise<Space>;
     /**

package/dist/types.d.ts

@@ -141,6 +141,21 @@ export interface ListMemoriesParams {
 export interface RememberParams {
     readonly text: string;
     readonly title?: string;
+    /**
+     * The Spaces this is filed into. REQUIRED BY THE SERVER, though optional
+     * here.
+     *
+     * A capture with no Space is refused with a 400 that names this account's
+     * Spaces. It used to be filed into the account's default, its oldest Space,
+     * or a new one made for it — three destinations nobody chose — and none of
+     * those exists now: a Space is chosen or nothing is kept.
+     *
+     * It stays optional in the TYPE so that a caller upgrading this package gets
+     * the explanation from the server, in a sentence listing the Spaces they
+     * actually have, rather than a compile error that says "required" and leaves
+     * them looking for a list. Every call that omits it now fails at runtime;
+     * that break is intended and is the whole change.
+     */
     readonly spaceIds?: readonly string[];
 }
 /**
@@ -247,6 +262,35 @@ export interface Space {
     /** Set when archived. An archived Space is hidden, not deleted. */
     readonly archivedAt?: string;
 }
+/**
+ * Where one context is filing, and whether anybody decided it.
+ *
+ * TWO FIELDS BECAUSE THEY ARE TWO FACTS, and merging them is the mistake this
+ * shape exists to make impossible. `chosen` is a Space somebody picked here: it
+ * narrows what a question is answered from as well as where a note lands.
+ * `fallback` is the account's own default, adopted automatically for captures
+ * that name none, and it narrows NOTHING — reading through it would silently
+ * scope every question the person ever asked to a Space they never picked.
+ *
+ * Neither present means no Space can be named at all, which is a real state
+ * rather than a gap: an account with no Spaces yet.
+ */
+export interface WorkingSpace {
+    /** The context this answers about — `cli:default`, `email`. The server owns it. */
+    readonly scope: string;
+    /**
+     * The Space chosen for this context.
+     *
+     * ABSENT MEANS NOTHING IS KEPT from it, not "kept somewhere else". There
+     * used to be a `fallback` beside this — the account-wide Space a capture
+     * fell into when nobody chose — and it is gone with the setting itself: a
+     * Space is chosen or the capture is refused.
+     */
+    readonly chosen?: {
+        readonly id: string;
+        readonly name: string;
+    };
+}
 export interface CreateSpaceParams {
     readonly name: string;
     readonly description?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@persistmemory/sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The official TypeScript client for the PersistMemory API",
   "license": "MIT",
   "author": "PersistMemory",