opencode-matrixx 2.6.11 → 2.6.13

package/dist/features/plan-contract/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Plan Contract Types
+ *
+ * Structured view of an Oracle work plan: parsed sections, numbered tasks,
+ * definition-of-done lines, and optional YAML front-matter.
+ */
+import type { PlanSection } from "./constants";
+export type { PlanSection };
+/** A single numbered TODO task parsed from a plan. */
+export interface PlanTask {
+    /** Task number as written in the plan (e.g. `1` in `- [ ] 1. ...`). */
+    n: number;
+    /** Task title text following the number. */
+    title: string;
+    /** Whether the task checkbox is checked. */
+    checked: boolean;
+    /** 1-based line number of the task within the plan file. */
+    line: number;
+    /** Stable LINE#ID anchor for hashline-scoped edits. */
+    anchor: string;
+}
+/** Severity-neutral diagnostic emitted while validating a plan contract. */
+export interface PlanContractWarning {
+    /** Machine-readable warning code. */
+    code: string;
+    /** Human-readable explanation. */
+    message: string;
+    /** 1-based line the warning refers to, when known. */
+    line?: number;
+}
+/** Outcome of validating a plan against the contract. */
+export interface PlanContractResult {
+    /** True when no errors were produced (warnings may still be present). */
+    ok: boolean;
+    /** Non-fatal contract deviations. */
+    warnings: PlanContractWarning[];
+    /** Fatal contract violations. */
+    errors: string[];
+}
+/** Lifecycle status carried by a plan's YAML front-matter. */
+export type PlanStatus = "pending" | "in_progress" | "completed";
+/** Structured YAML front-matter block parsed from a plan file. */
+export interface PlanFrontMatter {
+    /** Current plan lifecycle status. */
+    status: PlanStatus;
+    /** Monotonic revision counter. */
+    revision: number;
+    /** Execution phase label, when present. */
+    phase?: string;
+    /** Execution wave label, when present. */
+    wave?: string;
+    /** Task ids this plan depends on. */
+    deps?: string[];
+    /** Task ids blocked by this plan. */
+    blockedBy?: string[];
+}

package/dist/features/plan-contract/validate.d.ts

@@ -0,0 +1,9 @@
+import type { PlanContract } from "./schema";
+import type { PlanContractResult, PlanTask } from "./types";
+/** Optional caller-supplied LINE#ID anchors keyed by 1-based line number. */
+export type HashlineAnchors = ReadonlyMap<number, string> | Readonly<Record<number, string>>;
+export declare function parsePlanTasks(content: string, hashlineAnchors?: HashlineAnchors): PlanTask[];
+export declare function parsePlanContract(content: string): PlanContract;
+export declare function validatePlanContract(content: string, options?: {
+    mode?: "warn" | "fail";
+}): PlanContractResult;

package/dist/features/session-state/state.d.ts

@@ -28,14 +28,6 @@ export declare function setSessionAgent(sessionID: string, agent: string): void;
 export declare function updateSessionAgent(sessionID: string, agent: string): void;
 export declare function getSessionAgent(sessionID: string): string | undefined;
 export declare function clearSessionAgent(sessionID: string): void;
-export declare function incFailureCounter(sessionID: string): number;
-export declare function resetFailureCounter(sessionID: string): void;
-export declare function getFailureCount(sessionID: string): number;
-export declare function getFailureState(sessionID: string): {
-    count: number;
-    lastFailedAt: number;
-} | undefined;
-export declare function clearFailureCounter(sessionID: string): void;
-/** @internal For testing only */
-export declare function _resetFailureCountersForTesting(): void;
-export declare function isThresholdReached(sessionID: string, threshold: number): boolean;
+export declare function setSessionModel(sessionID: string, model: string): void;
+export declare function getSessionModel(sessionID: string): string | undefined;
+export declare function clearSessionModel(sessionID: string): void;

package/dist/hooks/dcp-nudge-sanitizer/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const NUDGE_MARKERS: RegExp[];
+export declare function normalizeNudgeText(text: string): string;

package/dist/hooks/dcp-nudge-sanitizer/hook.d.ts

@@ -0,0 +1,25 @@
+/**
+ * DCP Sticky-Nudge Sanitizer Hook
+ *
+ * Ordering constraint (do not "fix" by assuming otherwise):
+ * Matrixx registers `experimental.chat.messages.transform` BEFORE DCP (plugin
+ * index 0 vs 1), so this sanitizer runs before DCP injects this cycle's nudge.
+ * It therefore cleans PRIOR-cycle sticky nudge parts and caps accumulation at
+ * ~1 per cycle. It CANNOT suppress the nudge DCP injects later in the SAME
+ * cycle. Full same-cycle suppression requires the optional deploy step that
+ * reorders the `plugin` array so Matrixx runs after DCP.
+ */
+import type { Part } from "@opencode-ai/sdk";
+import type { PluginContext } from "../../plugin/types";
+interface MessageWithParts {
+    info: unknown;
+    parts: Part[];
+}
+type MessagesTransformHook = {
+    "experimental.chat.messages.transform"?: (input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+export declare function sanitizeNudgeParts(messages: MessageWithParts[]): void;
+export declare function createDcpNudgeSanitizerHook(_ctx: PluginContext): MessagesTransformHook;
+export {};

package/dist/hooks/dcp-nudge-sanitizer/index.d.ts

@@ -0,0 +1 @@
+export { createDcpNudgeSanitizerHook } from "./hook";

package/dist/hooks/evolution-compressor/host-llm-call.d.ts

@@ -0,0 +1,17 @@
+import type { createOpencodeClient } from "@opencode-ai/sdk";
+import type { LlmUsage } from "../../features/evolution/compressor/interface";
+type Client = ReturnType<typeof createOpencodeClient>;
+export declare function parseModelOverride(model: string | undefined): {
+    providerID: string;
+    modelID: string;
+} | undefined;
+export declare function createHostLlmCall(options: {
+    client: Client;
+    directory: string;
+    agent?: string;
+    model?: string;
+}): (prompt: string, model?: string) => Promise<{
+    text: string;
+    usage?: LlmUsage;
+}>;
+export {};

package/dist/hooks/index.d.ts

@@ -12,6 +12,7 @@ export { createCompactionTodoPreserverHook } from "./compaction-todo-preserver";
 export { createContextModeEnforcerHook } from "./context-mode-enforcer";
 export { type ContextWindowLimitRecoveryOptions, type ContextWindowLimitRecoveryOptions as AnthropicContextWindowLimitRecoveryOptions, createContextWindowLimitRecoveryHook, createContextWindowLimitRecoveryHook as createAnthropicContextWindowLimitRecoveryHook } from "./context-window-limit-recovery";
 export { createContextWindowMonitorHook } from "./context-window-monitor";
+export { createDcpNudgeSanitizerHook } from "./dcp-nudge-sanitizer";
 export { createDelegateTaskRetryHook } from "./delegate-task-retry";
 export { createDesignIntentPreserverHook } from "./design-intent-preserver";
 export { createDirectoryAgentsInjectorHook } from "./directory-agents-injector";
@@ -24,8 +25,6 @@ export { createEvolutionCompressorHook } from "./evolution-compressor";
 export { createEvolutionHitlHook } from "./evolution-hitl";
 export { passesQualityGate } from "./evolution-quality-gate";
 export { createEvolutionWatcherHook } from "./evolution-watcher";
-export { createFailureCounterHook } from "./failure-counter";
-export { createHashlineEditDiffEnhancerHook } from "./hashline-edit-diff-enhancer";
 export { createHashlineReadEnhancerHook } from "./hashline-read-enhancer";
 export { createInputSecretGuardHook } from "./input-secret-guard";
 export { createInteractiveBashSessionHook } from "./interactive-bash-session";
@@ -37,6 +36,7 @@ export { createKnowledgeHubSearchNudgeHook } from "./knowledge-hub-search-nudge"
 export { createMatrixLoopHook, type MatrixLoopHook } from "./matrix-loop";
 export { createMouseNotepadHook } from "./mouse-notepad";
 export { createNonInteractiveEnvHook } from "./non-interactive-env";
+export { createNudgeLoopBreakerHook } from "./nudge-loop-breaker";
 export { createOracleMdOnlyHook } from "./oracle-md-only";
 export { createPlanPersister } from "./plan-persister";
 export { createPostReadInjectorHook } from "./post-read-injector";

package/dist/hooks/nudge-loop-breaker/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_LOOP_THRESHOLD = 3;
+export declare const DEFAULT_COOLDOWN_MS = 1000;
+export declare const MAX_BACKOFF_EXPONENT = 5;
+export declare const DSML_PATTERNS: RegExp[];
+export declare const SESSION_ID_KEYS: readonly ["sessionID", "sessionId", "session"];
+export declare const TEXT_KEYS: readonly ["text", "content", "message", "assistantText", "snapshot", "assistantMessageID"];
+export declare const TOOL_KEYS: readonly ["tool", "toolName", "name"];
+export declare const RESET_TOOL_NAMES: Set<string>;
+export declare const DETECT_EVENT_TYPES: Set<string>;

package/dist/hooks/nudge-loop-breaker/hook.d.ts

@@ -0,0 +1,18 @@
+import type { PluginContext } from "../../plugin/types";
+export interface NudgeLoopBreakerOptions {
+    threshold?: number;
+    cooldownMs?: number;
+    now?: () => number;
+    onCorrective?: (sessionID: string, backoff: number) => void;
+}
+type EventInput = {
+    event: {
+        type: string;
+        properties?: unknown;
+    };
+};
+export type NudgeLoopBreakerHook = {
+    event: (input: EventInput) => Promise<void>;
+};
+export declare function createNudgeLoopBreakerHook(ctx: PluginContext, options?: NudgeLoopBreakerOptions): NudgeLoopBreakerHook;
+export {};

package/dist/hooks/nudge-loop-breaker/index.d.ts

@@ -0,0 +1 @@
+export { createNudgeLoopBreakerHook } from "./hook";

package/dist/hooks/nudge-loop-breaker/session-state.d.ts

@@ -0,0 +1,11 @@
+export interface NudgeLoopState {
+    count: number;
+    lastHash: string | null;
+    lastAt: number;
+    lastEmitAt: number;
+    correctiveSent: boolean;
+}
+export declare function createNudgeLoopState(): NudgeLoopState;
+export declare function computeBackoffDelay(count: number, threshold?: number): number;
+export declare function hashText(text: string): string;
+export declare function normalizeNudgeText(text: string): string;

package/dist/hooks/task-continuation-enforcer/constants.d.ts

@@ -1,11 +1,6 @@
 export declare const HOOK_NAME = "task-continuation-enforcer";
 export declare const DEFAULT_SKIP_AGENTS: string[];
-export declare const EXPLORER_AGENTS: string[];
-export declare function hasNonExplorerBgTasks(tasks: Array<{
-    agent?: string;
-}>): boolean;
 export declare const CONTINUATION_PROMPT: string;
-export declare const BOOTSTRAP_PROMPT: string;
 export declare const COUNTDOWN_SECONDS = 2;
 export declare const TOAST_DURATION_MS = 900;
 export declare const COUNTDOWN_GRACE_PERIOD_MS = 500;