@supermemory/eve 0.1.1 → 0.1.3

package/README.md

@@ -9,10 +9,24 @@ gives Eve tools to search, remember, extract, and forget.
 
 ## Add memory to Eve
 
+From an Eve project, add the provider from Eve's integration registry:
+
+```bash
+eve add memory/supermemory
+```
+
+Or install it yourself:
+
 ```bash
 npm install @supermemory/eve
 ```
 
+The provider supports Eve 0.47.3 and newer 0.x releases. Set `SUPERMEMORY_API_KEY` from the
+[Supermemory console](https://console.supermemory.ai).
+
+Use Eve 0.71.3 or newer for development. Eve 0.66.1 has an upstream completed-turn capture
+regression; Eve restored automatic capture in 0.69.0.
+
 Create a memory slot in the consuming Eve agent. `supermemory(...)` configures the provider;
 `defineMemory(...)` binds it to an Eve-managed scope.
 
@@ -26,12 +40,15 @@ export default defineMemory({
   namespace: "your-company-agent-v1",
   description: "Recall and manage durable context for the current user.",
   provider: supermemory({
-    apiKey: process.env.SUPERMEMORY_API_KEY!,
+    apiKey: () => process.env.SUPERMEMORY_API_KEY!,
   }),
   scope: byPrincipal,
 });
 ```
 
+Pass `apiKey` as a function so the key is read when the agent runs, not when `eve build` loads the
+slot. A plain string also works, but then the key must be set in the build environment too.
+
 Pick a namespace for the agent and keep it stable. If it changes, Eve sees a different memory space.
 `description` is added to the tool descriptions the model sees, so keep it short and say what this
 memory is for.
@@ -120,7 +137,7 @@ export default defineMemory({
   namespace: "your-company-agent-v1",
   description: "Recall and manage durable context for the current user.",
   provider: supermemory({
-    apiKey: process.env.SUPERMEMORY_API_KEY!,
+    apiKey: () => process.env.SUPERMEMORY_API_KEY!,
     containerTagPrefix: "eve_agent",
     autoSearch: {
       enabled: true,
@@ -163,6 +180,10 @@ Install the same provider. SuperRAG handles PDFs, URLs, images, audio, video, an
 can index a source, search it later, and return to the original document when it needs more detail.
 There is no separate RAG setup.
 
+Eve 0.71.3 has an upstream serialization issue that prevents memory-provider tools from loading
+on attached-file turns. Until Eve fixes it, use `extract` with text or URL sources. File extraction
+accepts only Eve-staged paths under `/workspace/.eve/attachments/`.
+
 ## Development
 
 Requires Node.js 24 or newer.
@@ -174,3 +195,14 @@ npm run typecheck
 npm run build
 npm pack --dry-run
 ```
+
+### Publishing
+
+Pushes to `main` run the release workflow. After checks and a packaged-import smoke test pass,
+the workflow publishes the version in `package.json` if it is not already on npm. Bump the
+package version and update `package-lock.json` to ship a new release; no Git tag is required.
+Publishing uses npm trusted publishing with GitHub Actions OIDC; no `NPM_TOKEN` secret is needed.
+In the npm package's trusted publisher settings, select GitHub Actions, set the organization to
+`supermemoryai`, the repository to `eve-supermemory`, and the workflow filename to `release.yml`.
+Leave the environment name empty and allow direct `npm publish`. The release job uses a
+GitHub-hosted runner because npm trusted publishing does not support self-hosted runners.

package/dist/lib/extract-source.js

@@ -12,11 +12,11 @@ function extractionMetadata(input, ctx) {
 }
 async function sandboxAttachment(inputPath, ctx) {
     const sandbox = await ctx.getSandbox();
-    const attachmentsRoot = resolve(sandbox.resolvePath("/workspace/attachments"));
+    const attachmentsRoot = resolve(sandbox.resolvePath("/workspace/.eve/attachments"));
     const resolvedPath = resolve(sandbox.resolvePath(inputPath));
     const relativePath = relative(attachmentsRoot, resolvedPath);
     if (!relativePath || relativePath.startsWith("..") || isAbsolute(relativePath)) {
-        throw new Error("Files must come from Eve's /workspace/attachments directory.");
+        throw new Error("Files must come from Eve's /workspace/.eve/attachments directory.");
     }
     const bytes = await sandbox.readBinaryFile({
         path: resolvedPath,

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@supermemory/eve",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Durable user context, retrieval, extraction, remembering, and forgetting for Eve agents.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/supermemoryai/eve-supermemory.git"
+  },
   "type": "module",
   "files": [
     "dist"
@@ -35,11 +39,11 @@
   "devDependencies": {
     "@biomejs/biome": "2.5.7",
     "@types/node": "24.x",
-    "eve": "0.47.3",
+    "eve": "0.71.3",
     "typescript": "7.0.2"
   },
   "peerDependencies": {
-    "eve": "^0.47.3"
+    "eve": ">=0.47.3 <1"
   },
   "publishConfig": {
     "access": "public"