@caplets/core 0.14.0 → 0.16.0

package/dist/serve/options.d.ts

@@ -0,0 +1,34 @@
+export type ServeTransport = "stdio" | "http";
+export type RawServeOptions = {
+    transport?: string;
+    host?: string;
+    port?: string | number;
+    path?: string;
+    user?: string;
+    password?: string;
+    allowUnauthenticatedHttp?: boolean;
+};
+export type StdioServeOptions = {
+    transport: "stdio";
+};
+export type HttpServeOptions = {
+    transport: "http";
+    host: string;
+    port: number;
+    path: string;
+    auth: HttpBasicAuthOptions;
+    warnUnauthenticatedNetwork: boolean;
+    loopback: boolean;
+};
+export type HttpBasicAuthOptions = {
+    enabled: false;
+    user: string;
+} | {
+    enabled: true;
+    user: string;
+    password: string;
+};
+export type ServeOptions = StdioServeOptions | HttpServeOptions;
+export type ServeEnv = Partial<Record<"CAPLETS_SERVER_USER" | "CAPLETS_SERVER_PASSWORD", string>>;
+export declare function resolveServeOptions(raw: RawServeOptions, env?: ServeEnv): ServeOptions;
+export declare function isLoopbackHost(host: string): boolean;

package/dist/serve/session.d.ts

@@ -0,0 +1,21 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { CapletsEngine } from "../engine";
+export type ToolServer = Pick<McpServer, "registerTool" | "connect" | "close">;
+export type CapletsMcpSessionOptions = {
+    server?: ToolServer;
+};
+export declare class CapletsMcpSession {
+    private readonly engine;
+    readonly server: ToolServer;
+    private readonly tools;
+    private readonly unsubscribeReload;
+    private closed;
+    constructor(engine: CapletsEngine, options?: CapletsMcpSessionOptions);
+    connect(transport: Transport): Promise<void>;
+    registeredToolIds(): string[];
+    close(): Promise<void>;
+    private reconcileTools;
+    private registerCapletTool;
+    private handleTool;
+}

package/dist/serve/stdio.d.ts

@@ -0,0 +1,5 @@
+import { type CapletsEngineOptions } from "../engine";
+export type ServeStdioOptions = CapletsEngineOptions & {
+    signalHandling?: boolean;
+};
+export declare function serveStdio(options?: ServeStdioOptions): Promise<void>;

package/dist/tool-search.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare function searchToolList<T>(tools: Tool[], query: string, limit: number, compact: (tool: Tool) => T): T[];

package/dist/tools.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { CapletSetManager } from "./caplet-sets";
+import type { CapletConfig } from "./config";
+import type { CliToolsManager } from "./cli-tools";
+import type { DownstreamManager } from "./downstream";
+import type { GraphQLManager } from "./graphql";
+import type { HttpActionManager } from "./http-actions";
+import type { OpenApiManager } from "./openapi";
+import type { ServerRegistry } from "./registry";
+export declare const generatedToolInputSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        get_caplet: "get_caplet";
+        check_backend: "check_backend";
+        list_tools: "list_tools";
+        search_tools: "search_tools";
+        get_tool: "get_tool";
+        call_tool: "call_tool";
+    }>;
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    tool: z.ZodOptional<z.ZodString>;
+    arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type GeneratedServerToolRequest = z.infer<typeof generatedToolInputSchema>;
+export declare function handleServerTool(server: CapletConfig, request: unknown, registry: ServerRegistry, downstream: DownstreamManager, openapi?: OpenApiManager, graphql?: GraphQLManager, http?: HttpActionManager, cli?: CliToolsManager, caplets?: CapletSetManager): Promise<any>;
+export declare function validateOperationRequest(request: unknown, maxSearchLimit: number): RequiredOperationRequest;
+type RequiredOperationRequest = {
+    operation: "get_caplet" | "check_backend";
+} | {
+    operation: "list_tools";
+    limit?: number;
+} | {
+    operation: "search_tools";
+    query: string;
+    limit?: number;
+} | {
+    operation: "get_tool";
+    tool: string;
+} | {
+    operation: "call_tool";
+    tool: string;
+    arguments: Record<string, unknown>;
+    fields?: string[];
+};
+export type CapletArtifact = {
+    kind: "screenshot" | "snapshot" | "console-log" | "network-log" | "file";
+    displayPath: string;
+    pathResolution: "absolute" | "relative-to-mcp-server";
+};
+export type CapletResultMetadata = {
+    id: string;
+    name: string;
+    backend: string;
+    operation: RequiredOperationRequest["operation"];
+    tool?: string;
+    status: "ok" | "error";
+    elapsedMs?: number;
+    artifacts?: CapletArtifact[];
+};
+export declare function metadataFor(server: CapletConfig, operation: RequiredOperationRequest["operation"], tool?: string, startedAt?: number): CapletResultMetadata;
+export declare function jsonResult(value: unknown, metadata?: CapletResultMetadata): CallToolResult;
+export declare function annotateCallToolResult<T extends object>(result: T, metadata: CapletResultMetadata): T & CallToolResult;
+export declare function projectCallToolResult<T extends object>(result: T, outputSchema: unknown, fields: string[]): T & CallToolResult;
+export declare function extractArtifacts(result: unknown): CapletArtifact[];
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caplets/core",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Core runtime library for Caplets progressive disclosure gateways.",
   "keywords": [
     "caplets",
@@ -21,31 +21,44 @@
     "directory": "packages/core"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "type": "module",
   "main": "dist/index.js",
   "exports": {
-    ".": "./dist/index.js",
-    "./generated-tool-input-schema": "./dist/generated-tool-input-schema.js",
-    "./native": "./dist/native.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./generated-tool-input-schema": {
+      "types": "./dist/generated-tool-input-schema.d.ts",
+      "default": "./dist/generated-tool-input-schema.js"
+    },
+    "./native": {
+      "types": "./dist/native.d.ts",
+      "default": "./dist/native.js"
+    }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
+    "@hono/mcp": "^0.3.0",
+    "@hono/node-server": "^1.19.14",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^14.0.3",
     "graphql": "^16.14.0",
+    "hono": "^4.12.19",
     "vfile": "^6.0.3",
     "vfile-matter": "^5.0.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.7.0",
-    "@typescript/native-preview": "7.0.0-dev.20260515.1",
-    "rolldown": "^1.0.0",
+    "@types/node": "^25.9.0",
+    "@typescript/native-preview": "7.0.0-dev.20260518.1",
+    "rolldown": "^1.0.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.6"
   },
@@ -53,7 +66,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "rm -rf dist && rolldown -c",
+    "build": "rm -rf dist && rolldown -c && tsc -p tsconfig.build.json",
     "build:watch": "rolldown -c --watch",
     "typecheck": "tsgo --noEmit",
     "test": "vitest run"