@oh-my-pi/pi-coding-agent 15.1.0 → 15.1.2

package/dist/types/cli/grievances-cli.d.ts

@@ -0,0 +1,25 @@
+export interface ListGrievancesOptions {
+    limit: number;
+    tool?: string;
+    json: boolean;
+}
+export interface CleanGrievancesOptions {
+    /** Delete a single grievance by id. */
+    id?: number;
+    /** Delete every grievance recorded for this tool name. */
+    tool?: string;
+    /** Delete every grievance regardless of tool/id. */
+    all?: boolean;
+    /** Output the deletion count as JSON instead of a status message. */
+    json?: boolean;
+}
+export declare function listGrievances(options: ListGrievancesOptions): Promise<void>;
+/**
+ * Delete grievances from the auto-QA database.
+ *
+ * Selectors are mutually exclusive in intent — exactly one of `id`, `tool`, or
+ * `all` is required. Multiple selectors are rejected to prevent ambiguous deletes
+ * (e.g. `--id 5 --all` would be a footgun). Returns silently when the database
+ * does not exist yet.
+ */
+export declare function cleanGrievances(options: CleanGrievancesOptions): Promise<void>;

package/dist/types/cli/initial-message.d.ts

@@ -0,0 +1,17 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
+import type { Args } from "./args";
+export interface InitialMessageInput {
+    parsed: Args;
+    fileText?: string;
+    fileImages?: ImageContent[];
+    stdinContent?: string;
+}
+export interface InitialMessageResult {
+    initialMessage?: string;
+    initialImages?: ImageContent[];
+}
+/**
+ * Combine stdin content, @file text, and the first CLI message into a single
+ * initial prompt for non-interactive mode.
+ */
+export declare function buildInitialMessage({ parsed, fileText, fileImages, stdinContent }: InitialMessageInput): InitialMessageResult;

package/dist/types/cli/list-models.d.ts

@@ -0,0 +1,30 @@
+import type { ModelRegistry } from "../config/model-registry";
+/**
+ * List available models, optionally filtered by search pattern
+ */
+export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string): Promise<void>;
+/**
+ * Options for the `--list-models` command entry point.
+ */
+export interface RunListModelsOptions {
+    modelRegistry: ModelRegistry;
+    cwd: string;
+    /** CLI-supplied extension paths (e.g. from `-e <path>`). */
+    additionalExtensionPaths?: string[];
+    /** Extension paths configured under `extensions:` in user settings. */
+    settingsExtensions?: string[];
+    /** Disabled extension ids from settings (`disabledExtensions`). */
+    disabledExtensionIds?: string[];
+    /** When true, skip discovery and only load `additionalExtensionPaths`. */
+    disableExtensionDiscovery?: boolean;
+    searchPattern?: string;
+}
+/**
+ * Loads extensions (CLI `-e` paths and `settings.extensions`) and surfaces
+ * any provider/model registrations on the supplied `modelRegistry` before
+ * delegating to {@link listModels}. This is the single entry point used by
+ * `--list-models` and exists to ensure extension-contributed providers are
+ * visible in the listing (issue #905). The load is intentionally narrow:
+ * no agent loop, no MCP servers, no custom-tool registration.
+ */
+export declare function runListModelsCommand(options: RunListModelsOptions): Promise<void>;

package/dist/types/cli/plugin-cli.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Plugin CLI command handlers.
+ *
+ * Handles `omp plugin <command>` subcommands for plugin lifecycle management.
+ */
+export type PluginAction = "install" | "uninstall" | "list" | "link" | "doctor" | "features" | "config" | "enable" | "disable" | "marketplace" | "discover" | "upgrade";
+export interface PluginCommandArgs {
+    action: PluginAction;
+    args: string[];
+    flags: {
+        json?: boolean;
+        fix?: boolean;
+        force?: boolean;
+        dryRun?: boolean;
+        local?: boolean;
+        enable?: string;
+        disable?: string;
+        set?: string;
+        scope?: "user" | "project";
+    };
+}
+/**
+ * Parse plugin subcommand arguments.
+ * Returns undefined if not a plugin command.
+ */
+export declare function parsePluginArgs(args: string[]): PluginCommandArgs | undefined;
+export { classifyInstallTarget } from "./classify-install-target";
+/**
+ * Run a plugin command.
+ */
+export declare function runPluginCommand(cmd: PluginCommandArgs): Promise<void>;
+export declare function printPluginHelp(): void;

package/dist/types/cli/read-cli.d.ts

@@ -0,0 +1,4 @@
+export interface ReadCommandArgs {
+    path: string;
+}
+export declare function runReadCommand(cmd: ReadCommandArgs): Promise<void>;

package/dist/types/cli/session-picker.d.ts

@@ -0,0 +1,3 @@
+import type { SessionInfo } from "../session/session-manager";
+/** Show TUI session selector and return selected session path or null if cancelled */
+export declare function selectSession(sessions: SessionInfo[]): Promise<string | null>;

package/dist/types/cli/setup-cli.d.ts

@@ -0,0 +1,24 @@
+export type SetupComponent = "python" | "stt";
+export interface SetupCommandArgs {
+    component: SetupComponent;
+    flags: {
+        json?: boolean;
+        check?: boolean;
+    };
+}
+/**
+ * Parse setup subcommand arguments.
+ * Returns undefined if not a setup command.
+ */
+export declare function parseSetupArgs(args: string[]): SetupCommandArgs | undefined;
+/**
+ * Install Python packages using uv (preferred) or pip.
+ */
+/**
+ * Run the setup command.
+ */
+export declare function runSetupCommand(cmd: SetupCommandArgs): Promise<void>;
+/**
+ * Print setup command help.
+ */
+export declare function printSetupHelp(): void;

package/dist/types/cli/shell-cli.d.ts

@@ -0,0 +1,8 @@
+export interface ShellCommandArgs {
+    cwd?: string;
+    timeoutMs?: number;
+    noSnapshot?: boolean;
+}
+export declare function parseShellArgs(args: string[]): ShellCommandArgs | undefined;
+export declare function runShellCommand(cmd: ShellCommandArgs): Promise<void>;
+export declare function printShellHelp(): void;

package/dist/types/cli/ssh-cli.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SSH CLI command handlers.
+ *
+ * Handles `omp ssh <command>` subcommands for SSH host configuration management.
+ */
+export type SSHAction = "add" | "remove" | "list";
+export interface SSHCommandArgs {
+    action: SSHAction;
+    args: string[];
+    flags: {
+        json?: boolean;
+        host?: string;
+        user?: string;
+        port?: string;
+        key?: string;
+        desc?: string;
+        compat?: boolean;
+        scope?: "project" | "user";
+    };
+}
+export declare function runSSHCommand(cmd: SSHCommandArgs): Promise<void>;

package/dist/types/cli/stats-cli.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Stats CLI command handlers.
+ *
+ * Handles `omp stats` subcommand for viewing AI usage statistics.
+ */
+export interface StatsCommandArgs {
+    port: number;
+    json: boolean;
+    summary: boolean;
+}
+/**
+ * Parse stats subcommand arguments.
+ * Returns undefined if not a stats command.
+ */
+export declare function parseStatsArgs(args: string[]): StatsCommandArgs | undefined;
+export declare function runStatsCommand(cmd: StatsCommandArgs): Promise<void>;
+export declare function printStatsHelp(): void;

package/dist/types/cli/update-cli.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Parse update subcommand arguments.
+ * Returns undefined if not an update command.
+ */
+export declare function parseUpdateArgs(args: string[]): {
+    force: boolean;
+    check: boolean;
+} | undefined;
+export declare function resolveUpdateMethodForTest(ompPath: string, bunBinDir: string | undefined): "bun" | "binary";
+/**
+ * Run the update command.
+ */
+export declare function runUpdateCommand(opts: {
+    force: boolean;
+    check: boolean;
+}): Promise<void>;
+/**
+ * Print update command help.
+ */
+export declare function printUpdateHelp(): void;

package/dist/types/cli/web-search-cli.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Web search CLI command handlers.
+ *
+ * Handles `omp q`/`omp web-search` subcommands for testing web search providers.
+ */
+import type { SearchProviderId } from "../web/search/types";
+export interface SearchCommandArgs {
+    query: string;
+    provider?: SearchProviderId | "auto";
+    recency?: "day" | "week" | "month" | "year";
+    limit?: number;
+    expanded: boolean;
+}
+/**
+ * Parse web search subcommand arguments.
+ * Returns undefined if not a web search command.
+ */
+export declare function parseSearchArgs(args: string[]): SearchCommandArgs | undefined;
+export declare function runSearchCommand(cmd: SearchCommandArgs): Promise<void>;
+export declare function printSearchHelp(): void;

package/dist/types/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+/** Run the CLI with the given argv (no `process.argv` prefix). */
+export declare function runCli(argv: string[]): Promise<void>;

package/dist/types/commands/acp.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Run Oh My Pi as an ACP (Agent Client Protocol) server over stdio.
+ *
+ * Thin wrapper around the launch flow that forces `mode: "acp"` unless the
+ * ACP terminal-auth flag asks the same command to open the interactive TUI.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Acp extends Command {
+    static description: string;
+    static strict: boolean;
+    run(): Promise<void>;
+}

package/dist/types/commands/agents.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Manage bundled task agents.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Agents extends Command {
+    static description: string;
+    static args: {
+        action: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: "unpack"[];
+        };
+    };
+    static flags: {
+        force: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        dir: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        user: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        project: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/commands/commit.d.ts

@@ -0,0 +1,27 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Commit extends Command {
+    static description: string;
+    static flags: {
+        push: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "dry-run": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "no-changelog": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        legacy: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        context: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+        model: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/commands/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Manage configuration settings.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+import { type ConfigAction } from "../cli/config-cli";
+export default class Config extends Command {
+    static description: string;
+    static args: {
+        action: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: ConfigAction[];
+        };
+        key: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+        value: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            multiple: true;
+        };
+    };
+    static flags: {
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/commands/grep.d.ts

@@ -0,0 +1,42 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Grep extends Command {
+    static description: string;
+    static args: {
+        pattern: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+        path: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+    };
+    static flags: {
+        glob: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+        limit: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+            default: number;
+        };
+        context: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+            default: number;
+        };
+        files: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        count: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        "no-gitignore": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/commands/grievances.d.ts

@@ -0,0 +1,40 @@
+/**
+ * View and clean recently reported tool issues from automated QA.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Grievances extends Command {
+    static description: string;
+    static args: {
+        action: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: string[];
+            default: string;
+        };
+    };
+    static flags: {
+        limit: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+            default: number;
+        };
+        tool: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
+        id: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+        all: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/commands/launch.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Root command for the coding agent CLI.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Index extends Command {
+    static description: string;
+    static hidden: boolean;
+    static args: {
+        messages: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            multiple: true;
+        };
+    };
+    static flags: {
+        model: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        smol: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        slow: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        plan: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        provider: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "api-key": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "system-prompt": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "append-system-prompt": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "allow-home": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        mode: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            options: string[];
+        };
+        print: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        continue: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        resume: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+        "session-dir": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "no-session": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        models: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "no-tools": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "no-lsp": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "no-pty": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        tools: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        thinking: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            options: import("@oh-my-pi/pi-ai").Effort[];
+        };
+        hook: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        extension: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+            multiple: true;
+        };
+        "no-extensions": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "no-skills": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        skills: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "no-rules": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        export: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "list-models": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "no-title": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    static examples: string[];
+    static strict: boolean;
+    run(): Promise<void>;
+}

package/dist/types/commands/plugin.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Manage plugins (install, uninstall, list, etc.).
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+import { type PluginAction } from "../cli/plugin-cli";
+export default class Plugin extends Command {
+    static description: string;
+    static args: {
+        action: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: PluginAction[];
+        };
+        targets: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            multiple: true;
+        };
+    };
+    static flags: {
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        fix: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        force: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "dry-run": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        local: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        enable: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        disable: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        set: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        scope: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            options: string[];
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/commands/read.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Show what the read tool will return for a given path.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Read extends Command {
+    static description: string;
+    static args: {
+        path: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: true;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/commands/setup.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Install dependencies for optional features.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+import { type SetupComponent } from "../cli/setup-cli";
+export default class Setup extends Command {
+    static description: string;
+    static args: {
+        component: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: SetupComponent[];
+        };
+    };
+    static flags: {
+        check: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+        };
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}