@supermemory/eve 0.1.2 → 0.2.0-rc.1

package/README.md

@@ -9,21 +9,33 @@ 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:
+For Eve 1.0 RC5, install the matching provider candidate once it is published:
 
 ```bash
-eve add memory/supermemory
+npm install @supermemory/eve@next eve@1.0.0-rc.5
 ```
 
-Or install it yourself:
+The candidate `@supermemory/eve@0.2.0-rc.1` targets only the `next` tag. Until that
+release is approved and published, use a local build of this branch; `next` is not
+available yet. The default npm `latest` remains `0.1.3` for Eve 0.x consumers.
+
+For an existing Eve 0.x application, keep the current provider:
 
 ```bash
-npm install @supermemory/eve
+npm install @supermemory/eve@0.1.3
 ```
 
-The provider supports Eve 0.47.3 and newer 0.x releases. Set `SUPERMEMORY_API_KEY` from the
+`eve add memory/supermemory` installs from Eve's integration registry. For the 1.0
+candidate, use the explicit `@next` installation above until the registry selects a
+compatible release; don't assume the registry command upgrades the provider channel.
+
+This source targets Eve 1.0, starting with `eve@1.0.0-rc.5`. Development pins that release
+exactly. Set `SUPERMEMORY_API_KEY` from the
 [Supermemory console](https://console.supermemory.ai).
 
+For Eve 0.x, keep using `@supermemory/eve@0.1.3`. The 1.0-compatible provider no longer
+registers the post-compaction recall hook that Eve 1.0 rejects.
+
 Create a memory slot in the consuming Eve agent. `supermemory(...)` configures the provider;
 `defineMemory(...)` binds it to an Eve-managed scope.
 
@@ -93,8 +105,9 @@ When a turn uses a Supermemory tool, retrieved material is marked as existing co
 learned again from the assistant's response.
 
 Before each turn, the provider loads the user's current Supermemory profile and automatically
-searches for context relevant to the request. Eve runs recall again after context compaction. The
-agent can still use the search and read tools when it needs broader or source-level context.
+searches for context relevant to the request. Eve 1.0 keeps recalled context outside conversation
+history, so compaction preserves it without calling a post-compaction recall hook. The agent can
+still use the search and read tools when it needs broader or source-level context.
 
 ## Agent-directed memory
 
@@ -177,6 +190,40 @@ 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.
 
+File extraction accepts only Eve-staged paths under `/workspace/.eve/attachments/`. The
+provider passes the tool cancellation signal to Eve's binary-file read and to the Supermemory
+upload. Hosted attachment turns still need an end-to-end check before release.
+
+## Upgrading an existing integration to Eve 1.0
+
+Follow [Eve's upgrade guide](https://eve.dev/docs/guides/upgrade) for your agent and deployment.
+This package is a memory provider, not an Eve extension, so it has no extension distribution
+manifest to rebuild.
+
+Keep your memory slot name, explicit namespace, trusted scope resolver, and `containerTagPrefix`
+unchanged. The provider's container derivation, session document IDs, source metadata, and
+Supermemory SDK dependency are unchanged; it does not rewrite or migrate stored documents.
+Eve's default namespace includes deployment identity, so changing the application root or
+Preview identity can still select a different partition. Preserve your existing identity rather
+than inventing a new namespace during the upgrade.
+
+The provider still uses Eve's memory lifecycle keys `turn.started` and `turn.completed`.
+These are provider callbacks, not raw v26 session-stream consumers: do not rename capture to
+`turn.settled`. Eve calls completed-turn capture only for a successfully completed turn.
+It preserves recalled messages outside history during compaction, replacing the old
+`compaction.completed` recall callback.
+
+This package stores conversation text and source documents, not raw Eve session events.
+It needs no v26-to-v27 event conversion. Applications that archive Eve events themselves must
+follow Eve's saved-history migration separately, retain their originals, and keep old deployments
+running for existing sessions as the upgrade guide requires.
+
+The release candidate is `0.2.0-rc.1`; merging this branch runs the existing release workflow
+and publishes it to `next`, not `latest`. Eve 0.x consumers stay on `0.1.3`. The `0.2.0-rc.1`
+prerelease is outside existing `^0.1.3` and `~0.1.3` ranges. Upgrading an agent to Eve 1.0 before
+installing the matching provider is unsupported. This separates the breaking runtime upgrade
+without changing stored memory or the existing stable release.
+
 ## Development
 
 Requires Node.js 24 or newer.
@@ -191,9 +238,15 @@ npm pack --dry-run
 
 ### Publishing
 
-Pushes to `main` run the release workflow. After checks and a packaged-import smoke test pass,
+Pushes to `main` run the release workflow. **Merging a version bump can publish automatically.**
+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.
+The workflow reads the npm tag from `publishConfig.tag`, permits only `next` and `latest`,
+and refuses to publish a prerelease to `latest`. The candidate sets `tag: "next"`. Keep that
+tag through RC validation; GA promotion and changing `latest` require a separate release decision.
+A local `npm publish --dry-run --tag next` checks the candidate without publishing it.
+
 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`.

package/dist/lib/extract-source.js

@@ -12,15 +12,15 @@ 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,
-        abortSignal: ctx.abortSignal,
+        signal: ctx.abortSignal,
     });
     if (!bytes) {
         throw new Error(`Attachment not found: ${inputPath}`);

package/dist/provider.js

@@ -58,7 +58,6 @@ export function supermemory(options) {
     return defineMemoryProvider({
         recall: {
             "turn.started": recall,
-            "compaction.completed": recall,
         },
         ...(config.capture.enabled
             ? {

package/dist/tools/index.d.ts

@@ -1,302 +1,3 @@
+import type { MemoryToolSet } from "eve/memory";
 import type { SupermemoryDependencies } from "../lib/dependencies.js";
-export declare function createSupermemoryTools(dependencies: SupermemoryDependencies): {
-    search: import("eve/tools").ToolDefinition<{
-        query: string;
-        scope: "all" | "conversations" | "documents" | "memories";
-        customId?: string | undefined;
-    }, import("supermemory/resources/search.mjs").SearchMemoriesResponse> & {
-        execute(input: {
-            query: string;
-            scope: "all" | "conversations" | "documents" | "memories";
-            customId?: string | undefined;
-        }, ctx: import("eve/tools").ToolContext): Promise<import("supermemory/resources/search.mjs").SearchMemoriesResponse>;
-    };
-    read_session: import("eve/tools").ToolDefinition<{
-        documentId: string;
-        offset: number;
-    }, {
-        id: string;
-        customId: string | null;
-        connectionId: string | null;
-        title: string | null;
-        type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-        status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-        taskType: "memory" | "superrag";
-        metadata: string | number | boolean | unknown[] | {
-            [key: string]: unknown;
-        } | null;
-        summary: string | null;
-        source: string | null;
-        url: string | null | undefined;
-        filepath: string | null;
-        createdAt: string;
-        updatedAt: string;
-        content: null;
-        offset: number;
-        nextOffset: null;
-        totalCharacters: number | null;
-    } | {
-        content: string;
-        offset: number;
-        nextOffset: number | null;
-        totalCharacters: number;
-        id: string;
-        customId: string | null;
-        connectionId: string | null;
-        title: string | null;
-        type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-        status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-        taskType: "memory" | "superrag";
-        metadata: string | number | boolean | unknown[] | {
-            [key: string]: unknown;
-        } | null;
-        summary: string | null;
-        source: string | null;
-        url: string | null | undefined;
-        filepath: string | null;
-        createdAt: string;
-        updatedAt: string;
-    }> & {
-        execute(input: {
-            documentId: string;
-            offset: number;
-        }, ctx: import("eve/tools").ToolContext): Promise<{
-            id: string;
-            customId: string | null;
-            connectionId: string | null;
-            title: string | null;
-            type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-            status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-            taskType: "memory" | "superrag";
-            metadata: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            summary: string | null;
-            source: string | null;
-            url: string | null | undefined;
-            filepath: string | null;
-            createdAt: string;
-            updatedAt: string;
-            content: null;
-            offset: number;
-            nextOffset: null;
-            totalCharacters: number | null;
-        } | {
-            content: string;
-            offset: number;
-            nextOffset: number | null;
-            totalCharacters: number;
-            id: string;
-            customId: string | null;
-            connectionId: string | null;
-            title: string | null;
-            type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-            status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-            taskType: "memory" | "superrag";
-            metadata: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            summary: string | null;
-            source: string | null;
-            url: string | null | undefined;
-            filepath: string | null;
-            createdAt: string;
-            updatedAt: string;
-        }>;
-    };
-    read_document: import("eve/tools").ToolDefinition<{
-        container: "agent_context" | "agent_extraction";
-        documentId: string;
-        offset: number;
-    }, {
-        id: string;
-        customId: string | null;
-        connectionId: string | null;
-        title: string | null;
-        type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-        status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-        taskType: "memory" | "superrag";
-        metadata: string | number | boolean | unknown[] | {
-            [key: string]: unknown;
-        } | null;
-        summary: string | null;
-        source: string | null;
-        url: string | null | undefined;
-        filepath: string | null;
-        createdAt: string;
-        updatedAt: string;
-        content: null;
-        offset: number;
-        nextOffset: null;
-        totalCharacters: number | null;
-    } | {
-        content: string;
-        offset: number;
-        nextOffset: number | null;
-        totalCharacters: number;
-        id: string;
-        customId: string | null;
-        connectionId: string | null;
-        title: string | null;
-        type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-        status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-        taskType: "memory" | "superrag";
-        metadata: string | number | boolean | unknown[] | {
-            [key: string]: unknown;
-        } | null;
-        summary: string | null;
-        source: string | null;
-        url: string | null | undefined;
-        filepath: string | null;
-        createdAt: string;
-        updatedAt: string;
-    }> & {
-        execute(input: {
-            container: "agent_context" | "agent_extraction";
-            documentId: string;
-            offset: number;
-        }, ctx: import("eve/tools").ToolContext): Promise<{
-            id: string;
-            customId: string | null;
-            connectionId: string | null;
-            title: string | null;
-            type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-            status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-            taskType: "memory" | "superrag";
-            metadata: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            summary: string | null;
-            source: string | null;
-            url: string | null | undefined;
-            filepath: string | null;
-            createdAt: string;
-            updatedAt: string;
-            content: null;
-            offset: number;
-            nextOffset: null;
-            totalCharacters: number | null;
-        } | {
-            content: string;
-            offset: number;
-            nextOffset: number | null;
-            totalCharacters: number;
-            id: string;
-            customId: string | null;
-            connectionId: string | null;
-            title: string | null;
-            type: "audio" | "github_markdown" | "google_doc" | "google_sheet" | "google_slide" | "image" | "notion_doc" | "onedrive" | "pdf" | "text" | "tweet" | "video" | "webpage";
-            status: "chunking" | "done" | "embedding" | "extracting" | "failed" | "indexing" | "queued" | "unknown";
-            taskType: "memory" | "superrag";
-            metadata: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            summary: string | null;
-            source: string | null;
-            url: string | null | undefined;
-            filepath: string | null;
-            createdAt: string;
-            updatedAt: string;
-        }>;
-    };
-    remember: import("eve/tools").ToolDefinition<{
-        memory: string;
-        sourceDocumentId?: string | undefined;
-    }, {
-        documentId: string;
-        status: string;
-        sourceDocumentId: string | null;
-    }> & {
-        execute(input: {
-            memory: string;
-            sourceDocumentId?: string | undefined;
-        }, ctx: import("eve/tools").ToolContext): Promise<{
-            documentId: string;
-            status: string;
-            sourceDocumentId: string | null;
-        }>;
-    };
-    extract: import("eve/tools").ToolDefinition<{
-        kind: "file" | "text" | "url";
-        value: string;
-        title?: string | undefined;
-    }, {
-        documentId: string;
-        status: string;
-    }> & {
-        execute(input: {
-            kind: "file" | "text" | "url";
-            value: string;
-            title?: string | undefined;
-        }, ctx: import("eve/tools").ToolContext): Promise<{
-            documentId: string;
-            status: string;
-        }>;
-    };
-    forget: import("eve/tools").ToolDefinition<{
-        memoryId: string;
-        reason?: string | undefined;
-    }, import("supermemory/resources/memories.mjs").MemoryForgetResponse> & {
-        execute(input: {
-            memoryId: string;
-            reason?: string | undefined;
-        }, ctx: import("eve/tools").ToolContext): Promise<import("supermemory/resources/memories.mjs").MemoryForgetResponse>;
-    };
-    forget_matching: import("eve/tools").ToolDefinition<{
-        query?: string | undefined;
-        dryRun: boolean;
-        ids?: string[] | undefined;
-        threshold?: number | undefined;
-        maxForget?: number | undefined;
-        reason?: string | undefined;
-    }, {
-        dryRun: true;
-        count: number;
-        forgetBatchId: null;
-        summary: string;
-        candidates: {
-            id: string;
-            memory: string;
-            score: number;
-        }[];
-    } | {
-        dryRun: false;
-        count: number;
-        forgetBatchId: string | null;
-        summary: string;
-        forgotten: {
-            id: string;
-            memory: string;
-            score: number;
-        }[];
-    }> & {
-        execute(input: {
-            query?: string | undefined;
-            dryRun: boolean;
-            ids?: string[] | undefined;
-            threshold?: number | undefined;
-            maxForget?: number | undefined;
-            reason?: string | undefined;
-        }, ctx: import("eve/tools").ToolContext): Promise<{
-            dryRun: true;
-            count: number;
-            forgetBatchId: null;
-            summary: string;
-            candidates: {
-                id: string;
-                memory: string;
-                score: number;
-            }[];
-        } | {
-            dryRun: false;
-            count: number;
-            forgetBatchId: string | null;
-            summary: string;
-            forgotten: {
-                id: string;
-                memory: string;
-                score: number;
-            }[];
-        }>;
-    };
-};
+export declare function createSupermemoryTools(dependencies: SupermemoryDependencies): MemoryToolSet;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermemory/eve",
-  "version": "0.1.2",
+  "version": "0.2.0-rc.1",
   "description": "Durable user context, retrieval, extraction, remembering, and forgetting for Eve agents.",
   "repository": {
     "type": "git",
@@ -39,14 +39,15 @@
   "devDependencies": {
     "@biomejs/biome": "2.5.7",
     "@types/node": "24.x",
-    "eve": "0.66.1",
+    "eve": "1.0.0-rc.5",
     "typescript": "7.0.2"
   },
   "peerDependencies": {
-    "eve": ">=0.47.3 <1"
+    "eve": "^1.0.0-rc.5"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "tag": "next"
   },
   "engines": {
     "node": ">=24"