@pyxmate/memory 0.2.11-beta → 0.2.13-beta

package/dist/{chunk-265LTIGS.mjs → chunk-FEOGTCSW.mjs}

@@ -94,9 +94,12 @@ var MemoryClient = class {
     return this.fetchApi(`/api/memory/entries${qs ? `?${qs}` : ""}`);
   }
   // --- Additional endpoints ---
-  async ingestFile(file) {
+  async ingestFile(file, options) {
     const formData = new FormData();
     formData.append("file", file);
+    if (options?.description) {
+      formData.append("description", options.description);
+    }
     const res = await fetch(`${this.baseUrl}/api/memory/ingest/file`, {
       method: "POST",
       body: formData,

package/dist/{chunk-TUTB4CH5.mjs → chunk-L62JXWDM.mjs}

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

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-TUTB4CH5.mjs";
-import "./chunk-265LTIGS.mjs";
+} from "./chunk-L62JXWDM.mjs";
+import "./chunk-FEOGTCSW.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/index.d.ts

@@ -95,7 +95,9 @@ declare class MemoryClient implements ExtendedMemoryInterface {
     stats(): Promise<MemoryStats$1>;
     shutdown(): Promise<void>;
     list(params?: MemoryListParams): Promise<MemoryListResult>;
-    ingestFile(file: File): Promise<IngestionResult>;
+    ingestFile(file: File, options?: {
+        description?: string;
+    }): Promise<IngestionResult>;
     /** @deprecated Use {@link list} instead. Kept for backwards compatibility. */
     listEntries(params?: {
         page?: number;
@@ -305,6 +307,8 @@ interface MemoryStats {
     recentAccessCount: number;
     graphNodeCount?: number;
     graphEdgeCount?: number;
+    /** Name of the active graph store ('neo4j', 'sqlite', or undefined if none). */
+    graphStore?: string;
     /** Whether the memory service is connected. False when using DisabledMemory. */
     connected?: boolean;
 }

package/dist/index.mjs

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

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-TUTB4CH5.mjs";
-import "./chunk-265LTIGS.mjs";
+} from "./chunk-L62JXWDM.mjs";
+import "./chunk-FEOGTCSW.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.2.11-beta",
+  "version": "0.2.13-beta",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",
@@ -16,7 +16,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/fysoul17/pyx-memory.git",
+    "url": "https://github.com/pyx-corp/pyx-memory-v1.git",
     "directory": "packages/sdk"
   },
   "exports": {

package/skills/pyx-memory/SKILL.md

@@ -3,12 +3,16 @@ name: pyx-memory
 description: >
   Persistent memory system for AI agents. Use this skill to store and retrieve
   knowledge across conversations via pyx-memory. Triggers whenever you need to
-  remember something, recall prior context, store a decision or bug fix, or
-  search for what was discussed before. Also use when integrating the pyx-memory
-  SDK into code, working with MemoryClient, or using the HTTP API.
+  remember something, recall prior context, store a decision or bug fix, ingest
+  files or images, or search for what was discussed before. Also use when
+  integrating the pyx-memory SDK into code, working with MemoryClient, or using
+  the HTTP API.
   Triggers on: 'remember', 'recall', 'store memory', 'search memory',
+  'ingest file', 'store this image', 'remember this document',
   'what did we decide', 'pyx-memory', 'memory', 'MemoryClient',
   'integrate memory', 'memory consolidation'.
+allowed-tools: Read, Grep, Glob, Bash(curl *)
+argument-hint: "[store|search|ingest] <content or query>"
 ---
 
 # pyx-memory — Agent Memory System
@@ -56,6 +60,27 @@ curl -s "{{ENDPOINT}}/api/memory/search?q=QUERY&limit=5" \
   -H "Authorization: Bearer {{API_KEY}}"
 ```
 
+## Ingest files & images: when a file is worth remembering
+
+Upload files directly when the content is worth persisting — diagrams, screenshots, documents, data files.
+
+- **User shares a document or image** and says "remember this" or "store this" → ingest it
+- **A screenshot captures important context** (error screen, architecture diagram, UI state) → ingest with a description
+- **A document contains reference material** (spec, config, report) → ingest it
+
+```bash
+curl -s -X POST {{ENDPOINT}}/api/memory/ingest/file \
+  -H "Authorization: Bearer {{API_KEY}}" \
+  -F "file=@path/to/file" \
+  -F "description=What this file contains or shows"
+```
+
+Supported formats: txt, md, csv, pdf, docx, json, jsonl, html, png, jpg, jpeg, webp, gif, bmp, tiff, svg (50MB limit).
+
+**Images require a `description`** — this is how the content gets embedded and becomes searchable. Without it, the image is stored but not findable. Use your vision capabilities to generate the description when the user doesn't provide one.
+
+**Documents don't need a `description`** — text content is extracted and chunked automatically.
+
 ## Rules
 
 - Always include `topic` and `project` in metadata

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

@@ -23,7 +23,7 @@ const client = new MemoryClient('http://localhost:7822', process.env.MEMORY_API_
 | GET | `/health` | Public health check (status only — no internals exposed) |
 | 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) |
+| POST | `/api/memory/ingest/file` | Upload file (multipart, 50MB limit). Supports optional `description` field for agent-provided image descriptions (via LLM vision). Formats: txt, md, csv, pdf, docx, json, jsonl, html, png, jpg, jpeg, webp, gif, bmp, tiff, svg |
 | GET | `/api/memory/search?query=...&strategy=...&limit=...` | Search memories — **does NOT support** filters, enableHyDE, enableRerank |
 | GET | `/api/memory/stats` | Memory statistics |
 | GET | `/api/memory/entries?page=...&limit=...` | List entries (paginated) |