oh-my-opencode 3.16.0 → 3.17.1

package/dist/openclaw/config.d.ts

@@ -1,8 +1,8 @@
 import type { OpenClawConfig, OpenClawGateway } from "./types";
+export { validateGatewayUrl } from "./gateway-url-validation";
 export declare function normalizeReplyListenerConfig(config: OpenClawConfig): OpenClawConfig;
 export declare function resolveGateway(config: OpenClawConfig, event: string): {
     gatewayName: string;
     gateway: OpenClawGateway;
     instruction: string;
 } | null;
-export declare function validateGatewayUrl(url: string): boolean;

package/dist/openclaw/dispatcher.d.ts

@@ -1,19 +1,9 @@
-import type { OpenClawGateway } from "./types";
-export declare function validateGatewayUrl(url: string): boolean;
+import type { OpenClawGateway, WakeResult } from "./types";
 export declare function interpolateInstruction(template: string, variables: Record<string, string | undefined>): string;
 export declare function shellEscapeArg(value: string): string;
 export declare function resolveCommandTimeoutMs(gatewayTimeout?: number, envTimeoutRaw?: string | undefined): number;
-export declare function wakeGateway(gatewayName: string, gatewayConfig: OpenClawGateway, payload: unknown): Promise<{
-    gateway: string;
-    success: boolean;
-    error?: string;
-    statusCode?: number;
-}>;
-export declare function wakeCommandGateway(gatewayName: string, gatewayConfig: OpenClawGateway, variables: Record<string, string | undefined>): Promise<{
-    gateway: string;
-    success: boolean;
-    error?: string;
-}>;
+export declare function wakeGateway(gatewayName: string, gatewayConfig: OpenClawGateway, payload: unknown): Promise<WakeResult>;
+export declare function wakeCommandGateway(gatewayName: string, gatewayConfig: OpenClawGateway, variables: Record<string, string | undefined>): Promise<WakeResult>;
 type KillableProcess = {
     pid?: number;
     kill: (signal?: NodeJS.Signals) => void;

package/dist/openclaw/gateway-url-validation.d.ts

@@ -0,0 +1 @@
+export declare function validateGatewayUrl(url: string): boolean;

package/dist/openclaw/reply-listener-discord.d.ts

@@ -0,0 +1,4 @@
+import { ReplyListenerRateLimiter } from "./reply-listener-injection";
+import { type ReplyListenerDaemonState } from "./reply-listener-state";
+import type { OpenClawConfig } from "./types";
+export declare function pollDiscordReplies(config: OpenClawConfig, state: ReplyListenerDaemonState, rateLimiter: ReplyListenerRateLimiter): Promise<void>;

package/dist/openclaw/reply-listener-injection.d.ts

@@ -0,0 +1,10 @@
+import type { OpenClawConfig } from "./types";
+export declare function sanitizeReplyInput(text: string): string;
+export declare class ReplyListenerRateLimiter {
+    private readonly maxPerMinute;
+    private readonly timestamps;
+    private readonly windowMs;
+    constructor(maxPerMinute: number);
+    canProceed(): boolean;
+}
+export declare function injectReplyIntoPane(paneId: string, text: string, platform: string, config: OpenClawConfig): Promise<boolean>;

package/dist/openclaw/reply-listener-log.d.ts

@@ -0,0 +1,2 @@
+export declare function writeSecureReplyListenerFile(filePath: string, content: string): void;
+export declare function logReplyListenerMessage(message: string): void;

package/dist/openclaw/reply-listener-paths.d.ts

@@ -0,0 +1,7 @@
+export declare const REPLY_LISTENER_SECURE_FILE_MODE = 384;
+export declare function getReplyListenerStateDir(): string;
+export declare function getReplyListenerPidFilePath(): string;
+export declare function getReplyListenerStateFilePath(): string;
+export declare function getReplyListenerConfigFilePath(): string;
+export declare function getReplyListenerLogFilePath(): string;
+export declare function ensureReplyListenerStateDir(): void;

package/dist/openclaw/reply-listener-process.d.ts

@@ -0,0 +1,4 @@
+export declare const REPLY_LISTENER_DAEMON_IDENTITY_MARKER = "--openclaw-reply-listener-daemon";
+export declare function createReplyListenerDaemonEnv(extraEnv: Record<string, string>): Record<string, string>;
+export declare function isReplyListenerProcessRunning(pid: number): boolean;
+export declare function isReplyListenerDaemonProcess(pid: number): Promise<boolean>;

package/dist/openclaw/reply-listener-spawn.d.ts

@@ -0,0 +1,5 @@
+export interface ReplyListenerSpawnProcess {
+    pid: number | undefined;
+    unref(): void;
+}
+export declare function spawnReplyListenerDaemon(daemonScript: string, startupToken: string): ReplyListenerSpawnProcess;

package/dist/openclaw/reply-listener-startup.d.ts

@@ -0,0 +1,12 @@
+import type { ReplyListenerDaemonState } from "./reply-listener-state";
+interface WaitForReplyListenerReadyOptions {
+    pid: number;
+    startupToken: string;
+    timeoutMs: number;
+    readState: () => ReplyListenerDaemonState | null;
+    sleep: (ms: number) => Promise<void>;
+}
+export declare function createReplyListenerStartupToken(): string;
+export declare function getReplyListenerStartupTimeoutMs(): number;
+export declare function waitForReplyListenerReady(options: WaitForReplyListenerReadyOptions): Promise<ReplyListenerDaemonState | null>;
+export {};

package/dist/openclaw/reply-listener-state.d.ts

@@ -0,0 +1,29 @@
+import type { OpenClawConfig } from "./types";
+export declare const REPLY_LISTENER_STARTUP_TOKEN_ENV = "OMO_OPENCLAW_REPLY_LISTENER_STARTUP_TOKEN";
+export interface ReplyListenerDaemonState {
+    isRunning: boolean;
+    pid: number | null;
+    startedAt: string;
+    startupToken: string | null;
+    configSignature: string | null;
+    lastPollAt: string | null;
+    telegramLastUpdateId: number | null;
+    discordLastMessageId: string | null;
+    lastDiscordMessageId: string | null;
+    messagesSeen: number;
+    messagesInjected: number;
+    errors: number;
+    lastError?: string;
+}
+export declare function createPendingReplyListenerState(startupToken: string): ReplyListenerDaemonState;
+export declare function readReplyListenerDaemonState(): ReplyListenerDaemonState | null;
+export declare function writeReplyListenerDaemonState(state: ReplyListenerDaemonState): void;
+export declare function readReplyListenerDaemonConfig(): OpenClawConfig | null;
+export declare function writeReplyListenerDaemonConfig(config: OpenClawConfig): void;
+export declare function readReplyListenerPid(): number | null;
+export declare function writeReplyListenerPid(pid: number): void;
+export declare function removeReplyListenerPid(): void;
+export declare function getReplyListenerStartupTokenFromEnv(): string | null;
+export declare function recordReplyListenerPoll(state: ReplyListenerDaemonState, pid: number): void;
+export declare function recordSeenDiscordMessage(state: ReplyListenerDaemonState, messageId: string): void;
+export declare function markReplyListenerStopped(state: ReplyListenerDaemonState | null, error?: string): ReplyListenerDaemonState;

package/dist/openclaw/reply-listener-telegram.d.ts

@@ -0,0 +1,4 @@
+import { ReplyListenerRateLimiter } from "./reply-listener-injection";
+import { type ReplyListenerDaemonState } from "./reply-listener-state";
+import type { OpenClawConfig } from "./types";
+export declare function pollTelegramReplies(config: OpenClawConfig, state: ReplyListenerDaemonState, rateLimiter: ReplyListenerRateLimiter): Promise<void>;

package/dist/openclaw/reply-listener.d.ts

@@ -1,31 +1,18 @@
+import { logReplyListenerMessage } from "./reply-listener-log";
+import { type ReplyListenerDaemonState } from "./reply-listener-state";
 import type { OpenClawConfig } from "./types";
-export declare const DAEMON_IDENTITY_MARKER = "--openclaw-reply-listener-daemon";
-export declare function logReplyListenerMessage(message: string): void;
-interface DaemonState {
-    isRunning: boolean;
-    pid: number | null;
-    startedAt: string;
-    lastPollAt: string | null;
-    telegramLastUpdateId: number | null;
-    discordLastMessageId: string | null;
-    messagesInjected: number;
-    errors: number;
-    lastError?: string;
-}
-export declare function isReplyListenerProcess(pid: number): Promise<boolean>;
 export declare function isDaemonRunning(): Promise<boolean>;
-export declare function sanitizeReplyInput(text: string): string;
 export declare function pollLoop(): Promise<void>;
 export declare function startReplyListener(config: OpenClawConfig): Promise<{
     success: boolean;
     message: string;
-    state?: DaemonState;
+    state?: ReplyListenerDaemonState;
     error?: string;
 }>;
 export declare function stopReplyListener(): Promise<{
     success: boolean;
     message: string;
-    state?: DaemonState;
+    state?: ReplyListenerDaemonState;
     error?: string;
 }>;
-export {};
+export { logReplyListenerMessage };

package/dist/openclaw/runtime-dispatch.d.ts

@@ -0,0 +1,17 @@
+import type { OpenClawConfig, WakeResult } from "./types";
+interface DispatchOpenClawContext {
+    sessionId?: string;
+    projectPath?: string;
+    tmuxPaneId?: string;
+    tmuxSession?: string;
+    replyChannel?: string;
+    replyTarget?: string;
+    replyThread?: string;
+}
+interface DispatchOpenClawEventParams {
+    config: OpenClawConfig;
+    rawEvent: string;
+    context: DispatchOpenClawContext;
+}
+export declare function dispatchOpenClawEvent(params: DispatchOpenClawEventParams): Promise<WakeResult | null>;
+export {};

package/dist/openclaw/types.d.ts

@@ -35,4 +35,8 @@ export interface WakeResult {
     success: boolean;
     error?: string;
     statusCode?: number;
+    messageId?: string;
+    platform?: string;
+    channelId?: string;
+    threadId?: string;
 }

package/dist/plugin/command-execute-before.d.ts

@@ -10,8 +10,10 @@ type CommandExecuteBeforeOutput = {
         text?: string;
         [key: string]: unknown;
     }>;
+    message?: Record<string, unknown>;
 };
+declare const NATIVE_LOOP_TRIGGERED_FLAG = "__omoNativeLoopTriggered";
 export declare function createCommandExecuteBeforeHandler(args: {
     hooks: CreatedHooks;
 }): (input: CommandExecuteBeforeInput, output: CommandExecuteBeforeOutput) => Promise<void>;
-export {};
+export { NATIVE_LOOP_TRIGGERED_FLAG };

package/dist/plugin/tool-registry.d.ts

@@ -1,8 +1,29 @@
 import type { AvailableCategory } from "../agents/dynamic-agent-prompt-builder";
 import type { OhMyOpenCodeConfig } from "../config";
 import type { PluginContext, ToolsRecord } from "./types";
+import { builtinTools, createBackgroundTools, createCallOmoAgent, createLookAt, createSkillMcpTool, createSkillTool, createGrepTools, createGlobTools, createAstGrepTools, createSessionManagerTools, createDelegateTask, discoverCommandsSync, interactive_bash, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, createHashlineEditTool } from "../tools";
 import type { Managers } from "../create-managers";
 import type { SkillContext } from "./skill-context";
+type ToolRegistryFactories = {
+    builtinTools: typeof builtinTools;
+    createBackgroundTools: typeof createBackgroundTools;
+    createCallOmoAgent: typeof createCallOmoAgent;
+    createLookAt: typeof createLookAt;
+    createSkillMcpTool: typeof createSkillMcpTool;
+    createSkillTool: typeof createSkillTool;
+    createGrepTools: typeof createGrepTools;
+    createGlobTools: typeof createGlobTools;
+    createAstGrepTools: typeof createAstGrepTools;
+    createSessionManagerTools: typeof createSessionManagerTools;
+    createDelegateTask: typeof createDelegateTask;
+    discoverCommandsSync: typeof discoverCommandsSync;
+    interactive_bash: typeof interactive_bash;
+    createTaskCreateTool: typeof createTaskCreateTool;
+    createTaskGetTool: typeof createTaskGetTool;
+    createTaskList: typeof createTaskList;
+    createTaskUpdateTool: typeof createTaskUpdateTool;
+    createHashlineEditTool: typeof createHashlineEditTool;
+};
 export type ToolRegistryResult = {
     filteredTools: ToolsRecord;
     taskSystemEnabled: boolean;
@@ -15,4 +36,6 @@ export declare function createToolRegistry(args: {
     skillContext: SkillContext;
     availableCategories: AvailableCategory[];
     interactiveBashEnabled?: boolean;
+    toolFactories?: Partial<ToolRegistryFactories>;
 }): ToolRegistryResult;
+export {};

package/dist/plugin-handlers/agent-priority-order.d.ts

@@ -1 +1,12 @@
+/**
+ * CRITICAL: This is the ONLY source of truth for core agent ordering.
+ * The order is: sisyphus → hephaestus → prometheus → atlas
+ *
+ * DO NOT CHANGE THIS ORDER. Any PR attempting to modify this order
+ * or introduce alternative ordering mechanisms (ZWSP prefixes, sort
+ * shims, etc.) will be rejected.
+ *
+ * See: src/plugin-handlers/AGENTS.md for architectural context.
+ */
+export declare const CANONICAL_CORE_AGENT_ORDER: readonly ["sisyphus", "hephaestus", "prometheus", "atlas"];
 export declare function reorderAgentsByPriority(agents: Record<string, unknown>): Record<string, unknown>;

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

@@ -10,13 +10,18 @@
  * type selector dropdown. Use ` - ` (space-dash-space) instead of `(...)`.
  */
 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.
  * Returns original key if not found.
  */
 export declare function getAgentDisplayName(configKey: string): string;
+/**
+ * Runtime-facing agent name used for OpenCode list ordering.
+ */
 export declare function getAgentListDisplayName(configKey: string): string;
 /**
  * Resolve an agent name (display name or config key) to its lowercase config key.

package/dist/shared/compaction-marker.d.ts

@@ -8,5 +8,6 @@ type CompactionMessageLike = {
 export declare function isCompactionAgent(agent: unknown): boolean;
 export declare function hasCompactionPart(parts: unknown): boolean;
 export declare function isCompactionMessage(message: CompactionMessageLike): boolean;
+export declare function getCompactionPartStorageDir(messageID: string): string;
 export declare function hasCompactionPartInStorage(messageID: string | undefined): boolean;
 export {};

package/dist/shared/migration/migrations-sidecar.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Sidecar state file that tracks applied config migrations outside the user's
+ * config file.
+ *
+ * Why this exists (#3263): users who revert an auto-migrated value (e.g.
+ * `gpt-5.4` → `gpt-5.3-codex`) and then delete the `_migrations` field from
+ * their config would fall into an infinite migration loop — every startup
+ * re-applied the migration because there was no memory of the previous
+ * application. The sidecar remembers applied migrations even when the user
+ * scrubs the config, and only "resets" when the user explicitly deletes both
+ * the config and the sidecar.
+ *
+ * The sidecar lives next to the config file as
+ * `<configFileName>.migrations.json`. One sidecar per config file. The file
+ * format is a flat JSON object:
+ *
+ *     {
+ *       "appliedMigrations": [
+ *         "model-version:openai/gpt-5.3-codex->openai/gpt-5.4",
+ *         "model-version:anthropic/claude-opus-4-5->anthropic/claude-opus-4-6"
+ *       ]
+ *     }
+ */
+export interface MigrationsSidecar {
+    appliedMigrations: string[];
+}
+export declare function getSidecarPath(configPath: string): string;
+/**
+ * Read the set of applied migration keys from the sidecar next to
+ * `configPath`. Returns an empty set on any read or parse failure so the
+ * caller can still trust the return value and safely fall back to the
+ * config's `_migrations` field.
+ */
+export declare function readAppliedMigrations(configPath: string): Set<string>;
+/**
+ * Persist the given set of applied migration keys to the sidecar next to
+ * `configPath`. The sidecar is written atomically. Returns true on success,
+ * false if the write failed (the caller can still proceed — the next
+ * startup will re-run the migration, which is idempotent by design).
+ */
+export declare function writeAppliedMigrations(configPath: string, migrations: Set<string>): boolean;

package/dist/shared/plugin-identity.d.ts

@@ -1,5 +1,7 @@
 export declare const PLUGIN_NAME = "oh-my-openagent";
 export declare const LEGACY_PLUGIN_NAME = "oh-my-opencode";
+export declare const PUBLISHED_PACKAGE_NAME = "oh-my-opencode";
+export declare const ACCEPTED_PACKAGE_NAMES: readonly ["oh-my-opencode", "oh-my-openagent"];
 export declare const CONFIG_BASENAME = "oh-my-openagent";
 export declare const LEGACY_CONFIG_BASENAME = "oh-my-opencode";
 export declare const LOG_FILENAME = "oh-my-opencode.log";

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

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

package/dist/shared/posthog.d.ts

@@ -0,0 +1,14 @@
+import { PostHog } from "posthog-node";
+type PostHogCaptureEvent = Parameters<PostHog["capture"]>[0];
+type PostHogExceptionProperties = Parameters<PostHog["captureException"]>[2];
+type PostHogActivityReason = "run_started" | "plugin_loaded";
+type PostHogClient = {
+    capture: (message: PostHogCaptureEvent) => void;
+    captureException: (error: unknown, distinctId?: string, additionalProperties?: PostHogExceptionProperties) => void;
+    trackActive: (distinctId: string, reason: PostHogActivityReason) => void;
+    shutdown: () => Promise<void>;
+};
+export declare function getPostHogDistinctId(): string;
+export declare function createCliPostHog(): PostHogClient;
+export declare function createPluginPostHog(): PostHogClient;
+export {};

package/dist/shared/shell-env.d.ts

@@ -3,9 +3,13 @@ export type ShellType = "unix" | "powershell" | "cmd" | "csh";
  * Detect the current shell type based on environment variables.
  *
  * Detection priority:
- * 1. PSModulePath → PowerShell
- * 2. SHELL env var → Unix shell
+ * 1. SHELL env var → Unix shell (explicit user choice takes precedence)
+ * 2. PSModulePath → PowerShell
  * 3. Platform fallback → win32: cmd, others: unix
+ *
+ * Note: SHELL is checked before PSModulePath because on Windows, PSModulePath
+ * is always set by the system even when the active shell is Git Bash or WSL.
+ * An explicit SHELL variable indicates the user's chosen shell overrides that.
  */
 export declare function detectShellType(): ShellType;
 /**

package/dist/testing/module-mock-lifecycle.d.ts

@@ -0,0 +1,21 @@
+type MockModuleFactory = () => Record<string, unknown>;
+type MockApi = {
+    module: (specifier: string, factory: MockModuleFactory) => unknown;
+    restore: () => unknown;
+};
+type ModuleLoadResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: Error;
+};
+type ModuleMockLifecycleOptions = {
+    getCallerUrl?: () => string;
+    resolveSpecifier?: (specifier: string, callerUrl: string) => string;
+    loadOriginalModule?: (specifier: string, callerUrl: string) => ModuleLoadResult;
+};
+export declare function installModuleMockLifecycle(mockApi: MockApi, options?: ModuleMockLifecycleOptions): {
+    restoreModuleMocks: () => void;
+};
+export {};

package/dist/tools/session-manager/tools.d.ts

@@ -1,3 +1,21 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import { type ToolDefinition } from "@opencode-ai/plugin/tool";
-export declare function createSessionManagerTools(ctx: PluginInput): Record<string, ToolDefinition>;
+import { getAllSessions, getMainSessions, getSessionInfo, readSessionMessages, readSessionTodos, sessionExists, setStorageClient } from "./storage";
+import { filterSessionsByDate, formatSessionInfo, formatSessionList, formatSessionMessages, formatSearchResults, searchInSession } from "./session-formatter";
+type SessionManagerToolDeps = {
+    getAllSessions: typeof getAllSessions;
+    getMainSessions: typeof getMainSessions;
+    getSessionInfo: typeof getSessionInfo;
+    readSessionMessages: typeof readSessionMessages;
+    readSessionTodos: typeof readSessionTodos;
+    sessionExists: typeof sessionExists;
+    setStorageClient: typeof setStorageClient;
+    filterSessionsByDate: typeof filterSessionsByDate;
+    formatSessionInfo: typeof formatSessionInfo;
+    formatSessionList: typeof formatSessionList;
+    formatSessionMessages: typeof formatSessionMessages;
+    formatSearchResults: typeof formatSearchResults;
+    searchInSession: typeof searchInSession;
+};
+export declare function createSessionManagerTools(ctx: PluginInput, deps?: Partial<SessionManagerToolDeps>): Record<string, ToolDefinition>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "3.16.0",
+  "version": "3.17.1",
   "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",
@@ -68,6 +68,7 @@
     "jsonc-parser": "^3.3.1",
     "picocolors": "^1.1.1",
     "picomatch": "^4.0.2",
+    "posthog-node": "^5.29.2",
     "vscode-jsonrpc": "^8.2.0",
     "zod": "^4.3.0"
   },
@@ -78,17 +79,17 @@
     "typescript": "^5.7.3"
   },
   "optionalDependencies": {
-    "oh-my-opencode-darwin-arm64": "3.16.0",
-    "oh-my-opencode-darwin-x64": "3.16.0",
-    "oh-my-opencode-darwin-x64-baseline": "3.16.0",
-    "oh-my-opencode-linux-arm64": "3.16.0",
-    "oh-my-opencode-linux-arm64-musl": "3.16.0",
-    "oh-my-opencode-linux-x64": "3.16.0",
-    "oh-my-opencode-linux-x64-baseline": "3.16.0",
-    "oh-my-opencode-linux-x64-musl": "3.16.0",
-    "oh-my-opencode-linux-x64-musl-baseline": "3.16.0",
-    "oh-my-opencode-windows-x64": "3.16.0",
-    "oh-my-opencode-windows-x64-baseline": "3.16.0"
+    "oh-my-opencode-darwin-arm64": "3.17.1",
+    "oh-my-opencode-darwin-x64": "3.17.1",
+    "oh-my-opencode-darwin-x64-baseline": "3.17.1",
+    "oh-my-opencode-linux-arm64": "3.17.1",
+    "oh-my-opencode-linux-arm64-musl": "3.17.1",
+    "oh-my-opencode-linux-x64": "3.17.1",
+    "oh-my-opencode-linux-x64-baseline": "3.17.1",
+    "oh-my-opencode-linux-x64-musl": "3.17.1",
+    "oh-my-opencode-linux-x64-musl-baseline": "3.17.1",
+    "oh-my-opencode-windows-x64": "3.17.1",
+    "oh-my-opencode-windows-x64-baseline": "3.17.1"
   },
   "overrides": {},
   "trustedDependencies": [