@pyxmate/memory 0.5.3 → 0.5.5

package/dist/{chunk-AXTWVLDO.mjs → chunk-A3W2OUCH.mjs}

@@ -1,6 +1,6 @@
 import {
   MemoryClient
-} from "./chunk-YL5QMN6G.mjs";
+} from "./chunk-RDQIIYAV.mjs";
 
 // ../dashboard/src/aggregations/consolidation-analytics.ts
 function analyzeConsolidationLog(entries) {

package/dist/{chunk-YL5QMN6G.mjs → chunk-RDQIIYAV.mjs}

@@ -171,6 +171,25 @@ var MemoryClient = class {
     }
     return result;
   }
+  /**
+   * Get the download URL for an uploaded file.
+   * Returns a URL that serves the original file binary with proper Content-Type.
+   */
+  getFileDownloadUrl(filename) {
+    return `${this.baseUrl}/api/memory/files/download/${encodeURIComponent(filename)}`;
+  }
+  /**
+   * Download an uploaded file by filename.
+   * Returns the raw Response (caller handles the body — arrayBuffer, blob, stream, etc.).
+   */
+  async downloadFile(filename) {
+    const url = this.getFileDownloadUrl(filename);
+    const res = await fetch(url, { headers: this._authHeaders });
+    if (!res.ok) {
+      throw new MemoryServerError(`File download failed: ${res.status}`, res.status);
+    }
+    return res;
+  }
   /** @deprecated Use {@link list} instead. Kept for backwards compatibility. */
   async listEntries(params) {
     const result = await this.list(params);

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-AXTWVLDO.mjs";
-import "./chunk-YL5QMN6G.mjs";
+} from "./chunk-A3W2OUCH.mjs";
+import "./chunk-RDQIIYAV.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/index.d.ts

@@ -108,6 +108,16 @@ declare class MemoryClient implements ExtendedMemoryInterface {
         description?: string;
         enrichment?: EnrichmentCallbacks;
     }): Promise<FileIngestResult>;
+    /**
+     * Get the download URL for an uploaded file.
+     * Returns a URL that serves the original file binary with proper Content-Type.
+     */
+    getFileDownloadUrl(filename: string): string;
+    /**
+     * Download an uploaded file by filename.
+     * Returns the raw Response (caller handles the body — arrayBuffer, blob, stream, etc.).
+     */
+    downloadFile(filename: string): Promise<Response>;
     /** @deprecated Use {@link list} instead. Kept for backwards compatibility. */
     listEntries(params?: {
         page?: number;

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-YL5QMN6G.mjs";
+} from "./chunk-RDQIIYAV.mjs";
 
 // ../shared/src/constants/defaults.ts
 var DEFAULTS = {

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-AXTWVLDO.mjs";
-import "./chunk-YL5QMN6G.mjs";
+} from "./chunk-A3W2OUCH.mjs";
+import "./chunk-RDQIIYAV.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
 import { useCallback as useCallback2, useMemo } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyxmate/memory",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",

package/skills/pyx-memory/reference/http-api.md

@@ -18,7 +18,7 @@ Destructive operations (DELETE, forget, decay, consolidate, reindex) require `AD
 const client = new MemoryClient('http://localhost:7822', process.env.MEMORY_API_KEY);
 ```
 
-## Core (12 endpoints)
+## Core (13 endpoints)
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
@@ -26,6 +26,7 @@ const client = new MemoryClient('http://localhost:7822', process.env.MEMORY_API_
 | GET | `/admin/health` | Admin health check (version, uptime, embedding provider, memory stats) |
 | POST | `/api/memory/ingest` | Store a memory (JSON: `{ content, type, metadata, agentId?, sessionId?, targets?, entities?, relationships?, importance?, source?, eventTime?, id?, parentId?, ingestTime? }`) |
 | POST | `/api/memory/ingest/file` | Upload file (multipart, 50MB limit). For PDFs with images, returns an `enrichment` block with HMAC token and image metadata for two-phase enrichment. |
+| GET | `/api/memory/files/download/:filename` | Download uploaded file binary by filename. Returns the original file with proper Content-Type. Images served inline, documents as attachment. |
 | GET | `/api/memory/files/:fileId/images/:imageId?token=...` | Fetch an extracted PDF image (binary). Requires HMAC token from ingest response. |
 | POST | `/api/memory/files/:fileId/enrich` | Submit image descriptions + entities after LLM vision processing. Requires `X-Enrichment-Token` header. |
 | GET | `/api/memory/search?query=...&strategy=...&limit=...` | Search memories — **does NOT support** filters, enableHyDE, enableRerank |
@@ -125,6 +126,35 @@ await memory.ingestFile(pdfFile, {
 });
 ```
 
+## File Downloads
+
+`GET /api/memory/files/download/:filename` serves uploaded file binaries.
+
+- **Images** (`image/*`): served inline (`Content-Disposition: inline`)
+- **Documents**: served as attachment (`Content-Disposition: attachment; filename="..."`)
+- **Caching**: `Cache-Control: public, max-age=86400, immutable`
+- **Auth**: standard API key auth (same as other endpoints)
+- **Security**: path traversal prevention, extension validation against ingestion allowlist
+
+### Example: download a file
+
+```bash
+curl -o report.pdf "{{ENDPOINT}}/api/memory/files/download/report.pdf" \
+  -H "Authorization: Bearer {{API_KEY}}"
+```
+
+### SDK usage
+
+```typescript
+// Get download URL (useful for markdown images, browser rendering)
+const url = memory.getFileDownloadUrl('screenshot.png');
+// → 'http://localhost:7822/api/memory/files/download/screenshot.png'
+
+// Download file binary
+const response = await memory.downloadFile('report.pdf');
+const buffer = await response.arrayBuffer();
+```
+
 ## Two-Phase PDF Enrichment
 
 When a PDF contains extractable images, the server returns an `enrichment` block from `POST /api/memory/ingest/file`. The SDK wraps the full three-phase flow into a single `ingestFile()` call with `EnrichmentCallbacks`.