opencode-matrixx 2.6.6 → 2.6.7

package/dist/features/background-agent/wake-scheduler.d.ts

@@ -0,0 +1,47 @@
+export interface WakeSchedulerConfig {
+    enabled?: boolean;
+    intervalMs?: number;
+}
+export interface WakeParentState {
+    hasPendingChildren: boolean;
+    hasUndeliveredNotifications: boolean;
+    hasUnfinishedTodos?: boolean;
+}
+export declare const WAKE_REMINDER_TEXT = "<system-reminder>\n[BACKGROUND WAKE]\n\nOne or more background tasks for this session are still running or have undelivered results.\nUse background_output with the task ID to retrieve results when ready.\nDo NOT poll - continue productive work.\n</system-reminder>";
+export declare function isWakeSchedulerEnabled(cfg?: WakeSchedulerConfig): boolean;
+export declare function resolveWakeIntervalMs(cfg?: WakeSchedulerConfig): number;
+export declare function shouldWakeForParent(state: WakeParentState): boolean;
+export declare function nextWakeDelay(lastWakeAtMs: number, intervalMs: number, nowMs?: number): number;
+export declare class WakeTracker {
+    private stagnantByParent;
+    recordWake(parentSessionID: string, progressed: boolean): boolean;
+    resetOnActivity(parentSessionID: string): void;
+    stagnantCount(parentSessionID: string): number;
+}
+export type WakeTimerHandle = ReturnType<typeof setTimeout>;
+export type WakeScheduleTimer = (callback: () => void, delayMs: number) => WakeTimerHandle;
+export type WakeClearTimer = (handle: WakeTimerHandle) => void;
+export interface WakeRegistration {
+    intervalMs: number;
+    readState: () => WakeParentState;
+    deliverWake: () => void | Promise<void>;
+}
+export declare class WakeScheduler {
+    private timers;
+    private registrations;
+    private snapshots;
+    private readonly tracker;
+    private readonly scheduleTimer;
+    private readonly clearTimer;
+    constructor(deps?: {
+        scheduleTimer?: WakeScheduleTimer;
+        clearTimer?: WakeClearTimer;
+    });
+    private armTimer;
+    schedule(parentSessionID: string, registration: WakeRegistration): void;
+    clear(parentSessionID: string): void;
+    dispose(): void;
+    hasScheduledWake(parentSessionID: string): boolean;
+    private clearTimerFor;
+    private tick;
+}

package/dist/features/background-agent/wallclock.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Wall-clock supervisor: fire-once elapsed-time bound for running background tasks.
+ *
+ * Staleness is activity-based; this module is elapsed-time-based. Each armed entry
+ * fires its callback exactly once when `startedAtMs + timeoutMs` passes, no matter
+ * how busy or productive the task looks. A timeout of `0` or `undefined` means OFF
+ * and arms nothing.
+ *
+ * Grace contract (manager-owned, pinned here): on fire the manager aborts the
+ * session once, waits `wallClockAbortGraceMs`, then marks the task terminal —
+ * unless the task completed naturally during grace, in which case the natural
+ * outcome wins and the pending mark is cancelled.
+ *
+ * This module must not import from manager/client/fs — pure timers only. It mirrors
+ * the settled-flag lifecycle of `acquireWithDeadline` in `concurrency.ts`.
+ */
+/** Maximum delay accepted by `setTimeout` (2^31-1 ms); enforced by schema max too. */
+export declare const MAX_WALLCLOCK_TIMEOUT_MS = 2147483647;
+/** Context delivered to the fire callback exactly once per armed deadline. */
+export interface WallclockFireContext {
+    taskId: string;
+    elapsedMs: number;
+    limitMs: number;
+}
+export type WallclockFireCallback = (ctx: WallclockFireContext) => void;
+/** Pure remaining-time math: deadline minus now (negative when already expired). */
+export declare function remainingMs(startedAtMs: number, timeoutMs: number, nowMs?: number): number;
+/** OFF (`0`/`undefined`) never arms; any other value is an active elapsed-time bound. */
+export declare function isWallclockEnabled(timeoutMs: number | undefined): timeoutMs is number;
+export declare class WallclockSupervisor {
+    private entries;
+    arm(taskId: string, startedAtMs: number, timeoutMs: number | undefined, onFire: WallclockFireCallback): void;
+    disarm(taskId: string): boolean;
+    disarmAll(): void;
+    size(): number;
+    getDeadlineAt(taskId: string): number | undefined;
+}

package/dist/features/bdd/schema.d.ts

@@ -86,8 +86,8 @@ export declare const HttpMethodSchema: z.ZodEnum<{
 }>;
 export declare const ResponseFormatSchema: z.ZodEnum<{
     binary: "binary";
-    json: "json";
     text: "text";
+    json: "json";
     html: "html";
     xml: "xml";
 }>;
@@ -118,8 +118,8 @@ export declare const ApiResponseSchema: z.ZodObject<{
     status: z.ZodNumber;
     format: z.ZodEnum<{
         binary: "binary";
-        json: "json";
         text: "text";
+        json: "json";
         html: "html";
         xml: "xml";
     }>;
@@ -174,8 +174,8 @@ export declare const ApiAnnotationsSchema: z.ZodObject<{
         status: z.ZodNumber;
         format: z.ZodEnum<{
             binary: "binary";
-            json: "json";
             text: "text";
+            json: "json";
             html: "html";
             xml: "xml";
         }>;
@@ -236,8 +236,8 @@ export declare const ContractAnnotationsSchema: z.ZodObject<{
             status: z.ZodNumber;
             format: z.ZodEnum<{
                 binary: "binary";
-                json: "json";
                 text: "text";
+                json: "json";
                 html: "html";
                 xml: "xml";
             }>;
@@ -366,8 +366,8 @@ export declare const ContractSchema: z.ZodObject<{
                 status: z.ZodNumber;
                 format: z.ZodEnum<{
                     binary: "binary";
-                    json: "json";
                     text: "text";
+                    json: "json";
                     html: "html";
                     xml: "xml";
                 }>;

package/dist/hooks/context-mode-enforcer/constants.d.ts

@@ -1,6 +1,6 @@
 export declare const HOOK_NAME = "context-mode-enforcer";
 export declare const WARN_MESSAGE_READ = "Use ctx_search / ctx_batch_execute / ctx_execute for analysis \u2014 raw read/grep/glob bypasses FTS5 sandbox and pollutes context. Use Read only with hashline IDs for Edit (non-plan paths; .matrixx/plans/*.md must use plan_read/plan_update).";
-export declare const BLOCK_MESSAGE_GREP_GLOB = "Blocked: raw grep/glob is forbidden when context-mode is enforced. Use ctx_search (indexed) \u2192 grep/glob fallback only when ctx_* unavailable, or ctx_batch_execute / ctx_execute for multi-file analysis.";
+export declare const BLOCK_MESSAGE_GREP_GLOB: string;
 export declare const WARN_MESSAGE_BASH_READ = "Use ctx_* / Read tool instead of `cat`/`head`/`tail`/`grep` via bash for analysis. Raw bash file reads bypass sandbox.";
 export declare const DEFAULT_BLOCKED_TOOLS: readonly ["grep", "glob"];
 export declare const WARN_ONLY_TOOLS: readonly ["read"];