oh-my-opencode 3.17.5 → 3.17.7

package/dist/plugin/event.d.ts

@@ -10,6 +10,7 @@ type FirstMessageVariantGate = {
     } | undefined) => void;
     clear: (sessionID: string) => void;
 };
+export declare function extractErrorMessage(error: unknown): string;
 type EventInput = Parameters<NonNullable<NonNullable<CreatedHooks["writeExistingFileGuard"]>["event"]>>[0];
 export declare function createEventHandler(args: {
     ctx: PluginContext;

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -1,4 +1,5 @@
 import type { HookName, OhMyOpenCodeConfig } from "../../config";
+import type { BackgroundManager } from "../../features/background-agent";
 import type { ModelFallbackControllerAccessor } from "../../hooks/model-fallback";
 import type { PluginContext } from "../types";
 import type { ModelCacheState } from "../../plugin-state";
@@ -6,6 +7,7 @@ export declare function createCoreHooks(args: {
     ctx: PluginContext;
     pluginConfig: OhMyOpenCodeConfig;
     modelCacheState: ModelCacheState;
+    backgroundManager: BackgroundManager;
     modelFallbackControllerAccessor?: ModelFallbackControllerAccessor;
     isHookEnabled: (hookName: HookName) => boolean;
     safeHookEnabled: boolean;

package/dist/plugin/hooks/create-session-hooks.d.ts

@@ -1,4 +1,5 @@
 import type { OhMyOpenCodeConfig, HookName } from "../../config";
+import type { BackgroundManager } from "../../features/background-agent";
 import type { ModelFallbackControllerAccessor } from "../../hooks/model-fallback";
 import type { ModelCacheState } from "../../plugin-state";
 import type { PluginContext } from "../types";
@@ -34,6 +35,7 @@ export declare function createSessionHooks(args: {
     ctx: PluginContext;
     pluginConfig: OhMyOpenCodeConfig;
     modelCacheState: ModelCacheState;
+    backgroundManager: BackgroundManager;
     modelFallbackControllerAccessor?: ModelFallbackControllerAccessor;
     isHookEnabled: (hookName: HookName) => boolean;
     safeHookEnabled: boolean;

package/dist/shared/agent-display-names.d.ts

@@ -12,7 +12,6 @@
 export declare const AGENT_DISPLAY_NAMES: Record<string, string>;
 export declare function stripInvisibleAgentCharacters(agentName: string): string;
 export declare function stripAgentListSortPrefix(agentName: string): string;
-export declare function getAgentRuntimeName(configKey: string): string;
 /**
  * Get display name for an agent config key.
  * Uses case-insensitive lookup for backward compatibility.
@@ -20,7 +19,13 @@ export declare function getAgentRuntimeName(configKey: string): string;
  */
 export declare function getAgentDisplayName(configKey: string): string;
 /**
- * Runtime-facing agent name used for OpenCode list ordering.
+ * Thin alias for `getAgentDisplayName` preserved for external imports.
+ *
+ * Earlier versions injected zero-width prefixes here to bias OpenCode's
+ * `agent.name` sort. Sort ordering is now enforced by
+ * `src/shared/agent-sort-shim.ts`, so this function emits the canonical
+ * display name verbatim. Kept exported because downstream modules still
+ * import this symbol; do not collapse the call sites without coordinating.
  */
 export declare function getAgentListDisplayName(configKey: string): string;
 /**

package/dist/shared/agent-sort-shim.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Agent sort shim.
+ *
+ * OpenCode 1.4.x ignores the agent `order` field (sst/opencode#19127) and
+ * sorts the agent list by `agent.name` via Remeda `sortBy(x => x.name, "asc")`
+ * at packages/opencode/src/agent/agent.ts. Without intervention, the four
+ * core agents collapse into Atlas -> Hephaestus -> Prometheus -> Sisyphus,
+ * which inverts the canonical sisyphus -> hephaestus -> prometheus -> atlas
+ * order this project ships.
+ *
+ * Earlier attempts to bias the sort key with invisible characters (ZWSP,
+ * U+2060 WORD JOINER, U+00AD SOFT HYPHEN, ANSI escape) caused visible-gap
+ * and column-truncation regressions in the TUI status bar (#3259, #3238).
+ *
+ * This shim is the narrowly-scoped alternative from PR #3267 with the Cubic
+ * P1 mitigations applied:
+ *   1. `isAgentArray` rejects any array element that is null, non-object, or
+ *      lacks a string `name`, eliminating the throw-on-mixed-array failure
+ *      mode that closed the original PR.
+ *   2. The activation predicate requires >= 2 elements whose `.name` is one
+ *      of the four canonical core display names, so unrelated `.sort()` and
+ *      `.toSorted()` calls (string arrays, number arrays, generic objects)
+ *      execute native behavior unchanged.
+ *
+ * Remove this shim once OpenCode honors the agent `order` field
+ * (sst/opencode#19127).
+ */
+export declare function installAgentSortShim(): void;

package/dist/shared/dynamic-truncator.d.ts

@@ -1,5 +1,11 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import { type ContextLimitModelCacheState } from "./context-limit-resolver";
+type ContextWindowUsage = {
+    usedTokens: number;
+    remainingTokens: number;
+    usagePercentage: number;
+};
+export declare function invalidateContextWindowUsageCache(ctx: PluginInput, sessionID?: string): void;
 export interface TruncationResult {
     result: string;
     truncated: boolean;
@@ -11,18 +17,11 @@ export interface TruncationOptions {
     contextWindowLimit?: number;
 }
 export declare function truncateToTokenLimit(output: string, maxTokens: number, preserveHeaderLines?: number): TruncationResult;
-export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ContextLimitModelCacheState): Promise<{
-    usedTokens: number;
-    remainingTokens: number;
-    usagePercentage: number;
-} | null>;
+export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ContextLimitModelCacheState): Promise<ContextWindowUsage | null>;
 export declare function dynamicTruncate(ctx: PluginInput, sessionID: string, output: string, options?: TruncationOptions, modelCacheState?: ContextLimitModelCacheState): Promise<TruncationResult>;
 export declare function createDynamicTruncator(ctx: PluginInput, modelCacheState?: ContextLimitModelCacheState): {
     truncate: (sessionID: string, output: string, options?: TruncationOptions) => Promise<TruncationResult>;
-    getUsage: (sessionID: string) => Promise<{
-        usedTokens: number;
-        remainingTokens: number;
-        usagePercentage: number;
-    } | null>;
+    getUsage: (sessionID: string) => Promise<ContextWindowUsage | null>;
     truncateSync: (output: string, maxTokens: number, preserveHeaderLines?: number) => TruncationResult;
 };
+export {};

package/dist/shared/file-reference-resolver.d.ts

@@ -1 +1,2 @@
+export declare function resolveFilePath(filePath: string, cwd: string): string;
 export declare function resolveFileReferencesInText(text: string, cwd?: string, depth?: number, maxDepth?: number): Promise<string>;

package/dist/shared/model-error-classifier.d.ts

@@ -5,12 +5,12 @@ export interface ErrorInfo {
 }
 /**
  * Determines if an error is a retryable model error.
- * Returns true if the error is a known retryable type OR matches retryable message patterns.
+ * Returns true if it's a known retryable type OR matches retryable message patterns.
  */
 export declare function isRetryableModelError(error: ErrorInfo): boolean;
 /**
  * Determines if an error should trigger a fallback retry.
- * Returns true for deadstop errors that completely halt the action loop.
+ * Returns true for errors that halt execution.
  */
 export declare function shouldRetryError(error: ErrorInfo): boolean;
 /**

package/dist/shared/posthog-activity-state.d.ts

@@ -1,8 +1,11 @@
 type PostHogActivityCaptureState = {
     dayUTC: string;
-    hourUTC: string;
     captureDaily: boolean;
-    captureHourly: boolean;
+};
+type PluginLoadedCaptureState = {
+    dayUTC: string;
+    capturePluginLoaded: boolean;
 };
 export declare function getPostHogActivityCaptureState(now?: Date): PostHogActivityCaptureState;
+export declare function getPluginLoadedCaptureState(now?: Date): PluginLoadedCaptureState;
 export {};

package/dist/shared/posthog.d.ts

@@ -1,4 +1,9 @@
 import { PostHog } from "posthog-node";
+import { getPostHogActivityCaptureState } from "./posthog-activity-state";
+/** @internal test-only */
+export declare function __setActivityStateProviderForTesting(provider: typeof getPostHogActivityCaptureState): void;
+/** @internal test-only */
+export declare function __resetActivityStateProviderForTesting(): void;
 type PostHogCaptureEvent = Parameters<PostHog["capture"]>[0];
 type PostHogExceptionProperties = Parameters<PostHog["captureException"]>[2];
 type PostHogActivityReason = "run_started" | "plugin_loaded";

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

@@ -7,6 +7,7 @@ export type BackgroundOutputMessage = {
             created?: number;
         };
         agent?: string;
+        error?: unknown;
     };
     parts?: Array<{
         type?: string;

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

@@ -2,3 +2,4 @@ import type { CategoryConfig } from "../../config/schema";
 export declare const DEFAULT_CATEGORIES: Record<string, CategoryConfig>;
 export declare const CATEGORY_PROMPT_APPENDS: Record<string, string>;
 export declare const CATEGORY_DESCRIPTIONS: Record<string, string>;
+export declare const CATEGORY_PROMPT_APPEND_RESOLVERS: Record<string, (model: string | undefined) => string>;

package/dist/tools/delegate-task/builtin-category-definition.d.ts

@@ -4,4 +4,5 @@ export type BuiltinCategoryDefinition = {
     config: CategoryConfig;
     description: string;
     promptAppend: string;
+    resolvePromptAppend?: (model: string | undefined) => string;
 };

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

@@ -1,5 +1,5 @@
 import type { AvailableCategory, AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
-export { CATEGORY_DESCRIPTIONS, CATEGORY_PROMPT_APPENDS, DEFAULT_CATEGORIES, } from "./builtin-categories";
+export { CATEGORY_DESCRIPTIONS, CATEGORY_PROMPT_APPENDS, CATEGORY_PROMPT_APPEND_RESOLVERS, DEFAULT_CATEGORIES, } from "./builtin-categories";
 /**
  * System prompt prepended to plan agent invocations.
  * Instructs the plan agent to first gather context via explore/librarian agents,

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

@@ -38,6 +38,7 @@ export interface SessionMessage {
             created?: number;
         };
         finish?: string;
+        error?: unknown;
         agent?: string;
         model?: {
             providerID: string;

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

@@ -1,2 +1,5 @@
 import type { BuiltinCategoryDefinition } from "./builtin-category-definition";
+export declare const DEEP_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on GOAL-ORIENTED AUTONOMOUS tasks.\n\nYou are NOT an interactive assistant. You are an autonomous problem-solver.\n\nBEFORE making ANY changes:\n1. Silently explore the codebase extensively (5-15 minutes of reading is normal)\n2. Read related files, trace dependencies, understand the full context\n3. Build a complete mental model of the problem space\n4. Do not ask clarifying questions - the goal is already defined\n\nYou receive a GOAL. When the goal includes numbered steps or phases, treat them as one atomic task broken into sub-steps, not as separate independent tasks. Figure out HOW to achieve it yourself. Thorough research before any action.\n\nSub-steps of ONE goal = execute all steps as phases of one atomic task.\nGenuinely independent tasks = flag and refuse, require separate delegations.\n\nApproach: explore extensively, understand deeply, then act decisively. Prefer comprehensive solutions over quick patches. If the goal is unclear, make reasonable assumptions and proceed.\n\nMinimal status updates. Focus on results, not play-by-play. Report completion with summary of changes.\n</Category_Context>";
+export declare const DEEP_CATEGORY_PROMPT_APPEND_GPT_5_5 = "<Category_Context name=\"deep\">\nYou are operating in DEEP mode. This is the category reserved for goal-oriented autonomous work on hairy problems that reward thorough exploration and comprehensive solutions.\n\nThe orchestrator chose this category because the task benefits from depth over speed. You should feel empowered to spend the time needed: five to fifteen minutes of silent exploration before the first edit is normal and correct. Rushing to implementation on a deep task is a failure mode, not a feature.\n\n# How deep mode adjusts the base behavior\n\n**Exploration budget: generous.** Read the files you need, trace dependencies both directions, fire 2-5 explore/librarian sub-agents in parallel for broader questions. Build a complete mental model before the first `apply_patch`. Exploration here is an investment, not overhead.\n\n**Goal, not plan.** You receive a GOAL describing the desired outcome. You figure out HOW to achieve it. The orchestrator deliberately did not hand you a step-by-step plan; producing one and asking for approval is not what was asked. Execute.\n\n**Atomic task treatment.** When the goal contains numbered steps or phases, treat them as sub-steps of ONE task and execute them all in this turn. Splitting them across turns is wrong unless they reveal an architectural blocker that requires the user's input. If the \"steps\" turn out to be genuinely independent tasks that should have been separate delegations, flag that in your final message and refuse the ones beyond scope.\n\n**Root cause bias.** Prefer root-cause fixes over symptom fixes. A null check around `foo()` is a symptom fix; fixing whatever causes `foo()` to return unexpected values is the root fix. Trace at least two levels up before settling on an answer. In deep mode, you have permission (and the expectation) to do the deeper fix.\n\n**Ambition scaled to context.** For brand-new greenfield work, be ambitious. Choose strong defaults, avoid AI-slop aesthetics, produce something you would be proud to hand to another senior engineer. For changes in an existing codebase, be surgical and respect the existing patterns; depth does not mean invasiveness.\n\n**Completion bar: full delivery.** \"Simplified version\", \"proof of concept\", and \"you can extend this later\" are not acceptable deliveries for a deep task. The orchestrator routed here specifically for a complete solution. If you hit a genuine blocker (missing secret, design decision only the user can make, three materially different attempts all failed), document it and return; otherwise, finish the task.\n\n**Status cadence: sparse.** The user is not on the other side of this conversation; the orchestrator is, and they will synthesize your progress. Send commentary only at meaningful phase transitions (starting exploration, starting implementation, starting verification, hitting a genuine blocker). Do not narrate every tool call; silence during focused work is expected.\n</Category_Context>";
+export declare function resolveDeepCategoryPromptAppend(model: string | undefined): string;
 export declare const OPENAI_CATEGORIES: BuiltinCategoryDefinition[];

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

@@ -1,5 +1,6 @@
 import type { FallbackEntry } from "../../shared/model-requirements";
 import type { DelegatedModelConfig } from "./types";
+import type { ModelFallbackState } from "../../hooks/model-fallback/hook";
 export declare function retrySyncPromptWithFallbacks(input: {
     sessionID: string;
     initialError: string;
@@ -9,4 +10,6 @@ export declare function retrySyncPromptWithFallbacks(input: {
 }): Promise<{
     promptError: string | null;
     categoryModel: DelegatedModelConfig | undefined;
+    fallbackState?: ModelFallbackState;
 }>;
+export declare function getNextSyncFallbackModel(sessionID: string, fallbackState: ModelFallbackState | undefined): DelegatedModelConfig | null;

package/dist/tools/slashcommand/command-discovery-deps.d.ts

@@ -0,0 +1,6 @@
+export { EXCLUDED_DIRS } from "../../shared/excluded-dirs";
+export { parseFrontmatter } from "../../shared/frontmatter";
+export { sanitizeModelField } from "../../shared/model-sanitizer";
+export { getOpenCodeCommandDirs } from "../../shared/opencode-command-dirs";
+export { discoverPluginCommandDefinitions } from "../../shared/plugin-command-discovery";
+export { findProjectOpencodeCommandDirs } from "../../shared/project-discovery-dirs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "3.17.5",
+  "version": "3.17.7",
   "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",
@@ -80,17 +80,17 @@
     "zod": "^4.3.0"
   },
   "optionalDependencies": {
-    "oh-my-opencode-darwin-arm64": "3.17.5",
-    "oh-my-opencode-darwin-x64": "3.17.5",
-    "oh-my-opencode-darwin-x64-baseline": "3.17.5",
-    "oh-my-opencode-linux-arm64": "3.17.5",
-    "oh-my-opencode-linux-arm64-musl": "3.17.5",
-    "oh-my-opencode-linux-x64": "3.17.5",
-    "oh-my-opencode-linux-x64-baseline": "3.17.5",
-    "oh-my-opencode-linux-x64-musl": "3.17.5",
-    "oh-my-opencode-linux-x64-musl-baseline": "3.17.5",
-    "oh-my-opencode-windows-x64": "3.17.5",
-    "oh-my-opencode-windows-x64-baseline": "3.17.5"
+    "oh-my-opencode-darwin-arm64": "3.17.7",
+    "oh-my-opencode-darwin-x64": "3.17.7",
+    "oh-my-opencode-darwin-x64-baseline": "3.17.7",
+    "oh-my-opencode-linux-arm64": "3.17.7",
+    "oh-my-opencode-linux-arm64-musl": "3.17.7",
+    "oh-my-opencode-linux-x64": "3.17.7",
+    "oh-my-opencode-linux-x64-baseline": "3.17.7",
+    "oh-my-opencode-linux-x64-musl": "3.17.7",
+    "oh-my-opencode-linux-x64-musl-baseline": "3.17.7",
+    "oh-my-opencode-windows-x64": "3.17.7",
+    "oh-my-opencode-windows-x64-baseline": "3.17.7"
   },
   "overrides": {},
   "trustedDependencies": [

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

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