@retaw106/mmc-oc 0.0.0-stage → 1.2.1

package/dist/shared/prompt-surface-a1-golden.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared accessors for the A1 prompt-surface golden.
+ *
+ * The golden (`prompt-surface-a1-golden.md`, generated by
+ * `scripts/export-agent-surface.ts`) is read by tests in BOTH packages, and its
+ * section headings are the contract between the generator and those readers.
+ * Keeping the path, the heading strings, and the offset guard here means a
+ * change to the golden's section format is a one-file edit rather than a hunt
+ * across packages.
+ *
+ * This module resolves the golden relative to ITSELF, so consumers never carry
+ * their own `../..` path arithmetic — that arithmetic differs per package and is
+ * exactly the kind of thing that rots silently when files move.
+ */
+export declare const A1_TOOL_SECTION_HEADING = "## 2. Tool surface";
+export declare const A1_HASH_BASELINE_HEADING = "## 3. System-prompt hash baseline";
+export declare function readA1GoldenDocument(): string;
+/**
+ * Locate a golden section heading, refusing to continue when it is absent.
+ *
+ * A bare `indexOf` returns -1 for a missing heading, and `slice(start, -1)`
+ * silently yields an empty (or truncated) section rather than failing: the
+ * golden then parses as ZERO tools and the consuming test passes by comparing
+ * empty to empty. Failing loudly here keeps a malformed golden from reading as a
+ * clean run.
+ */
+export declare function a1GoldenSectionOffset(document: string, heading: string): number;
+//# sourceMappingURL=prompt-surface-a1-golden.d.ts.map

package/dist/shared/prompt-surface-a1-golden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface-a1-golden.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface-a1-golden.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAE5E,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM/E"}

package/dist/shared/prompt-surface-runtime.d.ts

@@ -0,0 +1,62 @@
+import type { HarnessId } from "./harness";
+import { type PromptSurfaceConfig, type PromptSurfacePreset } from "./prompt-surface";
+/**
+ * The single source of truth for the mmc_* tools exposed by the prompt surface.
+ * Consumers derive their registries and light-description catalogs from this list
+ * so adding a tool cannot silently skip one prompt-surface integration point.
+ */
+export declare const ACTIVE_TOOL_IDS: readonly ["mmc_reduce", "mmc_expand", "mmc_note", "mmc_memory", "mmc_search"];
+/** @deprecated Use ACTIVE_TOOL_IDS. Kept as an alias for existing consumers. */
+export declare const PROMPT_SURFACE_TOOL_IDS: readonly ["mmc_reduce", "mmc_expand", "mmc_note", "mmc_memory", "mmc_search"];
+export type PromptSurfaceToolId = (typeof ACTIVE_TOOL_IDS)[number];
+export declare const LIGHT_TOOL_DESCRIPTIONS: {
+    readonly mmc_reduce: "Stamp an item as no longer needed for the work ahead. Not a delete: stamping QUEUES it, the item stays readable until Magic Context clears stamped items in one sweep, newest tags are protected, and a cleared item goes to the archive (recent: a [dropped §N§] placeholder; older: removed) recoverable via mmc_expand(tag=N). The question is \"does this need to stay on my desk for what comes next?\" — a file you keep editing stays, the grep that found it goes. Stamp used reads/searches/outputs, acted-on build/test output, redundant dumps, extracted pasted payloads; keep user messages, your own text, unresolved errors, raw evidence, exact wording that may matter. Look at each tag; never blanket-stamp \"1-50\". Grammar: \"3-5\", \"1,2,9\", \"1-5,8,12-15\".";
+    readonly mmc_expand: "Recover one item with tag=N (a §N§ or dropped placeholder number), not a message ordinal; text or one tool call with full input/output. message=N and start/end are whole-message ordinals from history/search, never tag numbers. Recover raw conversation behind a <session-history> heading or around a mmc_search hit: mmc_expand(start, end) returns [N] U:/A: lines (~15K-token cap; oversized ranges return the head and where to continue). verbose=true lists messages with per-part previews to pick one; message=N returns that message in full, including a tool output released with mmc_reduce. Ranges after the last compartment are your live tail, not expandable.";
+    readonly mmc_note: "Session notes are pending intentions: work you intend to return to, with findings attached (\"take a note\" always qualifies). Not active steps, an executing plan, or restart insurance; a record of how things stand (world-state, a design at a point in time) with nothing you intend to do about it — that goes stale silently; a fact worth keeping is memory, the rest is nothing. First line = title (<80 chars). write saves; read lists rows (note_ids for bodies); update changes one; dismiss retires 1–50. Dismiss a note when its work lands or is abandoned; a queue you never dismiss from stops being read.";
+    readonly mmc_memory: "Durable facts about this project, shared with every agent on it and kept for the months this work lasts; active ones are already in <project-memory> as `#id: fact`. Write one standalone fact when it must not have to be found again — a rule, an architecture fact, a constraint, a config value, a naming convention — especially what cost you turns. A pending intention with evidence is mmc_note, not memory. write (content + category); update one id (content; category optional); archive one or more ids (reason optional); merge two or more ids (content); get 1–20 ids in any status.";
+    readonly mmc_search: "Search the archive — everything that ever happened here that is not on your desk: memories not in <project-memory>, compacted conversation, notes. Phrase query as a natural-language question carrying the exact terms you expect (\"where is the opencode source code path?\", \"why did we choose SQLite over postgres?\", \"how does the historian lease work?\") — a keyword stack finds less. Sources (omit for all): memory (rules, conventions), message (compacted conversation; hits carry ordinals for mmc_expand), note (parked follow-ups). Memory ids alone (`#7234`) resolve directly. from/to restrict every source to an inclusive UTC date range.";
+};
+/**
+ * Preserve the existing full-preset hash exactly while giving other presets a
+ * distinct semantic cache identity, including during any future asset fallback.
+ */
+export declare function promptSurfaceHashMaterial(systemContent: string, preset?: PromptSurfacePreset): string;
+export interface PromptSurfaceGuidanceSelection {
+    /** The configured built-in preset. */
+    preset: PromptSurfacePreset;
+    /** Complete user-authored primary section captured when a model-key epoch starts. */
+    primaryOverride?: string;
+}
+export interface PromptSurfaceRegistrationSelection {
+    preset: PromptSurfacePreset;
+    descriptionFor: (toolId: string, fullDescription: string) => string;
+}
+export interface PromptSurfaceRuntime {
+    resolveRegistration: (config: PromptSurfaceConfig | undefined, modelKey?: string) => PromptSurfaceRegistrationSelection;
+    resolveGuidance: (config: PromptSurfaceConfig | undefined, modelKey: string | undefined) => PromptSurfaceGuidanceSelection;
+}
+export interface CreatePromptSurfaceRuntimeOptions {
+    /** Optional harness tag; retained for call-site compatibility and diagnostics. */
+    harness?: HarnessId;
+    directory?: string;
+    /** Explicit test/integration seam; production derives the USER config directory. */
+    userConfigDirectory?: string;
+    warn: (message: string) => void;
+}
+/**
+ * Create one host-registration runtime. Its warning set is shared by tool
+ * registration and every guidance epoch, so invalid overrides are reported once
+ * instead of on every model call.
+ */
+export declare function createPromptSurfaceRuntime(options: CreatePromptSurfaceRuntimeOptions): PromptSurfaceRuntime;
+export interface PromptSurfaceGuidanceEpochCache {
+    resolve: (sessionId: string, config: PromptSurfaceConfig | undefined, modelKey: string | undefined) => PromptSurfaceGuidanceSelection;
+    clear: (sessionId: string) => void;
+}
+/**
+ * Freeze preset selection and materialized override bytes for one model-key epoch.
+ * Every hook using the same runtime also shares this cache, so a file edit cannot
+ * make the system hook and Rust adapter observe different bytes within one epoch.
+ */
+export declare function createPromptSurfaceGuidanceEpochCache(runtime: PromptSurfaceRuntime): PromptSurfaceGuidanceEpochCache;
+//# sourceMappingURL=prompt-surface-runtime.d.ts.map

package/dist/shared/prompt-surface-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface-runtime.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface-runtime.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACH,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAE3B,MAAM,kBAAkB,CAAC;AAK1B;;;;GAIG;AACH,eAAO,MAAM,eAAe,+EAMlB,CAAC;AAEX,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,+EAAkB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,uBAAuB;;;;;;CAM8B,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,mBAA4B,GACrC,MAAM,CAIR;AAID,MAAM,WAAW,8BAA8B;IAC3C,sCAAsC;IACtC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kCAAkC;IAC/C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;CACvE;AAED,MAAM,WAAW,oBAAoB;IACjC,mBAAmB,EAAE,CACjB,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,CAAC,EAAE,MAAM,KAChB,kCAAkC,CAAC;IACxC,eAAe,EAAE,CACb,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAC3B,8BAA8B,CAAC;CACvC;AAED,MAAM,WAAW,iCAAiC;IAC9C,kFAAkF;IAClF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAWD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,iCAAiC,GAC3C,oBAAoB,CAmGtB;AAQD,MAAM,WAAW,+BAA+B;IAC5C,OAAO,EAAE,CACL,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAC3B,8BAA8B,CAAC;IACpC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAOD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACjD,OAAO,EAAE,oBAAoB,GAC9B,+BAA+B,CAuBjC"}

package/dist/shared/prompt-surface.d.ts

@@ -0,0 +1,53 @@
+/** The built-in prompt-surface variants. */
+export type PromptSurfacePreset = "full" | "light";
+/**
+ * The configuration consumed by prompt-surface resolution. The schema adds
+ * validation and defaults; this structural type keeps the resolver usable by
+ * every host without importing a config loader.
+ */
+export interface PromptSurfaceConfig {
+    default?: PromptSurfacePreset;
+    models?: Readonly<Record<string, PromptSurfacePreset>>;
+    guidance_override_path?: string;
+    tool_descriptions?: Readonly<Record<string, string>>;
+}
+/** Stable wire identity for the config fields that can alter a served prompt surface. */
+export declare function promptSurfaceConfigIdentity(config: PromptSurfaceConfig | undefined): string;
+export type PromptSurfaceResolutionSource = "exact" | "bare" | "wildcard" | "default";
+/** Validate bare model, provider/model, and provider/* routing keys. */
+export declare function isValidPromptSurfaceModelKey(key: string): boolean;
+export type ModelKeyLookupSource = Exclude<PromptSurfaceResolutionSource, "default">;
+export interface ModelKeyCandidate {
+    key: string;
+    source: ModelKeyLookupSource;
+}
+/**
+ * Return the same progressive model-key candidates used by cache_ttl. The
+ * provider/model boundary is the first slash; the rest of the string remains
+ * the model ID, including additional slashes. Candidates are case-sensitive.
+ *
+ * Known harness provider aliases are checked canonical-first at each specificity,
+ * so one shared config works on every harness and canonical wins on collisions.
+ * Provider wildcards are checked after progressively less-specific model keys,
+ * but before the caller's default. That keeps an exact or base-model override
+ * authoritative while still allowing `provider/*` to cover otherwise-unlisted
+ * models.
+ */
+export declare function modelKeyLookupOrder(modelKey: string | undefined): ModelKeyCandidate[];
+/** Resolve one per-model value using the shared cache_ttl lookup walk. */
+export declare function resolveModelConfigValue<T>(values: Readonly<Record<string, T>> | undefined, modelKey: string | undefined): {
+    value: T;
+    source: ModelKeyLookupSource;
+} | undefined;
+/**
+ * Resolve the prompt preset for a model. Invalid or missing model keys use the
+ * configured default and are reported as a default resolution rather than a
+ * partial match.
+ */
+export declare function resolvePromptSurface(config: PromptSurfaceConfig | undefined, modelKey: string | undefined): {
+    preset: PromptSurfacePreset;
+    source: PromptSurfaceResolutionSource;
+};
+/** Resolve a cache_ttl-style value with the shared model-key walk. */
+export declare function resolveModelConfigOrDefault<T>(values: Readonly<Record<string, T>>, modelKey: string | undefined, fallback: T): T;
+//# sourceMappingURL=prompt-surface.d.ts.map

package/dist/shared/prompt-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACvD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAW3F;AAED,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtF,wEAAwE;AACxE,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAyBjE;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,6BAA6B,EAAE,SAAS,CAAC,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAoCrF;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,CAAC,EACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,EAC/C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG,SAAS,CAWxD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,6BAA6B,CAAA;CAAE,CASxE;AAED,sEAAsE;AACtE,wBAAgB,2BAA2B,CAAC,CAAC,EACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,CAAC,GACZ,CAAC,CAEH"}

package/dist/shared/provider-response-completion.d.ts

@@ -0,0 +1,12 @@
+/** Failure markers take precedence over a completion timestamp or token usage. */
+export declare function providerResponseFailed(input: {
+    finish?: unknown;
+    error?: unknown;
+}): boolean;
+/** A terminal, non-failed assistant response can refresh a cache without usage. */
+export declare function isSuccessfulProviderCompletion(input: {
+    completedAt?: unknown;
+    finish?: unknown;
+    error?: unknown;
+}): boolean;
+//# sourceMappingURL=provider-response-completion.d.ts.map

package/dist/shared/provider-response-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-response-completion.d.ts","sourceRoot":"","sources":["../../src/shared/provider-response-completion.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAM5F;AAED,mFAAmF;AACnF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAQV"}

package/dist/shared/record-type-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=record-type-guard.d.ts.map

package/dist/shared/record-type-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-type-guard.d.ts","sourceRoot":"","sources":["../../src/shared/record-type-guard.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/shared/redaction.d.ts

@@ -0,0 +1,7 @@
+export declare function isSecretKey(key: string): boolean;
+export declare function sanitizePathString(value: string): string;
+export declare function redactSecretText(value: string): string;
+export declare function sanitizeDiagnosticText(value: string): string;
+export declare function hasShareabilitySensitiveText(text: string): boolean;
+export declare function sanitizeConfigValue(value: unknown, keyPath?: string[]): unknown;
+//# sourceMappingURL=redaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/shared/redaction.ts"],"names":[],"mappings":"AAoFA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAmChD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcxD;AA+FD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAatD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAsBD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,OAAO,CAmBnF"}

package/dist/shared/resolve-fallbacks.d.ts

@@ -0,0 +1,48 @@
+import type { ModelInput, ResolvedModelEntry } from "./model-resolution";
+/**
+ * Resolve the fallback model list to attempt for a hidden-agent (historian /
+ * dreamer) call when its configured primary fails.
+ *
+ * Policy: ONLY the user's explicitly-configured `fallback_models` for this
+ * agent. There is NO builtin provider-agnostic chain — a hardcoded chain
+ * inevitably names providers the user doesn't have (e.g. a metapi-only user got
+ * a chain of google/github-copilot/opencode entries, every one a
+ * `Model not found` retry), which produced confusing errors and wasted
+ * attempts. If the user configured nothing, this returns an empty list and the
+ * runner's session-model last resort (the model the user is actually using) is
+ * the only fallback.
+ *
+ * The returned list does NOT include the primary model — it's the ordered list
+ * of *alternates* to try after the primary fails. Each entry is
+ * "provider/modelID" form. Duplicates and empty strings are filtered; entries
+ * that don't match the "provider/modelID" shape (a "/" with non-empty parts) are
+ * dropped as a defensive guard against malformed user config.
+ */
+export declare function resolveFallbackChain(userFallbacks: readonly string[] | string | undefined): string[];
+/**
+ * Parse a "provider/modelID" string into the OpenCode `model` object shape.
+ * Returns null on invalid input.
+ *
+ * Note: only splits on the FIRST "/" — modelID can legitimately contain slashes
+ * (e.g. `lemonade/GLM-4.7-Flash-GGUF/main`).
+ */
+export declare function parseProviderModel(spec: string): {
+    providerID: string;
+    modelID: string;
+} | null;
+/**
+ * Build the `{ model: { providerID, modelID } }` fragment for an OpenCode prompt
+ * body from a `provider/model` spec string, or `{}` when the spec is absent or
+ * unparseable (the session falls back to its default model). Spread into a
+ * `client.session.prompt` body.
+ */
+export declare function modelBodyField(spec: ModelInput | undefined): {
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+    variant?: string;
+};
+/** Convert legacy string call sites and resolved entries into one active attempt shape. */
+export declare function toModelEntry(spec: ModelInput | undefined): ResolvedModelEntry | undefined;
+//# sourceMappingURL=resolve-fallbacks.d.ts.map

package/dist/shared/resolve-fallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-fallbacks.d.ts","sourceRoot":"","sources":["../../src/shared/resolve-fallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAChC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GACtD,MAAM,EAAE,CAGV;AA2BD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO/F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG;IAC1D,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAOA;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAMzF"}

package/dist/shared/rpc-client.d.ts

@@ -0,0 +1,28 @@
+export declare class MagicContextRpcClient {
+    private port;
+    private token;
+    private instanceId;
+    private portDir;
+    private legacyPortFilePath;
+    private healthChecked;
+    constructor(storageDir: string, directory: string);
+    /** Call an RPC method. Retries port resolution if the server isn't ready yet. */
+    call<T = Record<string, unknown>>(method: string, params?: Record<string, unknown>): Promise<T>;
+    /** Check if the RPC server is reachable. */
+    isAvailable(): Promise<boolean>;
+    /** Resolve the live server's port + bearer token (for opening the WS push
+     *  channel). Reuses the same health-checked port-file discovery as `call`,
+     *  so the WS client and the HTTP client always agree on which server instance
+     *  (and token) to use. Returns null when no live server is found. */
+    resolveEndpoint(): Promise<{
+        port: number;
+        token: string | null;
+        instanceId: string | null;
+    } | null>;
+    private resolvePort;
+    private readPortFiles;
+    private healthCheck;
+    private fetchWithTimeout;
+    reset(): void;
+}
+//# sourceMappingURL=rpc-client.d.ts.map

package/dist/shared/rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../src/shared/rpc-client.ts"],"names":[],"mappings":"AAiBA,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,aAAa,CAAS;gBAElB,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKjD,iFAAiF;IAC3E,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,CAAC,CAAC;IAwDb,4CAA4C;IACtC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;;yEAGqE;IAC/D,eAAe,IAAI,OAAO,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,GAAG,IAAI,CAAC;YAYK,WAAW;IAwBzB,OAAO,CAAC,aAAa;YAiCP,WAAW;YAoBX,gBAAgB;IAU9B,KAAK,IAAI,IAAI;CAMhB"}

package/dist/shared/rpc-notifications.d.ts

@@ -0,0 +1,74 @@
+/**
+ * In-memory notification queue for server→TUI push.
+ * Replaces SQLite plugin_messages table.
+ *
+ * Also tracks whether a TUI client is actively connected (polling).
+ * The server plugin cannot use `process.env.OPENCODE_CLIENT` to detect TUI
+ * because the server runs in a separate process from the TUI client.
+ */
+export interface RpcNotification {
+    id: number;
+    type: string;
+    payload: Record<string, unknown>;
+    sessionId?: string;
+}
+/**
+ * A connected TUI notification sink — one per authenticated WebSocket. The RPC
+ * server registers a sink when a TUI socket authenticates (hello) and removes
+ * it on close. `send` is sink-agnostic (the server owns the actual WS socket)
+ * so this module stays free of Bun/WS types.
+ */
+export interface NotificationSink {
+    /** The TUI's active session at connect time (its hello scope). */
+    sessionId?: string;
+    /** Protocol 2 clients use strict session scoping; absent means legacy behavior. */
+    protocol?: number;
+    /** Deliver one notification over this sink's live socket. */
+    send: (notification: RpcNotification) => void;
+}
+/** Register a live TUI sink. Returns an unregister fn (call on socket close). */
+export declare function registerNotificationSink(sink: NotificationSink): () => void;
+/** Push a notification to the TUI. Fans out to any live WS sink immediately and
+ *  also enqueues it so a TUI that is momentarily disconnected (reconnecting, or
+ *  not yet connected) still receives it on its next hello via the backlog drain.
+ *  At-least-once: a live push that the socket drops is re-delivered from the
+ *  queue on reconnect (pruned only when the client acknowledges it). */
+export declare function pushNotification(type: string, payload: Record<string, unknown>, sessionId?: string): void;
+export declare function acknowledgeNotifications(ids: readonly number[]): void;
+/** Reset process-local state to simulate a fresh server module in protocol tests. */
+export declare function __resetNotificationStateForTests(): void;
+export interface DrainNotificationsOptions {
+    /**
+     * Cursor for global notifications when a session-scoped client sends separate
+     * session and global watermarks.
+     */
+    globalLastReceivedId?: number;
+    /** Ack/drain only the named session, not global notifications. */
+    sessionOnly?: boolean;
+    /** Ack/drain only session-less global notifications. */
+    globalOnly?: boolean;
+}
+/** Return pending notifications after pruning only the scopes the client acked.
+ *
+ *  Session-scoped and global notifications have independent cursors. A TUI can
+ *  switch from session A to session B after handling a high id in A; that high
+ *  watermark must never prune B's lower, still-unseen ids. Global notifications
+ *  are also tracked separately so a global dialog does not become a session
+ *  watermark. Legacy callers that omit options keep the original single-cursor
+ *  behavior.
+ *
+ *  Delivery is at-least-once (non-destructive return + prune-on-ack): a returned
+ *  notification stays queued until an exact acknowledgement or a legacy cursor
+ *  removes it, so a dropped WS socket re-delivers unhandled backlog on reconnect. */
+export declare function drainNotifications(lastReceivedId?: number, sessionId?: string, options?: DrainNotificationsOptions): RpcNotification[];
+/** Whether a TUI client is connected via a live notification socket.
+ *  Now exact socket liveness (a registered WS sink), not a poll-drain timestamp.
+ *
+ *  Pass `sessionId` (preferred) to ask whether a TUI is connected FOR THAT
+ *  SESSION — this is what producers (`/mmc-status`, `/mmc-recomp`, the upgrade
+ *  reminder) must use to decide dialog-vs-message, so a TUI on a different
+ *  session in the same process does not misroute their delivery. A modern
+ *  session-less sink is global-only; a legacy sink retains broad compatibility.
+ *  Omit `sessionId` only for callers with no session context. */
+export declare function isTuiConnected(sessionId?: string): boolean;
+//# sourceMappingURL=rpc-notifications.d.ts.map

package/dist/shared/rpc-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-notifications.d.ts","sourceRoot":"","sources":["../../src/shared/rpc-notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC7B,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,KAAK,IAAI,CAAC;CACjD;AAYD,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAK3E;AAUD;;;;wEAIwE;AACxE,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACnB,IAAI,CA+BN;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAMrE;AAED,qFAAqF;AACrF,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD;AAED,MAAM,WAAW,yBAAyB;IACtC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD;;;;;;;;;;;qFAWqF;AACrF,wBAAgB,kBAAkB,CAC9B,cAAc,SAAI,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,yBAA8B,GACxC,eAAe,EAAE,CAqDnB;AAED;;;;;;;;iEAQiE;AACjE,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAQ1D"}

package/dist/shared/rpc-server.d.ts

@@ -0,0 +1,52 @@
+type RpcHandler = (params: Record<string, unknown>) => Promise<Record<string, unknown>>;
+/**
+ * Plugin-private localhost RPC server for TUI ↔ server-plugin communication.
+ *
+ * Runs on Bun (the OpenCode server runner is a Bun Worker), so it uses
+ * `Bun.serve` to host BOTH:
+ *  - HTTP request/reply routes (`/health`, `/rpc/<method>`) — the TUI's snapshot
+ *    and dialog-result calls, which are event-driven, not idle; and
+ *  - a WebSocket endpoint (`/ws`) — a single persistent connection per TUI over
+ *    which the server PUSHES notifications (dialog/toast actions). This replaces
+ *    the old 500ms HTTP poll, whose new-connection-per-tick cost was the source
+ *    of idle TUI CPU (#200). Pi never imports this module, so `Bun.serve` is safe.
+ */
+export declare class MagicContextRpcServer {
+    private server;
+    private port;
+    private handlers;
+    private portFilePath;
+    private portDir;
+    private startedAt;
+    private readonly instanceId;
+    private unregisterOwnInstance;
+    /** Every authenticated WS socket, so dispose can close them all. */
+    private sockets;
+    private readonly token;
+    constructor(storageDir: string, directory: string);
+    /** Register an RPC method handler. */
+    handle(method: string, handler: RpcHandler): void;
+    /**
+     * Run a registered handler from inside this process, skipping the HTTP hop.
+     *
+     * A caller that already lives in the server process (a host command callback,
+     * for instance) must reach exactly the handler the TUI reaches over HTTP, so
+     * the two entry points cannot drift apart. The loopback socket, its bearer
+     * token and JSON encoding add nothing here, so they are skipped rather than
+     * paid for; an unknown method is still an error, as it is over HTTP.
+     */
+    dispatch(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Start the server on a random port, write port to disk. */
+    start(): Promise<number>;
+    /** Stop the server: close every socket, stop accepting, remove port file. */
+    stop(): void;
+    private warnIfOtherLiveInstance;
+    /** HTTP route handler (Bun fetch). Returns a Response, or undefined when the
+     *  request was upgraded to a WebSocket. */
+    private handleFetch;
+    /** WS message handler: hello (auth + sink registration + backlog delivery) and
+     *  ack (exact removal or legacy cursor pruning). All other messages are ignored. */
+    private handleWsMessage;
+}
+export {};
+//# sourceMappingURL=rpc-server.d.ts.map

package/dist/shared/rpc-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-server.d.ts","sourceRoot":"","sources":["../../src/shared/rpc-server.ts"],"names":[],"mappings":"AAmBA,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AA8CxF;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,oEAAoE;IACpE,OAAO,CAAC,OAAO,CAAsC;IAMrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;gBAE7C,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKjD,sCAAsC;IACtC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;;;;;OAQG;IACG,QAAQ,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMnC,6DAA6D;IACvD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAmE9B,6EAA6E;IAC7E,IAAI,IAAI,IAAI;YAyBE,uBAAuB;IAkBrC;+CAC2C;YAC7B,WAAW;IAyDzB;wFACoF;IACpF,OAAO,CAAC,eAAe;CA8H1B"}