@oh-my-pi/pi-coding-agent 15.1.1 → 15.1.3

package/dist/types/cli/auth-gateway-cli.d.ts

@@ -0,0 +1,18 @@
+export type AuthGatewayAction = "serve" | "token" | "status";
+export interface AuthGatewayCommandArgs {
+    action: AuthGatewayAction;
+    flags: {
+        json?: boolean;
+        bind?: string;
+        regenerate?: boolean;
+        /**
+         * Disable bearer-token auth on inbound requests. Useful when the gateway
+         * is bound to loopback (the default `127.0.0.1:4000`) and you don't want
+         * to wire token-paste plumbing into every local client.
+         */
+        noAuth?: boolean;
+    };
+}
+declare const ACTIONS: readonly AuthGatewayAction[];
+export declare function runAuthGatewayCommand(cmd: AuthGatewayCommandArgs): Promise<void>;
+export { ACTIONS as AUTH_GATEWAY_ACTIONS };

package/dist/types/cli/classify-install-target.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Classify an install spec as a marketplace plugin reference or a plain npm package.
+ *
+ * Rules (applied in order):
+ *  1. Starts with `@` (scoped npm) -> always npm.
+ *  2. Contains `@` after the first character -> split on the LAST `@`.
+ *     If the right-hand side is a known marketplace name, it's a marketplace ref.
+ *     Otherwise it's an npm spec (e.g. `pkg@1.2.3`).
+ *  3. No `@` -> npm.
+ */
+export declare function classifyInstallTarget(spec: string, knownMarketplaces: Set<string>): {
+    type: "marketplace";
+    name: string;
+    marketplace: string;
+} | {
+    type: "npm";
+    spec: string;
+};

package/dist/types/cli/commands/init-xdg.d.ts

@@ -0,0 +1 @@
+export declare function initXdg(): Promise<void>;

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

@@ -0,0 +1,22 @@
+/**
+ * Config CLI command handlers.
+ *
+ * Handles `omp config <command>` subcommands for managing settings.
+ * Uses the settings schema as the source of truth for available settings.
+ */
+export type ConfigAction = "list" | "get" | "set" | "reset" | "path" | "init-xdg";
+export interface ConfigCommandArgs {
+    action: ConfigAction;
+    key?: string;
+    value?: string;
+    flags: {
+        json?: boolean;
+    };
+}
+/**
+ * Parse config subcommand arguments.
+ * Returns undefined if not a config command.
+ */
+export declare function parseConfigArgs(args: string[]): ConfigCommandArgs | undefined;
+export declare function runConfigCommand(cmd: ConfigCommandArgs): Promise<void>;
+export declare function printConfigHelp(): void;

package/dist/types/cli/file-processor.d.ts

@@ -0,0 +1,11 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
+export interface ProcessedFiles {
+    text: string;
+    images: ImageContent[];
+}
+export interface ProcessFileOptions {
+    /** Whether to auto-resize images to 2000x2000 max. Default: true */
+    autoResizeImages?: boolean;
+}
+/** Process @file arguments into text content and image attachments */
+export declare function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles>;

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

@@ -0,0 +1,17 @@
+import { GrepOutputMode } from "@oh-my-pi/pi-natives";
+export interface GrepCommandArgs {
+    pattern: string;
+    path: string;
+    glob?: string;
+    limit: number;
+    context: number;
+    mode: GrepOutputMode;
+    gitignore: boolean;
+}
+/**
+ * Parse grep subcommand arguments.
+ * Returns undefined if not a grep command.
+ */
+export declare function parseGrepArgs(args: string[]): GrepCommandArgs | undefined;
+export declare function runGrepCommand(cmd: GrepCommandArgs): Promise<void>;
+export declare function printGrepHelp(): void;

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

@@ -0,0 +1,37 @@
+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 interface PushGrievancesOptions {
+    /** Emit the {@link FlushResult} as JSON instead of a status line. */
+    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>;
+/**
+ * Manually drain every unpushed grievance to the configured backend,
+ * ignoring the user-facing consent gate (manual push is the user's
+ * explicit "yes ship these now" intent).
+ *
+ * Requires endpoint configuration (default `qa.omp.sh/v1/grievances`).
+ */
+export declare function pushGrievances(options: PushGrievancesOptions): 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/auth-broker.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `omp auth-broker` — manage the omp credential vault.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+import { type AuthBrokerAction } from "../cli/auth-broker-cli";
+export default class AuthBroker extends Command {
+    static description: string;
+    static args: {
+        action: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: AuthBrokerAction[];
+        };
+        source: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+    };
+    static flags: {
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        bind: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            char: string;
+        };
+        regenerate: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        via: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        provider: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "include-disabled": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "from-local": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "include-env": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "include-oauth": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "dry-run": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/commands/auth-gateway.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `omp auth-gateway` — run a forward proxy that injects auth from the broker.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+import { type AuthGatewayAction } from "../cli/auth-gateway-cli";
+export default class AuthGateway extends Command {
+    static description: string;
+    static args: {
+        action: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: AuthGatewayAction[];
+        };
+    };
+    static flags: {
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        bind: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            char: string;
+        };
+        regenerate: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "no-auth": 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, clean, and push 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>;
+}