@sayknow-cli/coding-agent 0.3.5 → 0.3.6

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

@@ -1,25 +0,0 @@
-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

@@ -1,182 +0,0 @@
-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/insane/bridge.d.ts

@@ -1,103 +0,0 @@
-/**
- * Bridge from TypeScript to the vendored insane-search Python engine.
- *
- * Invokes `python3 -m engine "<url>" --json` per fallback attempt (cwd + PYTHONPATH
- * pointed at the vendored engine), validates the JSON envelope, and maps it onto a
- * discriminated result. Hardened: clamped timeout, AbortSignal propagation that
- * kills+reaps the child, bounded stdout/stderr capture, and a per-process
- * concurrency cap so blocked reads cannot fork-storm.
- *
- * Fail-closed: missing dependencies / bad output / auth-required never throw past
- * the caller and never auto-install anything; they return ok:false with a stable,
- * bounded note so `read` can continue with its normal degraded result.
- */
-import { spawn as nodeSpawn } from "node:child_process";
-/** packages/coding-agent/vendor/insane-search */
-export declare const INSANE_VENDOR_DIR: string;
-/** Stable note prefixes — tests assert on these without depending on full stderr. */
-export declare const INSANE_NOTES: {
-    readonly guardBlocked: (reason: string) => string;
-    readonly vendorMissing: `insane fallback unavailable: vendor engine missing at packages/coding-agent/vendor/insane-search`;
-    readonly noPython: `insane fallback unavailable: python3 not found; install python3 and curl_cffi, then retry with web.insaneFallback=true`;
-    readonly noCurlCffi: `insane fallback unavailable: python3 cannot import curl_cffi; install curl_cffi for Phase 0-2`;
-    readonly noBrowser: `insane fallback unavailable: node/playwright/stealth dependencies missing for Phase 3; install dependencies under packages/coding-agent/vendor/insane-search/engine/templates`;
-    readonly timeout: (seconds: number) => string;
-    readonly invalidJson: `insane fallback failed: engine returned invalid JSON`;
-    readonly authRequired: `insane fallback stopped: authentication required`;
-    readonly verdict: (verdict: string) => string;
-    readonly untried: (routes: string) => string;
-    readonly mustBrowserMcp: `insane fallback requires browser MCP/manual phase: must_invoke_playwright_mcp=true`;
-    readonly concurrency: `insane fallback skipped: max concurrent engine attempts reached`;
-    readonly emptyContent: `insane fallback failed: engine reported ok but returned no content`;
-};
-/** Raw JSON envelope produced by `python3 -m engine --json`. */
-export interface InsaneFetchResultRaw {
-    ok?: boolean;
-    verdict?: string;
-    content?: string;
-    profile_used?: string;
-    trace?: unknown;
-    untried_routes?: string[];
-    must_invoke_playwright_mcp?: boolean;
-}
-export interface InsaneSuccess {
-    ok: true;
-    content: string;
-    profileUsed?: string;
-    notes: string[];
-}
-export interface InsaneFailure {
-    ok: false;
-    reason: string;
-    verdict?: string;
-    notes: string[];
-}
-export type InsaneBridgeResult = InsaneSuccess | InsaneFailure;
-export interface EngineInvocation {
-    url: string;
-    timeoutMs: number;
-    signal?: AbortSignal;
-}
-export interface EngineRawOutput {
-    code: number | null;
-    stdout: string;
-    stderr: string;
-    timedOut: boolean;
-    aborted: boolean;
-}
-/** Seam: run the engine subprocess. Default spawns python3. */
-export type EngineRunner = (inv: EngineInvocation) => Promise<EngineRawOutput>;
-export interface InsaneDependencyStatus {
-    vendorPresent: boolean;
-    python: boolean;
-    curlCffi: boolean;
-    browser: boolean;
-}
-/** Seam: probe dependencies. Default probes the real environment (cached). */
-export type DependencyProber = () => Promise<InsaneDependencyStatus>;
-type SpawnImpl = typeof nodeSpawn;
-/** Real engine runner: `python3 -m engine "<url>" --json`. */
-export declare function runEngineSubprocess(inv: EngineInvocation, options?: {
-    spawnImpl?: SpawnImpl;
-}): Promise<EngineRawOutput>;
-/** Reset the probe cache between tests so probe state never leaks. */
-export declare function resetInsaneProbeCacheForTest(): void;
-/** Probe (and cache) the insane-search runtime dependencies. */
-export declare function probeInsaneDependencies(): Promise<InsaneDependencyStatus>;
-export declare function resetInsaneConcurrencyForTest(): void;
-export interface TryInsaneFetchOptions {
-    timeoutMs?: number;
-    signal?: AbortSignal;
-    concurrencyLimit?: number;
-    /** Seam: dependency prober (default real, cached). */
-    prober?: DependencyProber;
-    /** Seam: engine runner (default real subprocess). */
-    runner?: EngineRunner;
-}
-/**
- * Attempt to read `url` through the insane-search engine. The caller is
- * responsible for the opt-in gate, raw-mode skip, and the public-URL guard
- * (which MUST run before this is called). Never throws; always returns a result.
- */
-export declare function tryInsaneFetch(url: string, options?: TryInsaneFetchOptions): Promise<InsaneBridgeResult>;
-export {};

package/dist/types/web/insane/url-guard.d.ts

@@ -1,25 +0,0 @@
-export interface PublicUrlAccepted {
-    ok: true;
-    url: URL;
-    addresses: string[];
-}
-export interface PublicUrlRejected {
-    ok: false;
-    reason: string;
-}
-export type PublicUrlResult = PublicUrlAccepted | PublicUrlRejected;
-/** Resolver seam so tests can inject DNS results without real lookups. */
-export type AddressResolver = (hostname: string) => Promise<string[]>;
-/** True for any address that is not a routable public unicast address. */
-export declare function isPrivateOrSpecialAddress(address: string): boolean;
-/**
- * Validate that `rawUrl` is a public http/https target. Resolves DNS names and
- * rejects any that map to a private/special address. Never throws; returns a
- * discriminated result.
- */
-export declare function validatePublicHttpUrl(rawUrl: string, options?: {
-    resolver?: AddressResolver;
-}): Promise<PublicUrlResult>;
-export declare function validatePublicHttpUrlForInsane(rawUrl: string, options?: {
-    resolver?: AddressResolver;
-}): Promise<PublicUrlResult>;

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

@@ -1,23 +0,0 @@
-import type { AuthStorage } from "@sayknow-cli/ai";
-export declare class KagiApiError extends Error {
-    readonly statusCode?: number;
-    constructor(message: string, statusCode?: number);
-}
-export interface KagiSearchOptions {
-    limit?: number;
-    sessionId?: string;
-    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(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | null>;
-export declare function searchWithKagi(query: string, options: KagiSearchOptions | undefined, authStorage: AuthStorage): Promise<KagiSearchResult>;

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

@@ -1,58 +0,0 @@
-import type { AgentStorage } from "../session/agent-storage";
-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(storage: AgentStorage | null | undefined): string | null;
-export declare function getParallelExtractContent(document: ParallelExtractDocument): string;
-export declare function searchWithParallel(objective: string, queries: string[], options: ParallelSearchOptions, storage: AgentStorage | null | undefined): Promise<ParallelSearchResult>;
-export declare function extractWithParallel(urls: string[], options: ParallelExtractOptions, storage: AgentStorage | null | undefined): Promise<ParallelExtractResult>;

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

@@ -1,6 +0,0 @@
-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

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

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

@@ -1,5 +0,0 @@
-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

@@ -1,5 +0,0 @@
-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

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

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

@@ -1,5 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,5 +0,0 @@
-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

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

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

@@ -1,5 +0,0 @@
-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

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

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

@@ -1,5 +0,0 @@
-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

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

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

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

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

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

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

@@ -1,8 +0,0 @@
-/**
- * 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

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

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

@@ -1,5 +0,0 @@
-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

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

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

@@ -1,5 +0,0 @@
-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

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

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

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

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

@@ -1,5 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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

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

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

@@ -1,5 +0,0 @@
-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

@@ -1,5 +0,0 @@
-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

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

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

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

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

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

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

@@ -1,5 +0,0 @@
-import type { SpecialHandler } from "./types";
-/**
- * Handle IACR ePrint Archive URLs
- */
-export declare const handleIacr: SpecialHandler;