memory-sdk 1.0.1

package/README.md

@@ -0,0 +1,81 @@
+# memory-sdk
+
+AgentLink Memory API 客户端：使用 API Key 对 `/api/memory/v1/memories` 进行 CRUD 与列表/搜索，适用于 Node 与浏览器。
+
+## 获取 API Key
+
+在 [Memory 设置页](https://www.mixlab.top/memory/settings) 的「API Key」区域创建 Key，格式为 `al_` 开头。请求时需在请求头中携带：`Authorization: Bearer <key>` 或 `X-Api-Key: <key>`，本 SDK 使用 Bearer 方式。
+
+## 安装
+
+```bash
+npm install memory-sdk
+```
+
+## 使用
+
+### 连接官方站（默认）
+
+不传 `baseUrl` 时，默认请求 `https://www.mixlab.top/api`。
+
+```ts
+import { MemoryClient } from 'memory-sdk';
+
+const client = new MemoryClient({ apiKey: 'al_xxx' });
+
+// 列表
+const list = await client.list();
+const filtered = await client.list({ category: '笔记', limit: 20, offset: 0 });
+
+// 搜索
+const results = await client.search('关键词', 50);
+
+// 单条
+const one = await client.get('memory-id'); // 404 时为 null
+
+// 创建
+const created = await client.create({
+  source: 'https://example.com',
+  category: '阅读',
+  content: '内容摘要',
+  tags: ['tag1'],
+});
+
+// 更新
+const updated = await client.update(created.id, { content: '更新后的内容' });
+
+// 删除
+await client.delete(created.id);
+```
+
+### 自建或同源
+
+传入 `baseUrl` 即可：
+
+- 自建服务：`baseUrl: 'https://your-domain.com/api'`
+- 浏览器同源：`baseUrl: window.location.origin + '/api'`
+
+```ts
+const client = new MemoryClient({
+  apiKey: 'al_xxx',
+  baseUrl: 'https://your-domain.com/api',
+});
+```
+
+### 类型
+
+```ts
+import type { Memory, CreatePayload, UpdatePayload, ListParams } from 'memory-sdk';
+import { DEFAULT_BASE_URL } from 'memory-sdk';
+```
+
+## API
+
+- `list(params?: ListParams): Promise<Memory[]>` — 列表，支持 `category`、`source`、`tag`、`limit`、`offset`
+- `search(q: string, limit?: number): Promise<Memory[]>` — 关键词搜索
+- `get(id: string): Promise<Memory | null>` — 按 id 获取，404 返回 `null`
+- `create(payload: CreatePayload): Promise<Memory>` — 创建（`source`、`category`、`content` 必填）
+- `update(id: string, payload: UpdatePayload): Promise<Memory>` — 更新
+- `delete(id: string): Promise<void>` — 删除
+
+非 2xx 响应会解析 `{ error?: string }` 并抛出 `Error`。

package/dist/index.d.mts

@@ -0,0 +1,74 @@
+/**
+ * Memory 数据类型定义（与后端 API 返回对齐）
+ */
+interface Memory {
+    id: string;
+    source: string;
+    category: string;
+    content: string;
+    tags: string[];
+    images?: string[];
+    createdAt: number;
+    updatedAt: number;
+    metadata?: unknown;
+    rawData?: unknown;
+}
+/** 创建 Memory 的请求体：source、category、content 必填 */
+interface CreatePayload {
+    source: string;
+    category: string;
+    content: string;
+    tags?: string[];
+    images?: string[];
+    metadata?: unknown;
+    rawData?: unknown;
+}
+/** 更新 Memory 的请求体：全部可选 */
+interface UpdatePayload {
+    source?: string;
+    category?: string;
+    content?: string;
+    tags?: string[];
+    images?: string[];
+    metadata?: unknown;
+    rawData?: unknown;
+}
+/** 列表/筛选参数（对应 GET 的 searchParams） */
+interface ListParams {
+    category?: string;
+    source?: string;
+    tag?: string;
+    limit?: number;
+    offset?: number;
+}
+
+/** 默认 API 基础地址（含 /api 前缀） */
+declare const DEFAULT_BASE_URL = "https://www.mixlab.top/api";
+interface MemoryClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+/**
+ * Memory API 客户端：使用 API Key 调用 /api/memory/v1/memories 的 CRUD 与列表/搜索。
+ */
+declare class MemoryClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: MemoryClientOptions);
+    private url;
+    private headers;
+    /** 列表，支持 category / source / tag / limit / offset */
+    list(params?: ListParams): Promise<Memory[]>;
+    /** 关键词搜索 */
+    search(q: string, limit?: number): Promise<Memory[]>;
+    /** 按 id 获取单条，404 返回 null */
+    get(id: string): Promise<Memory | null>;
+    /** 创建 */
+    create(payload: CreatePayload): Promise<Memory>;
+    /** 更新 */
+    update(id: string, payload: UpdatePayload): Promise<Memory>;
+    /** 删除 */
+    delete(id: string): Promise<void>;
+}
+
+export { type CreatePayload, DEFAULT_BASE_URL, type ListParams, type Memory, MemoryClient, type MemoryClientOptions, type UpdatePayload };

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Memory 数据类型定义（与后端 API 返回对齐）
+ */
+interface Memory {
+    id: string;
+    source: string;
+    category: string;
+    content: string;
+    tags: string[];
+    images?: string[];
+    createdAt: number;
+    updatedAt: number;
+    metadata?: unknown;
+    rawData?: unknown;
+}
+/** 创建 Memory 的请求体：source、category、content 必填 */
+interface CreatePayload {
+    source: string;
+    category: string;
+    content: string;
+    tags?: string[];
+    images?: string[];
+    metadata?: unknown;
+    rawData?: unknown;
+}
+/** 更新 Memory 的请求体：全部可选 */
+interface UpdatePayload {
+    source?: string;
+    category?: string;
+    content?: string;
+    tags?: string[];
+    images?: string[];
+    metadata?: unknown;
+    rawData?: unknown;
+}
+/** 列表/筛选参数（对应 GET 的 searchParams） */
+interface ListParams {
+    category?: string;
+    source?: string;
+    tag?: string;
+    limit?: number;
+    offset?: number;
+}
+
+/** 默认 API 基础地址（含 /api 前缀） */
+declare const DEFAULT_BASE_URL = "https://www.mixlab.top/api";
+interface MemoryClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+/**
+ * Memory API 客户端：使用 API Key 调用 /api/memory/v1/memories 的 CRUD 与列表/搜索。
+ */
+declare class MemoryClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: MemoryClientOptions);
+    private url;
+    private headers;
+    /** 列表，支持 category / source / tag / limit / offset */
+    list(params?: ListParams): Promise<Memory[]>;
+    /** 关键词搜索 */
+    search(q: string, limit?: number): Promise<Memory[]>;
+    /** 按 id 获取单条，404 返回 null */
+    get(id: string): Promise<Memory | null>;
+    /** 创建 */
+    create(payload: CreatePayload): Promise<Memory>;
+    /** 更新 */
+    update(id: string, payload: UpdatePayload): Promise<Memory>;
+    /** 删除 */
+    delete(id: string): Promise<void>;
+}
+
+export { type CreatePayload, DEFAULT_BASE_URL, type ListParams, type Memory, MemoryClient, type MemoryClientOptions, type UpdatePayload };

package/dist/index.js

@@ -0,0 +1,139 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  MemoryClient: () => MemoryClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://www.mixlab.top/api";
+var MEMORIES_PATH = "/memory/v1/memories";
+function toMemory(record) {
+  const tags = Array.isArray(record.tags) ? record.tags : [];
+  return {
+    id: record.id,
+    source: record.source,
+    category: record.category,
+    content: record.content,
+    tags,
+    images: record.images?.length ? record.images : void 0,
+    createdAt: record.createdAt,
+    updatedAt: record.updatedAt,
+    metadata: record.metadata,
+    rawData: record.rawData
+  };
+}
+async function handleResponse(res, parse) {
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const err = data && typeof data === "object" && "error" in data ? String(data.error) : `HTTP ${res.status}`;
+    throw new Error(err);
+  }
+  return parse(data);
+}
+var MemoryClient = class {
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  url(path, searchParams) {
+    const u = `${this.baseUrl}${path}`;
+    if (!searchParams || Object.keys(searchParams).length === 0) return u;
+    const sp = new URLSearchParams(searchParams);
+    return `${u}?${sp.toString()}`;
+  }
+  headers(init) {
+    return {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.apiKey}`,
+      ...init
+    };
+  }
+  /** 列表，支持 category / source / tag / limit / offset */
+  async list(params) {
+    const searchParams = {};
+    if (params?.category) searchParams.category = params.category;
+    if (params?.source) searchParams.source = params.source;
+    if (params?.tag) searchParams.tag = params.tag;
+    if (params?.limit != null) searchParams.limit = String(params.limit);
+    if (params?.offset != null) searchParams.offset = String(params.offset);
+    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });
+    const list = await handleResponse(res, (data) => Array.isArray(data) ? data : []);
+    return list.map(toMemory);
+  }
+  /** 关键词搜索 */
+  async search(q, limit) {
+    const searchParams = { q };
+    if (limit != null) searchParams.limit = String(limit);
+    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });
+    const list = await handleResponse(res, (data) => Array.isArray(data) ? data : []);
+    return list.map(toMemory);
+  }
+  /** 按 id 获取单条，404 返回 null */
+  async get(id) {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      headers: this.headers()
+    });
+    if (res.status === 404) return null;
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record);
+  }
+  /** 创建 */
+  async create(payload) {
+    const res = await fetch(this.url(MEMORIES_PATH), {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(payload)
+    });
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record);
+  }
+  /** 更新 */
+  async update(id, payload) {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      method: "PATCH",
+      headers: this.headers(),
+      body: JSON.stringify(payload)
+    });
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record);
+  }
+  /** 删除 */
+  async delete(id) {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      method: "DELETE",
+      headers: this.headers()
+    });
+    if (!res.ok) {
+      const data = await res.json().catch(() => ({}));
+      const err = data && typeof data === "object" && "error" in data ? String(data.error) : `HTTP ${res.status}`;
+      throw new Error(err);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_BASE_URL,
+  MemoryClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export { MemoryClient, DEFAULT_BASE_URL, type MemoryClientOptions } from './client';\nexport type { Memory, CreatePayload, UpdatePayload, ListParams } from './types';\n","import type { CreatePayload, ListParams, Memory, UpdatePayload } from './types';\n\n/** 默认 API 基础地址（含 /api 前缀） */\nexport const DEFAULT_BASE_URL = 'https://www.mixlab.top/api';\n\nconst MEMORIES_PATH = '/memory/v1/memories';\n\nfunction toMemory(record: {\n  id: string;\n  source: string;\n  category: string;\n  content: string;\n  tags: string[] | unknown;\n  images?: string[];\n  createdAt: number;\n  updatedAt: number;\n  metadata?: unknown;\n  rawData?: unknown;\n}): Memory {\n  const tags = Array.isArray(record.tags) ? record.tags : [];\n  return {\n    id: record.id,\n    source: record.source,\n    category: record.category,\n    content: record.content,\n    tags,\n    images: record.images?.length ? record.images : undefined,\n    createdAt: record.createdAt,\n    updatedAt: record.updatedAt,\n    metadata: record.metadata,\n    rawData: record.rawData,\n  };\n}\n\nasync function handleResponse<T>(res: Response, parse: (data: unknown) => T): Promise<T> {\n  const data = await res.json().catch(() => ({}));\n  if (!res.ok) {\n    const err = data && typeof data === 'object' && 'error' in data ? String(data.error) : `HTTP ${res.status}`;\n    throw new Error(err);\n  }\n  return parse(data);\n}\n\nexport interface MemoryClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n}\n\n/**\n * Memory API 客户端：使用 API Key 调用 /api/memory/v1/memories 的 CRUD 与列表/搜索。\n */\nexport class MemoryClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(options: MemoryClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  }\n\n  private url(path: string, searchParams?: Record<string, string>): string {\n    const u = `${this.baseUrl}${path}`;\n    if (!searchParams || Object.keys(searchParams).length === 0) return u;\n    const sp = new URLSearchParams(searchParams);\n    return `${u}?${sp.toString()}`;\n  }\n\n  private headers(init?: Record<string, string>): Record<string, string> {\n    return {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${this.apiKey}`,\n      ...init,\n    };\n  }\n\n  /** 列表，支持 category / source / tag / limit / offset */\n  async list(params?: ListParams): Promise<Memory[]> {\n    const searchParams: Record<string, string> = {};\n    if (params?.category) searchParams.category = params.category;\n    if (params?.source) searchParams.source = params.source;\n    if (params?.tag) searchParams.tag = params.tag;\n    if (params?.limit != null) searchParams.limit = String(params.limit);\n    if (params?.offset != null) searchParams.offset = String(params.offset);\n\n    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });\n    const list = await handleResponse(res, (data) => (Array.isArray(data) ? data : []));\n    return list.map(toMemory);\n  }\n\n  /** 关键词搜索 */\n  async search(q: string, limit?: number): Promise<Memory[]> {\n    const searchParams: Record<string, string> = { q };\n    if (limit != null) searchParams.limit = String(limit);\n    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });\n    const list = await handleResponse(res, (data) => (Array.isArray(data) ? data : []));\n    return list.map(toMemory);\n  }\n\n  /** 按 id 获取单条，404 返回 null */\n  async get(id: string): Promise<Memory | null> {\n    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {\n      headers: this.headers(),\n    });\n    if (res.status === 404) return null;\n    const record = await handleResponse(res, (x) => x);\n    return toMemory(record as Parameters<typeof toMemory>[0]);\n  }\n\n  /** 创建 */\n  async create(payload: CreatePayload): Promise<Memory> {\n    const res = await fetch(this.url(MEMORIES_PATH), {\n      method: 'POST',\n      headers: this.headers(),\n      body: JSON.stringify(payload),\n    });\n    const record = await handleResponse(res, (x) => x);\n    return toMemory(record as Parameters<typeof toMemory>[0]);\n  }\n\n  /** 更新 */\n  async update(id: string, payload: UpdatePayload): Promise<Memory> {\n    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {\n      method: 'PATCH',\n      headers: this.headers(),\n      body: JSON.stringify(payload),\n    });\n    const record = await handleResponse(res, (x) => x);\n    return toMemory(record as Parameters<typeof toMemory>[0]);\n  }\n\n  /** 删除 */\n  async delete(id: string): Promise<void> {\n    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {\n      method: 'DELETE',\n      headers: this.headers(),\n    });\n    if (!res.ok) {\n      const data = await res.json().catch(() => ({}));\n      const err = data && typeof data === 'object' && 'error' in data ? String(data.error) : `HTTP ${res.status}`;\n      throw new Error(err);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,111 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://www.mixlab.top/api";
+var MEMORIES_PATH = "/memory/v1/memories";
+function toMemory(record) {
+  const tags = Array.isArray(record.tags) ? record.tags : [];
+  return {
+    id: record.id,
+    source: record.source,
+    category: record.category,
+    content: record.content,
+    tags,
+    images: record.images?.length ? record.images : void 0,
+    createdAt: record.createdAt,
+    updatedAt: record.updatedAt,
+    metadata: record.metadata,
+    rawData: record.rawData
+  };
+}
+async function handleResponse(res, parse) {
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const err = data && typeof data === "object" && "error" in data ? String(data.error) : `HTTP ${res.status}`;
+    throw new Error(err);
+  }
+  return parse(data);
+}
+var MemoryClient = class {
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  url(path, searchParams) {
+    const u = `${this.baseUrl}${path}`;
+    if (!searchParams || Object.keys(searchParams).length === 0) return u;
+    const sp = new URLSearchParams(searchParams);
+    return `${u}?${sp.toString()}`;
+  }
+  headers(init) {
+    return {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.apiKey}`,
+      ...init
+    };
+  }
+  /** 列表，支持 category / source / tag / limit / offset */
+  async list(params) {
+    const searchParams = {};
+    if (params?.category) searchParams.category = params.category;
+    if (params?.source) searchParams.source = params.source;
+    if (params?.tag) searchParams.tag = params.tag;
+    if (params?.limit != null) searchParams.limit = String(params.limit);
+    if (params?.offset != null) searchParams.offset = String(params.offset);
+    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });
+    const list = await handleResponse(res, (data) => Array.isArray(data) ? data : []);
+    return list.map(toMemory);
+  }
+  /** 关键词搜索 */
+  async search(q, limit) {
+    const searchParams = { q };
+    if (limit != null) searchParams.limit = String(limit);
+    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });
+    const list = await handleResponse(res, (data) => Array.isArray(data) ? data : []);
+    return list.map(toMemory);
+  }
+  /** 按 id 获取单条，404 返回 null */
+  async get(id) {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      headers: this.headers()
+    });
+    if (res.status === 404) return null;
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record);
+  }
+  /** 创建 */
+  async create(payload) {
+    const res = await fetch(this.url(MEMORIES_PATH), {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(payload)
+    });
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record);
+  }
+  /** 更新 */
+  async update(id, payload) {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      method: "PATCH",
+      headers: this.headers(),
+      body: JSON.stringify(payload)
+    });
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record);
+  }
+  /** 删除 */
+  async delete(id) {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      method: "DELETE",
+      headers: this.headers()
+    });
+    if (!res.ok) {
+      const data = await res.json().catch(() => ({}));
+      const err = data && typeof data === "object" && "error" in data ? String(data.error) : `HTTP ${res.status}`;
+      throw new Error(err);
+    }
+  }
+};
+export {
+  DEFAULT_BASE_URL,
+  MemoryClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type { CreatePayload, ListParams, Memory, UpdatePayload } from './types';\n\n/** 默认 API 基础地址（含 /api 前缀） */\nexport const DEFAULT_BASE_URL = 'https://www.mixlab.top/api';\n\nconst MEMORIES_PATH = '/memory/v1/memories';\n\nfunction toMemory(record: {\n  id: string;\n  source: string;\n  category: string;\n  content: string;\n  tags: string[] | unknown;\n  images?: string[];\n  createdAt: number;\n  updatedAt: number;\n  metadata?: unknown;\n  rawData?: unknown;\n}): Memory {\n  const tags = Array.isArray(record.tags) ? record.tags : [];\n  return {\n    id: record.id,\n    source: record.source,\n    category: record.category,\n    content: record.content,\n    tags,\n    images: record.images?.length ? record.images : undefined,\n    createdAt: record.createdAt,\n    updatedAt: record.updatedAt,\n    metadata: record.metadata,\n    rawData: record.rawData,\n  };\n}\n\nasync function handleResponse<T>(res: Response, parse: (data: unknown) => T): Promise<T> {\n  const data = await res.json().catch(() => ({}));\n  if (!res.ok) {\n    const err = data && typeof data === 'object' && 'error' in data ? String(data.error) : `HTTP ${res.status}`;\n    throw new Error(err);\n  }\n  return parse(data);\n}\n\nexport interface MemoryClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n}\n\n/**\n * Memory API 客户端：使用 API Key 调用 /api/memory/v1/memories 的 CRUD 与列表/搜索。\n */\nexport class MemoryClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(options: MemoryClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  }\n\n  private url(path: string, searchParams?: Record<string, string>): string {\n    const u = `${this.baseUrl}${path}`;\n    if (!searchParams || Object.keys(searchParams).length === 0) return u;\n    const sp = new URLSearchParams(searchParams);\n    return `${u}?${sp.toString()}`;\n  }\n\n  private headers(init?: Record<string, string>): Record<string, string> {\n    return {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${this.apiKey}`,\n      ...init,\n    };\n  }\n\n  /** 列表，支持 category / source / tag / limit / offset */\n  async list(params?: ListParams): Promise<Memory[]> {\n    const searchParams: Record<string, string> = {};\n    if (params?.category) searchParams.category = params.category;\n    if (params?.source) searchParams.source = params.source;\n    if (params?.tag) searchParams.tag = params.tag;\n    if (params?.limit != null) searchParams.limit = String(params.limit);\n    if (params?.offset != null) searchParams.offset = String(params.offset);\n\n    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });\n    const list = await handleResponse(res, (data) => (Array.isArray(data) ? data : []));\n    return list.map(toMemory);\n  }\n\n  /** 关键词搜索 */\n  async search(q: string, limit?: number): Promise<Memory[]> {\n    const searchParams: Record<string, string> = { q };\n    if (limit != null) searchParams.limit = String(limit);\n    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });\n    const list = await handleResponse(res, (data) => (Array.isArray(data) ? data : []));\n    return list.map(toMemory);\n  }\n\n  /** 按 id 获取单条，404 返回 null */\n  async get(id: string): Promise<Memory | null> {\n    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {\n      headers: this.headers(),\n    });\n    if (res.status === 404) return null;\n    const record = await handleResponse(res, (x) => x);\n    return toMemory(record as Parameters<typeof toMemory>[0]);\n  }\n\n  /** 创建 */\n  async create(payload: CreatePayload): Promise<Memory> {\n    const res = await fetch(this.url(MEMORIES_PATH), {\n      method: 'POST',\n      headers: this.headers(),\n      body: JSON.stringify(payload),\n    });\n    const record = await handleResponse(res, (x) => x);\n    return toMemory(record as Parameters<typeof toMemory>[0]);\n  }\n\n  /** 更新 */\n  async update(id: string, payload: UpdatePayload): Promise<Memory> {\n    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {\n      method: 'PATCH',\n      headers: this.headers(),\n      body: JSON.stringify(payload),\n    });\n    const record = await handleResponse(res, (x) => x);\n    return toMemory(record as Parameters<typeof toMemory>[0]);\n  }\n\n  /** 删除 */\n  async delete(id: string): Promise<void> {\n    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {\n      method: 'DELETE',\n      headers: this.headers(),\n    });\n    if (!res.ok) {\n      const data = await res.json().catch(() => ({}));\n      const err = data && typeof data === 'object' && 'error' in data ? String(data.error) : `HTTP ${res.status}`;\n      throw new Error(err);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "memory-sdk",
+  "version": "1.0.1",
+  "description": "AgentLink Memory API client - CRUD and search with API Key",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist"
+  },
+  "keywords": ["agentlink", "memory", "api", "sdk"],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rimraf": "^4.4.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.2"
+  }
+}

package/src/client.ts

@@ -0,0 +1,143 @@
+import type { CreatePayload, ListParams, Memory, UpdatePayload } from './types';
+
+/** 默认 API 基础地址（含 /api 前缀） */
+export const DEFAULT_BASE_URL = 'https://www.mixlab.top/api';
+
+const MEMORIES_PATH = '/memory/v1/memories';
+
+function toMemory(record: {
+  id: string;
+  source: string;
+  category: string;
+  content: string;
+  tags: string[] | unknown;
+  images?: string[];
+  createdAt: number;
+  updatedAt: number;
+  metadata?: unknown;
+  rawData?: unknown;
+}): Memory {
+  const tags = Array.isArray(record.tags) ? record.tags : [];
+  return {
+    id: record.id,
+    source: record.source,
+    category: record.category,
+    content: record.content,
+    tags,
+    images: record.images?.length ? record.images : undefined,
+    createdAt: record.createdAt,
+    updatedAt: record.updatedAt,
+    metadata: record.metadata,
+    rawData: record.rawData,
+  };
+}
+
+async function handleResponse<T>(res: Response, parse: (data: unknown) => T): Promise<T> {
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const err = data && typeof data === 'object' && 'error' in data ? String(data.error) : `HTTP ${res.status}`;
+    throw new Error(err);
+  }
+  return parse(data);
+}
+
+export interface MemoryClientOptions {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+/**
+ * Memory API 客户端：使用 API Key 调用 /api/memory/v1/memories 的 CRUD 与列表/搜索。
+ */
+export class MemoryClient {
+  private readonly apiKey: string;
+  private readonly baseUrl: string;
+
+  constructor(options: MemoryClientOptions) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+  }
+
+  private url(path: string, searchParams?: Record<string, string>): string {
+    const u = `${this.baseUrl}${path}`;
+    if (!searchParams || Object.keys(searchParams).length === 0) return u;
+    const sp = new URLSearchParams(searchParams);
+    return `${u}?${sp.toString()}`;
+  }
+
+  private headers(init?: Record<string, string>): Record<string, string> {
+    return {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${this.apiKey}`,
+      ...init,
+    };
+  }
+
+  /** 列表，支持 category / source / tag / limit / offset */
+  async list(params?: ListParams): Promise<Memory[]> {
+    const searchParams: Record<string, string> = {};
+    if (params?.category) searchParams.category = params.category;
+    if (params?.source) searchParams.source = params.source;
+    if (params?.tag) searchParams.tag = params.tag;
+    if (params?.limit != null) searchParams.limit = String(params.limit);
+    if (params?.offset != null) searchParams.offset = String(params.offset);
+
+    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });
+    const list = await handleResponse(res, (data) => (Array.isArray(data) ? data : []));
+    return list.map(toMemory);
+  }
+
+  /** 关键词搜索 */
+  async search(q: string, limit?: number): Promise<Memory[]> {
+    const searchParams: Record<string, string> = { q };
+    if (limit != null) searchParams.limit = String(limit);
+    const res = await fetch(this.url(MEMORIES_PATH, searchParams), { headers: this.headers() });
+    const list = await handleResponse(res, (data) => (Array.isArray(data) ? data : []));
+    return list.map(toMemory);
+  }
+
+  /** 按 id 获取单条，404 返回 null */
+  async get(id: string): Promise<Memory | null> {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      headers: this.headers(),
+    });
+    if (res.status === 404) return null;
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record as Parameters<typeof toMemory>[0]);
+  }
+
+  /** 创建 */
+  async create(payload: CreatePayload): Promise<Memory> {
+    const res = await fetch(this.url(MEMORIES_PATH), {
+      method: 'POST',
+      headers: this.headers(),
+      body: JSON.stringify(payload),
+    });
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record as Parameters<typeof toMemory>[0]);
+  }
+
+  /** 更新 */
+  async update(id: string, payload: UpdatePayload): Promise<Memory> {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      method: 'PATCH',
+      headers: this.headers(),
+      body: JSON.stringify(payload),
+    });
+    const record = await handleResponse(res, (x) => x);
+    return toMemory(record as Parameters<typeof toMemory>[0]);
+  }
+
+  /** 删除 */
+  async delete(id: string): Promise<void> {
+    const res = await fetch(this.url(`${MEMORIES_PATH}/${encodeURIComponent(id)}`), {
+      method: 'DELETE',
+      headers: this.headers(),
+    });
+    if (!res.ok) {
+      const data = await res.json().catch(() => ({}));
+      const err = data && typeof data === 'object' && 'error' in data ? String(data.error) : `HTTP ${res.status}`;
+      throw new Error(err);
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { MemoryClient, DEFAULT_BASE_URL, type MemoryClientOptions } from './client';
+export type { Memory, CreatePayload, UpdatePayload, ListParams } from './types';

package/src/types.ts

@@ -0,0 +1,46 @@
+/**
+ * Memory 数据类型定义（与后端 API 返回对齐）
+ */
+export interface Memory {
+  id: string;
+  source: string;
+  category: string;
+  content: string;
+  tags: string[];
+  images?: string[];
+  createdAt: number;
+  updatedAt: number;
+  metadata?: unknown;
+  rawData?: unknown;
+}
+
+/** 创建 Memory 的请求体：source、category、content 必填 */
+export interface CreatePayload {
+  source: string;
+  category: string;
+  content: string;
+  tags?: string[];
+  images?: string[];
+  metadata?: unknown;
+  rawData?: unknown;
+}
+
+/** 更新 Memory 的请求体：全部可选 */
+export interface UpdatePayload {
+  source?: string;
+  category?: string;
+  content?: string;
+  tags?: string[];
+  images?: string[];
+  metadata?: unknown;
+  rawData?: unknown;
+}
+
+/** 列表/筛选参数（对应 GET 的 searchParams） */
+export interface ListParams {
+  category?: string;
+  source?: string;
+  tag?: string;
+  limit?: number;
+  offset?: number;
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['cjs', 'esm'],
+  dts: true,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  external: [],
+});