memax-sdk 0.1.2 → 0.1.3

package/dist/resources/hubs.d.ts

@@ -0,0 +1,10 @@
+import type { Hub, HubWithRole, HubSwitchResult } from "../types.js";
+import type { RequestFn } from "../transport.js";
+export declare class HubsResource {
+    private readonly req;
+    constructor(req: RequestFn);
+    list(): Promise<HubWithRole[]>;
+    create(name: string): Promise<Hub>;
+    switch(idOrSlug: string): Promise<HubSwitchResult>;
+}
+//# sourceMappingURL=hubs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hubs.d.ts","sourceRoot":"","sources":["../../src/resources/hubs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIlC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAGzD"}

package/dist/resources/hubs.js

@@ -0,0 +1,16 @@
+export class HubsResource {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    async list() {
+        return this.req("GET", "/v1/hubs");
+    }
+    async create(name) {
+        return this.req("POST", "/v1/hubs", { body: { name } });
+    }
+    async switch(idOrSlug) {
+        return this.req("POST", `/v1/hubs/${idOrSlug}/switch`, { body: {} });
+    }
+}
+//# sourceMappingURL=hubs.js.map

package/dist/resources/hubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubs.js","sourceRoot":"","sources":["../../src/resources/hubs.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,QAAQ,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/resources/memories.d.ts

@@ -0,0 +1,13 @@
+import type { AskOptions, AskResult, ListMemoriesOptions, ListMemoriesResult, Memory, PushOptions, RecallOptions, RecallResult } from "../types.js";
+import type { RequestFn } from "../transport.js";
+export declare class MemoriesResource {
+    private readonly req;
+    constructor(req: RequestFn);
+    push(content: string, options?: PushOptions): Promise<Memory>;
+    recall(query: string, options?: RecallOptions): Promise<RecallResult>;
+    ask(query: string, options?: AskOptions): Promise<AskResult>;
+    list(options?: ListMemoriesOptions): Promise<ListMemoriesResult>;
+    get(id: string): Promise<Memory>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=memories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/resources/memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,aAAa,EACb,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB7D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBrE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAW5D,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0BhE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/resources/memories.js

@@ -0,0 +1,73 @@
+export class MemoriesResource {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    async push(content, options) {
+        return this.req("POST", "/v1/memories", {
+            body: {
+                content,
+                title: options?.title ?? "",
+                hint: options?.hint ?? "",
+                category: options?.category ?? "",
+                tags: options?.tags ?? [],
+                source: options?.source ?? "sdk",
+                source_path: options?.sourcePath,
+                content_type: options?.contentType ?? "markdown",
+                project_context: options?.projectContext,
+            },
+            hubId: options?.hubId,
+        });
+    }
+    async recall(query, options) {
+        return this.req("POST", "/v1/recall", {
+            body: {
+                query,
+                limit: options?.limit ?? 5,
+                category: options?.category,
+                tags: options?.tags,
+                include_archived: options?.includeArchived,
+                source: options?.source ?? "sdk",
+                working_dir: options?.workingDir,
+                project_context: options?.projectContext,
+            },
+            hubId: options?.hubId,
+        });
+    }
+    async ask(query, options) {
+        return this.req("POST", "/v1/ask", {
+            body: {
+                query,
+                limit: options?.limit ?? 10,
+                model: options?.model ?? "auto",
+                locale: options?.locale,
+            },
+        });
+    }
+    async list(options) {
+        const res = await this.req("GET", "/v1/memories", {
+            query: {
+                limit: options?.limit,
+                cursor: options?.cursor,
+                sort: options?.sort,
+            },
+            hubId: options?.hubId,
+        });
+        if (Array.isArray(res)) {
+            return {
+                memories: res,
+                next_cursor: "",
+                has_more: false,
+                total: res.length,
+            };
+        }
+        return res;
+    }
+    async get(id) {
+        return this.req("GET", `/v1/memories/${id}`);
+    }
+    async delete(id) {
+        await this.req("DELETE", `/v1/memories/${id}`);
+    }
+}
+//# sourceMappingURL=memories.js.map

package/dist/resources/memories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.js","sourceRoot":"","sources":["../../src/resources/memories.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,OAAqB;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAS,MAAM,EAAE,cAAc,EAAE;YAC9C,IAAI,EAAE;gBACJ,OAAO;gBACP,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;gBAC3B,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE;gBACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE;gBACjC,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE;gBACzB,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;gBAChC,WAAW,EAAE,OAAO,EAAE,UAAU;gBAChC,YAAY,EAAE,OAAO,EAAE,WAAW,IAAI,UAAU;gBAChD,eAAe,EAAE,OAAO,EAAE,cAAc;aACzC;YACD,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QACjD,OAAO,IAAI,CAAC,GAAG,CAAe,MAAM,EAAE,YAAY,EAAE;YAClD,IAAI,EAAE;gBACJ,KAAK;gBACL,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;gBAC1B,QAAQ,EAAE,OAAO,EAAE,QAAQ;gBAC3B,IAAI,EAAE,OAAO,EAAE,IAAI;gBACnB,gBAAgB,EAAE,OAAO,EAAE,eAAe;gBAC1C,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;gBAChC,WAAW,EAAE,OAAO,EAAE,UAAU;gBAChC,eAAe,EAAE,OAAO,EAAE,cAAc;aACzC;YACD,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,OAAoB;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAY,MAAM,EAAE,SAAS,EAAE;YAC5C,IAAI,EAAE;gBACJ,KAAK;gBACL,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;gBAC3B,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM;gBAC/B,MAAM,EAAE,OAAO,EAAE,MAAM;aACxB;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA6B;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CACxB,KAAK,EACL,cAAc,EACd;YACE,KAAK,EAAE;gBACL,KAAK,EAAE,OAAO,EAAE,KAAK;gBACrB,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,IAAI,EAAE,OAAO,EAAE,IAAI;aACpB;YACD,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CACF,CAAC;QAEF,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,QAAQ,EAAE,GAAG;gBACb,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,KAAK;gBACf,KAAK,EAAE,GAAG,CAAC,MAAM;aAClB,CAAC;QACJ,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,GAAG,CAAS,KAAK,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,GAAG,CAAO,QAAQ,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/resources/settings.d.ts

@@ -0,0 +1,8 @@
+import type { Settings } from "../types.js";
+import type { RequestFn } from "../transport.js";
+export declare class SettingsResource {
+    private readonly req;
+    constructor(req: RequestFn);
+    get(): Promise<Settings>;
+}
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/resources/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;CAG/B"}

package/dist/resources/settings.js

@@ -0,0 +1,10 @@
+export class SettingsResource {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    async get() {
+        return this.req("GET", "/v1/settings");
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/resources/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/resources/settings.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,GAAG;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/resources/topics.d.ts

@@ -0,0 +1,19 @@
+import type { Topic, TopicCreateParams, TopicListResponse, TopicMemoriesResponse, TopicReorderOperation, TopicUpdateParams } from "../types.js";
+import type { RequestFn } from "../transport.js";
+export declare class TopicsResource {
+    private readonly req;
+    constructor(req: RequestFn);
+    list(hubId?: string): Promise<TopicListResponse>;
+    get(id: string): Promise<Topic>;
+    create(params: TopicCreateParams): Promise<Topic>;
+    update(id: string, params: TopicUpdateParams): Promise<Topic>;
+    delete(id: string): Promise<void>;
+    listMemories(topicId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<TopicMemoriesResponse>;
+    addMemory(topicId: string, memoryId: string, confidence?: number): Promise<void>;
+    removeMemory(topicId: string, memoryId: string): Promise<void>;
+    reorder(operations: TopicReorderOperation[]): Promise<void>;
+}
+//# sourceMappingURL=topics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../src/resources/topics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EAClB,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;IAErC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMhD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI/B,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIjD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAI7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,qBAAqB,CAAC;IAa3B,SAAS,CACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAMV,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,OAAO,CAAC,UAAU,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlE"}

package/dist/resources/topics.js

@@ -0,0 +1,45 @@
+export class TopicsResource {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    async list(hubId) {
+        return this.req("GET", "/v1/topics", {
+            query: { hub_id: hubId },
+        });
+    }
+    async get(id) {
+        return this.req("GET", `/v1/topics/${id}`);
+    }
+    async create(params) {
+        return this.req("POST", "/v1/topics", { body: params });
+    }
+    async update(id, params) {
+        return this.req("PATCH", `/v1/topics/${id}`, { body: params });
+    }
+    async delete(id) {
+        await this.req("DELETE", `/v1/topics/${id}`);
+    }
+    async listMemories(topicId, options) {
+        return this.req("GET", `/v1/topics/${topicId}/memories`, {
+            query: {
+                limit: options?.limit,
+                cursor: options?.cursor,
+            },
+        });
+    }
+    async addMemory(topicId, memoryId, confidence) {
+        await this.req("POST", `/v1/topics/${topicId}/memories`, {
+            body: { memory_id: memoryId, ...(confidence != null && { confidence }) },
+        });
+    }
+    async removeMemory(topicId, memoryId) {
+        await this.req("DELETE", `/v1/topics/${topicId}/memories/${memoryId}`);
+    }
+    async reorder(operations) {
+        await this.req("POST", "/v1/topics/reorder", {
+            body: { operations },
+        });
+    }
+}
+//# sourceMappingURL=topics.js.map

package/dist/resources/topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../src/resources/topics.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,IAAI,CAAC,KAAc;QACvB,OAAO,IAAI,CAAC,GAAG,CAAoB,KAAK,EAAE,YAAY,EAAE;YACtD,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;SACzB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,GAAG,CAAQ,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAyB;QACpC,OAAO,IAAI,CAAC,GAAG,CAAQ,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAAyB;QAChD,OAAO,IAAI,CAAC,GAAG,CAAQ,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,GAAG,CAAO,QAAQ,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,OAA6C;QAE7C,OAAO,IAAI,CAAC,GAAG,CACb,KAAK,EACL,cAAc,OAAO,WAAW,EAChC;YACE,KAAK,EAAE;gBACL,KAAK,EAAE,OAAO,EAAE,KAAK;gBACrB,MAAM,EAAE,OAAO,EAAE,MAAM;aACxB;SACF,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAAe,EACf,QAAgB,EAChB,UAAmB;QAEnB,MAAM,IAAI,CAAC,GAAG,CAAO,MAAM,EAAE,cAAc,OAAO,WAAW,EAAE;YAC7D,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE;SACzE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,QAAgB;QAClD,MAAM,IAAI,CAAC,GAAG,CACZ,QAAQ,EACR,cAAc,OAAO,aAAa,QAAQ,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAmC;QAC/C,MAAM,IAAI,CAAC,GAAG,CAAO,MAAM,EAAE,oBAAoB,EAAE;YACjD,IAAI,EAAE,EAAE,UAAU,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/transport.d.ts

@@ -0,0 +1,18 @@
+import type { MemaxConfig } from "./types.js";
+export interface RequestOptions {
+    body?: unknown;
+    hubId?: string;
+    query?: Record<string, string | number | boolean | null | undefined>;
+}
+export type RequestFn = <T>(method: string, path: string, options?: RequestOptions) => Promise<T>;
+export declare class ApiTransport {
+    private readonly apiUrl;
+    private readonly getAuth;
+    private readonly fetchImpl;
+    private readonly headers;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    constructor(config: MemaxConfig);
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACtE;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,CAAC,CAAC,CAAC;AA4ChB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,EAAE,WAAW;IASzB,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;CA6Ed"}

package/dist/transport.js

@@ -0,0 +1,107 @@
+import { MemaxError } from "./errors.js";
+const DEFAULT_API_URL = "https://api.memax.app";
+const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_RETRY_DELAY_MS = 1500;
+function resolveFetch(config) {
+    if (config.fetch) {
+        return config.fetch;
+    }
+    if (typeof globalThis.fetch !== "function") {
+        throw new Error("Fetch is not available in this runtime. Pass `fetch` in MemaxConfig.");
+    }
+    return globalThis.fetch.bind(globalThis);
+}
+function createAuthProvider(config) {
+    if (config.auth) {
+        return config.auth;
+    }
+    if (config.apiKey) {
+        const key = config.apiKey;
+        return async () => ({ Authorization: `Bearer ${key}` });
+    }
+    return async () => ({});
+}
+function buildQueryString(query) {
+    if (!query) {
+        return "";
+    }
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value == null) {
+            continue;
+        }
+        params.set(key, String(value));
+    }
+    const encoded = params.toString();
+    return encoded ? `?${encoded}` : "";
+}
+export class ApiTransport {
+    apiUrl;
+    getAuth;
+    fetchImpl;
+    headers;
+    maxRetries;
+    retryDelayMs;
+    constructor(config) {
+        this.apiUrl = (config.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
+        this.getAuth = createAuthProvider(config);
+        this.fetchImpl = resolveFetch(config);
+        this.headers = config.headers ?? {};
+        this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.retryDelayMs = config.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+    }
+    async request(method, path, options) {
+        const url = `${this.apiUrl}${path}${buildQueryString(options?.query)}`;
+        let lastErr;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            const authHeaders = await this.getAuth();
+            const headers = {
+                "Content-Type": "application/json",
+                ...this.headers,
+                ...authHeaders,
+            };
+            if (options?.hubId) {
+                headers["X-Hub-ID"] = options.hubId;
+            }
+            let res;
+            try {
+                res = await this.fetchImpl(url, {
+                    method,
+                    headers,
+                    body: options?.body !== undefined
+                        ? JSON.stringify(options.body)
+                        : undefined,
+                });
+            }
+            catch {
+                throw new MemaxError(`Cannot reach API at ${url} — is the server running?`, "network_error", 0);
+            }
+            const text = await res.text();
+            if (!text && res.ok) {
+                return undefined;
+            }
+            let json;
+            try {
+                json = JSON.parse(text);
+            }
+            catch {
+                if (res.status === 401) {
+                    throw new MemaxError("Not authenticated — run `memax login` first", "unauthorized", 401);
+                }
+                throw new MemaxError(`API returned ${res.status} with non-JSON response`, "invalid_response", res.status);
+            }
+            if (json.error) {
+                const err = new MemaxError(json.error.message, json.error.code, res.status);
+                if (json.error.code === "not_ready" && attempt < this.maxRetries) {
+                    lastErr = err;
+                    await new Promise((resolve) => setTimeout(resolve, this.retryDelayMs));
+                    continue;
+                }
+                throw err;
+            }
+            return json.data;
+        }
+        throw lastErr;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.test.d.ts.map

package/dist/transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.d.ts","sourceRoot":"","sources":["../src/transport.test.ts"],"names":[],"mappings":""}

package/dist/transport.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it, vi } from "vitest";
+import { ApiTransport } from "./transport.js";
+function jsonResponse(body, init) {
+    return new Response(JSON.stringify(body), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+        ...init,
+    });
+}
+describe("ApiTransport", () => {
+    it("uses apiKey auth and merges query params", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse({ data: { ok: true } }));
+        const transport = new ApiTransport({
+            apiUrl: "https://api.memax.app/",
+            apiKey: "test-key",
+            fetch: fetchMock,
+            headers: { "X-Test": "1" },
+        });
+        await transport.request("GET", "/v1/test", {
+            query: { a: 1, b: "two", skip: undefined },
+            hubId: "hub-1",
+        });
+        expect(fetchMock).toHaveBeenCalledWith("https://api.memax.app/v1/test?a=1&b=two", expect.objectContaining({
+            method: "GET",
+            headers: expect.objectContaining({
+                Authorization: "Bearer test-key",
+                "X-Hub-ID": "hub-1",
+                "X-Test": "1",
+                "Content-Type": "application/json",
+            }),
+        }));
+    });
+    it("returns undefined for empty successful responses", async () => {
+        const fetchMock = vi.fn(async () => new Response(null, { status: 204 }));
+        const transport = new ApiTransport({ fetch: fetchMock });
+        await expect(transport.request("DELETE", "/v1/test")).resolves.toBeUndefined();
+    });
+    it("retries not_ready responses", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(jsonResponse({ error: { code: "not_ready", message: "warming up" } }, { status: 503 }))
+            .mockResolvedValueOnce(jsonResponse({ data: { ok: true } }));
+        const transport = new ApiTransport({
+            fetch: fetchMock,
+            maxRetries: 1,
+            retryDelayMs: 0,
+        });
+        await expect(transport.request("GET", "/v1/test")).resolves.toEqual({ ok: true });
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+    });
+    it("maps unauthorized non-json responses", async () => {
+        const fetchMock = vi.fn(async () => new Response("unauthorized", { status: 401 }));
+        const transport = new ApiTransport({ fetch: fetchMock });
+        await expect(transport.request("GET", "/v1/test")).rejects.toMatchObject({
+            code: "unauthorized",
+            status: 401,
+        });
+    });
+    it("throws network_error when fetch fails", async () => {
+        const fetchMock = vi.fn(async () => {
+            throw new Error("boom");
+        });
+        const transport = new ApiTransport({ fetch: fetchMock });
+        await expect(transport.request("GET", "/v1/test")).rejects.toMatchObject({
+            code: "network_error",
+            status: 0,
+        });
+    });
+});
+//# sourceMappingURL=transport.test.js.map

package/dist/transport.test.js.map

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

package/dist/types.d.ts

@@ -10,9 +10,19 @@ export interface MemaxConfig {
     apiKey?: string;
     /** Dynamic auth provider — for CLI/custom integrations that manage tokens */
     auth?: AuthProvider;
+    /** Custom fetch implementation for Node, tests, SSR, or edge runtimes */
+    fetch?: typeof globalThis.fetch;
+    /** Default headers applied to every request before auth headers */
+    headers?: Record<string, string>;
+    /** Number of retries for retryable API responses like `not_ready` */
+    maxRetries?: number;
+    /** Delay between retry attempts in milliseconds */
+    retryDelayMs?: number;
 }
 export interface PushOptions {
     title?: string;
+    /** Context hint to help AI process this memory (e.g. "This is my resume"). Improves categorization, summarization, and retrieval. */
+    hint?: string;
     category?: string;
     tags?: string[];
     source?: string;
@@ -48,6 +58,7 @@ export interface Memory {
     content: string;
     content_type: string;
     summary: string;
+    hint?: string;
     category: string;
     tags: string[];
     boundary: string;
@@ -57,6 +68,7 @@ export interface Memory {
     version: number;
     access_count: number;
     project_context?: Record<string, string>;
+    topic_ids?: string[];
     created_at: string;
     updated_at: string;
 }
@@ -64,6 +76,7 @@ export interface RecalledMemory {
     id: string;
     title: string;
     summary?: string;
+    hint?: string;
     chunk_content: string;
     heading_chain: string;
     relevance_score: number;
@@ -72,6 +85,8 @@ export interface RecalledMemory {
     age: string;
     hub_id?: string;
     hub_name?: string;
+    topic_ids?: string[];
+    topic_names?: string[];
 }
 export interface RecallResult {
     memories: RecalledMemory[];
@@ -117,7 +132,7 @@ export interface AgentConfig {
     created_at: string;
     updated_at: string;
 }
-export type SyncAction = "unchanged" | "push" | "pull" | "conflict";
+export type SyncAction = "unchanged" | "push" | "pull" | "conflict" | "delete_local";
 export interface SyncPlanAction {
     action: SyncAction;
     agent: string;
@@ -127,6 +142,7 @@ export interface SyncPlanAction {
     config_id?: string;
     cloud_hash?: string;
     cloud_updated_at?: string;
+    version?: number;
 }
 export interface SyncManifestEntry {
     agent: string;
@@ -134,12 +150,39 @@ export interface SyncManifestEntry {
     scope: string;
     content_hash: string;
     updated_at: string;
+    local_path?: string;
+}
+export interface ConfigSyncRequest {
+    device_id: string;
+    configs: SyncManifestEntry[];
+}
+export interface AgentConfigSyncAck {
+    agent: string;
+    file_path: string;
+    scope: string;
+    content_hash?: string;
+    version: number;
+    local_path?: string;
+    deleted?: boolean;
+}
+export interface ConfigSyncAckRequest {
+    device_id: string;
+    configs: AgentConfigSyncAck[];
+}
+export interface ConfigLocalDeleteRequest {
+    device_id: string;
+    agent: string;
+    file_path: string;
+    scope: string;
+    local_path?: string;
 }
 export interface ConfigUpsertRequest {
     agent: string;
     file_path: string;
     scope: string;
     content: string;
+    device_id?: string;
+    local_path?: string;
 }
 export interface ConfigMergeRequest {
     local_content: string;
@@ -217,8 +260,51 @@ export interface Settings {
     active_hub_id?: string;
     [key: string]: unknown;
 }
-/** @deprecated Use Memory instead */
-export type Note = Memory;
-/** @deprecated Use RecalledMemory instead */
-export type RecalledNote = RecalledMemory;
+export interface Topic {
+    id: string;
+    owner_id: string;
+    hub_id?: string;
+    parent_id: string | null;
+    name: string;
+    description?: string;
+    icon: string;
+    position: number;
+    pinned: boolean;
+    user_modified: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface TopicTree extends Topic {
+    memory_count: number;
+    children: TopicTree[];
+}
+export interface TopicListResponse {
+    topics: TopicTree[];
+    unassigned_count: number;
+}
+export interface TopicCreateParams {
+    name: string;
+    description?: string;
+    icon?: string;
+    parent_id?: string;
+    hub_id?: string;
+}
+export interface TopicUpdateParams {
+    name?: string;
+    description?: string;
+    icon?: string;
+    position?: number;
+    parent_id?: string | null;
+    pinned?: boolean;
+}
+export interface TopicReorderOperation {
+    topic_id: string;
+    position: number;
+    parent_id?: string | null;
+}
+export interface TopicMemoriesResponse {
+    memories: Memory[];
+    next_cursor: string;
+    has_more: boolean;
+}
 //# sourceMappingURL=types.d.ts.map