@caplets/core 0.19.0 → 0.20.0

package/dist/stable-json.d.ts

@@ -0,0 +1,3 @@
+export declare function stableJsonValue(value: unknown): unknown;
+export declare function stableJsonStringify(value: unknown): string;
+export declare function stableJsonSha256Hex(value: unknown): Promise<string>;

package/dist/stable-json.js

@@ -0,0 +1,26 @@
+//#region src/stable-json.ts
+function stableJsonValue(value) {
+	if (Array.isArray(value)) return value.map((item) => stableJsonValue(item));
+	if (isPlainObject(value)) {
+		const sorted = {};
+		for (const key of Object.keys(value).sort()) {
+			const item = value[key];
+			if (item !== void 0) sorted[key] = stableJsonValue(item);
+		}
+		return sorted;
+	}
+	return value;
+}
+function stableJsonStringify(value) {
+	return JSON.stringify(stableJsonValue(value));
+}
+async function stableJsonSha256Hex(value) {
+	const bytes = new TextEncoder().encode(stableJsonStringify(value));
+	const digest = await globalThis.crypto.subtle.digest("SHA-256", bytes);
+	return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function isPlainObject(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+//#endregion
+export { stableJsonSha256Hex, stableJsonStringify, stableJsonValue };

package/dist/tools.d.ts

@@ -6,43 +6,54 @@ import type { DownstreamManager } from "./downstream";
 import type { GraphQLManager } from "./graphql";
 import type { HttpActionManager } from "./http-actions";
 import type { OpenApiManager } from "./openapi";
+import { type ObservedOutputShapeStore } from "./observed-output-shapes";
 import type { ServerRegistry } from "./registry";
 import { type ResultMarkdownContext } from "./result-content";
 export { generatedToolInputSchema } from "./generated-tool-input-schema";
 export type GeneratedServerToolRequest = RequiredOperationRequest;
-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, backend?: string): RequiredOperationRequest;
+export type HandleServerToolOptions = {
+    observedOutputShapeStore?: ObservedOutputShapeStore | undefined;
+    observedOutputShapeScope?: "local" | "self_hosted" | "cloud" | undefined;
+    workspaceId?: string | undefined;
+    projectFingerprint?: string | undefined;
+};
+export declare function handleServerTool(server: CapletConfig, request: unknown, registry: ServerRegistry, downstream: DownstreamManager, openapi?: OpenApiManager, graphql?: GraphQLManager, http?: HttpActionManager, cli?: CliToolsManager, caplets?: CapletSetManager, options?: HandleServerToolOptions): Promise<any>;
+export declare function validateOperationRequest(request: unknown, _maxSearchLimit: number, backend?: string): RequiredOperationRequest;
 type RequiredOperationRequest = {
-    operation: "inspect" | "check_backend";
+    operation: "inspect" | "check";
 } | {
-    operation: "list_tools";
+    operation: "tools";
     limit?: number;
+    cursor?: string;
 } | {
     operation: "search_tools";
     query: string;
     limit?: number;
+    cursor?: string;
 } | {
-    operation: "get_tool";
-    tool: string;
+    operation: "describe_tool";
+    name: string;
 } | {
     operation: "call_tool";
-    tool: string;
-    arguments: Record<string, unknown>;
+    name: string;
+    args: Record<string, unknown>;
     fields?: string[];
 } | {
-    operation: "list_resources" | "list_resource_templates" | "list_prompts";
+    operation: "resources" | "resource_templates" | "prompts";
     limit?: number;
+    cursor?: string;
 } | {
     operation: "search_resources" | "search_prompts";
     query: string;
     limit?: number;
+    cursor?: string;
 } | {
     operation: "read_resource";
     uri: string;
 } | {
     operation: "get_prompt";
-    prompt: string;
-    arguments: Record<string, unknown>;
+    name: string;
+    args: Record<string, unknown>;
 } | {
     operation: "complete";
     ref: {

package/dist/{validation-BBG4skZf.js → validation-CdqbI2zN.js}

@@ -1,3 +1,26 @@
+//#region src/redaction.ts
+const SECRET_KEY_PATTERN = /(token|secret|authorization|auth|api[-_]?key|password|credential|clientsecret|client_secret|code|refresh)/iu;
+const SECRET_TEXT_PATTERNS = [
+	/(Authorization:\s*Bearer\s+)[0-9A-Za-z._~+/=-]+/giu,
+	/(bearer\s+)[a-z0-9._~+/=-]+/giu,
+	/([?&](?:access_token|refresh_token|token|code)=)[^&\s]+/giu
+];
+function isSecretKey(key) {
+	return SECRET_KEY_PATTERN.test(key);
+}
+function redactSecretText(value, options = {}) {
+	const replacement = options.replacement ?? "[REDACTED]";
+	let text = value;
+	for (const pattern of [...options.patterns ?? [], ...SECRET_TEXT_PATTERNS]) text = text.replace(pattern, (...args) => {
+		return `${typeof args[1] === "string" ? args[1] : ""}${replacement}`;
+	});
+	for (const secret of options.additionalSecrets?.filter(Boolean) ?? []) text = text.split(secret).join(replacement);
+	return {
+		text,
+		redacted: text !== value
+	};
+}
+//#endregion
 //#region src/errors.ts
 const CAPLETS_ERROR_CODES = [
 	"CONFIG_NOT_FOUND",
@@ -34,14 +57,12 @@ var CapletsError = class extends Error {
 		this.details = details;
 	}
 };
-const SECRET_KEY_PATTERN = /(token|secret|authorization|auth|api[-_]?key|password|credential|clientsecret|client_secret|code|refresh)/i;
-const SECRET_VALUE_PATTERN = /(bearer\s+)[a-z0-9._~+/=-]+|([?&](?:access_token|refresh_token|token|code)=)[^&\s]+/gi;
 function redactSecrets(value) {
-	if (typeof value === "string") return value.replace(SECRET_VALUE_PATTERN, "$1$2[REDACTED]");
+	if (typeof value === "string") return redactSecretText(value).text;
 	if (Array.isArray(value)) return value.map((item) => redactSecrets(item));
 	if (value && typeof value === "object") {
 		const redacted = {};
-		for (const [key, nested] of Object.entries(value)) redacted[key] = SECRET_KEY_PATTERN.test(key) ? "[REDACTED]" : redactSecrets(nested);
+		for (const [key, nested] of Object.entries(value)) redacted[key] = isSecretKey(key) ? "[REDACTED]" : redactSecrets(nested);
 		return redacted;
 	}
 	return value;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@caplets/core",
-  "version": "0.19.0",
-  "description": "Core runtime library for Caplets progressive disclosure gateways.",
+  "version": "0.20.0",
+  "description": "Core runtime library for Caplets Code Mode and progressive disclosure gateways.",
   "keywords": [
     "caplets",
     "gateway",
@@ -47,10 +47,34 @@
       "types": "./dist/caplet-source/filesystem.d.ts",
       "default": "./dist/caplet-source/filesystem.js"
     },
+    "./code-mode": {
+      "types": "./dist/code-mode/index.d.ts",
+      "default": "./dist/code-mode.js"
+    },
+    "./observed-output-shapes": {
+      "types": "./dist/observed-output-shapes/index.d.ts",
+      "default": "./dist/observed-output-shapes.js"
+    },
+    "./observed-output-shapes/pure": {
+      "types": "./dist/observed-output-shapes/pure.d.ts",
+      "default": "./dist/observed-output-shapes/pure.js"
+    },
+    "./project-binding": {
+      "types": "./dist/project-binding/index.d.ts",
+      "default": "./dist/project-binding.js"
+    },
+    "./redaction": {
+      "types": "./dist/redaction.d.ts",
+      "default": "./dist/redaction.js"
+    },
     "./runtime-plan": {
       "types": "./dist/runtime-plan/index.d.ts",
       "default": "./dist/runtime-plan.js"
     },
+    "./stable-json": {
+      "types": "./dist/stable-json.d.ts",
+      "default": "./dist/stable-json.js"
+    },
     "./config-runtime": {
       "types": "./dist/config-runtime.d.ts",
       "default": "./dist/config-runtime.js"
@@ -64,9 +88,12 @@
     "@hono/mcp": "^0.3.0",
     "@hono/node-server": "^2.0.4",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "ajv": "^8.20.0",
     "commander": "^15.0.0",
     "graphql": "^16.14.1",
     "hono": "^4.12.23",
+    "quickjs-emscripten": "^0.32.0",
+    "typescript": "^6.0.3",
     "vfile": "^6.0.3",
     "vfile-matter": "^5.0.1",
     "yaml": "^2.9.0",
@@ -76,7 +103,6 @@
     "@types/node": "^25.9.1",
     "@typescript/native-preview": "7.0.0-dev.20260603.1",
     "rolldown": "^1.0.3",
-    "typescript": "^6.0.3",
     "vitest": "^4.1.8"
   },
   "engines": {