opencode-matrixx 1.0.2 → 1.1.0

package/dist/features/team-mode/types.d.ts

@@ -0,0 +1,210 @@
+import { z } from "zod";
+export declare const MESSAGE_KINDS: readonly ["message", "shutdown_request", "shutdown_approved", "shutdown_rejected", "announcement"];
+export declare const MEMBER_KINDS: readonly ["category", "subagent_type"];
+export declare const TASK_STATUSES: readonly ["pending", "claimed", "in_progress", "completed", "deleted"];
+export declare const RUNTIME_STATUSES: readonly ["creating", "active", "shutdown_requested", "deleting", "deleted", "failed", "orphaned"];
+export declare const CategoryMemberSchema: z.ZodObject<{
+    name: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    worktreePath: z.ZodOptional<z.ZodString>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    backendType: z.ZodDefault<z.ZodEnum<{
+        tmux: "tmux";
+        "in-process": "in-process";
+    }>>;
+    color: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    kind: z.ZodLiteral<"category">;
+    category: z.ZodString;
+    prompt: z.ZodString;
+}, z.core.$strict>;
+export declare const SubagentMemberSchema: z.ZodObject<{
+    name: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    worktreePath: z.ZodOptional<z.ZodString>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    backendType: z.ZodDefault<z.ZodEnum<{
+        tmux: "tmux";
+        "in-process": "in-process";
+    }>>;
+    color: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    kind: z.ZodLiteral<"subagent_type">;
+    subagent_type: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const MemberSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    name: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    worktreePath: z.ZodOptional<z.ZodString>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    backendType: z.ZodDefault<z.ZodEnum<{
+        tmux: "tmux";
+        "in-process": "in-process";
+    }>>;
+    color: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    kind: z.ZodLiteral<"category">;
+    category: z.ZodString;
+    prompt: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    name: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    worktreePath: z.ZodOptional<z.ZodString>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    backendType: z.ZodDefault<z.ZodEnum<{
+        tmux: "tmux";
+        "in-process": "in-process";
+    }>>;
+    color: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    kind: z.ZodLiteral<"subagent_type">;
+    subagent_type: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "kind">;
+export declare const TeamSpecSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    leadAgentId: z.ZodString;
+    teamAllowedPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sessionPermission: z.ZodOptional<z.ZodString>;
+    members: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        name: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        worktreePath: z.ZodOptional<z.ZodString>;
+        subscriptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        backendType: z.ZodDefault<z.ZodEnum<{
+            tmux: "tmux";
+            "in-process": "in-process";
+        }>>;
+        color: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        kind: z.ZodLiteral<"category">;
+        category: z.ZodString;
+        prompt: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        worktreePath: z.ZodOptional<z.ZodString>;
+        subscriptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        backendType: z.ZodDefault<z.ZodEnum<{
+            tmux: "tmux";
+            "in-process": "in-process";
+        }>>;
+        color: z.ZodOptional<z.ZodString>;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        kind: z.ZodLiteral<"subagent_type">;
+        subagent_type: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strip>;
+export declare const MessageSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    kind: z.ZodEnum<{
+        message: "message";
+        shutdown_request: "shutdown_request";
+        shutdown_approved: "shutdown_approved";
+        shutdown_rejected: "shutdown_rejected";
+        announcement: "announcement";
+    }>;
+    body: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    timestamp: z.ZodNumber;
+    correlationId: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TaskSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    subject: z.ZodString;
+    description: z.ZodString;
+    activeForm: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        pending: "pending";
+        in_progress: "in_progress";
+        completed: "completed";
+        deleted: "deleted";
+        claimed: "claimed";
+    }>;
+    owner: z.ZodOptional<z.ZodString>;
+    blocks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    blockedBy: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    claimedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const RuntimeStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    teamRunId: z.ZodString;
+    teamName: z.ZodString;
+    specSource: z.ZodEnum<{
+        user: "user";
+        project: "project";
+    }>;
+    createdAt: z.ZodNumber;
+    status: z.ZodEnum<{
+        deleted: "deleted";
+        active: "active";
+        failed: "failed";
+        creating: "creating";
+        shutdown_requested: "shutdown_requested";
+        deleting: "deleting";
+        orphaned: "orphaned";
+    }>;
+    leadSessionId: z.ZodOptional<z.ZodString>;
+    members: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        sessionId: z.ZodOptional<z.ZodString>;
+        tmuxPaneId: z.ZodOptional<z.ZodString>;
+        agentType: z.ZodEnum<{
+            leader: "leader";
+            "general-purpose": "general-purpose";
+        }>;
+        status: z.ZodEnum<{
+            pending: "pending";
+            completed: "completed";
+            running: "running";
+            idle: "idle";
+            shutdown_approved: "shutdown_approved";
+            errored: "errored";
+        }>;
+        color: z.ZodOptional<z.ZodString>;
+        worktreePath: z.ZodOptional<z.ZodString>;
+        lastInjectedTurnMarker: z.ZodOptional<z.ZodString>;
+        pendingInjectedMessageIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    shutdownRequests: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        memberId: z.ZodString;
+        requestedAt: z.ZodNumber;
+        approvedAt: z.ZodOptional<z.ZodNumber>;
+        rejectedReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    bounds: z.ZodObject<{
+        maxMembers: z.ZodDefault<z.ZodNumber>;
+        maxParallelMembers: z.ZodDefault<z.ZodNumber>;
+        maxMessagesPerRun: z.ZodDefault<z.ZodNumber>;
+        maxWallClockMinutes: z.ZodDefault<z.ZodNumber>;
+        maxMemberTurns: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export declare const AGENT_ELIGIBILITY_REGISTRY: Readonly<Record<string, {
+    verdict: "eligible" | "conditional" | "hard-reject";
+    rejectionMessage?: string;
+}>>;
+export type TeamSpec = z.infer<typeof TeamSpecSchema>;
+export type Member = z.infer<typeof MemberSchema>;
+export type CategoryMember = z.infer<typeof CategoryMemberSchema>;
+export type SubagentMember = z.infer<typeof SubagentMemberSchema>;
+export type Message = z.infer<typeof MessageSchema>;
+export type Task = z.infer<typeof TaskSchema>;
+export type RuntimeState = z.infer<typeof RuntimeStateSchema>;

package/dist/hooks/handoff-injector/constants.d.ts

@@ -1,4 +1,4 @@
 export declare const HANDOFF_FILENAME = "handoff.md";
 export declare const HANDOFF_CONSUMED_FILENAME = "handoff.consumed.md";
-export declare const HANDOFF_FILE_PATH = ".matrix/handoff.md";
-export declare const HANDOFF_CONSUMED_FILE_PATH = ".matrix/handoff.consumed.md";
+export declare const HANDOFF_FILE_PATH = ".matrixx/handoff.md";
+export declare const HANDOFF_CONSUMED_FILE_PATH = ".matrixx/handoff.consumed.md";

package/dist/hooks/hashline-edit-diff-enhancer/hook.d.ts

@@ -0,0 +1,28 @@
+interface HashlineEditDiffEnhancerConfig {
+    hashline_edit?: {
+        enabled: boolean;
+    };
+}
+type BeforeInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type BeforeOutput = {
+    args: Record<string, unknown>;
+};
+type AfterInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type AfterOutput = {
+    title: string;
+    output: string;
+    metadata: Record<string, unknown>;
+};
+export declare function createHashlineEditDiffEnhancerHook(config: HashlineEditDiffEnhancerConfig): {
+    "tool.execute.before": (input: BeforeInput, output: BeforeOutput) => Promise<void>;
+    "tool.execute.after": (input: AfterInput, output: AfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/hashline-edit-diff-enhancer/index.d.ts

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

package/dist/hooks/index.d.ts

@@ -45,3 +45,9 @@ export { createSecretLeakGuardHook } from "./secret-leak-guard";
 export { createEnvFileWriteGuardHook } from "./env-file-write-guard";
 export { createJsonErrorRecoveryHook } from "./json-error-recovery";
 export { createBashFileReadGuardHook } from "./bash-file-read-guard";
+export { createTodoDescriptionOverrideHook } from "./todo-description-override";
+export { createReadImageResizerHook } from "./read-image-resizer";
+export { createRuntimeFallbackHook, type RuntimeFallbackHook, type RuntimeFallbackOptions, SessionCategoryRegistry } from "./runtime-fallback";
+export { createWebFetchRedirectGuardHook } from "./webfetch-redirect-guard";
+export { createHashlineEditDiffEnhancerHook } from "./hashline-edit-diff-enhancer";
+export { createToolPairValidatorHook } from "./tool-pair-validator";

package/dist/hooks/keyword-detector/ultrawork/planner.d.ts

@@ -2,5 +2,5 @@
  * Ultrawork message section for planner agents (Oracle).
  * Planner agents should NOT be told to call plan agent - they ARE the planner.
  */
-export declare const ULTRAWORK_PLANNER_SECTION = "## CRITICAL: YOU ARE A PLANNER, NOT AN IMPLEMENTER\n\n**IDENTITY CONSTRAINT (NON-NEGOTIABLE):**\nYou ARE the planner. You ARE NOT an implementer. You DO NOT write code. You DO NOT execute tasks.\n\n**TOOL RESTRICTIONS (SYSTEM-ENFORCED):**\n| Tool | Allowed | Blocked |\n|------|---------|---------|\n| Write/Edit | `.matrix/**/*.md` ONLY | Everything else |\n| Read | All files | - |\n| Bash | Research commands only | Implementation commands |\n| task | explore, librarian | - |\n\n**IF YOU TRY TO WRITE/EDIT OUTSIDE `.matrix/`:**\n- System will BLOCK your action\n- You will receive an error\n- DO NOT retry - you are not supposed to implement\n\n**YOUR ONLY WRITABLE PATHS:**\n- `.matrix/plans/*.md` - Final work plans\n- `.matrix/drafts/*.md` - Working drafts during interview\n\n**WHEN USER ASKS YOU TO IMPLEMENT:**\nREFUSE. Say: \"I'm a planner. I create work plans, not implementations. Run `/start-work` after I finish planning.\"\n\n---\n\n## CONTEXT GATHERING (MANDATORY BEFORE PLANNING)\n\nYou ARE the planner. Your job: create bulletproof work plans.\n**Before drafting ANY plan, gather context via explore/librarian agents.**\n\n### Research Protocol\n1. **Fire parallel background agents** for comprehensive context:\n   ```\n   task(subagent_type=\"trinity\", load_skills=[], prompt=\"Find existing patterns for [topic] in codebase\", run_in_background=true)\n   task(subagent_type=\"trinity\", load_skills=[], prompt=\"Find test infrastructure and conventions\", run_in_background=true)\n   task(subagent_type=\"operator\", load_skills=[], prompt=\"Find official docs and best practices for [technology]\", run_in_background=true)\n   ```\n2. **Wait for results** before planning - rushed plans fail\n3. **Synthesize findings** into informed requirements\n\n### What to Research\n- Existing codebase patterns and conventions\n- Test infrastructure (TDD possible?)\n- External library APIs and constraints\n- Similar implementations in OSS (via librarian)\n\n**NEVER plan blind. Context first, plan second.**\n\n---\n\n## MANDATORY OUTPUT: PARALLEL TASK GRAPH + TODO LIST\n\n**YOUR PRIMARY OUTPUT IS A PARALLEL EXECUTION TASK GRAPH.**\n\nWhen you finalize a plan, you MUST structure it for maximum parallel execution:\n\n### 1. Parallel Execution Waves (REQUIRED)\n\nAnalyze task dependencies and group independent tasks into parallel waves:\n\n```\nWave 1 (Start Immediately - No Dependencies):\n\u251C\u2500\u2500 Task 1: [description] \u2192 category: X, skills: [a, b]\n\u2514\u2500\u2500 Task 4: [description] \u2192 category: Y, skills: [c]\n\nWave 2 (After Wave 1 Completes):\n\u251C\u2500\u2500 Task 2: [depends: 1] \u2192 category: X, skills: [a]\n\u251C\u2500\u2500 Task 3: [depends: 1] \u2192 category: Z, skills: [d]\n\u2514\u2500\u2500 Task 5: [depends: 4] \u2192 category: Y, skills: [c]\n\nWave 3 (After Wave 2 Completes):\n\u2514\u2500\u2500 Task 6: [depends: 2, 3] \u2192 category: X, skills: [a, b]\n\nCritical Path: Task 1 \u2192 Task 2 \u2192 Task 6\nEstimated Parallel Speedup: ~40% faster than sequential\n```\n\n### 2. Dependency Matrix (REQUIRED)\n\n| Task | Depends On | Blocks | Can Parallelize With |\n|------|------------|--------|---------------------|\n| 1 | None | 2, 3 | 4 |\n| 2 | 1 | 6 | 3, 5 |\n| 3 | 1 | 6 | 2, 5 |\n| 4 | None | 5 | 1 |\n| 5 | 4 | None | 2, 3 |\n| 6 | 2, 3 | None | None (final) |\n\n### 3. TODO List Structure (REQUIRED)\n\nEach TODO item MUST include:\n\n```markdown\n- [ ] N. [Task Title]\n\n  **What to do**: [Clear steps]\n  \n  **Dependencies**: [Task numbers this depends on] | None\n  **Blocks**: [Task numbers that depend on this]\n  **Parallel Group**: Wave N (with Tasks X, Y)\n  \n  **Recommended Agent Profile**:\n  - **Category**: `[construct | source | matrix-bend | quick | blue-pill | red-pill | writing]`\n  - **Skills**: [`skill-1`, `skill-2`]\n  \n  **Acceptance Criteria**: [Verifiable conditions]\n```\n\n### 4. Agent Dispatch Summary (REQUIRED)\n\n| Wave | Tasks | Dispatch Command |\n|------|-------|------------------|\n| 1 | 1, 4 | `task(category=\"...\", load_skills=[...], run_in_background=false)` \u00D7 2 |\n| 2 | 2, 3, 5 | `task(...)` \u00D7 3 after Wave 1 completes |\n| 3 | 6 | `task(...)` final integration |\n\n**WHY PARALLEL TASK GRAPH IS MANDATORY:**\n- Orchestrator (Morpheus) executes tasks in parallel waves\n- Independent tasks run simultaneously via background agents\n- Proper dependency tracking prevents race conditions\n- Category + skills ensure optimal model routing per task";
+export declare const ULTRAWORK_PLANNER_SECTION = "## CRITICAL: YOU ARE A PLANNER, NOT AN IMPLEMENTER\n\n**IDENTITY CONSTRAINT (NON-NEGOTIABLE):**\nYou ARE the planner. You ARE NOT an implementer. You DO NOT write code. You DO NOT execute tasks.\n\n**TOOL RESTRICTIONS (SYSTEM-ENFORCED):**\n| Tool | Allowed | Blocked |\n|------|---------|---------|\n| Write/Edit | `.matrixx/**/*.md` ONLY | Everything else |\n| Read | All files | - |\n| Bash | Research commands only | Implementation commands |\n| task | explore, librarian | - |\n\n**IF YOU TRY TO WRITE/EDIT OUTSIDE `.matrixx/`:**\n- System will BLOCK your action\n- You will receive an error\n- DO NOT retry - you are not supposed to implement\n\n**YOUR ONLY WRITABLE PATHS:**\n- `.matrixx/plans/*.md` - Final work plans\n- `.matrixx/drafts/*.md` - Working drafts during interview\n\n**WHEN USER ASKS YOU TO IMPLEMENT:**\nREFUSE. Say: \"I'm a planner. I create work plans, not implementations. Run `/start-work` after I finish planning.\"\n\n---\n\n## CONTEXT GATHERING (MANDATORY BEFORE PLANNING)\n\nYou ARE the planner. Your job: create bulletproof work plans.\n**Before drafting ANY plan, gather context via explore/librarian agents.**\n\n### Research Protocol\n1. **Fire parallel background agents** for comprehensive context:\n   ```\n   task(subagent_type=\"trinity\", load_skills=[], prompt=\"Find existing patterns for [topic] in codebase\", run_in_background=true)\n   task(subagent_type=\"trinity\", load_skills=[], prompt=\"Find test infrastructure and conventions\", run_in_background=true)\n   task(subagent_type=\"operator\", load_skills=[], prompt=\"Find official docs and best practices for [technology]\", run_in_background=true)\n   ```\n2. **Wait for results** before planning - rushed plans fail\n3. **Synthesize findings** into informed requirements\n\n### What to Research\n- Existing codebase patterns and conventions\n- Test infrastructure (TDD possible?)\n- External library APIs and constraints\n- Similar implementations in OSS (via librarian)\n\n**NEVER plan blind. Context first, plan second.**\n\n---\n\n## MANDATORY OUTPUT: PARALLEL TASK GRAPH + TODO LIST\n\n**YOUR PRIMARY OUTPUT IS A PARALLEL EXECUTION TASK GRAPH.**\n\nWhen you finalize a plan, you MUST structure it for maximum parallel execution:\n\n### 1. Parallel Execution Waves (REQUIRED)\n\nAnalyze task dependencies and group independent tasks into parallel waves:\n\n```\nWave 1 (Start Immediately - No Dependencies):\n\u251C\u2500\u2500 Task 1: [description] \u2192 category: X, skills: [a, b]\n\u2514\u2500\u2500 Task 4: [description] \u2192 category: Y, skills: [c]\n\nWave 2 (After Wave 1 Completes):\n\u251C\u2500\u2500 Task 2: [depends: 1] \u2192 category: X, skills: [a]\n\u251C\u2500\u2500 Task 3: [depends: 1] \u2192 category: Z, skills: [d]\n\u2514\u2500\u2500 Task 5: [depends: 4] \u2192 category: Y, skills: [c]\n\nWave 3 (After Wave 2 Completes):\n\u2514\u2500\u2500 Task 6: [depends: 2, 3] \u2192 category: X, skills: [a, b]\n\nCritical Path: Task 1 \u2192 Task 2 \u2192 Task 6\nEstimated Parallel Speedup: ~40% faster than sequential\n```\n\n### 2. Dependency Matrix (REQUIRED)\n\n| Task | Depends On | Blocks | Can Parallelize With |\n|------|------------|--------|---------------------|\n| 1 | None | 2, 3 | 4 |\n| 2 | 1 | 6 | 3, 5 |\n| 3 | 1 | 6 | 2, 5 |\n| 4 | None | 5 | 1 |\n| 5 | 4 | None | 2, 3 |\n| 6 | 2, 3 | None | None (final) |\n\n### 3. TODO List Structure (REQUIRED)\n\nEach TODO item MUST include:\n\n```markdown\n- [ ] N. [Task Title]\n\n  **What to do**: [Clear steps]\n  \n  **Dependencies**: [Task numbers this depends on] | None\n  **Blocks**: [Task numbers that depend on this]\n  **Parallel Group**: Wave N (with Tasks X, Y)\n  \n  **Recommended Agent Profile**:\n  - **Category**: `[construct | source | matrix-bend | quick | blue-pill | red-pill | writing]`\n  - **Skills**: [`skill-1`, `skill-2`]\n  \n  **Acceptance Criteria**: [Verifiable conditions]\n```\n\n### 4. Agent Dispatch Summary (REQUIRED)\n\n| Wave | Tasks | Dispatch Command |\n|------|-------|------------------|\n| 1 | 1, 4 | `task(category=\"...\", load_skills=[...], run_in_background=false)` \u00D7 2 |\n| 2 | 2, 3, 5 | `task(...)` \u00D7 3 after Wave 1 completes |\n| 3 | 6 | `task(...)` final integration |\n\n**WHY PARALLEL TASK GRAPH IS MANDATORY:**\n- Orchestrator (Morpheus) executes tasks in parallel waves\n- Independent tasks run simultaneously via background agents\n- Proper dependency tracking prevents race conditions\n- Category + skills ensure optimal model routing per task";
 export declare function getPlannerUltraworkMessage(): string;

package/dist/hooks/matrix-loop/constants.d.ts

@@ -1,5 +1,5 @@
 export declare const HOOK_NAME = "matrix-loop";
-export declare const DEFAULT_STATE_FILE = ".matrix/matrix-loop.local.md";
+export declare const DEFAULT_STATE_FILE = ".matrixx/matrix-loop.local.md";
 export declare const COMPLETION_TAG_PATTERN: RegExp;
 export declare const DEFAULT_MAX_ITERATIONS = 100;
 export declare const DEFAULT_COMPLETION_PROMISE = "DONE";

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

@@ -1,2 +1,2 @@
 export declare const HOOK_NAME = "sisyphus-junior-notepad";
-export declare const NOTEPAD_DIRECTIVE = "\n<Work_Context>\n## Notepad Location (for recording learnings)\nNOTEPAD PATH: .matrix/notepads/{plan-name}/\n- learnings.md: Record patterns, conventions, successful approaches\n- issues.md: Record problems, blockers, gotchas encountered\n- decisions.md: Record architectural choices and rationales\n- problems.md: Record unresolved issues, technical debt\n\nYou SHOULD append findings to notepad files after completing work.\nIMPORTANT: Always APPEND to notepad files - never overwrite or use Edit tool.\n\n## Plan Location (READ ONLY)\nPLAN PATH: .matrix/plans/{plan-name}.md\n\nCRITICAL RULE: NEVER MODIFY THE PLAN FILE\n\nThe plan file (.matrix/plans/*.md) is SACRED and READ-ONLY.\n- You may READ the plan to understand tasks\n- You may READ checkbox items to know what to do\n- You MUST NOT edit, modify, or update the plan file\n- You MUST NOT mark checkboxes as complete in the plan\n- Only the Orchestrator manages the plan file\n\nVIOLATION = IMMEDIATE FAILURE. The Orchestrator tracks plan state.\n</Work_Context>\n";
+export declare const NOTEPAD_DIRECTIVE = "\n<Work_Context>\n## Notepad Location (for recording learnings)\nNOTEPAD PATH: .matrixx/notepads/{plan-name}/\n- learnings.md: Record patterns, conventions, successful approaches\n- issues.md: Record problems, blockers, gotchas encountered\n- decisions.md: Record architectural choices and rationales\n- problems.md: Record unresolved issues, technical debt\n\nYou SHOULD append findings to notepad files after completing work.\nIMPORTANT: Always APPEND to notepad files - never overwrite or use Edit tool.\n\n## Plan Location (READ ONLY)\nPLAN PATH: .matrixx/plans/{plan-name}.md\n\nCRITICAL RULE: NEVER MODIFY THE PLAN FILE\n\nThe plan file (.matrixx/plans/*.md) is SACRED and READ-ONLY.\n- You may READ the plan to understand tasks\n- You may READ checkbox items to know what to do\n- You MUST NOT edit, modify, or update the plan file\n- You MUST NOT mark checkboxes as complete in the plan\n- Only the Orchestrator manages the plan file\n\nVIOLATION = IMMEDIATE FAILURE. The Orchestrator tracks plan state.\n</Work_Context>\n";

package/dist/hooks/preemptive-compaction-degradation-monitor.d.ts

@@ -0,0 +1,55 @@
+import type { MatrixxConfig } from "../config";
+interface CompactionTargetState {
+    providerID: string;
+    modelID: string;
+}
+interface ClientLike {
+    session: {
+        summarize: (input: {
+            path: {
+                id: string;
+            };
+            body: {
+                providerID: string;
+                modelID: string;
+            };
+            query: {
+                directory: string;
+            };
+        }) => Promise<unknown>;
+        messages: (input: {
+            path: {
+                id: string;
+            };
+            query?: {
+                directory: string;
+            };
+        }) => Promise<unknown>;
+    };
+    tui: {
+        showToast: (input: {
+            body: {
+                title: string;
+                message: string;
+                variant: "warning";
+                duration: number;
+            };
+        }) => Promise<unknown>;
+    };
+}
+export interface AssistantCompactionMessageInfo {
+    sessionID: string;
+    id?: string;
+}
+export declare function createPostCompactionDegradationMonitor(args: {
+    client: ClientLike;
+    directory: string;
+    pluginConfig: MatrixxConfig;
+    tokenCache: Map<string, CompactionTargetState>;
+    compactionInProgress: Set<string>;
+}): {
+    clear: (sessionID: string) => void;
+    onSessionCompacted: (sessionID: string) => void;
+    onAssistantMessageUpdated: (info: AssistantCompactionMessageInfo) => Promise<void>;
+};
+export {};

package/dist/hooks/preemptive-compaction-no-text-tail.d.ts

@@ -0,0 +1,18 @@
+export declare function isStepOnlyNoTextParts(parts: unknown): boolean;
+export declare function resolveNoTextTailFromSession(args: {
+    client: {
+        session: {
+            messages: (input: {
+                path: {
+                    id: string;
+                };
+                query?: {
+                    directory: string;
+                };
+            }) => Promise<unknown>;
+        };
+    };
+    sessionID: string;
+    messageID?: string;
+    directory: string;
+}): Promise<boolean>;

package/dist/hooks/preemptive-compaction-trigger.d.ts

@@ -0,0 +1,13 @@
+import type { MatrixxConfig } from "../config";
+import { type ContextLimitModelCacheState } from "../shared/context-limit-resolver";
+import type { CachedCompactionState, PreemptiveCompactionContext } from "./preemptive-compaction-types";
+export declare function runPreemptiveCompactionIfNeeded(args: {
+    ctx: PreemptiveCompactionContext;
+    pluginConfig: MatrixxConfig;
+    modelCacheState?: ContextLimitModelCacheState;
+    sessionID: string;
+    tokenCache: Map<string, CachedCompactionState>;
+    compactionInProgress: Set<string>;
+    compactedSessions: Set<string>;
+    lastCompactionTime: Map<string, number>;
+}): Promise<void>;

package/dist/hooks/preemptive-compaction-types.d.ts

@@ -0,0 +1,53 @@
+export interface TokenInfo {
+    input: number;
+    output: number;
+    reasoning: number;
+    cache: {
+        read: number;
+        write: number;
+    };
+}
+export interface CachedCompactionState {
+    providerID: string;
+    modelID: string;
+    tokens: TokenInfo;
+}
+export interface PreemptiveCompactionClient {
+    session: {
+        messages: (input: {
+            path: {
+                id: string;
+            };
+            query?: {
+                directory: string;
+            };
+        }) => Promise<unknown>;
+        summarize: (input: {
+            path: {
+                id: string;
+            };
+            body: {
+                providerID: string;
+                modelID: string;
+                auto?: boolean;
+            };
+            query: {
+                directory: string;
+            };
+        }) => Promise<unknown>;
+    };
+    tui: {
+        showToast: (input: {
+            body: {
+                title: string;
+                message: string;
+                variant: "warning";
+                duration: number;
+            };
+        }) => Promise<unknown>;
+    };
+}
+export interface PreemptiveCompactionContext {
+    client: PreemptiveCompactionClient;
+    directory: string;
+}

package/dist/hooks/preemptive-compaction.d.ts

@@ -1,16 +1,8 @@
-type PluginInput = {
-    client: {
-        session: {
-            messages: (...args: any[]) => any;
-            summarize: (...args: any[]) => any;
-        };
-        tui: {
-            showToast: (...args: any[]) => any;
-        };
-    };
-    directory: string;
-};
-export declare function createPreemptiveCompactionHook(ctx: PluginInput): {
+import type { MatrixxConfig } from "../config";
+import type { ContextLimitModelCacheState } from "../shared/context-limit-resolver";
+import type { PreemptiveCompactionContext } from "./preemptive-compaction-types";
+type PluginInput = PreemptiveCompactionContext;
+export declare function createPreemptiveCompactionHook(ctx: PluginInput, pluginConfig?: MatrixxConfig, modelCacheState?: ContextLimitModelCacheState): {
     "tool.execute.after": (input: {
         tool: string;
         sessionID: string;

package/dist/hooks/prometheus-md-only/constants.d.ts

@@ -1,7 +1,7 @@
 export declare const HOOK_NAME = "prometheus-md-only";
 export declare const ORACLE_AGENT = "oracle";
 export declare const ALLOWED_EXTENSIONS: string[];
-export declare const ALLOWED_PATH_PREFIX = ".matrix";
+export declare const ALLOWED_PATH_PREFIX = ".matrixx";
 export declare const BLOCKED_TOOLS: string[];
 export declare const PLANNING_CONSULT_WARNING: string;
 export declare const PROMETHEUS_WORKFLOW_REMINDER: string;

package/dist/hooks/prometheus-md-only/path-policy.d.ts

@@ -1,10 +1,10 @@
 /**
  * Cross-platform path validator for Oracle file writes.
  * Uses path.resolve/relative instead of string matching to handle:
- * - Windows backslashes (e.g., .matrix\\plans\\x.md)
- * - Mixed separators (e.g., .matrix\\plans/x.md)
+ * - Windows backslashes (e.g., .matrixx\\plans\\x.md)
+ * - Mixed separators (e.g., .matrixx\\plans/x.md)
  * - Case-insensitive directory/extension matching
  * - Workspace confinement (blocks paths outside root or via traversal)
- * - Nested project paths (e.g., parent/.matrix/... when ctx.directory is parent)
+ * - Nested project paths (e.g., parent/.matrixx/... when ctx.directory is parent)
  */
 export declare function isAllowedFile(filePath: string, workspaceRoot: string): boolean;

package/dist/hooks/read-image-resizer/hook.d.ts

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

package/dist/hooks/read-image-resizer/image-dimensions.d.ts

@@ -0,0 +1,2 @@
+import type { ImageDimensions } from "./types";
+export declare function parseImageDimensions(base64DataUrl: string, mimeType: string): ImageDimensions | null;

package/dist/hooks/read-image-resizer/image-resizer.d.ts

@@ -0,0 +1,5 @@
+import type { ImageDimensions, ResizeResult } from "./types";
+export declare function calculateTargetDimensions(width: number, height: number, maxLongEdge?: number): ImageDimensions | null;
+export declare function resizeImage(base64DataUrl: string, mimeType: string, target: ImageDimensions, deps?: {
+    loadSharpModule?: () => Promise<unknown | null>;
+}): Promise<ResizeResult | null>;

package/dist/hooks/read-image-resizer/index.d.ts

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

package/dist/hooks/read-image-resizer/png-fallback-resizer.d.ts

@@ -0,0 +1,2 @@
+import type { ImageDimensions, ResizeResult } from "./types";
+export declare function resizeImageFallback(base64DataUrl: string, mimeType: string, target: ImageDimensions): ResizeResult | null;

package/dist/hooks/read-image-resizer/types.d.ts

@@ -0,0 +1,14 @@
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+export interface ImageAttachment {
+    mime: string;
+    url: string;
+    filename?: string;
+}
+export interface ResizeResult {
+    resizedDataUrl: string;
+    original: ImageDimensions;
+    resized: ImageDimensions;
+}

package/dist/hooks/runtime-fallback/agent-resolver.d.ts

@@ -0,0 +1,6 @@
+export declare const AGENT_NAMES: string[];
+export declare const agentPattern: RegExp;
+export declare function detectAgentFromSession(sessionID: string): string | undefined;
+export declare function normalizeAgentName(agent: string | undefined): string | undefined;
+export declare function resolveAgentForSession(sessionID: string, eventAgent?: string): string | undefined;
+export declare function resolveRegisteredAgentName(agent: string | undefined): string | undefined;

package/dist/hooks/runtime-fallback/auto-retry-signal.d.ts

@@ -0,0 +1,4 @@
+export interface AutoRetrySignal {
+    signal: string;
+}
+export declare function extractAutoRetrySignal(info: Record<string, unknown> | undefined): AutoRetrySignal | undefined;

package/dist/hooks/runtime-fallback/auto-retry.d.ts

@@ -0,0 +1,10 @@
+import type { HookDeps } from "./types";
+export declare function createAutoRetryHelpers(deps: HookDeps): {
+    abortSessionRequest: (sessionID: string, source: string) => Promise<void>;
+    clearSessionFallbackTimeout: (sessionID: string) => void;
+    scheduleSessionFallbackTimeout: (sessionID: string, resolvedAgent?: string) => void;
+    autoRetryWithFallback: (sessionID: string, newModel: string, resolvedAgent: string | undefined, source: string) => Promise<void>;
+    resolveAgentForSessionFromContext: (sessionID: string, eventAgent?: string) => Promise<string | undefined>;
+    cleanupStaleSessions: () => void;
+};
+export type AutoRetryHelpers = ReturnType<typeof createAutoRetryHelpers>;

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

@@ -0,0 +1,20 @@
+import type { HookDeps } from "./types";
+export declare function createChatMessageHandler(deps: HookDeps): (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>;

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

@@ -0,0 +1,4 @@
+import type { RuntimeFallbackConfig } from "../../config";
+export declare const DEFAULT_CONFIG: Required<RuntimeFallbackConfig>;
+export declare const RETRYABLE_ERROR_PATTERNS: RegExp[];
+export declare const HOOK_NAME = "runtime-fallback";

package/dist/hooks/runtime-fallback/error-classifier.d.ts

@@ -0,0 +1,13 @@
+export { extractAutoRetrySignal } from "./auto-retry-signal";
+export declare function getErrorMessage(error: unknown): string;
+export declare function extractStatusCode(error: unknown, retryOnErrors?: number[]): number | undefined;
+export declare function extractErrorName(error: unknown): string | undefined;
+export declare function classifyErrorType(error: unknown): string | undefined;
+export declare function containsErrorContent(parts: Array<{
+    type?: string;
+    text?: string;
+}> | undefined): {
+    hasError: boolean;
+    errorMessage?: string;
+};
+export declare function isRetryableError(error: unknown, retryOnErrors: number[]): boolean;

package/dist/hooks/runtime-fallback/event-handler.d.ts

@@ -0,0 +1,8 @@
+import type { HookDeps } from "./types";
+import type { AutoRetryHelpers } from "./auto-retry";
+export declare function createEventHandler(deps: HookDeps, helpers: AutoRetryHelpers): ({ event }: {
+    event: {
+        type: string;
+        properties?: unknown;
+    };
+}) => Promise<void>;

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

@@ -0,0 +1,10 @@
+import type { MatrixxConfig } from "../../config";
+type ResolveFallbackBootstrapModelOptions = {
+    sessionID: string;
+    source: string;
+    eventModel?: string;
+    resolvedAgent?: string;
+    pluginConfig?: MatrixxConfig;
+};
+export declare function resolveFallbackBootstrapModel(options: ResolveFallbackBootstrapModelOptions): string | undefined;
+export {};

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

@@ -0,0 +1,2 @@
+import type { MatrixxConfig } from "../../config";
+export declare function getFallbackModelsForSession(sessionID: string, agent: string | undefined, pluginConfig: MatrixxConfig | undefined): string[];

package/dist/hooks/runtime-fallback/fallback-retry-dispatcher.d.ts

@@ -0,0 +1,11 @@
+import type { AutoRetryHelpers } from "./auto-retry";
+import type { HookDeps, FallbackState } from "./types";
+type DispatchFallbackRetryOptions = {
+    sessionID: string;
+    state: FallbackState;
+    fallbackModels: string[];
+    resolvedAgent?: string;
+    source: string;
+};
+export declare function dispatchFallbackRetry(deps: HookDeps, helpers: AutoRetryHelpers, options: DispatchFallbackRetryOptions): Promise<void>;
+export {};