greprag 5.32.0 → 5.34.0

package/dist/opencode-plugin.d.ts

@@ -6,15 +6,35 @@
  *   2. Capture every completed (user, assistant) turn pair to /v1/memory/turn
  *      for episodic compaction.
  *
- * Loaded by OpenCode from ~/.config/opencode/plugins/greprag-memory.js
+ * Loaded by opencode from ~/.config/opencode/plugins/greprag-memory.js
  * (installed by `greprag init --opencode`). All types are declared inline so
- * the file has zero external runtime imports — the package source must remain
- * self-contained because opencode's loader hands the compiled module straight
- * to Bun, with no resolution step against our dependency tree.
+ * the file has zero external runtime imports beyond the helpers module and
+ * Node built-ins — opencode's loader hands the compiled module straight to
+ * Bun with no resolution step against our dependency tree.
+ *
+ * adr: adr/opencode-monitor-relay.md — see entries 2026-06-06 (f) for the
+ * `export = { id, server }` rationale (single V1 plugin module, no
+ * `__esModule` wrapper, no `__test` helper export) and (g) for the recap
+ * renderer alignment with `greprag-hook` (single source of truth for the
+ * recap body pushed at session start), and (h) for the defensive
+ * `output.system` / optional-`sessionID` handling.
+ *
+ * Opencode SessionStart model:
+ *   Opencode has no true SessionStart hook (confirmed against sst/opencode
+ *   docs and corroborated by other plugins — Superpowers, codexfi,
+ *   opencode-rules, context-mode — all of which use
+ *   `experimental.chat.system.transform` as a turn-1 surrogate). The
+ *   experimental hook fires before each LLM call; we push the recap on the
+ *   first fire per session and skip later fires. This is a turn-1 model,
+ *   not a true session-start model, but it's the closest opencode has and
+ *   it's what other working plugins do.
  *
  * Hook surface used (verified against sst/opencode dev branch):
  *   - experimental.chat.system.transform — fires before each LLM call. We
- *     push recap text on the FIRST fire per sessionID and ignore later fires.
+ *     push recap text on the FIRST fire per sessionID and ignore later
+ *     fires. Defensive: sessionID is optional (opencode issue #6142), and
+ *     output.system may arrive as `string | string[]` depending on
+ *     runtime/version — we handle both shapes.
  *   - event — receives every bus event. We listen for "message.updated" with
  *     role="assistant" and info.time.completed set (assistant message
  *     finalized), then fetch the session's full message list via the supplied
@@ -29,13 +49,19 @@ interface OpenCodeProject {
     name?: string;
     path?: string;
 }
+interface OpenCodeSession {
+    id: string;
+    directory?: string;
+    path?: string;
+    projectID?: string;
+}
 interface OpenCodeClient {
     session: {
-        messages: (args: {
+        get: (args: {
             path: {
                 id: string;
             };
-        }) => Promise<WithParts[]>;
+        }) => Promise<OpenCodeSession>;
     };
 }
 interface OpenCodePluginContext {
@@ -46,139 +72,16 @@ interface OpenCodePluginContext {
     serverUrl: URL;
     $: unknown;
 }
-interface UserInfo {
-    id: string;
-    sessionID: string;
-    role: 'user';
-    time: {
-        created: number;
-    };
-}
-interface AssistantInfo {
-    id: string;
-    sessionID: string;
-    role: 'assistant';
-    parentID: string;
-    modelID: string;
-    providerID: string;
-    time: {
-        created: number;
-        completed?: number;
-    };
-    agent: string;
-    path: {
-        cwd: string;
-        root: string;
-    };
-    cost: number;
-    error?: unknown;
-}
-type MessageInfo = UserInfo | AssistantInfo;
-interface WithParts {
-    info: MessageInfo;
-    parts: Part[];
-}
-interface TextPart {
-    type: 'text';
-    text: string;
-    synthetic?: boolean;
-    ignored?: boolean;
-}
-type ToolState = {
-    status: 'pending';
-    input: Record<string, unknown>;
-} | {
-    status: 'running';
-    input: Record<string, unknown>;
-    title?: string;
-} | {
-    status: 'completed';
-    input: Record<string, unknown>;
-    output: string;
-    title: string;
-} | {
-    status: 'error';
-    input: Record<string, unknown>;
-    error: string;
-};
-interface ToolPart {
-    type: 'tool';
-    callID: string;
-    tool: string;
-    state: ToolState;
-}
-interface GenericPart {
-    type: string;
-    [key: string]: unknown;
-}
-type Part = TextPart | ToolPart | GenericPart;
-interface BusEvent {
-    id?: string;
-    type: string;
-    properties: Record<string, unknown>;
-}
 type Hooks = {
     'experimental.chat.system.transform'?: (input: {
-        sessionID: string;
+        sessionID?: string;
         model: unknown;
     }, output: {
-        system: string[];
-    }) => Promise<void> | void;
-    event?: (input: {
-        event: BusEvent;
+        system: string | string[];
     }) => Promise<void> | void;
 };
-interface ProjectAnchor {
-    projectId: string;
-    projectName: string;
-    memoryCapture: boolean;
-    sessionStartRecap: boolean;
-    inboxNotify: 'every_turn' | 'session_start_only' | 'off';
-}
-/** Resolve the project anchor for `worktree` using the same 4-level cascade
- *  the Claude Code CLI uses (packages/cli/src/project-anchor.ts). Settings
- *  always come from the nearest repo-level file when one exists, regardless
- *  of which identity level resolved.
- *
- *    1. Anchor file with explicit `project_id` → file-based identity
- *    2. Git repo with at least one commit → root-commit-derived UUID
- *    3. Ephemeral cwd + ~/.greprag/project.json exists → global anchor
- *    4. Path-hash fallback (never returns null; lets capture flow until
- *       `greprag init` runs and `greprag doctor` consolidates) */
-declare function readAnchor(worktree: string): ProjectAnchor;
-declare function extractText(parts: Part[]): string;
-interface ToolCallSummary {
-    name: string;
-    target?: string;
-    brief?: string;
-}
-/** Pull a one-line summary out of each tool call: name + a target string + an
- *  optional brief for shell commands. Mirrors the shape the Claude Code hook
- *  posts so server-side compaction sees identical structure regardless of
- *  client origin. */
-declare function extractToolCalls(parts: Part[]): ToolCallSummary[];
-declare function extractFilesTouched(parts: Part[]): string[];
-type TurnProvenance = 'session-turn' | 'skill-injection' | 'continuation-summary' | 'chip-prompt';
-interface Envelope {
-    userPrompt: string;
-    agentResponse: string;
-    toolCalls: ToolCallSummary[];
-    filesTouched: string[];
-    status: 'completed' | 'errored';
-    provenance: TurnProvenance;
-}
-declare function buildEnvelope(userParts: Part[], assistantParts: Part[], errored: boolean): Envelope;
-declare const GrepRAGMemoryPlugin: (ctx: OpenCodePluginContext) => Promise<Hooks>;
 declare const _default: {
-    server: (ctx: OpenCodePluginContext) => Promise<Hooks>;
     id: string;
+    server: (ctx: OpenCodePluginContext) => Promise<Hooks>;
 };
-export default _default;
-export { GrepRAGMemoryPlugin };
-export declare const __test: {
-    extractText: typeof extractText;
-    extractToolCalls: typeof extractToolCalls;
-    extractFilesTouched: typeof extractFilesTouched;
-    buildEnvelope: typeof buildEnvelope;
-    readAnchor: typeof readAnchor;
-};
+export = _default;