@code-yeongyu/senpi-codemode 2026.10.10 → 2026.10.12

package/src/tool/run-eval-cell.ts

@@ -9,12 +9,10 @@ import {
 import type { KernelToHostMessage } from "../bridge/protocol.ts";
 import { resolveSandbox } from "../config/feature-settings.ts";
 import { DEFAULT_FOREGROUND_WINDOW_SECONDS, defaultCodemodeSettings } from "../config/settings.ts";
-import {
-	KERNEL_TOOLS_CAPABILITIES,
-	type KernelToolsCapability,
-	type KernelToolsDescribeResult,
-} from "../kernels/js/kernel-tools-types.ts";
-import { sandboxCellExecutor } from "../kernels/sandbox/sandbox-cell.ts";
+import type { JsEnvironments } from "../environments/js-environments.ts";
+import type { PackagesInstallEnvironments } from "../environments/packages-install.ts";
+import { KERNEL_TOOLS_CAPABILITIES, type KernelToolsCapability } from "../kernels/js/kernel-tools-types.ts";
+import { sandboxCellExecutor, sandboxRuntimeInfo } from "../kernels/sandbox/sandbox-cell.ts";
 import { TIMEOUT_PAUSE_OP, TIMEOUT_RESUME_OP } from "../timeouts/bridge-timeout.ts";
 import { abortError, CellExecution, defaultTimeoutFactory } from "./cell-execution.ts";
 import { CellHandler, type CellState } from "./cell-handler.ts";
@@ -44,7 +42,8 @@ export async function runEvalCell(
 	const bridgeAbortController = new AbortController();
 	const cellSignal = AbortSignal.any([invocation.signal, bridgeAbortController.signal]);
 	const bridgeContext: ExtensionContext = { ...invocation.ctx, signal: cellSignal };
-	const runtime = options.runtimes?.[invocation.input.language];
+	const runtime =
+		invocation.input.isolate === true ? sandboxRuntimeInfo() : options.runtimes?.[invocation.input.language];
 	const state: CellState = {
 		input: invocation.input,
 		...(runtime === undefined ? {} : { runtime }),
@@ -240,6 +239,7 @@ async function executeCell(
 				...(kernelTools === undefined ? {} : { kernelTools }),
 				...(options.handles === undefined ? {} : { handles: options.handles }),
 				hardDeadlineMs: cell.startedAtMs + cell.hardLimitSeconds * 1_000,
+				...cellEnvironments(invocation.input.language, options),
 			});
 			handler = activeHandler;
 			cellManager.bindKernel(
@@ -352,14 +352,24 @@ async function executeCell(
 }
 
 function kernelToolsFor(kernel: EvalKernel): KernelToolsCapability | undefined {
-	if (!("describeKernelTools" in kernel) || typeof kernel.describeKernelTools !== "function") return undefined;
-	const withTools = kernel as EvalKernel & {
-		describeKernelTools: (names: readonly string[]) => Promise<KernelToolsDescribeResult>;
-		invokeKernelTool: ExtensionKernelTools["invoke"];
-	};
+	if (typeof kernel.describeKernelTools !== "function" || typeof kernel.invokeKernelTool !== "function")
+		return undefined;
+	const describeKernelTools = kernel.describeKernelTools.bind(kernel);
+	const invokeKernelTool = kernel.invokeKernelTool.bind(kernel);
 	return {
 		capabilities: KERNEL_TOOLS_CAPABILITIES,
-		describe: (names) => withTools.describeKernelTools(names),
-		invoke: (request, options) => withTools.invokeKernelTool(request, options),
+		describe: describeKernelTools,
+		invoke: invokeKernelTool,
 	} satisfies ExtensionKernelTools;
 }
+
+// Only JS cells call tools in-process; a Python cell reaches packages.install() over the bridge, whose session manager
+// holds the same Python environment its magics use.
+function cellEnvironments(
+	language: string,
+	options: { readonly jsEnvironments?: JsEnvironments },
+): { readonly environments?: PackagesInstallEnvironments } {
+	if (language === "js" && options.jsEnvironments !== undefined)
+		return { environments: { js: options.jsEnvironments } };
+	return {};
+}

package/src/tool/runtime-label.ts

@@ -10,7 +10,8 @@ const ELLIPSIS = "\u2026";
  * runtime name because node and bun are otherwise indistinguishable.
  */
 export function formatRuntimeBadge(language: EvalLanguage, runtime: EvalRuntimeInfo, home: string = homedir()): string {
-	const label = language === "js" ? `${runtime.name} ${runtime.version}` : runtime.version;
+	const base = language === "js" ? `${runtime.name} ${runtime.version}` : runtime.version;
+	const label = runtime.isolation === undefined ? base : `${base}, ${runtime.isolation}`;
 	if (runtime.path === undefined || runtime.path.length === 0) return label;
 	return `${label}, ${minifyPath(runtime.path, home)}`;
 }

package/src/tool/types.ts

@@ -1,4 +1,9 @@
-import type { AgentToolResult, AgentToolUpdateCallback, KernelPreludeContribution } from "@code-yeongyu/senpi";
+import type {
+	AgentToolResult,
+	AgentToolUpdateCallback,
+	ExtensionKernelTools,
+	KernelPreludeContribution,
+} from "@code-yeongyu/senpi";
 import { type TSchema, type TUnsafe, Type } from "typebox";
 import type { KernelMemoryReport } from "../bridge/memory-protocol.ts";
 import type { HostToKernelMessage, KernelToHostMessage } from "../bridge/protocol.ts";
@@ -8,7 +13,7 @@ import {
 	DEFAULT_RUN_BUDGET_SECONDS,
 	defaultCodemodeSettings,
 } from "../config/settings.ts";
-import type { KernelToolsCapability } from "../kernels/js/kernel-tools-types.ts";
+import type { KernelToolsCapability, KernelToolsDescribeResult } from "../kernels/js/kernel-tools-types.ts";
 import type { TruncationMeta } from "../output/output-meta.ts";
 
 export const evalLanguageOrder = ["js", "py", "rb", "jl"] as const;
@@ -238,6 +243,10 @@ export interface EvalKernel {
 	isAlive?(): boolean;
 	/** Hands over, and forgets, every queued cell of a dead kernel that never started. */
 	drainPending?(): readonly PendingCell[];
+	/** Describes this kernel's registered kernel tools; only an in-process JS kernel has them. */
+	describeKernelTools?(names: readonly string[]): Promise<KernelToolsDescribeResult>;
+	/** Invokes one of this kernel's kernel tools; present exactly when `describeKernelTools` is. */
+	invokeKernelTool?: ExtensionKernelTools["invoke"];
 }
 
 export interface EvalKernelManager {
@@ -279,6 +288,8 @@ export interface EvalRuntimeInfo {
 	readonly name: string;
 	readonly version: string;
 	readonly path?: string;
+	/** JS only: the kernel runs in a child process (`process`), or the cell ran in an isolated QuickJS VM (`sandbox`). */
+	readonly isolation?: "process" | "sandbox";
 }
 
 export type EvalRuntimes = Readonly<Partial<Record<EvalLanguage, EvalRuntimeInfo>>>;