@supermemory/eve 0.1.0

package/dist/tools/read-session.d.ts

@@ -0,0 +1,94 @@
+import type { SupermemoryDependencies } from "../lib/dependencies.js";
+export declare function createReadSessionTool(dependencies: SupermemoryDependencies): 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;
+    }>;
+};

package/dist/tools/read-session.js

@@ -0,0 +1,25 @@
+import { defineTool } from "eve/tools";
+import { z } from "zod";
+import { readStoredDocument } from "../lib/documents.js";
+export function createReadSessionTool(dependencies) {
+    return defineTool({
+        description: "Read a previous agent conversation/session. Use after search returns a conversation result whenever answering the user requires the surrounding exchange, what the user or assistant actually said, the sequence of decisions, or exact earlier wording. Pass the exact results[].documents[].id whose metadata.source_type is conversation and start with offset 0. Continue with the returned nextOffset whenever more of that session is needed.",
+        inputSchema: z.object({
+            documentId: z
+                .string()
+                .trim()
+                .min(1)
+                .max(200)
+                .describe("The exact results[].documents[].id for a source whose metadata.source_type is conversation."),
+            offset: z
+                .number()
+                .int()
+                .nonnegative()
+                .default(0)
+                .describe("The exact nextOffset returned by the previous read, or zero."),
+        }),
+        execute({ documentId, offset }, ctx) {
+            return readStoredDocument(documentId, offset, "agent_context", ctx, dependencies);
+        },
+    });
+}

package/dist/tools/remember.d.ts

@@ -0,0 +1,18 @@
+import type { SupermemoryDependencies } from "../lib/dependencies.js";
+export declare function createRememberTool(dependencies: SupermemoryDependencies): 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;
+    }>;
+};

package/dist/tools/remember.js

@@ -0,0 +1,26 @@
+import { defineTool } from "eve/tools";
+import { z } from "zod";
+import { rememberContext } from "../lib/remember.js";
+export function createRememberTool(dependencies) {
+    return defineTool({
+        description: "Decide whether the current conversation contains context worth carrying into future sessions, and save it when appropriate. Use when the user says remember this, save this, keep this for later, don't forget, from now on, always, never, stop doing this, or next time; corrects behavior they expect changed in future interactions; expresses frustration such as why do you keep doing this when the surrounding conversation reveals a reusable correction; or shares or corrects durable personal information, identity, relationships, preferences, boundaries, goals, commitments, decisions, or ongoing project context. Compose one concise standalone memory grounded in what the user said or confirmed. For identity or relationships, preserve the entity, relationship, and stable detail. For a preference, constraint, or correction, preserve the desired behavior, its scope or trigger, and any boundary. For a decision or commitment, preserve the context, settled choice, and relevant condition. For project state, preserve the objective, current state, decisions, constraints or blockers, and concrete next actions. When frustration reveals the instruction, save the reusable behavior change rather than the temporary emotion. When the memory comes from an extracted source, include its exact sourceDocumentId.",
+        inputSchema: z.object({
+            memory: z
+                .string()
+                .trim()
+                .min(1)
+                .max(3_000)
+                .refine((memory) => memory.split(/\s+/u).length <= 180, "Memory must be 180 words or fewer.")
+                .describe("One dense standalone memory. Include the relevant subject and scope: a short identity fact, a scoped preference or correction, a decision with its condition, or project state with constraints and next actions."),
+            sourceDocumentId: z
+                .string()
+                .trim()
+                .max(200)
+                .optional()
+                .describe("Only when the memory was synthesized from an extracted source: its exact extraction document ID. Omit for ordinary conversation memories."),
+        }),
+        execute(input, ctx) {
+            return rememberContext(input, ctx, dependencies);
+        },
+    });
+}

package/dist/tools/search.d.ts

@@ -0,0 +1,12 @@
+import type { SupermemoryDependencies } from "../lib/dependencies.js";
+export declare function createSearchTool(dependencies: SupermemoryDependencies): 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>;
+};

package/dist/tools/search.js

@@ -0,0 +1,29 @@
+import { defineTool } from "eve/tools";
+import { z } from "zod";
+import { SEARCH_SCOPES, searchStoredContext } from "../lib/search-context.js";
+export function createSearchTool(dependencies) {
+    return defineTool({
+        description: "Search saved memory/context and previous user conversation/session. Use whenever answering the user or carrying out their request could benefit from something they shared, preferred, decided, discussed, or worked on before. For example, before ordering food, search for what they like; before doing a task, search for relevant preferences, decisions, or prior work. Also use when the user asks what you know about them, about a memory or earlier conversation, or about a stored document. Results are summaries; use read_session or read_document when the underlying context is needed.",
+        inputSchema: z.object({
+            query: z
+                .string()
+                .trim()
+                .min(1)
+                .max(2_000)
+                .describe("A standalone natural-language retrieval query with one retrieval intent."),
+            scope: z
+                .enum(SEARCH_SCOPES)
+                .default("all")
+                .describe("Use memories for durable facts and decisions, conversations for previous agent sessions, documents for stored source wording, or all when the storage form is mixed or unclear."),
+            customId: z
+                .string()
+                .trim()
+                .max(200)
+                .optional()
+                .describe("Only for a follow-up within a known source: the exact results[].documents[].metadata.source_id from an earlier search result."),
+        }),
+        execute(input, ctx) {
+            return searchStoredContext(input, { signal: ctx.abortSignal }, dependencies);
+        },
+    });
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@supermemory/eve",
+  "version": "0.1.0",
+  "description": "Durable user context, retrieval, extraction, remembering, and forgetting for Eve agents.",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "agents",
+    "eve",
+    "memory",
+    "supermemory"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "prebuild": "npm run clean",
+    "build": "tsc -p tsconfig.build.json",
+    "check": "biome ci src",
+    "format": "biome format --write src",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "supermemory": "^4.25.4",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.7",
+    "@types/node": "24.x",
+    "eve": "0.47.3",
+    "typescript": "7.0.2"
+  },
+  "peerDependencies": {
+    "eve": "^0.47.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}