@lit-protocol/vincent-app-sdk 1.0.1 → 1.0.3-beta.0

package/dist/src/toolClient/execute/types.d.ts

@@ -0,0 +1,38 @@
+import type { z } from 'zod';
+import type { BaseToolContext, PolicyEvaluationResultContext, SchemaValidationError } from '@lit-protocol/vincent-tool-sdk';
+/** @category Interfaces */
+export interface ToolExecuteResponseSuccess<Result, Policies extends Record<string, any>> {
+    success: true;
+    result: Result;
+    context?: BaseToolContext<PolicyEvaluationResultContext<Policies>>;
+}
+/** @category Interfaces */
+export interface ToolExecuteResponseSuccessNoResult<Policies extends Record<string, any>> {
+    success: true;
+    result?: never;
+    context?: BaseToolContext<PolicyEvaluationResultContext<Policies>>;
+}
+/** @category Interfaces */
+export interface ToolExecuteResponseFailure<Result, Policies extends Record<string, any>> {
+    success: false;
+    runtimeError?: string;
+    schemaValidationError?: SchemaValidationError;
+    result: Result;
+    context?: BaseToolContext<PolicyEvaluationResultContext<Policies>>;
+}
+/** @category Interfaces */
+export interface ToolExecuteResponseFailureNoResult<Policies extends Record<string, any>> {
+    success: false;
+    runtimeError?: string;
+    schemaValidationError?: SchemaValidationError;
+    result?: never;
+    context?: BaseToolContext<PolicyEvaluationResultContext<Policies>>;
+}
+/** @category Interfaces */
+export type ToolExecuteResponse<SuccessSchema extends z.ZodType | undefined, FailSchema extends z.ZodType | undefined, Policies extends Record<string, any>> = (SuccessSchema extends z.ZodType ? ToolExecuteResponseSuccess<z.infer<SuccessSchema>, Policies> : ToolExecuteResponseSuccessNoResult<Policies>) | (FailSchema extends z.ZodType ? ToolExecuteResponseFailure<z.infer<FailSchema>, Policies> : ToolExecuteResponseFailureNoResult<Policies>);
+/** @hidden */
+export interface RemoteVincentToolExecutionResult<SuccessSchema extends z.ZodType | undefined, FailSchema extends z.ZodType | undefined, Policies extends Record<string, any>> {
+    toolExecutionResult: ToolExecuteResponse<SuccessSchema, FailSchema, Policies>;
+    toolContext: BaseToolContext<PolicyEvaluationResultContext<Policies>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/toolClient/execute/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/toolClient/execute/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EACV,eAAe,EACf,6BAA6B,EAC7B,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,2BAA2B;AAC3B,MAAM,WAAW,0BAA0B,CAAC,MAAM,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACtF,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC;CACpE;AAED,2BAA2B;AAC3B,MAAM,WAAW,kCAAkC,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACtF,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC;CACpE;AAED,2BAA2B;AAC3B,MAAM,WAAW,0BAA0B,CAAC,MAAM,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACtF,OAAO,EAAE,KAAK,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC;CACpE;AAED,2BAA2B;AAC3B,MAAM,WAAW,kCAAkC,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACtF,OAAO,EAAE,KAAK,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC;CACpE;AAED,2BAA2B;AAC3B,MAAM,MAAM,mBAAmB,CAC7B,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,EAC3C,UAAU,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,EACxC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAElC,CAAC,aAAa,SAAS,CAAC,CAAC,OAAO,GAC5B,0BAA0B,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,GAC5D,kCAAkC,CAAC,QAAQ,CAAC,CAAC,GACjD,CAAC,UAAU,SAAS,CAAC,CAAC,OAAO,GACzB,0BAA0B,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,GACzD,kCAAkC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEtD,cAAc;AACd,MAAM,WAAW,gCAAgC,CAC/C,aAAa,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,EAC3C,UAAU,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,EACxC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEpC,mBAAmB,EAAE,mBAAmB,CAAC,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9E,WAAW,EAAE,eAAe,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC;CACvE"}

package/dist/src/toolClient/execute/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// src/toolClient/execute/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/toolClient/execute/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/toolClient/execute/types.ts"],"names":[],"mappings":";AAAA,kCAAkC"}

package/dist/src/toolClient/index.d.ts

@@ -1,3 +1,19 @@
+/** The VincentToolClient is used to handle all interactions with VincentTools -- both local execution of its precheck()
+ * method and the execution of its `execute()` method via the LIT Action runtime.  The VincentToolClient also handles calling policy
+ * precheck methods when they are defined, and returns all policy precheck results along with the tool precheck result.
+ *
+ * @packageDocumentation
+ */
+export { isToolResponseSuccess, isToolResponseRuntimeFailure, isToolResponseSchemaValidationFailure, isToolResponseFailure, } from './typeGuards';
+import { disconnectLitNodeClientInstance } from '../internal/LitNodeClient/getLitNodeClient';
+/** This method closes any registered event listeners maintained by Vincent Tool Clients, allowing your process to exit gracefully.
+ * @category API
+ */
+declare const disconnectVincentToolClients: typeof disconnectLitNodeClientInstance;
+export { disconnectVincentToolClients };
 export { getVincentToolClient } from './vincentToolClient';
-export { type VincentToolClient, type ToolClientContext, type ToolResponse, type ToolResponseSuccess, type ToolResponseSuccessNoResult, type ToolResponseFailure, type ToolResponseFailureNoResult, type RemoteVincentToolExecutionResult, type BaseToolContext, } from './types';
+export type { VincentToolClient, ToolClientContext, BaseToolContext } from './types';
+export { generateVincentToolSessionSigs } from './execute/generateVincentToolSessionSigs';
+export type { ToolExecuteResponse, ToolExecuteResponseFailureNoResult, ToolExecuteResponseFailure, ToolExecuteResponseSuccessNoResult, ToolExecuteResponseSuccess, } from './execute/types';
+export type { ToolPrecheckResponse, ToolPrecheckResponseFailureNoResult, ToolPrecheckResponseFailure, ToolPrecheckResponseSuccessNoResult, ToolPrecheckResponseSuccess, } from './precheck/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/toolClient/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/toolClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,eAAe,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/toolClient/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,qCAAqC,EACrC,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAE7F;;GAEG;AACH,QAAA,MAAM,4BAA4B,wCAAkC,CAAC;AACrE,OAAO,EAAE,4BAA4B,EAAE,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAErF,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,YAAY,EACV,mBAAmB,EACnB,kCAAkC,EAClC,0BAA0B,EAC1B,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,oBAAoB,EACpB,mCAAmC,EACnC,2BAA2B,EAC3B,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/src/toolClient/index.js

@@ -1,6 +1,26 @@
 "use strict";
+/** The VincentToolClient is used to handle all interactions with VincentTools -- both local execution of its precheck()
+ * method and the execution of its `execute()` method via the LIT Action runtime.  The VincentToolClient also handles calling policy
+ * precheck methods when they are defined, and returns all policy precheck results along with the tool precheck result.
+ *
+ * @packageDocumentation
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVincentToolClient = void 0;
+exports.generateVincentToolSessionSigs = exports.getVincentToolClient = exports.disconnectVincentToolClients = exports.isToolResponseFailure = exports.isToolResponseSchemaValidationFailure = exports.isToolResponseRuntimeFailure = exports.isToolResponseSuccess = void 0;
+// src/lib/toolClient/index.ts
+var typeGuards_1 = require("./typeGuards");
+Object.defineProperty(exports, "isToolResponseSuccess", { enumerable: true, get: function () { return typeGuards_1.isToolResponseSuccess; } });
+Object.defineProperty(exports, "isToolResponseRuntimeFailure", { enumerable: true, get: function () { return typeGuards_1.isToolResponseRuntimeFailure; } });
+Object.defineProperty(exports, "isToolResponseSchemaValidationFailure", { enumerable: true, get: function () { return typeGuards_1.isToolResponseSchemaValidationFailure; } });
+Object.defineProperty(exports, "isToolResponseFailure", { enumerable: true, get: function () { return typeGuards_1.isToolResponseFailure; } });
+const getLitNodeClient_1 = require("../internal/LitNodeClient/getLitNodeClient");
+/** This method closes any registered event listeners maintained by Vincent Tool Clients, allowing your process to exit gracefully.
+ * @category API
+ */
+const disconnectVincentToolClients = getLitNodeClient_1.disconnectLitNodeClientInstance;
+exports.disconnectVincentToolClients = disconnectVincentToolClients;
 var vincentToolClient_1 = require("./vincentToolClient");
 Object.defineProperty(exports, "getVincentToolClient", { enumerable: true, get: function () { return vincentToolClient_1.getVincentToolClient; } });
+var generateVincentToolSessionSigs_1 = require("./execute/generateVincentToolSessionSigs");
+Object.defineProperty(exports, "generateVincentToolSessionSigs", { enumerable: true, get: function () { return generateVincentToolSessionSigs_1.generateVincentToolSessionSigs; } });
 //# sourceMappingURL=index.js.map

package/dist/src/toolClient/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/toolClient/index.ts"],"names":[],"mappings":";;;AAAA,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/toolClient/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,8BAA8B;AAE9B,2CAKsB;AAJpB,mHAAA,qBAAqB,OAAA;AACrB,0HAAA,4BAA4B,OAAA;AAC5B,mIAAA,qCAAqC,OAAA;AACrC,mHAAA,qBAAqB,OAAA;AAGvB,iFAA6F;AAE7F;;GAEG;AACH,MAAM,4BAA4B,GAAG,kDAA+B,CAAC;AAC5D,oEAA4B;AAErC,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA;AAG7B,2FAA0F;AAAjF,gJAAA,8BAA8B,OAAA"}

package/dist/src/toolClient/precheck/resultCreators.d.ts

@@ -0,0 +1,71 @@
+import type { z } from 'zod';
+import type { BaseToolContext, SchemaValidationError } from '@lit-protocol/vincent-tool-sdk';
+import type { ToolPrecheckResponseFailure, ToolPrecheckResponseFailureNoResult, ToolPrecheckResponseSuccess, ToolPrecheckResponseSuccessNoResult, PolicyPrecheckResultContext } from './types';
+export declare function createAllowPrecheckResult<PoliciesByPackageName extends Record<string, any>>(evaluatedPolicies: Array<keyof PoliciesByPackageName>, allowedPolicies: {
+    [K in keyof PoliciesByPackageName]?: {
+        result: PoliciesByPackageName[K]['__schemaTypes'] extends {
+            precheckAllowResultSchema: infer Schema;
+        } ? Schema extends z.ZodType ? z.infer<Schema> : never : never;
+    };
+}): {
+    allow: true;
+    evaluatedPolicies: Array<keyof PoliciesByPackageName>;
+    allowedPolicies: {
+        [K in keyof PoliciesByPackageName]?: {
+            result: PoliciesByPackageName[K]['__schemaTypes'] extends {
+                precheckAllowResultSchema: infer Schema;
+            } ? Schema extends z.ZodType ? z.infer<Schema> : never : never;
+        };
+    };
+};
+export declare function createDenyPrecheckResult<PoliciesByPackageName extends Record<string, any>>(evaluatedPolicies: Array<keyof PoliciesByPackageName>, allowedPolicies: {
+    [K in keyof PoliciesByPackageName]?: {
+        result: PoliciesByPackageName[K]['__schemaTypes'] extends {
+            precheckAllowResultSchema: infer Schema;
+        } ? Schema extends z.ZodType ? z.infer<Schema> : never : never;
+    };
+}, deniedPolicy: {
+    packageName: keyof PoliciesByPackageName;
+    runtimeError?: string;
+    schemaValidationError?: SchemaValidationError;
+    result: (PoliciesByPackageName[keyof PoliciesByPackageName]['__schemaTypes'] extends {
+        precheckDenyResultSchema: infer Schema;
+    } ? Schema extends z.ZodType ? z.infer<Schema> : undefined : undefined) | undefined;
+}): {
+    allow: false;
+    evaluatedPolicies: Array<keyof PoliciesByPackageName>;
+    allowedPolicies: {
+        [K in keyof PoliciesByPackageName]?: {
+            result: PoliciesByPackageName[K]['__schemaTypes'] extends {
+                precheckAllowResultSchema: infer Schema;
+            } ? Schema extends z.ZodType ? z.infer<Schema> : never : never;
+        };
+    };
+    deniedPolicy: {
+        packageName: keyof PoliciesByPackageName;
+        runtimeError?: string;
+        schemaValidationError?: SchemaValidationError;
+        result: (PoliciesByPackageName[keyof PoliciesByPackageName]['__schemaTypes'] extends {
+            precheckDenyResultSchema: infer Schema;
+        } ? Schema extends z.ZodType ? z.infer<Schema> : undefined : undefined) | undefined;
+    };
+};
+export declare function createToolPrecheckResponseSuccess<Success, Policies extends Record<any, any>>(params: {
+    result: Success;
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}): ToolPrecheckResponseSuccess<Success, Policies>;
+export declare function createToolPrecheckResponseSuccessNoResult<Policies extends Record<any, any>>(params?: {
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}): ToolPrecheckResponseSuccessNoResult<Policies>;
+export declare function createToolPrecheckResponseFailure<Fail, Policies extends Record<any, any>>(params: {
+    runtimeError?: string;
+    schemaValidationError?: SchemaValidationError;
+    result: Fail;
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}): ToolPrecheckResponseFailure<Fail, Policies>;
+export declare function createToolPrecheckResponseFailureNoResult<Policies extends Record<any, any>>(params: {
+    runtimeError?: string;
+    schemaValidationError?: SchemaValidationError;
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}): ToolPrecheckResponseFailureNoResult<Policies>;
+//# sourceMappingURL=resultCreators.d.ts.map

package/dist/src/toolClient/precheck/resultCreators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultCreators.d.ts","sourceRoot":"","sources":["../../../../src/toolClient/precheck/resultCreators.ts"],"names":[],"mappings":"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"}

package/dist/src/toolClient/precheck/resultCreators.js

@@ -0,0 +1,57 @@
+"use strict";
+// src/lib/toolClient/precheck/resultCreators.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAllowPrecheckResult = createAllowPrecheckResult;
+exports.createDenyPrecheckResult = createDenyPrecheckResult;
+exports.createToolPrecheckResponseSuccess = createToolPrecheckResponseSuccess;
+exports.createToolPrecheckResponseSuccessNoResult = createToolPrecheckResponseSuccessNoResult;
+exports.createToolPrecheckResponseFailure = createToolPrecheckResponseFailure;
+exports.createToolPrecheckResponseFailureNoResult = createToolPrecheckResponseFailureNoResult;
+function createAllowPrecheckResult(evaluatedPolicies, allowedPolicies) {
+    return {
+        allow: true,
+        evaluatedPolicies,
+        allowedPolicies,
+    };
+}
+function createDenyPrecheckResult(evaluatedPolicies, allowedPolicies, deniedPolicy) {
+    return {
+        allow: false,
+        evaluatedPolicies,
+        allowedPolicies,
+        deniedPolicy,
+    };
+}
+function createToolPrecheckResponseSuccess(params) {
+    return {
+        success: true,
+        result: params.result,
+        context: params.context,
+    };
+}
+function createToolPrecheckResponseSuccessNoResult(params) {
+    return {
+        success: true,
+        result: undefined,
+        context: params?.context,
+    };
+}
+function createToolPrecheckResponseFailure(params) {
+    return {
+        success: false,
+        schemaValidationError: params.schemaValidationError,
+        runtimeError: params.runtimeError,
+        result: params.result,
+        context: params.context,
+    };
+}
+function createToolPrecheckResponseFailureNoResult(params) {
+    return {
+        success: false,
+        runtimeError: params.runtimeError,
+        schemaValidationError: params.schemaValidationError,
+        result: undefined,
+        context: params.context,
+    };
+}
+//# sourceMappingURL=resultCreators.js.map

package/dist/src/toolClient/precheck/resultCreators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultCreators.js","sourceRoot":"","sources":["../../../../src/toolClient/precheck/resultCreators.ts"],"names":[],"mappings":";AAAA,gDAAgD;;AAchD,8DAiCC;AAED,4DA+DC;AAED,8EAYC;AAED,8FAUC;AAED,8EAaC;AAED,8FAcC;AA3JD,SAAgB,yBAAyB,CACvC,iBAAqD,EACrD,eAUC;IAgBD,OAAO;QACL,KAAK,EAAE,IAAI;QACX,iBAAiB;QACjB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CACtC,iBAAqD,EACrD,eAUC,EACD,YAaC;IA+BD,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,iBAAiB;QACjB,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAgB,iCAAiC,CAG/C,MAGD;IACC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,SAAgB,yCAAyC,CAEvD,MAED;IACC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,MAAM,EAAE,OAAO;KACzB,CAAC;AACJ,CAAC;AAED,SAAgB,iCAAiC,CAA0C,MAK1F;IACC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,SAAgB,yCAAyC,CAEvD,MAID;IACC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/src/toolClient/precheck/runPolicyPrechecks.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { ToolPolicyParameterData } from '@lit-protocol/vincent-contracts-sdk';
+import type { BaseContext, BaseToolContext, BundledVincentTool, VincentTool } from '@lit-protocol/vincent-tool-sdk';
+import type { ToolPolicyMap } from '@lit-protocol/vincent-tool-sdk/internal';
+import type { PolicyPrecheckResultContext } from './types';
+export declare function runToolPolicyPrechecks<const IpfsCid extends string, ToolParamsSchema extends z.ZodType, PkgNames extends string, PolicyMap extends ToolPolicyMap<any, PkgNames>, PoliciesByPackageName extends PolicyMap['policyByPackageName'], ExecuteSuccessSchema extends z.ZodType = z.ZodUndefined, ExecuteFailSchema extends z.ZodType = z.ZodUndefined, PrecheckSuccessSchema extends z.ZodType = z.ZodUndefined, PrecheckFailSchema extends z.ZodType = z.ZodUndefined>(params: {
+    bundledVincentTool: BundledVincentTool<VincentTool<ToolParamsSchema, PkgNames, PolicyMap, PoliciesByPackageName, ExecuteSuccessSchema, ExecuteFailSchema, PrecheckSuccessSchema, PrecheckFailSchema, any, any>, IpfsCid>;
+    toolParams: z.infer<ToolParamsSchema>;
+    context: BaseContext & {
+        rpcUrl?: string;
+    };
+    decodedPolicies: ToolPolicyParameterData;
+}): Promise<BaseToolContext<PolicyPrecheckResultContext<PoliciesByPackageName>>>;
+//# sourceMappingURL=runPolicyPrechecks.d.ts.map

package/dist/src/toolClient/precheck/runPolicyPrechecks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPolicyPrechecks.d.ts","sourceRoot":"","sources":["../../../../src/toolClient/precheck/runPolicyPrechecks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,WAAW,EAEZ,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAU7E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAQ3D,wBAAsB,sBAAsB,CAC1C,KAAK,CAAC,OAAO,SAAS,MAAM,EAC5B,gBAAgB,SAAS,CAAC,CAAC,OAAO,EAClC,QAAQ,SAAS,MAAM,EACvB,SAAS,SAAS,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,EAC9C,qBAAqB,SAAS,SAAS,CAAC,qBAAqB,CAAC,EAC9D,oBAAoB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACvD,iBAAiB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACpD,qBAAqB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACxD,kBAAkB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACrD,MAAM,EAAE;IACR,kBAAkB,EAAE,kBAAkB,CACpC,WAAW,CACT,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,GAAG,EACH,GAAG,CACJ,EACD,OAAO,CACR,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtC,OAAO,EAAE,WAAW,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,eAAe,EAAE,uBAAuB,CAAC;CAC1C,GAAG,OAAO,CAAC,eAAe,CAAC,2BAA2B,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAmL/E"}

package/dist/src/toolClient/precheck/runPolicyPrechecks.js

@@ -0,0 +1,97 @@
+"use strict";
+// src/lib/toolClient/precheck/runPolicyPrechecks.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runToolPolicyPrechecks = runToolPolicyPrechecks;
+const zod_1 = require("zod");
+const internal_1 = require("@lit-protocol/vincent-tool-sdk/internal");
+const resultCreators_1 = require("./resultCreators");
+const bigintReplacer = (key, value) => {
+    return typeof value === 'bigint' ? value.toString() : value;
+};
+async function runToolPolicyPrechecks(params) {
+    const { bundledVincentTool: { vincentTool, ipfsCid }, toolParams, context, decodedPolicies, } = params;
+    console.log('Executing runToolPolicyPrechecks()', Object.keys(params.bundledVincentTool.vincentTool.supportedPolicies.policyByPackageName));
+    const validatedPolicies = await (0, internal_1.validatePolicies)({
+        decodedPolicies,
+        vincentTool,
+        toolIpfsCid: ipfsCid,
+        parsedToolParams: toolParams,
+    });
+    const decodedPoliciesByPackageName = {};
+    for (const { policyPackageName, parameters } of validatedPolicies) {
+        decodedPoliciesByPackageName[policyPackageName] = parameters;
+    }
+    const evaluatedPolicies = [];
+    const allowedPolicies = {};
+    let deniedPolicy = undefined;
+    const policyByName = vincentTool.supportedPolicies.policyByPackageName;
+    for (const { policyPackageName, toolPolicyParams } of validatedPolicies) {
+        const key = policyPackageName;
+        const toolPolicy = policyByName[key];
+        evaluatedPolicies.push(key);
+        const vincentPolicy = toolPolicy.vincentPolicy;
+        if (!vincentPolicy.precheck) {
+            console.log('No precheck() defined policy', key, 'skipping...');
+            continue;
+        }
+        try {
+            console.log('Executing precheck() for policy', key);
+            const result = await vincentPolicy.precheck({
+                toolParams: toolPolicyParams,
+                userParams: decodedPoliciesByPackageName[key],
+            }, context);
+            console.log('vincentPolicy.precheck() result', JSON.stringify(result, bigintReplacer, 2));
+            // precheck() might have thrown a runtimeError or failed to parse the input
+            if (((0, internal_1.isPolicyDenyResponse)(result) && result.runtimeError) || result.schemaValidationError) {
+                deniedPolicy = {
+                    result: undefined,
+                    runtimeError: result.runtimeError,
+                    schemaValidationError: result.schemaValidationError,
+                    packageName: key,
+                };
+                break;
+            }
+            const { schemaToUse } = (0, internal_1.getSchemaForPolicyResponseResult)({
+                value: result,
+                allowResultSchema: vincentPolicy.precheckAllowResultSchema ?? zod_1.z.undefined(),
+                denyResultSchema: vincentPolicy.precheckDenyResultSchema ?? zod_1.z.undefined(),
+            });
+            const validated = (0, internal_1.validateOrDeny)(result.result, schemaToUse, 'precheck', 'output');
+            if ((0, internal_1.isPolicyDenyResponse)(result)) {
+                // Return value from precheck was invalid in this case
+                deniedPolicy = {
+                    runtimeError: result.runtimeError,
+                    schemaValidationError: result.schemaValidationError,
+                    result: validated,
+                    packageName: key,
+                };
+                break;
+            }
+            allowedPolicies[key] = {
+                result: validated.result,
+            };
+        }
+        catch (err) {
+            deniedPolicy = {
+                packageName: key,
+                ...(0, internal_1.createDenyResult)({
+                    runtimeError: err instanceof Error ? err.message : 'Unknown error in precheck()',
+                }),
+            };
+            break;
+        }
+    }
+    if (deniedPolicy) {
+        const policiesContext = (0, resultCreators_1.createDenyPrecheckResult)(evaluatedPolicies, allowedPolicies, deniedPolicy);
+        return {
+            ...context,
+            policiesContext,
+        };
+    }
+    const policiesContext = (0, resultCreators_1.createAllowPrecheckResult)(evaluatedPolicies, allowedPolicies);
+    return {
+        ...context,
+        policiesContext,
+    };
+}
+//# sourceMappingURL=runPolicyPrechecks.js.map

package/dist/src/toolClient/precheck/runPolicyPrechecks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPolicyPrechecks.js","sourceRoot":"","sources":["../../../../src/toolClient/precheck/runPolicyPrechecks.ts"],"names":[],"mappings":"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"}

package/dist/src/toolClient/precheck/types.d.ts

@@ -0,0 +1,82 @@
+import type { z } from 'zod';
+import type { BaseToolContext, SchemaValidationError } from '@lit-protocol/vincent-tool-sdk';
+import type { VincentPolicy } from '@lit-protocol/vincent-tool-sdk/internal';
+/** @category Interfaces */
+export interface ToolPrecheckResponseSuccess<Result, Policies extends Record<string, any>> {
+    success: true;
+    result: Result;
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}
+/** @category Interfaces */
+export interface ToolPrecheckResponseSuccessNoResult<Policies extends Record<string, any>> {
+    success: true;
+    result?: never;
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}
+/** @category Interfaces */
+export interface ToolPrecheckResponseFailure<Result, Policies extends Record<string, any>> {
+    success: false;
+    runtimeError?: string;
+    schemaValidationError?: SchemaValidationError;
+    result: Result;
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}
+/** @category Interfaces */
+export interface ToolPrecheckResponseFailureNoResult<Policies extends Record<string, any>> {
+    success: false;
+    runtimeError?: string;
+    schemaValidationError?: SchemaValidationError;
+    result?: never;
+    context?: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}
+/** @category Interfaces */
+export type ToolPrecheckResponse<SuccessSchema extends z.ZodType | undefined, FailSchema extends z.ZodType | undefined, Policies extends Record<string, any>> = (SuccessSchema extends z.ZodType ? ToolPrecheckResponseSuccess<z.infer<SuccessSchema>, Policies> : ToolPrecheckResponseSuccessNoResult<Policies>) | (FailSchema extends z.ZodType ? ToolPrecheckResponseFailure<z.infer<FailSchema>, Policies> : ToolPrecheckResponseFailureNoResult<Policies>);
+export interface RemoteVincentToolExecutionResult<SuccessSchema extends z.ZodType | undefined, FailSchema extends z.ZodType | undefined, Policies extends Record<string, any>> {
+    toolExecutionResult: ToolPrecheckResponse<SuccessSchema, FailSchema, Policies>;
+    toolContext: BaseToolContext<PolicyPrecheckResultContext<Policies>>;
+}
+export type PolicyPrecheckResultContext<Policies extends Record<string, {
+    vincentPolicy: VincentPolicy<any, any, any, any, any, any, any, any, any, any>;
+    /** @hidden */
+    __schemaTypes?: {
+        policyToolParamsSchema: z.ZodType;
+        userParamsSchema?: z.ZodType;
+        evalAllowResultSchema?: z.ZodType;
+        evalDenyResultSchema?: z.ZodType;
+        commitParamsSchema?: z.ZodType;
+        commitAllowResultSchema?: z.ZodType;
+        commitDenyResultSchema?: z.ZodType;
+        evaluate?: Function;
+        precheck?: Function;
+        commit?: Function;
+    };
+}>> = {
+    evaluatedPolicies: Array<keyof Policies>;
+} & ({
+    allow: true;
+    allowedPolicies: {
+        [PolicyKey in keyof Policies]?: {
+            result: Policies[PolicyKey]['__schemaTypes'] extends {
+                precheckAllowResultSchema: infer Schema;
+            } ? Schema extends z.ZodType ? z.infer<Schema> : never : never;
+        };
+    };
+    deniedPolicy?: never;
+} | {
+    allow: false;
+    deniedPolicy: {
+        runtimeError?: string;
+        packageName: keyof Policies;
+        result: (Policies[Extract<keyof Policies, string>]['__schemaTypes'] extends {
+            precheckDenyResultSchema: infer Schema;
+        } ? Schema extends z.ZodType ? z.infer<Schema> : undefined : undefined) | undefined;
+    };
+    allowedPolicies?: {
+        [PolicyKey in keyof Policies]?: {
+            result: Policies[PolicyKey]['__schemaTypes'] extends {
+                precheckAllowResultSchema: infer Schema;
+            } ? Schema extends z.ZodType ? z.infer<Schema> : never : never;
+        };
+    };
+});
+//# sourceMappingURL=types.d.ts.map

package/dist/src/toolClient/precheck/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/toolClient/precheck/types.ts"],"names":[],"mappings":"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"}

package/dist/src/toolClient/precheck/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// src/lib/toolClient/precheck/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/toolClient/precheck/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/toolClient/precheck/types.ts"],"names":[],"mappings":";AAAA,uCAAuC"}

package/dist/src/toolClient/typeGuards.d.ts

@@ -1,19 +1,28 @@
-import type { RemoteVincentToolExecutionResult, ToolResponse, ToolResponseFailure, ToolResponseFailureNoResult, ToolResponseSuccess, ToolResponseSuccessNoResult } from './types';
-/**
- * Runtime type guard for ToolResponse success result.
- */
-export declare function isToolResponseSuccess(value: unknown): value is ToolResponseSuccess<any, Record<string, any>> | ToolResponseSuccessNoResult<Record<string, any>>;
-/**
- * Runtime type guard for ToolResponse failure result.
- */
-export declare function isToolResponseFailure(value: unknown): value is ToolResponseFailure<any, Record<string, any>> | ToolResponseFailureNoResult<Record<string, any>>;
-/**
- * General ToolResponse shape check (success or failure).
- */
-export declare function isToolResponse(value: unknown): value is ToolResponse<any, any, Record<string, any>>;
-/**
- * Runtime type guard for RemoteVincentToolExecutionResult.
- * Checks if a value has the shape of a RemoteVincentToolExecutionResult.
- */
+import type { RemoteVincentToolExecutionResult, ToolExecuteResponse, ToolExecuteResponseFailure, ToolExecuteResponseFailureNoResult, ToolExecuteResponseSuccess, ToolExecuteResponseSuccessNoResult } from './execute/types';
+/** Type guard function that returns true only if the passed value is a successful tool response
+ * @category API
+ * */
+export declare function isToolResponseSuccess(value: unknown): value is ToolExecuteResponseSuccess<any, Record<string, any>> | ToolExecuteResponseSuccessNoResult<Record<string, any>>;
+/** Type guard function that returns true only if the passed value is a failure tool response
+ *  @category API */
+export declare function isToolResponseFailure(value: unknown): value is ToolExecuteResponseFailure<any, Record<string, any>> | ToolExecuteResponseFailureNoResult<Record<string, any>>;
+/** Type guard function that returns true only if the passed value is a failure tool response that was a runtime error
+ * This could be caused by code `throw()`ing an error from inside tool or policy code, or by errors encountered in the
+ * Vincent SDK wrapping code that handles the execution of the tool/policies.
+ *
+ * This could also be the result of a schema validation error -- use {@link isToolResponseSchemaValidationFailure} to check
+ * to see if have a data validation error.
+ *
+ *  @category API*/
+export declare function isToolResponseRuntimeFailure(value: unknown): value is ToolExecuteResponseFailureNoResult<Record<string, any>>;
+/** Type guard function that returns true only if the passed value is a failure tool response that was caused by
+ * a schema parsing failure.  All data inputs and outputs to / from Vincent Tools and Policies is validated using ZOD schemas.
+ *
+ * If this returns true, you can parse the `schemaValidationError` property in the response - it is a ZodError object.
+ * @category API */
+export declare function isToolResponseSchemaValidationFailure(value: unknown): value is ToolExecuteResponseFailureNoResult<Record<string, any>>;
+/** @hidden */
+export declare function isToolResponse(value: unknown): value is ToolExecuteResponse<any, any, Record<string, any>>;
+/** @hidden */
 export declare function isRemoteVincentToolExecutionResult(value: unknown): value is RemoteVincentToolExecutionResult<any, any, Record<any, any>>;
 //# sourceMappingURL=typeGuards.d.ts.map

package/dist/src/toolClient/typeGuards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../../src/toolClient/typeGuards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gCAAgC,EAChC,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IACJ,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAC7C,2BAA2B,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAOnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IACJ,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAC7C,2BAA2B,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAOnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAOtD;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,gCAAgC,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAUvE"}
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../../src/toolClient/typeGuards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gCAAgC,EAChC,mBAAmB,EACnB,0BAA0B,EAC1B,kCAAkC,EAClC,0BAA0B,EAC1B,kCAAkC,EACnC,MAAM,iBAAiB,CAAC;AAEzB;;KAEK;AACL,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IACJ,0BAA0B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GACpD,kCAAkC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAO1D;AAED;oBACoB;AACpB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IACJ,0BAA0B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GACpD,kCAAkC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAO1D;AAED;;;;;;;mBAOmB;AACnB,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kCAAkC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAIlE;AAED;;;;mBAImB;AACnB,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kCAAkC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAKlE;AAED,cAAc;AACd,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAO7D;AAED,cAAc;AACd,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,gCAAgC,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAUvE"}

package/dist/src/toolClient/typeGuards.js

@@ -3,39 +3,58 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isToolResponseSuccess = isToolResponseSuccess;
 exports.isToolResponseFailure = isToolResponseFailure;
+exports.isToolResponseRuntimeFailure = isToolResponseRuntimeFailure;
+exports.isToolResponseSchemaValidationFailure = isToolResponseSchemaValidationFailure;
 exports.isToolResponse = isToolResponse;
 exports.isRemoteVincentToolExecutionResult = isRemoteVincentToolExecutionResult;
-/**
- * Runtime type guard for ToolResponse success result.
- */
+/** Type guard function that returns true only if the passed value is a successful tool response
+ * @category API
+ * */
 function isToolResponseSuccess(value) {
     return (typeof value === 'object' &&
         value !== null &&
         'success' in value &&
         value.success === true);
 }
-/**
- * Runtime type guard for ToolResponse failure result.
- */
+/** Type guard function that returns true only if the passed value is a failure tool response
+ *  @category API */
 function isToolResponseFailure(value) {
     return (typeof value === 'object' &&
         value !== null &&
         'success' in value &&
         value.success === false);
 }
-/**
- * General ToolResponse shape check (success or failure).
- */
+/** Type guard function that returns true only if the passed value is a failure tool response that was a runtime error
+ * This could be caused by code `throw()`ing an error from inside tool or policy code, or by errors encountered in the
+ * Vincent SDK wrapping code that handles the execution of the tool/policies.
+ *
+ * This could also be the result of a schema validation error -- use {@link isToolResponseSchemaValidationFailure} to check
+ * to see if have a data validation error.
+ *
+ *  @category API*/
+function isToolResponseRuntimeFailure(value) {
+    if (!isToolResponseFailure(value))
+        return false;
+    return 'runtimeError' in value && typeof value.runtimeError === 'string';
+}
+/** Type guard function that returns true only if the passed value is a failure tool response that was caused by
+ * a schema parsing failure.  All data inputs and outputs to / from Vincent Tools and Policies is validated using ZOD schemas.
+ *
+ * If this returns true, you can parse the `schemaValidationError` property in the response - it is a ZodError object.
+ * @category API */
+function isToolResponseSchemaValidationFailure(value) {
+    if (!isToolResponseFailure(value))
+        return false;
+    return ('schemaValidationError' in value && typeof value.schemaValidationError === 'object');
+}
+/** @hidden */
 function isToolResponse(value) {
     return (typeof value === 'object' &&
         value !== null &&
         'success' in value &&
         typeof value.success === 'boolean');
 }
-/**
- * Runtime type guard for RemoteVincentToolExecutionResult.
- * Checks if a value has the shape of a RemoteVincentToolExecutionResult.
- */
+/** @hidden */
 function isRemoteVincentToolExecutionResult(value) {
     return (typeof value === 'object' &&
         value !== null &&