@actiondock/core 2.6.0 → 2.7.0

package/dist/runtime/runner.d.ts

@@ -5,18 +5,8 @@ import type { Clock } from "./clock.js";
 import type { RuntimePlatform } from "../platform/types.js";
 import type { ProcessOwner } from "../process/index.js";
 export { RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, MAX_SUBRUNS_REACHED, ACTION_CALL_CYCLE, ACTION_CYCLE_DETECTED, ACTION_MAX_DEPTH_EXCEEDED, } from "../errors.js";
-/**
- * 校验值是否为合法的 JSON 兼容结构，严禁 NaN、Infinity、循环引用及不可序列化类型。
- *
- * 环路检测采用「当前递归路径栈」语义：对象仅在自身子树遍历期间保持标记，
- * 子树遍历完成后立即移除，从而正确放行共享子对象的有向无环结构（如 {a: shared, b: shared}）。
- */
-export declare function validateJsonValue(val: unknown, stack?: WeakSet<object>): {
-    valid: true;
-} | {
-    valid: false;
-    reason: string;
-};
+import { validateJsonValue, validateActionInputValue, assertJsonValue, type ValidateJsonOptions, type ValidateActionInputOptions } from "../json/value-validator.js";
+export { validateJsonValue, validateActionInputValue, assertJsonValue, type ValidateJsonOptions, type ValidateActionInputOptions, };
 /**
  * 跨包运行上下文解析结果契约。
  */

package/dist/runtime/runner.js

@@ -4,62 +4,16 @@ import { ActionResolver } from "../catalog/action-resolver.js";
 import { loadActions, loadProjectConfig } from "../project/loader.js";
 import { resolveActionProject } from "../registry/registry.js";
 import { ACTION_CALL_CYCLE, ACTION_CYCLE_DETECTED, ACTION_FAILED, ACTION_MAX_DEPTH_EXCEEDED, ACTION_NOT_FOUND, ACTION_SUBRUN_LIMIT, ACTION_TIMEOUT, describeActionLoadFailure, INPUT_NOT_JSON, MAX_SUBRUNS_REACHED, OUTPUT_NOT_JSON, ACTION_CANCELLED, PACKAGE_NOT_FOUND, INPUT_VALIDATION_FAILED, OUTPUT_VALIDATION_FAILED, UNDECLARED_ACTION_DEPENDENCY, } from "../errors.js";
-import { validateSchema } from "../schema/validator.js";
+import { validateSchemaOnly } from "../schema/validator.js";
 import { createActionContext, StderrLogger } from "./context.js";
 import { ActionRegistry, findLocalAction, isActionDefinitionObject, parseActionRef, resolveAnonymousActionId, } from "./action-registry.js";
 import { buildInitialRunRecord, createRunFinalizer, createRunOrThrow, tryCreateRun, } from "./run-persistence.js";
 import { PackageRunnerFactory } from "./package-runner-factory.js";
 // 错误码常量已收敛至 src/errors.ts 单一事实源，此处保留 re-export 以维持既有导入路径兼容。
 export { RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, MAX_SUBRUNS_REACHED, ACTION_CALL_CYCLE, ACTION_CYCLE_DETECTED, ACTION_MAX_DEPTH_EXCEEDED, } from "../errors.js";
-/**
- * 校验值是否为合法的 JSON 兼容结构，严禁 NaN、Infinity、循环引用及不可序列化类型。
- *
- * 环路检测采用「当前递归路径栈」语义：对象仅在自身子树遍历期间保持标记，
- * 子树遍历完成后立即移除，从而正确放行共享子对象的有向无环结构（如 {a: shared, b: shared}）。
- */
-export function validateJsonValue(val, stack = new WeakSet()) {
-    if (val === null || typeof val === "boolean" || typeof val === "string") {
-        return { valid: true };
-    }
-    if (typeof val === "number") {
-        if (!Number.isFinite(val) || Number.isNaN(val)) {
-            return { valid: false, reason: `Number is non-finite or NaN (${val})` };
-        }
-        return { valid: true };
-    }
-    if (typeof val === "undefined" || typeof val === "function" || typeof val === "symbol" || typeof val === "bigint") {
-        return { valid: false, reason: `Unsupported JSON type '${typeof val}'` };
-    }
-    if (typeof val === "object") {
-        if (stack.has(val)) {
-            return { valid: false, reason: "Circular reference detected in object structure" };
-        }
-        stack.add(val);
-        try {
-            if (Array.isArray(val)) {
-                for (const item of val) {
-                    const res = validateJsonValue(item, stack);
-                    if (!res.valid)
-                        return res;
-                }
-                return { valid: true };
-            }
-            for (const v of Object.values(val)) {
-                if (v !== undefined) {
-                    const res = validateJsonValue(v, stack);
-                    if (!res.valid)
-                        return res;
-                }
-            }
-            return { valid: true };
-        }
-        finally {
-            // 无论正常返回还是提前返回，均须将当前对象移出路径栈，避免祖先对象被误判为环路
-            stack.delete(val);
-        }
-    }
-    return { valid: true };
-}
+import { validateJsonValue, validateActionInputValue, assertJsonValue, } from "../json/value-validator.js";
+// 复用统一迭代式 JsonValue 校验器，杜绝深层递归栈溢出，并保持既有导出兼容
+export { validateJsonValue, validateActionInputValue, assertJsonValue, };
 /**
  * ActionDock 核心执行引擎（ActionRunner）。
  *
@@ -300,14 +254,20 @@ export class ActionRunner {
     start(actionOrId, input = {}, options = {}) {
         const runCtx = this.prepareRunContext(actionOrId, input, options);
         const { runId, targetActionId, targetPackageId } = runCtx;
-        // 输入参数 JSON 格式与合法性防御校验（拦截 NaN/Infinity/循环引用等非 JSON 类型）
-        const inputCheck = validateJsonValue(input);
+        // 输入参数 JSON 格式与合法性防御校验（拦截 NaN/Infinity/循环引用等非 JSON 类型及非法原型键策略违规）
+        const inputCheck = validateActionInputValue(input);
         if (!inputCheck.valid) {
-            const error = {
-                code: INPUT_NOT_JSON,
-                message: `Input validation failed for action '${targetActionId}': ${inputCheck.reason}`,
-            };
-            // 安全记录 failed 状态（不可序列化的非法 input 严禁直接写入持久化存储）
+            const error = inputCheck.kind === "json-value"
+                ? {
+                    code: INPUT_NOT_JSON,
+                    message: `Input validation failed for action '${targetActionId}': ${inputCheck.reason}`,
+                }
+                : {
+                    code: INPUT_VALIDATION_FAILED,
+                    message: `Input validation failed for action '${targetActionId}': ${inputCheck.reason}`,
+                    details: [inputCheck.reason],
+                };
+            // 安全记录 failed 状态（不可序列化或策略违规的非法 input 严禁直接写入持久化存储）
             tryCreateRun(this.storage, buildInitialRunRecord(this.buildRunPersistenceInput(runCtx), "failed", error));
             return {
                 runId,
@@ -516,9 +476,11 @@ export class ActionRunner {
      * 输入参数 JSON Schema 校验（若 action 已就绪，返回校验错误或 undefined）。
      */
     checkActionInputSchema(action, targetActionId, input) {
-        const targetInputSchema = action?.inputSchema ?? this.projectConfig?.actions?.[targetActionId]?.inputSchema;
-        if (targetInputSchema) {
-            const val = validateSchema(targetInputSchema, input);
+        const targetInputSchema = action?.inputSchema !== undefined
+            ? action.inputSchema
+            : this.projectConfig?.actions?.[targetActionId]?.inputSchema;
+        if (targetInputSchema !== undefined) {
+            const val = validateSchemaOnly(targetInputSchema, input);
             if (!val.valid) {
                 return {
                     code: INPUT_VALIDATION_FAILED,
@@ -729,12 +691,18 @@ export class ActionRunner {
                         finalizer.finalize("failed", undefined, error);
                         return { ok: false, runId, error };
                     }
-                    const inputCheck = validateJsonValue(input);
+                    const inputCheck = validateActionInputValue(input);
                     if (!inputCheck.valid) {
-                        const error = {
-                            code: INPUT_NOT_JSON,
-                            message: `Input validation failed for action '${targetActionId}': ${inputCheck.reason}`,
-                        };
+                        const error = inputCheck.kind === "json-value"
+                            ? {
+                                code: INPUT_NOT_JSON,
+                                message: `Input validation failed for action '${targetActionId}': ${inputCheck.reason}`,
+                            }
+                            : {
+                                code: INPUT_VALIDATION_FAILED,
+                                message: `Input validation failed for action '${targetActionId}': ${inputCheck.reason}`,
+                                details: [inputCheck.reason],
+                            };
                         finalizer.finalize("failed", undefined, error);
                         return { ok: false, runId, error };
                     }
@@ -795,9 +763,11 @@ export class ActionRunner {
      * 输出结果 Schema 校验（返回校验错误或 undefined）。
      */
     checkActionOutputSchema(action, targetActionId, rawOutput) {
-        const targetOutputSchema = action?.outputSchema ?? this.projectConfig?.actions?.[targetActionId]?.outputSchema;
-        if (targetOutputSchema) {
-            const outVal = validateSchema(targetOutputSchema, rawOutput);
+        const targetOutputSchema = action?.outputSchema !== undefined
+            ? action.outputSchema
+            : this.projectConfig?.actions?.[targetActionId]?.outputSchema;
+        if (targetOutputSchema !== undefined) {
+            const outVal = validateSchemaOnly(targetOutputSchema, rawOutput);
             if (!outVal.valid) {
                 return {
                     code: OUTPUT_VALIDATION_FAILED,

package/dist/runtime/standalone.d.ts

@@ -11,6 +11,13 @@ export declare const ExitCode: {
     readonly INVALID_ARGUMENT: 2;
     readonly SIGINT: 130;
 };
+/**
+ * 调用控制选项契约。
+ */
+export interface InvocationControl {
+    signal?: AbortSignal;
+    cancellationSource?: "external" | "sigint";
+}
 /**
  * 独立二进制运行分发器配置选项。
  */
@@ -63,9 +70,10 @@ export declare class StandaloneDispatcher {
      * 解析命令行参数并分发执行对应子命令。
      *
      * @param argv 命令行参数数组（如 process.argv.slice(2)）
+     * @param control 可选的中断与取消控制契约
      * @returns 退出状态码（0: 成功, 1: 失败, 2: 参数错误, 130: 中断）
      */
-    dispatch(argv: string[]): Promise<number>;
+    dispatch(argv: string[], control?: InvocationControl): Promise<number>;
     private handleList;
     private handleDescribe;
     private handleRun;
@@ -97,3 +105,8 @@ export declare class StandaloneRuntime {
  * 工厂函数：创建独立运行时实例。
  */
 export declare function createStandaloneRuntime(options: StandaloneRuntimeOptions): StandaloneRuntime;
+/**
+ * 独立二进制进程入口适配器。
+ * 仅在命令行可执行入口调用，负责全局 SIGINT 监听与退出状态码写入。
+ */
+export declare function runStandaloneProcess(argv: string[], options: StandaloneDispatcherOptions): Promise<void>;

package/dist/runtime/standalone.js

@@ -1,8 +1,9 @@
-import { readFileSync } from "node:fs";
 import { decodeStateKey } from "@actiondock/sdk";
 import { filterWithFallbackInfo } from "../filter/index.js";
 import { createActionDockTarget } from "../target/target.js";
 import { STANDALONE_ASYNC_UNSUPPORTED } from "../errors.js";
+import { resolveActionInput, formatActionDetail, buildActionDescribePayload, mapInputValidationFailure, } from "../input/index.js";
+import { validateActionInputValue } from "../json/value-validator.js";
 import { normalizeActionCollection } from "./action-collection.js";
 import { parseDuration } from "../utils/index.js";
 /**
@@ -84,24 +85,27 @@ export class StandaloneDispatcher {
      * 解析命令行参数并分发执行对应子命令。
      *
      * @param argv 命令行参数数组（如 process.argv.slice(2)）
+     * @param control 可选的中断与取消控制契约
      * @returns 退出状态码（0: 成功, 1: 失败, 2: 参数错误, 130: 中断）
      */
-    async dispatch(argv) {
-        const args = [...argv];
+    async dispatch(argv, control) {
+        const separator = argv.indexOf("--");
+        const controlArgs = separator >= 0 ? argv.slice(0, separator) : argv;
+        const actionArgs = separator >= 0 ? argv.slice(separator + 1) : [];
         let dataDir;
         const configOverrides = {};
-        // 1. 提取全局参数（--data-dir, --config）
+        // 1. 提取全局参数（--data-dir, --config）仅从 controlArgs 中解析
         const filteredArgs = [];
-        for (let i = 0; i < args.length; i++) {
-            const arg = args[i];
-            if (arg === "--data-dir" && i + 1 < args.length) {
-                dataDir = args[++i];
+        for (let i = 0; i < controlArgs.length; i++) {
+            const arg = controlArgs[i];
+            if (arg === "--data-dir" && i + 1 < controlArgs.length) {
+                dataDir = controlArgs[++i];
             }
             else if (arg.startsWith("--data-dir=")) {
                 dataDir = arg.slice(11);
             }
-            else if (arg === "--config" && i + 1 < args.length) {
-                const pair = args[++i];
+            else if (arg === "--config" && i + 1 < controlArgs.length) {
+                const pair = controlArgs[++i];
                 const [k, ...v] = pair.split("=");
                 if (k)
                     configOverrides[k] = v.join("=");
@@ -119,8 +123,8 @@ export class StandaloneDispatcher {
         const command = filteredArgs[0] || "help";
         const subArgs = filteredArgs.slice(1);
         // 2. 独立入口拒绝异步启动语义
-        if (args.includes("--async")) {
-            const isJson = args.includes("--json");
+        if (controlArgs.includes("--async")) {
+            const isJson = controlArgs.includes("--json");
             if (isJson) {
                 this.writeOut(JSON.stringify({
                     ok: false,
@@ -155,39 +159,44 @@ export class StandaloneDispatcher {
             this.writeErr(`Error initializing standalone target: ${err?.message || err}`);
             return ExitCode.FAILURE;
         }
-        const controller = new AbortController();
-        const sigintHandler = () => {
-            controller.abort(new Error("Interrupted by SIGINT"));
-        };
-        process.once("SIGINT", sigintHandler);
         try {
+            let code;
             switch (command) {
                 case "list":
-                    return await this.handleList(target, subArgs);
+                    code = await this.handleList(target, subArgs);
+                    break;
                 case "describe":
                 case "show":
-                    return await this.handleDescribe(target, subArgs);
+                    code = await this.handleDescribe(target, subArgs);
+                    break;
                 case "run":
-                    return await this.handleRun(target, subArgs, controller.signal);
+                    code = await this.handleRun(target, subArgs, actionArgs, control?.signal);
+                    break;
                 case "config":
-                    return await this.handleConfig(target, subArgs);
+                    code = await this.handleConfig(target, subArgs);
+                    break;
                 case "state":
-                    return await this.handleState(target, subArgs);
+                    code = await this.handleState(target, subArgs);
+                    break;
                 default:
                     this.writeErr(`Unknown command: '${command}'`);
                     this.printHelp();
                     return ExitCode.INVALID_ARGUMENT;
             }
+            if (control?.cancellationSource === "sigint" && control?.signal?.aborted) {
+                return ExitCode.SIGINT;
+            }
+            return code;
         }
         catch (err) {
-            if (err?.name === "AbortError" || controller.signal.aborted) {
+            if (control?.cancellationSource === "sigint" &&
+                (control?.signal?.aborted || err?.name === "AbortError" || err?.message?.includes("SIGINT"))) {
                 return ExitCode.SIGINT;
             }
             this.writeErr(`Error: ${err?.message || err}`);
             return ExitCode.FAILURE;
         }
         finally {
-            process.removeListener("SIGINT", sigintHandler);
             if (ownsTarget) {
                 await target.close();
             }
@@ -237,7 +246,18 @@ export class StandaloneDispatcher {
         const id = subArgs.find((a) => !a.startsWith("-"));
         const isJson = subArgs.includes("--json");
         if (!id) {
-            this.writeErr("Error: Action ID is required for describe");
+            if (isJson) {
+                this.writeOut(JSON.stringify({
+                    ok: false,
+                    error: {
+                        code: "INVALID_ARGUMENT",
+                        message: "Action ID is required for describe",
+                    },
+                }, null, 2));
+            }
+            else {
+                this.writeErr("Error: Action ID is required for describe");
+            }
             return ExitCode.INVALID_ARGUMENT;
         }
         let action;
@@ -245,81 +265,136 @@ export class StandaloneDispatcher {
             action = await target.describeAction(id);
         }
         catch {
-            this.writeErr(`Error: Action '${id}' not found`);
+            if (isJson) {
+                this.writeOut(JSON.stringify({
+                    ok: false,
+                    error: {
+                        code: "INVALID_ARGUMENT",
+                        message: `Action '${id}' not found`,
+                    },
+                }, null, 2));
+            }
+            else {
+                this.writeErr(`Error: Action '${id}' not found`);
+            }
             return ExitCode.INVALID_ARGUMENT;
         }
-        const detail = {
-            id: action.id,
+        const payload = buildActionDescribePayload(action, {
             packageId: this.options.packageId,
-            description: action.description,
-            inputSchema: action.inputSchema,
-            outputSchema: action.outputSchema,
-        };
+        });
         if (isJson) {
-            this.writeOut(JSON.stringify(detail, null, 2));
+            this.writeOut(JSON.stringify(payload, null, 2));
         }
         else {
-            let text = `Action: ${action.id}\n`;
-            if (action.description)
-                text += `Description: ${action.description}\n`;
-            if (action.inputSchema) {
-                text += `\nInput Schema:\n${JSON.stringify(action.inputSchema, null, 2)}\n`;
-            }
-            if (action.outputSchema) {
-                text += `\nOutput Schema:\n${JSON.stringify(action.outputSchema, null, 2)}\n`;
-            }
-            this.writeOut(text.trimEnd());
+            this.writeOut(formatActionDetail(payload));
         }
         return ExitCode.SUCCESS;
     }
-    async handleRun(target, subArgs, signal) {
+    async handleRun(target, subArgs, actionArgs, signal) {
+        const isJson = subArgs.includes("--json");
         const id = subArgs.find((a) => !a.startsWith("-"));
         if (!id) {
-            this.writeErr("Error: Action ID is required for run");
+            if (isJson) {
+                this.writeOut(JSON.stringify({
+                    ok: false,
+                    error: {
+                        code: "INVALID_ARGUMENT",
+                        message: "Error: Action ID is required for run",
+                    },
+                }, null, 2));
+            }
+            else {
+                this.writeErr("Error: Action ID is required for run");
+            }
             return ExitCode.INVALID_ARGUMENT;
         }
-        let input = {};
+        let inputStr;
+        let inputFile;
         let timeoutMs;
-        let isJson = false;
         for (let i = 0; i < subArgs.length; i++) {
             const arg = subArgs[i];
-            if (arg === "--json") {
-                isJson = true;
-            }
-            else if (arg === "--timeout" && i + 1 < subArgs.length) {
-                timeoutMs = parseDuration(subArgs[++i]);
-            }
-            else if (arg.startsWith("--timeout=")) {
-                timeoutMs = parseDuration(arg.slice(10));
-            }
-            else if (arg === "--input" && i + 1 < subArgs.length) {
+            if (arg === "--timeout" && i + 1 < subArgs.length) {
                 try {
-                    input = JSON.parse(subArgs[++i]);
+                    timeoutMs = parseDuration(subArgs[++i]);
                 }
-                catch (e) {
-                    this.writeErr(`Error parsing --input JSON: ${e.message}`);
+                catch (err) {
+                    if (isJson) {
+                        this.writeOut(JSON.stringify({
+                            ok: false,
+                            error: {
+                                code: "INVALID_ARGUMENT",
+                                message: `Invalid timeout format: ${err?.message || err}`,
+                            },
+                        }, null, 2));
+                    }
+                    else {
+                        this.writeErr(`Error: Invalid timeout format: ${err?.message || err}`);
+                    }
                     return ExitCode.INVALID_ARGUMENT;
                 }
             }
-            else if (arg.startsWith("--input=")) {
+            else if (arg.startsWith("--timeout=")) {
                 try {
-                    input = JSON.parse(arg.slice(8));
+                    timeoutMs = parseDuration(arg.slice(10));
                 }
-                catch (e) {
-                    this.writeErr(`Error parsing --input JSON: ${e.message}`);
+                catch (err) {
+                    if (isJson) {
+                        this.writeOut(JSON.stringify({
+                            ok: false,
+                            error: {
+                                code: "INVALID_ARGUMENT",
+                                message: `Invalid timeout format: ${err?.message || err}`,
+                            },
+                        }, null, 2));
+                    }
+                    else {
+                        this.writeErr(`Error: Invalid timeout format: ${err?.message || err}`);
+                    }
                     return ExitCode.INVALID_ARGUMENT;
                 }
             }
+            else if (arg === "--input" && i + 1 < subArgs.length) {
+                inputStr = subArgs[++i];
+            }
+            else if (arg.startsWith("--input=")) {
+                inputStr = arg.slice(8);
+            }
             else if (arg === "--input-file" && i + 1 < subArgs.length) {
-                try {
-                    input = JSON.parse(readFileSync(subArgs[++i], "utf-8"));
-                }
-                catch (e) {
-                    this.writeErr(`Error reading --input-file: ${e.message}`);
-                    return ExitCode.INVALID_ARGUMENT;
-                }
+                inputFile = subArgs[++i];
+            }
+            else if (arg.startsWith("--input-file=")) {
+                inputFile = arg.slice(13);
+            }
+        }
+        let input;
+        try {
+            input = await resolveActionInput({
+                input: inputStr,
+                inputFile,
+                flatArgs: actionArgs.length > 0 ? actionArgs : undefined,
+                stdin: process.stdin,
+            });
+            const check = validateActionInputValue(input);
+            if (!check.valid) {
+                throw mapInputValidationFailure("cli-pre-target", check);
             }
         }
+        catch (err) {
+            if (isJson) {
+                this.writeOut(JSON.stringify({
+                    ok: false,
+                    error: {
+                        code: err?.code || "INVALID_ARGUMENT",
+                        message: err?.message || String(err),
+                        ...(err?.details !== undefined ? { details: err.details } : {}),
+                    },
+                }, null, 2));
+            }
+            else {
+                this.writeErr(`Error: ${err?.message || String(err)}`);
+            }
+            return ExitCode.INVALID_ARGUMENT;
+        }
         const result = await target.runAction(id, input, {
             signal,
             timeoutMs,
@@ -646,3 +721,34 @@ export class StandaloneRuntime {
 export function createStandaloneRuntime(options) {
     return new StandaloneRuntime(options);
 }
+/**
+ * 独立二进制进程入口适配器。
+ * 仅在命令行可执行入口调用，负责全局 SIGINT 监听与退出状态码写入。
+ */
+export async function runStandaloneProcess(argv, options) {
+    const controller = new AbortController();
+    const control = {
+        signal: controller.signal,
+    };
+    let sigintCount = 0;
+    const sigintHandler = () => {
+        sigintCount++;
+        if (sigintCount === 1) {
+            control.cancellationSource = "sigint";
+            controller.abort(new Error("Interrupted by SIGINT"));
+        }
+        else {
+            process.exitCode = 130;
+            process.exit(130);
+        }
+    };
+    process.on("SIGINT", sigintHandler);
+    try {
+        const dispatcher = new StandaloneDispatcher(options);
+        const exitCode = await dispatcher.dispatch(argv, control);
+        process.exitCode = exitCode;
+    }
+    finally {
+        process.removeListener("SIGINT", sigintHandler);
+    }
+}

package/dist/schema/index.d.ts

@@ -0,0 +1 @@
+export * from "./validator.js";

package/dist/schema/index.js

@@ -0,0 +1 @@
+export * from "./validator.js";

package/dist/schema/validator.d.ts

@@ -10,8 +10,18 @@ export interface ValidationResult {
 }
 /**
  * 递归检查数据中是否包含危险的原型污染属性键名（__proto__、constructor、prototype）。
+ * 内部委托 validateActionInputValue 执行迭代遍历，确保环路安全、有向无环图安全且无调用栈溢出风险。
  */
 export declare function hasDangerousKeys(data: unknown): boolean;
+/**
+ * 内部纯 Schema 校验器。
+ * 仅处理布尔 Schema 与 Ajv 规则校验，严禁执行 dangerous-key 遍历。
+ *
+ * @param schema 期望匹配的 JSON Schema 对象
+ * @param data 待校验的原始数据
+ * @returns 包含 valid 状态与错误信息列表的 ValidationResult
+ */
+export declare function validateSchemaOnly(schema: JsonSchema | undefined, data: unknown): ValidationResult;
 /**
  * 校验指定数据是否符合给定的 JSON Schema 契约。
  *