opencode-matrixx 2.5.0 → 2.6.1

package/dist/mcp/index.d.ts

@@ -1,4 +1,6 @@
 import type { MatrixxConfig } from "../config/schema";
+import { type McpCreationFailure } from "./mcp-validator";
+export type { McpCreationFailure } from "./mcp-validator";
 export { type McpName, McpNameSchema } from "./types";
 type RemoteMcpConfig = {
     type: "remote";
@@ -13,4 +15,11 @@ type LocalMcpConfig = {
     enabled: boolean;
 };
 type BuiltinMcpConfig = RemoteMcpConfig | LocalMcpConfig;
-export declare function createBuiltinMcps(disabledMcps?: string[], config?: MatrixxConfig): Record<string, BuiltinMcpConfig>;
+export interface CreateBuiltinMcpsOptions {
+    isCommandAvailable?: (command: string) => boolean;
+}
+export interface CreateBuiltinMcpsResult {
+    mcps: Record<string, BuiltinMcpConfig>;
+    failures: McpCreationFailure[];
+}
+export declare function createBuiltinMcps(disabledMcps?: string[], config?: MatrixxConfig, options?: CreateBuiltinMcpsOptions): CreateBuiltinMcpsResult;

package/dist/mcp/mcp-startup-state.d.ts

@@ -0,0 +1,4 @@
+import type { McpCreationFailure } from "./mcp-validator";
+export declare function setMcpStartupFailures(failures: McpCreationFailure[]): void;
+export declare function getMcpStartupFailures(): McpCreationFailure[];
+export declare function _resetMcpStartupFailuresForTesting(): void;

package/dist/mcp/mcp-validator.d.ts

@@ -0,0 +1,13 @@
+import type { WebsearchConfig } from "../config/schema";
+export interface McpCreationFailure {
+    name: string;
+    error: string;
+}
+export type McpValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateWebsearchConfig(config?: WebsearchConfig): McpValidationResult;
+export declare function isCommandAvailable(command: string): boolean;

package/dist/plugin/hooks/create-continuation-hooks.d.ts

@@ -1,6 +1,6 @@
 import type { HookName, MatrixxConfig } from "../../config";
 import type { BackgroundManager } from "../../features/background-agent";
-import { createArchitectHook, createBackgroundNotificationHook, createCompactionContextInjector, createCompactionTodoPreserverHook, createPlanPersister, createStopContinuationGuardHook, createTodoContinuationEnforcer } from "../../hooks";
+import { createArchitectHook, createBackgroundNotificationHook, createCompactionContextInjector, createCompactionTodoPreserverHook, createEvolutionCompressorHook, createEvolutionHitlHook, createPlanPersister, createStopContinuationGuardHook, createTaskContinuationEnforcer, createTodoContinuationEnforcer } from "../../hooks";
 import type { PluginContext } from "../types";
 import { createUnstableAgentBabysitter } from "../unstable-agent-babysitter";
 export type ContinuationHooks = {
@@ -8,10 +8,13 @@ export type ContinuationHooks = {
     compactionContextInjector: ReturnType<typeof createCompactionContextInjector> | null;
     compactionTodoPreserver: ReturnType<typeof createCompactionTodoPreserverHook> | null;
     todoContinuationEnforcer: ReturnType<typeof createTodoContinuationEnforcer> | null;
+    taskContinuationEnforcer: ReturnType<typeof createTaskContinuationEnforcer> | null;
     unstableAgentBabysitter: ReturnType<typeof createUnstableAgentBabysitter> | null;
     backgroundNotificationHook: ReturnType<typeof createBackgroundNotificationHook> | null;
     architectHook: ReturnType<typeof createArchitectHook> | null;
     planPersister: ReturnType<typeof createPlanPersister> | null;
+    evolutionCompressor: ReturnType<typeof createEvolutionCompressorHook> | null;
+    evolutionHitl: ReturnType<typeof createEvolutionHitlHook> | null;
 };
 type SessionRecovery = {
     setOnAbortCallback: (callback: (sessionID: string) => void) => void;

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -25,12 +25,13 @@ export declare function createCoreHooks(args: {
     envFileWriteGuard: ReturnType<typeof import("../../hooks").createEnvFileWriteGuardHook> | null;
     jsonErrorRecovery: ReturnType<typeof import("../../hooks").createJsonErrorRecoveryHook> | null;
     bashFileReadGuard: ReturnType<typeof import("../../hooks").createBashFileReadGuardHook> | null;
-    todoDescriptionOverride: ReturnType<typeof import("../../hooks").createTodoDescriptionOverrideHook> | null;
     readImageResizer: ReturnType<typeof import("../../hooks").createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof import("../../hooks").createWebFetchRedirectGuardHook> | null;
     hashlineEditDiffEnhancer: ReturnType<typeof import("../../hooks").createHashlineEditDiffEnhancerHook> | null;
     qualityGate: ReturnType<typeof import("../../hooks").createQualityGateHook> | null;
     taskNotepad: ReturnType<typeof import("../../hooks").createTaskNotepadHook> | null;
+    taskEditGuard: ReturnType<typeof import("../../hooks").createTaskEditGuardHook> | null;
+    evolutionWatcher: ReturnType<typeof import("../../hooks").createEvolutionWatcherHook> | null;
     contextWindowMonitor: ReturnType<typeof import("../../hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("../../hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("../../hooks").createSessionRecoveryHook> | null;
@@ -52,4 +53,5 @@ export declare function createCoreHooks(args: {
     anthropicEffort: ReturnType<typeof import("../../hooks/anthropic-effort").createAnthropicEffortHook> | null;
     runtimeFallback: ReturnType<typeof import("../../hooks").createRuntimeFallbackHook> | null;
     rtkBashRewriter: ReturnType<typeof import("../../hooks").createRtkBashRewriterHook> | null;
+    mcpStartupNotification: ReturnType<typeof import("../../hooks").createMcpStartupNotificationHook> | null;
 };

package/dist/plugin/hooks/create-session-hooks.d.ts

@@ -1,5 +1,5 @@
 import type { HookName, MatrixxConfig } from "../../config";
-import { createAgentUsageReminderHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createContextWindowMonitorHook, createDelegateTaskRetryHook, createEditErrorRecoveryHook, createInteractiveBashSessionHook, createMatrixLoopHook, createMouseNotepadHook, createNonInteractiveEnvHook, createOracleMdOnlyHook, createPreemptiveCompactionHook, createQuestionLabelTruncatorHook, createRtkBashRewriterHook, createRuntimeFallbackHook, createSessionNotification, createSessionRecoveryHook, createStartWorkHook, createTaskResumeInfoHook, createThinkModeHook } from "../../hooks";
+import { createAgentUsageReminderHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createContextWindowMonitorHook, createDelegateTaskRetryHook, createEditErrorRecoveryHook, createInteractiveBashSessionHook, createMatrixLoopHook, createMcpStartupNotificationHook, createMouseNotepadHook, createNonInteractiveEnvHook, createOracleMdOnlyHook, createPreemptiveCompactionHook, createQuestionLabelTruncatorHook, createRtkBashRewriterHook, createRuntimeFallbackHook, createSessionNotification, createSessionRecoveryHook, createStartWorkHook, createTaskResumeInfoHook, createThinkModeHook } from "../../hooks";
 import { createAnthropicEffortHook } from "../../hooks/anthropic-effort";
 import type { PluginContext } from "../types";
 export type SessionHooks = {
@@ -24,6 +24,7 @@ export type SessionHooks = {
     anthropicEffort: ReturnType<typeof createAnthropicEffortHook> | null;
     runtimeFallback: ReturnType<typeof createRuntimeFallbackHook> | null;
     rtkBashRewriter: ReturnType<typeof createRtkBashRewriterHook> | null;
+    mcpStartupNotification: ReturnType<typeof createMcpStartupNotificationHook> | null;
 };
 export declare function createSessionHooks(args: {
     ctx: PluginContext;

package/dist/plugin/hooks/create-tool-guard-hooks.d.ts

@@ -1,5 +1,5 @@
 import type { HookName, MatrixxConfig } from "../../config";
-import { createBashFileReadGuardHook, createCommentCheckerHooks, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createHashlineEditDiffEnhancerHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskNotepadHook, createTasksTodowriteDisablerHook, createTodoDescriptionOverrideHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
+import { createBashFileReadGuardHook, createCommentCheckerHooks, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createEvolutionWatcherHook, createHashlineEditDiffEnhancerHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskEditGuardHook, createTaskNotepadHook, createTasksTodowriteDisablerHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
 import type { PluginContext } from "../types";
 export type ToolGuardHooks = {
     commentChecker: ReturnType<typeof createCommentCheckerHooks> | null;
@@ -15,12 +15,13 @@ export type ToolGuardHooks = {
     envFileWriteGuard: ReturnType<typeof createEnvFileWriteGuardHook> | null;
     jsonErrorRecovery: ReturnType<typeof createJsonErrorRecoveryHook> | null;
     bashFileReadGuard: ReturnType<typeof createBashFileReadGuardHook> | null;
-    todoDescriptionOverride: ReturnType<typeof createTodoDescriptionOverrideHook> | null;
     readImageResizer: ReturnType<typeof createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof createWebFetchRedirectGuardHook> | null;
     hashlineEditDiffEnhancer: ReturnType<typeof createHashlineEditDiffEnhancerHook> | null;
     qualityGate: ReturnType<typeof createQualityGateHook> | null;
     taskNotepad: ReturnType<typeof createTaskNotepadHook> | null;
+    taskEditGuard: ReturnType<typeof createTaskEditGuardHook> | null;
+    evolutionWatcher: ReturnType<typeof createEvolutionWatcherHook> | null;
 };
 export declare function createToolGuardHooks(args: {
     ctx: PluginContext;

package/dist/plugin-handlers/agent-config-handler.d.ts

@@ -2,6 +2,7 @@ import type { MatrixxConfig } from "../config";
 import type { PluginComponents } from "./plugin-components-loader";
 export declare function setAvailableToolNames(names: string[]): void;
 export declare function getAvailableToolNames(): string[];
+export declare function injectContextDiscipline(availableToolNames: string[], agents: Record<string, Record<string, unknown>>): void;
 export declare function applyAgentConfig(params: {
     config: Record<string, unknown>;
     pluginConfig: MatrixxConfig;

package/dist/shared/delay.d.ts

@@ -0,0 +1 @@
+export declare function delay(ms: number): Promise<void>;

package/dist/shared/error-formatting.d.ts

@@ -25,3 +25,4 @@ export interface ErrorContext {
  * Replaces the `?? "pending"` anti-pattern across matrixx background task tools.
  */
 export declare function formatDetailedError(error: unknown, ctx: ErrorContext): string;
+export declare function getErrorMessage(error: unknown): string;

package/dist/shared/format-bytes.d.ts

@@ -0,0 +1 @@
+export declare function formatBytes(bytes: number): string;

package/dist/shared/format-bytes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/index.d.ts

@@ -1,34 +1,30 @@
 export * from "./agent-tool-restrictions";
 export * from "./agent-variant";
 export * from "./binary-downloader";
-export * from "./code-patterns";
-export * from "./code-patterns";
 export * from "./command-executor";
 export * from "./config-errors";
 export * from "./connected-providers-cache";
 export * from "./data-path";
 export * from "./deep-merge";
+export * from "./delay";
 export * from "./dynamic-truncator";
 export * from "./external-plugin-detector";
 export * from "./file-reference-resolver";
 export * from "./file-utils";
+export * from "./format-bytes";
 export * from "./format-duration";
 export * from "./frontmatter";
 export * from "./git-worktree";
-export * from "./is-object";
+export * from "./is-abort-error";
 export * from "./jsonc-parser";
 export * from "./logger";
 export * from "./migration";
 export * from "./model-availability";
 export * from "./model-requirements";
-export { resolveModelPipeline } from "./model-resolution-pipeline";
-export type { ModelResolutionProvenance, ModelResolutionRequest, ModelResolutionResult, } from "./model-resolution-types";
-export * from "./model-resolver";
-export * from "./model-sanitizer";
+export { type ModelResolutionProvenance, type ModelResolutionRequest, type ModelResolutionResult, normalizeModel, resolveModelPipeline, } from "./model-resolution-pipeline";
 export * from "./model-suggestion-retry";
 export * from "./normalize-sdk-response";
 export * from "./opencode-config-dir";
-export type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths, } from "./opencode-config-dir-types";
 export * from "./opencode-http-api";
 export * from "./opencode-message-dir";
 export * from "./opencode-server-auth";
@@ -38,14 +34,16 @@ export * from "./opencode-version";
 export * from "./permission-compat";
 export * from "./port-utils";
 export * from "./safe-create-hook";
+export * from "./sentinels";
 export * from "./session-cursor";
 export * from "./session-directory-resolver";
 export * from "./session-utils";
 export * from "./shell-env";
+export * from "./status-types";
 export * from "./system-directive";
 export * from "./tmux";
 export * from "./token-cache";
-export * from "./tool-guards";
 export * from "./transcript-path";
 export * from "./truncate-description";
+export * from "./with-timeout";
 export * from "./zip-extractor";

package/dist/shared/is-abort-error.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/model-resolution-pipeline.d.ts

@@ -1,2 +1,27 @@
-import type { ModelResolutionRequest, ModelResolutionResult } from "./model-resolution-types";
+import type { FallbackEntry } from "./model-requirements";
+export type ModelResolutionRequest = {
+    intent?: {
+        globalOverrideModel?: string;
+        uiSelectedModel?: string;
+        userModel?: string;
+        categoryDefaultModel?: string;
+    };
+    constraints: {
+        availableModels: Set<string>;
+        connectedProviders?: string[];
+    };
+    policy?: {
+        fallbackChain?: FallbackEntry[];
+        systemDefaultModel?: string;
+    };
+};
+export type ModelResolutionProvenance = "override" | "category-default" | "provider-fallback" | "system-default";
+export type ModelResolutionResult = {
+    model: string;
+    provenance: ModelResolutionProvenance;
+    variant?: string;
+    attempted?: string[];
+    reason?: string;
+};
+export declare function normalizeModel(model?: string): string | undefined;
 export declare function resolveModelPipeline(request: ModelResolutionRequest): ModelResolutionResult | undefined;

package/dist/shared/opencode-config-dir.d.ts

@@ -1,5 +1,16 @@
-import type { OpenCodeConfigDirOptions, OpenCodeConfigPaths } from "./opencode-config-dir-types";
-export type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths, } from "./opencode-config-dir-types";
+export type OpenCodeBinaryType = "opencode" | "opencode-desktop";
+export type OpenCodeConfigDirOptions = {
+    binary: OpenCodeBinaryType;
+    version?: string | null;
+    checkExisting?: boolean;
+};
+export type OpenCodeConfigPaths = {
+    configDir: string;
+    configJson: string;
+    configJsonc: string;
+    packageJson: string;
+    matrixxConfig: string;
+};
 export declare const TAURI_APP_IDENTIFIER = "ai.opencode.desktop";
 export declare const TAURI_APP_IDENTIFIER_DEV = "ai.opencode.desktop.dev";
 export declare function isDevBuild(version: string | null | undefined): boolean;

package/dist/shared/sentinels.d.ts

@@ -0,0 +1,2 @@
+export declare const NOT_CACHED: unique symbol;
+export declare const FALSE_PENDING_RETRY: unique symbol;

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

@@ -0,0 +1,15 @@
+export declare function setSessionTemperature(sessionID: string, temperature: number): void;
+export declare function getSessionTemperature(sessionID: string): number | undefined;
+export declare function clearSessionTemperature(sessionID: string): void;
+export declare function setSessionTools(sessionID: string, tools: Record<string, boolean>): void;
+export declare function getSessionTools(sessionID: string): Record<string, boolean> | undefined;
+export declare function clearSessionTools(): void;
+/**
+ * Per-session model tracking.
+ */
+type SessionModel = {
+    providerID: string;
+    modelID: string;
+};
+export declare function getSessionModel(sessionID: string): SessionModel | undefined;
+export {};

package/dist/shared/status-types.d.ts

@@ -0,0 +1 @@
+export type TaskStatus = "pending" | "running" | "completed" | "error";

package/dist/shared/system-directive.d.ts

@@ -34,6 +34,7 @@ export declare function hasSystemReminder(text: string): boolean;
 export declare function removeSystemReminders(text: string): string;
 export declare const SystemDirectiveTypes: {
     readonly TODO_CONTINUATION: "TODO CONTINUATION";
+    readonly TASK_CONTINUATION: "TASK CONTINUATION";
     readonly MATRIX_LOOP: "MATRIX LOOP";
     readonly MISSION_CONTINUATION: "MISSION CONTINUATION";
     readonly DELEGATION_REQUIRED: "DELEGATION REQUIRED";

package/dist/shared/task-system-gating.d.ts

@@ -0,0 +1,3 @@
+import type { MatrixxConfig } from "../config/schema";
+export declare const TASK_SYSTEM_DEFAULT: true;
+export declare function isTaskSystemEnabled(config: Partial<MatrixxConfig> | undefined | null): boolean;

package/dist/shared/task-system-gating.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/with-timeout.d.ts

@@ -0,0 +1 @@
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string): Promise<T>;

package/dist/shared/with-timeout.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/background-task/delay.d.ts

@@ -1 +1 @@
-export declare function delay(ms: number): Promise<void>;
+export { delay } from "../../shared/delay";

package/dist/tools/index.d.ts

@@ -8,6 +8,7 @@ export { createGlobTools } from "./glob";
 export { createGrepTools } from "./grep";
 export { createHandoffTools } from "./handoff";
 export { interactive_bash, startBackgroundCheck as startTmuxCheck } from "./interactive-bash";
+export { createPdfExtractFiguresTool } from "./pdf-extract-figures";
 export { createSessionManagerTools } from "./session-manager";
 export { sessionExists } from "./session-manager/storage";
 export { createSkillTool } from "./skill";
@@ -22,6 +23,6 @@ export { createDelegateAgent } from "./delegate-agent";
 export { createDelegateTask } from "./delegate-task";
 export { createHashlineEditTool } from "./hashline-edit";
 export { createLookAt } from "./look-at";
-export { createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, } from "./task";
+export { createTaskCleanupTool, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, } from "./task";
 export declare function createBackgroundTools(manager: BackgroundManager, client: OpencodeClient): Record<string, ToolDefinition>;
 export declare const builtinTools: Record<string, ToolDefinition>;

package/dist/tools/pdf-extract-figures/index.d.ts

@@ -0,0 +1 @@
+export { createPdfExtractFiguresTool } from "./tools";

package/dist/tools/pdf-extract-figures/tools.d.ts

@@ -0,0 +1,11 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+export interface PdfExtractFiguresArgs {
+    file_path: string;
+    output_dir?: string;
+    page?: number;
+    min_width?: number;
+    min_height?: number;
+    min_area?: number;
+    json_only?: boolean;
+}
+export declare function createPdfExtractFiguresTool(): Record<string, ToolDefinition>;

package/dist/tools/task/index.d.ts

@@ -1,6 +1,6 @@
+export { createTaskCleanupTool } from "./task-cleanup";
 export { createTaskCreateTool } from "./task-create";
 export { createTaskGetTool } from "./task-get";
 export { createTaskList } from "./task-list";
 export { createTaskUpdateTool } from "./task-update";
-export type { TodoInfo } from "./todo-sync";
 export type { TaskCreateInput, TaskDeleteInput, TaskGetInput, TaskListInput, TaskObject, TaskStatus, TaskUpdateInput } from "./types";

package/dist/tools/task/task-cleanup.d.ts

@@ -0,0 +1,4 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+import type { MatrixxConfig } from "../../config/schema";
+export declare function createTaskCleanupTool(config: Partial<MatrixxConfig>, ctx?: PluginInput): ToolDefinition;

package/dist/tools/task/task-cleanup.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/task/task-get.d.ts

@@ -1,3 +1,4 @@
+import type { PluginInput } from "@opencode-ai/plugin";
 import { type ToolDefinition } from "@opencode-ai/plugin/tool";
 import type { MatrixxConfig } from "../../config/schema";
-export declare function createTaskGetTool(config: Partial<MatrixxConfig>): ToolDefinition;
+export declare function createTaskGetTool(config: Partial<MatrixxConfig>, ctx?: PluginInput): ToolDefinition;

package/dist/tools/task/task-list.d.ts

@@ -1,3 +1,4 @@
+import type { PluginInput } from "@opencode-ai/plugin";
 import { type ToolDefinition } from "@opencode-ai/plugin/tool";
 import type { MatrixxConfig } from "../../config/schema";
-export declare function createTaskList(config: Partial<MatrixxConfig>): ToolDefinition;
+export declare function createTaskList(config: Partial<MatrixxConfig>, ctx?: PluginInput): ToolDefinition;

package/dist/tools/task/types.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 export declare const TaskStatusSchema: z.ZodEnum<{
     deleted: "deleted";
-    completed: "completed";
     pending: "pending";
+    completed: "completed";
     in_progress: "in_progress";
 }>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
@@ -12,8 +12,8 @@ export declare const TaskObjectSchema: z.ZodObject<{
     description: z.ZodString;
     status: z.ZodEnum<{
         deleted: "deleted";
-        completed: "completed";
         pending: "pending";
+        completed: "completed";
         in_progress: "in_progress";
     }>;
     activeForm: z.ZodOptional<z.ZodString>;
@@ -24,6 +24,7 @@ export declare const TaskObjectSchema: z.ZodObject<{
     repoURL: z.ZodOptional<z.ZodString>;
     parentID: z.ZodOptional<z.ZodString>;
     threadID: z.ZodString;
+    projectRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type TaskObject = z.infer<typeof TaskObjectSchema>;
 export declare const TaskSchema: z.ZodObject<{
@@ -32,8 +33,8 @@ export declare const TaskSchema: z.ZodObject<{
     description: z.ZodString;
     status: z.ZodEnum<{
         deleted: "deleted";
-        completed: "completed";
         pending: "pending";
+        completed: "completed";
         in_progress: "in_progress";
     }>;
     activeForm: z.ZodOptional<z.ZodString>;
@@ -44,6 +45,7 @@ export declare const TaskSchema: z.ZodObject<{
     repoURL: z.ZodOptional<z.ZodString>;
     parentID: z.ZodOptional<z.ZodString>;
     threadID: z.ZodString;
+    projectRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type Task = TaskObject;
 export declare const TaskCreateInputSchema: z.ZodObject<{
@@ -61,8 +63,8 @@ export type TaskCreateInput = z.infer<typeof TaskCreateInputSchema>;
 export declare const TaskListInputSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<{
         deleted: "deleted";
-        completed: "completed";
         pending: "pending";
+        completed: "completed";
         in_progress: "in_progress";
     }>>;
     parentID: z.ZodOptional<z.ZodString>;
@@ -78,8 +80,8 @@ export declare const TaskUpdateInputSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
         deleted: "deleted";
-        completed: "completed";
         pending: "pending";
+        completed: "completed";
         in_progress: "in_progress";
     }>>;
     activeForm: z.ZodOptional<z.ZodString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-matrixx",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,6 +8,10 @@
   "files": [
     "dist"
   ],
+  "bin": {
+    "opencode-matrixx": "dist/cli.js",
+    "matrixx": "dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -16,7 +20,9 @@
     "./schema.json": "./dist/matrixx.schema.json"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun run build:schema",
+    "build": "bun run build:plugin && bun run build:cli && tsc --emitDeclarationOnly && bun run build:schema",
+    "build:plugin": "bun build src/index.ts --outdir dist --target bun --format esm --external @ast-grep/napi --external \"opencode/*\" --external \"@opencode-ai/core/*\" --external effect --external \"effect/*\"",
+    "build:cli": "bun build src/cli/index.ts --outfile dist/cli.js --target bun --format esm && chmod +x dist/cli.js",
     "build:schema": "bun run script/build-schema.ts",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run clean && bun run build",
@@ -24,7 +30,8 @@
     "lint": "biome check src/",
     "lint:fix": "biome check --write src/",
     "ci": "bash script/run-ci.sh",
-    "test": "bash script/run-ci.sh"
+    "test": "bash script/run-ci.sh",
+    "matrixx": "bun run bin/matrixx.ts"
   },
   "keywords": [
     "opencode",
@@ -58,6 +65,7 @@
   "dependencies": {
     "@ast-grep/cli": "^0.40.0",
     "@ast-grep/napi": "^0.40.0",
+    "@clack/prompts": "^1.7.0",
     "@code-yeongyu/comment-checker": "^0.6.1",
     "@cucumber/gherkin": "^34.0.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
@@ -94,5 +102,9 @@
     "@ast-grep/cli",
     "@ast-grep/napi",
     "@code-yeongyu/comment-checker"
-  ]
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
 }

package/dist/config/schema/model-capabilities.d.ts

@@ -1,8 +0,0 @@
-import { z } from "zod";
-export declare const ModelCapabilitiesConfigSchema: z.ZodObject<{
-    enabled: z.ZodOptional<z.ZodBoolean>;
-    auto_refresh_on_start: z.ZodOptional<z.ZodBoolean>;
-    refresh_timeout_ms: z.ZodOptional<z.ZodNumber>;
-    source_url: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type ModelCapabilitiesConfig = z.infer<typeof ModelCapabilitiesConfigSchema>;

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

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

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

@@ -1 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

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

package/dist/shared/is-object.d.ts

@@ -1 +0,0 @@
-export declare function isObject(value: unknown): value is Record<string, unknown>;

package/dist/shared/model-resolution-types.d.ts

@@ -1,27 +0,0 @@
-import type { FallbackEntry } from "./model-requirements";
-export type ModelResolutionRequest = {
-    intent?: {
-        /** Global override for all agents and categories — set via the global_model config.
-         * Highest priority; checked before everything else. */
-        globalOverrideModel?: string;
-        uiSelectedModel?: string;
-        userModel?: string;
-        categoryDefaultModel?: string;
-    };
-    constraints: {
-        availableModels: Set<string>;
-        connectedProviders?: string[];
-    };
-    policy?: {
-        fallbackChain?: FallbackEntry[];
-        systemDefaultModel?: string;
-    };
-};
-export type ModelResolutionProvenance = "override" | "category-default" | "provider-fallback" | "system-default";
-export type ModelResolutionResult = {
-    model: string;
-    provenance: ModelResolutionProvenance;
-    variant?: string;
-    attempted?: string[];
-    reason?: string;
-};

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

@@ -1,24 +0,0 @@
-import type { FallbackEntry } from "./model-requirements";
-import type { ModelResolutionProvenance } from "./model-resolution-types";
-export type ModelResolutionInput = {
-    userModel?: string;
-    inheritedModel?: string;
-    systemDefault?: string;
-};
-/** @deprecated Use ModelResolutionProvenance from model-resolution-types.ts */
-export type ModelSource = ModelResolutionProvenance;
-export type ModelResolutionResult = {
-    model: string;
-    source: ModelResolutionProvenance;
-    variant?: string;
-};
-export type ExtendedModelResolutionInput = {
-    uiSelectedModel?: string;
-    userModel?: string;
-    categoryDefaultModel?: string;
-    fallbackChain?: FallbackEntry[];
-    availableModels: Set<string>;
-    systemDefaultModel?: string;
-};
-export declare function resolveModel(input: ModelResolutionInput): string | undefined;
-export declare function resolveModelWithFallback(input: ExtendedModelResolutionInput): ModelResolutionResult | undefined;

package/dist/shared/opencode-config-dir-types.d.ts

@@ -1,13 +0,0 @@
-export type OpenCodeBinaryType = "opencode" | "opencode-desktop";
-export type OpenCodeConfigDirOptions = {
-    binary: OpenCodeBinaryType;
-    version?: string | null;
-    checkExisting?: boolean;
-};
-export type OpenCodeConfigPaths = {
-    configDir: string;
-    configJson: string;
-    configJsonc: string;
-    packageJson: string;
-    matrixxConfig: string;
-};

package/dist/shared/session-model-state.d.ts

@@ -1,6 +0,0 @@
-type SessionModel = {
-    providerID: string;
-    modelID: string;
-};
-export declare function getSessionModel(sessionID: string): SessionModel | undefined;
-export {};

package/dist/shared/session-temperature-store.d.ts

@@ -1,3 +0,0 @@
-export declare function setSessionTemperature(sessionID: string, temperature: number): void;
-export declare function getSessionTemperature(sessionID: string): number | undefined;
-export declare function clearSessionTemperature(sessionID: string): void;

package/dist/shared/session-tools-store.d.ts

@@ -1,3 +0,0 @@
-export declare function setSessionTools(sessionID: string, tools: Record<string, boolean>): void;
-export declare function getSessionTools(sessionID: string): Record<string, boolean> | undefined;
-export declare function clearSessionTools(): void;