@agentmem/sdk 0.6.0

package/README.md

@@ -0,0 +1,42 @@
+# @agentmem/sdk
+
+TypeScript SDK for [AgentMem](https://agentmem.dev) — the memory API for AI agents.
+
+## Install
+
+```bash
+npm install @agentmem/sdk
+# or
+pnpm add @agentmem/sdk
+# or
+yarn add @agentmem/sdk
+```
+
+## Usage
+
+```ts
+import { MemoryStore } from '@agentmem/sdk'
+
+const mem = new MemoryStore({
+  apiKey: process.env.AGENTMEM_API_KEY!,
+  // baseUrl: 'https://your-self-hosted.example.com/functions/v1/api', // optional
+})
+
+await mem.write({
+  content: 'user prefers dark mode',
+  agentId: 'agent-1',
+  scope:   'user',
+})
+
+const hits = await mem.search({
+  query:   'theme preference',
+  agentId: 'agent-1',
+  topK:    5,
+})
+```
+
+See [`src/types.ts`](./src/types.ts) for the full type surface (writes, search, conflicts, scratch, API keys, teams, policies, webhooks, retention, usage, batch).
+
+## License
+
+[Apache-2.0](../LICENSE)

package/dist/index.cjs

@@ -0,0 +1,178 @@
+"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, {
+  AgentMemError: () => AgentMemError,
+  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  MemoryStore: () => MemoryStore
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://lwbwcuuzoituanwhekyo.supabase.co/functions/v1/api";
+var MemoryStore = class {
+  constructor(opts) {
+    this.apiKey = opts.apiKey;
+    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  async req(method, path, body) {
+    const r = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${this.apiKey}`
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    if (r.status === 204) return null;
+    const json = await r.json();
+    if (!r.ok) {
+      throw new AgentMemError(json?.error ?? `HTTP ${r.status}`, r.status);
+    }
+    return json;
+  }
+  // ── Memory ────────────────────────────────────────────────────────────────
+  async write(params) {
+    return this.req("POST", "/v1/memory/write", params);
+  }
+  async search(params) {
+    return this.req("POST", "/v1/memory/search", params);
+  }
+  async get(id) {
+    return this.req("GET", `/v1/memory/${id}`);
+  }
+  async delete(id) {
+    return this.req("DELETE", `/v1/memory/${id}`);
+  }
+  async checkConflicts(params) {
+    return this.req("POST", "/v1/memory/conflicts", params);
+  }
+  // ── Batch ─────────────────────────────────────────────────────────────────
+  async batchWrite(writes) {
+    return this.req("POST", "/v1/memory/batch/write", { writes });
+  }
+  async batchSearch(searches) {
+    return this.req("POST", "/v1/memory/batch/search", { searches });
+  }
+  // ── Scratch ───────────────────────────────────────────────────────────────
+  async scratchSet(params) {
+    const { ttlSecs, ...rest } = params;
+    return this.req("POST", "/v1/scratch/set", { ...rest, ttl: ttlSecs });
+  }
+  async scratchGet(workflowId, key) {
+    const r = await this.req("POST", "/v1/scratch/get", { workflowId, key });
+    return r.value;
+  }
+  async scratchDel(workflowId, key) {
+    return this.req("POST", "/v1/scratch/del", { workflowId, key });
+  }
+  // ── Workflows ─────────────────────────────────────────────────────────────
+  async summarize(workflowId, agentId) {
+    const r = await this.req("POST", `/v1/workflows/${workflowId}/summarize`, { agentId });
+    return r.summary;
+  }
+  async workflowMemories(workflowId) {
+    return this.req("GET", `/v1/workflows/${workflowId}/memories`);
+  }
+  // ── API Keys ──────────────────────────────────────────────────────────────
+  async listKeys() {
+    const r = await this.req("GET", "/v1/keys");
+    return r.keys;
+  }
+  async createKey(params) {
+    return this.req("POST", "/v1/keys", params);
+  }
+  async revokeKey(id) {
+    return this.req("DELETE", `/v1/keys/${id}`);
+  }
+  // ── Teams ─────────────────────────────────────────────────────────────────
+  async listTeams() {
+    const r = await this.req("GET", "/v1/teams");
+    return r.teams;
+  }
+  async createTeam(name) {
+    return this.req("POST", "/v1/teams", { name });
+  }
+  async deleteTeam(id) {
+    return this.req("DELETE", `/v1/teams/${id}`);
+  }
+  // ── Conflict policies ─────────────────────────────────────────────────────
+  async listPolicies() {
+    const r = await this.req("GET", "/v1/policies");
+    return r.policies;
+  }
+  async setPolicy(params) {
+    return this.req("PUT", "/v1/policies", params);
+  }
+  async deletePolicy(id) {
+    return this.req("DELETE", `/v1/policies/${id}`);
+  }
+  // ── Webhooks ──────────────────────────────────────────────────────────────
+  async listWebhooks() {
+    const r = await this.req("GET", "/v1/webhooks");
+    return r.webhooks;
+  }
+  async createWebhook(params) {
+    return this.req("POST", "/v1/webhooks", params);
+  }
+  async enableWebhook(id) {
+    return this.req("PATCH", `/v1/webhooks/${id}`, { active: true });
+  }
+  async disableWebhook(id) {
+    return this.req("PATCH", `/v1/webhooks/${id}`, { active: false });
+  }
+  async deleteWebhook(id) {
+    return this.req("DELETE", `/v1/webhooks/${id}`);
+  }
+  // ── Org settings ──────────────────────────────────────────────────────────
+  async registerByok(customerKey) {
+    return this.req("POST", "/v1/org/byok", { customerKey });
+  }
+  async removeByok() {
+    return this.req("DELETE", "/v1/org/byok");
+  }
+  async getRetention() {
+    return this.req("GET", "/v1/org/retention");
+  }
+  async setRetention(params) {
+    return this.req("PUT", "/v1/org/retention", params);
+  }
+  async getWorkflowUsage(days = 30) {
+    const r = await this.req(
+      "GET",
+      `/v1/org/usage/workflows?days=${days}`
+    );
+    return r.workflows;
+  }
+};
+var AgentMemError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "AgentMemError";
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentMemError,
+  DEFAULT_BASE_URL,
+  MemoryStore
+});

package/dist/index.d.cts

@@ -0,0 +1,197 @@
+interface ClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+type Scope = 'private' | 'team' | 'global';
+type Role = 'planner' | 'executor' | 'observer';
+type ConflictPolicy = 'ignore' | 'planner_wins' | 'timestamp_wins' | 'human_in_loop';
+type WebhookEvent = 'memory.written' | 'memory.deleted' | 'memory.conflict_blocked' | 'memory.superseded';
+interface WriteParams {
+    content: string;
+    agentId: string;
+    scope?: Scope;
+    role?: Role;
+    workflowId?: string;
+    expiresAt?: string;
+}
+interface WriteResult {
+    writeId: string;
+    duplicate?: boolean;
+}
+interface SearchParams {
+    query: string;
+    agentId: string;
+    workflowId?: string;
+    topK?: number;
+    scope?: Scope;
+    atTime?: string;
+}
+interface MemoryHit {
+    id: string;
+    content: string;
+    agent_id: string;
+    scope: string;
+    role: string | null;
+    workflow_id: string | null;
+    created_at: string;
+    score: number;
+    vector_clock?: Record<string, number>;
+}
+interface Memory {
+    id: string;
+    content: string;
+    agent_id: string;
+    scope: string;
+    role: string | null;
+    workflow_id: string | null;
+    created_at: string;
+    expires_at: string | null;
+    extracted: boolean;
+    encrypted: boolean;
+    vector_clock?: Record<string, number>;
+}
+interface Conflict {
+    memoryId: string;
+    severity: 'high' | 'low';
+    description: string;
+}
+interface ConflictResult {
+    conflicts: Conflict[];
+}
+interface ScratchSetParams {
+    workflowId: string;
+    key: string;
+    value: string;
+    ttlSecs?: number;
+}
+interface ApiKey {
+    id: string;
+    name: string;
+    key_prefix: string;
+    tier: string;
+    scoped_agent: string | null;
+    scoped_scope: string | null;
+    created_at: string;
+    last_used_at: string | null;
+    revoked_at: string | null;
+}
+interface CreateKeyParams {
+    name: string;
+    tier?: string;
+    scopedAgent?: string;
+    scopedScope?: string;
+}
+interface CreateKeyResult {
+    key: string;
+    id: string;
+}
+interface Team {
+    id: string;
+    name: string;
+    created_at: string;
+}
+interface Policy {
+    id: string;
+    workflow_id: string | null;
+    policy: ConflictPolicy;
+    webhook_url: string | null;
+    created_at: string;
+}
+interface SetPolicyParams {
+    policy: ConflictPolicy;
+    workflowId?: string;
+    webhookUrl?: string | null;
+}
+interface Webhook {
+    id: string;
+    url: string;
+    events: WebhookEvent[];
+    active: boolean;
+    created_at: string;
+    secret?: string;
+}
+interface CreateWebhookParams {
+    url: string;
+    events: WebhookEvent[];
+}
+interface Retention {
+    memoriesDays: number | null;
+    auditDays: number;
+    scratchDays: number;
+}
+interface WorkflowUsage {
+    writes: number;
+    searches: number;
+}
+interface BatchWriteResult {
+    results: Array<{
+        writeId?: string;
+        duplicate?: boolean;
+        error?: string;
+    }>;
+}
+interface BatchSearchResult {
+    results: Array<MemoryHit[] | {
+        error: string;
+    }>;
+}
+
+declare const DEFAULT_BASE_URL = "https://lwbwcuuzoituanwhekyo.supabase.co/functions/v1/api";
+declare class MemoryStore {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(opts: ClientOptions);
+    private req;
+    write(params: WriteParams): Promise<WriteResult>;
+    search(params: SearchParams): Promise<MemoryHit[]>;
+    get(id: string): Promise<Memory>;
+    delete(id: string): Promise<void>;
+    checkConflicts(params: {
+        content: string;
+        agentId: string;
+        workflowId?: string;
+        scope?: string;
+    }): Promise<ConflictResult>;
+    batchWrite(writes: WriteParams[]): Promise<BatchWriteResult>;
+    batchSearch(searches: SearchParams[]): Promise<BatchSearchResult>;
+    scratchSet(params: ScratchSetParams): Promise<void>;
+    scratchGet(workflowId: string, key: string): Promise<string | null>;
+    scratchDel(workflowId: string, key: string): Promise<void>;
+    summarize(workflowId: string, agentId: string): Promise<string>;
+    workflowMemories(workflowId: string): Promise<MemoryHit[]>;
+    listKeys(): Promise<ApiKey[]>;
+    createKey(params: CreateKeyParams): Promise<CreateKeyResult>;
+    revokeKey(id: string): Promise<void>;
+    listTeams(): Promise<Team[]>;
+    createTeam(name: string): Promise<Team>;
+    deleteTeam(id: string): Promise<void>;
+    listPolicies(): Promise<Policy[]>;
+    setPolicy(params: SetPolicyParams): Promise<Policy>;
+    deletePolicy(id: string): Promise<void>;
+    listWebhooks(): Promise<Webhook[]>;
+    createWebhook(params: CreateWebhookParams): Promise<Webhook & {
+        secret: string;
+    }>;
+    enableWebhook(id: string): Promise<Webhook>;
+    disableWebhook(id: string): Promise<Webhook>;
+    deleteWebhook(id: string): Promise<void>;
+    registerByok(customerKey: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    removeByok(): Promise<{
+        ok: boolean;
+        warning: string;
+    }>;
+    getRetention(): Promise<Retention>;
+    setRetention(params: Retention): Promise<{
+        ok: boolean;
+    }>;
+    getWorkflowUsage(days?: number): Promise<Record<string, WorkflowUsage>>;
+}
+declare class AgentMemError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+
+export { AgentMemError, type ApiKey, type BatchSearchResult, type BatchWriteResult, type ClientOptions, type Conflict, type ConflictPolicy, type ConflictResult, type CreateKeyParams, type CreateKeyResult, type CreateWebhookParams, DEFAULT_BASE_URL, type Memory, type MemoryHit, MemoryStore, type Policy, type Retention, type Role, type Scope, type ScratchSetParams, type SearchParams, type SetPolicyParams, type Team, type Webhook, type WebhookEvent, type WorkflowUsage, type WriteParams, type WriteResult };

package/dist/index.d.ts

@@ -0,0 +1,197 @@
+interface ClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+type Scope = 'private' | 'team' | 'global';
+type Role = 'planner' | 'executor' | 'observer';
+type ConflictPolicy = 'ignore' | 'planner_wins' | 'timestamp_wins' | 'human_in_loop';
+type WebhookEvent = 'memory.written' | 'memory.deleted' | 'memory.conflict_blocked' | 'memory.superseded';
+interface WriteParams {
+    content: string;
+    agentId: string;
+    scope?: Scope;
+    role?: Role;
+    workflowId?: string;
+    expiresAt?: string;
+}
+interface WriteResult {
+    writeId: string;
+    duplicate?: boolean;
+}
+interface SearchParams {
+    query: string;
+    agentId: string;
+    workflowId?: string;
+    topK?: number;
+    scope?: Scope;
+    atTime?: string;
+}
+interface MemoryHit {
+    id: string;
+    content: string;
+    agent_id: string;
+    scope: string;
+    role: string | null;
+    workflow_id: string | null;
+    created_at: string;
+    score: number;
+    vector_clock?: Record<string, number>;
+}
+interface Memory {
+    id: string;
+    content: string;
+    agent_id: string;
+    scope: string;
+    role: string | null;
+    workflow_id: string | null;
+    created_at: string;
+    expires_at: string | null;
+    extracted: boolean;
+    encrypted: boolean;
+    vector_clock?: Record<string, number>;
+}
+interface Conflict {
+    memoryId: string;
+    severity: 'high' | 'low';
+    description: string;
+}
+interface ConflictResult {
+    conflicts: Conflict[];
+}
+interface ScratchSetParams {
+    workflowId: string;
+    key: string;
+    value: string;
+    ttlSecs?: number;
+}
+interface ApiKey {
+    id: string;
+    name: string;
+    key_prefix: string;
+    tier: string;
+    scoped_agent: string | null;
+    scoped_scope: string | null;
+    created_at: string;
+    last_used_at: string | null;
+    revoked_at: string | null;
+}
+interface CreateKeyParams {
+    name: string;
+    tier?: string;
+    scopedAgent?: string;
+    scopedScope?: string;
+}
+interface CreateKeyResult {
+    key: string;
+    id: string;
+}
+interface Team {
+    id: string;
+    name: string;
+    created_at: string;
+}
+interface Policy {
+    id: string;
+    workflow_id: string | null;
+    policy: ConflictPolicy;
+    webhook_url: string | null;
+    created_at: string;
+}
+interface SetPolicyParams {
+    policy: ConflictPolicy;
+    workflowId?: string;
+    webhookUrl?: string | null;
+}
+interface Webhook {
+    id: string;
+    url: string;
+    events: WebhookEvent[];
+    active: boolean;
+    created_at: string;
+    secret?: string;
+}
+interface CreateWebhookParams {
+    url: string;
+    events: WebhookEvent[];
+}
+interface Retention {
+    memoriesDays: number | null;
+    auditDays: number;
+    scratchDays: number;
+}
+interface WorkflowUsage {
+    writes: number;
+    searches: number;
+}
+interface BatchWriteResult {
+    results: Array<{
+        writeId?: string;
+        duplicate?: boolean;
+        error?: string;
+    }>;
+}
+interface BatchSearchResult {
+    results: Array<MemoryHit[] | {
+        error: string;
+    }>;
+}
+
+declare const DEFAULT_BASE_URL = "https://lwbwcuuzoituanwhekyo.supabase.co/functions/v1/api";
+declare class MemoryStore {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(opts: ClientOptions);
+    private req;
+    write(params: WriteParams): Promise<WriteResult>;
+    search(params: SearchParams): Promise<MemoryHit[]>;
+    get(id: string): Promise<Memory>;
+    delete(id: string): Promise<void>;
+    checkConflicts(params: {
+        content: string;
+        agentId: string;
+        workflowId?: string;
+        scope?: string;
+    }): Promise<ConflictResult>;
+    batchWrite(writes: WriteParams[]): Promise<BatchWriteResult>;
+    batchSearch(searches: SearchParams[]): Promise<BatchSearchResult>;
+    scratchSet(params: ScratchSetParams): Promise<void>;
+    scratchGet(workflowId: string, key: string): Promise<string | null>;
+    scratchDel(workflowId: string, key: string): Promise<void>;
+    summarize(workflowId: string, agentId: string): Promise<string>;
+    workflowMemories(workflowId: string): Promise<MemoryHit[]>;
+    listKeys(): Promise<ApiKey[]>;
+    createKey(params: CreateKeyParams): Promise<CreateKeyResult>;
+    revokeKey(id: string): Promise<void>;
+    listTeams(): Promise<Team[]>;
+    createTeam(name: string): Promise<Team>;
+    deleteTeam(id: string): Promise<void>;
+    listPolicies(): Promise<Policy[]>;
+    setPolicy(params: SetPolicyParams): Promise<Policy>;
+    deletePolicy(id: string): Promise<void>;
+    listWebhooks(): Promise<Webhook[]>;
+    createWebhook(params: CreateWebhookParams): Promise<Webhook & {
+        secret: string;
+    }>;
+    enableWebhook(id: string): Promise<Webhook>;
+    disableWebhook(id: string): Promise<Webhook>;
+    deleteWebhook(id: string): Promise<void>;
+    registerByok(customerKey: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    removeByok(): Promise<{
+        ok: boolean;
+        warning: string;
+    }>;
+    getRetention(): Promise<Retention>;
+    setRetention(params: Retention): Promise<{
+        ok: boolean;
+    }>;
+    getWorkflowUsage(days?: number): Promise<Record<string, WorkflowUsage>>;
+}
+declare class AgentMemError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+
+export { AgentMemError, type ApiKey, type BatchSearchResult, type BatchWriteResult, type ClientOptions, type Conflict, type ConflictPolicy, type ConflictResult, type CreateKeyParams, type CreateKeyResult, type CreateWebhookParams, DEFAULT_BASE_URL, type Memory, type MemoryHit, MemoryStore, type Policy, type Retention, type Role, type Scope, type ScratchSetParams, type SearchParams, type SetPolicyParams, type Team, type Webhook, type WebhookEvent, type WorkflowUsage, type WriteParams, type WriteResult };

package/dist/index.js

@@ -0,0 +1,149 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://lwbwcuuzoituanwhekyo.supabase.co/functions/v1/api";
+var MemoryStore = class {
+  constructor(opts) {
+    this.apiKey = opts.apiKey;
+    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  async req(method, path, body) {
+    const r = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${this.apiKey}`
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    if (r.status === 204) return null;
+    const json = await r.json();
+    if (!r.ok) {
+      throw new AgentMemError(json?.error ?? `HTTP ${r.status}`, r.status);
+    }
+    return json;
+  }
+  // ── Memory ────────────────────────────────────────────────────────────────
+  async write(params) {
+    return this.req("POST", "/v1/memory/write", params);
+  }
+  async search(params) {
+    return this.req("POST", "/v1/memory/search", params);
+  }
+  async get(id) {
+    return this.req("GET", `/v1/memory/${id}`);
+  }
+  async delete(id) {
+    return this.req("DELETE", `/v1/memory/${id}`);
+  }
+  async checkConflicts(params) {
+    return this.req("POST", "/v1/memory/conflicts", params);
+  }
+  // ── Batch ─────────────────────────────────────────────────────────────────
+  async batchWrite(writes) {
+    return this.req("POST", "/v1/memory/batch/write", { writes });
+  }
+  async batchSearch(searches) {
+    return this.req("POST", "/v1/memory/batch/search", { searches });
+  }
+  // ── Scratch ───────────────────────────────────────────────────────────────
+  async scratchSet(params) {
+    const { ttlSecs, ...rest } = params;
+    return this.req("POST", "/v1/scratch/set", { ...rest, ttl: ttlSecs });
+  }
+  async scratchGet(workflowId, key) {
+    const r = await this.req("POST", "/v1/scratch/get", { workflowId, key });
+    return r.value;
+  }
+  async scratchDel(workflowId, key) {
+    return this.req("POST", "/v1/scratch/del", { workflowId, key });
+  }
+  // ── Workflows ─────────────────────────────────────────────────────────────
+  async summarize(workflowId, agentId) {
+    const r = await this.req("POST", `/v1/workflows/${workflowId}/summarize`, { agentId });
+    return r.summary;
+  }
+  async workflowMemories(workflowId) {
+    return this.req("GET", `/v1/workflows/${workflowId}/memories`);
+  }
+  // ── API Keys ──────────────────────────────────────────────────────────────
+  async listKeys() {
+    const r = await this.req("GET", "/v1/keys");
+    return r.keys;
+  }
+  async createKey(params) {
+    return this.req("POST", "/v1/keys", params);
+  }
+  async revokeKey(id) {
+    return this.req("DELETE", `/v1/keys/${id}`);
+  }
+  // ── Teams ─────────────────────────────────────────────────────────────────
+  async listTeams() {
+    const r = await this.req("GET", "/v1/teams");
+    return r.teams;
+  }
+  async createTeam(name) {
+    return this.req("POST", "/v1/teams", { name });
+  }
+  async deleteTeam(id) {
+    return this.req("DELETE", `/v1/teams/${id}`);
+  }
+  // ── Conflict policies ─────────────────────────────────────────────────────
+  async listPolicies() {
+    const r = await this.req("GET", "/v1/policies");
+    return r.policies;
+  }
+  async setPolicy(params) {
+    return this.req("PUT", "/v1/policies", params);
+  }
+  async deletePolicy(id) {
+    return this.req("DELETE", `/v1/policies/${id}`);
+  }
+  // ── Webhooks ──────────────────────────────────────────────────────────────
+  async listWebhooks() {
+    const r = await this.req("GET", "/v1/webhooks");
+    return r.webhooks;
+  }
+  async createWebhook(params) {
+    return this.req("POST", "/v1/webhooks", params);
+  }
+  async enableWebhook(id) {
+    return this.req("PATCH", `/v1/webhooks/${id}`, { active: true });
+  }
+  async disableWebhook(id) {
+    return this.req("PATCH", `/v1/webhooks/${id}`, { active: false });
+  }
+  async deleteWebhook(id) {
+    return this.req("DELETE", `/v1/webhooks/${id}`);
+  }
+  // ── Org settings ──────────────────────────────────────────────────────────
+  async registerByok(customerKey) {
+    return this.req("POST", "/v1/org/byok", { customerKey });
+  }
+  async removeByok() {
+    return this.req("DELETE", "/v1/org/byok");
+  }
+  async getRetention() {
+    return this.req("GET", "/v1/org/retention");
+  }
+  async setRetention(params) {
+    return this.req("PUT", "/v1/org/retention", params);
+  }
+  async getWorkflowUsage(days = 30) {
+    const r = await this.req(
+      "GET",
+      `/v1/org/usage/workflows?days=${days}`
+    );
+    return r.workflows;
+  }
+};
+var AgentMemError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "AgentMemError";
+  }
+};
+export {
+  AgentMemError,
+  DEFAULT_BASE_URL,
+  MemoryStore
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@agentmem/sdk",
+  "version": "0.6.0",
+  "description": "TypeScript SDK for AgentMem — the memory API for AI agents",
+  "license": "Apache-2.0",
+  "author": "rooney011 <bvsa2020@gmail.com>",
+  "homepage": "https://agentmem.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rooney011/agentmem-sdk.git",
+    "directory": "typescript"
+  },
+  "bugs": { "url": "https://github.com/rooney011/agentmem-sdk/issues" },
+  "keywords": ["ai", "agents", "memory", "llm", "rag", "vector", "sdk"],
+  "type": "module",
+  "main":   "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types":  "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types":   "./dist/index.d.ts",
+      "import":  "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build":     "tsup src/index.ts --format esm,cjs --dts --clean",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup":       "8.3.5",
+    "typescript": "5.8.3"
+  },
+  "engines": { "node": ">=18" }
+}