opencode-matrixx 2.1.0 → 2.2.0

package/dist/shared/index.d.ts

@@ -45,6 +45,7 @@ export * from "./shell-env";
 export * from "./system-directive";
 export * from "./tmux";
 export * from "./token-cache";
+export * from "./tool-guards";
 export * from "./transcript-path";
 export * from "./truncate-description";
 export * from "./zip-extractor";

package/dist/shared/model-resolution-pipeline.d.ts

@@ -1,25 +1,2 @@
-import type { FallbackEntry } from "./model-requirements";
-export type ModelResolutionRequest = {
-    intent?: {
-        uiSelectedModel?: string;
-        userModel?: string;
-        categoryDefaultModel?: string;
-    };
-    constraints: {
-        availableModels: Set<string>;
-        connectedProviders?: string[] | null;
-    };
-    policy?: {
-        fallbackChain?: FallbackEntry[];
-        systemDefaultModel?: string;
-    };
-};
-export type ModelResolutionProvenance = "override" | "category-default" | "provider-fallback" | "system-default";
-export type ModelResolutionResult = {
-    model: string;
-    provenance: ModelResolutionProvenance;
-    variant?: string;
-    attempted?: string[];
-    reason?: string;
-};
+import type { ModelResolutionRequest, ModelResolutionResult } from "./model-resolution-types";
 export declare function resolveModelPipeline(request: ModelResolutionRequest): ModelResolutionResult | undefined;

package/dist/shared/model-resolution-types.d.ts

@@ -7,6 +7,7 @@ export type ModelResolutionRequest = {
     };
     constraints: {
         availableModels: Set<string>;
+        connectedProviders?: string[];
     };
     policy?: {
         fallbackChain?: FallbackEntry[];

package/dist/shared/model-resolver.d.ts

@@ -1,13 +1,15 @@
 import type { FallbackEntry } from "./model-requirements";
+import type { ModelResolutionProvenance } from "./model-resolution-types";
 export type ModelResolutionInput = {
     userModel?: string;
     inheritedModel?: string;
     systemDefault?: string;
 };
-export type ModelSource = "override" | "category-default" | "provider-fallback" | "system-default";
+/** @deprecated Use ModelResolutionProvenance from model-resolution-types.ts */
+export type ModelSource = ModelResolutionProvenance;
 export type ModelResolutionResult = {
     model: string;
-    source: ModelSource;
+    source: ModelResolutionProvenance;
     variant?: string;
 };
 export type ExtendedModelResolutionInput = {

package/dist/shared/opencode-config-dir.d.ts

@@ -1,8 +1,7 @@
-import type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths } from "./opencode-config-dir-types";
+import type { OpenCodeConfigDirOptions, OpenCodeConfigPaths } from "./opencode-config-dir-types";
 export type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths, } from "./opencode-config-dir-types";
 export declare const TAURI_APP_IDENTIFIER = "ai.opencode.desktop";
 export declare const TAURI_APP_IDENTIFIER_DEV = "ai.opencode.desktop.dev";
 export declare function isDevBuild(version: string | null | undefined): boolean;
 export declare function getOpenCodeConfigDir(options: OpenCodeConfigDirOptions): string;
 export declare function getOpenCodeConfigPaths(options: OpenCodeConfigDirOptions): OpenCodeConfigPaths;
-export declare function detectExistingConfigDir(binary: OpenCodeBinaryType, version?: string | null): string | null;

package/dist/shared/session-directory-resolver.d.ts

@@ -1,7 +1 @@
 export declare function isWindowsAppDataDirectory(directory: string): boolean;
-export declare function resolveSessionDirectory(options: {
-    parentDirectory: string | null | undefined;
-    fallbackDirectory: string;
-    platform?: NodeJS.Platform;
-    currentWorkingDirectory?: string;
-}): string;

package/dist/shared/tool-guards.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared tool name guard functions.
+ * Used by multiple hooks to check tool types (read/write).
+ */
+/**
+ * Check if a tool name represents a read operation.
+ * @param toolName - The tool name to check (case-insensitive)
+ * @returns true if the tool is a read tool
+ */
+export declare function isReadTool(toolName: string): boolean;
+/**
+ * Check if a tool name represents a write operation.
+ * @param toolName - The tool name to check (case-insensitive)
+ * @returns true if the tool is a write tool
+ */
+export declare function isWriteTool(toolName: string): boolean;

package/dist/tools/assembly/assembly-executor.d.ts

@@ -0,0 +1,17 @@
+import type { AssemblyConfig } from "../../config/schema/assembly";
+import type { BackgroundManager } from "../../features/background-agent/manager";
+import type { AssemblyArgs, SynthesisResult, VoterResult } from "./types";
+export interface AssemblyExecutorInput {
+    manager: BackgroundManager;
+    args: AssemblyArgs;
+    config: AssemblyConfig | undefined;
+    sessionID: string;
+    messageID: string;
+}
+export interface AssemblyOutput {
+    question: string;
+    voters: VoterResult[];
+    rounds: SynthesisResult[];
+    finalConsensus: string;
+}
+export declare function executeAssembly(input: AssemblyExecutorInput): Promise<AssemblyOutput>;

package/dist/tools/assembly/constants.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderModel } from "./types";
+export declare const DEFAULT_VOTERS = 3;
+export declare const DEFAULT_ROUNDS = 2;
+export declare const VOTER_TIMEOUT_MS = 120000;
+export declare const POLL_INTERVAL_MS = 1000;
+export declare const DEFAULT_PROVIDERS: ProviderModel[];

package/dist/tools/assembly/index.d.ts

@@ -0,0 +1,2 @@
+export type { AssemblyToolOptions } from "./tools";
+export { createAssemblyTool } from "./tools";

package/dist/tools/assembly/provider-selector.d.ts

@@ -0,0 +1,3 @@
+import type { AssemblyConfig } from "../../config/schema/assembly";
+import type { ProviderModel } from "./types";
+export declare function selectProviders(count: number, modelsOverride: string[] | undefined, config: AssemblyConfig | undefined): ProviderModel[];

package/dist/tools/assembly/synthesizer.d.ts

@@ -0,0 +1,3 @@
+import type { BackgroundManager } from "../../features/background-agent/manager";
+import type { SynthesisResult, VoterResult } from "./types";
+export declare function synthesizeResults(manager: BackgroundManager, question: string, voterResults: VoterResult[], round: number, parentSessionID: string, parentMessageID: string): Promise<SynthesisResult>;

package/dist/tools/assembly/tool-description.d.ts

@@ -0,0 +1,2 @@
+/** Assembly tool description for LLM consumption */
+export declare const TOOL_DESCRIPTION = "\nSpawns multiple AI agents (voters) with different model providers to independently analyze a question or decision, then synthesizes their reasoning into a unified consensus.\n\n## When to use\n- Making critical decisions that benefit from multiple perspectives\n- Evaluating complex tradeoffs where bias reduction matters\n- Validating architectural choices through multi-model reasoning\n- When you need confidence scoring on analysis\n\n## How it works\n1. **Voter selection**: Auto-selects N models from configured providers (or use your override)\n2. **Independent voting**: Each voter independently analyzes the question\n3. **Synthesis**: All voter outputs are fed to a synthesis round that identifies agreement, disagreement, and confidence\n4. **Multi-round**: Optionally repeat synthesis for deeper convergence\n\n## Output format\nReturns a structured consensus with:\n- Unified answer/conclusion\n- Confidence level (high/medium/low)\n- Key disagreements between voters\n- Per-voter reasoning traces\n";

package/dist/tools/assembly/tools.d.ts

@@ -0,0 +1,10 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { AssemblyConfig } from "../../config/schema/assembly";
+import type { BackgroundManager } from "../../features/background-agent/manager";
+export interface AssemblyToolOptions {
+    manager: BackgroundManager;
+    pluginConfig?: {
+        assembly?: AssemblyConfig;
+    };
+}
+export declare function createAssemblyTool(options: AssemblyToolOptions): ToolDefinition;

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

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export declare const AssemblyArgsSchema: z.ZodObject<{
+    question: z.ZodString;
+    voters: z.ZodOptional<z.ZodNumber>;
+    rounds: z.ZodOptional<z.ZodNumber>;
+    models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type AssemblyArgs = z.infer<typeof AssemblyArgsSchema>;
+export interface VoterResult {
+    voterIndex: number;
+    modelLabel: string;
+    reasoning: string;
+    status: "completed" | "error" | "timeout";
+    error?: string;
+}
+export interface SynthesisResult {
+    round: number;
+    consensus: string;
+    confidence: "high" | "medium" | "low";
+    disagreements: string[];
+}
+export interface ProviderModel {
+    providerID: string;
+    modelID: string;
+}

package/dist/tools/assembly/voter-spawner.d.ts

@@ -0,0 +1,3 @@
+import type { BackgroundManager } from "../../features/background-agent/manager";
+import type { ProviderModel, VoterResult } from "./types";
+export declare function spawnVoters(manager: BackgroundManager, question: string, providers: ProviderModel[], parentSessionID: string, parentMessageID: string): Promise<VoterResult[]>;

package/dist/tools/handoff/constants.d.ts

@@ -12,6 +12,3 @@ export declare const MAX_GIT_OUTPUT_BYTES = 4096;
 export declare const GIT_COMMAND_TIMEOUT_MS = 5000;
 /** Sentinel used when we cannot resolve git metadata for the working dir. */
 export declare const UNKNOWN_GIT_SHA = "unknown";
-/** Canonical list of supported actions (kept in sync with the zod enum). */
-export declare const HANDOFF_ACTIONS: readonly ["create", "read", "list", "archive"];
-export type HandoffAction = (typeof HANDOFF_ACTIONS)[number];

package/dist/tools/index.d.ts

@@ -13,6 +13,7 @@ export { lspManager };
 import type { PluginInput, ToolDefinition } from "@opencode-ai/plugin";
 import type { BackgroundManager } from "../features/background-agent";
 type OpencodeClient = PluginInput["client"];
+export { createAssemblyTool } from "./assembly";
 export { createDelegateAgent } from "./delegate-agent";
 export { createDelegateTask } from "./delegate-task";
 export { createHashlineEditTool } from "./hashline-edit";

package/package.json

@@ -1,17 +1,12 @@
 {
   "name": "opencode-matrixx",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "bin": {
-    "matrixx": "./bin/matrixx.js"
-  },
   "files": [
-    "dist",
-    "bin",
-    "postinstall.mjs"
+    "dist"
   ],
   "exports": {
     ".": {
@@ -21,12 +16,9 @@
     "./schema.json": "./dist/matrixx.schema.json"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm --external @ast-grep/napi && bun run build:schema",
-    "build:all": "bun run build && bun run build:binaries",
-    "build:binaries": "bun run script/build-binaries.ts",
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @ast-grep/napi && tsc --emitDeclarationOnly && bun run build:schema",
     "build:schema": "bun run script/build-schema.ts",
     "clean": "rm -rf dist",
-    "postinstall": "node postinstall.mjs",
     "prepublishOnly": "bun run clean && bun run build",
     "typecheck": "tsc --noEmit",
     "lint": "biome check src/",
@@ -51,10 +43,7 @@
     "vibe-coding",
     "agentic",
     "autonomous-agents",
-    "developer-tools",
-    "typescript",
-    "plugin",
-    "cli"
+    "plugin"
   ],
   "author": "klpanagi",
   "license": "SUL-1.0",
@@ -69,17 +58,12 @@
   "dependencies": {
     "@ast-grep/cli": "^0.40.0",
     "@ast-grep/napi": "^0.40.0",
-    "@clack/prompts": "^0.11.0",
     "@code-yeongyu/comment-checker": "^0.6.1",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@opencode-ai/plugin": "1.3.15",
     "@opencode-ai/sdk": "1.3.15",
-    "commander": "^14.0.2",
-    "detect-libc": "^2.0.0",
     "js-yaml": "^4.1.1",
     "jsonc-parser": "^3.3.1",
-    "opencode-matrixx": ".",
-    "picocolors": "^1.1.1",
     "picomatch": "^4.0.2",
     "vscode-jsonrpc": "^8.2.0",
     "zod": "^4.1.8"
@@ -91,15 +75,6 @@
     "bun-types": "1.3.6",
     "typescript": "^5.7.3"
   },
-  "optionalDependencies": {
-    "opencode-matrixx-darwin-arm64": "2.1.0",
-    "opencode-matrixx-darwin-x64": "2.1.0",
-    "opencode-matrixx-linux-arm64": "2.1.0",
-    "opencode-matrixx-linux-arm64-musl": "2.1.0",
-    "opencode-matrixx-linux-x64": "2.1.0",
-    "opencode-matrixx-linux-x64-musl": "2.1.0",
-    "opencode-matrixx-windows-x64": "2.1.0"
-  },
   "trustedDependencies": [
     "@ast-grep/cli",
     "@ast-grep/napi",

package/bin/matrixx.js

@@ -1,80 +0,0 @@
-#!/usr/bin/env node
-// bin/matrixx.js
-// Wrapper script that detects platform and spawns the correct binary
-
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { getPlatformPackage, getBinaryPath } from "./platform.js";
-
-const require = createRequire(import.meta.url);
-
-/**
- * Detect libc family on Linux
- * @returns {string | null} 'glibc', 'musl', or null if detection fails
- */
-function getLibcFamily() {
-  if (process.platform !== "linux") {
-    return undefined; // Not needed on non-Linux
-  }
-  
-  try {
-    const detectLibc = require("detect-libc");
-    return detectLibc.familySync();
-  } catch {
-    // detect-libc not available
-    return null;
-  }
-}
-
-function main() {
-  const { platform, arch } = process;
-  const libcFamily = getLibcFamily();
-  
-  // Get platform package name
-  let pkg;
-  try {
-    pkg = getPlatformPackage({ platform, arch, libcFamily });
-  } catch (error) {
-    console.error(`\nmatrixx: ${error.message}\n`);
-    process.exit(1);
-  }
-  
-  // Resolve binary path
-  const binRelPath = getBinaryPath(pkg, platform);
-  
-  let binPath;
-  try {
-    binPath = require.resolve(binRelPath);
-  } catch {
-    console.error(`\nmatrixx: Platform binary not installed.`);
-    console.error(`\nYour platform: ${platform}-${arch}${libcFamily === "musl" ? "-musl" : ""}`);
-    console.error(`Expected package: ${pkg}`);
-    console.error(`\nTo fix, run:`);
-    console.error(`  npm install ${pkg}\n`);
-    process.exit(1);
-  }
-  
-  // Spawn the binary
-  const result = spawnSync(binPath, process.argv.slice(2), {
-    stdio: "inherit",
-  });
-  
-  // Handle spawn errors
-  if (result.error) {
-    console.error(`\nmatrixx: Failed to execute binary.`);
-    console.error(`Error: ${result.error.message}\n`);
-    process.exit(2);
-  }
-  
-  // Handle signals
-  if (result.signal) {
-    const signalNum = result.signal === "SIGTERM" ? 15 : 
-                      result.signal === "SIGKILL" ? 9 :
-                      result.signal === "SIGINT" ? 2 : 1;
-    process.exit(128 + signalNum);
-  }
-
-  process.exit(result.status ?? 1);
-}
-
-main();

package/bin/platform.js

@@ -1,38 +0,0 @@
-// bin/platform.js
-// Shared platform detection module - used by wrapper and postinstall
-
-/**
- * Get the platform-specific package name
- * @param {{ platform: string, arch: string, libcFamily?: string | null }} options
- * @returns {string} Package name like "opencode-matrixx-darwin-arm64"
- * @throws {Error} If libc cannot be detected on Linux
- */
-export function getPlatformPackage({ platform, arch, libcFamily }) {
-  let suffix = "";
-  if (platform === "linux") {
-    if (libcFamily === null || libcFamily === undefined) {
-      throw new Error(
-        "Could not detect libc on Linux. " +
-        "Please ensure detect-libc is installed or report this issue."
-      );
-    }
-    if (libcFamily === "musl") {
-      suffix = "-musl";
-    }
-  }
-  
-  // Map platform names: win32 -> windows (for package name)
-  const os = platform === "win32" ? "windows" : platform;
-  return `opencode-matrixx-${os}-${arch}${suffix}`;
-}
-
-/**
- * Get the path to the binary within a platform package
- * @param {string} pkg Package name
- * @param {string} platform Process platform
- * @returns {string} Relative path like "opencode-matrixx-darwin-arm64/bin/matrixx"
- */
-export function getBinaryPath(pkg, platform) {
-  const ext = platform === "win32" ? ".exe" : "";
-  return `${pkg}/bin/matrixx${ext}`;
-}

package/bin/platform.test.ts

@@ -1,148 +0,0 @@
-// bin/platform.test.ts
-import { describe, expect, test } from "bun:test";
-import { getPlatformPackage, getBinaryPath } from "./platform.js";
-
-describe("getPlatformPackage", () => {
-  // #region Darwin platforms
-  test("returns darwin-arm64 for macOS ARM64", () => {
-    // #given macOS ARM64 platform
-    const input = { platform: "darwin", arch: "arm64" };
-
-    // #when getting platform package
-    const result = getPlatformPackage(input);
-
-    // #then returns correct package name
-    expect(result).toBe("opencode-matrixx-darwin-arm64");
-  });
-
-  test("returns darwin-x64 for macOS Intel", () => {
-    // #given macOS x64 platform
-    const input = { platform: "darwin", arch: "x64" };
-
-    // #when getting platform package
-    const result = getPlatformPackage(input);
-
-    // #then returns correct package name
-    expect(result).toBe("opencode-matrixx-darwin-x64");
-  });
-  // #endregion
-
-  // #region Linux glibc platforms
-  test("returns linux-x64 for Linux x64 with glibc", () => {
-    // #given Linux x64 with glibc
-    const input = { platform: "linux", arch: "x64", libcFamily: "glibc" };
-
-    // #when getting platform package
-    const result = getPlatformPackage(input);
-
-    // #then returns correct package name
-    expect(result).toBe("opencode-matrixx-linux-x64");
-  });
-
-  test("returns linux-arm64 for Linux ARM64 with glibc", () => {
-    // #given Linux ARM64 with glibc
-    const input = { platform: "linux", arch: "arm64", libcFamily: "glibc" };
-
-    // #when getting platform package
-    const result = getPlatformPackage(input);
-
-    // #then returns correct package name
-    expect(result).toBe("opencode-matrixx-linux-arm64");
-  });
-  // #endregion
-
-  // #region Linux musl platforms
-  test("returns linux-x64-musl for Alpine x64", () => {
-    // #given Linux x64 with musl (Alpine)
-    const input = { platform: "linux", arch: "x64", libcFamily: "musl" };
-
-    // #when getting platform package
-    const result = getPlatformPackage(input);
-
-    // #then returns correct package name with musl suffix
-    expect(result).toBe("opencode-matrixx-linux-x64-musl");
-  });
-
-  test("returns linux-arm64-musl for Alpine ARM64", () => {
-    // #given Linux ARM64 with musl (Alpine)
-    const input = { platform: "linux", arch: "arm64", libcFamily: "musl" };
-
-    // #when getting platform package
-    const result = getPlatformPackage(input);
-
-    // #then returns correct package name with musl suffix
-    expect(result).toBe("opencode-matrixx-linux-arm64-musl");
-  });
-  // #endregion
-
-  // #region Windows platform
-  test("returns windows-x64 for Windows", () => {
-    // #given Windows x64 platform (win32 is Node's platform name)
-    const input = { platform: "win32", arch: "x64" };
-
-    // #when getting platform package
-    const result = getPlatformPackage(input);
-
-    // #then returns correct package name with 'windows' not 'win32'
-    expect(result).toBe("opencode-matrixx-windows-x64");
-  });
-  // #endregion
-
-  // #region Error cases
-  test("throws error for Linux with null libcFamily", () => {
-    // #given Linux platform with null libc detection
-    const input = { platform: "linux", arch: "x64", libcFamily: null };
-
-    // #when getting platform package
-    // #then throws descriptive error
-    expect(() => getPlatformPackage(input)).toThrow("Could not detect libc");
-  });
-
-  test("throws error for Linux with undefined libcFamily", () => {
-    // #given Linux platform with undefined libc
-    const input = { platform: "linux", arch: "x64", libcFamily: undefined };
-
-    // #when getting platform package
-    // #then throws descriptive error
-    expect(() => getPlatformPackage(input)).toThrow("Could not detect libc");
-  });
-  // #endregion
-});
-
-describe("getBinaryPath", () => {
-  test("returns path without .exe for Unix platforms", () => {
-    // #given Unix platform package
-    const pkg = "opencode-matrixx-darwin-arm64";
-    const platform = "darwin";
-
-    // #when getting binary path
-    const result = getBinaryPath(pkg, platform);
-
-    // #then returns path without extension
-    expect(result).toBe("opencode-matrixx-darwin-arm64/bin/matrixx");
-  });
-
-  test("returns path with .exe for Windows", () => {
-    // #given Windows platform package
-    const pkg = "opencode-matrixx-windows-x64";
-    const platform = "win32";
-
-    // #when getting binary path
-    const result = getBinaryPath(pkg, platform);
-
-    // #then returns path with .exe extension
-    expect(result).toBe("opencode-matrixx-windows-x64/bin/matrixx.exe");
-  });
-
-  test("returns path without .exe for Linux", () => {
-    // #given Linux platform package
-    const pkg = "opencode-matrixx-linux-x64";
-    const platform = "linux";
-
-    // #when getting binary path
-    const result = getBinaryPath(pkg, platform);
-
-    // #then returns path without extension
-    expect(result).toBe("opencode-matrixx-linux-x64/bin/matrixx");
-  });
-});

package/dist/cli/cli-installer.d.ts

@@ -1,2 +0,0 @@
-import type { InstallArgs } from "./types";
-export declare function runCliInstaller(args: InstallArgs, version: string): Promise<number>;

package/dist/cli/cli-program.d.ts

@@ -1 +0,0 @@
-export declare function runCli(): void;

package/dist/cli/config-manager/add-plugin-to-opencode-config.d.ts

@@ -1,2 +0,0 @@
-import type { ConfigMergeResult } from "../types";
-export declare function addPluginToOpenCodeConfig(currentVersion: string): Promise<ConfigMergeResult>;

package/dist/cli/config-manager/add-provider-config.d.ts

@@ -1,2 +0,0 @@
-import type { ConfigMergeResult, InstallConfig } from "../types";
-export declare function addProviderConfig(config: InstallConfig): ConfigMergeResult;