@stigmer/runner 3.0.1

package/dist/workflows/listen-orchestrator.js

@@ -0,0 +1,143 @@
+/**
+ * Listen task orchestrator — Temporal workflow-layer implementation.
+ *
+ * Registers handlers for each event in the listen configuration based on
+ * its transport type (signal, query, update), then blocks until the
+ * consumption strategy is satisfied.
+ *
+ * Transport type semantics:
+ * - signal: blocking; receives data via signal channel, counts toward completion
+ * - query:  non-blocking; registers a read-only handler that returns data
+ *           on demand. Does NOT count toward completion — the listen task
+ *           returns immediately after registering query handlers (unless
+ *           mixed with blocking event types).
+ * - update: blocking; registers a bidirectional handler with validator.
+ *           Counts toward completion like signals. Returns reply data to caller.
+ *
+ * TEMPORAL SANDBOX: This file runs inside the deterministic workflow
+ * isolate. Only @temporalio/workflow APIs are allowed.
+ */
+import { defineSignal, defineQuery, defineUpdate, setHandler, condition, } from "@temporalio/workflow";
+/**
+ * Orchestrates a listen task within the Temporal workflow sandbox.
+ * Called by the workflow function's `ctx.listen` callback wiring.
+ *
+ * Returns the received payload(s). For single-event listeners, returns
+ * the raw payload. For multi-event listeners, returns a map of
+ * { eventId: payload }.
+ */
+export async function orchestrateListenTask(config) {
+    const { events, mode, timeoutMs } = config;
+    const blockingEvents = events.filter(e => e.type !== "query");
+    const queryEvents = events.filter(e => e.type === "query");
+    for (const event of queryEvents) {
+        registerQueryHandler(event);
+    }
+    if (blockingEvents.length === 0) {
+        return undefined;
+    }
+    if (blockingEvents.length === 1 && queryEvents.length === 0) {
+        return waitForSingleBlockingEvent(blockingEvents[0], timeoutMs);
+    }
+    if (mode === "any") {
+        return waitForAnyBlockingEvent(blockingEvents, timeoutMs);
+    }
+    return waitForAllBlockingEvents(blockingEvents, timeoutMs);
+}
+function registerQueryHandler(event) {
+    const query = defineQuery(event.id);
+    setHandler(query, () => {
+        if (event.data !== undefined) {
+            return event.data;
+        }
+        return undefined;
+    });
+}
+function registerSignalHandler(event, onReceive) {
+    const signal = defineSignal(event.id);
+    setHandler(signal, (data) => {
+        onReceive(data);
+    });
+}
+function registerUpdateHandler(event, onReceive) {
+    const replyData = event.data;
+    // Temporal TS SDK's setHandler overloads have strict generic inference that
+    // rejects [unknown] args. The runtime is correct — cast through any to bypass
+    // the compile-time mismatch (same pattern used for OTel interceptor SDK gap).
+    const update = defineUpdate(event.id);
+    setHandler(update, (data) => {
+        onReceive(data);
+        return replyData !== undefined ? replyData : undefined;
+    }, {
+        validator: (_data) => { },
+    });
+}
+function registerBlockingHandler(event, onReceive) {
+    if (event.type === "signal") {
+        registerSignalHandler(event, onReceive);
+    }
+    else if (event.type === "update") {
+        registerUpdateHandler(event, onReceive);
+    }
+}
+async function waitForSingleBlockingEvent(event, timeoutMs) {
+    let payload = undefined;
+    let received = false;
+    registerBlockingHandler(event, (data) => {
+        payload = data;
+        received = true;
+    });
+    const completed = await condition(() => received, timeoutMs);
+    if (!completed) {
+        throw new Error(`Listen task timed out waiting for ${event.type} '${event.id}' after ${timeoutMs}ms`);
+    }
+    return payload;
+}
+async function waitForAnyBlockingEvent(events, timeoutMs) {
+    let winningPayload = undefined;
+    let winningEventId = undefined;
+    let anyReceived = false;
+    for (const event of events) {
+        registerBlockingHandler(event, (data) => {
+            if (!anyReceived) {
+                winningPayload = data;
+                winningEventId = event.id;
+                anyReceived = true;
+            }
+        });
+    }
+    const completed = await condition(() => anyReceived, timeoutMs);
+    if (!completed) {
+        const ids = events.map(e => e.id).join(", ");
+        throw new Error(`Listen task timed out waiting for any event from [${ids}] after ${timeoutMs}ms`);
+    }
+    return { __event_id__: winningEventId, payload: winningPayload };
+}
+async function waitForAllBlockingEvents(events, timeoutMs) {
+    const received = {};
+    const completionFlags = new Map();
+    for (const event of events) {
+        completionFlags.set(event.id, false);
+        registerBlockingHandler(event, (data) => {
+            received[event.id] = data;
+            completionFlags.set(event.id, true);
+        });
+    }
+    const allComplete = () => {
+        for (const flag of completionFlags.values()) {
+            if (!flag)
+                return false;
+        }
+        return true;
+    };
+    const completed = await condition(allComplete, timeoutMs);
+    if (!completed) {
+        const pending = events
+            .filter(e => !completionFlags.get(e.id))
+            .map(e => e.id)
+            .join(", ");
+        throw new Error(`Listen task timed out waiting for events [${pending}] after ${timeoutMs}ms`);
+    }
+    return received;
+}
+//# sourceMappingURL=listen-orchestrator.js.map

package/dist/workflows/listen-orchestrator.js.map

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

package/dist/workflows/metrics-sink.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Workflow sink for recording per-task metrics from within the
+ * Temporal deterministic sandbox. Sinks are the SDK-sanctioned way
+ * to push data from workflow code to worker-side infrastructure
+ * (OTel, logging, etc.) without breaking determinism.
+ *
+ * The sink interface is imported by the workflow bundle; the
+ * implementation (injected sink) is created by the worker.
+ */
+export type WorkflowMetricsSink = {
+    recordTaskDuration(info: {
+        taskName: string;
+        taskKind: string;
+        durationMs: number;
+        success: boolean;
+    }): void;
+    recordExecutionStart(info: {
+        workflowName: string;
+    }): void;
+    recordExecutionEnd(info: {
+        workflowName: string;
+        success: boolean;
+        durationMs: number;
+    }): void;
+    [key: string]: (...args: any[]) => any;
+};
+export type WorkflowMetricsSinks = {
+    metrics: WorkflowMetricsSink;
+    [key: string]: WorkflowMetricsSink;
+};
+export declare function recordTaskMetric(taskName: string, taskKind: string, durationMs: number, success: boolean): void;
+export declare function recordExecutionStartMetric(workflowName: string): void;
+export declare function recordExecutionEndMetric(workflowName: string, success: boolean, durationMs: number): void;

package/dist/workflows/metrics-sink.js

@@ -0,0 +1,21 @@
+/**
+ * Workflow sink for recording per-task metrics from within the
+ * Temporal deterministic sandbox. Sinks are the SDK-sanctioned way
+ * to push data from workflow code to worker-side infrastructure
+ * (OTel, logging, etc.) without breaking determinism.
+ *
+ * The sink interface is imported by the workflow bundle; the
+ * implementation (injected sink) is created by the worker.
+ */
+import { proxySinks } from "@temporalio/workflow";
+const { metrics } = proxySinks();
+export function recordTaskMetric(taskName, taskKind, durationMs, success) {
+    metrics.recordTaskDuration({ taskName, taskKind, durationMs, success });
+}
+export function recordExecutionStartMetric(workflowName) {
+    metrics.recordExecutionStart({ workflowName });
+}
+export function recordExecutionEndMetric(workflowName, success, durationMs) {
+    metrics.recordExecutionEnd({ workflowName, success, durationMs });
+}
+//# sourceMappingURL=metrics-sink.js.map

package/dist/workflows/metrics-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-sink.js","sourceRoot":"","sources":["../../src/workflows/metrics-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAyBlD,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,EAAwB,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAgB,EAAE,UAAkB,EAAE,OAAgB;IACvG,OAAO,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,OAAO,CAAC,oBAAoB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,YAAoB,EAAE,OAAgB,EAAE,UAAkB;IACjG,OAAO,CAAC,kBAAkB,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/workflows/run-orchestrator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Run task workflow orchestrator — child workflow execution.
+ *
+ * Handles the `run.workflow` variant by executing a child Temporal
+ * workflow. Supports two modes:
+ * - await: true — blocks until child completes, returns its result
+ * - await: false — fire-and-forget with PARENT_CLOSE_POLICY_ABANDON
+ *
+ * TEMPORAL SANDBOX: This file runs inside the deterministic workflow isolate.
+ */
+import type { RunWorkflowExecutionConfig } from "../workflow-engine/types.js";
+/**
+ * Executes a child workflow based on the run task configuration.
+ */
+export declare function orchestrateRunWorkflow(config: RunWorkflowExecutionConfig): Promise<unknown>;

package/dist/workflows/run-orchestrator.js

@@ -0,0 +1,27 @@
+/**
+ * Run task workflow orchestrator — child workflow execution.
+ *
+ * Handles the `run.workflow` variant by executing a child Temporal
+ * workflow. Supports two modes:
+ * - await: true — blocks until child completes, returns its result
+ * - await: false — fire-and-forget with PARENT_CLOSE_POLICY_ABANDON
+ *
+ * TEMPORAL SANDBOX: This file runs inside the deterministic workflow isolate.
+ */
+import { executeChild, ParentClosePolicy } from "@temporalio/workflow";
+/**
+ * Executes a child workflow based on the run task configuration.
+ */
+export async function orchestrateRunWorkflow(config) {
+    const childHandle = await executeChild(config.name, {
+        args: config.input !== undefined ? [config.input] : [],
+        parentClosePolicy: config.await
+            ? ParentClosePolicy.PARENT_CLOSE_POLICY_TERMINATE
+            : ParentClosePolicy.PARENT_CLOSE_POLICY_ABANDON,
+    });
+    if (!config.await) {
+        return undefined;
+    }
+    return childHandle;
+}
+//# sourceMappingURL=run-orchestrator.js.map

package/dist/workflows/run-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-orchestrator.js","sourceRoot":"","sources":["../../src/workflows/run-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIvE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAkC;IAElC,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE;QAClD,IAAI,EAAE,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QACtD,iBAAiB,EAAE,MAAM,CAAC,KAAK;YAC7B,CAAC,CAAC,iBAAiB,CAAC,6BAA6B;YACjD,CAAC,CAAC,iBAAiB,CAAC,2BAA2B;KAClD,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/workflows/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Workflow boundary types for the MCP server connect flow.
+ *
+ * These types define the Temporal wire contract between the Java/Go
+ * backend (which starts and reads the workflow) and the TypeScript
+ * workflow implementation. All field names use snake_case to match
+ * the Java `Map<String, Object>` keys exactly — Temporal's TS SDK
+ * does plain JSON serialization with no name transformation.
+ *
+ * IMPORTANT: This file MUST contain only plain TypeScript interfaces
+ * with zero runtime imports. It is imported by the workflow file
+ * which runs inside the Temporal deterministic sandbox.
+ */
+export interface ConnectMcpServerWorkflowInput {
+    mcp_server_id: string;
+    execution_context_id?: string | null;
+    invoker_identity_account_id?: string | null;
+}
+export interface ConnectMcpServerWorkflowOutput {
+    tools: WireToolResult[];
+    resource_templates: WireResourceTemplateResult[];
+    tool_approvals: WireToolApproval[];
+}
+export interface WireToolResult {
+    name: string;
+    description: string;
+    input_schema?: Record<string, unknown> | null;
+}
+export interface WireResourceTemplateResult {
+    uri_template: string;
+    name: string;
+    description: string;
+    mime_type: string;
+}
+export interface WireToolApproval {
+    tool_name: string;
+    requires_approval: boolean;
+    message: string;
+}
+export interface DiscoverMcpServerWorkflowOutput {
+    tools: WireToolResult[];
+    resource_templates: WireResourceTemplateResult[];
+    previous_tools_fingerprint: string;
+    previous_tool_approvals: WireToolApproval[];
+    new_tools_fingerprint: string;
+}

package/dist/workflows/types.js

@@ -0,0 +1,15 @@
+/**
+ * Workflow boundary types for the MCP server connect flow.
+ *
+ * These types define the Temporal wire contract between the Java/Go
+ * backend (which starts and reads the workflow) and the TypeScript
+ * workflow implementation. All field names use snake_case to match
+ * the Java `Map<String, Object>` keys exactly — Temporal's TS SDK
+ * does plain JSON serialization with no name transformation.
+ *
+ * IMPORTANT: This file MUST contain only plain TypeScript interfaces
+ * with zero runtime imports. It is imported by the workflow file
+ * which runs inside the Temporal deterministic sandbox.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workflows/types.js.map

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

package/dist/workflows/workflow-signals.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared pause/resume signal definitions and handler setup for
+ * workflow execution. Used by both the hydration wrapper
+ * ("stigmer/workflow/execute-from-execution") and the direct
+ * invocation path ("stigmer/workflow/execute").
+ *
+ * The Java/Go orchestrators forward pause and resume signals to
+ * the child workflow. The engine checks a `checkPause` callback
+ * at yield points between tasks; when paused, the workflow blocks
+ * on `condition(() => !paused)` — alive but idle.
+ *
+ * SANDBOX RULES: This file runs inside the Temporal deterministic V8
+ * isolate. Only @temporalio/workflow APIs and pure TS logic.
+ */
+export declare const pauseSignal: import("@temporalio/workflow").SignalDefinition<[string], string>;
+export declare const resumeSignal: import("@temporalio/workflow").SignalDefinition<[], "resume">;
+export interface PauseResumeHandlers {
+    readonly checkPause: () => Promise<void>;
+}
+/**
+ * Registers pause and resume signal handlers on the current workflow
+ * and returns a `checkPause` callback suitable for threading into the
+ * engine's `TaskExecutionContext`.
+ *
+ * Must be called at workflow start, before any async work. Temporal
+ * requires signal handlers to be registered synchronously at the top
+ * of the workflow function.
+ */
+export declare function setupPauseResumeHandlers(): PauseResumeHandlers;

package/dist/workflows/workflow-signals.js

@@ -0,0 +1,46 @@
+/**
+ * Shared pause/resume signal definitions and handler setup for
+ * workflow execution. Used by both the hydration wrapper
+ * ("stigmer/workflow/execute-from-execution") and the direct
+ * invocation path ("stigmer/workflow/execute").
+ *
+ * The Java/Go orchestrators forward pause and resume signals to
+ * the child workflow. The engine checks a `checkPause` callback
+ * at yield points between tasks; when paused, the workflow blocks
+ * on `condition(() => !paused)` — alive but idle.
+ *
+ * SANDBOX RULES: This file runs inside the Temporal deterministic V8
+ * isolate. Only @temporalio/workflow APIs and pure TS logic.
+ */
+import { defineSignal, setHandler, condition, log } from "@temporalio/workflow";
+export const pauseSignal = defineSignal("pause");
+export const resumeSignal = defineSignal("resume");
+/**
+ * Registers pause and resume signal handlers on the current workflow
+ * and returns a `checkPause` callback suitable for threading into the
+ * engine's `TaskExecutionContext`.
+ *
+ * Must be called at workflow start, before any async work. Temporal
+ * requires signal handlers to be registered synchronously at the top
+ * of the workflow function.
+ */
+export function setupPauseResumeHandlers() {
+    let paused = false;
+    setHandler(pauseSignal, (reason) => {
+        log.info("Pause signal received", { reason });
+        paused = true;
+    });
+    setHandler(resumeSignal, () => {
+        log.info("Resume signal received");
+        paused = false;
+    });
+    const checkPause = async () => {
+        if (!paused)
+            return;
+        log.info("Engine paused at task boundary, waiting for resume signal");
+        await condition(() => !paused);
+        log.info("Engine resumed, continuing execution");
+    };
+    return { checkPause };
+}
+//# sourceMappingURL=workflow-signals.js.map

package/dist/workflows/workflow-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-signals.js","sourceRoot":"","sources":["../../src/workflows/workflow-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAW,OAAO,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAMnD;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,UAAU,CAAC,WAAW,EAAE,CAAC,MAAc,EAAE,EAAE;QACzC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE;QAC5B,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACnC,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE;QAC3C,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,GAAG,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QACtE,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@stigmer/runner",
+  "version": "3.0.1",
+  "description": "Embeddable Temporal worker for the Stigmer AI agent platform — handles agent execution, workflow orchestration, and MCP server management",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "stigmer-runner": "./dist/main.js"
+  },
+  "main": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./src/index.ts"
+    },
+    "./cli": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/main.js",
+      "default": "./src/main.ts"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/build-fingerprint.js",
+    "gen:ipc-fixtures": "tsx scripts/generate-ipc-fixtures.ts",
+    "start": "tsx src/main.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check-deps": "bash scripts/check-langchain-deps.sh",
+    "clean": "rm -rf dist"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "stigmer",
+    "runner",
+    "temporal",
+    "ai-agents",
+    "cursor-sdk",
+    "deepagents"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      },
+      "./cli": {
+        "types": "./dist/main.d.ts",
+        "import": "./dist/main.js"
+      }
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stigmer/stigmer.git",
+    "directory": "backend/services/runner"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "2.12.0",
+    "@connectrpc/connect": "^2.0.0",
+    "@connectrpc/connect-node": "^2.0.0",
+    "@cursor/sdk": "^1.0.11",
+    "@langchain/anthropic": "^1.4.0",
+    "@langchain/core": "^1.1.47",
+    "@langchain/langgraph": "^1.3.0",
+    "@langchain/mcp-adapters": "^1.1.3",
+    "@langchain/openai": "^1.4.0",
+    "zod-to-json-schema": "^3.24.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^2.0.0",
+    "@opentelemetry/exporter-metrics-otlp-grpc": "^0.218.0",
+    "@opentelemetry/sdk-metrics": "^2.0.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.218.0",
+    "@opentelemetry/resources": "^2.0.0",
+    "@opentelemetry/sdk-trace-base": "^2.0.0",
+    "@opentelemetry/sdk-trace-node": "^2.0.0",
+    "@stigmer/protos": "3.0.1",
+    "@temporalio/activity": "^1.11.0",
+    "@temporalio/client": "^1.11.0",
+    "@temporalio/common": "^1.11.0",
+    "@temporalio/interceptors-opentelemetry": "~1.16.0",
+    "@temporalio/worker": "^1.11.0",
+    "@temporalio/workflow": "^1.16.2",
+    "deepagents": "^1.10.0",
+    "jq-wasm": "^1.1.0-jq-1.8.1",
+    "js-yaml": "^4.1.1",
+    "semver": "^7.8.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@temporalio/testing": "^1.16.2",
+    "@types/js-yaml": "^4.0.9",
+    "@types/semver": "^7.7.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.4"
+  }
+}