nodebench-mcp 2.31.2 → 2.33.0

package/dist/tools/deepSimTools.js

@@ -0,0 +1,404 @@
+function normalizeGatewayBaseUrl(raw) {
+    if (!raw)
+        return null;
+    const trimmed = raw.replace(/\/$/, "");
+    if (trimmed.includes(".convex.cloud")) {
+        return trimmed.replace(".convex.cloud", ".convex.site");
+    }
+    return trimmed;
+}
+function getDeepSimConfig() {
+    const siteUrl = normalizeGatewayBaseUrl(process.env.CONVEX_SITE_URL || process.env.VITE_CONVEX_URL || process.env.CONVEX_URL);
+    const secret = process.env.MCP_SECRET;
+    if (!siteUrl || !secret)
+        return null;
+    return { siteUrl, secret };
+}
+/** TIMEOUT: Gateway call timeout in ms */
+const GATEWAY_TIMEOUT_MS = 30_000;
+/** BOUND_READ: Max response body size (2 MB) */
+const MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
+async function callGateway(fn, args) {
+    const config = getDeepSimConfig();
+    if (!config) {
+        return {
+            success: false,
+            error: "Missing CONVEX_SITE_URL, VITE_CONVEX_URL, or CONVEX_URL, or MCP_SECRET. Cannot call Deep Sim backend.",
+        };
+    }
+    // ERROR_BOUNDARY: Wrap entire fetch+parse in try/catch
+    try {
+        // TIMEOUT: AbortController with budget gate
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), GATEWAY_TIMEOUT_MS);
+        const res = await fetch(`${config.siteUrl}/api/mcpGateway`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-mcp-secret": config.secret,
+            },
+            body: JSON.stringify({ fn, args }),
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        // BOUND_READ: Cap response body size before parsing
+        const contentLength = res.headers.get("content-length");
+        if (contentLength && parseInt(contentLength, 10) > MAX_RESPONSE_BYTES) {
+            return {
+                success: false,
+                error: `Response too large (${contentLength} bytes, max ${MAX_RESPONSE_BYTES}). Reduce scope or use pagination.`,
+            };
+        }
+        const text = await res.text();
+        if (text.length > MAX_RESPONSE_BYTES) {
+            return {
+                success: false,
+                error: `Response body too large (${text.length} chars, max ${MAX_RESPONSE_BYTES}). Reduce scope or use pagination.`,
+            };
+        }
+        let payload;
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            return {
+                success: false,
+                error: `Deep Sim backend returned non-JSON response (HTTP ${res.status}): ${text.slice(0, 200)}`,
+            };
+        }
+        if (!res.ok) {
+            const errorMessage = ("error" in payload ? payload.error : undefined) ||
+                payload.message ||
+                `Deep Sim backend returned HTTP ${res.status}`;
+            return { success: false, error: errorMessage };
+        }
+        return payload;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("abort")) {
+            return { success: false, error: `Deep Sim gateway timed out after ${GATEWAY_TIMEOUT_MS}ms for ${fn}` };
+        }
+        return { success: false, error: `Deep Sim gateway call failed for ${fn}: ${message}` };
+    }
+}
+function successOrError(result, latencyMs) {
+    if (!result.success) {
+        return { error: true, message: result.error, latencyMs };
+    }
+    return { success: true, latencyMs, data: result.data };
+}
+// ---------------------------------------------------------------------------
+// 7 Deep Sim MCP Tools
+// ---------------------------------------------------------------------------
+export const deepSimTools = [
+    // -----------------------------------------------------------------------
+    // 1. build_claim_graph
+    // -----------------------------------------------------------------------
+    {
+        name: "build_claim_graph",
+        description: "Extract claims from a source packet and link each claim to its evidence. Returns a directed graph of claims with supporting/contradicting evidence, confidence per claim, and whatWouldChangeMyMind for each.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: {
+                    type: "string",
+                    description: "Canonical entity key, e.g. company/acme-ai",
+                },
+                sources: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 50,
+                    description: "Source texts, URLs, or document keys to extract claims from",
+                },
+                maxClaims: {
+                    type: "number",
+                    default: 20,
+                    maximum: 50,
+                    description: "Maximum number of claims to extract (default 20, max 50)",
+                },
+            },
+            required: ["entityKey", "sources"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("buildClaimGraph", {
+                entityKey: args.entityKey,
+                sources: args.sources,
+                maxClaims: Math.min(args.maxClaims ?? 20, 50),
+            });
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    // -----------------------------------------------------------------------
+    // 2. extract_variables
+    // -----------------------------------------------------------------------
+    {
+        name: "extract_variables",
+        description: "Identify and weight the key variables driving an entity's trajectory across 6 categories (intrinsic, temporal, network, intervention, market, constraint). Returns ranked variables with sensitivity estimates, data completeness, and whatWouldChangeMyMind.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: {
+                    type: "string",
+                    description: "Canonical entity key",
+                },
+                claimGraphId: {
+                    type: "string",
+                    description: "ID from build_claim_graph output (optional, for context enrichment)",
+                },
+                variableCategories: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        enum: ["intrinsic", "temporal", "network", "intervention", "market", "constraint"],
+                    },
+                    default: ["intrinsic", "temporal", "network", "intervention", "market", "constraint"],
+                    description: "Which variable categories to analyze",
+                },
+                maxVariables: {
+                    type: "number",
+                    default: 15,
+                    maximum: 30,
+                    description: "Maximum variables to return (default 15, max 30)",
+                },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("extractVariables", {
+                entityKey: args.entityKey,
+                claimGraphId: args.claimGraphId,
+                variableCategories: args.variableCategories ?? [
+                    "intrinsic", "temporal", "network", "intervention", "market", "constraint",
+                ],
+                maxVariables: Math.min(args.maxVariables ?? 15, 30),
+            });
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    // -----------------------------------------------------------------------
+    // 3. generate_countermodels
+    // -----------------------------------------------------------------------
+    {
+        name: "generate_countermodels",
+        description: "For every main thesis or scenario, generate serious alternative explanations with their own evidence and confidence. Forces intellectual honesty by surfacing counter-arguments and what would validate each.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: {
+                    type: "string",
+                    description: "Canonical entity key",
+                },
+                thesis: {
+                    type: "string",
+                    description: "The main claim or scenario to challenge",
+                },
+                claimGraphId: {
+                    type: "string",
+                    description: "Optional claim graph ID for context enrichment",
+                },
+                maxCounterModels: {
+                    type: "number",
+                    default: 3,
+                    maximum: 5,
+                    description: "Maximum counter-models to generate (default 3, max 5)",
+                },
+            },
+            required: ["entityKey", "thesis"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("generateCounterModels", {
+                entityKey: args.entityKey,
+                thesis: args.thesis,
+                claimGraphId: args.claimGraphId,
+                maxCounterModels: Math.min(args.maxCounterModels ?? 3, 5),
+            });
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    // -----------------------------------------------------------------------
+    // 4. run_deep_sim
+    // -----------------------------------------------------------------------
+    {
+        name: "run_deep_sim",
+        description: "Run a multi-agent scenario simulation with bounded branching and budget controls. Instantiates agents with personas and incentives, varies conditions across branches, and generates an analytical report with convergence metrics.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: {
+                    type: "string",
+                    description: "Canonical entity key",
+                },
+                workflow: {
+                    type: "string",
+                    enum: [
+                        "investor_diligence",
+                        "founder_strategy",
+                        "ceo_decision",
+                        "gtm_analysis",
+                        "creator_trajectory",
+                        "trend_forecast",
+                    ],
+                    description: "Which analysis workflow to run",
+                },
+                variableOverrides: {
+                    type: "object",
+                    description: "Override specific variable values for what-if analysis",
+                },
+                maxBranches: {
+                    type: "number",
+                    default: 3,
+                    maximum: 5,
+                    description: "Maximum scenario branches (default 3, max 5)",
+                },
+                maxRounds: {
+                    type: "number",
+                    default: 4,
+                    maximum: 6,
+                    description: "Maximum deliberation rounds per branch (default 4, max 6)",
+                },
+                budgetSeconds: {
+                    type: "number",
+                    default: 90,
+                    maximum: 180,
+                    description: "Total wall-clock budget in seconds (default 90, max 180)",
+                },
+            },
+            required: ["entityKey", "workflow"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("runDeepSim", {
+                entityKey: args.entityKey,
+                workflow: args.workflow,
+                variableOverrides: args.variableOverrides ?? {},
+                maxBranches: Math.min(args.maxBranches ?? 3, 5),
+                maxRounds: Math.min(args.maxRounds ?? 4, 6),
+                budgetSeconds: Math.min(args.budgetSeconds ?? 90, 180),
+            });
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    // -----------------------------------------------------------------------
+    // 5. rank_interventions
+    // -----------------------------------------------------------------------
+    {
+        name: "rank_interventions",
+        description: "Rank potential interventions by expected trajectory delta. Each intervention includes expected impact, confidence, cost, timeframe, and what evidence would confirm or deny its effect.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: {
+                    type: "string",
+                    description: "Canonical entity key",
+                },
+                scenarioId: {
+                    type: "string",
+                    description: "Scenario ID from run_deep_sim output to optimize for",
+                },
+                maxInterventions: {
+                    type: "number",
+                    default: 5,
+                    maximum: 10,
+                    description: "Maximum interventions to rank (default 5, max 10)",
+                },
+            },
+            required: ["entityKey", "scenarioId"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("rankInterventions", {
+                entityKey: args.entityKey,
+                scenarioId: args.scenarioId,
+                maxInterventions: Math.min(args.maxInterventions ?? 5, 10),
+            });
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    // -----------------------------------------------------------------------
+    // 6. score_compounding
+    // -----------------------------------------------------------------------
+    {
+        name: "score_compounding",
+        description: "Compute the full 8-dimension trajectory score for an entity. Returns trust-adjusted compounding, drift, adaptation velocity, and all sub-scores with explanations. Output includes TrajectoryScoreBreakdown and TrajectorySummaryData.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: {
+                    type: "string",
+                    description: "Canonical entity key",
+                },
+                entityType: {
+                    type: "string",
+                    enum: ["product", "startup", "founder", "workflow", "agent", "mission", "team"],
+                    description: "Entity type for scoring context",
+                },
+                windowDays: {
+                    type: "number",
+                    default: 90,
+                    minimum: 7,
+                    maximum: 365,
+                    description: "Lookback window in days for trajectory computation (default 90)",
+                },
+            },
+            required: ["entityKey", "entityType"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const windowDays = Math.max(7, Math.min(args.windowDays ?? 90, 365));
+            const result = await callGateway("scoreCompounding", {
+                entityKey: args.entityKey,
+                entityType: args.entityType,
+                windowDays,
+            });
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    // -----------------------------------------------------------------------
+    // 7. render_decision_memo
+    // -----------------------------------------------------------------------
+    {
+        name: "render_decision_memo",
+        description: "Render a 1-page executive decision memo from a completed Deep Sim analysis. Combines claim graph, variables, scenarios, interventions, and compounding score into a structured memo with counter-models, forecast check date, and whatWouldChangeMyMind.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: {
+                    type: "string",
+                    description: "Canonical entity key",
+                },
+                workflow: {
+                    type: "string",
+                    description: "Workflow name used in the Deep Sim run",
+                },
+                format: {
+                    type: "string",
+                    enum: ["markdown", "json", "html"],
+                    default: "markdown",
+                    description: "Output format for the rendered memo (default markdown)",
+                },
+                audienceRole: {
+                    type: "string",
+                    enum: ["ceo", "investor", "founder", "builder"],
+                    default: "founder",
+                    description: "Target audience role for tone and emphasis (default founder)",
+                },
+            },
+            required: ["entityKey", "workflow"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("renderDecisionMemo", {
+                entityKey: args.entityKey,
+                workflow: args.workflow,
+                format: args.format ?? "markdown",
+                audienceRole: args.audienceRole ?? "founder",
+            });
+            return successOrError(result, Date.now() - started);
+        },
+    },
+];
+//# sourceMappingURL=deepSimTools.js.map

package/dist/tools/deepSimTools.js.map

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

package/dist/tools/dimensionTools.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from "../types.js";
+export declare const dimensionTools: McpTool[];

package/dist/tools/dimensionTools.js

@@ -0,0 +1,246 @@
+function normalizeGatewayBaseUrl(raw) {
+    if (!raw)
+        return null;
+    const trimmed = raw.replace(/\/$/, "");
+    if (trimmed.includes(".convex.cloud")) {
+        return trimmed.replace(".convex.cloud", ".convex.site");
+    }
+    return trimmed;
+}
+function getDimensionConfig() {
+    const siteUrl = normalizeGatewayBaseUrl(process.env.CONVEX_SITE_URL || process.env.VITE_CONVEX_URL || process.env.CONVEX_URL);
+    const secret = process.env.MCP_SECRET;
+    if (!siteUrl || !secret)
+        return null;
+    return { siteUrl, secret };
+}
+/** TIMEOUT: Gateway call timeout in ms */
+const GATEWAY_TIMEOUT_MS = 30_000;
+/** BOUND_READ: Max response body size (2 MB) */
+const MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
+async function callGateway(fn, args) {
+    const config = getDimensionConfig();
+    if (!config) {
+        return {
+            success: false,
+            error: "Missing CONVEX_SITE_URL, VITE_CONVEX_URL, or CONVEX_URL, or MCP_SECRET. Cannot call DeepTrace dimension backend.",
+        };
+    }
+    // ERROR_BOUNDARY: Wrap entire fetch+parse in try/catch
+    try {
+        // TIMEOUT: AbortController with budget gate
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), GATEWAY_TIMEOUT_MS);
+        const res = await fetch(`${config.siteUrl}/api/mcpGateway`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-mcp-secret": config.secret,
+            },
+            body: JSON.stringify({ fn, args }),
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        // BOUND_READ: Cap response body size before parsing
+        const contentLength = res.headers.get("content-length");
+        if (contentLength && parseInt(contentLength, 10) > MAX_RESPONSE_BYTES) {
+            return {
+                success: false,
+                error: `Response too large (${contentLength} bytes, max ${MAX_RESPONSE_BYTES}). Reduce scope or use pagination.`,
+            };
+        }
+        const text = await res.text();
+        if (text.length > MAX_RESPONSE_BYTES) {
+            return {
+                success: false,
+                error: `Response body too large (${text.length} chars, max ${MAX_RESPONSE_BYTES}). Reduce scope or use pagination.`,
+            };
+        }
+        let payload;
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            return {
+                success: false,
+                error: `DeepTrace backend returned non-JSON response (HTTP ${res.status}): ${text.slice(0, 200)}`,
+            };
+        }
+        if (!res.ok) {
+            const errorMessage = ("error" in payload ? payload.error : undefined)
+                || payload.message
+                || `DeepTrace dimension backend returned HTTP ${res.status}`;
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+        return payload;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes("abort")) {
+            return { success: false, error: `DeepTrace gateway timed out after ${GATEWAY_TIMEOUT_MS}ms for ${fn}` };
+        }
+        return { success: false, error: `DeepTrace gateway call failed for ${fn}: ${message}` };
+    }
+}
+function successOrError(result, latencyMs) {
+    if (!result.success) {
+        return { error: true, message: result.error, latencyMs };
+    }
+    return { success: true, latencyMs, data: result.data };
+}
+export const dimensionTools = [
+    {
+        name: "compute_dimension_profile",
+        description: "Recompute and persist the DeepTrace dimension profile for an entity. Use after new company evidence, relationship updates, or temporal signals land.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key, e.g. company/acme-ai" },
+                entityName: { type: "string", description: "Optional display name when entity context is sparse" },
+                entityType: { type: "string", description: "Optional entity type such as company or person" },
+                triggerEventKey: { type: "string", description: "Optional event key or reason for recomputation" },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("refreshDimensionProfile", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    {
+        name: "get_dimension_profile",
+        description: "Fetch the latest persisted DeepTrace dimension profile, including regime label, policy context, confidence, and the normalized dimension state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key" },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("getDimensionProfile", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    {
+        name: "list_dimension_snapshots",
+        description: "List historical DeepTrace dimension snapshots for an entity to inspect regime transitions over time.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key" },
+                limit: { type: "number", description: "Maximum number of snapshots to return (default 12)" },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("listDimensionSnapshots", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    {
+        name: "list_dimension_evidence",
+        description: "List the durable evidence rows behind a DeepTrace dimension profile. Useful for auditing why a score or availability status was assigned.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key" },
+                dimensionFamily: { type: "string", description: "Optional family such as capital, people, or narrative" },
+                dimensionName: { type: "string", description: "Optional metric name within the family" },
+                limit: { type: "number", description: "Maximum rows to return (default 40)" },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("listDimensionEvidence", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    {
+        name: "list_dimension_interactions",
+        description: "List stored interaction effects for an entity, such as capital plus investor quality reducing execution fragility or narrative outpacing evidence.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key" },
+                limit: { type: "number", description: "Maximum rows to return (default 16)" },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("listDimensionInteractions", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    {
+        name: "export_dimension_bundle",
+        description: "Export the full DeepTrace dimension bundle for an entity: latest profile, snapshots, evidence, and interaction effects in one response.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key" },
+                snapshotLimit: { type: "number", description: "Maximum snapshots to include" },
+                evidenceLimit: { type: "number", description: "Maximum evidence rows to include" },
+                interactionLimit: { type: "number", description: "Maximum interaction rows to include" },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("getDimensionBundle", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    {
+        name: "run_research_cell",
+        description: "Run a bounded re-analysis cell for a DeepTrace entity investigation. Queries existing DeepTrace state through parallel branches (evidence gap analysis, counter-hypothesis, dimension coverage, source diversification) to surface gaps and weaknesses. Does NOT acquire new external evidence — use due-diligence orchestrator for that. Triggers when confidence is low, coverage is sparse, or operator requests deeper analysis. Returns merged findings in standard DeepTrace format with receipts and dimension profile.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key, e.g. company/acme-ai" },
+                entityName: { type: "string", description: "Optional display name" },
+                confidence: { type: "number", description: "Current investigation confidence [0,1]. Cell auto-triggers below 0.65" },
+                dimensionCoverage: { type: "number", description: "Current dimension coverage ratio [0,1]. Cell auto-triggers below 0.70" },
+                durableSourceCount: { type: "number", description: "Number of durable evidence sources. Cell auto-triggers below 3" },
+                operatorRequested: { type: "boolean", description: "Force-trigger the research cell regardless of thresholds" },
+                existingFacts: { type: "array", items: { type: "string" }, description: "Known facts to avoid redundant research" },
+                maxBranches: { type: "number", description: "Max parallel research branches (default 3, max 3)" },
+                maxRefinementRounds: { type: "number", description: "Max refinement rounds (default 2, max 2)" },
+            },
+            required: ["entityKey", "confidence", "dimensionCoverage", "durableSourceCount"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("runResearchCell", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+    {
+        name: "run_entity_intelligence_mission",
+        description: "Run a full DeepTrace entity intelligence mission with optional bounded research cell. Unifies relationship mapping, ownership, supply chain, signals, and causal analysis. Pass researchCell=true for threshold-driven re-analysis when the investigation has gaps, or forceResearchCell=true to explicitly force the bounded cell.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityKey: { type: "string", description: "Canonical entity key" },
+                entityName: { type: "string", description: "Optional display name" },
+                researchCell: { type: "boolean", description: "Enable threshold-driven autoresearch cell for low-confidence investigations" },
+                forceResearchCell: { type: "boolean", description: "Force the bounded research cell even if thresholds are healthy" },
+            },
+            required: ["entityKey"],
+        },
+        handler: async (args) => {
+            const started = Date.now();
+            const result = await callGateway("runEntityIntelligenceMission", args);
+            return successOrError(result, Date.now() - started);
+        },
+    },
+];
+//# sourceMappingURL=dimensionTools.js.map