opencode-matrixx 2.6.4 → 2.6.6

package/dist/tools/delegate-task/categories.d.ts

@@ -1,22 +1,12 @@
-import type { CategoriesConfig, CategoryConfig, ModelRequirements } from "../../config/schema";
-import type { TierResolverContext } from "../../shared/tier-resolver";
+import type { CategoriesConfig, CategoryConfig, ModelPresetEntry, ModelRequirements } from "../../config/schema";
 interface ResolveCategoryConfigOptions {
     userCategories?: CategoriesConfig;
     inheritedModel?: string;
     systemDefaultModel?: string;
     availableModels?: Set<string>;
-    tierContext?: TierResolverContext;
     modelRequirements?: ModelRequirements;
-    tiers?: Record<string, {
-        providerPriority: string[];
-        modelPattern: string;
-        fallbackTier?: string;
-        fallback?: {
-            providers: string[];
-            model: string;
-            variant?: string;
-        }[];
-    }>;
+    /** Preset entry resolved at call time (session overlay > config active_preset). */
+    presetEntry?: ModelPresetEntry;
 }
 interface ResolveCategoryConfigResult {
     config: CategoryConfig;
@@ -27,11 +17,6 @@ interface ResolveCategoryConfigResult {
 /**
  * Resolve the configuration for a given category name.
  * Merges default and user configurations, handles model resolution.
- *
- * Tier resolution: both `userConfig.tier` and `defaultConfig.tier` are
- * resolved against the live provider list (`tierContext`). An explicit
- * `userConfig.model` always wins; an explicit `userConfig.tier` wins
- * over the default tier; otherwise the default tier is used.
  */
 export declare function resolveCategoryConfig(categoryName: string, options: ResolveCategoryConfigOptions): ResolveCategoryConfigResult | null;
 export {};

package/dist/tools/delegate-task/complexity-constants.d.ts

@@ -1,10 +1,7 @@
-import type { Tiers } from "../../config/schema";
-import { type TierResolverContext } from "../../shared/tier-resolver";
 import type { ComplexityLevel } from "./complexity-types";
 export type ComplexityDowngradesConfig = Record<string, Record<string, string>>;
 export type ComplexityConfigHolder = {
     complexityDowngrades?: ComplexityDowngradesConfig;
-    tiers?: Tiers;
 };
 /**
  * Resolve the model for a given category and complexity level.
@@ -12,17 +9,15 @@ export type ComplexityConfigHolder = {
  * Config-driven: no built-in literals. Downgrade map is resolved as:
  *   userDowngrades ?? config.complexityDowngrades?.[category] ?? {}
  * If no entry for this complexity, returns original (no downgrade).
- * If value starts with "tier:", resolves via live tier resolver.
  *
  * @param category - The task category name
  * @param complexity - The complexity level (1-5)
  * @param originalModel - The currently resolved model string
  * @param userDowngrades - Optional per-category user override from CategoryConfig.complexity_downgrades
- * @param config - Optional holder with global complexityDowngrades and tiers
- * @param tierContext - Optional live provider context for tier: resolution
+ * @param config - Optional holder with global complexityDowngrades
  * @returns The model to use and whether a downgrade was applied
  */
-export declare function resolveComplexityModel(category: string, complexity: ComplexityLevel, originalModel: string, userDowngrades?: Record<string, string>, config?: ComplexityConfigHolder | ComplexityDowngradesConfig, tierContext?: TierResolverContext): {
+export declare function resolveComplexityModel(category: string, complexity: ComplexityLevel, originalModel: string, userDowngrades?: Record<string, string>, config?: ComplexityConfigHolder | ComplexityDowngradesConfig): {
     model: string;
     downgraded: boolean;
 };

package/dist/tools/delegate-task/executor-types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentOverrides, BrowserAutomationProvider, CategoriesConfig, ComplexityDowngrades, ModelRequirements, Tiers } from "../../config/schema";
+import type { AgentOverrides, BrowserAutomationProvider, CategoriesConfig, ComplexityDowngrades, ModelPresets, ModelRequirements } from "../../config/schema";
 import type { BackgroundManager } from "../../features/background-agent";
 import type { OpencodeClient } from "./types";
 export interface ExecutorContext {
@@ -12,7 +12,12 @@ export interface ExecutorContext {
     agentOverrides?: AgentOverrides;
     modelRequirements?: ModelRequirements;
     complexityDowngrades?: ComplexityDowngrades;
-    tiers?: Tiers;
+    /** Named model presets from plugin config (`model_presets`). */
+    modelPresets?: ModelPresets;
+    /** Active preset name from plugin config (`active_preset`). */
+    activePreset?: string;
+    /** Invoking (parent) session ID — its preset overlay propagates to delegated tasks. */
+    sessionID?: string;
     onSyncSessionCreated?: (event: {
         sessionID: string;
         parentID: string;

package/dist/tools/delegate-task/sync-task.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/delegate-task/timing.d.ts

@@ -8,4 +8,9 @@ export declare function getTimingConfig(): {
     SESSION_CONTINUATION_STABILITY_MS: number;
 };
 export declare function __resetTimingConfig(): void;
+/**
+ * Set poll timeout from plugin config. Called during plugin initialization.
+ * Accepts a value in milliseconds; falls back to 10 min default.
+ */
+export declare function setPollTimeoutMs(ms: number): void;
 export declare function __setTimingConfig(overrides: Partial<ReturnType<typeof getTimingConfig>>): void;

package/dist/tools/delegate-task/timing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/delegate-task/types.d.ts

@@ -1,6 +1,6 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { AvailableCategory, AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
-import type { AgentOverrides, BrowserAutomationProvider, CategoriesConfig, ComplexityDowngrades, ModelRequirements, Tiers } from "../../config/schema";
+import type { AgentOverrides, BrowserAutomationProvider, CategoriesConfig, ComplexityDowngrades, ModelPresets, ModelRequirements } from "../../config/schema";
 import type { BackgroundManager } from "../../features/background-agent";
 export type OpencodeClient = PluginInput["client"];
 export interface DelegateTaskArgs {
@@ -71,7 +71,10 @@ export interface DelegateTaskToolOptions {
     agentOverrides?: AgentOverrides;
     modelRequirements?: ModelRequirements;
     complexityDowngrades?: ComplexityDowngrades;
-    tiers?: Tiers;
+    /** Named model presets from plugin config (`model_presets`). */
+    modelPresets?: ModelPresets;
+    /** Active preset name from plugin config (`active_preset`). */
+    activePreset?: string;
     onSyncSessionCreated?: (event: SyncSessionCreatedEvent) => Promise<void>;
 }
 export interface BuildSystemContentInput {

package/dist/tools/index.d.ts

@@ -14,6 +14,7 @@ export { createPlanDeleteTool } from "./plan/plan-delete";
 export { createPlanListTool } from "./plan/plan-list";
 export { createPlanReadTool } from "./plan/plan-read";
 export { createPlanUpdateTool } from "./plan/plan-update";
+export { createPresetTool } from "./preset";
 export { createSessionManagerTools } from "./session-manager";
 export { sessionExists } from "./session-manager/storage";
 export { createSkillTool } from "./skill";

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

@@ -0,0 +1 @@
+export { createPresetTool } from "./tools";

package/dist/tools/preset/tools.d.ts

@@ -0,0 +1,7 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+import type { MatrixxConfig } from "../../config";
+export interface PresetToolOptions {
+    pluginConfig?: MatrixxConfig;
+    directory?: string;
+}
+export declare function createPresetTool(options?: PresetToolOptions): Record<string, ToolDefinition>;

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

@@ -4,3 +4,4 @@
  * double dashes ("T-a--b"). Matches generateTaskId() output (T-{uuid}).
  */
 export declare const TASK_ID_PATTERN: RegExp;
+export declare const DEDUP_WINDOW_MS: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-matrixx",
-  "version": "2.6.4",
+  "version": "2.6.6",
   "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",

package/dist/config/presets.d.ts

@@ -1,4 +0,0 @@
-import type { MatrixxConfig } from "./schema/matrixx-config";
-export declare const PRESET_NAMES: readonly ["minimal", "balanced", "performance", "frontier"];
-export type PresetName = (typeof PRESET_NAMES)[number];
-export declare function expandPreset(preset: PresetName): MatrixxConfig;

package/dist/config/resolve-tiers.d.ts

@@ -1,32 +0,0 @@
-import { type TierResolverContext } from "../shared/tier-resolver";
-import type { MatrixxConfig } from "./schema/matrixx-config";
-interface WithTier {
-    model?: string;
-    tier?: string;
-}
-/**
- * Walk a merged MatrixxConfig and resolve any `tier: "..."` fields to concrete
- * `model: "..."` strings. The result is a new config object with the `tier`
- * fields cleared (so downstream code never re-resolves them).
- *
- * Precedence (per agent/category):
- *   1. Explicit `model` — kept as-is.
- *   2. Explicit `tier` — resolved against the live provider list.
- *   3. `default_tier` (top-level) — applied to any agent/category without
- *      a `model` or `tier` override, then resolved.
- *
- * If a tier cannot be resolved, the entry is left with `tier` set and `model`
- * undefined. The downstream `resolveModelPipeline` will fall through to
- * category defaults and the system default as a last resort.
- */
-export declare function resolveTiersInConfig(config: MatrixxConfig, ctx: TierResolverContext): MatrixxConfig;
-/**
- * Resolve tier fields in a category registry (e.g. `DEFAULT_CATEGORIES`) and
- * return a new object with `tier` cleared and `model` set where the tier
- * resolved. Entries that already have a concrete `model` are passed through.
- * Used at config load time to pre-resolve the built-in defaults so that
- * downstream code (createBuiltinAgents, buildAgent) only ever sees model
- * strings.
- */
-export declare function resolveTiersInCategoryRegistry(registry: Record<string, WithTier | undefined>, ctx: TierResolverContext, config?: MatrixxConfig): Record<string, WithTier>;
-export {};

package/dist/features/builtin-commands/templates/profile.d.ts

@@ -1 +0,0 @@
-export declare const PROFILE_TEMPLATE = "# /profile Command\n\n## Usage\n\n```\n/profile                  \u2192 List available profiles and show current\n/profile list            \u2192 List available profiles\n/profile show            \u2192 Show currently active profile\n/profile set <name>      \u2192 Change profile (edits project config, instructs to start new session)\n/profile set <name> --global  \u2192 Change profile globally (~/.config/opencode/matrixx.jsonc)\n/profile set <name> --project \u2192 Change profile project-scoped (.opencode/matrixx.jsonc)\n```\n\n## Available Profiles\n\n| Profile | Description | Key Characteristic |\n|---------|-------------|-------------------|\n| free | Zero-cost, uses only free/open models | Kimi K2.5 Free, Grok (free), GLM |\n| budget | Cost-optimized for tight budgets | Sonnet/Haiku mix, no Opus |\n| economy | Balanced cost and capability | Primarily Sonnet/Haiku |\n| balanced | Default \u2014 best overall value | Opus/Sonnet/Haiku tiered |\n| performance | Maximum quality, no compromises | Opus for all heavy agents |\n| go | Premium OpenCode Go subscription | Kimi K2.6, DeepSeek V4 Pro, GLM 5.1 |\n\n## How It Works\n\nEach profile sets the `model` field on every agent and category in Matrixx's configuration. When you switch profiles, the agent models are swapped accordingly.\n\nThe profile name is stored in your `matrixx.json` or `matrixx.jsonc` config file. On the next session, Matrixx reads it and applies the profile's model mapping, merging it with any explicit per-agent overrides you may have set.\n\n## Task: Change the Profile\n\nFollow these steps:\n\n### Step 1: Know the Current Config Location\n\nMatrixx reads config from two locations (user config wins over project config):\n- **Project**: `.opencode/matrixx.json` or `.opencode/matrixx.jsonc`\n- **Global**: `~/.config/opencode/matrixx.json` or `~/.config/opencode/matrixx.jsonc`\n\n### Step 2: Determine Which Config File to Edit\n\n- `--global` \u2192 Edit `~/.config/opencode/matrixx.jsonc`\n- `--project` (default) \u2192 Edit `.opencode/matrixx.jsonc`\n- If no flag and neither file exists, use `--project`\n\n### Step 3: Read the Target Config File\n\nUse the `read` tool to read the config file.\n\n### Step 4: Validate the Requested Profile\n\nIf the user asked for `/profile set <name>`, verify `<name>` is in the table above. If not, report the valid profiles and stop.\n\n### Step 5: Update the `profile` Key\n\nSet `\"profile\": \"<name>\"` in the config JSON. If the `profile` key already exists, update it. If it doesn't exist, add it at the top level. Do NOT modify any other keys.\n\n### Step 6: Write the Config File Back\n\nUse the `write` tool (or `edit` tool for minimal changes) to save the updated config.\n\n### Step 7: Confirm and Advise\n\nTell the user:\n1. The profile has been changed to `<name>`\n2. For the change to take effect, they MUST start a new session (`/new` or restart OpenCode)\n3. If they want session-level switching without restarting, suggest using the profile with `--global` or `--project` as appropriate\n\n### Step 8: If `/profile` Was Called Without Arguments\n\nJust list the available profiles and show the current configuration's profile value.";

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

@@ -1,44 +0,0 @@
-/**
- * Tier registry — abstract model classifications resolved against the live provider list.
- *
- * Tiers are matched by regex against "provider/model" strings, with a `providerPriority`
- * list to choose between providers when multiple match. Patterns are stored as
- * strings in `config.tiers[].modelPattern` and compiled at runtime via
- * `new RegExp` with try/catch (invalid -> never matches). No hardcoded
- * `provider` or model literals — all specs are config-driven via
- * `MatrixxConfig.tiers`. When config is empty, factories return empty/undefined
- * gracefully.
- */
-export type TierName = string;
-export interface TierSpec {
-    name: string;
-    /** Provider priority — first provider with a matching model wins. */
-    providerPriority: string[];
-    /** Regex tested against each "provider/model" string in the live provider list. */
-    modelPattern: RegExp;
-    /** Tier to recurse into if this tier cannot be satisfied. */
-    fallbackTier?: string;
-    /** Fallbacks used when the live provider list is empty but config provides them. */
-    fallback?: {
-        providers: string[];
-        model: string;
-        variant?: string;
-    }[];
-}
-export type TiersConfig = Record<string, {
-    providerPriority: string[];
-    modelPattern: string;
-    fallbackTier?: string;
-    fallback?: {
-        providers: string[];
-        model: string;
-        variant?: string;
-    }[];
-}>;
-export type TierConfigHolder = {
-    tiers?: TiersConfig;
-} | null | undefined;
-export declare function buildTierSpecs(config: TierConfigHolder): Record<string, TierSpec>;
-export declare function getTierSpec(tierName: string, config: TierConfigHolder): TierSpec | undefined;
-export declare function getTierNames(config: TierConfigHolder): string[];
-export declare function parseTierReference(value: string | undefined | null, config?: TierConfigHolder): string | null;

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

@@ -1,26 +0,0 @@
-import { type TierConfigHolder } from "./model-tiers";
-export interface TierResolverContext {
-    availableModels: Set<string>;
-    connectedProviders: string[] | null;
-}
-export type TierProvenance = "tier-resolved" | "tier-static-fallback";
-export interface TierResolutionResult {
-    model: string;
-    provenance: TierProvenance;
-    tier: string;
-}
-/**
- * Resolve a tier alias to a concrete "provider/model" string.
- *
- * Strategy:
- *   1. Live resolution: walk `providerPriority`, test `modelPattern` against
- *      each `provider/model` in the available set (config-driven, compiled at runtime).
- *   2. Config fallback: pick the first `fallback` whose provider is
- *      connected (used at first run when the live cache is cold, user-provided).
- *   3. Recurse into `fallbackTier` if defined.
- *
- * Returns null when no match is possible (no live models, no fallback
- * available, no fallback tier). When config is empty, returns null gracefully.
- */
-export declare function resolveTier(tier: string, ctx: TierResolverContext, config?: TierConfigHolder): TierResolutionResult | null;
-export declare function parseTierReference(value: string | undefined | null, config?: TierConfigHolder): string | null;

package/dist/tools/background-task/create-background-task.d.ts

@@ -1,3 +0,0 @@
-import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
-import type { BackgroundManager } from "../../features/background-agent";
-export declare function createBackgroundTask(manager: BackgroundManager, client: PluginInput["client"]): ToolDefinition;