opencode-matrixx-v2 0.0.0-stage → 1.0.0

package/dist/features/task-storage/types.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export declare const TaskStatusSchema: z.ZodEnum<{
+    deleted: "deleted";
+    pending: "pending";
+    completed: "completed";
+    in_progress: "in_progress";
+}>;
+export type TaskStatus = z.infer<typeof TaskStatusSchema>;
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    subject: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<{
+        deleted: "deleted";
+        pending: "pending";
+        completed: "completed";
+        in_progress: "in_progress";
+    }>;
+    activeForm: z.ZodOptional<z.ZodString>;
+    blocks: z.ZodArray<z.ZodString>;
+    blockedBy: z.ZodArray<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    repoURL: z.ZodOptional<z.ZodString>;
+    parentID: z.ZodOptional<z.ZodString>;
+    threadID: z.ZodOptional<z.ZodString>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Task = z.infer<typeof TaskSchema>;

package/dist/features/task-toast-manager/index.d.ts

@@ -0,0 +1,2 @@
+export { getTaskToastManager, initTaskToastManager, TaskToastManager } from "./manager";
+export type { ModelFallbackInfo, TaskStatus, TaskToastOptions, TrackedTask } from "./types";

package/dist/features/task-toast-manager/manager.d.ts

@@ -0,0 +1,55 @@
+import type { ConcurrencyManager } from "../background-agent/concurrency";
+import type { ModelFallbackInfo, TaskStatus, TrackedTask } from "./types";
+export declare class TaskToastManager {
+    private tasks;
+    private concurrencyManager?;
+    constructor(concurrencyManager?: ConcurrencyManager);
+    setConcurrencyManager(manager: ConcurrencyManager): void;
+    addTask(task: {
+        id: string;
+        description: string;
+        agent: string;
+        isBackground: boolean;
+        status?: TaskStatus;
+        category?: string;
+        skills?: string[];
+        modelInfo?: ModelFallbackInfo;
+    }): void;
+    /**
+     * Update task status
+     */
+    updateTask(id: string, status: TaskStatus): void;
+    /**
+     * Remove completed/error task
+     */
+    removeTask(id: string): void;
+    /**
+     * Get all running tasks (newest first)
+     */
+    getRunningTasks(): TrackedTask[];
+    /**
+     * Get all queued tasks
+     */
+    getQueuedTasks(): TrackedTask[];
+    /**
+     * Format duration since task started
+     */
+    private formatDuration;
+    private getConcurrencyInfo;
+    private buildTaskListMessage;
+    /**
+     * Show consolidated toast with all running/queued tasks
+     */
+    private showTaskListToast;
+    /**
+     * Show task completion toast
+     */
+    showCompletionToast(task: {
+        id: string;
+        description: string;
+        duration: string;
+    }): void;
+}
+export declare function getTaskToastManager(): TaskToastManager | null;
+export declare function initTaskToastManager(concurrencyManager?: ConcurrencyManager): TaskToastManager;
+export declare function _resetTaskToastManagerForTesting(): void;

package/dist/features/task-toast-manager/types.d.ts

@@ -0,0 +1,24 @@
+import type { ModelResolutionProvenance } from "../../shared/model-resolution-pipeline";
+export type TaskStatus = "running" | "queued" | "completed" | "error";
+export interface ModelFallbackInfo {
+    model: string;
+    type: "user-defined" | "inherited" | "category-default" | "system-default";
+    source?: ModelResolutionProvenance;
+}
+export interface TrackedTask {
+    id: string;
+    description: string;
+    agent: string;
+    status: TaskStatus;
+    startedAt: Date;
+    isBackground: boolean;
+    category?: string;
+    skills?: string[];
+    modelInfo?: ModelFallbackInfo;
+}
+export interface TaskToastOptions {
+    title: string;
+    message: string;
+    variant: "info" | "success" | "warning" | "error";
+    duration?: number;
+}

package/dist/features/tool-metadata-store/call-id.d.ts

@@ -0,0 +1,6 @@
+export interface ToolCallIDSource {
+    callID?: string;
+    callId?: string;
+    call_id?: string;
+}
+export declare function resolveToolCallID(ctx: ToolCallIDSource): string | undefined;

package/dist/features/tool-metadata-store/index.d.ts

@@ -0,0 +1,4 @@
+export type { ToolCallIDSource } from "./call-id";
+export { resolveToolCallID } from "./call-id";
+export type { PendingToolMetadata } from "./store";
+export { clearPendingStore, consumeToolMetadata, getPendingStoreSize, storeToolMetadata, } from "./store";

package/dist/features/tool-metadata-store/store.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pending tool metadata store.
+ *
+ * OpenCode's `fromPlugin()` wrapper always replaces the metadata returned by
+ * plugin tools with `{ truncated, outputPath }`, discarding any sessionId,
+ * title, or custom metadata set during `execute()`.
+ *
+ * This store captures metadata written via `ctx.metadata()` inside execute(),
+ * then the `tool.execute.after` hook consumes it and merges it back into the
+ * result *before* the processor writes the final part to the session store.
+ *
+ * Flow:
+ *   execute() → storeToolMetadata(sessionID, callID, data)
+ *   fromPlugin() → overwrites metadata with { truncated }
+ *   tool.execute.after → consumeToolMetadata(sessionID, callID) → merges back
+ *   processor → Session.updatePart(status:"completed", metadata: result.metadata)
+ */
+export interface PendingToolMetadata {
+    title?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Store metadata to be restored after fromPlugin() overwrites it.
+ * Called from tool execute() functions alongside ctx.metadata().
+ */
+export declare function storeToolMetadata(sessionID: string, callID: string, data: PendingToolMetadata): void;
+/**
+ * Consume stored metadata (one-time read, removes from store).
+ * Called from tool.execute.after hook.
+ */
+export declare function consumeToolMetadata(sessionID: string, callID: string): PendingToolMetadata | undefined;
+/**
+ * Get current store size (for testing/debugging).
+ */
+export declare function getPendingStoreSize(): number;
+/**
+ * Clear all pending metadata (for testing).
+ */
+export declare function clearPendingStore(): void;

package/dist/features/ultrawork-state/index.d.ts

@@ -0,0 +1 @@
+export { _resetUltraworkStateForTesting, clearUltraworkState, disableUltrawork, enableUltrawork, getUltraworkState, } from "./manager";

package/dist/features/ultrawork-state/manager.d.ts

@@ -0,0 +1,6 @@
+export declare function getUltraworkState(sessionID: string): "enabled" | "disabled" | undefined;
+export declare function enableUltrawork(sessionID: string): void;
+export declare function disableUltrawork(sessionID: string): void;
+export declare function clearUltraworkState(sessionID: string): void;
+/** @internal */
+export declare function _resetUltraworkStateForTesting(): void;

package/dist/hooks/agent-usage-reminder/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const AGENT_USAGE_REMINDER_STORAGE: string;
+export declare const TARGET_TOOLS: Set<string>;
+export declare const AGENT_TOOLS: Set<string>;
+export declare const MAX_AGENT_USAGE_REMINDERS = 3;
+export declare const REMINDER_MESSAGE = "\n[Agent Usage Reminder]\n\nYou called a search/fetch tool directly without leveraging specialized agents.\n\nRECOMMENDED: Use task with explore/librarian agents for better results:\n\n```\n// Parallel exploration - fire multiple agents simultaneously\ntask(agent=\"trinity\", prompt=\"Find all files matching pattern X\")\ntask(agent=\"trinity\", prompt=\"Search for implementation of Y\") \ntask(agent=\"operator\", prompt=\"Lookup documentation for Z\")\n\n// Then continue your work while they run in background\n// System will notify you when each completes\n```\n\nWHY:\n- Agents can perform deeper, more thorough searches\n- Background tasks run in parallel, saving time\n- Specialized agents have domain expertise\n- Reduces context window usage in main session\n\nALWAYS prefer: Multiple parallel task calls > Direct tool calls\n";

package/dist/hooks/agent-usage-reminder/hook.d.ts

@@ -0,0 +1,16 @@
+import type { MatrixxContext, V2Event } from "../../plugin/context";
+interface ToolExecuteInput {
+    tool: string;
+    sessionID: string;
+    callID: string;
+}
+interface ToolExecuteOutput {
+    title: string;
+    output: string;
+    metadata: unknown;
+}
+export declare function createAgentUsageReminderHook(_ctx: MatrixxContext): {
+    "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
+    event: (event: V2Event) => Promise<void>;
+};
+export {};

package/dist/hooks/agent-usage-reminder/storage.d.ts

@@ -0,0 +1,4 @@
+import type { AgentUsageState } from "./types";
+export declare function loadAgentUsageState(sessionID: string): AgentUsageState | null;
+export declare function saveAgentUsageState(state: AgentUsageState): void;
+export declare function clearAgentUsageState(sessionID: string): void;

package/dist/hooks/agent-usage-reminder/types.d.ts

@@ -0,0 +1,6 @@
+export interface AgentUsageState {
+    sessionID: string;
+    agentUsed: boolean;
+    reminderCount: number;
+    updatedAt: number;
+}

package/dist/hooks/anthropic-effort/hook.d.ts

@@ -0,0 +1,26 @@
+interface ChatParamsInput {
+    sessionID: string;
+    agent: {
+        name?: string;
+    };
+    model: {
+        providerID: string;
+        modelID: string;
+    };
+    provider: {
+        id: string;
+    };
+    message: {
+        variant?: string;
+    };
+}
+interface ChatParamsOutput {
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    options: Record<string, unknown>;
+}
+export declare function createAnthropicEffortHook(): {
+    "chat.params": (input: ChatParamsInput, output: ChatParamsOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/auto-slash-command/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const HOOK_NAME: "auto-slash-command";
+export declare const AUTO_SLASH_COMMAND_TAG_OPEN = "<auto-slash-command>";
+export declare const AUTO_SLASH_COMMAND_TAG_CLOSE = "</auto-slash-command>";
+export declare const SLASH_COMMAND_PATTERN: RegExp;
+export declare const EXCLUDED_COMMANDS: Set<string>;

package/dist/hooks/auto-slash-command/detector.d.ts

@@ -0,0 +1,13 @@
+import type { ParsedSlashCommand } from "./types";
+export declare function removeCodeBlocks(text: string): string;
+export declare function parseSlashCommand(text: string): ParsedSlashCommand | null;
+export declare function isExcludedCommand(command: string): boolean;
+export declare function detectSlashCommand(text: string): ParsedSlashCommand | null;
+export declare function extractPromptText(parts: Array<{
+    type: string;
+    text?: string;
+}>): string;
+export declare function findSlashCommandPartIndex(parts: Array<{
+    type: string;
+    text?: string;
+}>): number;

package/dist/hooks/auto-slash-command/executor.d.ts

@@ -0,0 +1,23 @@
+import type { BuiltinSkill } from "../../skills";
+import type { ParsedSlashCommand } from "./types";
+export interface ExecutorOptions {
+    skills?: BuiltinSkill[];
+}
+/**
+ * Ownership rule: the hook expands only matrixx-owned scopes (builtin,
+ * markdown command dirs, skills). Plugin-scope commands belong to other
+ * plugins and must fall through so the owning plugin handles them natively —
+ * claiming them renders instruction-less blocks (e.g. /dcp-compress). Empty
+ * templates are declined in every scope for the same reason.
+ */
+export declare function isHookOwnedCommand(cmd: {
+    scope: string;
+    content?: string;
+}): boolean;
+interface ExecuteResult {
+    success: boolean;
+    replacementText?: string;
+    error?: string;
+}
+export declare function executeSlashCommand(parsed: ParsedSlashCommand, options?: ExecutorOptions): Promise<ExecuteResult>;
+export {};

package/dist/hooks/auto-slash-command/hook.d.ts

@@ -0,0 +1,9 @@
+import type { BuiltinSkill } from "../../skills";
+import type { AutoSlashCommandHookInput, AutoSlashCommandHookOutput, CommandExecuteBeforeInput, CommandExecuteBeforeOutput } from "./types";
+export interface AutoSlashCommandHookOptions {
+    skills?: BuiltinSkill[];
+}
+export declare function createAutoSlashCommandHook(options?: AutoSlashCommandHookOptions): {
+    "chat.message": (input: AutoSlashCommandHookInput, output: AutoSlashCommandHookOutput) => Promise<void>;
+    "command.execute.before": (input: CommandExecuteBeforeInput, output: CommandExecuteBeforeOutput) => Promise<void>;
+};

package/dist/hooks/auto-slash-command/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./constants";
+export * from "./detector";
+export * from "./executor";
+export type { AutoSlashCommandHookOptions } from "./hook";
+export { createAutoSlashCommandHook } from "./hook";
+export * from "./types";

package/dist/hooks/auto-slash-command/types.d.ts

@@ -0,0 +1,34 @@
+export interface AutoSlashCommandHookInput {
+    sessionID: string;
+    agent?: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+    messageID?: string;
+}
+export interface AutoSlashCommandHookOutput {
+    message: Record<string, unknown>;
+    parts: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+}
+export interface ParsedSlashCommand {
+    command: string;
+    args: string;
+    raw: string;
+}
+export interface CommandExecuteBeforeInput {
+    command: string;
+    sessionID: string;
+    arguments: string;
+}
+export interface CommandExecuteBeforeOutput {
+    parts: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+}

package/dist/hooks/auto-update-checker/cache.d.ts

@@ -0,0 +1 @@
+export declare function invalidatePackage(packageName?: string): boolean;

package/dist/hooks/auto-update-checker/checker/cached-version.d.ts

@@ -0,0 +1 @@
+export declare function getCachedVersion(): string | null;

package/dist/hooks/auto-update-checker/checker/check-for-update.d.ts

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

package/dist/hooks/auto-update-checker/checker/config-paths.d.ts

@@ -0,0 +1 @@
+export declare function getConfigPaths(directory: string): string[];

package/dist/hooks/auto-update-checker/checker/jsonc-strip.d.ts

@@ -0,0 +1 @@
+export declare function stripJsonComments(json: string): string;

package/dist/hooks/auto-update-checker/checker/latest-version.d.ts

@@ -0,0 +1 @@
+export declare function getLatestVersion(channel?: string): Promise<string | null>;

package/dist/hooks/auto-update-checker/checker/local-dev-path.d.ts

@@ -0,0 +1,2 @@
+export declare function isLocalDevMode(directory: string): boolean;
+export declare function getLocalDevPath(directory: string): string | null;

package/dist/hooks/auto-update-checker/checker/local-dev-version.d.ts

@@ -0,0 +1 @@
+export declare function getLocalDevVersion(directory: string): string | null;

package/dist/hooks/auto-update-checker/checker/package-json-locator.d.ts

@@ -0,0 +1 @@
+export declare function findPackageJsonUp(startPath: string): string | null;

package/dist/hooks/auto-update-checker/checker/pinned-version-updater.d.ts

@@ -0,0 +1,2 @@
+export declare function updatePinnedVersion(configPath: string, oldEntry: string, newVersion: string): boolean;
+export declare function revertPinnedVersion(configPath: string, failedVersion: string, originalEntry: string): boolean;

package/dist/hooks/auto-update-checker/checker/plugin-entry.d.ts

@@ -0,0 +1,7 @@
+export interface PluginEntryInfo {
+    entry: string;
+    isPinned: boolean;
+    pinnedVersion: string | null;
+    configPath: string;
+}
+export declare function findPluginEntry(directory: string): PluginEntryInfo | null;

package/dist/hooks/auto-update-checker/checker.d.ts

@@ -0,0 +1,8 @@
+export { getCachedVersion } from "./checker/cached-version";
+export { checkForUpdate } from "./checker/check-for-update";
+export { getLatestVersion } from "./checker/latest-version";
+export { getLocalDevPath, isLocalDevMode } from "./checker/local-dev-path";
+export { getLocalDevVersion } from "./checker/local-dev-version";
+export { revertPinnedVersion, updatePinnedVersion } from "./checker/pinned-version-updater";
+export type { PluginEntryInfo } from "./checker/plugin-entry";
+export { findPluginEntry } from "./checker/plugin-entry";

package/dist/hooks/auto-update-checker/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const PACKAGE_NAME = "opencode-matrixx-v2";
+export declare const LEGACY_PACKAGE_NAME = "matrixx";
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org/-/package/opencode-matrixx-v2/dist-tags";
+export declare const NPM_FETCH_TIMEOUT = 5000;
+export declare function getWindowsAppdataDir(): string | null;
+export declare const USER_CONFIG_DIR: string;
+export declare const USER_OPENCODE_CONFIG: string;
+export declare const USER_OPENCODE_CONFIG_JSONC: string;
+export declare const INSTALLED_PACKAGE_JSON: string;

package/dist/hooks/auto-update-checker/hook/background-update-check.d.ts

@@ -0,0 +1,2 @@
+import type { MatrixxContext } from "../../../plugin/context";
+export declare function runBackgroundUpdateCheck(ctx: MatrixxContext, autoUpdate: boolean, getToastMessage: (isUpdate: boolean, latestVersion?: string) => string): Promise<void>;

package/dist/hooks/auto-update-checker/hook/config-errors-toast.d.ts

@@ -0,0 +1,2 @@
+import type { MatrixxContext } from "../../../plugin/context";
+export declare function showConfigErrorsIfAny(_ctx: MatrixxContext): Promise<void>;

package/dist/hooks/auto-update-checker/hook/connected-providers-status.d.ts

@@ -0,0 +1,2 @@
+import type { MatrixxContext } from "../../../plugin/context";
+export declare function updateAndShowConnectedProvidersCacheStatus(_ctx: MatrixxContext): Promise<void>;

package/dist/hooks/auto-update-checker/hook/model-cache-warning.d.ts

@@ -0,0 +1,2 @@
+import type { MatrixxContext } from "../../../plugin/context";
+export declare function showModelCacheWarningIfNeeded(_ctx: MatrixxContext): Promise<void>;

package/dist/hooks/auto-update-checker/hook/spinner-toast.d.ts

@@ -0,0 +1,2 @@
+import type { MatrixxContext } from "../../../plugin/context";
+export declare function showSpinnerToast(_ctx: MatrixxContext, version: string, message: string): Promise<void>;

package/dist/hooks/auto-update-checker/hook/startup-toasts.d.ts

@@ -0,0 +1,3 @@
+import type { MatrixxContext } from "../../../plugin/context";
+export declare function showVersionToast(ctx: MatrixxContext, version: string | null, message: string): Promise<void>;
+export declare function showLocalDevToast(ctx: MatrixxContext, version: string | null, isMorpheusEnabled: boolean): Promise<void>;

package/dist/hooks/auto-update-checker/hook/update-toasts.d.ts

@@ -0,0 +1,3 @@
+import type { MatrixxContext } from "../../../plugin/context";
+export declare function showUpdateAvailableToast(_ctx: MatrixxContext, latestVersion: string, getToastMessage: (isUpdate: boolean, latestVersion?: string) => string): Promise<void>;
+export declare function showAutoUpdatedToast(_ctx: MatrixxContext, oldVersion: string, newVersion: string): Promise<void>;

package/dist/hooks/auto-update-checker/hook.d.ts

@@ -0,0 +1,5 @@
+import type { MatrixxContext, V2Event } from "../../plugin/context";
+import type { AutoUpdateCheckerOptions } from "./types";
+export declare function createAutoUpdateCheckerHook(ctx: MatrixxContext, options?: AutoUpdateCheckerOptions): {
+    event: (event: V2Event) => void;
+};

package/dist/hooks/auto-update-checker/index.d.ts

@@ -0,0 +1,5 @@
+export { invalidatePackage } from "./cache";
+export { checkForUpdate } from "./checker";
+export { createAutoUpdateCheckerHook } from "./hook";
+export type { AutoUpdateCheckerOptions, UpdateCheckResult } from "./types";
+export { extractChannel, isDistTag, isPrereleaseOrDistTag, isPrereleaseVersion, } from "./version-channel";

package/dist/hooks/auto-update-checker/types.d.ts

@@ -0,0 +1,25 @@
+export interface NpmDistTags {
+    latest: string;
+    [key: string]: string;
+}
+export interface OpencodeConfig {
+    plugin?: string[];
+    [key: string]: unknown;
+}
+export interface PackageJson {
+    version: string;
+    name?: string;
+    [key: string]: unknown;
+}
+export interface UpdateCheckResult {
+    needsUpdate: boolean;
+    currentVersion: string | null;
+    latestVersion: string | null;
+    isLocalDev: boolean;
+    isPinned: boolean;
+}
+export interface AutoUpdateCheckerOptions {
+    showStartupToast?: boolean;
+    isMorpheusEnabled?: boolean;
+    autoUpdate?: boolean;
+}

package/dist/hooks/auto-update-checker/version-channel.d.ts

@@ -0,0 +1,4 @@
+export declare function isPrereleaseVersion(version: string): boolean;
+export declare function isDistTag(version: string): boolean;
+export declare function isPrereleaseOrDistTag(pinnedVersion: string | null): boolean;
+export declare function extractChannel(version: string | null): string;

package/dist/hooks/background-notification/hook.d.ts

@@ -0,0 +1,12 @@
+import type { BackgroundManager } from "../../features/background-agent";
+import type { V2Event } from "../../plugin/context";
+/**
+ * Background notification hook - handles event routing to BackgroundManager.
+ *
+ * Notifications are now delivered directly via session.prompt({ noReply })
+ * from the manager, so this hook only needs to handle event routing.
+ * Thin router: logs the routing decision, then forwards unchanged.
+ */
+export declare function createBackgroundNotificationHook(manager: BackgroundManager): {
+    event: (event: V2Event) => Promise<void>;
+};

package/dist/hooks/background-notification/types.d.ts

@@ -0,0 +1,4 @@
+import type { BackgroundTask } from "../../features/background-agent";
+export interface BackgroundNotificationHookConfig {
+    formatNotification?: (tasks: BackgroundTask[]) => string;
+}

package/dist/hooks/background-task-blocker/hook.d.ts

@@ -0,0 +1,10 @@
+export declare function createBackgroundTaskBlockerHook(): {
+    "tool.execute.before": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, _output: {
+        args: Record<string, unknown>;
+        message?: string;
+    }) => Promise<void>;
+};

package/dist/hooks/bash-file-read-guard.d.ts

@@ -0,0 +1,2 @@
+import type { Hooks } from "../plugin/legacy-hooks";
+export declare function createBashFileReadGuardHook(): Hooks;

package/dist/hooks/category-skill-reminder/formatter.d.ts

@@ -0,0 +1,2 @@
+import type { AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
+export declare function buildReminderMessage(availableSkills: AvailableSkill[]): string;

package/dist/hooks/category-skill-reminder/hook.d.ts

@@ -0,0 +1,19 @@
+import type { AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
+import type { MatrixxContext } from "../../plugin/context";
+interface ToolExecuteInput {
+    tool: string;
+    sessionID: string;
+    callID: string;
+    agent?: string;
+}
+interface ToolExecuteOutput {
+    title: string;
+    output: string;
+    metadata: unknown;
+}
+import type { V2Event } from "../../plugin/context";
+export declare function createCategorySkillReminderHook(ctx: MatrixxContext, availableSkills?: AvailableSkill[]): {
+    "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
+    event: (event: V2Event) => Promise<void>;
+};
+export {};

package/dist/hooks/comment-checker/cli-runner.d.ts

@@ -0,0 +1,20 @@
+import type { PendingCall } from "./types";
+export declare function initializeCommentCheckerCli(debugLog: (...args: unknown[]) => void): void;
+export declare function getCommentCheckerCliPathPromise(): Promise<string | null> | null;
+export declare function processWithCli(input: {
+    tool: string;
+    sessionID: string;
+    callID: string;
+}, pendingCall: PendingCall, output: {
+    output: string;
+}, cliPath: string, customPrompt: string | undefined, debugLog: (...args: unknown[]) => void): Promise<void>;
+interface ApplyPatchEdit {
+    filePath: string;
+    before: string;
+    after: string;
+}
+export declare function processApplyPatchEditsWithCli(sessionID: string, edits: ApplyPatchEdit[], output: {
+    output: string;
+}, cliPath: string, customPrompt: string | undefined, debugLog: (...args: unknown[]) => void): Promise<void>;
+export declare function isCliPathUsable(cliPath: string | null): cliPath is string;
+export {};

package/dist/hooks/comment-checker/cli.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Asynchronously get comment-checker binary path.
+ * Will trigger lazy download if binary not found.
+ */
+export declare function getCommentCheckerPath(): Promise<string | null>;
+/**
+ * Synchronously get comment-checker path (no download).
+ * Returns cached path or searches known locations.
+ */
+export declare function getCommentCheckerPathSync(): string | null;
+/**
+ * Start background initialization.
+ * Call this early to trigger download while other init happens.
+ */
+export declare function startBackgroundInit(): void;
+export interface HookInput {
+    session_id: string;
+    tool_name: string;
+    transcript_path: string;
+    cwd: string;
+    hook_event_name: string;
+    tool_input: {
+        file_path?: string;
+        content?: string;
+        old_string?: string;
+        new_string?: string;
+        edits?: Array<{
+            old_string: string;
+            new_string: string;
+        }>;
+    };
+    tool_response?: unknown;
+}
+export interface CheckResult {
+    hasComments: boolean;
+    message: string;
+}
+/**
+ * Run comment-checker CLI with given input.
+ * @param input Hook input to check
+ * @param cliPath Optional explicit path to CLI binary
+ * @param customPrompt Optional custom prompt to replace default warning message
+ */
+export declare function runCommentChecker(input: HookInput, cliPath?: string, customPrompt?: string): Promise<CheckResult>;
+/**
+ * Check if CLI is available (sync check, no download).
+ */
+export declare function isCliAvailable(): boolean;
+/**
+ * Check if CLI will be available (async, may trigger download).
+ */
+export declare function ensureCliAvailable(): Promise<boolean>;