opencode-codex-memory 0.7.0 → 0.7.2

package/README.md

@@ -52,7 +52,7 @@ If you want the mental model — learning, remembering, forgetting — see
 
 ```json
 {
-  "plugin": ["opencode-codex-memory@0.7.0"]
+  "plugin": ["opencode-codex-memory@0.7.2"]
 }
 ```
 
@@ -72,7 +72,7 @@ V2 plugin syntax:
 
 ```jsonc
 {
-  "plugins": [{ "package": "opencode-codex-memory@0.7.0" }],
+  "plugins": [{ "package": "opencode-codex-memory@0.7.2" }],
 }
 ```
 
@@ -198,7 +198,7 @@ To set options, turn the plugin entry into a `[name, options]` pair:
 ```json
 {
   "plugin": [
-    ["opencode-codex-memory@0.7.0", { "disable_on_external_context": true, "min_rollout_idle_hours": 2 }]
+    ["opencode-codex-memory@0.7.2", { "disable_on_external_context": true, "min_rollout_idle_hours": 2 }]
   ]
 }
 ```
@@ -265,7 +265,7 @@ Off by default; no changes to Codex's own config are required.
 {
   "plugin": [
     [
-      "opencode-codex-memory@0.7.0",
+      "opencode-codex-memory@0.7.2",
       { "codex_interop": { "import": true, "export": true } }
     ]
   ]
@@ -322,7 +322,7 @@ from the project memories Claude already keeps on your machine. **One-way only**
 ```json
 {
   "plugin": [
-    ["opencode-codex-memory@0.7.0", { "claude_import": { "enabled": true } }]
+    ["opencode-codex-memory@0.7.2", { "claude_import": { "enabled": true } }]
   ]
 }
 ```
@@ -349,7 +349,7 @@ Claude names each project with an opaque id (a folder under
 {
   "plugin": [
     [
-      "opencode-codex-memory@0.7.0",
+      "opencode-codex-memory@0.7.2",
       {
         "claude_import": {
           "enabled": true,

package/dist/src/tui.d.ts

@@ -0,0 +1,10 @@
+type PluginSetup = (() => void | Promise<void>) | void;
+declare function setup(ctx: unknown): Promise<PluginSetup>;
+/** OpenCode 1.x TUI host: keep the package loadable. No sidebar on 1.x. */
+declare function tui(): Promise<void>;
+declare const _default: {
+    id: string;
+    setup: typeof setup;
+    tui: typeof tui;
+};
+export default _default;

package/dist/src/tui.js

@@ -0,0 +1,24 @@
+/**
+ * Dual-host `./tui` entry.
+ *
+ * OpenCode 1.18.29+ (and 1.18.30) resolves `exports["./tui"]` and requires
+ * `default.tui()` — `readV1Plugin(..., "tui")` in strict mode. The Memory
+ * sidebar is OpenCode 2-only (`src/v2/tui.tsx`) and must not load until a
+ * V2 host calls setup(): the V2 TUI SDK is an optional peer and is missing
+ * on 1.x, so a static import there is "failed to load plugin".
+ */
+const PLUGIN_ID = "opencode-codex-memory.tui";
+async function setup(ctx) {
+    const { default: plugin } = await import("./v2/tui.js");
+    const fn = plugin.setup;
+    if (typeof fn !== "function")
+        return;
+    return fn(ctx);
+}
+/** OpenCode 1.x TUI host: keep the package loadable. No sidebar on 1.x. */
+async function tui() { }
+export default {
+    id: PLUGIN_ID,
+    setup,
+    tui,
+};

package/dist/src/v2/service.d.ts

@@ -1,12 +1,12 @@
 /**
  * The supported OpenCode 2 connection boundary.
  *
- * Server plugins do not receive the complete public client. The registered
- * local service does: the XDG `service.json` file is the discovery contract
- * (read-only — never Service.ensure()). Auth headers are preserved, and
- * GET /api/status pid must match this process. 2.0.5 dropped JSON
- * /api/health (404 HTML/empty); 2.0.3 Service.discover() still probes that
- * path and throws on a non-object body, so this module never calls it.
+ * Server plugins do not receive the complete public client. `ctx` is the
+ * documented plugin API; global session list is missing there, so we talk
+ * HTTP via `@opencode/client` (a runtime dependency so the plugin cache
+ * actually installs it). Discovery reads XDG `service.json` (never
+ * Service.ensure() / Service.discover() — those still probe /api/health,
+ * which 2.0.5 404s). GET /api/status pid must match this process.
  */
 export interface V2ServiceEndpoint {
     url: string;
@@ -57,6 +57,10 @@ export interface V2ServiceDependencies {
 export declare function setV2ServiceDependenciesForTest(dependencies: V2ServiceDependencies | null): void;
 /** Forget a cached endpoint after a service restart or failed request. */
 export declare function invalidateOwnService(): void;
+/** Last discoverOwnService failure, if ownServiceClient returned null. */
+export declare function lastServiceFailure(): string | null;
+/** Auth headers for the registered local service. */
+export declare function serviceHeaders(endpoint: V2ServiceEndpoint): Record<string, string> | undefined;
 export declare function parseReadyStatus(body: unknown): V2ServiceStatus | null;
 export declare function readRegisteredEndpoint(file?: string): Promise<V2ServiceEndpoint | undefined>;
 export declare function fetchServiceStatus(endpoint: V2ServiceEndpoint, headers: Record<string, string> | undefined, signal?: AbortSignal): Promise<V2ServiceStatus>;

package/dist/src/v2/service.js

@@ -1,19 +1,22 @@
 /**
  * The supported OpenCode 2 connection boundary.
  *
- * Server plugins do not receive the complete public client. The registered
- * local service does: the XDG `service.json` file is the discovery contract
- * (read-only — never Service.ensure()). Auth headers are preserved, and
- * GET /api/status pid must match this process. 2.0.5 dropped JSON
- * /api/health (404 HTML/empty); 2.0.3 Service.discover() still probes that
- * path and throws on a non-object body, so this module never calls it.
+ * Server plugins do not receive the complete public client. `ctx` is the
+ * documented plugin API; global session list is missing there, so we talk
+ * HTTP via `@opencode/client` (a runtime dependency so the plugin cache
+ * actually installs it). Discovery reads XDG `service.json` (never
+ * Service.ensure() / Service.discover() — those still probe /api/health,
+ * which 2.0.5 404s). GET /api/status pid must match this process.
  */
 import { readFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
+import { OpenCode } from "@opencode/client";
+import { Service } from "@opencode/client/service";
 let testDependencies = null;
 let clientPromise = null;
-const SERVICE_REQUEST_TIMEOUT_MS = 1_000;
+let lastFailure = null;
+const SERVICE_REQUEST_TIMEOUT_MS = 3_000;
 /** Test seam: replace discovery without changing the production connection path. */
 export function setV2ServiceDependenciesForTest(dependencies) {
     testDependencies = dependencies;
@@ -22,6 +25,15 @@ export function setV2ServiceDependenciesForTest(dependencies) {
 /** Forget a cached endpoint after a service restart or failed request. */
 export function invalidateOwnService() {
     clientPromise = null;
+    lastFailure = null;
+}
+/** Last discoverOwnService failure, if ownServiceClient returned null. */
+export function lastServiceFailure() {
+    return lastFailure;
+}
+/** Auth headers for the registered local service. */
+export function serviceHeaders(endpoint) {
+    return Service.headers(endpoint);
 }
 export function parseReadyStatus(body) {
     const record = unwrapStatusRecord(body);
@@ -94,36 +106,40 @@ export async function readRegisteredEndpoint(file = registrationPath()) {
 async function fetchJson(url, headers, signal) {
     const response = await fetch(url, { headers, signal });
     const text = await response.text();
+    let body;
     if (!text)
-        return undefined;
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return undefined;
+        body = undefined;
+    else {
+        try {
+            body = JSON.parse(text);
+        }
+        catch {
+            body = text;
+        }
     }
+    return { ok: response.ok, status: response.status, body };
 }
 export async function fetchServiceStatus(endpoint, headers, signal) {
-    const statusBody = await fetchJson(new URL("/api/status", endpoint.url), headers, signal);
-    const fromStatus = parseReadyStatus(statusBody);
+    const statusRes = await fetchJson(new URL("/api/status", endpoint.url), headers, signal);
+    const fromStatus = parseReadyStatus(statusRes.body);
     if (fromStatus)
         return fromStatus;
-    const healthBody = await fetchJson(new URL("/api/health", endpoint.url), headers, signal);
-    const fromHealth = parseReadyStatus(healthBody);
+    if (!statusRes.ok)
+        throw new Error(`GET /api/status ${String(statusRes.status)}`);
+    const healthRes = await fetchJson(new URL("/api/health", endpoint.url), headers, signal);
+    const fromHealth = parseReadyStatus(healthRes.body);
     if (fromHealth)
         return fromHealth;
     throw new Error("registered OpenCode service is not healthy");
 }
-async function productionDependencies() {
-    const { Service } = await import("@opencode/client/service");
-    const { OpenCode } = await import("@opencode/client");
+function productionDependencies() {
     return {
         service: {
             discover: () => readRegisteredEndpoint(),
-            headers: (endpoint) => Service.headers(endpoint),
+            headers: serviceHeaders,
         },
         make: (options) => OpenCode.make(options),
-        probe: (endpoint, signal) => fetchServiceStatus(endpoint, Service.headers(endpoint), signal),
+        probe: (endpoint, signal) => fetchServiceStatus(endpoint, serviceHeaders(endpoint), signal),
     };
 }
 async function probeEndpoint(deps, endpoint, client, signal) {
@@ -144,7 +160,7 @@ async function probeEndpoint(deps, endpoint, client, signal) {
  * safety failure because it would make global memory operate on another host.
  */
 export async function discoverOwnService(dependencies, timeoutMs = SERVICE_REQUEST_TIMEOUT_MS) {
-    const deps = dependencies ?? testDependencies ?? (await productionDependencies());
+    const deps = dependencies ?? testDependencies ?? productionDependencies();
     const endpoint = await withServiceTimeout(deps.service.discover(), timeoutMs);
     if (!endpoint)
         return null;
@@ -159,7 +175,13 @@ export async function discoverOwnService(dependencies, timeoutMs = SERVICE_REQUE
 /** Resolve the registered client once per live service; never start a service. */
 export async function ownServiceClient() {
     if (!clientPromise) {
-        const request = discoverOwnService().then((found) => found?.client ?? null).catch((err) => {
+        const request = discoverOwnService()
+            .then((found) => {
+            lastFailure = found ? null : "no registered OpenCode 2 service.json";
+            return found?.client ?? null;
+        })
+            .catch((err) => {
+            lastFailure = err instanceof Error ? err.message : String(err);
             console.warn("[opencode-codex-memory] registered OpenCode service unavailable:", err);
             return null;
         });

package/dist/src/v2/shim.js

@@ -1,5 +1,5 @@
 import { memoryRoot } from "../paths.js";
-import { invalidateOwnService, ownServiceClient } from "./service.js";
+import { invalidateOwnService, lastServiceFailure, ownServiceClient } from "./service.js";
 let v2ctx = null;
 export function setV2Context(ctx) {
     v2ctx = ctx;
@@ -315,19 +315,19 @@ async function v2promptWithWait(sessionID, body, signal) {
 export function buildV1ClientShim() {
     async function serviceOrThrow() {
         const client = await ownServiceClient();
-        if (!client)
-            throw new Error("no healthy registered OpenCode 2 service for global memory operations");
+        if (!client) {
+            throw new Error(lastServiceFailure() ?? "no healthy registered OpenCode 2 service for global memory operations");
+        }
         return client;
     }
-    async function listGlobalSessions(limit, cursor, search) {
-        const client = await serviceOrThrow();
+    async function paginateSessionList(listFn, limit, cursor, search) {
         const pageSize = Math.min(Math.max(limit, 1), 5000);
         const out = [];
         const seenCursors = new Set();
         const timestampCursor = typeof cursor === "number" ? cursor : undefined;
         let next = typeof cursor === "string" ? cursor : undefined;
         while (out.length < limit) {
-            const response = (await client.session.list?.({
+            const response = (await listFn({
                 limit: pageSize,
                 order: "desc",
                 parentID: null,
@@ -362,6 +362,16 @@ export function buildV1ClientShim() {
         }
         return { data: out.slice(0, limit) };
     }
+    async function listGlobalSessions(limit, cursor, search) {
+        const localList = v2ctx ? v2ctx.session.list : undefined;
+        if (typeof localList === "function") {
+            return paginateSessionList((input) => localList(input), limit, cursor, search);
+        }
+        const client = await serviceOrThrow();
+        if (typeof client.session.list !== "function")
+            throw new Error("registered service does not support session.list");
+        return paginateSessionList((input) => client.session.list(input), limit, cursor, search);
+    }
     const session = {
         create: async (opts) => {
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codex-memory",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Persistent memory plugin for opencode — ports codex's two-phase memory system (extraction → consolidation → injection → citation feedback)",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -18,8 +18,8 @@
       "types": "./dist/src/v2/index.d.ts"
     },
     "./tui": {
-      "types": "./dist/src/v2/tui.d.ts",
-      "import": "./dist/src/v2/tui.js"
+      "types": "./dist/src/tui.d.ts",
+      "import": "./dist/src/tui.js"
     },
     "./tools/*": {
       "import": "./dist/tools/*.js",
@@ -62,12 +62,12 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@opencode-ai/plugin": "^1.18.0",
+    "@opencode/client": "2.0.5",
     "diff": "^9.0.0",
     "isomorphic-git": "^1.38.6",
     "xdg-basedir": "^5.1.0"
   },
   "devDependencies": {
-    "@opencode/client": "2.0.3",
     "@opencode/plugin": "2.0.3",
     "zod": "4.1.8",
     "@opencode/theme": "2.0.3",