@rezzed.ai/memory 0.1.0

package/README.md

@@ -0,0 +1,148 @@
+# @rezzed.ai/memory
+
+**CacheBash Memory SDK** — Lightweight TypeScript client for storing and recalling learned patterns via CacheBash.
+
+## Installation
+
+```bash
+npm install @rezzed.ai/memory
+```
+
+## Quick Start
+
+```typescript
+import { CacheBashMemory } from "@rezzed.ai/memory";
+
+const memory = new CacheBashMemory({
+  apiKey: "your-api-key",
+  programId: "your-program-id",
+  endpoint: "https://api.cachebash.dev/v1/mcp", // optional, this is the default
+});
+
+// Store a memory pattern
+await memory.store({
+  id: "pattern-001",
+  domain: "workflow",
+  pattern: "Always validate input before processing",
+  confidence: 0.95,
+  evidence: "Prevented 3 runtime errors in production",
+});
+
+// Recall all patterns
+const patterns = await memory.recall();
+console.log(patterns);
+
+// Recall patterns by domain
+const workflowPatterns = await memory.recall({ domain: "workflow" });
+
+// Search patterns
+const searchResults = await memory.recall({ search: "validate" });
+
+// Get memory health stats
+const health = await memory.health();
+console.log(health);
+// {
+//   totalPatterns: 42,
+//   promotedPatterns: 5,
+//   stalePatterns: 2,
+//   domains: ["workflow", "security", "performance"],
+//   avgConfidence: 0.87,
+//   ...
+// }
+```
+
+## API Reference
+
+### `CacheBashMemory`
+
+Main client class for memory operations.
+
+#### Constructor
+
+```typescript
+new CacheBashMemory(config: CacheBashMemoryConfig)
+```
+
+**Config:**
+- `apiKey` (string, required) — Your CacheBash API key
+- `programId` (string, required) — Program ID for memory isolation
+- `endpoint` (string, optional) — MCP endpoint URL (default: `https://api.cachebash.dev/v1/mcp`)
+
+#### Methods
+
+##### `store(pattern: StorePatternInput): Promise<void>`
+
+Store or update a memory pattern. If a pattern with the same `id` exists, it will be replaced.
+
+**Pattern fields:**
+- `id` (string) — Unique pattern identifier
+- `domain` (string) — Domain category (e.g., "workflow", "security", "performance")
+- `pattern` (string) — The learned pattern or rule
+- `confidence` (number) — Confidence score (0-1)
+- `evidence` (string) — Supporting evidence or context
+
+##### `recall(options?: RecallOptions): Promise<MemoryPattern[]>`
+
+Recall memory patterns with optional filters.
+
+**Options:**
+- `domain` (string, optional) — Filter by domain
+- `search` (string, optional) — Text search across pattern and evidence fields
+
+**Returns:** Array of `MemoryPattern` objects (excludes stale patterns by default)
+
+##### `health(): Promise<MemoryHealth>`
+
+Get memory health statistics.
+
+**Returns:**
+- `totalPatterns` — Total pattern count
+- `promotedPatterns` — Patterns promoted to permanent storage
+- `stalePatterns` — Patterns marked as stale
+- `domains` — List of all domains
+- `avgConfidence` — Average confidence score
+- `oldestPattern` — Timestamp of oldest pattern
+- `newestPattern` — Timestamp of newest pattern
+- `decay` — Decay configuration (TTL, max age, etc.)
+
+## Types
+
+```typescript
+interface MemoryPattern {
+  id: string;
+  domain: string;
+  pattern: string;
+  confidence: number;
+  evidence: string;
+  discoveredAt: string;
+  lastReinforced: string;
+  promotedToStore: boolean;
+  stale: boolean;
+}
+
+interface MemoryHealth {
+  totalPatterns: number;
+  promotedPatterns: number;
+  stalePatterns: number;
+  domains: string[];
+  avgConfidence: number;
+  oldestPattern: string | null;
+  newestPattern: string | null;
+  decay: {
+    contextSummaryTTLDays: number;
+    learnedPatternMaxAge: number;
+    maxUnpromotedPatterns: number;
+    lastDecayRun: string;
+  };
+}
+```
+
+## License
+
+MIT
+
+## Links
+
+- [CacheBash Documentation](https://rezzed.ai/cachebash)
+- [GitHub Repository](https://github.com/rezzedai/cachebash)
+- [Report Issues](https://github.com/rezzedai/cachebash/issues)

package/dist/index.d.cts

@@ -0,0 +1,107 @@
+/**
+ * CacheBash Memory SDK Types
+ */
+/**
+ * A learned pattern stored in program memory.
+ */
+interface MemoryPattern {
+    id: string;
+    domain: string;
+    pattern: string;
+    confidence: number;
+    evidence: string;
+    discoveredAt: string;
+    lastReinforced: string;
+    promotedToStore: boolean;
+    stale: boolean;
+}
+/**
+ * Memory health statistics.
+ */
+interface MemoryHealth {
+    totalPatterns: number;
+    promotedPatterns: number;
+    stalePatterns: number;
+    domains: string[];
+    avgConfidence: number;
+    oldestPattern: string | null;
+    newestPattern: string | null;
+    decay: {
+        contextSummaryTTLDays: number;
+        learnedPatternMaxAge: number;
+        maxUnpromotedPatterns: number;
+        lastDecayRun: string;
+    };
+}
+/**
+ * Configuration for CacheBashMemory client.
+ */
+interface CacheBashMemoryConfig {
+    /**
+     * CacheBash API key (required).
+     */
+    apiKey: string;
+    /**
+     * MCP endpoint URL.
+     * @default "https://api.cachebash.dev/v1/mcp"
+     */
+    endpoint?: string;
+    /**
+     * Program ID for memory operations.
+     */
+    programId: string;
+}
+/**
+ * Options for recalling memories.
+ */
+interface RecallOptions {
+    /**
+     * Filter by domain (optional).
+     */
+    domain?: string;
+    /**
+     * Text search query (optional).
+     */
+    search?: string;
+}
+/**
+ * Pattern to store in memory.
+ */
+interface StorePatternInput {
+    id: string;
+    domain: string;
+    pattern: string;
+    confidence: number;
+    evidence: string;
+}
+
+/**
+ * CacheBashMemory — SDK client for memory pattern storage and recall.
+ */
+
+declare class CacheBashMemory {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly programId;
+    private requestId;
+    constructor(config: CacheBashMemoryConfig);
+    /**
+     * Store a memory pattern.
+     * If a pattern with the same ID exists, it will be replaced.
+     */
+    store(input: StorePatternInput): Promise<void>;
+    /**
+     * Recall memory patterns with optional filters.
+     */
+    recall(options?: RecallOptions): Promise<MemoryPattern[]>;
+    /**
+     * Get memory health statistics.
+     */
+    health(): Promise<MemoryHealth>;
+    /**
+     * Call an MCP tool via HTTP transport.
+     */
+    private callTool;
+}
+
+export { CacheBashMemory, type CacheBashMemoryConfig, type MemoryHealth, type MemoryPattern, type RecallOptions, type StorePatternInput };

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * CacheBash Memory SDK Types
+ */
+/**
+ * A learned pattern stored in program memory.
+ */
+interface MemoryPattern {
+    id: string;
+    domain: string;
+    pattern: string;
+    confidence: number;
+    evidence: string;
+    discoveredAt: string;
+    lastReinforced: string;
+    promotedToStore: boolean;
+    stale: boolean;
+}
+/**
+ * Memory health statistics.
+ */
+interface MemoryHealth {
+    totalPatterns: number;
+    promotedPatterns: number;
+    stalePatterns: number;
+    domains: string[];
+    avgConfidence: number;
+    oldestPattern: string | null;
+    newestPattern: string | null;
+    decay: {
+        contextSummaryTTLDays: number;
+        learnedPatternMaxAge: number;
+        maxUnpromotedPatterns: number;
+        lastDecayRun: string;
+    };
+}
+/**
+ * Configuration for CacheBashMemory client.
+ */
+interface CacheBashMemoryConfig {
+    /**
+     * CacheBash API key (required).
+     */
+    apiKey: string;
+    /**
+     * MCP endpoint URL.
+     * @default "https://api.cachebash.dev/v1/mcp"
+     */
+    endpoint?: string;
+    /**
+     * Program ID for memory operations.
+     */
+    programId: string;
+}
+/**
+ * Options for recalling memories.
+ */
+interface RecallOptions {
+    /**
+     * Filter by domain (optional).
+     */
+    domain?: string;
+    /**
+     * Text search query (optional).
+     */
+    search?: string;
+}
+/**
+ * Pattern to store in memory.
+ */
+interface StorePatternInput {
+    id: string;
+    domain: string;
+    pattern: string;
+    confidence: number;
+    evidence: string;
+}
+
+/**
+ * CacheBashMemory — SDK client for memory pattern storage and recall.
+ */
+
+declare class CacheBashMemory {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly programId;
+    private requestId;
+    constructor(config: CacheBashMemoryConfig);
+    /**
+     * Store a memory pattern.
+     * If a pattern with the same ID exists, it will be replaced.
+     */
+    store(input: StorePatternInput): Promise<void>;
+    /**
+     * Recall memory patterns with optional filters.
+     */
+    recall(options?: RecallOptions): Promise<MemoryPattern[]>;
+    /**
+     * Get memory health statistics.
+     */
+    health(): Promise<MemoryHealth>;
+    /**
+     * Call an MCP tool via HTTP transport.
+     */
+    private callTool;
+}
+
+export { CacheBashMemory, type CacheBashMemoryConfig, type MemoryHealth, type MemoryPattern, type RecallOptions, type StorePatternInput };

package/dist/index.js

@@ -0,0 +1,138 @@
+"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, {
+  CacheBashMemory: () => CacheBashMemory
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var CacheBashMemory = class {
+  apiKey;
+  endpoint;
+  programId;
+  requestId = 1;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.endpoint = config.endpoint || "https://api.cachebash.dev/v1/mcp";
+    this.programId = config.programId;
+    if (!this.apiKey) {
+      throw new Error("CacheBashMemory: apiKey is required");
+    }
+    if (!this.programId) {
+      throw new Error("CacheBashMemory: programId is required");
+    }
+  }
+  /**
+   * Store a memory pattern.
+   * If a pattern with the same ID exists, it will be replaced.
+   */
+  async store(input) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const pattern = {
+      ...input,
+      discoveredAt: now,
+      lastReinforced: now,
+      promotedToStore: false,
+      stale: false
+    };
+    const result = await this.callTool("store_memory", {
+      programId: this.programId,
+      pattern
+    });
+    if (!result.success) {
+      throw new Error(`Failed to store memory: ${result.error || "Unknown error"}`);
+    }
+  }
+  /**
+   * Recall memory patterns with optional filters.
+   */
+  async recall(options) {
+    const result = await this.callTool("recall_memory", {
+      programId: this.programId,
+      domain: options?.domain,
+      query: options?.search,
+      includeStale: false
+    });
+    if (!result.success) {
+      throw new Error(`Failed to recall memory: ${result.error || "Unknown error"}`);
+    }
+    return result.patterns || [];
+  }
+  /**
+   * Get memory health statistics.
+   */
+  async health() {
+    const result = await this.callTool("memory_health", {
+      programId: this.programId
+    });
+    if (!result.success) {
+      throw new Error(`Failed to get memory health: ${result.error || "Unknown error"}`);
+    }
+    return result.health;
+  }
+  /**
+   * Call an MCP tool via HTTP transport.
+   */
+  async callTool(name, args) {
+    const request = {
+      jsonrpc: "2.0",
+      method: "tools/call",
+      params: {
+        name,
+        arguments: args
+      },
+      id: this.requestId++
+    };
+    const response = await fetch(this.endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify(request)
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (data.error) {
+      throw new Error(`MCP error ${data.error.code}: ${data.error.message}`);
+    }
+    if (!data.result) {
+      throw new Error("MCP response missing result");
+    }
+    if (data.result.isError) {
+      const errorText = data.result.content[0]?.text || "Unknown error";
+      throw new Error(`MCP tool error: ${errorText}`);
+    }
+    const textContent = data.result.content[0]?.text;
+    if (!textContent) {
+      throw new Error("MCP response missing content");
+    }
+    return JSON.parse(textContent);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CacheBashMemory
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["/**\n * @rezzed.ai/memory — CacheBash Memory SDK\n */\n\nexport { CacheBashMemory } from \"./client.js\";\nexport type {\n  CacheBashMemoryConfig,\n  MemoryPattern,\n  MemoryHealth,\n  RecallOptions,\n  StorePatternInput,\n} from \"./types.js\";\n","/**\n * CacheBashMemory — SDK client for memory pattern storage and recall.\n */\n\nimport type {\n  CacheBashMemoryConfig,\n  MemoryPattern,\n  MemoryHealth,\n  RecallOptions,\n  StorePatternInput,\n} from \"./types.js\";\n\ninterface MCPRequest {\n  jsonrpc: \"2.0\";\n  method: string;\n  params: {\n    name: string;\n    arguments: Record<string, unknown>;\n  };\n  id: number;\n}\n\ninterface MCPResponse {\n  jsonrpc: \"2.0\";\n  result?: {\n    content: Array<{ type: string; text: string }>;\n    isError?: boolean;\n  };\n  error?: {\n    code: number;\n    message: string;\n  };\n  id: number;\n}\n\nexport class CacheBashMemory {\n  private readonly apiKey: string;\n  private readonly endpoint: string;\n  private readonly programId: string;\n  private requestId = 1;\n\n  constructor(config: CacheBashMemoryConfig) {\n    this.apiKey = config.apiKey;\n    this.endpoint = config.endpoint || \"https://api.cachebash.dev/v1/mcp\";\n    this.programId = config.programId;\n\n    if (!this.apiKey) {\n      throw new Error(\"CacheBashMemory: apiKey is required\");\n    }\n    if (!this.programId) {\n      throw new Error(\"CacheBashMemory: programId is required\");\n    }\n  }\n\n  /**\n   * Store a memory pattern.\n   * If a pattern with the same ID exists, it will be replaced.\n   */\n  async store(input: StorePatternInput): Promise<void> {\n    const now = new Date().toISOString();\n    const pattern: MemoryPattern = {\n      ...input,\n      discoveredAt: now,\n      lastReinforced: now,\n      promotedToStore: false,\n      stale: false,\n    };\n\n    const result = await this.callTool(\"store_memory\", {\n      programId: this.programId,\n      pattern,\n    });\n\n    if (!result.success) {\n      throw new Error(`Failed to store memory: ${result.error || \"Unknown error\"}`);\n    }\n  }\n\n  /**\n   * Recall memory patterns with optional filters.\n   */\n  async recall(options?: RecallOptions): Promise<MemoryPattern[]> {\n    const result = await this.callTool(\"recall_memory\", {\n      programId: this.programId,\n      domain: options?.domain,\n      query: options?.search,\n      includeStale: false,\n    });\n\n    if (!result.success) {\n      throw new Error(`Failed to recall memory: ${result.error || \"Unknown error\"}`);\n    }\n\n    return result.patterns || [];\n  }\n\n  /**\n   * Get memory health statistics.\n   */\n  async health(): Promise<MemoryHealth> {\n    const result = await this.callTool(\"memory_health\", {\n      programId: this.programId,\n    });\n\n    if (!result.success) {\n      throw new Error(`Failed to get memory health: ${result.error || \"Unknown error\"}`);\n    }\n\n    return result.health;\n  }\n\n  /**\n   * Call an MCP tool via HTTP transport.\n   */\n  private async callTool(name: string, args: Record<string, unknown>): Promise<any> {\n    const request: MCPRequest = {\n      jsonrpc: \"2.0\",\n      method: \"tools/call\",\n      params: {\n        name,\n        arguments: args,\n      },\n      id: this.requestId++,\n    };\n\n    const response = await fetch(this.endpoint, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(request),\n    });\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n    }\n\n    const data: MCPResponse = await response.json();\n\n    if (data.error) {\n      throw new Error(`MCP error ${data.error.code}: ${data.error.message}`);\n    }\n\n    if (!data.result) {\n      throw new Error(\"MCP response missing result\");\n    }\n\n    if (data.result.isError) {\n      const errorText = data.result.content[0]?.text || \"Unknown error\";\n      throw new Error(`MCP tool error: ${errorText}`);\n    }\n\n    // Parse the text content as JSON\n    const textContent = data.result.content[0]?.text;\n    if (!textContent) {\n      throw new Error(\"MCP response missing content\");\n    }\n\n    return JSON.parse(textContent);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,111 @@
+// src/client.ts
+var CacheBashMemory = class {
+  apiKey;
+  endpoint;
+  programId;
+  requestId = 1;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.endpoint = config.endpoint || "https://api.cachebash.dev/v1/mcp";
+    this.programId = config.programId;
+    if (!this.apiKey) {
+      throw new Error("CacheBashMemory: apiKey is required");
+    }
+    if (!this.programId) {
+      throw new Error("CacheBashMemory: programId is required");
+    }
+  }
+  /**
+   * Store a memory pattern.
+   * If a pattern with the same ID exists, it will be replaced.
+   */
+  async store(input) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const pattern = {
+      ...input,
+      discoveredAt: now,
+      lastReinforced: now,
+      promotedToStore: false,
+      stale: false
+    };
+    const result = await this.callTool("store_memory", {
+      programId: this.programId,
+      pattern
+    });
+    if (!result.success) {
+      throw new Error(`Failed to store memory: ${result.error || "Unknown error"}`);
+    }
+  }
+  /**
+   * Recall memory patterns with optional filters.
+   */
+  async recall(options) {
+    const result = await this.callTool("recall_memory", {
+      programId: this.programId,
+      domain: options?.domain,
+      query: options?.search,
+      includeStale: false
+    });
+    if (!result.success) {
+      throw new Error(`Failed to recall memory: ${result.error || "Unknown error"}`);
+    }
+    return result.patterns || [];
+  }
+  /**
+   * Get memory health statistics.
+   */
+  async health() {
+    const result = await this.callTool("memory_health", {
+      programId: this.programId
+    });
+    if (!result.success) {
+      throw new Error(`Failed to get memory health: ${result.error || "Unknown error"}`);
+    }
+    return result.health;
+  }
+  /**
+   * Call an MCP tool via HTTP transport.
+   */
+  async callTool(name, args) {
+    const request = {
+      jsonrpc: "2.0",
+      method: "tools/call",
+      params: {
+        name,
+        arguments: args
+      },
+      id: this.requestId++
+    };
+    const response = await fetch(this.endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify(request)
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (data.error) {
+      throw new Error(`MCP error ${data.error.code}: ${data.error.message}`);
+    }
+    if (!data.result) {
+      throw new Error("MCP response missing result");
+    }
+    if (data.result.isError) {
+      const errorText = data.result.content[0]?.text || "Unknown error";
+      throw new Error(`MCP tool error: ${errorText}`);
+    }
+    const textContent = data.result.content[0]?.text;
+    if (!textContent) {
+      throw new Error("MCP response missing content");
+    }
+    return JSON.parse(textContent);
+  }
+};
+export {
+  CacheBashMemory
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * CacheBashMemory — SDK client for memory pattern storage and recall.\n */\n\nimport type {\n  CacheBashMemoryConfig,\n  MemoryPattern,\n  MemoryHealth,\n  RecallOptions,\n  StorePatternInput,\n} from \"./types.js\";\n\ninterface MCPRequest {\n  jsonrpc: \"2.0\";\n  method: string;\n  params: {\n    name: string;\n    arguments: Record<string, unknown>;\n  };\n  id: number;\n}\n\ninterface MCPResponse {\n  jsonrpc: \"2.0\";\n  result?: {\n    content: Array<{ type: string; text: string }>;\n    isError?: boolean;\n  };\n  error?: {\n    code: number;\n    message: string;\n  };\n  id: number;\n}\n\nexport class CacheBashMemory {\n  private readonly apiKey: string;\n  private readonly endpoint: string;\n  private readonly programId: string;\n  private requestId = 1;\n\n  constructor(config: CacheBashMemoryConfig) {\n    this.apiKey = config.apiKey;\n    this.endpoint = config.endpoint || \"https://api.cachebash.dev/v1/mcp\";\n    this.programId = config.programId;\n\n    if (!this.apiKey) {\n      throw new Error(\"CacheBashMemory: apiKey is required\");\n    }\n    if (!this.programId) {\n      throw new Error(\"CacheBashMemory: programId is required\");\n    }\n  }\n\n  /**\n   * Store a memory pattern.\n   * If a pattern with the same ID exists, it will be replaced.\n   */\n  async store(input: StorePatternInput): Promise<void> {\n    const now = new Date().toISOString();\n    const pattern: MemoryPattern = {\n      ...input,\n      discoveredAt: now,\n      lastReinforced: now,\n      promotedToStore: false,\n      stale: false,\n    };\n\n    const result = await this.callTool(\"store_memory\", {\n      programId: this.programId,\n      pattern,\n    });\n\n    if (!result.success) {\n      throw new Error(`Failed to store memory: ${result.error || \"Unknown error\"}`);\n    }\n  }\n\n  /**\n   * Recall memory patterns with optional filters.\n   */\n  async recall(options?: RecallOptions): Promise<MemoryPattern[]> {\n    const result = await this.callTool(\"recall_memory\", {\n      programId: this.programId,\n      domain: options?.domain,\n      query: options?.search,\n      includeStale: false,\n    });\n\n    if (!result.success) {\n      throw new Error(`Failed to recall memory: ${result.error || \"Unknown error\"}`);\n    }\n\n    return result.patterns || [];\n  }\n\n  /**\n   * Get memory health statistics.\n   */\n  async health(): Promise<MemoryHealth> {\n    const result = await this.callTool(\"memory_health\", {\n      programId: this.programId,\n    });\n\n    if (!result.success) {\n      throw new Error(`Failed to get memory health: ${result.error || \"Unknown error\"}`);\n    }\n\n    return result.health;\n  }\n\n  /**\n   * Call an MCP tool via HTTP transport.\n   */\n  private async callTool(name: string, args: Record<string, unknown>): Promise<any> {\n    const request: MCPRequest = {\n      jsonrpc: \"2.0\",\n      method: \"tools/call\",\n      params: {\n        name,\n        arguments: args,\n      },\n      id: this.requestId++,\n    };\n\n    const response = await fetch(this.endpoint, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(request),\n    });\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n    }\n\n    const data: MCPResponse = await response.json();\n\n    if (data.error) {\n      throw new Error(`MCP error ${data.error.code}: ${data.error.message}`);\n    }\n\n    if (!data.result) {\n      throw new Error(\"MCP response missing result\");\n    }\n\n    if (data.result.isError) {\n      const errorText = data.result.content[0]?.text || \"Unknown error\";\n      throw new Error(`MCP tool error: ${errorText}`);\n    }\n\n    // Parse the text content as JSON\n    const textContent = data.result.content[0]?.text;\n    if (!textContent) {\n      throw new Error(\"MCP response missing content\");\n    }\n\n    return JSON.parse(textContent);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@rezzed.ai/memory",
+  "version": "0.1.0",
+  "description": "CacheBash Memory SDK — Lightweight client for memory pattern storage and recall",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rezzedai/cachebash.git",
+    "directory": "packages/memory"
+  },
+  "homepage": "https://rezzed.ai/cachebash",
+  "bugs": "https://github.com/rezzedai/cachebash/issues",
+  "keywords": [
+    "cachebash",
+    "memory",
+    "mcp",
+    "ai",
+    "agents",
+    "patterns",
+    "learned-behavior"
+  ]
+}