@polygraph/opencode-plugin 0.4.24 → 0.4.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polygraph/opencode-plugin",
-  "version": "0.4.24",
+  "version": "0.4.26",
   "description": "AI agent skills and subagents for Polygraph multi-repo coordination",
   "license": "UNLICENSED",
   "private": false,

package/server.js

@@ -1,4 +1,5 @@
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import yaml from 'js-yaml';
@@ -29,6 +30,18 @@ export const PolygraphPlugin = async () => {
       output.env.POLYGRAPH_AGENT_SESSION_ID = input.sessionID;
       output.env.POLYGRAPH_AGENT_TYPE = 'opencode';
     },
+
+    // OpenCode has no SessionStart hook, but the Polygraph CLI already seeds the
+    // session id into context at launch. The one thing compaction can drop is
+    // that identity, so we steer the summary prompt to retain it. This fires
+    // before each compaction; the note is appended to the summarization prompt
+    // (best-effort — we trust the model to keep the id + repos in the summary).
+    'experimental.session.compacting': async (input, output) => {
+      const note = polygraphCompactionNote(input.sessionID);
+      if (note) {
+        output.context.push(note);
+      }
+    },
   };
 };
 
@@ -92,3 +105,82 @@ function numberValue(value) {
 function recordValue(value) {
   return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
 }
+
+// --- Polygraph session context (mirrors source/hooks/reinject-polygraph-context.mjs) ---
+//
+// Resolve the Polygraph session for this OpenCode session id from local state,
+// then build a short instruction telling the summarizer to keep the Polygraph
+// session id and repo list in the compaction summary. Returns null when this is
+// not a Polygraph session (no matching parent-log sidecar) — a silent no-op.
+//
+// These helpers must NOT be exported: OpenCode calls every export of this
+// module as a plugin factory, and a factory that doesn't return a hooks object
+// crashes the server on startup ("Unexpected server error").
+
+function polygraphCompactionNote(agentSessionId, root) {
+  const session = readPolygraphSession(agentSessionId, root);
+  if (!session) {
+    return undefined;
+  }
+
+  const repos = session.repos
+    .map((repo) => repo.repoFullName)
+    .filter(Boolean)
+    .join(', ');
+
+  return (
+    `This conversation is running inside Polygraph session ${session.sessionId}` +
+    (repos ? ` (repos: ${repos})` : '') +
+    '. Preserve the Polygraph session id and the repo list verbatim in the ' +
+    'summary so they remain available after compaction.'
+  );
+}
+
+function readPolygraphSession(
+  agentSessionId,
+  root = path.join(homedir(), '.polygraph')
+) {
+  if (!agentSessionId) {
+    return undefined;
+  }
+
+  const sidecarsDir = path.join(root, 'sidecars');
+  if (!existsSync(sidecarsDir)) {
+    return undefined;
+  }
+
+  const fileName = `parent-${agentSessionId}.json`;
+  let polygraphSessionId;
+  for (const entry of readdirSync(sidecarsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const candidate = path.join(sidecarsDir, entry.name, fileName);
+    if (existsSync(candidate)) {
+      try {
+        polygraphSessionId = JSON.parse(readFileSync(candidate, 'utf8')).sessionId;
+      } catch {
+        polygraphSessionId = undefined;
+      }
+      break;
+    }
+  }
+  if (!polygraphSessionId) {
+    return undefined;
+  }
+
+  let session = {};
+  try {
+    session = JSON.parse(
+      readFileSync(
+        path.join(root, 'sessions', polygraphSessionId, 'session', 'session.json'),
+        'utf8'
+      )
+    );
+  } catch {
+    session = {};
+  }
+
+  return {
+    sessionId: polygraphSessionId,
+    repos: Array.isArray(session.repos) ? session.repos : [],
+  };
+}

package/skills/polygraph/SKILL.md

@@ -105,7 +105,7 @@ The subagent will:
 4. Call `show_session` to retrieve session details
 5. Return a summary with session URL and repo info
 
-**Case C only — new session just created:** After the init subagent completes and creates the new session, render the session welcome card (skip the session-details block below for this case). Prefer the `session_intro` MCP tool — call it with the session ID; it returns the card as markdown. If that tool is unavailable, run `polygraph session intro -s <sessionId>` via the CLI instead. Either way, print the result to the user verbatim as markdown — do NOT wrap it in a code block or reformat it (the logo is pre-fenced; the rest is live markdown). It needs no other input, and you do not need to call `show_session` first. Then continue (ask the user what they want, or start the requested task).
+**Case C only — new session just created:** After the init subagent completes and creates the new session, render the session welcome card (skip the session-details block below for this case). Prefer the `session_intro` MCP tool — call it with the session ID; it returns the card as markdown. If that tool is unavailable, run `polygraph session intro -s <sessionId>` via the CLI instead. The CLI command is intentionally hidden/internal and may not appear in public command listings, but it remains the correct skill fallback for rendering the welcome card. Either way, print the result to the user verbatim as markdown — do NOT wrap it in a code block or reformat it (the logo is pre-fenced; the rest is live markdown). It needs no other input, and you do not need to call `show_session` first. Then continue (ask the user what they want, or start the requested task).
 
 **After receiving the subagent's summary (Case B) or after calling `show_session` for an existing session (Case A), print the session details:**