@wolfx/opencode-magic-context 0.21.8-patch.1

package/dist/shared/transcript-opencode.d.ts

@@ -0,0 +1,71 @@
+/**
+ * OpenCode adapter for the harness-agnostic transcript interface.
+ *
+ * This is a thin proxy over OpenCode's `MessageLike[]` (i.e. `{ info,
+ * parts: unknown[] }[]`) — it does NOT copy data. Mutations through
+ * `setText`/`setToolOutput`/`replaceWithSentinel` write directly into
+ * the source `parts[]` arrays, exactly as the existing OpenCode-only
+ * transform code does today. `commit()` is a no-op because OpenCode's
+ * AI SDK reads `parts[]` back from the same array we mutated.
+ *
+ * This module is the boundary that lets the rest of the transform code
+ * (which moves to use the Transcript interface in 4b.2) work both for
+ * OpenCode and Pi without branching on harness type. By the end of 4b
+ * the only OpenCode-aware code in the plugin is this file plus
+ * `messages-transform.ts`.
+ *
+ * ## Mutation contract recap
+ *
+ * Magic Context's transform mutates message parts in three ways:
+ *
+ *  1. **Tag prefix injection** — prepends `§N§ ` to text parts and
+ *     tool result outputs. Repeated tagging is idempotent because
+ *     `prependTag` strips any existing prefix first.
+ *
+ *  2. **Sentinel replacement** — when a queued drop fires, the part is
+ *     replaced with a `[dropped §N§]` or `[truncated §N§]` placeholder.
+ *     The original tag number is preserved so the agent's mental
+ *     model of "what was here" survives.
+ *
+ *  3. **Structural noise stripping** — `step-start`/`step-finish`
+ *     wrappers and similar structural metadata are replaced with empty
+ *     sentinel parts so they don't consume tag numbers or get tagged
+ *     themselves.
+ *
+ * The OpenCode adapter implements (1) and (2) by editing `part.text` /
+ * `part.state.output` in place. For (3), structural parts surface as
+ * `kind: "structural"` so callers can filter them out. Adapter does NOT
+ * itself perform stripping — that's the transform pipeline's job, called
+ * after the adapter wraps the messages.
+ *
+ * Step 4b.1 ships the adapter alone. The existing OpenCode transform
+ * code keeps using `MessageLike[]` directly until 4b.2 migrates the
+ * tagging+drops layer to use Transcript instances.
+ */
+import type { Transcript } from "./transcript";
+/**
+ * The OpenCode `MessageLike` shape. Re-declared here to avoid a circular
+ * import with `tag-messages.ts` (which lives in the magic-context hooks
+ * tree and depends on storage). Keeping a local minimal type also makes
+ * the adapter trivially unit-testable without booting OpenCode SDK
+ * types.
+ *
+ * MUST stay structurally compatible with `tag-messages.ts MessageLike` —
+ * if that file's MessageLike adds a required field, this one needs to
+ * add it too. The build will fail loudly if the shapes diverge.
+ */
+export interface OpenCodeMessageLike {
+    info: {
+        id?: string;
+        role?: string;
+        sessionID?: string;
+    };
+    parts: unknown[];
+}
+/**
+ * Wrap an existing `MessageLike[]` as a Transcript. Zero copies — every
+ * `TranscriptPart` returned proxies the matching entry in the source
+ * `parts` array, and mutations are reflected immediately.
+ */
+export declare function createOpenCodeTranscript(messages: OpenCodeMessageLike[]): Transcript;
+//# sourceMappingURL=transcript-opencode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-opencode.d.ts","sourceRoot":"","sources":["../../src/shared/transcript-opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,KAAK,EACR,UAAU,EAIb,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,KAAK,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,UAAU,CA2BpF"}

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 `@earendil-works/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
+ * `@earendil-works/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

@@ -0,0 +1,10 @@
+/**
+ * Auto-configure tui.json with magic-context TUI plugin entry.
+ * Called from the server plugin at startup so the TUI sidebar loads on next restart.
+ */
+/**
+ * Ensure tui.json has the magic-context TUI plugin entry.
+ * Creates tui.json if it doesn't exist. Silently skips if already present.
+ */
+export declare function ensureTuiPluginEntry(): boolean;
+//# sourceMappingURL=tui-config.d.ts.map

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

@@ -0,0 +1 @@
+{"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-expand/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const CTX_EXPAND_DESCRIPTION: string;
+export declare const CTX_EXPAND_TOKEN_BUDGET = 15000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/ctx-expand/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-expand/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAGwD,CAAC;AAE5F,eAAO,MAAM,uBAAuB,QAAS,CAAC"}

package/dist/tools/ctx-expand/index.d.ts

@@ -0,0 +1,2 @@
+export { createCtxExpandTools } from "./tools";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/ctx-expand/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-expand/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+export declare function createCtxExpandTools(): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-expand/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAqDhE,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIrE"}

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

@@ -0,0 +1,5 @@
+export interface CtxExpandArgs {
+    start: number;
+    end: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-expand/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf"}

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

@@ -0,0 +1,4 @@
+export declare const CTX_MEMORY_TOOL_NAME = "ctx_memory";
+export declare const CTX_MEMORY_DESCRIPTION = "Manage cross-session project memories. Primary sessions can write new memories or delete stale ones. Dreamer sessions can also list, update, merge, and archive memories. Memories persist across sessions and are automatically injected into new sessions.\n\nSupported actions: write, delete, list, update, merge, archive.";
+export declare const DEFAULT_SEARCH_LIMIT = 10;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,sBAAsB,oUAE6B,CAAC;AACjE,eAAO,MAAM,oBAAoB,KAAK,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from "./constants";
+export * from "./tools";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import { type CtxMemoryToolDeps } from "./types";
+export declare function createCtxMemoryTools(deps: CtxMemoryToolDeps): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +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;AAyBhE,OAAO,EAIH,KAAK,iBAAiB,EACzB,MAAM,SAAS,CAAC;AA+djB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

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

@@ -0,0 +1,35 @@
+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];
+export interface CtxMemoryArgs {
+    action: CtxMemoryAction;
+    content?: string;
+    category?: string;
+    id?: number;
+    ids?: number[];
+    limit?: number;
+    reason?: string;
+}
+export interface CtxMemoryToolDeps {
+    db: Database;
+    ensureProjectRegistered?: (directory: string, db: Database) => Promise<void>;
+    /**
+     * 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[];
+    sourceType?: MemorySourceType;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"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,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;;;;;;;OAUG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC"}

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

@@ -0,0 +1,2 @@
+export declare const CTX_NOTE_DESCRIPTION = "Save or inspect durable session notes that persist for this session.\nUse this for short goals, constraints, decisions, or reminders worth carrying forward.\n\nActions:\n- `write`: Append one note. Optionally provide `surface_condition` to create a smart note.\n- `read`: Show current notes. Defaults to active session notes + ready smart notes; use `filter` to inspect all, pending, ready, active, or dismissed notes.\n- `dismiss`: Dismiss a note by `note_id`.\n- `update`: Update a note by `note_id`.\n\n**Smart Notes**: When `surface_condition` is provided with `write`, the note becomes a project-scoped smart note. A separate background process (the dreamer) periodically checks the condition using ONLY external, verifiable signals: GitHub state via `gh` CLI, web pages, files on disk, git history, etc. The dreamer cannot read your current conversation, cannot detect when the user says something, and has no memory of context that lives only in this session.\n\nWrite a smart note ONLY when the surface_condition is something an external agent with read-only tools can definitively check:\n\n\u2713 GOOD conditions (externally verifiable):\n- \"When PR #42 in cortexkit/magic-context is merged\"\n- \"When the file packages/plugin/src/foo.ts contains a function named bar\"\n- \"When the latest release tag is >= v0.22.0\"\n- \"When the GitHub Actions workflow runs/123 succeeds\"\n\n\u2717 BAD conditions (require knowing this session's context):\n- \"When the user mentions the worktree system has landed\"  \u2192 dreamer cannot see user messages\n- \"When they ask to re-run the audit fixes\"                \u2192 dreamer cannot see future requests\n- \"When we revisit this code path\"                         \u2192 no observable signal\n- \"When relevant to the current discussion\"                \u2192 no observable signal\n- \"After we finish the current refactor\"                   \u2192 no externally checkable boundary\n\nIf you want context that surfaces based on what's happening in your session, use a regular note (omit surface_condition) \u2014 those show up on natural work boundaries within this session. If you want a reminder tied to your future work without a clean external trigger, just write a regular note describing what to do; you'll see it when you read notes later.\n\nExample: `ctx_note(action=\"write\", content=\"Implement X because Y\", surface_condition=\"When PR #42 in cortexkit/magic-context is merged\")`\n\nHistorian reads these notes, deduplicates them, and rewrites the remaining useful notes over time.";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,mgFA8BkE,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from "./constants";
+export * from "./tools";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,15 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { Database } from "../../shared/sqlite";
+export interface CtxNoteToolDeps {
+    db: Database;
+    dreamerEnabled?: boolean;
+    /**
+     * 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

@@ -0,0 +1 @@
+{"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;AA2OD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}

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

@@ -0,0 +1,9 @@
+export type CtxNoteReadFilter = "all" | "active" | "pending" | "ready" | "dismissed";
+export interface CtxNoteArgs {
+    action?: "write" | "read" | "dismiss" | "update";
+    content?: string;
+    surface_condition?: string;
+    filter?: CtxNoteReadFilter;
+    note_id?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAErF,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,2 @@
+export declare const CTX_REDUCE_DESCRIPTION = "Reduce context by dropping tagged content you no longer need.\nUse \u00A7N\u00A7 identifiers visible in conversation. The `drop` param accepts ranges: \"3-5\", \"1,2,9\", \"1-5,8\".\n\nCRITICAL RULES:\n- NEVER blanket-drop large ranges (e.g., \"1-50\"). Always review what each tag contains first.\n- Only drop tool outputs you have already processed and no longer need.\n- Protected tags are accepted but deferred until they leave the last protected range.\n- Keep recent context \u2014 only reduce OLD content that is no longer relevant to current work.\n- Dropped content is gone forever.";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,olBAQA,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from "./constants";
+export * from "./tools";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,9 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { Database } from "../../shared/sqlite";
+export interface CtxReduceToolDeps {
+    db: Database;
+    protectedTags: number;
+    getSessionTokens?: (sessionId: string) => number;
+}
+export declare function createCtxReduceTools(deps: CtxReduceToolDeps): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"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-reduce/types.d.ts

@@ -0,0 +1,4 @@
+export interface CtxReduceArgs {
+    drop?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-reduce/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,4 @@
+export declare const CTX_SEARCH_TOOL_NAME = "ctx_search";
+export declare const CTX_SEARCH_DESCRIPTION: string;
+export declare const DEFAULT_CTX_SEARCH_LIMIT = 10;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,sBAAsB,QAkBvB,CAAC;AACb,eAAO,MAAM,wBAAwB,KAAK,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from "./constants";
+export * from "./tools";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-search/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { CtxSearchToolDeps } from "./types";
+export declare function createCtxSearchTools(deps: CtxSearchToolDeps): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +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;AAahE,OAAO,KAAK,EAAkC,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAiKjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAI5F"}

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

@@ -0,0 +1,34 @@
+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. */
+export type CtxSearchSource = "memory" | "message" | "git_commit";
+export interface CtxSearchArgs {
+    query: string;
+    limit?: number;
+    /** Restrict search to specific sources. Omit to search all. */
+    sources?: CtxSearchSource[];
+}
+export interface CtxSearchToolDeps {
+    db: Database;
+    ensureProjectRegistered?: (directory: string, db: Database) => Promise<void>;
+    /**
+     * 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. */
+    gitCommitsEnabled?: boolean;
+    /** Override message reader for testing (avoids opening OpenCode DB in CI). */
+    readMessages?: (sessionId: string) => Array<{
+        ordinal: number;
+        id: string;
+        role: string;
+        parts: unknown[];
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"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,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,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/tools/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./ctx-expand";
+export * from "./ctx-memory";
+export * from "./ctx-note";
+export * from "./ctx-reduce";
+export * from "./ctx-search";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}