@cortexkit/opencode-magic-context 0.15.7 → 0.16.1

package/dist/shared/transcript.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Harness-agnostic transcript interface.
+ *
+ * Magic Context's transform pipeline operates on messages in a specific
+ * shape: ordered messages with role-tagged parts (text, tool, reasoning,
+ * tool_result, image), where tagging, sentinel stripping, and queued-drop
+ * application MUTATE part content in-place. OpenCode's plugin transform
+ * receives a `{ info, parts: unknown[] }[]` array and the AI SDK reads
+ * those mutations directly. Pi's `pi.on("context", ...)` event delivers a
+ * `AgentMessage[]` and accepts a fully-replaced array as the result.
+ *
+ * Rather than building a bidirectional `MessageLike[] ↔ AgentMessage[]`
+ * adapter (Oracle's rejected Q1 alternative — too much round-trip
+ * complexity, double-conversion bugs), this module defines a small
+ * adapter contract that:
+ *
+ *   1. Exposes ordered messages with a *uniform* part-level mutation
+ *      surface, regardless of underlying shape.
+ *   2. Is owned by the harness — OpenCode's adapter mutates `parts[]`
+ *      directly (zero copies), Pi's adapter rebuilds an `AgentMessage[]`
+ *      from the mutated transcript only at commit time.
+ *   3. Lets the shared transform code (tagging, stripping, drops)
+ *      operate on `TranscriptPart` interface instances without caring
+ *      whether they're wrapping `Part` from `@opencode-ai/sdk` or
+ *      `TextContent | ToolCall | ThinkingContent` from `@mariozechner/pi-ai`.
+ *
+ * What this interface deliberately does NOT do:
+ *
+ * - **No data round-trip.** The transcript is a *view* over harness data;
+ *   it doesn't define a third canonical message shape. There's no JSON
+ *   serialization, no normalization to a common DTO. Round-trip-free
+ *   adapters are 10x simpler and faster.
+ *
+ * - **No mutation semantics divergence.** Both adapters expose the same
+ *   in-place mutation API (`setText`, `setOutput`, `replaceWithSentinel`).
+ *   Whether mutation flushes to the source array immediately (OpenCode)
+ *   or accumulates until `commit()` (Pi) is the adapter's concern.
+ *
+ * - **No session-storage abstraction.** Compartment storage, ordinals,
+ *   raw-history reads — those live in feature modules, not here. The
+ *   transcript only models the *current turn's* live message buffer.
+ *
+ * Step 4b.1 ships ONLY the interface and OpenCode adapter migration.
+ * Pi adapter implementation lands in 4b.2 alongside the Pi context-event
+ * wire-up, since the two are co-designed (the Pi adapter has to satisfy
+ * the same operations the tagging code calls). 4b.3 wires the Pi
+ * compartment trigger and historian invocation. 4b.4 nudges + auto-search.
+ */
+/** Categorical kind of a transcript part, useful for filter predicates. */
+export type TranscriptPartKind = "text" | "thinking" | "tool_use" | "tool_result" | "image" | "file" | "structural" | "unknown";
+/**
+ * A single content fragment within a transcript message.
+ *
+ * The interface is intentionally narrow: it exposes the operations Magic
+ * Context's transform code performs (read kind, read text, mutate text,
+ * mutate tool output, drop, replace with sentinel) and nothing more. Each
+ * harness adapter implements these against its native part type.
+ *
+ * IMPORTANT: implementations are stateful proxies over the live source
+ * data. Calling `setText("...")` on an OpenCode part mutates the
+ * underlying `Part.text`; calling it on a Pi part flips a dirty flag and
+ * the adapter's `commit()` rebuilds the affected `AgentMessage`. Either
+ * way, the transcript code reads back consistent values via `getText()`.
+ */
+export interface TranscriptPart {
+    /** Discriminator for filter logic. Stable across mutations. */
+    readonly kind: TranscriptPartKind;
+    /**
+     * Best-effort identifier for cross-pass tracking. May be:
+     * - OpenCode part ID (e.g. "prt_..."), stable across passes.
+     * - Pi tool-call ID for tool_use/tool_result parts.
+     * - undefined for synthetic/structural parts.
+     *
+     * Pure parts without a stable ID return undefined and are tracked
+     * positionally within their containing message instead.
+     */
+    readonly id: string | undefined;
+    /**
+     * The user-/agent-visible text payload, if this part has one. Returns
+     * undefined for parts that have no text representation (image, file,
+     * structural-only). For thinking parts returns the thinking text. For
+     * tool_use returns the JSON-stringified arguments (so size accounting
+     * reflects what the model sees). For tool_result returns the
+     * concatenated text content of the result.
+     */
+    getText(): string | undefined;
+    /**
+     * Replace the visible text payload. Applies only to text and thinking
+     * parts; throws for kinds where mutation isn't meaningful (the caller
+     * should check `kind` first).
+     *
+     * Returns true if the underlying source data actually changed (so
+     * deduplication helpers can short-circuit). Returns false when the
+     * new text equals the existing text byte-for-byte.
+     */
+    setText(newText: string): boolean;
+    /**
+     * For tool_result parts: replace the text content of the result.
+     * For tool_use parts: replace JSON-serialized arguments.
+     * For everything else: throws — caller should check `kind` first.
+     */
+    setToolOutput(newText: string): boolean;
+    /**
+     * Tool-specific metadata exposed for tagging/drop accounting:
+     * - toolName: tool identifier (e.g. "bash", "ctx_search"). undefined
+     *   for non-tool parts.
+     * - inputByteSize: serialized argument size; used by historian
+     *   pressure projection to estimate post-drop savings.
+     *
+     * For non-tool parts both fields are undefined.
+     */
+    getToolMetadata(): {
+        toolName: string | undefined;
+        inputByteSize: number;
+    };
+    /**
+     * Replace this part with a sentinel placeholder. Sentinels look like
+     * `[dropped §N§]` or `[truncated §N§]` and survive cache-busting
+     * cycles by carrying their original tag number. Used by the
+     * apply-operations flow when a queued drop fires.
+     *
+     * Implementations replace the part *in place* in the parent message's
+     * part array. The replaced part's `kind` shifts to "structural" so
+     * subsequent transform passes don't double-process it.
+     *
+     * Returns true on success; returns false if the part can't be
+     * replaced (e.g. it's already a sentinel, or it's an image part).
+     */
+    replaceWithSentinel(sentinelText: string): boolean;
+}
+/**
+ * A single message in the transcript, exposing role + ordered parts.
+ *
+ * Lifetime: a TranscriptMessage is valid only within a single transform
+ * pass. Adapters do not guarantee identity across passes — callers must
+ * use `info.id` for cross-pass correlation, never the message reference.
+ */
+export interface TranscriptMessage {
+    /**
+     * Lightweight metadata exposed for tagging, sentinel persistence, and
+     * cross-pass correlation. Adapters fill these from harness-native
+     * fields:
+     *
+     * - id: provider-stable message ID (OpenCode `msg_...`, Pi entryId).
+     * - role: "user" | "assistant" | "system" | "tool" | other custom roles.
+     * - sessionId: session identifier, used to scope DB writes.
+     *
+     * IMPORTANT for Pi: Pi's `ToolResultMessage` has role "toolResult"
+     * which the OpenCode-derived transform code expects to NOT be present
+     * (OpenCode folds tool results into the next user message's parts).
+     * The Pi adapter therefore exposes tool-result messages as parts of a
+     * synthetic "user" message in the transcript view, even though the
+     * underlying Pi storage has them as separate top-level entries. This
+     * is the *only* shape normalization the adapter performs.
+     */
+    readonly info: {
+        id?: string;
+        role: string;
+        sessionId?: string;
+    };
+    /** Ordered parts. Same ordering invariants as the underlying source. */
+    readonly parts: TranscriptPart[];
+}
+/**
+ * Adapter contract: everything the transform pipeline calls on a
+ * harness-specific transcript implementation.
+ *
+ * Adapters are owned by the harness adapter layer (OpenCode's
+ * messages-transform.ts, Pi's context-event handler). The shared
+ * transform code receives a Transcript and operates only through this
+ * interface — it never imports from `@opencode-ai/sdk` or
+ * `@mariozechner/pi-ai`.
+ */
+export interface Transcript {
+    /** Ordered messages in the current pass. */
+    readonly messages: TranscriptMessage[];
+    /**
+     * Adapter identification. Useful for:
+     * - Logging (`magic-context[opencode]` vs `magic-context[pi]`).
+     * - Per-harness behaviors gated at adapter level (e.g. opencode-only
+     *   compaction marker injection).
+     * - Test assertions confirming the right adapter ran.
+     */
+    readonly harness: "opencode" | "pi";
+    /**
+     * Commit accumulated mutations to the underlying source array.
+     *
+     * For OpenCode: no-op — parts are mutated directly in `Part.text`/
+     * `Part.state.output` and OpenCode reads them back from the same
+     * array, so changes are already visible.
+     *
+     * For Pi: rebuilds a new `AgentMessage[]` from the dirty messages
+     * and stores it on the adapter so `pi.on("context", ...)` can return
+     * `{ messages }` to Pi. Idempotent: calling twice is safe.
+     *
+     * Always called exactly once per pass, after the transform pipeline
+     * finishes. Adapters that don't need it implement it as a no-op.
+     */
+    commit(): void;
+}
+/**
+ * Sentinel marker for transcript parts that should be ignored by all
+ * downstream transform stages (tagging, drops, indexing). Adapters set
+ * this on parts that exist only as structural artifacts (e.g. OpenCode's
+ * `step-start`/`step-finish`).
+ *
+ * Exported so harness adapters can stamp it on synthetic parts they
+ * create internally and so test fixtures can construct synthetic
+ * transcripts without needing real OpenCode/Pi structures.
+ */
+export declare const STRUCTURAL_SENTINEL_KIND: TranscriptPartKind;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/shared/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/shared/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GACxB,MAAM,GACN,UAAU,GACV,UAAU,GACV,aAAa,GACb,OAAO,GACP,MAAM,GACN,YAAY,GACZ,SAAS,CAAC;AAEhB;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAElC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;;;;;;OAOG;IACH,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAE9B;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAExC;;;;;;;;OAQG;IACH,eAAe,IAAI;QAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAE3E;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,IAAI,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEjE,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAEvC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;;;OAaG;IACH,MAAM,IAAI,IAAI,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,EAAE,kBAAiC,CAAC"}

package/dist/shared/tui-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui-config.d.ts","sourceRoot":"","sources":["../../src/shared/tui-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CA4C9C"}
+{"version":3,"file":"tui-config.d.ts","sourceRoot":"","sources":["../../src/shared/tui-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4CH;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CA+C9C"}

package/dist/tools/ctx-memory/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAsBhE,OAAO,EAIH,KAAK,iBAAiB,EACzB,MAAM,SAAS,CAAC;AA+cjB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAsBhE,OAAO,EAIH,KAAK,iBAAiB,EACzB,MAAM,SAAS,CAAC;AAgdjB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-memory/types.d.ts

@@ -1,5 +1,5 @@
-import type { Database } from "bun:sqlite";
 import type { MemorySourceType } from "../../features/magic-context/memory";
+import type { Database } from "../../shared/sqlite";
 export declare const CTX_MEMORY_ACTIONS: readonly ["write", "delete"];
 export declare const CTX_MEMORY_DREAMER_ACTIONS: readonly ["write", "delete", "list", "update", "merge", "archive"];
 export type CtxMemoryAction = (typeof CTX_MEMORY_DREAMER_ACTIONS)[number];
@@ -14,7 +14,18 @@ export interface CtxMemoryArgs {
 }
 export interface CtxMemoryToolDeps {
     db: Database;
-    projectPath: string;
+    /**
+     * Resolve the project identity for the active session's directory.
+     *
+     * Why a function instead of a baked string: OpenCode's top-level
+     * `ctx.directory` is the directory the OpenCode process was started
+     * in (often `$HOME` when launched via `opencode -s <id>` from outside
+     * the project). The session's actual working directory is exposed
+     * per-call via `toolContext.directory`. Resolving here ensures
+     * `ctx_memory` operates on the session's project, not the launch
+     * directory's project.
+     */
+    resolveProjectPath: (directory: string) => string;
     memoryEnabled: boolean;
     embeddingEnabled: boolean;
     allowedActions?: CtxMemoryAction[];

package/dist/tools/ctx-memory/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,eAAO,MAAM,kBAAkB,8BAA+B,CAAC;AAE/D,eAAO,MAAM,0BAA0B,oEAM7B,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,eAAO,MAAM,kBAAkB,8BAA+B,CAAC;AAE/D,eAAO,MAAM,0BAA0B,oEAM7B,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb;;;;;;;;;;OAUG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC"}

package/dist/tools/ctx-note/tools.d.ts

@@ -1,9 +1,15 @@
-import type { Database } from "bun:sqlite";
 import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { Database } from "../../shared/sqlite";
 export interface CtxNoteToolDeps {
     db: Database;
     dreamerEnabled?: boolean;
-    projectIdentity?: string;
+    /**
+     * Resolve the project identity for the session's directory at call time.
+     * See CtxMemoryToolDeps.resolveProjectPath for why this is a function.
+     * Optional — when undefined, smart-note creation is rejected with an
+     * explanatory error.
+     */
+    resolveProjectPath?: (directory: string) => string;
 }
 export declare function createCtxNoteTools(deps: CtxNoteToolDeps): Record<string, ToolDefinition>;
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools/ctx-note/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAehE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAyND,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAWhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD;AA+ND,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}

package/dist/tools/ctx-reduce/tools.d.ts

@@ -1,5 +1,5 @@
-import type { Database } from "bun:sqlite";
 import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { Database } from "../../shared/sqlite";
 export interface CtxReduceToolDeps {
     db: Database;
     protectedTags: number;

package/dist/tools/ctx-reduce/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAahE,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD;AAuGD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAUhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD;AAuGD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-search/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAShE,OAAO,KAAK,EAAkC,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAyIjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAShE,OAAO,KAAK,EAAkC,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAoJjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

package/dist/tools/ctx-search/types.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from "bun:sqlite";
+import type { Database } from "../../shared/sqlite";
 /** Sources the agent can narrow ctx_search to. Facts are intentionally NOT a
  *  source — they're always rendered in <session-history> in message[0], so
  *  searching them returns content already visible in context. */
@@ -11,7 +11,13 @@ export interface CtxSearchArgs {
 }
 export interface CtxSearchToolDeps {
     db: Database;
-    projectPath: string;
+    /**
+     * Resolve the project identity for the session's directory at call time.
+     * See CtxMemoryToolDeps.resolveProjectPath for why this is a function:
+     * OpenCode's top-level `ctx.directory` reflects the launch dir, not the
+     * session's working directory.
+     */
+    resolveProjectPath: (directory: string) => string;
     memoryEnabled: boolean;
     embeddingEnabled: boolean;
     /** When true, ctx_search surfaces indexed git commits as a 3rd source. */

package/dist/tools/ctx-search/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;iEAEiE;AACjE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;AAElE,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,EAAE,CAAC;KACpB,CAAC,CAAC;CACN"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;iEAEiE;AACjE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;AAElE,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,EAAE,CAAC;KACpB,CAAC,CAAC;CACN"}

package/dist/tui/data/context-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui/data/context-db.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAA0B,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEpG,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAS9C,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,IAAI,IAAI,CAG/B;AA4ED,sDAAsD;AACtD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED,wDAAwD;AACxD,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CA4CvB;AAED,qCAAqC;AACrC,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ5E;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yDAAyD;AACzD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAchE"}
+{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui/data/context-db.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAA0B,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEpG,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAa9C,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,IAAI,IAAI,CAG/B;AA4ED,sDAAsD;AACtD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED,wDAAwD;AACxD,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CA4CvB;AAED,qCAAqC;AACrC,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ5E;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yDAAyD;AACzD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAchE"}

package/package.json

@@ -1,77 +1,75 @@
 {
-  "name": "@cortexkit/opencode-magic-context",
-  "version": "0.15.7",
-  "type": "module",
-  "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "opencode-magic-context": "dist/cli.js"
-  },
-  "author": "ualtinok",
-  "license": "MIT",
-  "keywords": [
-    "opencode",
-    "plugin",
-    "context",
-    "memory",
-    "ai",
-    "llm",
-    "prompt-caching",
-    "session-history"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/cortexkit/opencode-magic-context",
-    "directory": "packages/plugin"
-  },
-  "files": [
-    "dist",
-    "src/tui",
-    "src/shared",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @opencode-ai/plugin --external @huggingface/transformers && bun build src/cli/index.ts --outfile dist/cli.js --target node --format esm && tsc --emitDeclarationOnly",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.scripts.json",
-    "test": "bun test",
-    "lint": "biome check .",
-    "lint:fix": "biome check --write .",
-    "format": "biome format --write .",
-    "format:check": "biome format .",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "bun run build"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.1.0",
-    "@huggingface/transformers": "^4.1.0",
-    "@opencode-ai/plugin": "^1.2.26",
-    "@opencode-ai/sdk": "^1.2.26",
-    "ai-tokenizer": "^1.0.6",
-    "comment-json": "^4.6.2",
-    "zod": "^4.1.8"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "bun-types": "^1.3.10",
-    "typescript": "^5.8.0",
-    "@biomejs/biome": "^2.4.7"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./tui": {
-      "types": "./src/tui/index.tsx",
-      "import": "./src/tui/index.tsx"
-    }
-  },
-  "oc-plugin": [
-    "server",
-    "tui"
-  ],
-  "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.2.0"
-  }
+	"name": "@cortexkit/opencode-magic-context",
+	"version": "0.16.1",
+	"type": "module",
+	"description": "OpenCode plugin for Magic Context — cross-session memory and context management",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"author": "ualtinok",
+	"license": "MIT",
+	"keywords": [
+		"opencode",
+		"plugin",
+		"context",
+		"memory",
+		"ai",
+		"llm",
+		"prompt-caching",
+		"session-history"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/cortexkit/magic-context",
+		"directory": "packages/plugin"
+	},
+	"files": [
+		"dist",
+		"src/tui",
+		"src/shared",
+		"README.md"
+	],
+	"scripts": {
+		"build": "bun build src/index.ts --outdir dist --target node --format esm --external @opencode-ai/plugin --external @huggingface/transformers --external better-sqlite3 --external bun:sqlite && tsc --emitDeclarationOnly",
+		"typecheck": "tsc --noEmit && tsc -p tsconfig.scripts.json",
+		"test": "bun test",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"format": "biome format --write .",
+		"format:check": "biome format .",
+		"clean": "rm -rf dist",
+		"prepublishOnly": "bun run build"
+	},
+	"dependencies": {
+		"@huggingface/transformers": "^4.1.0",
+		"@opencode-ai/plugin": "^1.2.26",
+		"@opencode-ai/sdk": "^1.2.26",
+		"ai-tokenizer": "^1.0.6",
+		"better-sqlite3": "^12.9.0",
+		"comment-json": "^4.2.5",
+		"zod": "^4.1.8"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.7",
+		"@types/better-sqlite3": "^7.6.13",
+		"@types/node": "^22.0.0",
+		"bun-types": "^1.3.10",
+		"typescript": "^5.8.0"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./tui": {
+			"types": "./src/tui/index.tsx",
+			"import": "./src/tui/index.tsx"
+		}
+	},
+	"oc-plugin": [
+		"server",
+		"tui"
+	],
+	"peerDependencies": {
+		"@opencode-ai/plugin": ">=1.2.0"
+	}
 }

package/src/shared/conflict-detector.test.ts

@@ -50,7 +50,7 @@ describe("detectConflicts", () => {
         rmSync(userConfigDir, { recursive: true, force: true });
     });
 
-    function writeProjectConfig(plugins: string[]): void {
+    function writeProjectConfig(plugins: Array<string | [string, unknown]>): void {
         writeFileSync(join(projectDir, "opencode.json"), JSON.stringify({ plugin: plugins }));
     }
 
@@ -186,4 +186,47 @@ describe("detectConflicts", () => {
         const result = detectConflicts(projectDir);
         expect(result.hasConflict).toBe(false);
     });
+
+    // --- Tuple plugin entries (issue #49) ---
+    // OpenCode supports ["pkg@version", { ...options }] tuple form.
+    // The old code spread the raw array into the plugin list, causing
+    // matchesPackageName to receive an array instead of a string → crash.
+
+    describe("tuple plugin entries (issue #49)", () => {
+        it("does not crash when a plugin is defined as a [name, options] tuple", () => {
+            writeProjectConfig([
+                "@cortexkit/opencode-magic-context@latest",
+                ["@plannotator/opencode@latest", { workflow: "plan-agent" }],
+            ]);
+            expect(() => detectConflicts(projectDir)).not.toThrow();
+        });
+
+        it("detects DCP conflict when DCP is expressed as a tuple", () => {
+            writeProjectConfig([
+                "@cortexkit/opencode-magic-context@latest",
+                ["@tarquinen/opencode-dcp@latest", {}],
+            ]);
+            const result = detectConflicts(projectDir);
+            expect(result.conflicts.dcpPlugin).toBe(true);
+        });
+
+        it("detects OMO conflict when OMO is expressed as a tuple", () => {
+            writeProjectConfig([["oh-my-opencode@latest", {}]]);
+            const result = detectConflicts(projectDir);
+            expect(result.conflicts.omoPreemptiveCompaction).toBe(true);
+        });
+
+        it("does not crash on mixed string and tuple entries with unrelated packages", () => {
+            writeProjectConfig([
+                "oh-my-opencode-slim",
+                [
+                    "@plannotator/opencode@latest",
+                    { workflow: "plan-agent", planningAgents: ["plan"] },
+                ],
+                "@cortexkit/opencode-magic-context@latest",
+            ]);
+            const result = detectConflicts(projectDir);
+            expect(result.hasConflict).toBe(false);
+        });
+    });
 });

package/src/shared/conflict-detector.ts

@@ -7,7 +7,8 @@ interface OpenCodeConfig {
         auto?: boolean;
         prune?: boolean;
     };
-    plugin?: string[];
+    // OpenCode allows plugins as plain strings or [name, options] tuples.
+    plugin?: Array<string | [string, unknown]>;
 }
 
 interface OmoConfig {
@@ -223,9 +224,28 @@ function matchesPackageName(entry: string, canonicalNames: Set<string>): boolean
     return canonicalNames.has(nameOnly);
 }
 
+/** Extract the package-name string from a plugin entry.
+ *  OpenCode supports two forms:
+ *   - plain string:        "@scope/pkg@latest"
+ *   - tuple [name, opts]:  ["@scope/pkg@latest", { ... }]
+ *  Returns null for any other shape (numbers, objects, etc.). */
+function extractPluginName(entry: string | [string, unknown]): string | null {
+    if (typeof entry === "string") return entry;
+    if (Array.isArray(entry) && typeof entry[0] === "string") return entry[0];
+    return null;
+}
+
 function collectPluginEntries(directory: string): string[] {
     const plugins: string[] = [];
 
+    const pushFrom = (entries: Array<string | [string, unknown]> | undefined) => {
+        if (!entries) return;
+        for (const entry of entries) {
+            const name = extractPluginName(entry);
+            if (name) plugins.push(name);
+        }
+    };
+
     // Project-level configs
     for (const configPath of [
         join(directory, ".opencode", "opencode.jsonc"),
@@ -234,9 +254,7 @@ function collectPluginEntries(directory: string): string[] {
         join(directory, "opencode.json"),
     ]) {
         const config = readJsoncFile<OpenCodeConfig>(configPath);
-        if (config?.plugin) {
-            plugins.push(...config.plugin);
-        }
+        pushFrom(config?.plugin);
     }
 
     // User-level config
@@ -244,9 +262,7 @@ function collectPluginEntries(directory: string): string[] {
         const paths = getOpenCodeConfigPaths({ binary: "opencode" });
         for (const configPath of [paths.configJsonc, paths.configJson]) {
             const config = readJsoncFile<OpenCodeConfig>(configPath);
-            if (config?.plugin) {
-                plugins.push(...config.plugin);
-            }
+            pushFrom(config?.plugin);
         }
     } catch {
         // best-effort
@@ -265,7 +281,7 @@ function collectPluginEntries(directory: string): string[] {
  * `oh-my-opencode-cli`, etc.) are intentionally NOT matched here — they
  * don't ship the `preemptive-compaction`, `context-window-monitor`, or
  * `anthropic-context-window-limit-recovery` hooks that conflict with
- * Magic Context. See https://github.com/cortexkit/opencode-magic-context/issues/43.
+ * Magic Context. See https://github.com/cortexkit/magic-context/issues/43.
  *
  * The legacy `@code-yeongyu/` scope is no longer used — both names are
  * unscoped on npm.