@caplets/core 0.18.9 → 0.20.0

package/dist/attach/options.d.ts

@@ -0,0 +1,10 @@
+import { type RemoteSelectionInput, type ResolvedRemoteSelection } from "../remote/selection";
+import { type RawServeOptions, type ServeOptions } from "../serve/options";
+export type RawAttachServeOptions = RemoteSelectionInput & RawServeOptions & {
+    projectRoot?: string;
+};
+export type AttachServeOptions = ServeOptions & {
+    projectRoot: string;
+    selection: ResolvedRemoteSelection;
+};
+export declare function resolveAttachServeOptions(raw?: RawAttachServeOptions, env?: Record<string, string | undefined>): Promise<AttachServeOptions>;

package/dist/attach/server.d.ts

@@ -0,0 +1,5 @@
+import type { AttachServeOptions } from "./options";
+export type AttachServeIo = {
+    writeErr?: (value: string) => void;
+};
+export declare function attachResolvedCaplets(options: AttachServeOptions, io?: AttachServeIo): Promise<void>;

package/dist/caplet-files-bundle.d.ts

@@ -0,0 +1,430 @@
+import { z } from "zod";
+export declare const capletFileSchema: z.ZodObject<{
+    setup: z.ZodOptional<z.ZodObject<{
+        commands: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        verify: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    projectBinding: z.ZodOptional<z.ZodObject<{
+        required: z.ZodLiteral<true>;
+    }, z.core.$strict>>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            docker: "docker";
+            browser: "browser";
+        }>>>;
+        resources: z.ZodOptional<z.ZodObject<{
+            class: z.ZodOptional<z.ZodEnum<{
+                standard: "standard";
+                large: "large";
+                heavy: "heavy";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    mcpServer: z.ZodOptional<z.ZodObject<{
+        transport: z.ZodOptional<z.ZodEnum<{
+            stdio: "stdio";
+            http: "http";
+            sse: "sse";
+        }>>;
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        auth: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bearer">;
+            token: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"headers">;
+            headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oauth2">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oidc">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        startupTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        callTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        toolCacheTtlMs: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        projectBinding: z.ZodOptional<z.ZodObject<{
+            required: z.ZodLiteral<true>;
+        }, z.core.$strict>>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                docker: "docker";
+                browser: "browser";
+            }>>>;
+            resources: z.ZodOptional<z.ZodObject<{
+                class: z.ZodOptional<z.ZodEnum<{
+                    standard: "standard";
+                    large: "large";
+                    heavy: "heavy";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    openapiEndpoint: z.ZodOptional<z.ZodObject<{
+        specPath: z.ZodOptional<z.ZodString>;
+        specUrl: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        auth: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bearer">;
+            token: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"headers">;
+            headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oauth2">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oidc">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">;
+        requestTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        operationCacheTtlMs: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        projectBinding: z.ZodOptional<z.ZodObject<{
+            required: z.ZodLiteral<true>;
+        }, z.core.$strict>>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                docker: "docker";
+                browser: "browser";
+            }>>>;
+            resources: z.ZodOptional<z.ZodObject<{
+                class: z.ZodOptional<z.ZodEnum<{
+                    standard: "standard";
+                    large: "large";
+                    heavy: "heavy";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    graphqlEndpoint: z.ZodOptional<z.ZodObject<{
+        endpointUrl: z.ZodString;
+        schemaPath: z.ZodOptional<z.ZodString>;
+        schemaUrl: z.ZodOptional<z.ZodString>;
+        introspection: z.ZodOptional<z.ZodLiteral<true>>;
+        operations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            useWhen: z.ZodOptional<z.ZodString>;
+            avoidWhen: z.ZodOptional<z.ZodString>;
+            document: z.ZodOptional<z.ZodString>;
+            documentPath: z.ZodOptional<z.ZodString>;
+            operationName: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        auth: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bearer">;
+            token: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"headers">;
+            headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oauth2">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oidc">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">;
+        requestTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        operationCacheTtlMs: z.ZodOptional<z.ZodNumber>;
+        selectionDepth: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        projectBinding: z.ZodOptional<z.ZodObject<{
+            required: z.ZodLiteral<true>;
+        }, z.core.$strict>>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                docker: "docker";
+                browser: "browser";
+            }>>>;
+            resources: z.ZodOptional<z.ZodObject<{
+                class: z.ZodOptional<z.ZodEnum<{
+                    standard: "standard";
+                    large: "large";
+                    heavy: "heavy";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    httpApi: z.ZodOptional<z.ZodObject<{
+        baseUrl: z.ZodString;
+        auth: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bearer">;
+            token: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"headers">;
+            headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oauth2">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"oidc">;
+            authorizationUrl: z.ZodOptional<z.ZodString>;
+            tokenUrl: z.ZodOptional<z.ZodString>;
+            issuer: z.ZodOptional<z.ZodString>;
+            resourceMetadataUrl: z.ZodOptional<z.ZodString>;
+            authorizationServerMetadataUrl: z.ZodOptional<z.ZodString>;
+            openidConfigurationUrl: z.ZodOptional<z.ZodString>;
+            clientMetadataUrl: z.ZodOptional<z.ZodString>;
+            clientId: z.ZodOptional<z.ZodString>;
+            clientSecret: z.ZodOptional<z.ZodString>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            redirectUri: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">;
+        actions: z.ZodRecord<z.ZodString, z.ZodObject<{
+            inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            query: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            jsonBody: z.ZodOptional<z.ZodUnknown>;
+            useWhen: z.ZodOptional<z.ZodString>;
+            avoidWhen: z.ZodOptional<z.ZodString>;
+            method: z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PUT: "PUT";
+                PATCH: "PATCH";
+                DELETE: "DELETE";
+            }>;
+            path: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        requestTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxResponseBytes: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        projectBinding: z.ZodOptional<z.ZodObject<{
+            required: z.ZodLiteral<true>;
+        }, z.core.$strict>>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                docker: "docker";
+                browser: "browser";
+            }>>>;
+            resources: z.ZodOptional<z.ZodObject<{
+                class: z.ZodOptional<z.ZodEnum<{
+                    standard: "standard";
+                    large: "large";
+                    heavy: "heavy";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    cliTools: z.ZodOptional<z.ZodObject<{
+        actions: z.ZodRecord<z.ZodString, z.ZodObject<{
+            inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+            output: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodEnum<{
+                    text: "text";
+                    json: "json";
+                }>>;
+            }, z.core.$strict>>;
+            annotations: z.ZodOptional<z.ZodObject<{
+                readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+                destructiveHint: z.ZodOptional<z.ZodBoolean>;
+                idempotentHint: z.ZodOptional<z.ZodBoolean>;
+                openWorldHint: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            useWhen: z.ZodOptional<z.ZodString>;
+            avoidWhen: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        cwd: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        projectBinding: z.ZodOptional<z.ZodObject<{
+            required: z.ZodLiteral<true>;
+        }, z.core.$strict>>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                docker: "docker";
+                browser: "browser";
+            }>>>;
+            resources: z.ZodOptional<z.ZodObject<{
+                class: z.ZodOptional<z.ZodEnum<{
+                    standard: "standard";
+                    large: "large";
+                    heavy: "heavy";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    capletSet: z.ZodOptional<z.ZodObject<{
+        configPath: z.ZodOptional<z.ZodString>;
+        capletsRoot: z.ZodOptional<z.ZodString>;
+        defaultSearchLimit: z.ZodOptional<z.ZodNumber>;
+        maxSearchLimit: z.ZodOptional<z.ZodNumber>;
+        toolCacheTtlMs: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        projectBinding: z.ZodOptional<z.ZodObject<{
+            required: z.ZodLiteral<true>;
+        }, z.core.$strict>>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                docker: "docker";
+                browser: "browser";
+            }>>>;
+            resources: z.ZodOptional<z.ZodObject<{
+                class: z.ZodOptional<z.ZodEnum<{
+                    standard: "standard";
+                    large: "large";
+                    heavy: "heavy";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    useWhen: z.ZodOptional<z.ZodString>;
+    avoidWhen: z.ZodOptional<z.ZodString>;
+    $schema: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exposure: z.ZodOptional<z.ZodEnum<{
+        direct: "direct";
+        progressive: "progressive";
+        code_mode: "code_mode";
+        direct_and_code_mode: "direct_and_code_mode";
+        progressive_and_code_mode: "progressive_and_code_mode";
+    }>>;
+}, z.core.$strict>;
+export declare function capletJsonSchema(): unknown;
+export type CapletFileConfig = {
+    mcpServers?: Record<string, unknown>;
+    openapiEndpoints?: Record<string, unknown>;
+    graphqlEndpoints?: Record<string, unknown>;
+    httpApis?: Record<string, unknown>;
+    cliTools?: Record<string, unknown>;
+    capletSets?: Record<string, unknown>;
+};
+export type CapletFileLoadResult = {
+    config: CapletFileConfig;
+    paths: Record<string, string>;
+};
+export type CapletFileMapInput = {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+};
+export type CapletFileWarning = {
+    path?: string | undefined;
+    message: string;
+};
+export type BestEffortCapletFileLoadResult = CapletFileLoadResult & {
+    warnings: CapletFileWarning[];
+};
+export declare function loadCapletFilesFromMap(input: CapletFileMapInput): CapletFileLoadResult | undefined;
+export declare function buildCapletFileLoadResultFromEntries(root: string, candidates: Array<{
+    id: string;
+    path: string;
+}>, readConfig: (path: string) => unknown, warnings?: CapletFileWarning[]): BestEffortCapletFileLoadResult | undefined;
+export declare function readCapletFileContent(path: string, text: string, baseDir: string, normalizePath: (value: string | undefined, baseDir: string) => string | undefined): unknown;
+export declare function normalizeBundleLocalPath(value: string | undefined, baseDir: string): string | undefined;
+export declare function normalizeMapPath(path: string): string;
+export declare function mapDirname(path: string): string;
+export declare function validateCapletId(id: string, path: string): void;
+export declare function errorMessage(error: unknown): string;