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

package/dist/agents/dreamer.d.ts

@@ -0,0 +1,2 @@
+export declare const DREAMER_AGENT = "dreamer";
+//# sourceMappingURL=dreamer.d.ts.map

package/dist/agents/dreamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreamer.d.ts","sourceRoot":"","sources":["../../src/agents/dreamer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,YAAY,CAAC"}

package/dist/agents/historian.d.ts

@@ -0,0 +1,3 @@
+export declare const HISTORIAN_AGENT = "historian";
+export declare const HISTORIAN_EDITOR_AGENT = "historian-editor";
+//# sourceMappingURL=historian.d.ts.map

package/dist/agents/historian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historian.d.ts","sourceRoot":"","sources":["../../src/agents/historian.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,cAAc,CAAC;AAC3C,eAAO,MAAM,sBAAsB,qBAAqB,CAAC"}

package/dist/agents/magic-context-prompt.d.ts

@@ -0,0 +1,3 @@
+/** Generic magic context system prompt section shared by all agents. */
+export declare function buildMagicContextSection(_agent: string | null, protectedTags: number, ctxReduceEnabled?: boolean, dreamerEnabled?: boolean, dropToolStructure?: boolean, temporalAwarenessEnabled?: boolean, cavemanTextCompressionEnabled?: boolean): string;
+//# sourceMappingURL=magic-context-prompt.d.ts.map

package/dist/agents/magic-context-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-context-prompt.d.ts","sourceRoot":"","sources":["../../src/agents/magic-context-prompt.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAmFxE,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,UAAO,EACvB,cAAc,UAAQ,EACtB,iBAAiB,UAAO,EACxB,wBAAwB,UAAQ,EAChC,6BAA6B,UAAQ,GACtC,MAAM,CAiBR"}

package/dist/agents/permissions.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Permission rulesets for Magic Context's hidden subagents.
+ *
+ * # Why this exists
+ *
+ * Hidden agents (`historian`, `historian-editor`, `dreamer`, `sidekick`) are
+ * registered with `mode: "subagent"` and `hidden: true`, but those flags
+ * only control visibility in the UI picker — they do NOT restrict which
+ * tools the spawned session can call. By default a registered subagent
+ * inherits the FULL primary-agent tool surface: `task`, `bash`, `edit`,
+ * `webfetch`, `websearch`, `read`, `grep`, `glob`, every MCP tool, etc.
+ *
+ * That default is wrong for our agents:
+ *   - Historian should be a pure XML-emitting summarizer. It must not
+ *     dispatch `task(subagent_type=explore)` to fan out, edit files,
+ *     run bash, or fetch the web — its job is to read offloaded state
+ *     files and emit `<compartment>` blocks.
+ *   - The `task` permission only gets auto-denied when an agent is
+ *     INVOKED via the parent's `task()` tool (see OpenCode's
+ *     `deriveSubagentSessionPermission`). Our hidden agents are spawned
+ *     directly via `client.session.prompt(...)` from the plugin
+ *     runtime, so that auto-deny never fires — they get the same
+ *     `task` permission as a primary `build` agent.
+ *
+ * # Design
+ *
+ * Each hidden agent's `permission` field starts with `{ "*": "deny" }`
+ * and adds explicit `allow` entries for ONLY the tool ids it needs.
+ * OpenCode's `Permission.fromConfig` converts this flat map into a
+ * `Rule[]` ruleset where later entries override earlier ones, so the
+ * named allows always win against the wildcard deny.
+ *
+ * This is the same pattern OpenCode's own `explore` subagent uses
+ * (see `packages/opencode/src/agent/agent.ts:179-201`).
+ *
+ * User-supplied agent overrides (`pluginConfig.historian.permission`,
+ * etc.) still merge on top via OpenCode's `Permission.merge`, so
+ * advanced users can extend the allow-list without us blocking them.
+ *
+ * # What each agent needs
+ *
+ *   - **historian / historian-editor / compressor**: `read` plus the
+ *     read-only AFT navigation tools `aft_outline` and `aft_zoom`.
+ *     The runner offloads large existing-state XML to a temp file
+ *     under `<project>/.opencode/magic-context/historian/` and the
+ *     prompt instructs the model to read that file. AFT navigation
+ *     is allowed so historian can verify a symbol or file structure
+ *     when writing accurate compartment summaries.
+ *
+ *   - **dreamer**: `read`, `grep`, `glob`, `bash`, the read-only AFT
+ *     navigation tools `aft_outline` and `aft_zoom`, plus the Magic
+ *     Context MCP tools `ctx_memory`, `ctx_search`, `ctx_note`.
+ *     Dreamer task prompts in
+ *     `features/magic-context/dreamer/task-prompts.ts` explicitly tell
+ *     the model to grep schema files for defaults, read source to
+ *     confirm claims, run `git log` / `gh` / `curl` for verify and
+ *     smart-note evaluation, and use glob/find for directory
+ *     inventory. Live DB shows >100 bash invocations across all
+ *     dreamer task variants. `task` / `edit` / `write` / `webfetch` /
+ *     `websearch` remain denied — dreamer must not spawn subagents
+ *     or commit changes.
+ *
+ *   - **sidekick**: `ctx_search`, `ctx_memory`, plus the read-only AFT
+ *     navigation tools `aft_outline` and `aft_zoom`. Sidekick's job
+ *     is augmenting user prompts via memory retrieval — see
+ *     `features/magic-context/sidekick/agent.ts`. AFT navigation lets
+ *     it pull symbol-scoped structural context for prompts that
+ *     reference a specific file or symbol.
+ */
+/**
+ * Build a `permission` map suitable for `AgentConfig.permission`. Starts
+ * with a wildcard deny, then layers in the named tool allows on top.
+ * OpenCode's `Permission.fromConfig` preserves insertion order and its
+ * `evaluate` uses `findLast`, so named allows defeat the wildcard deny.
+ *
+ * Returns `Record<string, "deny" | "allow">` which the SDK's
+ * `AgentConfig.permission` type accepts via its `[key: string]: unknown`
+ * index signature. The same pattern is used by OpenCode's built-in
+ * `explore`/`scout`/`general` agents and by Alfonso for its static
+ * agent profiles.
+ */
+export declare function buildAllowOnlyPermission(allowedTools: readonly string[]): Record<string, "deny" | "allow">;
+/**
+ * Tools the historian + historian-editor + compressor agents need.
+ *
+ * Historian runners offload large `<existing_state>` XML to disk and
+ * tell the model to `read` it before emitting the summary XML. The
+ * core need is `read`; we also allow the read-only AFT navigation
+ * tools `aft_outline` and `aft_zoom` so that if a historian/compressor
+ * ever needs to verify a symbol or skim a file's structure to write
+ * an accurate compartment summary, it can do so token-efficiently
+ * instead of pulling whole files via `read`.
+ *
+ * Still denied: bash, edit, write, task, grep/glob, webfetch/
+ * websearch. Historian's job is summarizing the input it was given,
+ * not exploring the repo.
+ */
+export declare const HISTORIAN_ALLOWED_TOOLS: readonly ["read", "aft_outline", "aft_zoom"];
+/**
+ * Tools the dreamer agent needs. This is the broadest hidden-agent
+ * surface because dreamer's tasks legitimately require local-repo
+ * exploration plus external command execution:
+ *
+ *   - `ctx_memory` / `ctx_search` / `ctx_note` — the canonical memory
+ *     CRUD and retrieval path for consolidate / verify / archive /
+ *     improve and smart-note dismissal.
+ *   - `read` / `grep` / `glob` — the verify task prompt
+ *     (`task-prompts.ts`) explicitly tells the model to grep schema
+ *     files for default values, read source to confirm claimed
+ *     behavior, and use glob for project structure inventory.
+ *   - `bash` — required for smart-note condition evaluation (the
+ *     prompt explicitly mentions `gh` / `git` / `curl` / file reads),
+ *     for the verify task's `git log --oneline --since=...` step, and
+ *     for the improve task's `find` / `grep` directory inventory. The
+ *     live OpenCode DB shows over 100 `bash` invocations across
+ *     consolidate / verify / improve / archive-stale / smart-notes
+ *     dreamer child sessions, so removing it would regress real,
+ *     documented dreamer behavior.
+ *
+ * Deliberately NOT allowed:
+ *   - `task` — no subagent fanout from dreamer
+ *   - `edit` / `write` — dreamer must not modify project files;
+ *     `task-prompts.ts` explicitly states "Do not commit changes"
+ *   - `webfetch` / `websearch` — out of scope; smart-note URL fetches
+ *     go through `bash` + `curl` instead
+ */
+export declare const DREAMER_ALLOWED_TOOLS: readonly ["read", "grep", "glob", "bash", "aft_outline", "aft_zoom", "ctx_memory", "ctx_search", "ctx_note"];
+/**
+ * Tools the sidekick agent needs. Sidekick is a read-only memory
+ * retriever for `/ctx-aug` — it queries the project's memory store
+ * via `ctx_search` and (rarely) reads specific memories with
+ * `ctx_memory(action="list")`.
+ *
+ * Also allow `aft_outline` and `aft_zoom` so sidekick can pull
+ * lightweight structural context about a file or symbol when the
+ * user's prompt references it directly — token-efficient navigation
+ * without dragging in whole files.
+ *
+ * Still denied: spawning subagents, edits, bash, web fetches.
+ */
+export declare const SIDEKICK_ALLOWED_TOOLS: readonly ["ctx_search", "ctx_memory", "aft_outline", "aft_zoom"];
+//# sourceMappingURL=permissions.d.ts.map

package/dist/agents/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/agents/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,SAAS,MAAM,EAAE,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAMlC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,8CAA+C,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,qBAAqB,8GAUxB,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,kEAKzB,CAAC"}

package/dist/agents/sidekick.d.ts

@@ -0,0 +1,2 @@
+export declare const SIDEKICK_AGENT = "sidekick";
+//# sourceMappingURL=sidekick.d.ts.map

package/dist/agents/sidekick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidekick.d.ts","sourceRoot":"","sources":["../../src/agents/sidekick.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,aAAa,CAAC"}

package/dist/config/agent-disable.d.ts

@@ -0,0 +1,26 @@
+export declare function isAgentDisabled(agent?: {
+    disable?: boolean;
+} | null): boolean;
+export declare function isDreamerRunnable(config: {
+    dreamer?: {
+        disable?: boolean;
+    } | null;
+}): boolean;
+export declare function isDreamerScheduled(config: {
+    dreamer?: {
+        disable?: boolean;
+        schedule?: string;
+    } | null;
+}): boolean;
+export declare function isSidekickRunnable(config: {
+    sidekick?: {
+        disable?: boolean;
+    } | null;
+}): boolean;
+export declare function isHistorianRunnable(config: {
+    historian?: {
+        disable?: boolean;
+    } | null;
+}): boolean;
+export declare function migrateLegacyAgentEnabledInMemory(rawConfig: Record<string, unknown>, warnings: string[]): Record<string, unknown>;
+//# sourceMappingURL=agent-disable.d.ts.map

package/dist/config/agent-disable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-disable.d.ts","sourceRoot":"","sources":["../../src/config/agent-disable.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,OAAO,CAE7E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAE7F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACvC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7D,GAAG,OAAO,CAEV;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAE/F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAEjG;AAmDD,wBAAgB,iCAAiC,CAC7C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,EAAE,MAAM,EAAE,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/dist/config/index.d.ts

@@ -0,0 +1,33 @@
+import { type MagicContextConfig } from "./schema/magic-context";
+export interface MagicContextPluginConfig extends MagicContextConfig {
+    disabled_hooks?: string[];
+    command?: Record<string, {
+        template: string;
+        description?: string;
+        agent?: string;
+        model?: string;
+        subtask?: boolean;
+    }>;
+}
+export type LoadOutcome = "ok" | "project-file-parse-error" | "project-file-io-error" | "schema-recovery" | "substitution-failure";
+export interface LoadResultDetailed {
+    config: MagicContextPluginConfig & {
+        configWarnings?: string[];
+    };
+    loadOutcome: LoadOutcome;
+    sources: {
+        userConfig: LoadOutcome;
+        projectConfig: LoadOutcome;
+    };
+    substitutionFailures: Array<{
+        keyPath: string;
+        source: "user" | "project";
+        message: string;
+    }>;
+    recoveredTopLevelKeys: string[];
+}
+export declare function loadPluginConfig(directory: string): MagicContextPluginConfig & {
+    configWarnings?: string[];
+};
+export declare function loadPluginConfigDetailed(directory: string): LoadResultDetailed;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,wBAAwB,CAAC;AAG3F,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAChE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CACZ,MAAM,EACN;QACI,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACrB,CACJ,CAAC;CACL;AAmBD,MAAM,MAAM,WAAW,GACjB,IAAI,GACJ,0BAA0B,GAC1B,uBAAuB,GACvB,iBAAiB,GACjB,sBAAsB,CAAC;AAE7B,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,wBAAwB,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjE,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE;QACL,UAAU,EAAE,WAAW,CAAC;QACxB,aAAa,EAAE,WAAW,CAAC;KAC9B,CAAC;IACF,oBAAoB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACnC;AAmWD,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,GAClB,wBAAwB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA2E1D;AAgDD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAuE9E"}

package/dist/config/schema/agent-overrides.d.ts

@@ -0,0 +1,55 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import { z } from "zod";
+export declare const MAGIC_CONTEXT_AGENT_OVERRIDE_KEYS: readonly ["historian", "dreamer", "sidekick"];
+export declare const AgentOverrideConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    top_p: z.ZodOptional<z.ZodNumber>;
+    prompt: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    disable: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        subagent: "subagent";
+        primary: "primary";
+        all: "all";
+    }>>;
+    color: z.ZodOptional<z.ZodString>;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+    permission: z.ZodOptional<z.ZodObject<{
+        edit: z.ZodOptional<z.ZodEnum<{
+            deny: "deny";
+            allow: "allow";
+            ask: "ask";
+        }>>;
+        bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            deny: "deny";
+            allow: "allow";
+            ask: "ask";
+        }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
+            deny: "deny";
+            allow: "allow";
+            ask: "ask";
+        }>>]>>;
+        webfetch: z.ZodOptional<z.ZodEnum<{
+            deny: "deny";
+            allow: "allow";
+            ask: "ask";
+        }>>;
+        doom_loop: z.ZodOptional<z.ZodEnum<{
+            deny: "deny";
+            allow: "allow";
+            ask: "ask";
+        }>>;
+        external_directory: z.ZodOptional<z.ZodEnum<{
+            deny: "deny";
+            allow: "allow";
+            ask: "ask";
+        }>>;
+    }, z.core.$strip>>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    variant: z.ZodOptional<z.ZodString>;
+    fallback_models: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema> & Partial<AgentConfig>;
+//# sourceMappingURL=agent-overrides.d.ts.map

package/dist/config/schema/agent-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-overrides.d.ts","sourceRoot":"","sources":["../../../src/config/schema/agent-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iCAAiC,+CAAgD,CAAC;AAgB/F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC"}