opencode-matrixx 0.0.1

package/dist/hooks/json-error-recovery/hook.d.ts

@@ -0,0 +1,15 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare const JSON_ERROR_TOOL_EXCLUDE_LIST: readonly ["bash", "read", "glob", "grep", "webfetch", "look_at", "grep_app_searchgithub", "websearch_web_search_exa"];
+export declare const JSON_ERROR_PATTERNS: readonly RegExp[];
+export declare const JSON_ERROR_REMINDER = "\n[JSON PARSE ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou sent invalid JSON arguments to a tool. STOP and do this NOW:\n\n1. DO NOT retry with the same malformed JSON\n2. CORRECT the JSON syntax \u2014 check for: missing quotes, trailing commas, unmatched braces\n3. RETRY the tool call with valid JSON arguments\n\nThis usually means you garbled a string parameter or forgot to escape a character.\n";
+export declare function createJsonErrorRecoveryHook(_ctx: PluginInput): {
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+};

package/dist/hooks/json-error-recovery/index.d.ts

@@ -0,0 +1 @@
+export { createJsonErrorRecoveryHook, JSON_ERROR_TOOL_EXCLUDE_LIST, JSON_ERROR_PATTERNS, JSON_ERROR_REMINDER, } from "./hook";

package/dist/hooks/keyword-detector/analyze/default.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Analyze mode keyword detector.
+ *
+ * Triggers on analysis-related keywords across multiple languages:
+ * - English: analyze, analyse, investigate, examine, research, study, deep-dive, inspect, audit, evaluate, assess, review, diagnose, scrutinize, dissect, debug, comprehend, interpret, breakdown, understand, why is, how does, how to
+ * - Korean: 분석, 조사, 파악, 연구, 검토, 진단, 이해, 설명, 원인, 이유, 뜯어봐, 따져봐, 평가, 해석, 디버깅, 디버그, 어떻게, 왜, 살펴
+ * - Japanese: 分析, 調査, 解析, 検討, 研究, 診断, 理解, 説明, 検証, 精査, 究明, デバッグ, なぜ, どう, 仕組み
+ * - Chinese: 调查, 检查, 剖析, 深入, 诊断, 解释, 调试, 为什么, 原理, 搞清楚, 弄明白
+ * - Vietnamese: phân tích, điều tra, nghiên cứu, kiểm tra, xem xét, chẩn đoán, giải thích, tìm hiểu, gỡ lỗi, tại sao
+ */
+export declare const ANALYZE_PATTERN: RegExp;
+export declare const ANALYZE_MESSAGE = "[analyze-mode]\nANALYSIS MODE. Gather context before diving deep:\n\nCONTEXT GATHERING (parallel):\n- 1-2 explore agents (codebase patterns, implementations)\n- 1-2 librarian agents (if external library involved)\n- Direct tools: Grep, AST-grep, LSP for targeted searches\n\nIF COMPLEX - DO NOT STRUGGLE ALONE. Consult specialists:\n- **Oracle**: Conventional problems (architecture, debugging, complex logic)\n- **Artistry**: Non-conventional problems (different approach needed)\n\nSYNTHESIZE findings before proceeding.";

package/dist/hooks/keyword-detector/analyze/index.d.ts

@@ -0,0 +1 @@
+export { ANALYZE_PATTERN, ANALYZE_MESSAGE } from "./default";

package/dist/hooks/keyword-detector/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const CODE_BLOCK_PATTERN: RegExp;
+export declare const INLINE_CODE_PATTERN: RegExp;
+export { isPlannerAgent, getUltraworkMessage } from "./ultrawork";
+export { SEARCH_PATTERN, SEARCH_MESSAGE } from "./search";
+export { ANALYZE_PATTERN, ANALYZE_MESSAGE } from "./analyze";
+export type KeywordDetector = {
+    pattern: RegExp;
+    message: string | ((agentName?: string, modelID?: string) => string);
+};
+export declare const KEYWORD_DETECTORS: KeywordDetector[];

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

@@ -0,0 +1,11 @@
+export interface DetectedKeyword {
+    type: "ultrawork" | "search" | "analyze";
+    message: string;
+}
+export declare function removeCodeBlocks(text: string): string;
+export declare function detectKeywords(text: string, agentName?: string, modelID?: string): string[];
+export declare function detectKeywordsWithType(text: string, agentName?: string, modelID?: string): DetectedKeyword[];
+export declare function extractPromptText(parts: Array<{
+    type: string;
+    text?: string;
+}>): string;

package/dist/hooks/keyword-detector/hook.d.ts

@@ -0,0 +1,20 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { ContextCollector } from "../../features/context-injector";
+export declare function createKeywordDetectorHook(ctx: PluginInput, _collector?: ContextCollector): {
+    "chat.message": (input: {
+        sessionID: string;
+        agent?: string;
+        model?: {
+            providerID: string;
+            modelID: string;
+        };
+        messageID?: string;
+    }, output: {
+        message: Record<string, unknown>;
+        parts: Array<{
+            type: string;
+            text?: string;
+            [key: string]: unknown;
+        }>;
+    }) => Promise<void>;
+};

package/dist/hooks/keyword-detector/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./detector";
+export * from "./constants";
+export * from "./types";
+export { createKeywordDetectorHook } from "./hook";

package/dist/hooks/keyword-detector/search/default.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Search mode keyword detector.
+ *
+ * Triggers on search-related keywords across multiple languages:
+ * - English: search, find, locate, lookup, explore, discover, scan, grep, query, browse, detect, trace, seek, track, pinpoint, hunt, where is, show me, list all
+ * - Korean: 검색, 찾아, 탐색, 조회, 스캔, 서치, 뒤져, 찾기, 어디, 추적, 탐지, 찾아봐, 찾아내, 보여줘, 목록
+ * - Japanese: 検索, 探して, 見つけて, サーチ, 探索, スキャン, どこ, 発見, 捜索, 見つけ出す, 一覧
+ * - Chinese: 搜索, 查找, 寻找, 查询, 检索, 定位, 扫描, 发现, 在哪里, 找出来, 列出
+ * - Vietnamese: tìm kiếm, tra cứu, định vị, quét, phát hiện, truy tìm, tìm ra, ở đâu, liệt kê
+ */
+export declare const SEARCH_PATTERN: RegExp;
+export declare const SEARCH_MESSAGE = "[search-mode]\nMAXIMIZE SEARCH EFFORT. Launch multiple background agents IN PARALLEL:\n- explore agents (codebase patterns, file structures, ast-grep)\n- librarian agents (remote repos, official docs, GitHub examples)\nPlus direct tools: Grep, ripgrep (rg), ast-grep (sg)\nNEVER stop at first result - be exhaustive.";

package/dist/hooks/keyword-detector/search/index.d.ts

@@ -0,0 +1 @@
+export { SEARCH_PATTERN, SEARCH_MESSAGE } from "./default";

package/dist/hooks/keyword-detector/types.d.ts

@@ -0,0 +1,4 @@
+export interface KeywordDetectorState {
+    detected: boolean;
+    injected: boolean;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Default ultrawork message optimized for Claude series models.
+ *
+ * Key characteristics:
+ * - Natural tool-like usage of explore/librarian agents (run_in_background=true)
+ * - Parallel execution emphasized - fire agents and continue working
+ * - Simple workflow: EXPLORES → GATHER → PLAN → DELEGATE
+ */
+export declare const ULTRAWORK_DEFAULT_MESSAGE = "<ultrawork-mode>\n\n**MANDATORY**: You MUST say \"ULTRAWORK MODE ENABLED!\" to the user as your first response when this mode activates. This is non-negotiable.\n\n[CODE RED] Maximum precision required. Ultrathink before acting.\n\n## **ABSOLUTE CERTAINTY REQUIRED - DO NOT SKIP THIS**\n\n**YOU MUST NOT START ANY IMPLEMENTATION UNTIL YOU ARE 100% CERTAIN.**\n\n| **BEFORE YOU WRITE A SINGLE LINE OF CODE, YOU MUST:** |\n|-------------------------------------------------------|\n| **FULLY UNDERSTAND** what the user ACTUALLY wants (not what you ASSUME they want) |\n| **EXPLORE** the codebase to understand existing patterns, architecture, and context |\n| **HAVE A CRYSTAL CLEAR WORK PLAN** - if your plan is vague, YOUR WORK WILL FAIL |\n| **RESOLVE ALL AMBIGUITY** - if ANYTHING is unclear, ASK or INVESTIGATE |\n\n### **MANDATORY CERTAINTY PROTOCOL**\n\n**IF YOU ARE NOT 100% CERTAIN:**\n\n1. **THINK DEEPLY** - What is the user's TRUE intent? What problem are they REALLY trying to solve?\n2. **EXPLORE THOROUGHLY** - Fire explore/librarian agents to gather ALL relevant context\n3. **CONSULT SPECIALISTS** - For hard/complex tasks, DO NOT struggle alone. Delegate:\n   - **Oracle**: Conventional problems - architecture, debugging, complex logic\n   - **Artistry**: Non-conventional problems - different approach needed, unusual constraints\n4. **ASK THE USER** - If ambiguity remains after exploration, ASK. Don't guess.\n\n**SIGNS YOU ARE NOT READY TO IMPLEMENT:**\n- You're making assumptions about requirements\n- You're unsure which files to modify\n- You don't understand how existing code works\n- Your plan has \"probably\" or \"maybe\" in it\n- You can't explain the exact steps you'll take\n\n**WHEN IN DOUBT:**\n```\ntask(subagent_type=\"trinity\", load_skills=[], prompt=\"I'm implementing [TASK DESCRIPTION] and need to understand [SPECIFIC KNOWLEDGE GAP]. Find [X] patterns in the codebase \u2014 show file paths, implementation approach, and conventions used. I'll use this to [HOW RESULTS WILL BE USED]. Focus on src/ directories, skip test files unless test patterns are specifically needed. Return concrete file paths with brief descriptions of what each file does.\", run_in_background=true)\ntask(subagent_type=\"operator\", load_skills=[], prompt=\"I'm working with [LIBRARY/TECHNOLOGY] and need [SPECIFIC INFORMATION]. Find official documentation and production-quality examples for [Y] \u2014 specifically: API reference, configuration options, recommended patterns, and common pitfalls. Skip beginner tutorials. I'll use this to [DECISION THIS WILL INFORM].\", run_in_background=true)\ntask(subagent_type=\"oracle\", load_skills=[], prompt=\"I need architectural review of my approach to [TASK]. Here's my plan: [DESCRIBE PLAN WITH SPECIFIC FILES AND CHANGES]. My concerns are: [LIST SPECIFIC UNCERTAINTIES]. Please evaluate: correctness of approach, potential issues I'm missing, and whether a better alternative exists.\", run_in_background=false)\n```\n\n**ONLY AFTER YOU HAVE:**\n- Gathered sufficient context via agents\n- Resolved all ambiguities\n- Created a precise, step-by-step work plan\n- Achieved 100% confidence in your understanding\n\n**...THEN AND ONLY THEN MAY YOU BEGIN IMPLEMENTATION.**\n\n---\n\n## **NO EXCUSES. NO COMPROMISES. DELIVER WHAT WAS ASKED.**\n\n**THE USER'S ORIGINAL REQUEST IS SACRED. YOU MUST FULFILL IT EXACTLY.**\n\n| VIOLATION | CONSEQUENCE |\n|-----------|-------------|\n| \"I couldn't because...\" | **UNACCEPTABLE.** Find a way or ask for help. |\n| \"This is a simplified version...\" | **UNACCEPTABLE.** Deliver the FULL implementation. |\n| \"You can extend this later...\" | **UNACCEPTABLE.** Finish it NOW. |\n| \"Due to limitations...\" | **UNACCEPTABLE.** Use agents, tools, whatever it takes. |\n| \"I made some assumptions...\" | **UNACCEPTABLE.** You should have asked FIRST. |\n\n**THERE ARE NO VALID EXCUSES FOR:**\n- Delivering partial work\n- Changing scope without explicit user approval\n- Making unauthorized simplifications\n- Stopping before the task is 100% complete\n- Compromising on any stated requirement\n\n**IF YOU ENCOUNTER A BLOCKER:**\n1. **DO NOT** give up\n2. **DO NOT** deliver a compromised version\n3. **DO** consult specialists (oracle for conventional, matrix-bend for non-conventional)\n4. **DO** ask the user for guidance\n5. **DO** explore alternative approaches\n\n**THE USER ASKED FOR X. DELIVER EXACTLY X. PERIOD.**\n\n---\n\nYOU MUST LEVERAGE ALL AVAILABLE AGENTS / **CATEGORY + SKILLS** TO THEIR FULLEST POTENTIAL.\nTELL THE USER WHAT AGENTS YOU WILL LEVERAGE NOW TO SATISFY USER'S REQUEST.\n\n## MANDATORY: PLAN AGENT INVOCATION (NON-NEGOTIABLE)\n\n**YOU MUST ALWAYS INVOKE THE PLAN AGENT FOR ANY NON-TRIVIAL TASK.**\n\n| Condition | Action |\n|-----------|--------|\n| Task has 2+ steps | MUST call plan agent |\n| Task scope unclear | MUST call plan agent |\n| Implementation required | MUST call plan agent |\n| Architecture decision needed | MUST call plan agent |\n\n```\ntask(subagent_type=\"plan\", load_skills=[], prompt=\"<gathered context + user request>\")\n```\n\n**WHY PLAN AGENT IS MANDATORY:**\n- Plan agent analyzes dependencies and parallel execution opportunities\n- Plan agent outputs a **parallel task graph** with waves and dependencies\n- Plan agent provides structured TODO list with category + skills per task\n- YOU are an orchestrator, NOT an implementer\n\n### SESSION CONTINUITY WITH PLAN AGENT (CRITICAL)\n\n**Plan agent returns a session_id. USE IT for follow-up interactions.**\n\n| Scenario | Action |\n|----------|--------|\n| Plan agent asks clarifying questions | `task(session_id=\"{returned_session_id}\", load_skills=[], prompt=\"<your answer>\")` |\n| Need to refine the plan | `task(session_id=\"{returned_session_id}\", load_skills=[], prompt=\"Please adjust: <feedback>\")` |\n| Plan needs more detail | `task(session_id=\"{returned_session_id}\", load_skills=[], prompt=\"Add more detail to Task N\")` |\n\n**WHY SESSION_ID IS CRITICAL:**\n- Plan agent retains FULL conversation context\n- No repeated exploration or context gathering\n- Saves 70%+ tokens on follow-ups\n- Maintains interview continuity until plan is finalized\n\n```\n// WRONG: Starting fresh loses all context\ntask(subagent_type=\"plan\", load_skills=[], prompt=\"Here's more info...\")\n\n// CORRECT: Resume preserves everything\ntask(session_id=\"ses_abc123\", load_skills=[], prompt=\"Here's my answer to your question: ...\")\n```\n\n**FAILURE TO CALL PLAN AGENT = INCOMPLETE WORK.**\n\n---\n\n## AGENTS / **CATEGORY + SKILLS** UTILIZATION PRINCIPLES\n\n**DEFAULT BEHAVIOR: DELEGATE. DO NOT WORK YOURSELF.**\n\n| Task Type | Action | Why |\n|-----------|--------|-----|\n| Codebase exploration | task(subagent_type=\"trinity\", load_skills=[], run_in_background=true) | Parallel, context-efficient |\n| Documentation lookup | task(subagent_type=\"operator\", load_skills=[], run_in_background=true) | Specialized knowledge |\n| Planning | task(subagent_type=\"plan\", load_skills=[]) | Parallel task graph + structured TODO list |\n| Hard problem (conventional) | task(subagent_type=\"oracle\", load_skills=[]) | Architecture, debugging, complex logic |\n| Hard problem (non-conventional) | task(category=\"matrix-bend\", load_skills=[...]) | Different approach needed |\n| Implementation | task(category=\"...\", load_skills=[...]) | Domain-optimized models |\n\n**CATEGORY + SKILL DELEGATION:**\n```\n// Frontend work\ntask(category=\"construct\", load_skills=[\"frontend-ui-ux\"])\n\n// Complex logic\ntask(category=\"source\", load_skills=[\"typescript-programmer\"])\n\n// Quick fixes\ntask(category=\"bullet-time\", load_skills=[\"git-master\"])\n```\n\n**YOU SHOULD ONLY DO IT YOURSELF WHEN:**\n- Task is trivially simple (1-2 lines, obvious change)\n- You have ALL context already loaded\n- Delegation overhead exceeds task complexity\n\n**OTHERWISE: DELEGATE. ALWAYS.**\n\n---\n\n## MANDATORY: ACCEPTANCE CRITERIA DEFINITION (NON-NEGOTIABLE)\n\n**BEFORE writing ANY code, you MUST output an Acceptance Criteria block.**\n\nThis is NOT optional. Implementation without defined acceptance criteria = REJECTED.\n\n### Required Format:\n```\n## Acceptance Criteria\n1. [CRITERION]: [Observable, binary pass/fail condition]\n2. [CRITERION]: [Observable, binary pass/fail condition]\n...\n### Verification Commands:\n- [Exact command to run] \u2192 [Expected output]\n- [Exact command to run] \u2192 [Expected output]\n```\n\n### Rules:\n- Each criterion MUST be binary (PASS or FAIL \u2014 no \"mostly works\")\n- Each criterion MUST be verifiable via a specific command or observable behavior\n- Minimum 3 criteria for any non-trivial task\n- Criteria MUST cover: functional correctness, no regressions, code quality (typecheck/lint)\n- Include verification commands that will be executed during QA\n\n### Example:\n```\n## Acceptance Criteria\n1. User registration endpoint returns 201 on valid input\n2. Duplicate email returns 409 with error message\n3. All existing tests pass (bun test)\n4. TypeScript typecheck passes (bun run typecheck)\n5. No new lint errors introduced\n### Verification Commands:\n- bun test \u2192 All tests pass, 0 failures\n- bun run typecheck \u2192 Exit code 0, no errors\n- curl -X POST /api/register ... \u2192 201 Created\n```\n\n**FAILURE TO OUTPUT ACCEPTANCE CRITERIA = YOU MUST STOP AND DEFINE THEM.**\n\n---\n\n## EXECUTION RULES\n- **TODO**: Track EVERY step. Mark complete IMMEDIATELY after each.\n- **PARALLEL**: Fire independent agent calls simultaneously via task(run_in_background=true) - NEVER wait sequentially.\n- **BACKGROUND FIRST**: Use task for exploration/research agents (10+ concurrent if needed).\n- **VERIFY**: Re-read request after completion. Check ALL requirements met before reporting done.\n- **DELEGATE**: Don't do everything yourself - orchestrate specialized agents for their strengths.\n\n## WORKFLOW\n1. Analyze the request and identify required capabilities\n2. Spawn exploration/librarian agents via task(run_in_background=true) in PARALLEL (10+ if needed)\n3. Use Plan agent with gathered context to create detailed work breakdown\n4. Execute with continuous verification against original requirements\n\n---\n\n## MANDATORY: QA EXECUTION (NON-NEGOTIABLE)\n\n**AFTER implementation, you MUST execute ALL verification commands from your Acceptance Criteria.**\n\nThis is NOT optional. Claiming completion without QA execution = REJECTED.\n\n### QA Protocol:\n1. **Run every verification command** listed in your Acceptance Criteria\n2. **Report results** for each criterion: \u2705 PASS or \u274C FAIL\n3. **If ANY criterion fails**: Fix the issue, re-run ALL verification commands\n4. **Output a QA Report** in this exact format:\n\n```\n## QA Report\n| # | Criterion | Result | Evidence |\n|---|-----------|--------|----------|\n| 1 | [criterion] | \u2705 PASS | [what you observed] |\n| 2 | [criterion] | \u274C FAIL | [error output] |\n| 3 | [criterion] | \u2705 PASS | [what you observed] |\n\n**Overall: [X/Y PASS]** \u2014 [ACCEPTED if all pass / NEEDS FIX if any fail]\n```\n\n### Rules:\n- You MUST actually RUN the commands \u2014 not just say \"it should work\"\n- You MUST show evidence (command output, test results)\n- If ANY criterion fails, you MUST fix and re-run ALL criteria\n- You MUST NOT report completion until ALL criteria pass\n- If you cannot achieve a criterion, explain WHY and propose an alternative\n\n**NO EVIDENCE = NOT VERIFIED = NOT DONE.**\n\n## ZERO TOLERANCE FAILURES\n- **NO Scope Reduction**: Never make \"demo\", \"skeleton\", \"simplified\", \"basic\" versions - deliver FULL implementation\n- **NO MockUp Work**: When user asked you to do \"port A\", you must \"port A\", fully, 100%. No Extra feature, No reduced feature, no mock data, fully working 100% port.\n- **NO Partial Completion**: Never stop at 60-80% saying \"you can extend this...\" - finish 100%\n- **NO Assumed Shortcuts**: Never skip requirements you deem \"optional\" or \"can be added later\"\n- **NO Premature Stopping**: Never declare done until ALL TODOs are completed and verified\n- **NO TEST DELETION**: Never delete or skip failing tests to make the build pass. Fix the code, not the tests.\n\nTHE USER ASKED FOR X. DELIVER EXACTLY X. NOT A SUBSET. NOT A DEMO. NOT A STARTING POINT.\n\n1. EXPLORES + LIBRARIANS\n2. GATHER -> PLAN AGENT SPAWN\n3. WORK BY DELEGATING TO ANOTHER AGENTS\n\nNOW.\n\n</ultrawork-mode>\n\n---\n\n";
+export declare function getDefaultUltraworkMessage(): string;

package/dist/hooks/keyword-detector/ultrawork/gpt5.2.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ultrawork message optimized for GPT 5.2 series models.
+ *
+ * Key characteristics (from GPT 5.2 Prompting Guide):
+ * - "Stronger instruction adherence" - follows instructions more literally
+ * - "Conservative grounding bias" - prefers correctness over speed
+ * - "Parallelize independent reads to reduce latency" - official guidance
+ *
+ * Design principles:
+ * - Two-track parallel context gathering (Direct tools + Background agents)
+ * - Fire background agents, then use direct tools while waiting
+ * - Explicit complexity-based decision criteria
+ */
+export declare const ULTRAWORK_GPT_MESSAGE = "<ultrawork-mode>\n\n**MANDATORY**: You MUST say \"ULTRAWORK MODE ENABLED!\" to the user as your first response when this mode activates. This is non-negotiable.\n\n[CODE RED] Maximum precision required. Think deeply before acting.\n\n<output_verbosity_spec>\n- Default: 3-6 sentences or \u22645 bullets for typical answers\n- Simple yes/no questions: \u22642 sentences\n- Complex multi-file tasks: 1 short overview paragraph + \u22645 bullets (What, Where, Risks, Next, Open)\n- Avoid long narrative paragraphs; prefer compact bullets\n- Do not rephrase the user's request unless it changes semantics\n</output_verbosity_spec>\n\n<scope_constraints>\n- Implement EXACTLY and ONLY what the user requests\n- No extra features, no added components, no embellishments\n- If any instruction is ambiguous, choose the simplest valid interpretation\n- Do NOT expand the task beyond what was asked\n</scope_constraints>\n\n## CERTAINTY PROTOCOL\n\n**Before implementation, ensure you have:**\n- Full understanding of the user's actual intent\n- Explored the codebase to understand existing patterns\n- A clear work plan (mental or written)\n- Resolved any ambiguities through exploration (not questions)\n\n<uncertainty_handling>\n- If the question is ambiguous or underspecified:\n  - EXPLORE FIRST using tools (grep, file reads, explore agents)\n  - If still unclear, state your interpretation and proceed\n  - Ask clarifying questions ONLY as last resort\n- Never fabricate exact figures, line numbers, or references when uncertain\n- Prefer \"Based on the provided context...\" over absolute claims when unsure\n</uncertainty_handling>\n\n## DECISION FRAMEWORK: Self vs Delegate\n\n**Evaluate each task against these criteria to decide:**\n\n| Complexity | Criteria | Decision |\n|------------|----------|----------|\n| **Trivial** | <10 lines, single file, obvious pattern | **DO IT YOURSELF** |\n| **Moderate** | Single domain, clear pattern, <100 lines | **DO IT YOURSELF** (faster than delegation overhead) |\n| **Complex** | Multi-file, unfamiliar domain, >100 lines, needs specialized expertise | **DELEGATE** to appropriate category+skills |\n| **Research** | Need broad codebase context or external docs | **DELEGATE** to explore/librarian (background, parallel) |\n\n**Decision Factors:**\n- Delegation overhead \u2248 10-15 seconds. If task takes less, do it yourself.\n- If you already have full context loaded, do it yourself.\n- If task requires specialized expertise (frontend-ui-ux, git operations), delegate.\n- If you need information from multiple sources, fire parallel background agents.\n\n## AVAILABLE RESOURCES\n\nUse these when they provide clear value based on the decision framework above:\n\n| Resource | When to Use | How to Use |\n|----------|-------------|------------|\n| explore agent | Need codebase patterns you don't have | `task(subagent_type=\"trinity\", load_skills=[], run_in_background=true, ...)` |\n| librarian agent | External library docs, OSS examples | `task(subagent_type=\"operator\", load_skills=[], run_in_background=true, ...)` |\n| oracle agent | Stuck on architecture/debugging after 2+ attempts | `task(subagent_type=\"oracle\", load_skills=[], ...)` |\n| plan agent | Complex multi-step with dependencies (5+ steps) | `task(subagent_type=\"plan\", load_skills=[], ...)` |\n| task category | Specialized work matching a category | `task(category=\"...\", load_skills=[...])` |\n\n<tool_usage_rules>\n- Prefer tools over internal knowledge for fresh or user-specific data\n- Parallelize independent reads (read_file, grep, explore, librarian) to reduce latency\n- After any write/update, briefly restate: What changed, Where (path), Follow-up needed\n</tool_usage_rules>\n\n## EXECUTION PATTERN\n\n**Context gathering uses TWO parallel tracks:**\n\n| Track | Tools | Speed | Purpose |\n|-------|-------|-------|---------|\n| **Direct** | Grep, Read, LSP, AST-grep | Instant | Quick wins, known locations |\n| **Background** | explore, librarian agents | Async | Deep search, external docs |\n\n**ALWAYS run both tracks in parallel:**\n```\n// Fire background agents for deep exploration\ntask(subagent_type=\"trinity\", load_skills=[], prompt=\"I'm implementing [TASK] and need to understand [KNOWLEDGE GAP]. Find [X] patterns in the codebase \u2014 file paths, implementation approach, conventions used, and how modules connect. I'll use this to [DOWNSTREAM DECISION]. Focus on production code in src/. Return file paths with brief descriptions.\", run_in_background=true)\ntask(subagent_type=\"operator\", load_skills=[], prompt=\"I'm working with [TECHNOLOGY] and need [SPECIFIC INFO]. Find official docs and production examples for [Y] \u2014 API reference, configuration, recommended patterns, and pitfalls. Skip tutorials. I'll use this to [DECISION THIS INFORMS].\", run_in_background=true)\n\n// WHILE THEY RUN - use direct tools for immediate context\ngrep(pattern=\"relevant_pattern\", path=\"src/\")\nread_file(filePath=\"known/important/file.ts\")\n\n// Collect background results when ready\ndeep_context = background_output(task_id=...)\n\n// Merge ALL findings for comprehensive understanding\n```\n\n**Plan agent (complex tasks only):**\n- Only if 5+ interdependent steps\n- Invoke AFTER gathering context from both tracks\n\n**Execute:**\n- Surgical, minimal changes matching existing patterns\n- If delegating: provide exhaustive context and success criteria\n\n**Verify:**\n- `lsp_diagnostics` on modified files\n- Run tests if available\n\n## QUALITY STANDARDS\n\n| Phase | Action | Required Evidence |\n|-------|--------|-------------------|\n| Build | Run build command | Exit code 0 |\n| Test | Execute test suite | All tests pass |\n| Lint | Run lsp_diagnostics | Zero new errors |\n\n## MANDATORY: ACCEPTANCE CRITERIA DEFINITION (NON-NEGOTIABLE)\n\n**BEFORE writing ANY code, output an Acceptance Criteria block.**\n\n<acceptance_criteria_spec>\n- Implementation without defined acceptance criteria = REJECTED\n- Each criterion: binary PASS/FAIL, verifiable via command or observable behavior\n- Minimum 3 criteria for non-trivial tasks\n- Must cover: functional correctness, no regressions, code quality\n- Include exact verification commands to run during QA\n</acceptance_criteria_spec>\n\n**Required format:**\n```\n## Acceptance Criteria\n1. [CRITERION]: [Binary pass/fail condition]\n2. [CRITERION]: [Binary pass/fail condition]\n### Verification Commands:\n- [command] \u2192 [expected output]\n```\n\n## MANDATORY: QA EXECUTION (NON-NEGOTIABLE)\n\n**AFTER implementation, execute ALL verification commands from Acceptance Criteria.**\n\n<qa_protocol>\n- Run every verification command \u2014 do not assume \"it should work\"\n- Report each criterion: \u2705 PASS or \u274C FAIL with evidence\n- If ANY fails: fix, then re-run ALL commands\n- Do not report completion until ALL criteria pass\n</qa_protocol>\n\n**Required output:**\n```\n## QA Report\n| # | Criterion | Result | Evidence |\n|---|-----------|--------|----------|\n| 1 | [criterion] | \u2705 PASS | [observed] |\n\n**Overall: [X/Y PASS]** \u2014 [ACCEPTED/NEEDS FIX]\n```\n\n**NO EVIDENCE = NOT VERIFIED = NOT DONE.**\n\n## COMPLETION CRITERIA\n\nA task is complete when:\n1. Acceptance Criteria defined before implementation\n2. Requested functionality is fully implemented (not partial, not simplified)\n3. lsp_diagnostics shows zero errors on modified files\n4. Tests pass (or pre-existing failures documented)\n5. QA Report output with all criteria passing\n6. Code matches existing codebase patterns\n\n**Deliver exactly what was asked. No more, no less.**\n\n</ultrawork-mode>\n\n---\n\n";
+export declare function getGptUltraworkMessage(): string;

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

@@ -0,0 +1,17 @@
+/**
+ * Ultrawork message module - routes to appropriate message based on agent/model.
+ *
+ * Routing:
+ * 1. Planner agents (prometheus, plan) → planner.ts
+ * 2. GPT 5.2 models → gpt5.2.ts
+ * 3. Default (Claude, etc.) → default.ts (optimized for Claude series)
+ */
+export { isPlannerAgent, isGptModel, getUltraworkSource } from "./source-detector";
+export type { UltraworkSource } from "./source-detector";
+export { ULTRAWORK_PLANNER_SECTION, getPlannerUltraworkMessage } from "./planner";
+export { ULTRAWORK_GPT_MESSAGE, getGptUltraworkMessage } from "./gpt5.2";
+export { ULTRAWORK_DEFAULT_MESSAGE, getDefaultUltraworkMessage } from "./default";
+/**
+ * Gets the appropriate ultrawork message based on agent and model context.
+ */
+export declare function getUltraworkMessage(agentName?: string, modelID?: string): string;

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

@@ -0,0 +1,6 @@
+/**
+ * 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 function getPlannerUltraworkMessage(): string;

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

@@ -0,0 +1,21 @@
+/**
+ * Agent/model detection utilities for ultrawork message routing.
+ *
+ * Routing logic:
+ * 1. Planner agents (prometheus, plan) → planner.ts
+ * 2. GPT 5.2 models → gpt5.2.ts
+ * 3. Everything else (Claude, etc.) → default.ts
+ */
+import { isGptModel } from "../../../agents/types";
+/**
+ * Checks if agent is a planner-type agent.
+ * Planners don't need ultrawork injection (they ARE the planner).
+ */
+export declare function isPlannerAgent(agentName?: string): boolean;
+export { isGptModel };
+/** Ultrawork message source type */
+export type UltraworkSource = "planner" | "gpt" | "default";
+/**
+ * Determines which ultrawork message source to use.
+ */
+export declare function getUltraworkSource(agentName?: string, modelID?: string): UltraworkSource;

package/dist/hooks/matrix-loop/completion-promise-detector.d.ts

@@ -0,0 +1,8 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function detectCompletionInTranscript(transcriptPath: string | undefined, promise: string): boolean;
+export declare function detectCompletionInSessionMessages(ctx: PluginInput, options: {
+    sessionID: string;
+    promise: string;
+    apiTimeoutMs: number;
+    directory: string;
+}): Promise<boolean>;

package/dist/hooks/matrix-loop/completion-verifier.d.ts

@@ -0,0 +1,15 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export interface VerificationResult {
+    verified: boolean;
+    reason?: string;
+}
+export declare function verifyCompletion(ctx: PluginInput, options: {
+    sessionID: string;
+    directory: string;
+    completionPromise: string;
+    prompt: string;
+    iteration: number;
+    agent?: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}): Promise<VerificationResult>;

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

@@ -0,0 +1,8 @@
+export declare const HOOK_NAME = "matrix-loop";
+export declare const DEFAULT_STATE_FILE = ".matrix/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";
+export declare const DEFAULT_VERIFICATION_AGENT = "merovingian";
+export declare const DEFAULT_VERIFICATION_TIMEOUT_MS = 30000;
+export declare const DEFAULT_VERIFICATION_MAX_RETRIES = 2;

package/dist/hooks/matrix-loop/continuation-prompt-builder.d.ts

@@ -0,0 +1,2 @@
+import type { MatrixLoopState } from "./types";
+export declare function buildContinuationPrompt(state: MatrixLoopState): string;

package/dist/hooks/matrix-loop/continuation-prompt-injector.d.ts

@@ -0,0 +1,7 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function injectContinuationPrompt(ctx: PluginInput, options: {
+    sessionID: string;
+    prompt: string;
+    directory: string;
+    apiTimeoutMs: number;
+}): Promise<void>;

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

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./constants";
+export { readState, writeState, clearState, incrementIteration } from "./storage";
+export { createMatrixLoopHook } from "./matrix-loop-hook";
+export type { MatrixLoopHook } from "./matrix-loop-hook";

package/dist/hooks/matrix-loop/loop-session-recovery.d.ts

@@ -0,0 +1,7 @@
+export declare function createLoopSessionRecovery(options?: {
+    recoveryWindowMs?: number;
+}): {
+    isRecovering(sessionID: string): boolean;
+    markRecovering(sessionID: string): void;
+    clear(sessionID: string): void;
+};

package/dist/hooks/matrix-loop/loop-state-controller.d.ts

@@ -0,0 +1,16 @@
+import type { MatrixLoopOptions, MatrixLoopState } from "./types";
+export declare function createLoopStateController(options: {
+    directory: string;
+    stateDir: string | undefined;
+    config: MatrixLoopOptions["config"] | undefined;
+}): {
+    startLoop(sessionID: string, prompt: string, loopOptions?: {
+        maxIterations?: number;
+        completionPromise?: string;
+        ultrawork?: boolean;
+    }): boolean;
+    cancelLoop(sessionID: string): boolean;
+    getState(): MatrixLoopState | null;
+    clear(): boolean;
+    incrementIteration(): MatrixLoopState | null;
+};

package/dist/hooks/matrix-loop/matrix-loop-event-handler.d.ts

@@ -0,0 +1,28 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { MatrixLoopOptions, MatrixLoopState } from "./types";
+type SessionRecovery = {
+    isRecovering: (sessionID: string) => boolean;
+    markRecovering: (sessionID: string) => void;
+    clear: (sessionID: string) => void;
+};
+type LoopStateController = {
+    getState: () => MatrixLoopState | null;
+    clear: () => boolean;
+    incrementIteration: () => MatrixLoopState | null;
+};
+type MatrixLoopEventHandlerOptions = {
+    directory: string;
+    apiTimeoutMs: number;
+    getTranscriptPath: (sessionID: string) => string | undefined;
+    checkSessionExists?: MatrixLoopOptions["checkSessionExists"];
+    sessionRecovery: SessionRecovery;
+    loopState: LoopStateController;
+    verification?: MatrixLoopOptions["verification"];
+};
+export declare function createMatrixLoopEventHandler(ctx: PluginInput, options: MatrixLoopEventHandlerOptions): ({ event }: {
+    event: {
+        type: string;
+        properties?: unknown;
+    };
+}) => Promise<void>;
+export {};

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

@@ -0,0 +1,18 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { MatrixLoopOptions, MatrixLoopState } from "./types";
+export interface MatrixLoopHook {
+    event: (input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+    startLoop: (sessionID: string, prompt: string, options?: {
+        maxIterations?: number;
+        completionPromise?: string;
+        ultrawork?: boolean;
+    }) => boolean;
+    cancelLoop: (sessionID: string) => boolean;
+    getState: () => MatrixLoopState | null;
+}
+export declare function createMatrixLoopHook(ctx: PluginInput, options?: MatrixLoopOptions): MatrixLoopHook;

package/dist/hooks/matrix-loop/message-storage-directory.d.ts

@@ -0,0 +1 @@
+export { getMessageDir } from "../../shared/opencode-message-dir";

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

@@ -0,0 +1,6 @@
+import type { MatrixLoopState } from "./types";
+export declare function getStateFilePath(directory: string, customPath?: string): string;
+export declare function readState(directory: string, customPath?: string): MatrixLoopState | null;
+export declare function writeState(directory: string, state: MatrixLoopState, customPath?: string): boolean;
+export declare function clearState(directory: string, customPath?: string): boolean;
+export declare function incrementIteration(directory: string, customPath?: string): MatrixLoopState | null;

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

@@ -0,0 +1,25 @@
+import type { MatrixLoopConfig } from "../../config";
+export interface MatrixLoopState {
+    active: boolean;
+    iteration: number;
+    max_iterations: number;
+    completion_promise: string;
+    started_at: string;
+    prompt: string;
+    session_id?: string;
+    ultrawork?: boolean;
+    verification_in_progress?: boolean;
+    verification_failed_count?: number;
+}
+export interface MatrixLoopOptions {
+    config?: MatrixLoopConfig;
+    getTranscriptPath?: (sessionId: string) => string;
+    apiTimeout?: number;
+    checkSessionExists?: (sessionId: string) => Promise<boolean>;
+    verification?: {
+        enabled?: boolean;
+        agent?: string;
+        timeoutMs?: number;
+        maxRetries?: number;
+    };
+}

package/dist/hooks/matrix-loop/with-timeout.d.ts

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

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

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

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

@@ -0,0 +1,11 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createMouseNotepadHook(ctx: PluginInput): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+        message?: string;
+    }) => Promise<void>;
+};

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

@@ -0,0 +1,2 @@
+export * from "./constants";
+export { createMouseNotepadHook } from "./hook";

package/dist/hooks/non-interactive-env/constants.d.ts

@@ -0,0 +1,34 @@
+export declare const HOOK_NAME = "non-interactive-env";
+export declare const NON_INTERACTIVE_ENV: Record<string, string>;
+/**
+ * Shell command guidance for non-interactive environments.
+ * These patterns should be followed to avoid hanging on user input.
+ */
+export declare const SHELL_COMMAND_PATTERNS: {
+    readonly npm: {
+        readonly bad: readonly ["npm init", "npm install (prompts)"];
+        readonly good: readonly ["npm init -y", "npm install --yes"];
+    };
+    readonly apt: {
+        readonly bad: readonly ["apt-get install pkg"];
+        readonly good: readonly ["apt-get install -y pkg", "DEBIAN_FRONTEND=noninteractive apt-get install pkg"];
+    };
+    readonly pip: {
+        readonly bad: readonly ["pip install pkg (with prompts)"];
+        readonly good: readonly ["pip install --no-input pkg", "PIP_NO_INPUT=1 pip install pkg"];
+    };
+    readonly git: {
+        readonly bad: readonly ["git commit", "git merge branch", "git add -p", "git rebase -i"];
+        readonly good: readonly ["git commit -m 'msg'", "git merge --no-edit branch", "git add .", "git rebase --no-edit"];
+    };
+    readonly system: {
+        readonly bad: readonly ["rm file (prompts)", "cp a b (prompts)", "ssh host"];
+        readonly good: readonly ["rm -f file", "cp -f a b", "ssh -o BatchMode=yes host", "unzip -o file.zip"];
+    };
+    readonly banned: readonly ["vim", "nano", "vi", "emacs", "less", "more", "man", "python (REPL)", "node (REPL)", "git add -p", "git rebase -i"];
+    readonly workarounds: {
+        readonly yesPipe: "yes | ./script.sh";
+        readonly heredoc: "./script.sh <<EOF\noption1\noption2\nEOF";
+        readonly expectAlternative: "Use environment variables or config files instead of expect";
+    };
+};

package/dist/hooks/non-interactive-env/detector.d.ts

@@ -0,0 +1 @@
+export declare function isNonInteractive(): boolean;

package/dist/hooks/non-interactive-env/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./constants";
+export * from "./detector";
+export * from "./types";
+export { createNonInteractiveEnvHook } from "./non-interactive-env-hook";

package/dist/hooks/non-interactive-env/non-interactive-env-hook.d.ts

@@ -0,0 +1,14 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export * from "./constants";
+export * from "./detector";
+export * from "./types";
+export declare function createNonInteractiveEnvHook(_ctx: PluginInput): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+        message?: string;
+    }) => Promise<void>;
+};

package/dist/hooks/non-interactive-env/types.d.ts

@@ -0,0 +1,3 @@
+export interface NonInteractiveEnvConfig {
+    disabled?: boolean;
+}

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

@@ -0,0 +1,30 @@
+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): {
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, _output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+};
+export {};

package/dist/hooks/prometheus-md-only/agent-matcher.d.ts

@@ -0,0 +1 @@
+export declare function isOracleAgent(agentName: string | undefined): boolean;

package/dist/hooks/prometheus-md-only/agent-resolution.d.ts

@@ -0,0 +1,16 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+type OpencodeClient = PluginInput["client"];
+/**
+ * Get the effective agent for the session.
+ * Priority order:
+ * 1. In-memory session agent (most recent, set by /start-work)
+ * 2. Mission state agent (persisted across restarts, fixes #927)
+ * 3. Message files (fallback for sessions without mission state)
+ *
+ * This fixes issue #927 where after interruption:
+ * - In-memory map is cleared (process restart)
+ * - Message files return "oracle" (oldest message from /plan)
+ * - But mission.json has agent: "architect" (set by /start-work)
+ */
+export declare function getAgentFromSession(sessionID: string, directory: string, client?: OpencodeClient): Promise<string | undefined>;
+export {};

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

@@ -0,0 +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 BLOCKED_TOOLS: string[];
+export declare const PLANNING_CONSULT_WARNING: string;
+export declare const PROMETHEUS_WORKFLOW_REMINDER: string;

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

@@ -0,0 +1,11 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createOracleMdOnlyHook(ctx: PluginInput): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+        message?: string;
+    }) => Promise<void>;
+};

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

@@ -0,0 +1,2 @@
+export * from "./constants";
+export { createOracleMdOnlyHook } from "./hook";

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

@@ -0,0 +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)
+ * - 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)
+ */
+export declare function isAllowedFile(filePath: string, workspaceRoot: string): boolean;

package/dist/hooks/question-label-truncator/hook.d.ts

@@ -0,0 +1,7 @@
+export declare function createQuestionLabelTruncatorHook(): {
+    "tool.execute.before": (input: {
+        tool: string;
+    }, output: {
+        args: Record<string, unknown>;
+    }) => Promise<void>;
+};

package/dist/hooks/question-label-truncator/index.d.ts

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

package/dist/hooks/rules-injector/cache.d.ts

@@ -0,0 +1,8 @@
+export type SessionInjectedRulesCache = {
+    contentHashes: Set<string>;
+    realPaths: Set<string>;
+};
+export declare function createSessionCacheStore(): {
+    getSessionCache: (sessionID: string) => SessionInjectedRulesCache;
+    clearSessionCache: (sessionID: string) => void;
+};