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

package/dist/types/utils/sixel.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Returns whether SIXEL passthrough is explicitly enabled.
+ *
+ * Both gates must be enabled to preserve SIXEL control sequences:
+ * - PI_FORCE_IMAGE_PROTOCOL=sixel
+ * - PI_ALLOW_SIXEL_PASSTHROUGH=1
+ */
+export declare function isSixelPassthroughEnabled(): boolean;
+/** Returns true when the text contains a SIXEL start sequence. */
+export declare function containsSixelSequence(text: string): boolean;
+/**
+ * Returns a boolean mask indicating which lines belong to a SIXEL sequence block.
+ * Supports multi-line SIXEL payloads generated by libsixel.
+ */
+export declare function getSixelLineMask(lines: string[]): boolean[];
+/** Returns true when the line contains a SIXEL start sequence. */
+export declare function isSixelLine(line: string): boolean;
+/**
+ * Sanitizes text while preserving embedded SIXEL sequences when passthrough is enabled.
+ */
+export declare function sanitizeWithOptionalSixelPassthrough(text: string, sanitize: (text: string) => string): string;

package/dist/types/utils/title-generator.d.ts

@@ -0,0 +1,31 @@
+import { type Api, type Model } from "@oh-my-pi/pi-ai";
+import type { ModelRegistry } from "../config/model-registry";
+import type { Settings } from "../config/settings";
+/**
+ * Generate a title for a session based on the first user message.
+ *
+ * @param firstMessage The first user message
+ * @param registry Model registry
+ * @param settings Settings used to resolve the smol role
+ * @param sessionId Optional session id for sticky API key selection
+ * @param currentModel Current model (used to derive title model)
+ * @param metadataResolver Optional resolver evaluated after credential selection
+ *   to produce request metadata (e.g. user_id for session attribution). Using a
+ *   resolver instead of a pre-evaluated value ensures the metadata's account_uuid
+ *   reflects the credential actually selected for this request.
+ */
+export declare function generateSessionTitle(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined): Promise<string | null>;
+export declare function formatSessionTerminalTitle(sessionName: string | undefined, cwd?: string): string;
+/**
+ * Set the terminal title using OSC 0 (sets both tab and window title). Unsupported terminals ignore it.
+ */
+export declare function setTerminalTitle(title: string): void;
+export declare function setSessionTerminalTitle(sessionName: string | undefined, cwd?: string): void;
+/**
+ * Save the current terminal title on terminals that support xterm window ops.
+ */
+export declare function pushTerminalTitle(): void;
+/**
+ * Restore the previously saved terminal title on terminals that support xterm window ops.
+ */
+export declare function popTerminalTitle(): void;

package/dist/types/utils/tool-choice.d.ts

@@ -0,0 +1,6 @@
+import type { Api, Model, ToolChoice } from "@oh-my-pi/pi-ai";
+/**
+ * Build a provider-aware tool choice that targets one specific tool when supported.
+ * Some providers only support "any tool" forcing, not a named tool.
+ */
+export declare function buildNamedToolChoice(toolName: string, model?: Model<Api>): ToolChoice | undefined;

package/dist/types/utils/tools-manager.d.ts

@@ -0,0 +1,9 @@
+export type ToolName = "sd" | "sg" | "yt-dlp" | "trafilatura";
+export declare function getToolPath(tool: ToolName): string | null;
+type EnsureToolOptions = {
+    signal?: AbortSignal;
+    silent?: boolean;
+    notify?: (message: string) => void;
+};
+export declare function ensureTool(tool: ToolName, silentOrOptions?: EnsureToolOptions): Promise<string | undefined>;
+export {};

package/dist/types/vim/buffer.d.ts

@@ -0,0 +1,41 @@
+import { type Position, type VimBufferSnapshot, type VimFingerprint, type VimLoadedFile } from "./types";
+export declare function snapshotEqual(left: VimBufferSnapshot, right: VimBufferSnapshot): boolean;
+export declare class VimBuffer {
+    displayPath: string;
+    filePath: string;
+    lines: string[];
+    cursor: Position;
+    modified: boolean;
+    trailingNewline: boolean;
+    baseFingerprint: VimFingerprint | null;
+    editabilityChecked: boolean;
+    constructor(input: VimLoadedFile);
+    clone(): VimBuffer;
+    createSnapshot(): VimBufferSnapshot;
+    restore(snapshot: VimBufferSnapshot): void;
+    replaceLoadedFile(input: VimLoadedFile): void;
+    markSaved(input: VimLoadedFile): void;
+    lineCount(): number;
+    lastLineIndex(): number;
+    getLine(line: number): string;
+    clampLine(line: number): number;
+    clampCol(line: number, col: number): number;
+    setCursor(position: Position): void;
+    clampCursor(): void;
+    firstNonBlank(line: number): number;
+    getText(): string;
+    setText(text: string, trailingNewline?: boolean): void;
+    currentOffset(): number;
+    positionToOffset(position: Position): number;
+    offsetToPosition(offset: number): Position;
+    setCursorFromOffset(offset: number): void;
+    replaceOffsets(start: number, end: number, replacement: string, cursorOffset?: number): void;
+    deleteOffsets(start: number, end: number): string;
+    deleteLines(startLine: number, endLine: number): string[];
+    insertLines(index: number, newLines: string[]): void;
+    replaceLine(line: number, content: string): void;
+    joinLines(startLine: number, count: number): void;
+    indentLines(startLine: number, endLine: number, indentUnit: string, direction: 1 | -1): void;
+    getCharacterAtOffset(offset: number): string;
+    getCharacter(position: Position): string;
+}

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

@@ -0,0 +1,6 @@
+import type { VimExCommand } from "./types";
+export interface VimExParseContext {
+    currentLine: number;
+    lastLine: number;
+}
+export declare function parseExCommand(input: string, context?: VimExParseContext): VimExCommand;

package/dist/types/vim/engine.d.ts

@@ -0,0 +1,47 @@
+import type { FileDiagnosticsResult } from "../lsp";
+import { type VimBuffer } from "./buffer";
+import type { Position, VimInputMode, VimKeyToken, VimLoadedFile, VimPendingInput, VimRegister, VimSearchState, VimSelection } from "./types";
+export interface VimSaveResult {
+    loaded: VimLoadedFile;
+    diagnostics?: FileDiagnosticsResult;
+}
+export interface VimEngineCallbacks {
+    beforeMutate: (buffer: VimBuffer) => Promise<void>;
+    loadBuffer: (path: string) => Promise<VimLoadedFile>;
+    saveBuffer: (buffer: VimBuffer, options?: {
+        force?: boolean;
+    }) => Promise<VimSaveResult>;
+}
+export declare class VimEngine {
+    #private;
+    buffer: VimBuffer;
+    inputMode: VimInputMode;
+    selectionAnchor: Position | null;
+    register: VimRegister;
+    lastSearch: VimSearchState | null;
+    lastCharFind: {
+        char: string;
+        mode: "f" | "F" | "t" | "T";
+    } | null;
+    lastVisual: {
+        anchor: Position;
+        cursor: Position;
+        mode: VimInputMode;
+    } | null;
+    lastCommand?: string;
+    statusMessage?: string;
+    diagnostics?: FileDiagnosticsResult;
+    viewportStart: number;
+    closed: boolean;
+    constructor(buffer: VimBuffer, callbacks: VimEngineCallbacks);
+    clone(callbacks?: Partial<VimEngineCallbacks>): VimEngine;
+    getPublicMode(): import("./types").VimMode;
+    getSelection(): VimSelection | undefined;
+    getPendingInput(): VimPendingInput | undefined;
+    rollbackPendingInsert(): void;
+    setCursor(line: number, col: number): void;
+    executeTokens(tokens: readonly VimKeyToken[], lastCommand?: string, onStep?: () => Promise<void>): Promise<void>;
+    close(force: boolean): Promise<void>;
+    centerViewportOnCursor(size?: number): void;
+    applyLiteralInsert(text: string, exitInsertMode: boolean): Promise<void>;
+}

package/dist/types/vim/parser.d.ts

@@ -0,0 +1,3 @@
+import { type VimKeyToken } from "./types";
+export declare function parseKeySequences(sequences: string[]): VimKeyToken[];
+export declare function replayTokens(values: readonly string[]): VimKeyToken[];

package/dist/types/vim/render.d.ts

@@ -0,0 +1,25 @@
+import type { VimErrorLocation, VimMode, VimPendingInput, VimSelection, VimToolDetails, VimViewport } from "./types";
+export declare const VIM_OPEN_VIEWPORT_LINES = 80;
+export declare const VIM_DEFAULT_VIEWPORT_LINES = 10;
+interface ViewportRenderInput {
+    file: string;
+    mode: VimMode;
+    cursor: {
+        line: number;
+        col: number;
+    };
+    totalLines: number;
+    modified: boolean;
+    lines: string[];
+    viewport: VimViewport;
+    selection?: VimSelection;
+    statusMessage?: string;
+    lastCommand?: string;
+    pendingInput?: VimPendingInput;
+    errorLocation?: VimErrorLocation;
+    closed?: boolean;
+}
+export declare function computeViewport(cursorLine: number, totalLines: number, size: number, preferredStart?: number): VimViewport;
+export declare function renderVimDetails(details: VimToolDetails): string;
+export declare function buildDetails(input: ViewportRenderInput): VimToolDetails;
+export {};

package/dist/types/vim/types.d.ts

@@ -0,0 +1,182 @@
+import type { FileDiagnosticsResult } from "../lsp";
+import type { OutputMeta } from "../tools/output-meta";
+export type VimMode = "NORMAL" | "INSERT" | "VISUAL" | "VISUAL-LINE" | "COMMAND";
+export type VimInputMode = "normal" | "insert" | "visual" | "visual-line" | "command" | "search-forward" | "search-backward";
+export interface Position {
+    line: number;
+    col: number;
+}
+export interface VimViewport {
+    start: number;
+    end: number;
+}
+export interface VimSelection {
+    kind: "char" | "line";
+    start: Position;
+    end: Position;
+}
+export interface VimFocusLine {
+    line: number;
+    text: string;
+    windowStartCol: number;
+    windowEndCol: number;
+    caretCol: number;
+}
+export interface VimViewportLine {
+    line: number;
+    text: string;
+    isCursor: boolean;
+    isSelected: boolean;
+    cursorCol?: number;
+}
+export interface VimPendingInput {
+    kind: "insert" | "command" | "search-forward" | "search-backward";
+    text: string;
+}
+export interface VimErrorLocation {
+    sequenceIndex: number;
+    offset: number;
+}
+export interface VimToolDetails {
+    file: string;
+    mode: VimMode;
+    cursor: {
+        line: number;
+        col: number;
+    };
+    totalLines: number;
+    modified: boolean;
+    viewport: VimViewport;
+    focus?: VimFocusLine;
+    viewportLines?: VimViewportLine[];
+    selection?: VimSelection;
+    pendingInput?: VimPendingInput;
+    errorLocation?: VimErrorLocation;
+    closed?: boolean;
+    meta?: OutputMeta;
+    lastCommand?: string;
+    statusMessage?: string;
+    diagnostics?: FileDiagnosticsResult;
+}
+export interface VimFingerprint {
+    exists: boolean;
+    size: number;
+    mtimeMs: number;
+    hash: string;
+}
+export interface VimLoadedFile {
+    absolutePath: string;
+    displayPath: string;
+    lines: string[];
+    trailingNewline: boolean;
+    fingerprint: VimFingerprint | null;
+}
+export interface VimKeyToken {
+    value: string;
+    display: string;
+    sequenceIndex: number;
+    offset: number;
+}
+export interface VimRegister {
+    kind: "char" | "line";
+    text: string;
+}
+export interface VimSearchState {
+    pattern: string;
+    direction: 1 | -1;
+}
+export interface VimBufferSnapshot {
+    displayPath: string;
+    filePath: string;
+    lines: string[];
+    cursor: Position;
+    modified: boolean;
+    trailingNewline: boolean;
+    baseFingerprint: VimFingerprint | null;
+    editabilityChecked: boolean;
+}
+export interface VimUndoEntry {
+    before: VimBufferSnapshot;
+    after: VimBufferSnapshot;
+}
+export interface VimLineRange {
+    start: number;
+    end: number;
+}
+export type VimExCommand = {
+    kind: "write";
+    force: boolean;
+} | {
+    kind: "update";
+    force: boolean;
+} | {
+    kind: "quit";
+    force: boolean;
+} | {
+    kind: "write-quit";
+    force: boolean;
+} | {
+    kind: "edit";
+    force: boolean;
+    path?: string;
+} | {
+    kind: "goto-line";
+    line: number;
+} | {
+    kind: "substitute";
+    range?: VimLineRange | "all";
+    pattern: string;
+    replacement: string;
+    flags: string;
+} | {
+    kind: "delete";
+    range?: VimLineRange | "all";
+} | {
+    kind: "yank";
+    range?: VimLineRange | "all";
+} | {
+    kind: "put";
+    range?: VimLineRange | "all";
+    before: boolean;
+} | {
+    kind: "copy";
+    range?: VimLineRange | "all";
+    destination: number;
+} | {
+    kind: "move";
+    range?: VimLineRange | "all";
+    destination: number;
+} | {
+    kind: "sort";
+    range?: VimLineRange | "all";
+    flags: string;
+} | {
+    kind: "join";
+    range?: VimLineRange | "all";
+    trimWhitespace: boolean;
+} | {
+    kind: "global";
+    range?: VimLineRange | "all";
+    pattern: string;
+    command: string;
+    invert: boolean;
+} | {
+    kind: "append";
+    range?: VimLineRange;
+    text: string;
+} | {
+    kind: "insert-before";
+    range?: VimLineRange;
+    text: string;
+};
+export declare class VimInputError extends Error {
+    location?: {
+        sequenceIndex: number;
+        offset: number;
+    };
+    constructor(message: string, token?: VimKeyToken);
+}
+export declare function clonePosition(position: Position): Position;
+export declare function minPosition(left: Position, right: Position): Position;
+export declare function maxPosition(left: Position, right: Position): Position;
+export declare function toPublicMode(mode: VimInputMode): VimMode;

package/dist/types/web/kagi.d.ts

@@ -0,0 +1,21 @@
+export declare class KagiApiError extends Error {
+    readonly statusCode?: number;
+    constructor(message: string, statusCode?: number);
+}
+export interface KagiSearchOptions {
+    limit?: number;
+    signal?: AbortSignal;
+}
+export interface KagiSearchSource {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedDate?: string;
+}
+export interface KagiSearchResult {
+    requestId: string;
+    sources: KagiSearchSource[];
+    relatedQuestions: string[];
+}
+export declare function findKagiApiKey(): Promise<string | null>;
+export declare function searchWithKagi(query: string, options?: KagiSearchOptions): Promise<KagiSearchResult>;

package/dist/types/web/parallel.d.ts

@@ -0,0 +1,57 @@
+export interface ParallelUsageItem {
+    name?: string;
+    count?: number;
+}
+export interface ParallelSearchSource {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedDate?: string;
+    excerpts: string[];
+}
+export interface ParallelSearchResult {
+    requestId: string;
+    sources: ParallelSearchSource[];
+    warnings: string[];
+    usage: ParallelUsageItem[];
+}
+export interface ParallelExtractDocument {
+    url: string;
+    title?: string;
+    publishedDate?: string;
+    excerpts: string[];
+    fullContent?: string;
+}
+export interface ParallelExtractErrorEntry {
+    url: string;
+    errorType?: string;
+    httpStatusCode?: number;
+    content?: string;
+}
+export interface ParallelExtractResult {
+    requestId: string;
+    results: ParallelExtractDocument[];
+    errors: ParallelExtractErrorEntry[];
+    warnings: string[];
+    usage: ParallelUsageItem[];
+}
+export interface ParallelSearchOptions {
+    mode?: "fast" | "research";
+    maxCharsPerResult?: number;
+    signal?: AbortSignal;
+}
+export interface ParallelExtractOptions {
+    objective?: string;
+    searchQueries?: string[];
+    excerpts?: boolean;
+    fullContent?: boolean;
+    signal?: AbortSignal;
+}
+export declare class ParallelApiError extends Error {
+    readonly statusCode?: number;
+    constructor(message: string, statusCode?: number);
+}
+export declare function findParallelApiKey(): Promise<string | null>;
+export declare function getParallelExtractContent(document: ParallelExtractDocument): string;
+export declare function searchWithParallel(objective: string, queries: string[], options?: ParallelSearchOptions): Promise<ParallelSearchResult>;
+export declare function extractWithParallel(urls: string[], options?: ParallelExtractOptions): Promise<ParallelExtractResult>;

package/dist/types/web/scrapers/artifacthub.d.ts

@@ -0,0 +1,6 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Artifact Hub URLs via API
+ * Supports Helm charts, OLM operators, Falco rules, OPA policies, etc.
+ */
+export declare const handleArtifactHub: SpecialHandler;

package/dist/types/web/scrapers/arxiv.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle arXiv URLs via arXiv API
+ */
+export declare const handleArxiv: SpecialHandler;

package/dist/types/web/scrapers/aur.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle AUR (Arch User Repository) URLs via RPC API
+ */
+export declare const handleAur: SpecialHandler;

package/dist/types/web/scrapers/biorxiv.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle bioRxiv and medRxiv preprint URLs via their API
+ */
+export declare const handleBiorxiv: SpecialHandler;

package/dist/types/web/scrapers/bluesky.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Bluesky post URLs
+ */
+export declare const handleBluesky: SpecialHandler;

package/dist/types/web/scrapers/brew.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Homebrew formulae and cask URLs via API
+ */
+export declare const handleBrew: SpecialHandler;

package/dist/types/web/scrapers/cheatsh.d.ts

@@ -0,0 +1,8 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle cheat.sh / cht.sh URLs for command cheatsheets
+ *
+ * API: Plain text at https://cheat.sh/{topic}?T (T flag removes ANSI colors)
+ * Supports: commands, language/topic queries (e.g., python/list, go/slice)
+ */
+export declare const handleCheatSh: SpecialHandler;

package/dist/types/web/scrapers/chocolatey.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Chocolatey package URLs via NuGet v2 OData API
+ */
+export declare const handleChocolatey: SpecialHandler;

package/dist/types/web/scrapers/choosealicense.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleChooseALicense: SpecialHandler;

package/dist/types/web/scrapers/cisa-kev.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle CISA Known Exploited Vulnerabilities (KEV) URLs
+ */
+export declare const handleCisaKev: SpecialHandler;

package/dist/types/web/scrapers/clojars.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Clojars URLs via API
+ */
+export declare const handleClojars: SpecialHandler;

package/dist/types/web/scrapers/coingecko.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle CoinGecko cryptocurrency URLs via API
+ */
+export declare const handleCoinGecko: SpecialHandler;

package/dist/types/web/scrapers/crates-io.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle crates.io URLs via API
+ */
+export declare const handleCratesIo: SpecialHandler;

package/dist/types/web/scrapers/crossref.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleCrossref: SpecialHandler;

package/dist/types/web/scrapers/devto.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle dev.to URLs via API
+ */
+export declare const handleDevTo: SpecialHandler;

package/dist/types/web/scrapers/discogs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Discogs URL handler for music releases and masters
+ *
+ * Uses the Discogs API to extract structured metadata about releases.
+ * API docs: https://www.discogs.com/developers
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleDiscogs: SpecialHandler;

package/dist/types/web/scrapers/discourse.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Discourse forum URLs via API
+ */
+export declare const handleDiscourse: SpecialHandler;

package/dist/types/web/scrapers/dockerhub.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Docker Hub URLs via API
+ */
+export declare const handleDockerHub: SpecialHandler;

package/dist/types/web/scrapers/docs-rs.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleDocsRs: SpecialHandler;

package/dist/types/web/scrapers/fdroid.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle F-Droid URLs via API
+ */
+export declare const handleFdroid: SpecialHandler;

package/dist/types/web/scrapers/firefox-addons.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleFirefoxAddons: SpecialHandler;

package/dist/types/web/scrapers/flathub.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleFlathub: SpecialHandler;

package/dist/types/web/scrapers/github-gist.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle GitHub Gist URLs via GitHub API
+ */
+export declare const handleGitHubGist: SpecialHandler;

package/dist/types/web/scrapers/github.d.ts

@@ -0,0 +1,12 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Fetch from GitHub API
+ */
+export declare function fetchGitHubApi(endpoint: string, timeout: number, signal?: AbortSignal): Promise<{
+    data: unknown;
+    ok: boolean;
+}>;
+/**
+ * Handle GitHub URLs specially
+ */
+export declare const handleGitHub: SpecialHandler;

package/dist/types/web/scrapers/gitlab.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle GitLab URLs specially
+ */
+export declare const handleGitLab: SpecialHandler;

package/dist/types/web/scrapers/go-pkg.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle pkg.go.dev URLs via proxy API and page parsing
+ */
+export declare const handleGoPkg: SpecialHandler;

package/dist/types/web/scrapers/hackage.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Hackage (Haskell package registry) URLs via JSON API
+ */
+export declare const handleHackage: SpecialHandler;

package/dist/types/web/scrapers/hackernews.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleHackerNews: SpecialHandler;

package/dist/types/web/scrapers/hex.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Hex.pm (Elixir package registry) URLs via API
+ */
+export declare const handleHex: SpecialHandler;