@sayknow-cli/coding-agent 0.3.12 → 0.3.13

package/dist/types/runtime-mcp/oauth-discovery.d.ts

@@ -1,40 +0,0 @@
-/**
- * MCP OAuth Auto-Discovery
- *
- * Automatically detects OAuth requirements from MCP server responses
- * and extracts authentication endpoints.
- */
-export interface OAuthEndpoints {
-    authorizationUrl: string;
-    tokenUrl: string;
-    clientId?: string;
-    scopes?: string;
-}
-export interface AuthDetectionResult {
-    requiresAuth: boolean;
-    authType?: "oauth" | "apikey" | "unknown";
-    oauth?: OAuthEndpoints;
-    authServerUrl?: string;
-    message?: string;
-}
-export declare function extractMcpAuthServerUrl(error: Error): string | undefined;
-/**
- * Detect if an error indicates authentication is required.
- * Checks for common auth error patterns.
- */
-export declare function detectAuthError(error: Error): boolean;
-/**
- * Extract OAuth endpoints from error response.
- * Looks for WWW-Authenticate header format or JSON error bodies.
- */
-export declare function extractOAuthEndpoints(error: Error): OAuthEndpoints | null;
-/**
- * Analyze an error to determine authentication requirements.
- * Returns structured info about what auth is needed.
- */
-export declare function analyzeAuthError(error: Error): AuthDetectionResult;
-/**
- * Try to discover OAuth endpoints by querying the server's well-known endpoints.
- * This is a fallback when error responses don't include OAuth metadata.
- */
-export declare function discoverOAuthEndpoints(serverUrl: string, authServerUrl?: string): Promise<OAuthEndpoints | null>;

package/dist/types/runtime-mcp/oauth-flow.d.ts

@@ -1,59 +0,0 @@
-/**
- * Generic OAuth flow for MCP servers.
- *
- * Allows users to authenticate with any OAuth-compatible MCP server
- * by providing authorization URL, token URL, and client credentials.
- */
-import { OAuthCallbackFlow } from "@sayknow-cli/ai/utils/oauth/callback-server";
-import type { OAuthController, OAuthCredentials } from "@sayknow-cli/ai/utils/oauth/types";
-export interface MCPOAuthConfig {
-    /** Authorization endpoint URL */
-    authorizationUrl: string;
-    /** Token endpoint URL */
-    tokenUrl: string;
-    /** Client ID (optional when already embedded in authorization URL) */
-    clientId?: string;
-    /** Client secret (optional for PKCE flows) */
-    clientSecret?: string;
-    /** OAuth scopes (space-separated) */
-    scopes?: string;
-    /** Exact redirect URI to advertise to the provider */
-    redirectUri?: string;
-    /** Custom callback port (default: 3000) */
-    callbackPort?: number;
-    /** Custom callback path (default: /callback or redirectUri pathname) */
-    callbackPath?: string;
-}
-/**
- * Generic OAuth flow for MCP servers.
- * Supports standard OAuth 2.0 authorization code flow with PKCE.
- */
-export declare class MCPOAuthFlow extends OAuthCallbackFlow {
-    #private;
-    private config;
-    constructor(config: MCPOAuthConfig, ctrl: OAuthController);
-    /**
-     * Client id used during the authorization request. Returns the value supplied
-     * via {@link MCPOAuthConfig.clientId} or, when the server required dynamic
-     * client registration, the id issued during registration. `undefined` until
-     * {@link generateAuthUrl} (or {@link login}) has run for a server that needs
-     * a client id.
-     */
-    get resolvedClientId(): string | undefined;
-    /**
-     * Client secret issued by dynamic client registration, if any. Always
-     * `undefined` for PKCE-only/public clients and when the caller supplies the
-     * client id via config.
-     */
-    get registeredClientSecret(): string | undefined;
-    generateAuthUrl(state: string, redirectUri: string): Promise<{
-        url: string;
-        instructions?: string;
-    }>;
-    exchangeToken(code: string, _state: string, redirectUri: string): Promise<OAuthCredentials>;
-}
-/**
- * Refresh an MCP OAuth token using the standard refresh_token grant.
- * Returns updated credentials; preserves the old refresh token if the server doesn't rotate it.
- */
-export declare function refreshMCPOAuthToken(tokenUrl: string, refreshToken: string, clientId?: string, clientSecret?: string): Promise<OAuthCredentials>;

package/dist/types/runtime-mcp/render.d.ts

@@ -1,25 +0,0 @@
-/**
- * TUI rendering for MCP tools.
- *
- * Provides structured display of MCP tool calls and results,
- * showing args and output in JSON tree format similar to task tool.
- */
-import type { Component } from "@sayknow-cli/tui";
-import type { RenderResultOptions } from "../extensibility/custom-tools/types";
-import type { Theme } from "../modes/theme/theme";
-import type { MCPToolDetails } from "./tool-bridge";
-/**
- * Render MCP tool call.
- */
-export declare function renderMCPCall(args: Record<string, unknown>, theme: Theme, label: string): Component;
-/**
- * Render MCP tool result.
- */
-export declare function renderMCPResult(result: {
-    content: Array<{
-        type: string;
-        text?: string;
-    }>;
-    details?: MCPToolDetails;
-    isError?: boolean;
-}, options: RenderResultOptions, theme: Theme, args?: Record<string, unknown>): Component;

package/dist/types/runtime-mcp/smithery-auth.d.ts

@@ -1,16 +0,0 @@
-type SmitheryCliAuthSession = {
-    sessionId: string;
-    authUrl: string;
-};
-type SmitheryCliPollResponse = {
-    status: "pending" | "success" | "error";
-    apiKey?: string;
-    message?: string;
-};
-export declare function getSmitheryLoginUrl(): string;
-export declare function createSmitheryCliAuthSession(): Promise<SmitheryCliAuthSession>;
-export declare function pollSmitheryCliAuthSession(sessionId: string, signal?: AbortSignal): Promise<SmitheryCliPollResponse>;
-export declare function getSmitheryApiKey(): Promise<string | undefined>;
-export declare function saveSmitheryApiKey(apiKey: string): Promise<void>;
-export declare function clearSmitheryApiKey(): Promise<boolean>;
-export {};

package/dist/types/runtime-mcp/smithery-connect.d.ts

@@ -1,38 +0,0 @@
-export declare class SmitheryConnectError extends Error {
-    status: number;
-    constructor(message: string, status: number);
-}
-type SmitheryNamespace = {
-    name: string;
-};
-type SmitheryConnectionStatus = {
-    state: "connected";
-} | {
-    state: "auth_required";
-    authorizationUrl?: string;
-} | {
-    state: "error";
-    message: string;
-} | {
-    state: string;
-    [key: string]: unknown;
-};
-export type SmitheryConnection = {
-    connectionId: string;
-    mcpUrl: string;
-    name: string;
-    status?: SmitheryConnectionStatus;
-    createdAt?: string;
-};
-export declare function getSmitheryApiBaseUrl(): string;
-export declare function listSmitheryNamespaces(apiKey: string): Promise<SmitheryNamespace[]>;
-export declare function createSmitheryNamespace(apiKey: string): Promise<SmitheryNamespace>;
-export declare function resolveSmitheryNamespace(apiKey: string): Promise<string>;
-export declare function listSmitheryConnectionsByUrl(apiKey: string, namespace: string, mcpUrl: string): Promise<SmitheryConnection[]>;
-export declare function createSmitheryConnection(apiKey: string, namespace: string, params: {
-    mcpUrl: string;
-    name?: string;
-}): Promise<SmitheryConnection>;
-export declare function getSmitheryConnection(apiKey: string, namespace: string, connectionId: string): Promise<SmitheryConnection>;
-export declare function deleteSmitheryConnection(apiKey: string, namespace: string, connectionId: string): Promise<void>;
-export {};

package/dist/types/runtime-mcp/smithery-registry.d.ts

@@ -1,51 +0,0 @@
-import type { MCPServerConfig } from "./types";
-type RegistryInputType = "string" | "number" | "boolean";
-export type SmitherySearchResult = {
-    id: string;
-    name: string;
-    title?: string;
-    description?: string;
-    score?: number;
-    useCount?: number;
-    display: {
-        displayName: string;
-        description: string;
-        useCount: number;
-        verified: boolean;
-        deployed: boolean;
-        transport: string;
-        connectionType: string;
-        createdAt?: string;
-        homepage?: string;
-        tools: Array<{
-            name: string;
-            description?: string;
-            params: string[];
-        }>;
-    };
-    sourceType: "remote" | "package";
-    config: MCPServerConfig;
-    warnings: string[];
-    requiredInputs: Array<{
-        key: string;
-        label: string;
-        type: RegistryInputType;
-        required: boolean;
-        defaultValue?: string;
-        description?: string;
-        enumValues?: string[];
-        sensitive: boolean;
-    }>;
-};
-export interface SmitherySearchOptions {
-    limit?: number;
-    apiKey?: string;
-    includeSemantic?: boolean;
-}
-export declare class SmitheryRegistryError extends Error {
-    status: number;
-    constructor(message: string, status: number);
-}
-export declare function searchSmitheryRegistry(keyword: string, options?: SmitherySearchOptions): Promise<SmitherySearchResult[]>;
-export declare function toConfigName(candidate: string): string;
-export {};

package/dist/types/runtime-mcp/tool-bridge.d.ts

@@ -1,86 +0,0 @@
-/**
- * MCP to CustomTool bridge.
- *
- * Converts MCP tool definitions to CustomTool format for the agent.
- */
-import type { AgentToolUpdateCallback } from "@sayknow-cli/agent-core";
-import type { TSchema } from "@sayknow-cli/ai";
-import type { SourceMeta } from "../capability/types";
-import type { CustomTool, CustomToolContext, CustomToolResult, RenderResultOptions } from "../extensibility/custom-tools/types";
-import type { Theme } from "../modes/theme/theme";
-import type { MCPContent, MCPServerConnection, MCPToolDefinition } from "./types";
-/** Reconnect callback: tears down stale connection, returns new one or null. */
-export type MCPReconnect = () => Promise<MCPServerConnection | null>;
-export declare function isRetriableConnectionError(error: unknown): boolean;
-/** Details included in MCP tool results for rendering */
-export interface MCPToolDetails {
-    /** Server name */
-    serverName: string;
-    /** Original MCP tool name */
-    mcpToolName: string;
-    /** Whether the call resulted in an error */
-    isError?: boolean;
-    /** Raw content from MCP response */
-    rawContent?: MCPContent[];
-    /** Provider ID (e.g., "Anthropic model", "mcp-json") */
-    provider?: string;
-    /** Provider display name (e.g., "Anthropic Code", "MCP Config") */
-    providerName?: string;
-}
-export declare function createMCPToolName(serverName: string, toolName: string): string;
-/**
- * Parse an MCP tool name back to server and tool components.
- *
- * Note: This returns the normalized tool name (with server prefix stripped).
- * The original MCP tool name may have had the server name as a prefix.
- */
-export declare function parseMCPToolName(name: string): {
-    serverName: string;
-    toolName: string;
-} | null;
-/**
- * CustomTool wrapping an MCP tool with an active connection.
- */
-export declare class MCPTool implements CustomTool<TSchema, MCPToolDetails> {
-    private connection;
-    private readonly tool;
-    private readonly reconnect?;
-    readonly name: string;
-    readonly label: string;
-    readonly description: string;
-    readonly parameters: TSchema;
-    /** Original MCP tool name (before normalization) */
-    readonly mcpToolName: string;
-    /** Server name */
-    readonly mcpServerName: string;
-    /** Create MCPTool instances for all tools from an MCP server connection */
-    static fromTools(connection: MCPServerConnection, tools: MCPToolDefinition[], reconnect?: MCPReconnect): MCPTool[];
-    constructor(connection: MCPServerConnection, tool: MCPToolDefinition, reconnect?: MCPReconnect | undefined);
-    renderCall(args: unknown, _options: RenderResultOptions, theme: Theme): import("@sayknow-cli/tui").Component;
-    renderResult(result: CustomToolResult<MCPToolDetails>, options: RenderResultOptions, theme: Theme, args?: unknown): import("@sayknow-cli/tui").Component;
-    execute(_toolCallId: string, params: unknown, _onUpdate: AgentToolUpdateCallback<MCPToolDetails> | undefined, _ctx: CustomToolContext, signal?: AbortSignal): Promise<CustomToolResult<MCPToolDetails>>;
-}
-/**
- * CustomTool wrapping an MCP tool with deferred connection resolution.
- */
-export declare class DeferredMCPTool implements CustomTool<TSchema, MCPToolDetails> {
-    #private;
-    private readonly serverName;
-    private readonly tool;
-    private readonly getConnection;
-    private readonly reconnect?;
-    readonly name: string;
-    readonly label: string;
-    readonly description: string;
-    readonly parameters: TSchema;
-    /** Original MCP tool name (before normalization) */
-    readonly mcpToolName: string;
-    /** Server name */
-    readonly mcpServerName: string;
-    /** Create DeferredMCPTool instances for all tools from an MCP server */
-    static fromTools(serverName: string, tools: MCPToolDefinition[], getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect): DeferredMCPTool[];
-    constructor(serverName: string, tool: MCPToolDefinition, getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect | undefined);
-    renderCall(args: unknown, _options: RenderResultOptions, theme: Theme): import("@sayknow-cli/tui").Component;
-    renderResult(result: CustomToolResult<MCPToolDetails>, options: RenderResultOptions, theme: Theme, args?: unknown): import("@sayknow-cli/tui").Component;
-    execute(_toolCallId: string, params: unknown, _onUpdate: AgentToolUpdateCallback<MCPToolDetails> | undefined, _ctx: CustomToolContext, signal?: AbortSignal): Promise<CustomToolResult<MCPToolDetails>>;
-}

package/dist/types/runtime-mcp/tool-cache.d.ts

@@ -1,8 +0,0 @@
-import type { AgentStorage } from "../session/agent-storage";
-import type { MCPServerConfig, MCPToolDefinition } from "./types";
-export declare class MCPToolCache {
-    private storage;
-    constructor(storage: AgentStorage);
-    get(serverName: string, config: MCPServerConfig): Promise<MCPToolDefinition[] | null>;
-    set(serverName: string, config: MCPServerConfig, tools: MCPToolDefinition[]): Promise<void>;
-}

package/dist/types/runtime-mcp/transports/http.d.ts

@@ -1,36 +0,0 @@
-import type { MCPHttpServerConfig, MCPRequestOptions, MCPSseServerConfig, MCPTransport } from "../../runtime-mcp/types";
-/**
- * HTTP transport for MCP servers.
- * Uses POST for requests, supports SSE responses.
- */
-export declare class HttpTransport implements MCPTransport {
-    #private;
-    private config;
-    onClose?: () => void;
-    onError?: (error: Error) => void;
-    onNotification?: (method: string, params: unknown) => void;
-    onRequest?: (method: string, params: unknown) => Promise<unknown>;
-    /** Called on 401/403 to attempt token refresh. Returns updated headers or null. */
-    onAuthError?: () => Promise<Record<string, string> | null>;
-    constructor(config: MCPHttpServerConfig | MCPSseServerConfig);
-    get connected(): boolean;
-    get url(): string;
-    /**
-     * Mark transport as connected.
-     * HTTP doesn't need persistent connection, but we track state.
-     */
-    connect(): Promise<void>;
-    /**
-     * Start SSE listener for server-initiated messages.
-     * Resolves once the SSE connection is established (or fails/unsupported).
-     * Message reading continues in the background.
-     */
-    startSSEListener(): Promise<void>;
-    request<T = unknown>(method: string, params?: Record<string, unknown>, options?: MCPRequestOptions): Promise<T>;
-    notify(method: string, params?: Record<string, unknown>): Promise<void>;
-    close(): Promise<void>;
-}
-/**
- * Create and connect an HTTP transport.
- */
-export declare function createHttpTransport(config: MCPHttpServerConfig | MCPSseServerConfig): Promise<HttpTransport>;

package/dist/types/runtime-mcp/transports/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * MCP transport exports.
- */
-export * from "./http";
-export * from "./stdio";

package/dist/types/runtime-mcp/transports/stdio.d.ts

@@ -1,29 +0,0 @@
-/**
- * MCP stdio transport.
- *
- * Implements JSON-RPC 2.0 over subprocess stdin/stdout.
- * Messages are newline-delimited JSON.
- */
-import type { MCPRequestOptions, MCPStdioServerConfig, MCPTransport } from "../../runtime-mcp/types";
-export declare class StdioTransport implements MCPTransport {
-    #private;
-    private config;
-    onClose?: () => void;
-    onError?: (error: Error) => void;
-    onNotification?: (method: string, params: unknown) => void;
-    onRequest?: (method: string, params: unknown) => Promise<unknown>;
-    constructor(config: MCPStdioServerConfig);
-    get connected(): boolean;
-    get closeBeforeReconnect(): true;
-    /**
-     * Start the subprocess and begin reading.
-     */
-    connect(): Promise<void>;
-    request<T = unknown>(method: string, params?: Record<string, unknown>, options?: MCPRequestOptions): Promise<T>;
-    notify(method: string, params?: Record<string, unknown>): Promise<void>;
-    close(): Promise<void>;
-}
-/**
- * Create and connect a stdio transport.
- */
-export declare function createStdioTransport(config: MCPStdioServerConfig): Promise<StdioTransport>;