opencode-matrixx 2.6.13 → 2.6.14

package/dist/matrixx.schema.json

@@ -160,7 +160,6 @@
             "type": "string",
             "enum": [
               "task-continuation-enforcer",
-              "todo-continuation-enforcer",
               "context-window-monitor",
               "session-recovery",
               "session-notification",
@@ -184,7 +183,6 @@
               "matrix-loop",
               "category-skill-reminder",
               "compaction-context-injector",
-              "compaction-todo-preserver",
               "auto-slash-command",
               "edit-error-recovery",
               "delegate-task-retry",
@@ -196,7 +194,6 @@
               "unstable-agent-babysitter",
               "task-resume-info",
               "stop-continuation-guard",
-              "tasks-todowrite-disabler",
               "write-existing-file-guard",
               "anthropic-effort",
               "hashline-read-enhancer",
@@ -211,7 +208,6 @@
               "webfetch-redirect-guard",
               "tool-pair-validator",
               "quality-gate",
-              "task-notepad",
               "design-intent-preserver",
               "rtk-bash-rewriter",
               "evolution-watcher",
@@ -224,10 +220,27 @@
               "knowledge-hub-injector",
               "knowledge-hub-search-nudge",
               "dcp-nudge-sanitizer",
-              "nudge-loop-breaker"
+              "nudge-loop-breaker",
+              "task-notepad-writer"
             ]
           },
-          {}
+          {},
+          {
+            "type": "string",
+            "const": "todo-continuation-enforcer"
+          },
+          {
+            "type": "string",
+            "const": "compaction-todo-preserver"
+          },
+          {
+            "type": "string",
+            "const": "tasks-todowrite-disabler"
+          },
+          {
+            "type": "string",
+            "const": "task-notepad"
+          }
         ]
       }
     },
@@ -3937,7 +3950,6 @@
           "type": "boolean"
         },
         "task_system": {
-          "default": true,
           "type": "boolean"
         },
         "plugin_load_timeout_ms": {
@@ -3961,9 +3973,6 @@
           "type": "boolean"
         }
       },
-      "required": [
-        "task_system"
-      ],
       "additionalProperties": false
     },
     "dcp": {
@@ -4850,10 +4859,15 @@
           "type": "string"
         },
         "stale_after_hours": {
-          "description": "Pending tasks with no file activity for this many hours are considered stale (default: 24). Stale tasks are excluded from task-continuation directives.",
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 9007199254740991
+          "description": "Pending tasks with no file activity for this many hours are considered stale and excluded from task-continuation directives. Accepts fractional hours (minimum 0.25 = 15 minutes); there is no separate minutes companion key. Default 24.",
+          "type": "number",
+          "minimum": 0.25
+        },
+        "background_stale_after_hours": {
+          "description": "Window used only by the background-agent completion gates: a pending/in_progress task with no file activity for this many hours stops blocking completion of its background handle. Separate from stale_after_hours because a missed nudge and a wedged handle are different failures. Accepts fractional hours (min 0.25). Default 2.",
+          "default": 2,
+          "type": "number",
+          "minimum": 0.25
         },
         "session_scoped": {
           "description": "When true, the task-continuation-enforcer only considers tasks created by the current session (or its subagent sessions). When false, all project tasks are considered regardless of session origin.",
@@ -4991,10 +5005,9 @@
               ]
             },
             "stale_after_hours": {
-              "description": "Pending tasks with no file activity for this many hours are considered stale (default: 24). Stale tasks are excluded from task-continuation directives.",
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 9007199254740991
+              "description": "Pending tasks with no file activity for this many hours are considered stale and excluded from task-continuation directives. Accepts fractional hours (minimum 0.25 = 15 minutes); there is no separate minutes companion key. Default 24.",
+              "type": "number",
+              "minimum": 0.25
             },
             "session_scoped": {
               "description": "When true, the task-continuation-enforcer only considers tasks created by the current session (or its subagent sessions). When false, all project tasks are considered regardless of session origin.",

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

@@ -1,13 +1,11 @@
 import type { HookName, MatrixxConfig } from "../../config";
 import type { BackgroundManager } from "../../features/background-agent";
-import { createArchitectHook, createBackgroundNotificationHook, createCompactionContextInjector, createCompactionTodoPreserverHook, createEvolutionCompressorHook, createEvolutionHitlHook, createNudgeLoopBreakerHook, createPlanPersister, createStopContinuationGuardHook, createTaskContinuationEnforcer, createTodoContinuationEnforcer } from "../../hooks";
+import { createArchitectHook, createBackgroundNotificationHook, createCompactionContextInjector, createEvolutionCompressorHook, createEvolutionHitlHook, createNudgeLoopBreakerHook, createPlanPersister, createStopContinuationGuardHook, createTaskContinuationEnforcer } from "../../hooks";
 import type { PluginContext } from "../types";
 import { createUnstableAgentBabysitter } from "../unstable-agent-babysitter";
 export type ContinuationHooks = {
     stopContinuationGuard: ReturnType<typeof createStopContinuationGuardHook> | null;
     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;
     nudgeLoopBreaker: ReturnType<typeof createNudgeLoopBreakerHook> | null;

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

@@ -21,7 +21,6 @@ export declare function createCoreHooks(args: {
     directoryAgentsInjector: ReturnType<typeof import("../../hooks").createDirectoryAgentsInjectorHook> | null;
     emptyTaskResponseDetector: ReturnType<typeof import("../../hooks").createEmptyTaskResponseDetectorHook> | null;
     rulesInjector: ReturnType<typeof import("../../hooks").createRulesInjectorHook> | null;
-    tasksTodowriteDisabler: ReturnType<typeof import("../../hooks").createTasksTodowriteDisablerHook> | null;
     writeExistingFileGuard: ReturnType<typeof import("../../hooks").createWriteExistingFileGuardHook> | null;
     hashlineReadEnhancer: ReturnType<typeof import("../../hooks").createHashlineReadEnhancerHook> | null;
     secretLeakGuard: ReturnType<typeof import("../../hooks").createSecretLeakGuardHook> | null;
@@ -32,8 +31,8 @@ export declare function createCoreHooks(args: {
     readImageResizer: ReturnType<typeof import("../../hooks").createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof import("../../hooks").createWebFetchRedirectGuardHook> | null;
     qualityGate: ReturnType<typeof import("../../hooks").createQualityGateHook> | null;
-    taskNotepad: ReturnType<typeof import("../../hooks").createTaskNotepadHook> | null;
     taskEditGuard: ReturnType<typeof import("../../hooks").createTaskEditGuardHook> | null;
+    taskNotepadWriter: ReturnType<typeof import("../../hooks").createTaskNotepadWriterHook> | null;
     documentReaderGuard: ReturnType<typeof import("../../hooks").createDocumentReaderGuardHook> | null;
     knowledgeHubGuard: ReturnType<typeof import("../../hooks").createKnowledgeHubGuardHook> | null;
     knowledgeHubSearchNudge: ReturnType<typeof import("../../hooks").createKnowledgeHubSearchNudgeHook> | null;

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

@@ -1,5 +1,5 @@
 import type { HookName, MatrixxConfig } from "../../config";
-import { createBackgroundTaskBlockerHook, createBashFileReadGuardHook, createCommentCheckerHooks, createContextModeEnforcerHook, createDirectoryAgentsInjectorHook, createDocumentReaderGuardHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createEvolutionWatcherHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createKnowledgeHubGuardHook, createKnowledgeHubSearchNudgeHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskEditGuardHook, createTaskNotepadHook, createTasksTodowriteDisablerHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
+import { createBackgroundTaskBlockerHook, createBashFileReadGuardHook, createCommentCheckerHooks, createContextModeEnforcerHook, createDirectoryAgentsInjectorHook, createDocumentReaderGuardHook, createEmptyTaskResponseDetectorHook, createEnvFileWriteGuardHook, createEvolutionWatcherHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook, createKnowledgeHubGuardHook, createKnowledgeHubSearchNudgeHook, createQualityGateHook, createReadImageResizerHook, createRulesInjectorHook, createSecretLeakGuardHook, createTaskEditGuardHook, createTaskNotepadWriterHook, createToolOutputTruncatorHook, createWebFetchRedirectGuardHook, createWriteExistingFileGuardHook } from "../../hooks";
 import type { PluginContext } from "../types";
 export type ToolGuardHooks = {
     backgroundTaskBlocker: ReturnType<typeof createBackgroundTaskBlockerHook> | null;
@@ -8,7 +8,6 @@ export type ToolGuardHooks = {
     directoryAgentsInjector: ReturnType<typeof createDirectoryAgentsInjectorHook> | null;
     emptyTaskResponseDetector: ReturnType<typeof createEmptyTaskResponseDetectorHook> | null;
     rulesInjector: ReturnType<typeof createRulesInjectorHook> | null;
-    tasksTodowriteDisabler: ReturnType<typeof createTasksTodowriteDisablerHook> | null;
     writeExistingFileGuard: ReturnType<typeof createWriteExistingFileGuardHook> | null;
     hashlineReadEnhancer: ReturnType<typeof createHashlineReadEnhancerHook> | null;
     secretLeakGuard: ReturnType<typeof createSecretLeakGuardHook> | null;
@@ -19,8 +18,8 @@ export type ToolGuardHooks = {
     readImageResizer: ReturnType<typeof createReadImageResizerHook> | null;
     webfetchRedirectGuard: ReturnType<typeof createWebFetchRedirectGuardHook> | null;
     qualityGate: ReturnType<typeof createQualityGateHook> | null;
-    taskNotepad: ReturnType<typeof createTaskNotepadHook> | null;
     taskEditGuard: ReturnType<typeof createTaskEditGuardHook> | null;
+    taskNotepadWriter: ReturnType<typeof createTaskNotepadWriterHook> | null;
     documentReaderGuard: ReturnType<typeof createDocumentReaderGuardHook> | null;
     knowledgeHubGuard: ReturnType<typeof createKnowledgeHubGuardHook> | null;
     knowledgeHubSearchNudge: ReturnType<typeof createKnowledgeHubSearchNudgeHook> | null;

package/dist/plugin-handlers/task-permissions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Task-store permission grants.
+ *
+ * The task store (`.matrixx/tasks/`) is a separate write channel from the
+ * codebase. An agent whose prompt tells it to track work with tasks must be
+ * able to reach it, no matter which agent happens to hold delegation rights.
+ */
+/** The legacy todo tools are denied for every task-capable agent. */
+export declare const denyTodoTools: {
+    readonly todowrite: "deny";
+    readonly todoread: "deny";
+};
+/**
+ * Tracking only: the agent may read and write its own task-store records but
+ * may not delegate. Granted to every primary-capable agent.
+ */
+export declare const taskStorePermissions: {
+    readonly todowrite: "deny";
+    readonly todoread: "deny";
+    readonly "task_*": "allow";
+};
+/** Tracking plus outgoing delegation via the task tool. */
+export declare const fullTaskPermissions: {
+    readonly todowrite: "deny";
+    readonly todoread: "deny";
+    readonly task: "allow";
+    readonly "task_*": "allow";
+    readonly teammate: "allow";
+};
+type AgentLike = {
+    mode?: string;
+    permission?: Record<string, unknown>;
+};
+/**
+ * An agent that can be driven as a top-level session is expected to track its
+ * own work in the task store. Derived from the declared mode, never from a
+ * hardcoded name list — a name list is exactly what let the original drift go
+ * unnoticed.
+ */
+export declare function isTaskStorePrimary(agent: AgentLike): boolean;
+/** The permission defaults a primary-capable agent is missing. */
+export declare function deriveTaskPermissions(agent: AgentLike): Record<string, string>;
+/**
+ * Fill-only merge (the architect arm's `??=` pattern): a factory value or an
+ * explicit user override in their own config is never overwritten here.
+ */
+export declare function grantTaskPermissions(agent: AgentLike): void;
+export {};

package/dist/shared/logger.d.ts

@@ -1 +1,2 @@
+export declare function warn(message: string, data?: unknown): void;
 export declare function log(message: string, data?: unknown): void;

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

@@ -33,7 +33,6 @@ 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";

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

@@ -1,12 +1,32 @@
 import type { MatrixxConfig } from "../config/schema";
 import type { TasksConfig } from "../config/schema/tasks";
 export declare const TASK_SYSTEM_DEFAULT: true;
-export type ResolvedTasksConfig = Required<Pick<TasksConfig, "enabled" | "scope" | "session_scoped">> & Pick<TasksConfig, "storage_path" | "task_list_id" | "stale_after_hours" | "pollTimeoutMs">;
+export type ResolvedTasksConfig = Required<Pick<TasksConfig, "enabled" | "scope" | "session_scoped">> & Pick<TasksConfig, "storage_path" | "task_list_id" | "stale_after_hours" | "pollTimeoutMs" | "background_stale_after_hours">;
 /**
- * Merge the canonical `tasks` section with legacy locations.
- * Explicit `tasks.*` always wins; legacy keys fill the gaps:
- * `experimental.task_system` / `new_task_system_enabled` → enabled,
+ * Fallback for `tasks.background_stale_after_hours` when the key is absent.
+ * Kept here, next to the resolution that applies it, so the default and its
+ * use site cannot drift; re-exported from the enforcer's `staleness.ts` where
+ * the other staleness default lives.
+ */
+export declare const DEFAULT_BACKGROUND_STALE_AFTER_HOURS = 2;
+/**
+ * Point the one-time deprecation toast at an OpenCode client. Pass
+ * `undefined` to detach. Failures are swallowed — a toast is never worth a
+ * broken config load.
+ */
+export declare function bindTaskSystemDeprecationToast(client: unknown): void;
+/** Test-only: allow the one-time warning to fire again. */
+export declare function resetTaskSystemDeprecationWarning(): void;
+/**
+ * Merge the canonical `tasks` section with the remaining legacy locations:
  * `morpheus.tasks.*` → same-named key, `task.pollTimeoutMs` → pollTimeoutMs.
+ *
+ * `enabled` is NOT derived from the config: the file-backed task system is
+ * unconditional and always resolves to `TASK_SYSTEM_DEFAULT`. The three keys
+ * that used to gate it (`tasks.enabled`, `experimental.task_system`,
+ * `new_task_system_enabled`) are parsed, ignored, and reported once per session
+ * via `warn` plus a single startup toast. Nothing here throws.
+ *
  * Pure derivation, no mutation — safe to call on every read.
  */
 export declare function resolveTasksConfig(config: Partial<MatrixxConfig> | undefined | null): ResolvedTasksConfig;

package/dist/tools/session-manager/constants.d.ts

@@ -2,7 +2,7 @@ export { MESSAGE_STORAGE, OPENCODE_STORAGE, PART_STORAGE, SESSION_STORAGE } from
 export declare const TODO_DIR: string;
 export declare const TRANSCRIPT_DIR: string;
 export declare const SESSION_LIST_DESCRIPTION = "List all OpenCode sessions with optional filtering.\n\nReturns a list of available session IDs with metadata including message count, date range, and agents used.\n\nArguments:\n- limit (optional): Maximum number of sessions to return\n- from_date (optional): Filter sessions from this date (ISO 8601 format)\n- to_date (optional): Filter sessions until this date (ISO 8601 format)\n\nExample output:\n| Session ID | Messages | First | Last | Agents |\n|------------|----------|-------|------|--------|\n| ses_abc123 | 45 | 2025-12-20 | 2025-12-24 | build, oracle |\n| ses_def456 | 12 | 2025-12-19 | 2025-12-19 | build |";
-export declare const SESSION_READ_DESCRIPTION = "Read messages and history from an OpenCode session.\n\nReturns a formatted view of session messages with role, timestamp, and content. Optionally includes todos and transcript data.\n\nArguments:\n- session_id (required): Session ID to read\n- include_todos (optional): Include todo list if available (default: false)\n- include_transcript (optional): Include transcript log if available (default: false)\n- limit (optional): Maximum number of messages to return (default: all)\n\nExample output:\nSession: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 to 2025-12-24\n\n[Message 1] user (2025-12-20 10:30:00)\nHello, can you help me with...\n\n[Message 2] assistant (2025-12-20 10:30:15)\nOf course! Let me help you with...";
+export declare const SESSION_READ_DESCRIPTION = "Read messages and history from an OpenCode session.\n\nReturns a formatted view of session messages with role, timestamp, and content. Optionally includes task state and transcript data.\n\nArguments:\n- session_id (required): Session ID to read\n- include_todos (optional): Include the session's task state from the task store if available (default: false). Every task attributed to the session is listed, including one that has been untouched long enough to be stale, so an unfinished item is never hidden from this diagnostic.\n- include_transcript (optional): Include transcript log if available (default: false)\n- limit (optional): Maximum number of messages to return (default: all)\n\nExample output:\nSession: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 to 2025-12-24\n\n[Message 1] user (2025-12-20 10:30:00)\nHello, can you help me with...\n\n[Message 2] assistant (2025-12-20 10:30:15)\nOf course! Let me help you with...";
 export declare const SESSION_SEARCH_DESCRIPTION = "Search for content within OpenCode session messages.\n\nPerforms full-text search across session messages and returns matching excerpts with context.\n\nArguments:\n- query (required): Search query string\n- session_id (optional): Search within specific session only (default: all sessions)\n- case_sensitive (optional): Case-sensitive search (default: false)\n- limit (optional): Maximum number of results to return (default: 20)\n\nExample output:\nFound 3 matches across 2 sessions:\n\n[ses_abc123] Message msg_001 (user)\n...implement the **session manager** tool...\n\n[ses_abc123] Message msg_005 (assistant)\n...I'll create a **session manager** with full search...\n\n[ses_def456] Message msg_012 (user)\n...use the **session manager** to find...";
 export declare const SESSION_INFO_DESCRIPTION = "Get metadata and statistics about an OpenCode session.\n\nReturns detailed information about a session including message count, date range, agents used, and available data sources.\n\nArguments:\n- session_id (required): Session ID to inspect\n\nExample output:\nSession ID: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 10:30:00 to 2025-12-24 15:45:30\nDuration: 4 days, 5 hours\nAgents Used: build, oracle, librarian\nHas Todos: Yes (12 items, 8 completed)\nHas Transcript: Yes (234 entries)";
 export declare const SESSION_DELETE_DESCRIPTION = "Delete an OpenCode session and all associated data.\n\nRemoves session messages, parts, todos, and transcript. This operation cannot be undone.\n\nArguments:\n- session_id (required): Session ID to delete\n- confirm (required): Must be true to confirm deletion\n\nExample:\nsession_delete(session_id=\"ses_abc123\", confirm=true)\nSuccessfully deleted session ses_abc123";

package/dist/tools/session-manager/storage.d.ts

@@ -1,14 +1,58 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+import type { MatrixxConfig } from "../../config/schema";
 import type { SessionInfo, SessionMessage, SessionMetadata, TodoItem } from "./types";
 interface GetMainSessionsOptions {
     directory?: string;
 }
 export declare function setStorageClient(client: PluginInput["client"]): void;
 export declare function resetStorageClient(): void;
+/**
+ * Thread `ctx.directory` into the storage layer. `createSessionManagerTools` is the
+ * single construction point of this module, so the directory is held in a module
+ * setter for the same reason the SDK client is: `getSessionInfo` is a second
+ * consumer of the task read and has no directory of its own, so an explicit
+ * parameter would have to be threaded through both public signatures. Passing no
+ * directory makes the task store resolve to its global default, matching
+ * `getTaskDir`'s own contract when `directory` is omitted; this function needs a
+ * concrete string, so an unset directory falls back to `process.cwd()` exactly as
+ * `getTaskDir` does for a relative `storage_path`.
+ */
+export declare function setStorageDirectory(directory: string | undefined): void;
+/**
+ * Thread the plugin config into the task read, for the same reason as the directory:
+ * `getSessionInfo` is a second consumer of `readSessionTodos` and carries neither a
+ * config nor a directory of its own. Without it the read always resolves the
+ * `process.cwd()`-relative project store, which silently returns nothing for a user
+ * who configured `tasks.storage_path` or `tasks.scope: "global"` — the `include_todos`
+ * diagnostic would be permanently empty for exactly those users.
+ */
+export declare function setStorageConfig(config: Partial<MatrixxConfig> | undefined): void;
 export declare function getMainSessions(options: GetMainSessionsOptions): Promise<SessionMetadata[]>;
 export declare function getAllSessions(): Promise<string[]>;
 export { getMessageDir } from "../../shared/opencode-message-dir";
 export declare function sessionExists(sessionID: string): Promise<boolean>;
 export declare function readSessionMessages(sessionID: string): Promise<SessionMessage[]>;
+/**
+ * Read the file-backed task store for one session. Replaces the legacy read of
+ * OpenCode's own todo state, which had two branches: the SDK endpoint and a "stable
+ * mode" scan of OpenCode's on-disk todo directory. Both are gone.
+ *
+ * There is deliberately no `isSqliteBackend()` split here, unlike the message and
+ * session readers in this file. That distinction exists because those endpoints
+ * differ per backend; the task store is a plugin-owned local directory, so it is
+ * backend-independent and one read covers both. Do not "restore" the branch.
+ *
+ * Fails open via `readSessionTasks`: a missing store or an unreadable file yields
+ * `[]` rather than throwing, matching the contract of the reads it replaces.
+ *
+ * `excludeStale: false` is an explicit local opt-out, not a change of default.
+ * `SessionTaskQuery.excludeStale` stays `true` so a completion gate cannot leak a
+ * pending handle forever; that bound belongs to the gates, not to this read. This
+ * is the `include_todos` / `SessionInfo.todos` diagnostic, and the native list it
+ * replaced applied no staleness filter at all, so inheriting the default silently
+ * dropped an untouched-but-unfinished task from the view a user inspects when
+ * asking "what is this session carrying?" — which is why a session could report
+ * `has_todos: true` and render an empty list.
+ */
 export declare function readSessionTodos(sessionID: string): Promise<TodoItem[]>;
 export declare function getSessionInfo(sessionID: string): Promise<SessionInfo | null>;

package/dist/tools/session-manager/tools.d.ts

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

package/dist/tools/task/create-one.d.ts

@@ -0,0 +1,21 @@
+import type { TaskCreateInput, TaskObject } from "./types";
+export type CreateOneResult = {
+    outcome: "created";
+    task: TaskObject;
+} | {
+    outcome: "deduplicated";
+    id: string;
+    subject: string;
+};
+export interface CreateOneOptions {
+    input: TaskCreateInput;
+    taskDir: string;
+    directory: string;
+    threadID: string;
+}
+/**
+ * The caller owns the storage lock. This reads and writes one task and nothing
+ * else, so a batch can call it strictly sequentially and have item N's write
+ * already on disk when item N+1 runs its dedup scan.
+ */
+export declare function createOneTask(options: CreateOneOptions): CreateOneResult;

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

@@ -6,6 +6,13 @@ export declare const TaskStatusSchema: z.ZodEnum<{
     in_progress: "in_progress";
 }>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
+/** Optional with no default: pre-existing task files must keep loading unmodified. */
+export declare const TaskPrioritySchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+}>;
+export type TaskPriority = z.infer<typeof TaskPrioritySchema>;
 /** Task ID must match T-{uuid}-style format (rejects truncated IDs like "T-"). */
 export declare const TaskIdSchema: z.ZodString;
 export declare const TaskObjectSchema: z.ZodObject<{
@@ -27,6 +34,11 @@ export declare const TaskObjectSchema: z.ZodObject<{
     parentID: z.ZodOptional<z.ZodString>;
     threadID: z.ZodString;
     projectRoot: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
 }, z.core.$strict>;
 export type TaskObject = z.infer<typeof TaskObjectSchema>;
 export declare const TaskSchema: z.ZodObject<{
@@ -48,8 +60,17 @@ export declare const TaskSchema: z.ZodObject<{
     parentID: z.ZodOptional<z.ZodString>;
     threadID: z.ZodString;
     projectRoot: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
 }, z.core.$strict>;
 export type Task = TaskObject;
+/**
+ * Strict on purpose: `status` belongs to `task_update`, and silently dropping a
+ * key the caller was told about is how an argument shape drifts from the schema.
+ */
 export declare const TaskCreateInputSchema: z.ZodObject<{
     subject: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -60,8 +81,37 @@ export declare const TaskCreateInputSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     repoURL: z.ZodOptional<z.ZodString>;
     parentID: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+}, z.core.$strict>;
 export type TaskCreateInput = z.infer<typeof TaskCreateInputSchema>;
+/**
+ * Batch form of `task_create`. A top-level array is unrepresentable: the SDK
+ * types `args` as a ZodRawShape (a flat record of zod types) and validates it
+ * into a ZodObject before `execute` runs, so a declared `items` key is the only
+ * expressible way to create more than one task in a single call.
+ *
+ * Items are `unknown` here on purpose: each one is validated separately by
+ * `TaskCreateInputSchema` so a bad item fails alone instead of failing the call.
+ */
+export declare const TaskCreateBatchInputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strict>;
+export type TaskCreateBatchInput = z.infer<typeof TaskCreateBatchInputSchema>;
+/** One entry of the `tasks` array in the single, always-present response envelope. */
+export type CreatedTaskSummary = {
+    id: string;
+    subject: string;
+    deduplicated?: boolean;
+};
+/** A batch item that failed validation on its own; `index` is its position in `items`. */
+export type TaskCreateItemError = {
+    index: number;
+    message: string;
+};
 export declare const TaskListInputSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<{
         deleted: "deleted";
@@ -93,6 +143,11 @@ export declare const TaskUpdateInputSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     repoURL: z.ZodOptional<z.ZodString>;
     parentID: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
 }, z.core.$strip>;
 export type TaskUpdateInput = z.infer<typeof TaskUpdateInputSchema>;
 export declare const TaskDeleteInputSchema: z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-matrixx",
-  "version": "2.6.13",
+  "version": "2.6.14",
   "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",

package/dist/hooks/compaction-todo-preserver/hook.d.ts

@@ -1,24 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-interface TodoSnapshot {
-    id: string;
-    content: string;
-    status: "pending" | "in_progress" | "completed" | "cancelled";
-    priority?: "low" | "medium" | "high";
-}
-type TodoWriter = (input: {
-    sessionID: string;
-    todos: TodoSnapshot[];
-}) => Promise<void>;
-export declare function _resetForTesting(): void;
-export declare function _setWriterForTesting(writer: TodoWriter | null | undefined): void;
-export interface CompactionTodoPreserver {
-    capture: (sessionID: string) => Promise<void>;
-    event: (input: {
-        event: {
-            type: string;
-            properties?: unknown;
-        };
-    }) => Promise<void>;
-}
-export declare function createCompactionTodoPreserverHook(ctx: PluginInput): CompactionTodoPreserver;
-export {};

package/dist/hooks/compaction-todo-preserver/index.d.ts

@@ -1,2 +0,0 @@
-export type { CompactionTodoPreserver } from "./hook";
-export { _resetForTesting, _setWriterForTesting, createCompactionTodoPreserverHook } from "./hook";

package/dist/hooks/session-todo-status.d.ts

@@ -1,2 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-export declare function hasIncompleteTodos(ctx: PluginInput, sessionID: string): Promise<boolean>;

package/dist/hooks/task-notepad/constants.d.ts

@@ -1,10 +0,0 @@
-export declare const HOOK_NAME = "task-notepad";
-export declare const PLAN_DIR_NAME = ".matrixx";
-export declare const PLANS_SUBDIR = "plans";
-export declare const NOTEPAD_DIR_NAME = "notepads";
-export declare const TASKS_SUBDIR = "tasks";
-export declare const PLAN_EXTENSION = ".md";
-export declare const NOTEPAD_EXTENSION = ".md";
-export declare const TODO_TOOL_NAMES: Set<string>;
-export declare const TASK_NOTEPAD_FRAGMENT = "task-notepad";
-export declare const TODO_FETCH_ERROR_FRAGMENT = "Failed to fetch todos for task-notepad";

package/dist/hooks/task-notepad/hook.d.ts

@@ -1,12 +0,0 @@
-import type { TaskNotepadContext } from "./types";
-export declare function createTaskNotepadHook(ctx: TaskNotepadContext): {
-    "tool.execute.after": (input: {
-        tool: string;
-        sessionID: string;
-        callID: string;
-    }, output: {
-        title: string;
-        output: string;
-        metadata: Record<string, unknown>;
-    } | undefined) => Promise<void>;
-};

package/dist/hooks/task-notepad/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./constants";
-export { createTaskNotepadHook } from "./hook";
-export * from "./types";

package/dist/hooks/task-notepad/types.d.ts

@@ -1,16 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-type TodoStatus = "pending" | "in_progress" | "completed" | "cancelled";
-type TodoPriority = "low" | "medium" | "high";
-export interface TodoSnapshot {
-    id: string;
-    content: string;
-    status: TodoStatus;
-    priority?: TodoPriority;
-}
-export interface PlanFile {
-    name: string;
-    path: string;
-    mtimeMs: number;
-}
-export type TaskNotepadContext = Pick<PluginInput, "client" | "directory">;
-export {};

package/dist/hooks/tasks-todowrite-disabler/constants.d.ts

@@ -1,3 +0,0 @@
-export declare const HOOK_NAME = "tasks-todowrite-disabler";
-export declare const BLOCKED_TOOLS: string[];
-export declare const REPLACEMENT_MESSAGE = "TodoRead/TodoWrite are DISABLED because tasks.enabled is true.\n\n**ACTION REQUIRED**: RE-REGISTER what you were about to write as Todo using Task tools NOW. Then ASSIGN yourself and START WORKING immediately.\n\n**Use these tools instead:**\n- TaskCreate: Create new task with auto-generated ID\n- TaskUpdate: Update status, assign owner, add dependencies\n- TaskList: List active tasks with dependency info\n- TaskGet: Get full task details\n\n**Workflow:**\n1. TaskCreate({ subject: \"your task description\" })\n2. TaskUpdate({ id: \"T-xxx\", status: \"in_progress\", owner: \"your-thread-id\" })\n3. DO THE WORK\n4. TaskUpdate({ id: \"T-xxx\", status: \"completed\" })\n\nCRITICAL: 1 task = 1 task. Fire independent tasks concurrently.\n\n**STOP! DO NOT START WORKING DIRECTLY - NO MATTER HOW SMALL THE TASK!**\nEven if the task seems trivial (1 line fix, simple edit, quick change), you MUST:\n1. FIRST register it with TaskCreate\n2. THEN mark it in_progress\n3. ONLY THEN do the actual work\n4. FINALLY mark it completed\n\n**WHY?** Task tracking = visibility = accountability. Skipping registration = invisible work = chaos.\n\nDO NOT retry TodoWrite. Convert to TaskCreate NOW.";

package/dist/hooks/tasks-todowrite-disabler/hook.d.ts

@@ -1,14 +0,0 @@
-export interface TasksTodowriteDisablerConfig {
-    experimental?: {
-        task_system?: boolean;
-    };
-}
-export declare function createTasksTodowriteDisablerHook(config: TasksTodowriteDisablerConfig): {
-    "tool.execute.before": (input: {
-        tool: string;
-        sessionID: string;
-        callID: string;
-    }, _output: {
-        args: Record<string, unknown>;
-    }) => Promise<void>;
-};

package/dist/hooks/tasks-todowrite-disabler/index.d.ts

@@ -1,2 +0,0 @@
-export type { TasksTodowriteDisablerConfig } from "./hook";
-export { createTasksTodowriteDisablerHook } from "./hook";

package/dist/hooks/todo-continuation-enforcer/abort-detection.d.ts

@@ -1,4 +0,0 @@
-import type { MessageInfo } from "./types";
-export declare function isLastAssistantMessageAborted(messages: Array<{
-    info?: MessageInfo;
-}>): boolean;

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

@@ -1,10 +0,0 @@
-export declare const HOOK_NAME = "todo-continuation-enforcer";
-export declare const DEFAULT_SKIP_AGENTS: string[];
-export declare const CONTINUATION_PROMPT: string;
-export declare const COUNTDOWN_SECONDS = 2;
-export declare const TOAST_DURATION_MS = 900;
-export declare const COUNTDOWN_GRACE_PERIOD_MS = 500;
-export declare const ABORT_WINDOW_MS = 3000;
-export declare const CONTINUATION_COOLDOWN_MS = 30000;
-export declare const MAX_CONSECUTIVE_FAILURES = 5;
-export declare const FAILURE_RESET_WINDOW_MS: number;

package/dist/hooks/todo-continuation-enforcer/continuation-injection.d.ts

@@ -1,12 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import type { BackgroundManager } from "../../features/background-agent";
-import type { SessionStateStore } from "./session-state";
-import type { ResolvedMessageInfo } from "./types";
-export declare function injectContinuation(args: {
-    ctx: PluginInput;
-    sessionID: string;
-    backgroundManager?: BackgroundManager;
-    skipAgents?: string[];
-    resolvedInfo?: ResolvedMessageInfo;
-    sessionStateStore: SessionStateStore;
-}): Promise<void>;