@supermemory/eve 0.1.0 → 0.1.2

package/README.md

@@ -9,10 +9,21 @@ 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).
+
 Create a memory slot in the consuming Eve agent. `supermemory(...)` configures the provider;
 `defineMemory(...)` binds it to an Eve-managed scope.
 
@@ -26,12 +37,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 +134,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,
@@ -174,3 +188,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/index.d.ts

@@ -1,2 +1,2 @@
-export type { SupermemoryOptions } from "./options.js";
+export type { SupermemoryApiKey, SupermemoryOptions } from "./options.js";
 export { supermemory as default, supermemory } from "./provider.js";

package/dist/lib/capture-conversation.js

@@ -37,7 +37,8 @@ export async function captureCompletedTurn(context, dependencies, capture) {
     const entityContext = entityContextForTurn(turn, capture.entityContext);
     const sourceId = `conv_${context.session.id}`;
     try {
-        await addDocument(dependencies.client, {
+        const client = await dependencies.getClient();
+        await addDocument(client, {
             containerTag: dependencies.containerTags.context,
             content,
             customId: sourceId,

package/dist/lib/client.d.ts

@@ -1,2 +1,3 @@
 import Supermemory from "supermemory";
-export declare function createSupermemoryClient(apiKey: string): Supermemory;
+import type { SupermemoryApiKey } from "../options.js";
+export declare function createSupermemoryClientFactory(apiKey: SupermemoryApiKey): () => Promise<Supermemory>;

package/dist/lib/client.js

@@ -1,4 +1,15 @@
 import Supermemory from "supermemory";
-export function createSupermemoryClient(apiKey) {
-    return new Supermemory({ apiKey });
+export function createSupermemoryClientFactory(apiKey) {
+    if (typeof apiKey === "string") {
+        const client = new Supermemory({ apiKey });
+        return async () => client;
+    }
+    const resolveApiKey = apiKey;
+    return async () => {
+        const resolvedApiKey = await resolveApiKey();
+        if (!resolvedApiKey) {
+            throw new Error("The Supermemory API key resolver returned an empty value.");
+        }
+        return new Supermemory({ apiKey: resolvedApiKey });
+    };
 }

package/dist/lib/dependencies.d.ts

@@ -1,6 +1,6 @@
 import type Supermemory from "supermemory";
 import type { ContainerTags } from "./container-tags.js";
 export interface SupermemoryDependencies {
-    readonly client: Supermemory;
+    readonly getClient: () => Promise<Supermemory>;
     readonly containerTags: ContainerTags;
 }

package/dist/lib/documents.js

@@ -31,7 +31,8 @@ export async function readStoredDocument(documentId, offset, container, ctx, dep
     const containerTag = container === "agent_extraction"
         ? dependencies.containerTags.extraction
         : dependencies.containerTags.context;
-    const document = await accessibleDocument(dependencies.client, documentId, containerTag, ctx.abortSignal);
+    const client = await dependencies.getClient();
+    const document = await accessibleDocument(client, documentId, containerTag, ctx.abortSignal);
     const details = {
         id: document.id,
         customId: document.customId,

package/dist/lib/extract-source.js

@@ -31,7 +31,8 @@ async function sandboxAttachment(inputPath, ctx) {
     };
 }
 export async function extractSource(input, ctx, dependencies) {
-    const { client, containerTags } = dependencies;
+    const client = await dependencies.getClient();
+    const { containerTags } = dependencies;
     const metadata = extractionMetadata(input, ctx);
     if (input.kind === "file") {
         const { file, filepath } = await sandboxAttachment(input.value, ctx);

package/dist/lib/forget-matching.js

@@ -28,7 +28,8 @@ export async function forgetMatchingMemories(input, ctx, dependencies) {
     if (!input.dryRun && !input.ids?.length) {
         throw new Error("Finalizing requires the exact candidate IDs returned by a dry-run preview.");
     }
-    return forgetMatchingResponseSchema.parse(await dependencies.client.post("/v4/memories/forget-matching", {
+    const client = await dependencies.getClient();
+    return forgetMatchingResponseSchema.parse(await client.post("/v4/memories/forget-matching", {
         body: {
             ...(query ? { query } : {}),
             containerTag: dependencies.containerTags.context,

package/dist/lib/forget-memory.d.ts

@@ -4,4 +4,4 @@ export type ForgetMemoryInput = {
     memoryId: string;
     reason?: string;
 };
-export declare function forgetMemory(input: ForgetMemoryInput, ctx: ToolContext, dependencies: SupermemoryDependencies): import("supermemory").APIPromise<import("supermemory/resources/memories.mjs").MemoryForgetResponse>;
+export declare function forgetMemory(input: ForgetMemoryInput, ctx: ToolContext, dependencies: SupermemoryDependencies): Promise<import("supermemory/resources/memories.mjs").MemoryForgetResponse>;

package/dist/lib/forget-memory.js

@@ -1,5 +1,6 @@
-export function forgetMemory(input, ctx, dependencies) {
-    return dependencies.client.memories.forget({
+export async function forgetMemory(input, ctx, dependencies) {
+    const client = await dependencies.getClient();
+    return client.memories.forget({
         containerTag: dependencies.containerTags.context,
         id: input.memoryId,
         ...(input.reason ? { reason: input.reason } : {}),

package/dist/lib/remember.js

@@ -5,14 +5,15 @@ export async function rememberContext(input, ctx, dependencies) {
     const conversationId = `conv_${ctx.session.id}`;
     const requestedSourceDocumentId = input.sourceDocumentId?.trim();
     let sourceDocumentId;
+    const client = await dependencies.getClient();
     if (requestedSourceDocumentId) {
-        const source = await accessibleDocument(dependencies.client, requestedSourceDocumentId, dependencies.containerTags.extraction, ctx.abortSignal);
+        const source = await accessibleDocument(client, requestedSourceDocumentId, dependencies.containerTags.extraction, ctx.abortSignal);
         if (source.status !== "done") {
             throw new Error("The source document is still processing. Read it again before remembering its contents.");
         }
         sourceDocumentId = source.id;
     }
-    const result = await addDocument(dependencies.client, {
+    const result = await addDocument(client, {
         containerTag: dependencies.containerTags.context,
         content: input.memory,
         customId: sourceId,

package/dist/lib/search-context.js

@@ -13,7 +13,8 @@ export async function searchStoredContext(input, options, dependencies) {
     if (input.customId) {
         filters.push({ key: "source_id", value: input.customId });
     }
-    return dependencies.client.search({
+    const client = await dependencies.getClient();
+    return client.search({
         q: input.query,
         containerTag: dependencies.containerTags.context,
         searchMode: SEARCH_MODE_BY_SCOPE[input.scope],

package/dist/options.d.ts

@@ -1,6 +1,7 @@
+export type SupermemoryApiKey = string | (() => string | Promise<string>);
 export type SupermemoryMetadataValue = string | number | boolean | readonly string[];
 export interface SupermemoryOptions {
-    readonly apiKey: string;
+    readonly apiKey: SupermemoryApiKey;
     readonly containerTagPrefix?: string;
     readonly autoSearch?: {
         readonly enabled?: boolean;
@@ -17,7 +18,7 @@ export interface SupermemoryOptions {
     };
 }
 export interface SupermemoryConfig {
-    readonly apiKey: string;
+    readonly apiKey: SupermemoryApiKey;
     readonly containerTagPrefix: string;
     readonly autoSearch: {
         readonly enabled: boolean;

package/dist/options.js

@@ -1,5 +1,9 @@
 import { z } from "zod";
 const metadataValue = z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]);
+const apiKey = z.union([
+    z.string().min(1),
+    z.custom((value) => typeof value === "function"),
+]);
 function isTimeZone(value) {
     try {
         new Intl.DateTimeFormat("en-US", { timeZone: value });
@@ -10,7 +14,7 @@ function isTimeZone(value) {
     }
 }
 const optionsSchema = z.object({
-    apiKey: z.string().min(1),
+    apiKey,
     containerTagPrefix: z
         .string()
         .min(1)

package/dist/provider.js

@@ -1,7 +1,7 @@
 import { defineMemoryProvider, } from "eve/memory";
 import { EMPTY_AUTO_SEARCH_CONTEXT, loadAutoSearchContext } from "./lib/auto-search.js";
 import { captureCompletedTurn } from "./lib/capture-conversation.js";
-import { createSupermemoryClient } from "./lib/client.js";
+import { createSupermemoryClientFactory } from "./lib/client.js";
 import { resolveContainerTags } from "./lib/container-tags.js";
 import { loadProfileContext } from "./lib/profile-context.js";
 import { resolveOptions } from "./options.js";
@@ -13,18 +13,19 @@ function errorMessage(error) {
 }
 export function supermemory(options) {
     const config = resolveOptions(options);
-    const client = createSupermemoryClient(config.apiKey);
+    const getClient = createSupermemoryClientFactory(config.apiKey);
     const dependencies = (scopeKey) => ({
-        client,
+        getClient,
         containerTags: resolveContainerTags(scopeKey, config.containerTagPrefix),
     });
     const recall = async (context) => {
         const messages = [];
         try {
+            const memory = dependencies(context.memory.scope.key);
             const content = await loadProfileContext({
                 abortSignal: context.abortSignal,
-                client,
-                containerTag: dependencies(context.memory.scope.key).containerTags.context,
+                client: await memory.getClient(),
+                containerTag: memory.containerTags.context,
                 timeZone: config.profileContext.timeZone,
             });
             messages.push({ content, id: PROFILE_CONTEXT_ID });

package/dist/tools/forget.d.ts

@@ -6,5 +6,5 @@ export declare function createForgetTool(dependencies: SupermemoryDependencies):
     execute(input: {
         memoryId: string;
         reason?: string | undefined;
-    }, ctx: import("eve/tools").ToolContext): import("supermemory").APIPromise<import("supermemory/resources/memories.mjs").MemoryForgetResponse>;
+    }, ctx: import("eve/tools").ToolContext): Promise<import("supermemory/resources/memories.mjs").MemoryForgetResponse>;
 };

package/dist/tools/index.d.ts

@@ -240,7 +240,7 @@ export declare function createSupermemoryTools(dependencies: SupermemoryDependen
         execute(input: {
             memoryId: string;
             reason?: string | undefined;
-        }, ctx: import("eve/tools").ToolContext): import("supermemory").APIPromise<import("supermemory/resources/memories.mjs").MemoryForgetResponse>;
+        }, ctx: import("eve/tools").ToolContext): Promise<import("supermemory/resources/memories.mjs").MemoryForgetResponse>;
     };
     forget_matching: import("eve/tools").ToolDefinition<{
         query?: string | undefined;

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@supermemory/eve",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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.66.1",
     "typescript": "7.0.2"
   },
   "peerDependencies": {
-    "eve": "^0.47.3"
+    "eve": ">=0.47.3 <1"
   },
   "publishConfig": {
     "access": "public"