@caplets/core 0.16.0 → 0.18.0

package/dist/auth.d.ts

@@ -53,6 +53,15 @@ export declare class FileOAuthProvider implements OAuthClientProvider {
     codeVerifier(): string;
     addClientAuthentication: (headers: Headers, params: URLSearchParams) => Promise<void>;
 }
+export type StartedOAuthFlow = {
+    authorizationUrl: string;
+    complete(callbackUrl: string): Promise<void>;
+};
+export declare function startOAuthFlow(server: CapletServerConfig, options: {
+    redirectUri: string;
+    authDir?: string;
+    print?: (line: string) => void;
+}): Promise<StartedOAuthFlow>;
 export declare function runOAuthFlow(server: CapletServerConfig, options?: {
     noOpen?: boolean;
     authDir?: string;
@@ -61,6 +70,11 @@ export declare function runOAuthFlow(server: CapletServerConfig, options?: {
     open?: (url: string) => Promise<void>;
     print?: (line: string) => void;
 }): Promise<AuthResult>;
+export declare function startGenericOAuthFlow(target: GenericAuthTarget, options: {
+    redirectUri: string;
+    authDir?: string;
+    print?: (line: string) => void;
+}): Promise<StartedOAuthFlow>;
 export declare function runGenericOAuthFlow(target: GenericAuthTarget, options?: {
     noOpen?: boolean;
     authDir?: string;

package/dist/cli/auth.d.ts

@@ -1,4 +1,13 @@
+import { type GenericAuthTarget } from "../auth";
+import { loadConfig, type GraphQlEndpointConfig, type HttpApiConfig } from "../config";
+type AuthTarget = ReturnType<typeof authTargets>[number];
 type AuthListFormat = "plain" | "markdown" | "json";
+export type AuthStatusRow = {
+    server: string;
+    status: "missing" | "expired" | "authenticated";
+    expiresAt?: string;
+    scope?: string;
+};
 export declare function loginAuth(serverId: string, options: {
     configPath?: string;
     noOpen: boolean;
@@ -11,10 +20,25 @@ export declare function logoutAuth(serverId: string, options: {
     configPath?: string;
     writeOut: (value: string) => void;
 }): void;
+export declare function logoutAuthResult(serverId: string, options: {
+    authDir?: string;
+    configPath?: string;
+}): {
+    server: string;
+    deleted: boolean;
+};
 export declare function listAuth(options: {
     authDir?: string;
     configPath?: string;
     writeOut: (value: string) => void;
     format?: AuthListFormat;
 }): void;
+export declare function listAuthRows(options: {
+    authDir?: string;
+    configPath?: string;
+}): AuthStatusRow[];
+export declare function formatAuthRows(rows: AuthStatusRow[], format: Exclude<AuthListFormat, "json">): string;
+export declare function findAuthTarget(serverId: string, config?: import("../config").CapletsConfig): AuthTarget | undefined;
+declare function authTargets(config: ReturnType<typeof loadConfig>): (import("../config").CapletServerConfig | import("../config").OpenApiEndpointConfig | (GraphQlEndpointConfig & GenericAuthTarget) | (HttpApiConfig & GenericAuthTarget))[];
+export declare function assertLoginTarget(target: AuthTarget | undefined, serverId: string): asserts target is AuthTarget;
 export {};

package/dist/cli/commands.d.ts

@@ -0,0 +1,37 @@
+export declare const completionShells: readonly ["bash", "zsh", "fish", "powershell", "cmd"];
+export type CompletionShell = (typeof completionShells)[number];
+export declare const cliCommands: {
+    readonly completion: "completion";
+    readonly completeHidden: "__complete";
+    readonly serve: "serve";
+    readonly init: "init";
+    readonly list: "list";
+    readonly install: "install";
+    readonly add: "add";
+    readonly getCaplet: "get-caplet";
+    readonly checkBackend: "check-backend";
+    readonly listTools: "list-tools";
+    readonly searchTools: "search-tools";
+    readonly getTool: "get-tool";
+    readonly callTool: "call-tool";
+    readonly listResources: "list-resources";
+    readonly searchResources: "search-resources";
+    readonly listResourceTemplates: "list-resource-templates";
+    readonly readResource: "read-resource";
+    readonly listPrompts: "list-prompts";
+    readonly searchPrompts: "search-prompts";
+    readonly getPrompt: "get-prompt";
+    readonly complete: "complete";
+    readonly config: "config";
+    readonly auth: "auth";
+};
+export declare const topLevelCommandNames: readonly ["serve", "init", "list", "install", "add", "get-caplet", "check-backend", "list-tools", "search-tools", "get-tool", "call-tool", "list-resources", "search-resources", "list-resource-templates", "read-resource", "list-prompts", "search-prompts", "get-prompt", "complete", "config", "auth", "completion"];
+export declare const cliSubcommands: {
+    readonly add: readonly ["cli", "mcp", "openapi", "graphql", "http"];
+    readonly auth: readonly ["login", "logout", "list"];
+    readonly completion: readonly ["bash", "zsh", "fish", "powershell", "cmd"];
+    readonly config: readonly ["path", "paths"];
+};
+export declare const capletIdCommands: Set<string>;
+export declare const qualifiedToolCommands: Set<string>;
+export declare const qualifiedPromptCommands: Set<string>;

package/dist/cli/completion-cache.d.ts

@@ -0,0 +1,30 @@
+export type CompletionDiscoveryKind = "tools" | "prompts" | "resources" | "resourceTemplates";
+export type CompletionCandidate = {
+    value: string;
+    label?: string | undefined;
+    description?: string | undefined;
+};
+export type CompletionCacheKeyInput = {
+    server: string;
+    backend: string;
+    kind: CompletionDiscoveryKind;
+    fingerprint: string;
+};
+export type CompletionCacheEntry = {
+    status: "positive";
+    fetchedAt: number;
+    expiresAt: number;
+    candidates: CompletionCandidate[];
+} | {
+    status: "negative";
+    fetchedAt: number;
+    expiresAt: number;
+    reason: "auth_required" | "timeout" | "unavailable" | "unsupported" | "error";
+    candidates?: CompletionCandidate[];
+};
+export type ReadCompletionCacheEntry = CompletionCacheEntry & {
+    fresh: boolean;
+};
+export declare function completionCacheKey(input: CompletionCacheKeyInput): string;
+export declare function readCompletionCacheEntry(cacheDir: string, key: string, now?: number): ReadCompletionCacheEntry | undefined;
+export declare function writeCompletionCacheEntry(cacheDir: string, key: string, entry: CompletionCacheEntry): void;

package/dist/cli/completion-discovery.d.ts

@@ -0,0 +1,30 @@
+import { type CapletConfig, type CapletsConfig, type CompletionConfig } from "../config";
+import { type CompletionCandidate, type CompletionDiscoveryKind } from "./completion-cache";
+export type CompletionDiscoveryManagers = {
+    listTools?: (server: CapletConfig) => Promise<Array<{
+        name: string;
+        description?: string;
+    }>>;
+    listPrompts?: (server: CapletConfig) => Promise<Array<{
+        name: string;
+        description?: string;
+    }>>;
+    listResources?: (server: CapletConfig) => Promise<Array<{
+        uri: string;
+        name?: string;
+        description?: string;
+    }>>;
+    listResourceTemplates?: (server: CapletConfig) => Promise<Array<{
+        uriTemplate: string;
+        name?: string;
+        description?: string;
+    }>>;
+};
+export type CompletionDiscoveryOptions = {
+    config: CapletsConfig;
+    completion?: CompletionConfig | undefined;
+    cacheDir?: string | undefined;
+    managers?: CompletionDiscoveryManagers | undefined;
+    now?: number | undefined;
+};
+export declare function discoverCompletionCandidates(serverId: string, kind: CompletionDiscoveryKind, options: CompletionDiscoveryOptions): Promise<CompletionCandidate[]>;

package/dist/cli/completion.d.ts

@@ -0,0 +1,15 @@
+import { type CapletsConfig, type CompletionConfig } from "../config";
+import { type CompletionShell } from "./commands";
+import { type CompletionDiscoveryManagers } from "./completion-discovery";
+export { completionShells, type CompletionShell } from "./commands";
+export declare const trailingSpaceCompletionToken = "__CAPLETS_TRAILING_SPACE__";
+export type CompletionOptions = {
+    configPath?: string;
+    projectConfigPath?: string;
+    config?: CapletsConfig;
+    completion?: CompletionConfig;
+    cacheDir?: string;
+    managers?: CompletionDiscoveryManagers;
+};
+export declare function completionScript(shell: CompletionShell): string;
+export declare function completeCliWords(words: string[], options?: CompletionOptions): Promise<string[]>;

package/dist/cli.d.ts

@@ -6,6 +6,8 @@ export { addCliCaplet, addGraphqlCaplet, addHttpCaplet, addMcpCaplet, addOpenApi
 type CliIO = {
     writeOut?: (value: string) => void;
     writeErr?: (value: string) => void;
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    fetch?: typeof fetch;
     authDir?: string;
     version?: string;
     setExitCode?: (code: number) => void;