opencode-matrixx 2.1.0 → 2.3.0

package/dist/features/mission-state/plan-storage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Plan Persistence Storage
+ *
+ * Atomic file operations for plan files.
+ * Reuses the write-temp-then-rename pattern from handoff/storage.ts.
+ */
+import type { PlanMeta } from "./types";
+/**
+ * Ensure the .matrixx/plans directory exists under the project root.
+ */
+export declare function ensurePlanDir(directory: string): boolean;
+/**
+ * Read a plan file's content.
+ * Returns null if the file does not exist, is too large, or cannot be read.
+ */
+export declare function readPlanFile(planPath: string): string | null;
+/**
+ * Atomic write: write to a .tmp.{pid} file, then rename over the target.
+ * Prevents partial/corrupt files on crash mid-write.
+ */
+export declare function atomicWrite(filePath: string, content: string): boolean;
+/**
+ * Write content to a plan file using atomic write.
+ * Ensures the plan directory exists first.
+ */
+export declare function writePlanFile(directory: string, planPath: string, content: string): boolean;
+/**
+ * Sync markdown checkbox status to match todos.
+ *
+ * For each `- [ ]` or `- [x]` line, finds the matching todo by content
+ * and marks it completed if the todo status is completed/cancelled.
+ * Lines without a matching todo keep their current state.
+ */
+export declare function syncCheckboxes(content: string, todos: Array<{
+    content: string;
+    status: string;
+}>): string;
+/**
+ * Append or replace the <!-- plan-persister: ... --> metadata comment.
+ *
+ * If a comment already exists at the end of the file, it is replaced in-place.
+ * Otherwise, the tag is appended after the last line.
+ */
+export declare function upsertMetadataComment(content: string, meta: PlanMeta): string;
+/**
+ * Extract PlanMeta from an HTML comment, or null if absent/malformed.
+ */
+export declare function parseMetadataComment(content: string): PlanMeta | null;

package/dist/features/mission-state/rehydrate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Plan Persistence Rehydration
+ *
+ * Builds rehydration context from mission state + plan file for injection
+ * after compaction or session start.
+ */
+import type { RehydrationContext } from "./types";
+/**
+ * Build a rehydration context from mission state + plan file.
+ *
+ * Returns null when:
+ * - No mission file exists
+ * - Mission has no active_plan
+ * - Plan file is missing
+ * - Plan is 100% complete (no point rehydrating a finished plan)
+ */
+export declare function buildRehydrationContext(directory: string): RehydrationContext | null;
+/**
+ * Find active plan path from mission state.
+ */
+export declare function findActivePlan(directory: string): string | null;

package/dist/features/mission-state/types.d.ts

@@ -24,3 +24,49 @@ export interface PlanProgress {
     /** Whether all tasks are done */
     isComplete: boolean;
 }
+/**
+ * Plan Persistence Types
+ * Machine-parseable metadata appended as HTML comment to plan files
+ */
+/** Machine-parseable metadata appended as HTML comment to plan files */
+export interface PlanMeta {
+    /** Plan file name without .md extension */
+    id: string;
+    /** ISO timestamp of last write */
+    updatedAt: string;
+    /** Session ID that triggered the last write */
+    sessionId: string;
+    /** Total todo count at time of write */
+    todoTotal: number;
+    /** Completed todo count at time of write */
+    todoCompleted: number;
+    /** Git HEAD at time of write (optional) */
+    gitHead?: {
+        sha: string;
+        branch?: string;
+    };
+}
+/** Events the plan-persister hook listens to */
+export type PlanPersistEvent = {
+    type: "session.idle";
+    sessionID: string;
+} | {
+    type: "session.compacted";
+    sessionID: string;
+};
+/** Return value of buildRehydrationContext */
+export interface RehydrationContext {
+    planName: string;
+    planPath: string;
+    content: string;
+    progress: {
+        total: number;
+        completed: number;
+    };
+    directive: string;
+}
+/** Options for the plan-persister hook */
+export interface PlanPersistenceOptions {
+    /** Project root directory */
+    directory: string;
+}

package/dist/features/opencode-skill-loader/loader.d.ts

@@ -1,7 +1,5 @@
-import type { CommandDefinition } from "../claude-code-command-loader/types";
+import type { CommandDefinition } from "../command-loader/types";
 import type { LoadedSkill } from "./types";
-export declare function loadUserSkills(): Promise<Record<string, CommandDefinition>>;
-export declare function loadProjectSkills(directory?: string): Promise<Record<string, CommandDefinition>>;
 export declare function loadOpencodeGlobalSkills(): Promise<Record<string, CommandDefinition>>;
 export declare function loadOpencodeProjectSkills(directory?: string): Promise<Record<string, CommandDefinition>>;
 interface DiscoverSkillsOptions {

package/dist/features/opencode-skill-loader/skill-definition-record.d.ts

@@ -1,3 +1,3 @@
-import type { CommandDefinition } from "../claude-code-command-loader/types";
+import type { CommandDefinition } from "../command-loader/types";
 import type { LoadedSkill } from "./types";
 export declare function skillsToCommandDefinitionRecord(skills: LoadedSkill[]): Record<string, CommandDefinition>;

package/dist/features/opencode-skill-loader/types.d.ts

@@ -1,4 +1,4 @@
-import type { CommandDefinition } from "../claude-code-command-loader/types";
+import type { CommandDefinition } from "../command-loader/types";
 import type { SkillMcpConfig } from "../skill-mcp-manager/types";
 export type SkillScope = "builtin" | "config" | "user" | "project" | "opencode" | "opencode-project";
 export interface SkillMetadata {

package/dist/features/skill-mcp-manager/connection-type.d.ts

@@ -1,7 +1,6 @@
-import type { ClaudeCodeMcpServer } from "../claude-code-mcp-loader/types";
-import type { ConnectionType } from "./types";
+import type { ConnectionType, McpServerDefinition } from "./types";
 /**
  * Determines connection type from MCP server configuration.
  * Priority: explicit type field > url presence > command presence
  */
-export declare function getConnectionType(config: ClaudeCodeMcpServer): ConnectionType | null;
+export declare function getConnectionType(config: McpServerDefinition): ConnectionType | null;

package/dist/features/skill-mcp-manager/connection.d.ts

@@ -1,15 +1,14 @@
 import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import type { ClaudeCodeMcpServer } from "../claude-code-mcp-loader/types";
-import type { SkillMcpClientInfo, SkillMcpManagerState } from "./types";
+import type { McpServerDefinition, SkillMcpClientInfo, SkillMcpManagerState } from "./types";
 export declare function getOrCreateClient(params: {
     state: SkillMcpManagerState;
     clientKey: string;
     info: SkillMcpClientInfo;
-    config: ClaudeCodeMcpServer;
+    config: McpServerDefinition;
 }): Promise<Client>;
 export declare function getOrCreateClientWithRetryImpl(params: {
     state: SkillMcpManagerState;
     clientKey: string;
     info: SkillMcpClientInfo;
-    config: ClaudeCodeMcpServer;
+    config: McpServerDefinition;
 }): Promise<Client>;

package/dist/features/skill-mcp-manager/manager.d.ts

@@ -1,11 +1,10 @@
 import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import type { Prompt, Resource, Tool } from "@modelcontextprotocol/sdk/types.js";
-import type { ClaudeCodeMcpServer } from "../claude-code-mcp-loader/types";
-import type { SkillMcpClientInfo, SkillMcpServerContext } from "./types";
+import type { McpServerDefinition, SkillMcpClientInfo, SkillMcpServerContext } from "./types";
 export declare class SkillMcpManager {
     private readonly state;
     private getClientKey;
-    getOrCreateClient(info: SkillMcpClientInfo, config: ClaudeCodeMcpServer): Promise<Client>;
+    getOrCreateClient(info: SkillMcpClientInfo, config: McpServerDefinition): Promise<Client>;
     disconnectSession(sessionID: string): Promise<void>;
     disconnectAll(): Promise<void>;
     listTools(info: SkillMcpClientInfo, context: SkillMcpServerContext): Promise<Tool[]>;

package/dist/features/skill-mcp-manager/oauth-handler.d.ts

@@ -1,8 +1,8 @@
-import type { ClaudeCodeMcpServer } from "../claude-code-mcp-loader/types";
 import { McpOAuthProvider } from "../mcp-oauth/provider";
-export declare function buildHttpRequestInit(config: ClaudeCodeMcpServer, authProviders: Map<string, McpOAuthProvider>): Promise<RequestInit | undefined>;
+import type { McpServerDefinition } from "./types";
+export declare function buildHttpRequestInit(config: McpServerDefinition, authProviders: Map<string, McpOAuthProvider>): Promise<RequestInit | undefined>;
 export declare function handleStepUpIfNeeded(params: {
     error: Error;
-    config: ClaudeCodeMcpServer;
+    config: McpServerDefinition;
     authProviders: Map<string, McpOAuthProvider>;
 }): Promise<boolean>;

package/dist/features/skill-mcp-manager/types.d.ts

@@ -1,16 +1,28 @@
 import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import type { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import type { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import type { ClaudeCodeMcpServer } from "../claude-code-mcp-loader/types";
 import type { McpOAuthProvider } from "../mcp-oauth/provider";
-export type SkillMcpConfig = Record<string, ClaudeCodeMcpServer>;
+export interface McpServerDefinition {
+    type?: "http" | "sse" | "stdio";
+    url?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+    oauth?: {
+        clientId?: string;
+        scopes?: string[];
+    };
+    disabled?: boolean;
+}
+export type SkillMcpConfig = Record<string, McpServerDefinition>;
 export interface SkillMcpClientInfo {
     serverName: string;
     skillName: string;
     sessionID: string;
 }
 export interface SkillMcpServerContext {
-    config: ClaudeCodeMcpServer;
+    config: McpServerDefinition;
     skillName: string;
 }
 /**
@@ -51,6 +63,6 @@ export interface SkillMcpClientConnectionParams {
     state: SkillMcpManagerState;
     clientKey: string;
     info: SkillMcpClientInfo;
-    config: ClaudeCodeMcpServer;
+    config: McpServerDefinition;
 }
 export {};

package/dist/features/tmux-subagent/index.d.ts

@@ -1,10 +1,8 @@
 export * from "./action-executor";
-export * from "./cleanup";
 export * from "./decision-engine";
 export * from "./event-handlers";
 export * from "./manager";
 export * from "./pane-state-querier";
-export * from "./polling";
 export * from "./polling-constants";
 export * from "./session-created-event";
 export * from "./session-created-handler";

package/dist/features/ultrawork-state/index.d.ts

@@ -0,0 +1 @@
+export { _resetUltraworkStateForTesting, clearUltraworkState, disableUltrawork, enableUltrawork, getUltraworkState, } from "./manager";

package/dist/features/ultrawork-state/manager.d.ts

@@ -0,0 +1,6 @@
+export declare function getUltraworkState(sessionID: string): "enabled" | "disabled" | undefined;
+export declare function enableUltrawork(sessionID: string): void;
+export declare function disableUltrawork(sessionID: string): void;
+export declare function clearUltraworkState(sessionID: string): void;
+/** @internal */
+export declare function _resetUltraworkStateForTesting(): void;

package/dist/hooks/auto-update-checker/cache.d.ts

@@ -1,3 +1 @@
 export declare function invalidatePackage(packageName?: string): boolean;
-/** @deprecated Use invalidatePackage instead - this nukes ALL plugins */
-export declare function invalidateCache(): boolean;

package/dist/hooks/auto-update-checker/index.d.ts

@@ -1,4 +1,4 @@
-export { invalidateCache, invalidatePackage } from "./cache";
+export { invalidatePackage } from "./cache";
 export { checkForUpdate } from "./checker";
 export { createAutoUpdateCheckerHook } from "./hook";
 export type { AutoUpdateCheckerOptions, UpdateCheckResult } from "./types";

package/dist/hooks/env-context-injector/index.d.ts

@@ -0,0 +1,23 @@
+import type { Message, Part } from "@opencode-ai/sdk";
+interface MessageWithParts {
+    info: Message;
+    parts: Part[];
+}
+type MessagesTransformHook = {
+    "experimental.chat.messages.transform"?: (input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+/**
+ * Env-Context Injector Transform Hook
+ *
+ * Appends the <matrixx-env> block (date, time, timezone, locale, year)
+ * to the last user message in each turn.
+ *
+ * This ensures the system prompt (agent config) is 100% static and
+ * byte-identical across all turns in a session, enabling provider-side
+ * prefix caching (Anthropic prompt caching, DeepSeek KV cache, OpenAI
+ * auto-cache).
+ */
+export declare function createEnvContextInjectorHook(): MessagesTransformHook;
+export {};

package/dist/hooks/index.d.ts

@@ -16,6 +16,7 @@ export { createDirectoryAgentsInjectorHook } from "./directory-agents-injector";
 export { createDirectoryReadmeInjectorHook } from "./directory-readme-injector";
 export { createEditErrorRecoveryHook } from "./edit-error-recovery";
 export { createEmptyTaskResponseDetectorHook } from "./empty-task-response-detector";
+export { createEnvContextInjectorHook } from "./env-context-injector";
 export { createEnvFileWriteGuardHook } from "./env-file-write-guard";
 export { createHashlineEditDiffEnhancerHook } from "./hashline-edit-diff-enhancer";
 export { createHashlineReadEnhancerHook } from "./hashline-read-enhancer";
@@ -25,6 +26,7 @@ export { createKeywordDetectorHook } from "./keyword-detector";
 export { createMatrixLoopHook, type MatrixLoopHook } from "./matrix-loop";
 export { createMouseNotepadHook } from "./mouse-notepad";
 export { createNonInteractiveEnvHook } from "./non-interactive-env";
+export { createPlanPersister } from "./plan-persister";
 export { createPreemptiveCompactionHook } from "./preemptive-compaction";
 export { createOracleMdOnlyHook } from "./prometheus-md-only";
 export { createQualityGateHook } from "./quality-gate/hook";

package/dist/hooks/interactive-bash-session/parser.d.ts

@@ -3,12 +3,6 @@
  * Handles single/double quotes and backslash escapes
  */
 export declare function tokenizeCommand(cmd: string): string[];
-/**
- * Normalize session name by stripping :window and .pane suffixes
- * e.g., "matrixx-x:1" -> "matrixx-x", "matrixx-x:1.2" -> "matrixx-x"
- */
-export declare function normalizeSessionName(name: string): string;
-export declare function findFlagValue(tokens: string[], flag: string): string | null;
 /**
  * Extract session name from tokens, considering the subCommand
  * For new-session: prioritize -s over -t

package/dist/hooks/plan-persister/hook.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Plan Persister Hook
+ *
+ * Continuation hook that persists active plan state (todos + metadata)
+ * to the plan file on session.idle, and builds rehydration context
+ * for injection after compaction.
+ */
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { PlanPersistenceOptions } from "../../features/mission-state/types";
+export interface PlanPersister {
+    buildRehydrationContext: (sessionID: string) => string | null;
+    capture: (sessionID: string) => Promise<void>;
+    event: (input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+}
+export declare function createPlanPersister(ctx: PluginInput, options: PlanPersistenceOptions): PlanPersister;

package/dist/hooks/plan-persister/index.d.ts

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