@caplets/core 0.14.0 → 0.16.0

package/dist/config.d.ts

@@ -0,0 +1,227 @@
+import { z } from "zod";
+export { DEFAULT_AUTH_DIR, DEFAULT_CONFIG_PATH, PROJECT_CONFIG_FILE, resolveCapletsRoot, resolveConfigPath, resolveProjectCapletsRoot, resolveProjectConfigPath, } from "./config/paths";
+export type RemoteAuthConfig = {
+    type: "none";
+} | {
+    type: "bearer";
+    token: string;
+} | {
+    type: "headers";
+    headers: Record<string, string>;
+} | {
+    type: "oauth2";
+    authorizationUrl?: string | undefined;
+    tokenUrl?: string | undefined;
+    issuer?: string | undefined;
+    resourceMetadataUrl?: string | undefined;
+    authorizationServerMetadataUrl?: string | undefined;
+    openidConfigurationUrl?: string | undefined;
+    clientMetadataUrl?: string | undefined;
+    clientId?: string | undefined;
+    clientSecret?: string | undefined;
+    scopes?: string[] | undefined;
+    redirectUri?: string | undefined;
+} | {
+    type: "oidc";
+    authorizationUrl?: string | undefined;
+    tokenUrl?: string | undefined;
+    issuer?: string | undefined;
+    resourceMetadataUrl?: string | undefined;
+    authorizationServerMetadataUrl?: string | undefined;
+    openidConfigurationUrl?: string | undefined;
+    clientMetadataUrl?: string | undefined;
+    clientId?: string | undefined;
+    clientSecret?: string | undefined;
+    scopes?: string[] | undefined;
+    redirectUri?: string | undefined;
+};
+export type CapletServerConfig = {
+    server: string;
+    backend: "mcp";
+    name: string;
+    description: string;
+    tags?: string[] | undefined;
+    body?: string | undefined;
+    transport: "stdio" | "http" | "sse";
+    command?: string | undefined;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+    cwd?: string | undefined;
+    url?: string | undefined;
+    auth?: RemoteAuthConfig | undefined;
+    startupTimeoutMs: number;
+    callTimeoutMs: number;
+    toolCacheTtlMs: number;
+    disabled: boolean;
+};
+export type OpenApiAuthConfig = {
+    type: "none";
+} | {
+    type: "bearer";
+    token: string;
+} | {
+    type: "headers";
+    headers: Record<string, string>;
+} | Extract<RemoteAuthConfig, {
+    type: "oauth2" | "oidc";
+}>;
+export type OpenApiEndpointConfig = {
+    server: string;
+    backend: "openapi";
+    name: string;
+    description: string;
+    tags?: string[] | undefined;
+    body?: string | undefined;
+    specPath?: string | undefined;
+    specUrl?: string | undefined;
+    baseUrl?: string | undefined;
+    auth: OpenApiAuthConfig;
+    requestTimeoutMs: number;
+    operationCacheTtlMs: number;
+    disabled: boolean;
+};
+export type GraphQlOperationConfig = {
+    document?: string | undefined;
+    documentPath?: string | undefined;
+    operationName?: string | undefined;
+    description?: string | undefined;
+};
+export type GraphQlEndpointConfig = {
+    server: string;
+    backend: "graphql";
+    name: string;
+    description: string;
+    tags?: string[] | undefined;
+    body?: string | undefined;
+    endpointUrl: string;
+    schemaPath?: string | undefined;
+    schemaUrl?: string | undefined;
+    introspection?: true | undefined;
+    operations?: Record<string, GraphQlOperationConfig> | undefined;
+    auth: OpenApiAuthConfig;
+    requestTimeoutMs: number;
+    operationCacheTtlMs: number;
+    selectionDepth: number;
+    disabled: boolean;
+};
+export type HttpActionConfig = {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    description?: string | undefined;
+    inputSchema?: Record<string, unknown> | undefined;
+    outputSchema?: Record<string, unknown> | undefined;
+    query?: Record<string, string | number | boolean> | undefined;
+    headers?: Record<string, string | number | boolean> | undefined;
+    jsonBody?: unknown;
+};
+export type HttpApiConfig = {
+    server: string;
+    backend: "http";
+    name: string;
+    description: string;
+    tags?: string[] | undefined;
+    body?: string | undefined;
+    baseUrl: string;
+    auth: OpenApiAuthConfig;
+    actions: Record<string, HttpActionConfig>;
+    requestTimeoutMs: number;
+    maxResponseBytes: number;
+    disabled: boolean;
+};
+export type CliToolOutputConfig = {
+    type: "text" | "json";
+};
+export type CliToolActionConfig = {
+    description?: string | undefined;
+    inputSchema?: Record<string, unknown> | undefined;
+    outputSchema?: Record<string, unknown> | undefined;
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+    cwd?: string | undefined;
+    timeoutMs?: number | undefined;
+    maxOutputBytes?: number | undefined;
+    output?: CliToolOutputConfig | undefined;
+    annotations?: {
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+};
+export type CliToolsConfig = {
+    server: string;
+    backend: "cli";
+    name: string;
+    description: string;
+    tags?: string[] | undefined;
+    body?: string | undefined;
+    actions: Record<string, CliToolActionConfig>;
+    cwd?: string | undefined;
+    env?: Record<string, string> | undefined;
+    timeoutMs: number;
+    maxOutputBytes: number;
+    disabled: boolean;
+};
+export type CapletSetConfig = {
+    server: string;
+    backend: "caplets";
+    name: string;
+    description: string;
+    tags?: string[] | undefined;
+    body?: string | undefined;
+    configPath?: string | undefined;
+    capletsRoot?: string | undefined;
+    defaultSearchLimit: number;
+    maxSearchLimit: number;
+    toolCacheTtlMs: number;
+    disabled: boolean;
+};
+export type CapletConfig = CapletServerConfig | OpenApiEndpointConfig | GraphQlEndpointConfig | HttpApiConfig | CliToolsConfig | CapletSetConfig;
+export type CapletsOptions = {
+    defaultSearchLimit: number;
+    maxSearchLimit: number;
+};
+export type CapletsConfig = {
+    version: 1;
+    options: CapletsOptions;
+    mcpServers: Record<string, CapletServerConfig>;
+    openapiEndpoints: Record<string, OpenApiEndpointConfig>;
+    graphqlEndpoints: Record<string, GraphQlEndpointConfig>;
+    httpApis: Record<string, HttpApiConfig>;
+    cliTools: Record<string, CliToolsConfig>;
+    capletSets: Record<string, CapletSetConfig>;
+};
+export type ConfigSourceKind = "global-config" | "global-file" | "project-config" | "project-file";
+export type ConfigSource = {
+    kind: ConfigSourceKind;
+    path: string;
+};
+export type ConfigWithSources = {
+    config: CapletsConfig;
+    sources: Record<string, ConfigSource>;
+    shadows: Record<string, ConfigSource[]>;
+};
+export declare const configFileSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodLiteral<1>>;
+    defaultSearchLimit: z.ZodDefault<z.ZodNumber>;
+    maxSearchLimit: z.ZodDefault<z.ZodNumber>;
+    mcpServers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    openapiEndpoints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    graphqlEndpoints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    httpApis: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    cliTools: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    capletSets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+}, z.core.$strict>;
+export declare function configJsonSchema(): unknown;
+export declare function loadConfig(path?: string, projectPath?: string): CapletsConfig;
+export declare function loadConfigWithSources(path?: string, projectPath?: string): ConfigWithSources;
+export declare function loadIsolatedConfig(options: {
+    configPath?: string;
+    capletsRoot?: string;
+    defaultSearchLimit: number;
+    maxSearchLimit: number;
+}): CapletsConfig;
+export declare function parseConfig(input: unknown): CapletsConfig;
+export declare function interpolateEnv(value: string): string;

package/dist/downstream.d.ts

@@ -0,0 +1,41 @@
+import { type CompatibilityCallToolResult, type Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { CapletServerConfig } from "./config";
+import type { ServerRegistry } from "./registry";
+export type CompactTool = {
+    id: string;
+    tool: string;
+    description?: string;
+    hasInputSchema: boolean;
+    hasOutputSchema: boolean;
+};
+export declare class DownstreamManager {
+    private registry;
+    private readonly options;
+    private readonly connections;
+    private readonly connecting;
+    private readonly restartState;
+    constructor(registry: ServerRegistry, options?: {
+        authDir?: string;
+    });
+    updateRegistry(registry: ServerRegistry): void;
+    close(): Promise<void>;
+    closeServer(serverId: string): Promise<void>;
+    checkServer(server: CapletServerConfig): Promise<{
+        id: string;
+        status: string;
+        toolCount?: number;
+        elapsedMs: number;
+        error?: unknown;
+    }>;
+    listTools(server: CapletServerConfig): Promise<Tool[]>;
+    getTool(server: CapletServerConfig, toolName: string): Promise<Tool>;
+    callTool(server: CapletServerConfig, toolName: string, args: Record<string, unknown>): Promise<CompatibilityCallToolResult>;
+    compact(server: CapletServerConfig, tool: Tool): CompactTool;
+    search(server: CapletServerConfig, tools: Tool[], query: string, limit: number): CompactTool[];
+    private refreshTools;
+    private connect;
+    private createTransport;
+    private oauthProvider;
+    private currentServer;
+    private currentServerFingerprint;
+}