memax-sdk 0.2.0 → 0.4.0-alpha.1890

package/dist/client.d.ts

@@ -13,6 +13,7 @@ import { AgentsResource } from "./resources/agents.js";
 import { InvitesResource } from "./resources/invites.js";
 import { AccountResource } from "./resources/account.js";
 import { EventsResource } from "./resources/events.js";
+import { BarResource } from "./resources/bar.js";
 export declare class Memax {
     readonly memories: MemoriesResource;
     readonly configs: ConfigsResource;
@@ -28,6 +29,7 @@ export declare class Memax {
     readonly notifications: NotificationsResource;
     readonly agents: AgentsResource;
     readonly events: EventsResource;
+    readonly bar: BarResource;
     constructor(config: MemaxConfig);
     push(...args: Parameters<MemoriesResource["push"]>): Promise<import("./types.js").Memory>;
     recall(...args: Parameters<MemoriesResource["recall"]>): Promise<import("./types.js").RecallResult>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,qBAAa,KAAK;IAChB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAEpB,MAAM,EAAE,WAAW;IA0BzB,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAIlD,MAAM,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAItD,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;CAGvD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,qBAAa,KAAK;IAChB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;gBAEd,MAAM,EAAE,WAAW;IA4BzB,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAIlD,MAAM,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAItD,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;CAGvD"}

package/dist/client.js

@@ -13,6 +13,7 @@ import { AgentsResource } from "./resources/agents.js";
 import { InvitesResource } from "./resources/invites.js";
 import { AccountResource } from "./resources/account.js";
 import { EventsResource } from "./resources/events.js";
+import { BarResource } from "./resources/bar.js";
 export class Memax {
     memories;
     configs;
@@ -28,12 +29,17 @@ export class Memax {
     notifications;
     agents;
     events;
+    bar;
     constructor(config) {
         const transport = new ApiTransport(config);
         const req = transport.request.bind(transport);
         const stream = transport.stream.bind(transport);
         const download = transport.download.bind(transport);
-        const apiUrl = (config.apiUrl ?? "https://api.memax.app").replace(/\/$/, "");
+        // Read the resolved URL from the transport so the DEFAULT_API_URL
+        // fallback lives in exactly one place. Duplicating the hardcoded
+        // literal here would let the transport-level drift guard pass
+        // while `auth.githubURL(...)` silently used a stale host.
+        const apiUrl = transport.apiUrl;
         this.memories = new MemoriesResource(req, stream, download);
         this.configs = new ConfigsResource(req);
         this.agentSessions = new AgentSessionsResource(req, download);
@@ -48,6 +54,7 @@ export class Memax {
         this.notifications = new NotificationsResource(req);
         this.agents = new AgentsResource(req);
         this.events = new EventsResource(stream);
+        this.bar = new BarResource(req);
     }
     async push(...args) {
         return this.memories.push(...args);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -1,9 +1,136 @@
+/**
+ * MemaxError — the typed error thrown by the SDK on every non-2xx
+ * response. Carries the HTTP status, the machine-readable `code` the
+ * server sends in its error envelope, an optional `details` bag, and
+ * (for 429 responses) the `Retry-After` advice in seconds.
+ *
+ * # How to branch on it
+ *
+ * Three patterns exist, in order of preference:
+ *
+ *   1. **Status-class getters** (`isRateLimited`, `isForbidden`, …).
+ *      Covers the common HTTP semantics in one predicate. Most callers
+ *      want this.
+ *
+ *   2. **Machine code comparison** (`err.code === "hub_frozen"`).
+ *      Use when the server returns a business-logic code with no clean
+ *      status-class equivalent — e.g. `hub_frozen` is a 409 but means
+ *      "billing state", not "optimistic-lock conflict". The two
+ *      populate the same status but call for different copy.
+ *
+ *   3. **Raw status** (`err.status === 418`). Escape hatch. Avoid
+ *      unless you genuinely need the number.
+ *
+ * # Why getters, not a single `kind: "rateLimited" | ...` tag
+ *
+ * Errors can legitimately be in multiple classes (a 500 is a server
+ * error AND, by definition, retryable). Getters compose cleanly and
+ * stay open to extension without a breaking enum change. They also
+ * keep the public shape narrow: the SDK doesn't need to document a
+ * discriminator union that it'd have to evolve on every new status.
+ */
 export declare class MemaxError extends Error {
     code: string;
     status: number;
     details?: Record<string, unknown> | undefined;
-    constructor(message: string, code: string, status: number, details?: Record<string, unknown> | undefined);
-    /** True when the error is a quota limit (402). */
+    /**
+     * When set (always on 429 responses that carry a Retry-After header),
+     * this is the server's advice for how many seconds to wait before
+     * retrying. The transport parses both integer-second and HTTP-date
+     * forms; undefined means the header was missing or malformed.
+     *
+     * Rounded up to the nearest whole second for HTTP-date parsing, so
+     * callers can always display a clean countdown without needing
+     * ceiling logic of their own.
+     */
+    retryAfterSeconds?: number;
+    constructor(message: string, code: string, status: number, details?: Record<string, unknown> | undefined, retryAfterSeconds?: number);
+    /**
+     * Rate-limit (HTTP 429). Server also stamps `code === "rate_limited"`.
+     * Either signal is load-bearing: callers in browsers may see a 429
+     * surfaced by an intermediate proxy (CDN, WAF) without the server's
+     * error envelope, so the status-code branch is a genuine second path,
+     * not a duplicate.
+     */
+    get isRateLimited(): boolean;
+    /**
+     * Permission denied (HTTP 403). The user is authenticated but the
+     * grant does not permit this operation — includes API-key scope
+     * failures, hub-member role mismatches, and admin-only endpoint
+     * refusals. Distinct from 401 (not authenticated) which should push
+     * the user through the re-auth flow rather than showing a toast.
+     */
+    get isForbidden(): boolean;
+    /**
+     * Resource not found (HTTP 404). Usually means the thing the user
+     * was operating on no longer exists — deleted by another client,
+     * archived by a dream cycle, revoked by an admin. Callers may prefer
+     * silent success over an error toast for idempotent deletes, but the
+     * default copy ("That no longer exists") is accurate.
+     */
+    get isNotFound(): boolean;
+    /**
+     * State conflict (HTTP 409). Ambiguous on its own — could be
+     * optimistic-lock (someone else updated the row mid-edit) or a
+     * business-logic refusal (hub_frozen, duplicate_slug). Callers that
+     * care about the distinction should check `err.code` first, then
+     * fall back to this getter for the generic "refresh and try again"
+     * copy.
+     */
+    get isConflict(): boolean;
+    /**
+     * Quota exceeded (HTTP 402). The user hit their plan's limit
+     * (memory count, storage bytes, recall count, etc.). Distinct from
+     * rate-limited: the answer isn't "wait", it's "upgrade" or "archive
+     * something". Surface a link to the plan page, not a countdown.
+     */
     get isQuotaExceeded(): boolean;
+    /**
+     * Authentication failure (HTTP 401). Means the session / token is
+     * missing or expired — the user is not authenticated, not that
+     * they're authenticated-but-forbidden. Callers almost always want
+     * to redirect to sign-in rather than toast.
+     */
+    get isUnauthorized(): boolean;
+    /**
+     * Bad request (HTTP 400). Usually a client bug (malformed payload,
+     * invalid UUID, etc.) — shouldn't surface in production UIs. The
+     * classifier's copy is deliberately vague because we'd rather the
+     * error be reported than guessed-at.
+     */
+    get isBadRequest(): boolean;
+    /**
+     * Server error (HTTP 5xx). The server failed or is momentarily
+     * unavailable. Retryable — the classifier suggests "try again in
+     * a moment". Distinct from network-offline (status 0) which means
+     * the request didn't reach the server at all.
+     */
+    get isServerError(): boolean;
+    /**
+     * Network-layer failure (status 0). The request didn't reach the
+     * server — fetch threw (DNS, TCP, TLS, browser offline). The SDK
+     * doesn't currently manufacture this status code itself (it wraps
+     * fetch throws differently), so this is a forward-compatibility
+     * hook for a future transport refactor. Today, callers that want to
+     * detect offline should combine `err.status === 0` with
+     * `navigator.onLine === false` checks.
+     */
+    get isNetwork(): boolean;
 }
+/**
+ * parseRetryAfter — shared helper for 429 Retry-After parsing.
+ *
+ * The spec (RFC 7231 §7.1.3) allows two formats:
+ *   - delta-seconds (a non-negative integer): "120"
+ *   - HTTP-date (IMF-fixdate): "Fri, 31 Dec 1999 23:59:59 GMT"
+ *
+ * We handle both. Returns undefined when the header is missing or
+ * unparseable, so callers can treat "don't know how long to wait" the
+ * same as "server didn't say".
+ *
+ * Exported so the transport module and tests can share one code path —
+ * otherwise two implementations drift out of sync the first time
+ * anyone adds a new edge case (we've shipped that bug before).
+ */
+export declare function parseRetryAfter(raw: string | null | undefined, now?: Date): number | undefined;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;IAG1B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHxC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAM1C,kDAAkD;IAClD,IAAI,eAAe,IAAI,OAAO,CAE7B;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAW,SAAQ,KAAK;IAe1B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAhB1C;;;;;;;;;OASG;IACI,iBAAiB,CAAC,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EACxC,iBAAiB,CAAC,EAAE,MAAM;IAO5B;;;;;;OAMG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;;;OAMG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;;OAMG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;;;;;OAOG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;;;OAKG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;;;OAKG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;;OAKG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,GAAG,GAAE,IAAiB,GACrB,MAAM,GAAG,SAAS,CA4BpB"}

package/dist/errors.js

@@ -1,17 +1,191 @@
+/**
+ * MemaxError — the typed error thrown by the SDK on every non-2xx
+ * response. Carries the HTTP status, the machine-readable `code` the
+ * server sends in its error envelope, an optional `details` bag, and
+ * (for 429 responses) the `Retry-After` advice in seconds.
+ *
+ * # How to branch on it
+ *
+ * Three patterns exist, in order of preference:
+ *
+ *   1. **Status-class getters** (`isRateLimited`, `isForbidden`, …).
+ *      Covers the common HTTP semantics in one predicate. Most callers
+ *      want this.
+ *
+ *   2. **Machine code comparison** (`err.code === "hub_frozen"`).
+ *      Use when the server returns a business-logic code with no clean
+ *      status-class equivalent — e.g. `hub_frozen` is a 409 but means
+ *      "billing state", not "optimistic-lock conflict". The two
+ *      populate the same status but call for different copy.
+ *
+ *   3. **Raw status** (`err.status === 418`). Escape hatch. Avoid
+ *      unless you genuinely need the number.
+ *
+ * # Why getters, not a single `kind: "rateLimited" | ...` tag
+ *
+ * Errors can legitimately be in multiple classes (a 500 is a server
+ * error AND, by definition, retryable). Getters compose cleanly and
+ * stay open to extension without a breaking enum change. They also
+ * keep the public shape narrow: the SDK doesn't need to document a
+ * discriminator union that it'd have to evolve on every new status.
+ */
 export class MemaxError extends Error {
     code;
     status;
     details;
-    constructor(message, code, status, details) {
+    /**
+     * When set (always on 429 responses that carry a Retry-After header),
+     * this is the server's advice for how many seconds to wait before
+     * retrying. The transport parses both integer-second and HTTP-date
+     * forms; undefined means the header was missing or malformed.
+     *
+     * Rounded up to the nearest whole second for HTTP-date parsing, so
+     * callers can always display a clean countdown without needing
+     * ceiling logic of their own.
+     */
+    retryAfterSeconds;
+    constructor(message, code, status, details, retryAfterSeconds) {
         super(message);
         this.code = code;
         this.status = status;
         this.details = details;
         this.name = "MemaxError";
+        this.retryAfterSeconds = retryAfterSeconds;
     }
-    /** True when the error is a quota limit (402). */
+    /**
+     * Rate-limit (HTTP 429). Server also stamps `code === "rate_limited"`.
+     * Either signal is load-bearing: callers in browsers may see a 429
+     * surfaced by an intermediate proxy (CDN, WAF) without the server's
+     * error envelope, so the status-code branch is a genuine second path,
+     * not a duplicate.
+     */
+    get isRateLimited() {
+        return this.status === 429 || this.code === "rate_limited";
+    }
+    /**
+     * Permission denied (HTTP 403). The user is authenticated but the
+     * grant does not permit this operation — includes API-key scope
+     * failures, hub-member role mismatches, and admin-only endpoint
+     * refusals. Distinct from 401 (not authenticated) which should push
+     * the user through the re-auth flow rather than showing a toast.
+     */
+    get isForbidden() {
+        return this.status === 403;
+    }
+    /**
+     * Resource not found (HTTP 404). Usually means the thing the user
+     * was operating on no longer exists — deleted by another client,
+     * archived by a dream cycle, revoked by an admin. Callers may prefer
+     * silent success over an error toast for idempotent deletes, but the
+     * default copy ("That no longer exists") is accurate.
+     */
+    get isNotFound() {
+        return this.status === 404;
+    }
+    /**
+     * State conflict (HTTP 409). Ambiguous on its own — could be
+     * optimistic-lock (someone else updated the row mid-edit) or a
+     * business-logic refusal (hub_frozen, duplicate_slug). Callers that
+     * care about the distinction should check `err.code` first, then
+     * fall back to this getter for the generic "refresh and try again"
+     * copy.
+     */
+    get isConflict() {
+        return this.status === 409;
+    }
+    /**
+     * Quota exceeded (HTTP 402). The user hit their plan's limit
+     * (memory count, storage bytes, recall count, etc.). Distinct from
+     * rate-limited: the answer isn't "wait", it's "upgrade" or "archive
+     * something". Surface a link to the plan page, not a countdown.
+     */
     get isQuotaExceeded() {
-        return this.code === "quota_exceeded";
+        return this.status === 402 || this.code === "quota_exceeded";
+    }
+    /**
+     * Authentication failure (HTTP 401). Means the session / token is
+     * missing or expired — the user is not authenticated, not that
+     * they're authenticated-but-forbidden. Callers almost always want
+     * to redirect to sign-in rather than toast.
+     */
+    get isUnauthorized() {
+        return this.status === 401;
+    }
+    /**
+     * Bad request (HTTP 400). Usually a client bug (malformed payload,
+     * invalid UUID, etc.) — shouldn't surface in production UIs. The
+     * classifier's copy is deliberately vague because we'd rather the
+     * error be reported than guessed-at.
+     */
+    get isBadRequest() {
+        return this.status === 400;
+    }
+    /**
+     * Server error (HTTP 5xx). The server failed or is momentarily
+     * unavailable. Retryable — the classifier suggests "try again in
+     * a moment". Distinct from network-offline (status 0) which means
+     * the request didn't reach the server at all.
+     */
+    get isServerError() {
+        return this.status >= 500 && this.status < 600;
+    }
+    /**
+     * Network-layer failure (status 0). The request didn't reach the
+     * server — fetch threw (DNS, TCP, TLS, browser offline). The SDK
+     * doesn't currently manufacture this status code itself (it wraps
+     * fetch throws differently), so this is a forward-compatibility
+     * hook for a future transport refactor. Today, callers that want to
+     * detect offline should combine `err.status === 0` with
+     * `navigator.onLine === false` checks.
+     */
+    get isNetwork() {
+        return this.status === 0;
+    }
+}
+/**
+ * parseRetryAfter — shared helper for 429 Retry-After parsing.
+ *
+ * The spec (RFC 7231 §7.1.3) allows two formats:
+ *   - delta-seconds (a non-negative integer): "120"
+ *   - HTTP-date (IMF-fixdate): "Fri, 31 Dec 1999 23:59:59 GMT"
+ *
+ * We handle both. Returns undefined when the header is missing or
+ * unparseable, so callers can treat "don't know how long to wait" the
+ * same as "server didn't say".
+ *
+ * Exported so the transport module and tests can share one code path —
+ * otherwise two implementations drift out of sync the first time
+ * anyone adds a new edge case (we've shipped that bug before).
+ */
+export function parseRetryAfter(raw, now = new Date()) {
+    if (!raw)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    // Reject "number-ish but not delta-seconds" inputs (-5, 1.5, +3, .9)
+    // before they reach Date.parse, which would interpret them as
+    // ambiguous dates. The spec accepts ONLY `1*DIGIT` for delta-seconds,
+    // and every HTTP-date form contains letters ("Mon", "GMT", etc.), so
+    // a string that's neither pure-digits nor contains a letter is not
+    // a valid Retry-After value.
+    if (!/^\d+$/.test(trimmed) && !/[a-zA-Z]/.test(trimmed))
+        return undefined;
+    // Integer seconds — the common case. Regex is deliberate over
+    // Number() to reject floats and scientific notation up front.
+    if (/^\d+$/.test(trimmed)) {
+        const n = parseInt(trimmed, 10);
+        return Number.isFinite(n) && n >= 0 ? n : undefined;
     }
+    // HTTP-date form — Date.parse handles IMF-fixdate and RFC 850.
+    const parsed = Date.parse(trimmed);
+    if (Number.isNaN(parsed))
+        return undefined;
+    const deltaMs = parsed - now.getTime();
+    if (deltaMs <= 0)
+        return 0;
+    // Round up so "wait 0.3 seconds" becomes 1, not 0 — countdowns
+    // that briefly display "0s" look broken.
+    return Math.ceil(deltaMs / 1000);
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG1B;IACA;IACA;IAJT,YACE,OAAe,EACR,IAAY,EACZ,MAAc,EACd,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;IAED,kDAAkD;IAClD,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Memax } from "./client.js";
 export type { EventsSubscribeOptions } from "./resources/events.js";
 export { MemaxError } from "./errors.js";
-export type { MemaxConfig, AuthProvider, PushOptions, RecallOptions, AskOptions, ListMemoriesOptions, HubUpdateParams, MemoryKind, MemoryStability, Memory, MemoryAttachment, AttachmentViewURL, MemoryLifecycle, MemoryUpdateInput, DreamActionRef, DreamTopicRef, ShareMemoryResult, BatchMoveResult, BatchMoveSkippedMemory, BatchMoveSkipReason, BatchDeleteResult, BatchDeleteSkippedMemory, BatchDeleteSkipReason, AgentConfigBatchDeleteResult, AgentConfigDeleteSkippedItem, AgentConfigDeleteSkipReason, RelatedMemory, RecalledMemory, RecallResult, SearchResult, AskResult, ListMemoriesResult, Scope, AgentConfig, AgentConfigListResult, DeletedAgentConfig, SyncAction, SyncPlanAction, SyncManifestEntry, ConfigSyncRequest, AgentConfigSyncAck, ConfigSyncAckRequest, ConfigLocalDeleteRequest, RestoreDeletedConfigRequest, ConfigUpsertRequest, ConfigMergeRequest, UploadIntent, AgentSession, DeletedAgentSession, SessionSyncAction, SessionSyncPlanAction, SessionSyncManifestEntry, AgentSessionSyncRequest, AgentSessionSyncAck, AgentSessionSyncAckRequest, AgentSessionLocalDeleteRequest, RestoreDeletedSessionRequest, AgentSessionUpsertRequest, ResolveDivergenceRequest, ResolveDivergenceResponse, AuthProviderName, User, MeResponse, AuthTokenPair, ImpersonationResult, AuthIdentity, UnlinkProviderResult, ApiKeyCreateOptions, ApiKey, ApiKeyListItem, UpdateApiKeyPayload, UpdateApiKeyResult, OAuthConsentHub, OAuthConsentPermission, OAuthConsentRequest, UpdateProfileResult, DeleteAllDataResult, Hub, HubWithRole, HubMember, HubInvite, HubInviteeInput, HubOwnershipTransfer, HubDetailResult, HubSummary, HubSummaryStats, HubSummaryHeader, HubSummaryMember, HubAccent, HubRole, HubType, HubHeaderState, HubTimeBucket, HubGreetingKey, ContributorDeletePolicy, InviteDetails, InviteAcceptResult, DevFlagsSettings, Settings, SettingsUpdateInput, Usage, UsageWithLimits, PlanScope, PlanDefinition, UserLimits, Topic, TopicLifecycle, TopicDeltaSummary, TopicTree, TopicListResponse, TopicCreateParams, TopicUpdateParams, TopicUpdateErrorCode, TopicReorderOperation, TopicMemoriesResponse, DreamRun, DreamAction, DreamLatestRunSummary, DreamPendingReviewSummary, DreamIntelligenceSummary, DreamReport, ReviewTopicMergePayload, ReviewTopicRestructurePayload, ReviewTopicRef, Notification, NotificationAudience, NotificationStatus, NotificationResolution, NotificationKind, NotificationKindCount, NotificationSummary, NotificationListQuery, NotificationListResponse, NotificationBulkQuery, NotificationBulkResult, NotificationResolveAction, NotificationResolveResult, ReviewContradictionPayload, ReviewMemoryRef, DreamRunCompletedPayload, DreamRunCounts, HubInvitePayload, HubInviteHubRef, HubInviteInviterRef, HubMemberJoinedPayload, HubMemberRef, HubInviteAcceptedPayload, HubInviteDeclinedPayload, HubInviteDeclinedByYouPayload, HubOwnershipTransferPayload, HubOwnershipTransferredPayload, SystemNoticePayload, GiftInviteLinkPayload, ConnectedAgent, ConnectedAgentWithStats, ConnectedAgentUpdate, DisconnectAgentResult, AgentDisconnectSkipReason, AgentDisconnectSkippedItem, ApiKeyRevokeResult, ApiKeyRevokeSkipReason, ApiKeyRevokeSkippedItem, } from "./types.js";
+export type { MemaxConfig, AuthProvider, PushOptions, RecallOptions, AskOptions, ListMemoriesOptions, HubUpdateParams, MemoryKind, MemoryStability, Memory, MemoryAttachment, AttachmentViewURL, MemoryLifecycle, MemoryUpdateInput, DreamActionRef, DreamTopicRef, ShareMemoryResult, BatchMoveResult, BatchMoveSkippedMemory, BatchMoveSkipReason, BatchDeleteResult, BatchDeleteSkippedMemory, BatchDeleteSkipReason, AgentConfigBatchDeleteResult, AgentConfigDeleteSkippedItem, AgentConfigDeleteSkipReason, RelatedMemory, RecalledMemory, RecallResult, SearchResult, BarSearchResult, BarTopicMatch, BarHubMatch, AskResult, ListMemoriesResult, Scope, AgentConfig, AgentConfigListResult, DeletedAgentConfig, SyncAction, SyncPlanAction, SyncManifestEntry, ConfigSyncRequest, AgentConfigSyncAck, ConfigSyncAckRequest, ConfigLocalDeleteRequest, RestoreDeletedConfigRequest, ConfigUpsertRequest, ConfigMergeRequest, UploadIntent, AgentSession, DeletedAgentSession, SessionSyncAction, SessionSyncPlanAction, SessionSyncManifestEntry, AgentSessionSyncRequest, AgentSessionSyncAck, AgentSessionSyncAckRequest, AgentSessionLocalDeleteRequest, RestoreDeletedSessionRequest, AgentSessionUpsertRequest, ResolveDivergenceRequest, ResolveDivergenceResponse, AuthProviderName, User, MeResponse, AuthTokenPair, ImpersonationResult, AuthIdentity, UnlinkProviderResult, ApiKeyCreateOptions, ApiKey, ApiKeyListItem, UpdateApiKeyPayload, UpdateApiKeyResult, OAuthConsentHub, OAuthConsentPermission, OAuthConsentRequest, UpdateProfileResult, DeleteAllDataResult, Hub, HubSettings, HubSettingsInput, HubWithRole, HubMember, HubInvite, HubInviteeInput, HubOwnershipTransfer, HubDetailResult, HubSummary, HubSummaryStats, HubSummaryHeader, HubSummaryMember, HubAccent, HubRole, HubType, HubHeaderState, HubHeaderAuroraMode, HubTimeBucket, HubGreetingKey, ContributorDeletePolicy, InviteDetails, InviteAcceptResult, DevFlagsSettings, Settings, SettingsUpdateInput, Usage, UsageWithLimits, PlanScope, PlanDefinition, UserLimits, Topic, TopicLifecycle, TopicDeltaSummary, TopicTree, TopicListResponse, TopicCreateParams, TopicUpdateParams, TopicUpdateErrorCode, TopicReorderOperation, TopicMemoriesResponse, DreamRun, DreamAction, DreamLatestRunSummary, DreamPendingReviewSummary, DreamIntelligenceSummary, DreamReport, DreamRunListOptions, DreamRunListResponse, ReviewTopicMergePayload, ReviewTopicRestructurePayload, ReviewTopicRef, Notification, NotificationAudience, NotificationStatus, NotificationResolution, NotificationKind, NotificationKindCount, NotificationSummary, NotificationListQuery, NotificationListResponse, NotificationBulkQuery, NotificationBulkResult, NotificationResolveAction, NotificationResolveResult, ReviewContradictionPayload, ReviewMemoryRef, DreamRunCompletedPayload, DreamRunCounts, HubInvitePayload, HubInviteHubRef, HubInviteInviterRef, HubMemberJoinedPayload, HubMemberRef, HubInviteAcceptedPayload, HubInviteDeclinedPayload, HubInviteDeclinedByYouPayload, HubOwnershipTransferPayload, HubOwnershipTransferredPayload, SystemNoticePayload, GiftInviteLinkPayload, ConnectedAgent, ConnectedAgentWithStats, ConnectedAgentUpdate, DisconnectAgentResult, AgentDisconnectSkipReason, AgentDisconnectSkippedItem, ApiKeyRevokeResult, ApiKeyRevokeSkipReason, ApiKeyRevokeSkippedItem, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/bar.d.ts

@@ -0,0 +1,19 @@
+import type { BarSearchResult } from "../types.js";
+import type { RequestFn } from "../transport.js";
+export declare class BarResource {
+    private readonly req;
+    constructor(req: RequestFn);
+    /**
+     * Unified search for the web bar's pre-Enter "quick matches" layer.
+     * Returns memory FTS matches plus topic and hub jump-to candidates
+     * in a single response. Empty query returns empty arrays instead of
+     * a 400 so the client can call this unconditionally.
+     */
+    search(query: string, options?: {
+        limit?: number;
+        hubId?: string;
+        topicId?: string;
+        signal?: AbortSignal;
+    }): Promise<BarSearchResult>;
+}
+//# sourceMappingURL=bar.d.ts.map

package/dist/resources/bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar.d.ts","sourceRoot":"","sources":["../../src/resources/bar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,OAAO,CAAC,eAAe,CAAC;CAO5B"}

package/dist/resources/bar.js

@@ -0,0 +1,20 @@
+export class BarResource {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    /**
+     * Unified search for the web bar's pre-Enter "quick matches" layer.
+     * Returns memory FTS matches plus topic and hub jump-to candidates
+     * in a single response. Empty query returns empty arrays instead of
+     * a 400 so the client can call this unconditionally.
+     */
+    async search(query, options) {
+        return this.req("GET", "/v1/bar/search", {
+            query: { q: query, limit: options?.limit, topic_id: options?.topicId },
+            hubId: options?.hubId,
+            signal: options?.signal,
+        });
+    }
+}
+//# sourceMappingURL=bar.js.map

package/dist/resources/bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar.js","sourceRoot":"","sources":["../../src/resources/bar.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAKC;QAED,OAAO,IAAI,CAAC,GAAG,CAAkB,KAAK,EAAE,gBAAgB,EAAE;YACxD,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;YACtE,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/dreams.d.ts

@@ -1,9 +1,23 @@
-import type { DreamReport, DreamRun } from "../types.js";
+import type { DreamReport, DreamRunListOptions, DreamRunListResponse } from "../types.js";
 import type { RequestFn } from "../transport.js";
 export declare class DreamsResource {
     private readonly req;
     constructor(req: RequestFn);
-    list(limit?: number, hubId?: string): Promise<DreamRun[]>;
+    /**
+     * List recent dream runs for the caller, across hubs they
+     * belong to. Keyset paginated: pass the previous response's
+     * `next_cursor` as `cursor` to fetch the next page.
+     *
+     * Scoping:
+     *   - `hubId` narrows to one hub (the caller must be a member,
+     *     else the server returns 403).
+     *   - Omitting `hubId` spans every hub the caller participates
+     *     in — the default behavior for the Dream history view.
+     *
+     * Default limit is 20 on the server (max 100). Passing a
+     * `limit` overrides that per request.
+     */
+    list(opts?: DreamRunListOptions): Promise<DreamRunListResponse>;
     report(hubId?: string): Promise<DreamReport>;
     trigger(hubId?: string): Promise<{
         status: string;

package/dist/resources/dreams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dreams.d.ts","sourceRoot":"","sources":["../../src/resources/dreams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,IAAI,CAAC,KAAK,SAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOrD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5C,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAM3D"}
+{"version":3,"file":"dreams.d.ts","sourceRoot":"","sources":["../../src/resources/dreams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQnE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5C,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAM3D"}

package/dist/resources/dreams.js

@@ -3,11 +3,29 @@ export class DreamsResource {
     constructor(req) {
         this.req = req;
     }
-    async list(limit = 10, hubId) {
-        return this.req("GET", "/v1/dreams", {
-            hubId,
-            query: { limit },
-        });
+    /**
+     * List recent dream runs for the caller, across hubs they
+     * belong to. Keyset paginated: pass the previous response's
+     * `next_cursor` as `cursor` to fetch the next page.
+     *
+     * Scoping:
+     *   - `hubId` narrows to one hub (the caller must be a member,
+     *     else the server returns 403).
+     *   - Omitting `hubId` spans every hub the caller participates
+     *     in — the default behavior for the Dream history view.
+     *
+     * Default limit is 20 on the server (max 100). Passing a
+     * `limit` overrides that per request.
+     */
+    async list(opts = {}) {
+        const query = {};
+        if (opts.limit !== undefined)
+            query.limit = opts.limit;
+        if (opts.hubId !== undefined)
+            query.hub_id = opts.hubId;
+        if (opts.cursor !== undefined)
+            query.cursor = opts.cursor;
+        return this.req("GET", "/v1/dreams", { query });
     }
     async report(hubId) {
         return this.req("GET", "/v1/dreams/report", { hubId });

package/dist/resources/dreams.js.map

@@ -1 +1 @@
-{"version":3,"file":"dreams.js","sourceRoot":"","sources":["../../src/resources/dreams.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,EAAE,KAAc;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE;YACnC,KAAK;YACL,KAAK,EAAE,EAAE,KAAK,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAc;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE;YAC5C,IAAI,EAAE,EAAE;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"dreams.js","sourceRoot":"","sources":["../../src/resources/dreams.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CAAC,OAA4B,EAAE;QACvC,MAAM,KAAK,GAAgD,EAAE,CAAC;QAC9D,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAc;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE;YAC5C,IAAI,EAAE,EAAE;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/memories.d.ts

@@ -15,11 +15,21 @@ export declare class MemoriesResource {
         limit?: number;
         hubId?: string;
         topicId?: string;
+        signal?: AbortSignal;
     }): Promise<SearchResult[]>;
-    get(id: string): Promise<Memory>;
-    /** Semantically related memories via vector nearest-neighbor. Sub-50ms, no external API calls. */
+    get(id: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<Memory>;
+    /**
+     * Semantically related memories via vector nearest-neighbor. Sub-50ms, no
+     * external API calls.
+     *
+     * Neighbor scope is derived server-side from the source memory's hub, so
+     * there is no hubId parameter here — a memory's neighbors are the same set
+     * regardless of which hub the viewer is currently in.
+     */
     related(id: string, options?: {
-        hubId?: string;
+        signal?: AbortSignal;
     }): Promise<RelatedMemory[]>;
     delete(id: string): Promise<void>;
     update(id: string, patch: MemoryUpdateInput): Promise<Memory>;

package/dist/resources/memories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/resources/memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEvE,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,UAAU;IAGjC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB7D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAkBrE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAclE,SAAS,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,GAC9C,eAAe;IAeZ,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8BtE,iFAAiF;IAC3E,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,YAAY,EAAE,CAAC;IAOpB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAItC,kGAAkG;IAC5F,OAAO,CACX,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,aAAa,EAAE,CAAC;IAMrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7D,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMlE,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,CAAC;IAMpB;;;;;;;;;OASG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC;IAO7B;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAc5D;;;;;;;;;;;;;;;;;;OAkBG;IACG,SAAS,CACb,GAAG,EAAE,MAAM,EAAE,EACb,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,eAAe,CAAC;CAc5B"}
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/resources/memories.ts"],"names":[],"mappings":"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"}