opencode-matrixx 1.0.2 → 1.1.0

package/dist/hooks/runtime-fallback/fallback-state.d.ts

@@ -0,0 +1,6 @@
+import type { FallbackState, FallbackResult } from "./types";
+import type { RuntimeFallbackConfig } from "../../config";
+export declare function createFallbackState(originalModel: string): FallbackState;
+export declare function isModelInCooldown(model: string, state: FallbackState, cooldownSeconds: number): boolean;
+export declare function findNextAvailableFallback(state: FallbackState, fallbackModels: string[], cooldownSeconds: number): string | undefined;
+export declare function prepareFallback(sessionID: string, state: FallbackState, fallbackModels: string[], config: Required<RuntimeFallbackConfig>): FallbackResult;

package/dist/hooks/runtime-fallback/hook.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimeFallbackHook, RuntimeFallbackOptions, RuntimeFallbackPluginInput } from "./types";
+export declare function createRuntimeFallbackHook(ctx: RuntimeFallbackPluginInput, options?: RuntimeFallbackOptions): RuntimeFallbackHook;

package/dist/hooks/runtime-fallback/index.d.ts

@@ -0,0 +1,3 @@
+export { createRuntimeFallbackHook } from "./hook";
+export type { RuntimeFallbackHook, RuntimeFallbackOptions } from "./types";
+export { SessionCategoryRegistry } from "./session-category-registry";

package/dist/hooks/runtime-fallback/is-abort-error.d.ts

@@ -0,0 +1 @@
+export declare function isAbortError(error: unknown): boolean;

package/dist/hooks/runtime-fallback/last-user-retry-parts.d.ts

@@ -0,0 +1,4 @@
+export declare function getLastUserRetryParts(messagesResponse: unknown): Array<{
+    type: "text";
+    text: string;
+}>;

package/dist/hooks/runtime-fallback/message-update-handler.d.ts

@@ -0,0 +1,4 @@
+import type { HookDeps } from "./types";
+import type { AutoRetryHelpers } from "./auto-retry";
+export { hasVisibleAssistantResponse } from "./visible-assistant-response";
+export declare function createMessageUpdateHandler(deps: HookDeps, helpers: AutoRetryHelpers): (props: Record<string, unknown> | undefined) => Promise<void>;

package/dist/hooks/runtime-fallback/model-utils.d.ts

@@ -0,0 +1,7 @@
+export declare function parseModelString(model: string): {
+    providerID: string;
+    modelID: string;
+    variant?: string;
+} | undefined;
+export declare function normalizeFallbackModels(models: string | string[] | undefined): string[] | undefined;
+export declare function flattenToFallbackModelStrings(models: string[] | undefined): string[] | undefined;

package/dist/hooks/runtime-fallback/retry-model-payload.d.ts

@@ -0,0 +1,11 @@
+export declare function buildRetryModelPayload(model: string, agentSettings?: {
+    variant?: string;
+    reasoningEffort?: string;
+}): {
+    model: {
+        providerID: string;
+        modelID: string;
+    };
+    variant?: string;
+    reasoningEffort?: string;
+} | undefined;

package/dist/hooks/runtime-fallback/retry-status-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeRetryStatusMessage(message: string): string;
+export declare function extractRetryAttempt(statusAttempt: unknown, message: string): string;

package/dist/hooks/runtime-fallback/session-category-registry.d.ts

@@ -0,0 +1,6 @@
+export declare const SessionCategoryRegistry: {
+    register(sessionID: string, category: string): void;
+    get(sessionID: string): string | undefined;
+    remove(sessionID: string): void;
+    clear(): void;
+};

package/dist/hooks/runtime-fallback/session-messages.d.ts

@@ -0,0 +1,9 @@
+export type SessionMessagePart = {
+    type?: string;
+    text?: string;
+};
+export type SessionMessage = {
+    info?: Record<string, unknown>;
+    parts?: SessionMessagePart[];
+};
+export declare function extractSessionMessages(messagesResponse: unknown): SessionMessage[] | undefined;

package/dist/hooks/runtime-fallback/session-status-handler.d.ts

@@ -0,0 +1,3 @@
+import type { HookDeps } from "./types";
+import type { AutoRetryHelpers } from "./auto-retry";
+export declare function createSessionStatusHandler(deps: HookDeps, helpers: AutoRetryHelpers, sessionStatusRetryKeys: Map<string, string>): (props: Record<string, unknown> | undefined) => Promise<void>;

package/dist/hooks/runtime-fallback/types.d.ts

@@ -0,0 +1,113 @@
+import type { RuntimeFallbackConfig, MatrixxConfig } from "../../config";
+export interface RuntimeFallbackInterval {
+    unref: () => void;
+}
+export type RuntimeFallbackTimeout = object | number;
+export interface RuntimeFallbackPluginInput {
+    client: {
+        session: {
+            abort: (input: {
+                path: {
+                    id: string;
+                };
+            }) => Promise<unknown>;
+            messages: (input: {
+                path: {
+                    id: string;
+                };
+                query: {
+                    directory: string;
+                };
+            }) => Promise<unknown>;
+            promptAsync: (input: {
+                path: {
+                    id: string;
+                };
+                body: {
+                    agent?: string;
+                    model: {
+                        providerID: string;
+                        modelID: string;
+                    };
+                    parts: Array<{
+                        type: "text";
+                        text: string;
+                    }>;
+                };
+                query: {
+                    directory: string;
+                };
+            }) => Promise<unknown>;
+        };
+        tui: {
+            showToast: (input: {
+                body: {
+                    title: string;
+                    message: string;
+                    variant: "success" | "error" | "info" | "warning";
+                    duration: number;
+                };
+            }) => Promise<unknown>;
+        };
+    };
+    directory: string;
+}
+export interface FallbackState {
+    originalModel: string;
+    currentModel: string;
+    fallbackIndex: number;
+    failedModels: Map<string, number>;
+    attemptCount: number;
+    pendingFallbackModel?: string;
+}
+export interface FallbackResult {
+    success: boolean;
+    newModel?: string;
+    error?: string;
+    maxAttemptsReached?: boolean;
+}
+export interface RuntimeFallbackOptions {
+    config?: RuntimeFallbackConfig;
+    pluginConfig?: MatrixxConfig;
+    session_timeout_ms?: number;
+}
+export interface RuntimeFallbackHook {
+    event: (input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+    "chat.message"?: (input: {
+        sessionID: string;
+        agent?: string;
+        model?: {
+            providerID: string;
+            modelID: string;
+        };
+    }, output: {
+        message: {
+            model?: {
+                providerID: string;
+                modelID: string;
+            };
+        };
+        parts?: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => Promise<void>;
+    dispose?: () => void;
+}
+export interface HookDeps {
+    ctx: RuntimeFallbackPluginInput;
+    config: Required<RuntimeFallbackConfig>;
+    options: RuntimeFallbackOptions | undefined;
+    pluginConfig: MatrixxConfig | undefined;
+    sessionStates: Map<string, FallbackState>;
+    sessionLastAccess: Map<string, number>;
+    sessionRetryInFlight: Set<string>;
+    sessionAwaitingFallbackResult: Set<string>;
+    sessionFallbackTimeouts: Map<string, RuntimeFallbackTimeout>;
+    sessionStatusRetryKeys: Map<string, string>;
+}

package/dist/hooks/runtime-fallback/visible-assistant-response.d.ts

@@ -0,0 +1,3 @@
+import type { HookDeps } from "./types";
+import { extractAutoRetrySignal } from "./error-classifier";
+export declare function hasVisibleAssistantResponse(extractAutoRetrySignalFn: typeof extractAutoRetrySignal): (ctx: HookDeps["ctx"], sessionID: string, _info: Record<string, unknown> | undefined) => Promise<boolean>;

package/dist/hooks/shared/compaction-model-resolver.d.ts

@@ -0,0 +1,5 @@
+import type { MatrixxConfig } from "../../config";
+export declare function resolveCompactionModel(pluginConfig: MatrixxConfig, sessionID: string, originalProviderID: string, originalModelID: string): {
+    providerID: string;
+    modelID: string;
+};

package/dist/hooks/todo-description-override/description.d.ts

@@ -0,0 +1 @@
+export declare const TODOWRITE_DESCRIPTION = "Manage your todo list with ATOMIC, single-responsibility items.\n\nRULES:\n- One todo = one specific, verifiable action (not \"Update everything\" or \"Fix issues\")\n- Each todo must be completable in isolation \u2014 no vague catch-alls\n- Todos must be nameable with a single precise phrase\n- Mark in_progress BEFORE starting work, completed IMMEDIATELY after finishing\n- Only ONE todo in_progress at a time\n\nANTI-PATTERNS (will be rejected by reviewers):\n- \"Update X and Y and Z\" \u2192 SPLIT into 3 separate todos\n- \"Fix issues\" \u2192 SPECIFY which file, function, or behavior\n- \"Refactor\" \u2192 SPECIFY what is being refactored and to what end\n- \"Improve\" \u2192 SPECIFY the measurable outcome\n\nSTATUS TRANSITIONS:\n  pending \u2192 in_progress \u2192 completed\n  pending \u2192 cancelled (if no longer needed)\n\nNever batch-complete todos. Mark each one complete the moment it is done.";

package/dist/hooks/todo-description-override/hook.d.ts

@@ -0,0 +1,8 @@
+export declare function createTodoDescriptionOverrideHook(): {
+    "tool.definition": (input: {
+        toolID: string;
+    }, output: {
+        description: string;
+        parameters: unknown;
+    }) => Promise<void>;
+};

package/dist/hooks/todo-description-override/index.d.ts

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

package/dist/hooks/tool-pair-validator/hook.d.ts

@@ -0,0 +1,28 @@
+import type { Message, Part } from "@opencode-ai/sdk";
+type ToolUsePart = {
+    type: "tool_use";
+    id: string;
+    [key: string]: unknown;
+};
+type ToolResultPart = {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    [key: string]: unknown;
+};
+type TransformPart = Part | ToolUsePart | ToolResultPart;
+type TransformMessageInfo = Message | {
+    role: "user";
+    sessionID?: string;
+};
+interface MessageWithParts {
+    info: TransformMessageInfo;
+    parts: TransformPart[];
+}
+type MessagesTransformHook = {
+    "experimental.chat.messages.transform"?: (input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+export declare function createToolPairValidatorHook(): MessagesTransformHook;
+export {};

package/dist/hooks/tool-pair-validator/index.d.ts

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

package/dist/hooks/webfetch-redirect-guard/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_WEBFETCH_TIMEOUT_MS = 30000;
+export declare const MAX_WEBFETCH_TIMEOUT_MS = 120000;
+export declare const MAX_WEBFETCH_REDIRECTS = 10;
+export declare const WEBFETCH_REDIRECT_GUARD_STALE_TIMEOUT_MS: number;
+export declare const WEBFETCH_REDIRECT_ERROR_PATTERNS: readonly [RegExp, RegExp];
+export declare const WEBFETCH_REDIRECT_STATUSES: Set<number>;

package/dist/hooks/webfetch-redirect-guard/hook.d.ts

@@ -0,0 +1,19 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+type ToolExecuteInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type ToolExecuteBeforeOutput = {
+    args: Record<string, unknown>;
+};
+type ToolExecuteAfterOutput = {
+    title: string;
+    output: string;
+    metadata: Record<string, unknown>;
+};
+export declare function createWebFetchRedirectGuardHook(_ctx: PluginInput): {
+    "tool.execute.before": (input: ToolExecuteInput, output: ToolExecuteBeforeOutput) => Promise<void>;
+    "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteAfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/webfetch-redirect-guard/index.d.ts

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

package/dist/hooks/webfetch-redirect-guard/redirect-resolution.d.ts

@@ -0,0 +1,16 @@
+export type WebFetchFormat = "markdown" | "text" | "html";
+type RedirectResolutionParams = {
+    url: string;
+    format: WebFetchFormat;
+    timeoutSeconds?: number;
+};
+export type RedirectResolutionResult = {
+    type: "resolved";
+    url: string;
+} | {
+    type: "exceeded";
+    url: string;
+    maxRedirects: number;
+};
+export declare function resolveWebFetchRedirects(params: RedirectResolutionParams): Promise<RedirectResolutionResult>;
+export {};