@alisio/core 0.5.2 → 0.6.0

package/dist/tools/analysis.d.ts

@@ -5,6 +5,10 @@ import type { AnalysisRerun } from "../analysis/rerun.ts";
 import { type AnalysisRuntimeManager } from "../analysis/runtime-manager.ts";
 import { type ArtifactStore } from "../artifacts/store.ts";
 import type { ToolRegistry } from "../core/registry.ts";
+import type { ExecutionKernel } from "../forge/kernel.ts";
+import { type IsolationPolicy, type PythonRuntimeSetting } from "../forge/python/backend-selector.ts";
+import type { PyodideBackendDeps } from "../forge/python/pyodide-backend.ts";
+import type { EngineRegistry } from "../forge/registry.ts";
 export declare const NOT_SANDBOXED = "Managed Python is not a sandbox: the script runs with your user permissions and can read your files and use the network.";
 export interface AnalysisLimits {
     timeoutMs: number;
@@ -17,13 +21,30 @@ export interface AnalysisToolDeps {
     jobs: AnalysisJobs;
     /** Discovery (`interpreter`) and, for the optional extras, `hasExtras` / `installExtras`. */
     runtime: Pick<AnalysisRuntimeManager, "interpreter"> & Partial<Pick<AnalysisRuntimeManager, "hasExtras" | "installExtras">>;
-    /** Container mode (`analysis.runtime: "oci"`), read when each call starts. */
+    /** `analysis.runtime` and the container runtime, read when each call starts. */
     oci?: {
-        mode(): "managed" | "oci";
+        mode(): PythonRuntimeSetting;
         runtime(): OciRuntime;
     };
+    /** `analysis.isolation`, read when each call starts (`preferred` when absent). */
+    isolation?: () => IsolationPolicy;
+    /** The Pyodide backend (`analysis.runtime: "wasm"`, and a candidate of `auto`). */
+    wasm?: PyodideBackendDeps;
     /** Rerun of an earlier execution (`rerunOf`). */
     rerun?: AnalysisRerun;
+    /**
+     * The Forja kernel and engine registry shared with `js_run` (one journal, one state store). When
+     * absent the tool builds a private kernel over the jobs' database.
+     */
+    forge?: {
+        kernel: ExecutionKernel;
+        engines: EngineRegistry;
+    };
+    /**
+     * The verified Forja scratchpad of a session; undefined while there is none (Forja off, or
+     * `--read-only`). It enables `codePath` and is exposed to the script read-only.
+     */
+    scratchpad?: (session: string) => Promise<string | undefined>;
     /** Datasets of the session: `inputs: [{ datasetId }]` copies the dataset's SQLite file. */
     datasets?: DatasetService;
     rootOf: (sessionId: string) => string;
@@ -33,5 +54,7 @@ export interface AnalysisToolDeps {
         candidates: boolean;
         extras: string[];
     };
+    /** Whether `forge_guide` exists now; error results then point at `python.environment` (spec §8.4). */
+    guideHints?: () => boolean;
 }
 export declare function registerAnalysisTools(registry: ToolRegistry, deps: AnalysisToolDeps): void;