@wrongstack/core 0.284.1 → 0.285.0

package/dist/mcp-servers-DEV4s6Ks.d.ts

@@ -1,259 +0,0 @@
-import { C as Compactor } from './compactor-DQLL4HTo.js';
-import { M as Message, g as Tool } from './tool-BNlnIJvo.js';
-import { L as Logger, a as LogLevel } from './logger-B63L5bTg.js';
-import { b as MCPServerConfig } from './config-MRqn1V-u.js';
-
-type ContextManagerAction = 'check' | 'summary' | 'prune' | 'add_note' | 'compact' | 'repair';
-interface ContextManagerInput {
-    action: ContextManagerAction;
-    /** 0-based message indices for prune/summary (inclusive). */
-    from?: number | undefined;
-    to?: number | undefined;
-    /** Text for add_note / summary actions. For summary, this is the LLM-provided summary text. */
-    text?: string | undefined;
-    /** Inject after which index (for add_note). Defaults to prepend (0). */
-    afterIndex?: number | undefined;
-    /**
-     * System prompt blocks for accurate total token estimation in check action.
-     * When provided, check returns the full API request estimate
-     * (messages + system + tools) instead of just message tokens.
-     */
-    systemPrompt?: unknown | undefined;
-    /**
-     * Registered tools for accurate total token estimation in check action.
-     * Each tool's name + description + inputSchema is counted.
-     */
-    tools?: {
-        name: string;
-        description?: string | undefined;
-        inputSchema: unknown;
-    }[];
-}
-interface ContextManagerResult {
-    action: ContextManagerAction;
-    beforeTokens: number;
-    afterTokens?: number | undefined;
-    removedCount?: number | undefined;
-    messageCount: number;
-    summary?: string | undefined;
-    notes?: string | undefined;
-    repaired?: {
-        removedToolUses: string[];
-        removedToolResults: string[];
-        removedMessages: number;
-    } | undefined;
-}
-/**
- * Options for creating a context manager tool.
- * `compactor` is required for the "compact" action; without it the action returns an error.
- */
-interface ContextManagerToolOptions {
-    compactor?: Compactor | undefined;
-    /**
-     * Optional sub-LLM summarizer. When provided, the "summary" action calls this
-     * to produce real summaries of message ranges instead of placeholder text.
-     * (signature matches Provider.complete — return the summary text in result.content[0].text)
-     */
-    summarizer?: (((messages: Message[]) => Promise<string>)) | undefined;
-    /**
-     * Minimum full-request token count before the compact action is allowed to run.
-     * Prevents unnecessary compaction calls when context is small.
-     * Default: 0 (always allow). Set to ~5000 for meaningful compaction targets.
-     */
-    minCompactThreshold?: number | undefined;
-    /**
-     * Minimum token growth required before retrying after a NOOP compaction.
-     * A NOOP is when compaction saved nothing (preserveK protects everything,
-     * no oversized tool_results). Default: 2000.
-     */
-    noopRetryDeltaTokens?: number | undefined;
-    /**
-     * Provider's max context window in tokens. Used to compute a relative
-     * threshold when `minCompactThreshold` is not set. Default: 128_000.
-     */
-    maxContext?: number | undefined;
-    /**
-     * Fraction of maxContext that triggers compaction. Only used when
-     * `minCompactThreshold` is not set. Default: 0.5 (50% of maxContext).
-     */
-    compactThresholdFraction?: number | undefined;
-}
-declare function createContextManagerTool(opts?: ContextManagerToolOptions): Tool<ContextManagerInput, ContextManagerResult>;
-/** Pre-built instance with no compactor — compact action will return an error. */
-declare const contextManagerTool: Tool<ContextManagerInput, ContextManagerResult>;
-
-type LogFormat = 'pretty' | 'json';
-interface DefaultLoggerOptions {
-    level?: LogLevel | undefined;
-    file?: string | undefined;
-    /**
-     * @deprecated Use `format: 'json'` instead. Kept for backward compat
-     * with existing callers but has no effect on output — the `format`
-     * option controls whether stderr receives pretty-printed or JSON lines.
-     */
-    pretty?: boolean | undefined;
-    /** Output format for stderr. `pretty` (colored, human-readable) or `json` (machine-parseable). Defaults to `WRONGSTACK_LOG_FORMAT` env var, falling back to `pretty`. */
-    format?: LogFormat | undefined;
-    bindings?: Record<string, unknown>;
-    /**
-     * When false, suppress stderr output entirely — only write to the log
-     * file (if configured). Use this in TUI mode so plugin/library log
-     * messages don't interleave with Ink's terminal rendering.
-     * Default: true (stderr output is enabled).
-     */
-    stderr?: boolean | undefined;
-    /**
-     * Rotate the log file once it exceeds this many bytes: the current file is
-     * renamed to `<file>.1` (replacing any previous one) and a fresh file
-     * starts. Bounds total disk to ~2× this value. Default 10 MB.
-     */
-    maxFileBytes?: number | undefined;
-}
-declare class DefaultLogger implements Logger {
-    /** How many file writes between rotation size checks (statSync is not free). */
-    private static readonly ROTATE_CHECK_EVERY;
-    level: LogLevel;
-    private file?;
-    private bindings;
-    private format;
-    private stderr;
-    private maxFileBytes;
-    private writesSinceRotateCheck;
-    /**
-     * Serialized async tail for file writes. Every appendFile (and any
-     * chained rotation) is awaited through this promise so file I/O
-     * never overlaps itself — preserving the per-line ordering the
-     * sync version had, but without blocking the caller thread. Any
-     * rejection is swallowed (`catch(() => {})`) because logging must
-     * never crash the host.
-     *
-     * Children share the parent's tail: `child.tail === parent.tail`
-     * for the lifetime of the chain. Read/write access goes through
-     * `_tail` so that, when a child has been wired to a parent, both
-     * `enqueueRotate` and `log` always observe the parent's current tail
-     * rather than a stale snapshot taken at `child()` time.
-     */
-    private tail;
-    private parent;
-    /**
-     * Resolve the current tail. For the root logger this is the field;
-     * for a child logger we always read through the parent so that a
-     * child's appends land on the parent's most recent tail, and a
-     * parent's `flush()` waits for everything the child chained.
-     */
-    private get _tail();
-    private set _tail(value);
-    constructor(opts?: DefaultLoggerOptions);
-    error(msg: string, ctx?: unknown): void;
-    warn(msg: string, ctx?: unknown): void;
-    info(msg: string, ctx?: unknown): void;
-    debug(msg: string, ctx?: unknown): void;
-    trace(msg: string, ctx?: unknown): void;
-    child(bindings: Record<string, unknown>): Logger;
-    /**
-     * Wait until all queued file writes (and any pending rotation) have
-     * completed. `log()` is fire-and-forget by design — the caller never
-     * blocks on disk — so tests, shutdown handlers, and processes that
-     * need a deterministic "everything is on disk now" guarantee should
-     * `await logger.flush()` before reading the file or exiting.
-     */
-    flush(): Promise<void>;
-    /**
-     * Size-based rotation: when the file outgrows `maxFileBytes`, rename it to
-     * `<file>.1` (dropping the previous `.1`) so the live file restarts empty.
-     * Checked on the first write and every ROTATE_CHECK_EVERY writes after.
-     * Best-effort: a rename can fail on Windows while another process holds
-     * the file — the next check retries. Multiple processes appending to the
-     * same log all run this check; whoever crosses the threshold first wins.
-     *
-     * Async: the rotation runs on the file-write tail (so its writes don't
-     * interleave with the next append), and the caller never blocks on a
-     * statSync / renameSync syscall on the hot log path.
-     */
-    private enqueueRotate;
-    private log;
-}
-
-/**
- * Built-in MCP server presets available to all WrongStack users out of the box.
- * These servers must be explicitly enabled in config (disabled by default).
- *
- * To enable: set `mcpServers: { serverName: { enabled: true } }` in your config.
- *
- * Some servers require environment variables or additional config — see notes below.
- *
- * Transport types:
- *   stdio       — spawns a local npm package binary via child_process
- *   sse         — HTTP SSE endpoint (client POSTs requests)
- *   streamable-http — session-based HTTP with NDJSON responses
- */
-/** Filesystem access: read, write, list, search, tree. Good for exploring projects. */
-declare const filesystemServer: () => MCPServerConfig;
-/** GitHub API: issues, PRs, repos, search, file operations. Requires GITHUB_PERSONAL_ACCESS_TOKEN. */
-declare const githubServer: () => MCPServerConfig;
-/**
- * Context7 — codebase-aware documentation and Q&A using context from your code.
- * Live documentation for any library, grounded in your actual versions.
- */
-declare const context7Server: () => MCPServerConfig;
-/**
- * Brave Search — web search via Brave Browser's API.
- * Requires BRAVE_SEARCH_API_KEY. Free tier: 2,000 queries/month.
- * Sign up at https://api.search.brave.com/
- */
-declare const braveSearchServer: () => MCPServerConfig;
-/**
- * Block (Block, Inc.) — Postgres database access via SQL.
- * Useful for running queries against a connected database during development.
- */
-declare const blockServer: () => MCPServerConfig;
-/**
- * EverArt — AI image generation via various providers.
- * Requires EVERART_API_KEY.
- */
-declare const everArtServer: () => MCPServerConfig;
-/**
- * Slack — messaging, channels, search.
- * Requires SLACK_BOT_TOKEN and either SLACK_TEAM_ID or SLACK_USER_TOKEN.
- */
-declare const slackServer: () => MCPServerConfig;
-/**
- * AWS knowledge base — EC2, S3, Lambda, IAM, CloudFormation, cost management.
- * Requires AWS access key + secret in environment.
- */
-declare const awsServer: () => MCPServerConfig;
-/**
- * Google Maps — directions, distance matrix, geocoding, places.
- * Requires GOOGLE_MAPS_API_KEY.
- */
-declare const googleMapsServer: () => MCPServerConfig;
-/** Sentinel — security vulnerability scanning (sentinel-labs). */
-declare const sentinelServer: () => MCPServerConfig;
-/**
- * Z.AI Vision MCP — image understanding fallback for text-only models.
- * Requires Z_AI_API_KEY. Tools are read-only and safe to run automatically.
- */
-declare const zaiVisionServer: () => MCPServerConfig;
-/**
- * Playwright — browser automation: navigate, click, type, screenshot, evaluate JS.
- * Spawns a headless Chromium browser via @modelcontextprotocol/server-playwright.
- * Tools can read and interact with live web pages — permission defaults to
- * `confirm` because form submission / DOM mutation is possible.
- */
-declare const playwrightServer: () => MCPServerConfig;
-/**
- * MiniMax Token Plan MCP — search + understand_image.
- * This preset exposes only the read-only image understanding tool by default.
- * Requires MINIMAX_API_KEY and uvx on PATH.
- */
-declare const miniMaxVisionServer: () => MCPServerConfig;
-/**
- * SSH Manager — remote SSH execution, file transfer, tunnels, health checks, and deployment ops.
- * Server credentials are intentionally NOT embedded here. Configure hosts via mcp-ssh-manager's
- * env/TOML config (for example SSH_SERVER_<NAME>_HOST, USER, KEYPATH/PASSWORD) or ssh-agent.
- */
-declare const sshManagerServer: () => MCPServerConfig;
-/** Everything bundled — full set of built-in servers. Useful for `wstack mcp add --all`. */
-declare const allServers: () => Record<string, MCPServerConfig>;
-
-export { type ContextManagerAction as C, DefaultLogger as D, type LogFormat as L, type ContextManagerInput as a, type ContextManagerResult as b, type ContextManagerToolOptions as c, type DefaultLoggerOptions as d, allServers as e, awsServer as f, blockServer as g, braveSearchServer as h, context7Server as i, contextManagerTool as j, createContextManagerTool as k, everArtServer as l, filesystemServer as m, githubServer as n, googleMapsServer as o, miniMaxVisionServer as p, playwrightServer as q, slackServer as r, sentinelServer as s, sshManagerServer as t, zaiVisionServer as z };