opencode-codex-memory 0.4.5 → 0.4.7

package/README.md

@@ -52,7 +52,7 @@ If you want the mental model before the details, jump to
 
 ```json
 {
-  "plugin": ["opencode-codex-memory@0.4.5"]
+  "plugin": ["opencode-codex-memory@0.4.7"]
 }
 ```
 
@@ -239,7 +239,7 @@ To set options, turn the plugin entry into a `[name, options]` pair:
 ```json
 {
   "plugin": [
-    ["opencode-codex-memory@0.4.5", { "disable_on_external_context": true, "min_rollout_idle_hours": 2 }]
+    ["opencode-codex-memory@0.4.7", { "disable_on_external_context": true, "min_rollout_idle_hours": 2 }]
   ]
 }
 ```
@@ -298,7 +298,7 @@ directions:
 ```json
 {
   "plugin": [
-    ["opencode-codex-memory@0.4.5", { "codex_interop": { "import": true, "export": true } }]
+    ["opencode-codex-memory@0.4.7", { "codex_interop": { "import": true, "export": true } }]
   ]
 }
 ```

package/dist/src/capture.d.ts

@@ -5,17 +5,11 @@ export interface SessionRow {
     directory: string | null;
 }
 /**
- * Global session discovery through the official API: opencode's session.list
- * is project-scoped, so enumerate projects (project.list) and list each one
- * with scope=project (routes the request to that project's instance AND
- * widens the filter from the session directory to the whole project).
- * Instance contexts created this way are cached by the host for the process
- * lifetime, and the whole pass is rate-limited (30s min interval).
- *
- * Fail-safe at two levels: a failed project.list skips the pass ([]), a
- * failed per-project session.list skips that project — neither claims or
- * finalizes any job. Transcript loading must NOT be fail-safe — see
- * loadTranscript.
+ * Global session discovery through the official API:
+ * `GET /experimental/session?roots=true` (Session.listGlobal) — one call across
+ * all projects, sorted by most-recently-updated. Available since opencode
+ * 1.17.x. Fail-safe: any error skips the pass ([]); never finalizes a job.
+ * Transcript loading must NOT be fail-safe — see loadTranscript.
  */
 export declare function listRecentSessions(limit?: number): Promise<SessionRow[]>;
 export interface TranscriptMessage {

package/dist/src/capture.js

@@ -16,64 +16,57 @@ async function withTimeout(promise, ms, label) {
     }
 }
 /**
- * Global session discovery through the official API: opencode's session.list
- * is project-scoped, so enumerate projects (project.list) and list each one
- * with scope=project (routes the request to that project's instance AND
- * widens the filter from the session directory to the whole project).
- * Instance contexts created this way are cached by the host for the process
- * lifetime, and the whole pass is rate-limited (30s min interval).
- *
- * Fail-safe at two levels: a failed project.list skips the pass ([]), a
- * failed per-project session.list skips that project — neither claims or
- * finalizes any job. Transcript loading must NOT be fail-safe — see
- * loadTranscript.
+ * Hey-api transport on PluginInput.client. The V1 SDK has no
+ * `experimental.*` namespace, but the host-built client already carries
+ * baseUrl + auth headers; `_client.get` is the supported escape hatch for
+ * routes the generated surface lags on (same pattern as the scope/roots casts
+ * we used to need on session.list).
+ */
+function pluginHttp() {
+    const http = getPluginInput()?.client?._client;
+    if (!http || typeof http.get !== "function")
+        return null;
+    return http;
+}
+/**
+ * Global session discovery through the official API:
+ * `GET /experimental/session?roots=true` (Session.listGlobal) — one call across
+ * all projects, sorted by most-recently-updated. Available since opencode
+ * 1.17.x. Fail-safe: any error skips the pass ([]); never finalizes a job.
+ * Transcript loading must NOT be fail-safe — see loadTranscript.
  */
 export async function listRecentSessions(limit = SCAN_LIMIT) {
-    const client = getPluginInput()?.client;
-    if (!client?.project?.list || !client?.session?.list)
+    const http = pluginHttp();
+    if (!http)
         return [];
-    let projects;
     try {
-        const res = await withTimeout(client.project.list(), API_TIMEOUT_MS, "project.list");
-        if (!res || res.error || !Array.isArray(res.data))
-            throw new Error(`project.list failed: ${JSON.stringify(res?.error ?? {})}`);
-        projects = res.data;
+        const res = await withTimeout(http.get({
+            url: "/experimental/session",
+            query: { roots: true, limit },
+        }), API_TIMEOUT_MS, "experimental.session.list");
+        if (!res || res.error || !Array.isArray(res.data)) {
+            throw new Error(`experimental.session.list failed: ${JSON.stringify(res?.error ?? {})}`);
+        }
+        const all = [];
+        for (const s of res.data) {
+            // Top-level sessions only: task-tool children are summarized into their
+            // parent, and the plugin's own sub-sessions must never be memorized
+            // (roots=true drops children server-side; keep both belts).
+            if (!s?.id || s.parentID)
+                continue;
+            if (s.title && s.title.startsWith("codex-memory-"))
+                continue;
+            all.push({ id: s.id, updated_at: s.time?.updated ?? 0, directory: s.directory ?? null });
+        }
+        // Server already orders by time_updated DESC; re-sort so a lagging host
+        // cannot invert eligibility order.
+        all.sort((a, b) => b.updated_at - a.updated_at);
+        return all.slice(0, limit);
     }
     catch (err) {
-        console.warn("[opencode-codex-memory] project discovery failed; skipping pass:", err);
+        console.warn("[opencode-codex-memory] session discovery failed; skipping pass:", err);
         return [];
     }
-    const all = [];
-    for (const project of projects) {
-        if (!project?.worktree)
-            continue;
-        try {
-            const res = await withTimeout(client.session.list({
-                // scope/roots/limit are in the server's ListQuery (accepted since
-                // opencode 1.14.30, well under our 1.18 floor); the pinned SDK types
-                // still omit them (SessionListData.query is just { directory } as of
-                // 1.18.1), hence the cast at the call site.
-                query: { directory: project.worktree, scope: "project", roots: true, limit },
-            }), API_TIMEOUT_MS, "session.list");
-            if (!res || res.error || !Array.isArray(res.data))
-                throw new Error(JSON.stringify(res?.error ?? {}));
-            for (const s of res.data) {
-                // Top-level sessions only: task-tool children are summarized into
-                // their parent, and the plugin's own sub-sessions must never be
-                // memorized (roots=true drops children server-side; keep both belts).
-                if (!s?.id || s.parentID)
-                    continue;
-                if (s.title && s.title.startsWith("codex-memory-"))
-                    continue;
-                all.push({ id: s.id, updated_at: s.time?.updated ?? 0, directory: s.directory ?? null });
-            }
-        }
-        catch (err) {
-            console.warn(`[opencode-codex-memory] session.list failed for ${project.worktree}; skipping project:`, err);
-        }
-    }
-    all.sort((a, b) => b.updated_at - a.updated_at);
-    return all.slice(0, limit);
 }
 /** Official transcript surface: GET /session/{id}/message via the plugin's authenticated client. */
 async function fetchMessagesViaApi(sessionId) {

package/dist/src/llm.js

@@ -1,5 +1,6 @@
 import fs from "fs";
 import path from "path";
+import { memoryRoot } from "./paths.js";
 let inputRef = null;
 export function setPluginInput(input) {
     inputRef = input;
@@ -20,11 +21,27 @@ const SUBSESSION_DELETE_TIMEOUT_MS = 10_000;
 export function isMemorySubSession(sessionId) {
     return activeSubSessions.has(sessionId);
 }
+/**
+ * Host directory for memory sub-sessions. Must exist: OpenCode resolves it in
+ * SystemPrompt.environment and fails the turn with UnknownError/ENOENT when
+ * missing. Prefer the memory workspace itself — global, always ours, already
+ * granted to `memorize` via external_directory, and independent of whatever
+ * (possibly deleted) project PluginInput.directory points at.
+ */
+function resolveSubSessionDirectory() {
+    const root = memoryRoot();
+    fs.mkdirSync(root, { recursive: true });
+    return root;
+}
 async function createSession(agent, title) {
     const input = getPluginInput();
     if (!input)
         throw new Error("plugin input not initialized");
+    const directory = resolveSubSessionDirectory();
     const res = await input.client.session.create({
+        // directory is a query param (not body); without it the client inherits
+        // PluginInput.directory, which may be a deleted project path.
+        query: { directory },
         body: {
             title: title ?? `codex-memory-${agent}`,
             metadata: { [SUBSESSION_METADATA_KEY]: true },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codex-memory",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "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",
@@ -31,6 +31,9 @@
     "dev": "bun --watch src/index.ts",
     "build": "tsc && rm -rf dist/src/templates && cp -R src/templates dist/src/templates && cp opencode.json dist/opencode.json",
     "smoke": "bun scripts/smoke.ts",
+    "contract": "bun scripts/check-opencode-contract.ts",
+    "live:read": "bun scripts/live-readpath.ts",
+    "live:e2e": "bun scripts/live-e2e.ts",
     "prepack": "npm run build && npm run smoke",
     "test": "bun test",
     "typecheck": "tsc --noEmit"