opencode-matrixx 2.2.0 → 2.3.0

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/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/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";