@ephemushroom/opencode-claude-mem 0.6.2 → 0.7.1

package/dist/worker-client.d.ts

@@ -2,101 +2,56 @@ export interface WorkerEndpoint {
     readonly host: string;
     readonly port: number;
 }
-export type AutoStartResult = 'already-running' | 'started' | 'no-bun' | 'spawn-failed' | 'timeout' | 'skipped';
-export type SearchOrder = 'date_desc' | 'date_asc' | 'relevance';
-export interface SearchOptions {
-    readonly query?: string;
-    readonly limit?: number;
-    readonly project?: string;
-    readonly platformSource?: string;
-    readonly type?: string;
-    readonly obs_type?: string;
-    readonly dateStart?: string;
-    readonly dateEnd?: string;
-    readonly offset?: number;
-    readonly orderBy?: SearchOrder;
+export interface ProjectCounts {
+    readonly observations: number;
+    readonly summaries: number;
+    readonly sessions: number;
 }
-export interface ObservedMetadata {
-    readonly observedModel?: string;
-    readonly observedBilling?: string;
-}
-export declare function parseWorkerEndpoint(env: Record<string, string | undefined>, rawSettings: string | null): WorkerEndpoint;
-export declare function buildSearchParams(options: SearchOptions): URLSearchParams;
+type JsonRecord = Record<string, unknown>;
+export declare function isRecord(value: unknown): value is JsonRecord;
+/** claude-mem's data directory, which holds its settings.json: the environment, else ~/.claude-mem. */
+export declare function dataDirectory(env: Record<string, string | undefined>, home: string): string;
+/**
+ * The port a Worker uses when none is configured: 37700 plus the user id's last two
+ * digits, or on Windows (no user id) a number derived from the data directory.
+ */
+export declare function defaultWorkerPort(dataDir: string, platform?: NodeJS.Platform, uid?: number | null): number;
+export declare function parseWorkerEndpoint(env: Record<string, string | undefined>, rawSettings: string | null, fallbackPort?: number): WorkerEndpoint;
+/** True for this machine: localhost, *.localhost, ::1 and 127.0.0.0/8. */
+export declare function isLoopbackHost(host: string): boolean;
+/** An IPv6 host needs brackets inside a URL. */
+export declare function workerUrl(endpoint: WorkerEndpoint): string;
+/**
+ * The header a Worker with `CLAUDE_MEM_LOCAL_API_TOKEN` requires on everything but its
+ * health check. The token is read from the settings file only, and is sent only to a
+ * Worker on this machine.
+ */
+export declare function tokenHeaders(baseUrl: string, rawSettings: string | null): Record<string, string>;
+/**
+ * The Worker's SQLite database: CLAUDE_MEM_DATA_DIR from env, then settings, then
+ * ~/.claude-mem. Null when the Worker is not on this machine, because a local file would
+ * then describe a different store.
+ */
+export declare function resolveDatabasePath(env: Record<string, string | undefined>, rawSettings: string | null, home: string): string | null;
+/** Read-only per-project counts; null on a missing, locked or unexpected database. */
+export declare function readProjectCounts(path: string, project: string): Promise<ProjectCounts | null>;
+/** A claude-mem setting: the environment first, then the data directory's settings.json. */
+export declare function readWorkerSetting(key: string): string | null;
+export declare function getWorkerEndpoint(): WorkerEndpoint;
 export declare function getWorkerBaseUrl(): string;
+/** Headers for a request to `baseUrl`: the local token when that Worker needs one. */
+export declare function workerHeaders(baseUrl?: string): Record<string, string>;
 export declare class WorkerClient {
     private static readonly BASE_URL;
-    /** Per-process guard so multiple OpenCode windows don't all spawn workers. */
-    private static autoStartPromise;
-    /**
-     * Check if the worker is healthy
-     */
-    static isHealthy(): Promise<boolean>;
-    /**
-     * Ensure the worker is running. If healthy, returns true. Otherwise tries
-     * to spawn it via `bunx claude-mem start` in the background and resolves
-     * once the worker reports healthy or the timeout is reached.
-     *
-     * Idempotent + serialised within the process via `autoStartPromise`.
-     */
-    static ensureRunning(): Promise<boolean>;
-    /**
-     * Try to auto-start the Claude-Mem worker via `bunx claude-mem start`.
-     *
-     * Behaviour:
-     * - If the worker is already healthy, returns 'already-running' immediately.
-     * - If `bun` is not on PATH, returns 'no-bun' without attempting to spawn.
-     * - Otherwise spawns a detached `bunx claude-mem start` process and polls
-     *   /api/health for ~8 seconds. Returns 'started' on success, 'timeout' on
-     *   failure to come up, 'spawn-failed' if the spawn itself errored.
-     *
-     * Concurrent calls share the same in-flight promise.
-     */
-    static tryAutoStart(): Promise<AutoStartResult>;
-    private static runAutoStart;
-    /**
-     * Locate the `bun` executable. Prefers Bun's own runtime detector when the
-     * plugin is loaded inside Bun (which OpenCode currently is), then falls back
-     * to PATH probing via `process.env.PATH`.
-     */
-    private static findBun;
-    /**
-     * Initialize a session
-     */
-    static sessionInit(contentSessionId: string, project: string, prompt: string): Promise<{
-        sessionDbId: number;
-        promptNumber: number;
-        skipped?: boolean;
-        reason?: string;
-    } | null>;
-    /**
-     * Send observation
-     */
-    static sendObservation(contentSessionId: string, toolName: string, toolInput: unknown, toolResponse: unknown, cwd: string, toolUseId?: string): Promise<boolean>;
+    private static readonly SUPPORTED;
+    private static readonly DATABASE_PATH;
+    private static get;
     /**
-     * Trigger summarization
+     * Per-project counts, read from the Worker's database in read-only mode. The Worker's
+     * HTTP API only reports global totals. Null when the database is remote, missing,
+     * locked or of an unknown schema; the sidebar then falls back to the global totals.
      */
-    static summarize(contentSessionId: string, lastUserMessage: string, lastAssistantMessage: string, metadata?: ObservedMetadata): Promise<boolean>;
-    /**
-     * Get pre-formatted context for system prompt injection.
-     * Uses /api/context/inject which returns rich markdown with observations + session summaries.
-     */
-    static getContext(project: string): Promise<string | null>;
-    /**
-     * Timeline: get chronological context around an observation anchor or query.
-     * Mirrors the upstream MCP `timeline` tool (GET /api/timeline).
-     */
-    static timeline(options: {
-        project: string;
-        anchor?: number;
-        query?: string;
-        depthBefore?: number;
-        depthAfter?: number;
-    }): Promise<string>;
-    /**
-     * Fetch full observation details by IDs.
-     * Mirrors the upstream MCP `get_observations` tool (POST /api/observations/batch).
-     */
-    static getObservations(ids: number[], project?: string): Promise<string>;
+    static getProjectCounts(project: string): Promise<ProjectCounts | null>;
     /**
      * Fetch worker + database stats plus processing status for the sidebar view.
      * Combines GET /api/stats and GET /api/processing-status; null when offline.
@@ -118,6 +73,7 @@ export declare class WorkerClient {
     static getRecentSummaries(project: string, limit: number): Promise<{
         id: number;
         request: string;
+        at: number | null;
     }[]>;
     /**
      * Recent observations for the sidebar (GET /api/observations).
@@ -126,6 +82,12 @@ export declare class WorkerClient {
         id: number;
         type: string;
         title: string;
+        at: number | null;
     }[]>;
-    static search(options: SearchOptions): Promise<string>;
+    /**
+     * One observation (GET /api/observation/:id) or session summary (GET /api/session/:id)
+     * for the detail dialog; null when missing or offline.
+     */
+    static getDetail(kind: 'summary' | 'observation', id: number): Promise<Record<string, unknown> | null>;
 }
+export {};

package/dist/worker-start.d.ts

@@ -0,0 +1,46 @@
+export type WorkerState = 
+/** `version` is null when the Worker answered without a readable version. */
+{
+    readonly status: 'running';
+    readonly version: string | null;
+}
+/** No launcher: claude-mem is not installed on this machine. */
+ | {
+    readonly status: 'missing';
+}
+/** Not running, and this machine is told not to start it (or it runs elsewhere). */
+ | {
+    readonly status: 'disabled';
+}
+/** The launcher ran, and the port still does not answer. */
+ | {
+    readonly status: 'failed';
+};
+export interface WorkerStartDeps {
+    /** Null only when the connection was refused, meaning no Worker holds the port. */
+    readonly probe: () => Promise<{
+        version: string | null;
+    } | null>;
+    readonly disabled: () => boolean;
+    readonly launcher: () => string | null;
+    /** Resolves false when the launcher could not be spawned. */
+    readonly start: (launcher: string) => Promise<boolean>;
+    readonly waitMs: number;
+    readonly pollMs: number;
+}
+/**
+ * True for a refused connection, however the runtime reports it: Bun sets
+ * `code: 'ConnectionRefused'`, Node keeps ECONNREFUSED on `cause` or nested `errors`.
+ */
+export declare function isConnectionRefused(error: unknown, seen?: Set<unknown>): boolean;
+/** Where `npx claude-mem install` places the launcher (claude-mem's install-launcher.ts). */
+export declare function launcherPath(platform: NodeJS.Platform, env: Record<string, string | undefined>, home: string): string;
+/**
+ * claude-mem's own switches for "do not start a Worker here": an explicit Worker URL,
+ * `CLAUDE_MEM_WORKER_AUTOSTART=false`, or a Worker host that is another machine.
+ */
+export declare function autostartDisabled(read: (key: string) => string | null, host?: string): boolean;
+/** The Worker as it is now, without starting anything. */
+export declare function workerState(deps?: WorkerStartDeps): Promise<WorkerState>;
+/** One start at a time per process; every caller during it gets the same answer. */
+export declare function ensureWorker(deps?: WorkerStartDeps): Promise<WorkerState>;

package/dist/worker-tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * One namespace for every tool: a direct tool call sees `claude_mem_<name>`, Code Mode
+ * sees `tools.claude_mem.<name>` under a single catalog entry with this description.
+ */
+export declare const TOOL_NAMESPACE: {
+    readonly name: "claude_mem";
+    readonly description: "claude-mem memory beyond search. work_state_write / work_state_read are your canonical to-do list and working state for this project: use them instead of any built-in to-do tool. save_memory records a durable note. dumb_search is a one-call lookup; get_tool_uses fetches raw tool I/O; the corpus tools build and query knowledge corpora.";
+};
+export interface WorkerTool {
+    /** Without the namespace: `save_memory`, not `claude_mem_save_memory`. */
+    readonly name: string;
+    readonly description: string;
+    readonly input: Record<string, unknown>;
+    readonly options: {
+        readonly namespace: string;
+        readonly pinned?: true;
+    };
+    /** `context.signal` aborts when the session stops; the request is dropped with it. */
+    readonly execute: (input: unknown, context?: {
+        readonly signal?: AbortSignal;
+    }) => Promise<{
+        content: string;
+    }>;
+}
+export interface WorkerToolOptions {
+    /** The session's checkout: the Worker derives the project from it. */
+    readonly directory: string;
+    readonly baseUrl?: string;
+    /** Starts the Worker after a refused connection; resolves true when it answers. */
+    readonly startWorker?: () => Promise<boolean>;
+    readonly corpusIdleTimeoutMs?: number;
+}
+export declare function createWorkerTools(options: WorkerToolOptions): WorkerTool[];

package/package.json

@@ -1,25 +1,15 @@
 {
   "name": "@ephemushroom/opencode-claude-mem",
-  "version": "0.6.2",
-  "description": "OpenCode plugin for Claude-Mem persistent memory system",
-  "main": "./dist/package-server.js",
-  "types": "./dist/package-server.d.ts",
+  "version": "0.7.1",
+  "description": "Claude-Mem for OpenCode: capture through the official claude-mem plugin, memory tools and the Memory sidebar in one package",
   "type": "module",
   "files": [
     "dist"
   ],
   "exports": {
-    ".": {
-      "types": "./dist/package-server.d.ts",
-      "import": "./dist/package-server.js"
-    },
-    "./v2": {
-      "types": "./dist/v2.d.ts",
-      "import": "./dist/v2.js"
-    },
     "./server": {
-      "types": "./dist/package-server.d.ts",
-      "import": "./dist/package-server.js"
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
     },
     "./tui": {
       "types": "./dist/package-tui.d.ts",
@@ -31,7 +21,7 @@
     }
   },
   "scripts": {
-    "build": "bun build src/index.ts --outfile dist/index.js --target bun --format esm && bun build src/v2.ts --outfile dist/v2.js --target bun --format esm && bun build src/tui.ts --outfile dist/tui.js --target bun --format esm --external @opentui/solid --external solid-js && bun build src/cli.ts --outfile dist/cli.js --target bun --format esm --external @opentui/solid --external solid-js && bun build src/package-server.ts --outdir dist --target bun --format esm --external '*' && bun src/build-tui-bridge.ts && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "build": "bun build src/server.ts --outfile dist/server.js --target bun --format esm && bun build src/tui.ts --outfile dist/tui.js --target bun --format esm --external @opentui/solid --external solid-js && bun build src/cli.ts --outfile dist/cli.js --target bun --format esm --external @opentui/solid --external solid-js && bun src/build-tui-bridge.ts && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "lint": "oxlint",
@@ -61,19 +51,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@opentui/solid": "0.5.10"
+    "@opentui/solid": "0.8.1"
   },
   "devDependencies": {
-    "@opencode-ai/plugin": "^1.14.41",
-    "@opencode-ai/plugin-v2": "npm:@opencode-ai/plugin@0.0.0-beta-19151",
-    "@opencode-ai/theme": "^0.0.0-next-17030",
-    "@opencode/plugin": "2.0.16",
-    "@opencode/theme": "2.0.16",
-    "@opentui/core": "0.5.10",
+    "@opencode/plugin": "2.2.7",
+    "@opencode/theme": "2.2.7",
+    "@opentui/core": "0.8.1",
     "@types/bun": "latest",
     "oxfmt": "^0.33.0",
     "oxlint": "^1.63.0",
-    "solid-js": "1.9.14",
+    "solid-js": "1.9.17",
     "typescript": "^5.9.3",
     "zod": "4.1.8"
   }

package/dist/file-context.d.ts

@@ -1,17 +0,0 @@
-import type { InjectionOptions } from './memory-options';
-import { MemoryWorker } from './memory-worker';
-export declare class FileContext {
-    private readonly sessions;
-    private readonly options;
-    private readonly worker;
-    constructor(options: InjectionOptions, worker?: typeof MemoryWorker);
-    read(session: string, input: {
-        readonly tool: string;
-        readonly args: unknown;
-    }, location: {
-        readonly directory: string;
-        readonly project: string;
-    }): Promise<string>;
-    delete(session: string): void;
-    clear(): void;
-}

package/dist/index.d.ts

@@ -1,20 +0,0 @@
-import { type Plugin } from '@opencode-ai/plugin';
-/**
- * OpenCode Plugin for Claude-Mem
- *
- * Hooks used:
- * - `event` — session lifecycle (session.created, session.idle, session.compacted,
- *             session.deleted, message.updated, file.edited)
- * - `tool.execute.after` — capture tool observations
- * - `experimental.chat.system.transform` — inject memory context into system prompt
- * - `experimental.session.compacting` — preserve memory context during compaction
- * - `chat.message` — session init with real user prompt
- *
- * Memory context is automatically injected into every conversation via system prompt.
- * No manual commands needed - the plugin works transparently in the background.
- */
-export declare const ClaudeMemPlugin: Plugin;
-declare const _default: {
-    server: Plugin;
-};
-export default _default;