orchajs 0.18.0 → 0.19.0

package/dist/providers/index.d.ts

@@ -1,4 +1,3 @@
 import type { ProviderResponseGenerator } from "./types.js";
 export { isBuiltInProvider } from "./catalog.js";
 export declare const generateProviderResponse: ProviderResponseGenerator;
-//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.js

@@ -25,16 +25,32 @@ function loadProvider(name) {
     })
         .catch((error) => {
         loadedProviders.delete(name);
-        if ((name === "googlegenai" || name === "vertexai") &&
-            error instanceof Error &&
-            error.message.includes("@google/genai")) {
-            throw new OrchaError("provider_error", `Provider "${name}" requires Node.js 20 or newer and the optional "@google/genai" package.`, { cause: error });
+        const dependency = missingProviderDependency(name, error);
+        if (dependency) {
+            const nodeRequirement = dependency === "@google/genai"
+                ? " Node.js 20 or newer is also required."
+                : "";
+            throw new OrchaError("provider_error", `Provider "${name}" requires the optional "${dependency}" package.${nodeRequirement} Install it in the application that uses this provider.`, { cause: error });
         }
         throw error;
     });
     loadedProviders.set(name, loading);
     return loading;
 }
+function missingProviderDependency(name, error) {
+    if (!(error instanceof Error)) {
+        return undefined;
+    }
+    if (name === "bedrock" &&
+        error.message.includes("@aws-sdk/client-bedrock-runtime")) {
+        return "@aws-sdk/client-bedrock-runtime";
+    }
+    if ((name === "googlegenai" || name === "vertexai") &&
+        error.message.includes("@google/genai")) {
+        return "@google/genai";
+    }
+    return undefined;
+}
 function isProviderAdapter(value) {
     return (typeof value === "object" &&
         value !== null &&
@@ -42,4 +58,3 @@ function isProviderAdapter(value) {
         "generate" in value &&
         typeof value.generate === "function");
 }
-//# sourceMappingURL=index.js.map

package/dist/providers/openai.d.ts

@@ -1,3 +1,2 @@
 import type { ProviderAdapter } from "./types.js";
 export declare const openAIProvider: ProviderAdapter;
-//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.js

@@ -316,4 +316,3 @@ function normalizeUsage(usage) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-//# sourceMappingURL=openai.js.map

package/dist/providers/sse.d.ts

@@ -1,2 +1 @@
 export declare function readServerSentEvents(response: Response): AsyncGenerator<Record<string, unknown>>;
-//# sourceMappingURL=sse.d.ts.map

package/dist/providers/sse.js

@@ -55,4 +55,3 @@ export async function* readServerSentEvents(response) {
         reader.releaseLock();
     }
 }
-//# sourceMappingURL=sse.js.map

package/dist/providers/types.d.ts

@@ -69,4 +69,3 @@ export interface ProviderAdapter {
     generate(configuration: ProviderConfiguration, request: ProviderRequest): Promise<ProviderResponse>;
 }
 export type ProviderResponseGenerator = (name: ProviderName, configuration: ProviderConfiguration, request: ProviderRequest) => Promise<ProviderResponse>;
-//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/providers/vertex-ai.d.ts

@@ -1,3 +1,2 @@
 import type { ProviderAdapter } from "./types.js";
 export declare const vertexAIProvider: ProviderAdapter;
-//# sourceMappingURL=vertex-ai.d.ts.map

package/dist/providers/vertex-ai.js

@@ -37,4 +37,3 @@ async function generateVertexAI(configuration, request) {
     });
     return generateGoogleContent(toGoogleContentClient(client), request, "vertexai");
 }
-//# sourceMappingURL=vertex-ai.js.map

package/dist/runtime/actions/context.d.ts

@@ -14,4 +14,3 @@ export declare function createLocalActionContext(options: {
     metadata: SessionMetadata;
     idempotencyKey: string;
 }): LocalActionContext;
-//# sourceMappingURL=context.d.ts.map

package/dist/runtime/actions/context.js

@@ -66,4 +66,3 @@ function isAllowedHost(hostname, allowedHosts) {
         return hostname === allowed;
     });
 }
-//# sourceMappingURL=context.js.map

package/dist/runtime/actions/execute.d.ts

@@ -7,4 +7,3 @@ export declare function executeLocalAction(options: {
     metadata: SessionMetadata;
     idempotencyKey: string;
 }): Promise<unknown>;
-//# sourceMappingURL=execute.d.ts.map

package/dist/runtime/actions/execute.js

@@ -6,9 +6,21 @@ export async function executeLocalAction(options) {
         return executeNativeAction(options.action, options.parameters, context);
     }
     if (process.env.ORCHA_INCLUDE_SANDBOX !== "0") {
-        const { executeSandboxedAction } = await import("./sandbox.js");
+        const { executeSandboxedAction } = await loadSandboxRuntime();
         return executeSandboxedAction(options.action, options.parameters, context, options.configuration.sandbox);
     }
     throw new Error("The production bundle was built without the QuickJS sandbox.");
 }
-//# sourceMappingURL=execute.js.map
+async function loadSandboxRuntime() {
+    try {
+        return await import("./sandbox.js");
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            (error.message.includes("quickjs-emscripten-core") ||
+                error.message.includes("@jitl/quickjs-singlefile-cjs-release-sync"))) {
+            throw new Error('Sandboxed actions require the optional "quickjs-emscripten-core" and "@jitl/quickjs-singlefile-cjs-release-sync" packages. Install both in the application that selects the sandbox runtime.', { cause: error });
+        }
+        throw error;
+    }
+}

package/dist/runtime/actions/native.d.ts

@@ -1,4 +1,3 @@
 import type { CompiledActionManifest } from "../../types.js";
 import type { LocalActionContext } from "./context.js";
 export declare function executeNativeAction(action: CompiledActionManifest, parameters: Record<string, unknown>, context: LocalActionContext): Promise<unknown>;
-//# sourceMappingURL=native.d.ts.map

package/dist/runtime/actions/native.js

@@ -26,4 +26,3 @@ export async function executeNativeAction(action, parameters, context) {
         }
     }
 }
-//# sourceMappingURL=native.js.map

package/dist/runtime/actions/sandbox.d.ts

@@ -4,4 +4,3 @@ export declare function executeSandboxedAction(action: CompiledActionManifest, p
     memoryLimitMb?: number;
     stackLimitKb?: number;
 }): Promise<unknown>;
-//# sourceMappingURL=sandbox.d.ts.map

package/dist/runtime/actions/sandbox.js

@@ -114,4 +114,3 @@ function createSandboxProgram(action, parameters, context) {
         "})()",
     ].join("\n");
 }
-//# sourceMappingURL=sandbox.js.map

package/dist/runtime/agent.d.ts

@@ -39,4 +39,3 @@ export declare class RuntimeAgent implements AgentRuntime {
     pause(sessionId: string): Promise<SessionSnapshot>;
     update(sessionId: string, update: SessionUpdate): Promise<SessionSnapshot>;
 }
-//# sourceMappingURL=agent.d.ts.map

package/dist/runtime/agent.js

@@ -2622,4 +2622,3 @@ function failure(sessionId, code, message, options = {}) {
         },
     };
 }
-//# sourceMappingURL=agent.js.map

package/dist/runtime/context.d.ts

@@ -9,4 +9,3 @@ export interface OrchaRuntimeContext {
 }
 export declare function setOrchaRuntimeContext(client: object, context: OrchaRuntimeContext): void;
 export declare function getOrchaRuntimeContext(client: object): OrchaRuntimeContext;
-//# sourceMappingURL=context.d.ts.map

package/dist/runtime/context.js

@@ -9,4 +9,3 @@ export function getOrchaRuntimeContext(client) {
     }
     return context;
 }
-//# sourceMappingURL=context.js.map

package/dist/runtime/create-orcha.d.ts

@@ -9,4 +9,3 @@ export interface Orcha {
 export type OrchaClient = Orcha & Record<string, AgentRuntime>;
 export type BundleResolver = (configuration: OrchaInitConfiguration) => CompiledBundle;
 export declare function createOrcha(resolveBundle: BundleResolver, generateProviderResponse: ProviderResponseGenerator): OrchaClient;
-//# sourceMappingURL=create-orcha.d.ts.map

package/dist/runtime/create-orcha.js

@@ -120,4 +120,3 @@ export function createOrcha(resolveBundle, generateProviderResponse) {
     core.attachClient(client);
     return client;
 }
-//# sourceMappingURL=create-orcha.js.map

package/dist/runtime/execution.d.ts

@@ -2,4 +2,3 @@ import type { EvaluationResult, Execution, ExecutionSnapshot, RunResult } from "
 export type OutputSnapshotPublisher<TOutput> = (output: TOutput) => void;
 export type ExecutionSnapshotPublisher<TOutput> = (snapshot: ExecutionSnapshot<TOutput>) => void;
 export declare function createExecution<TOutput>(sessionId: string, execute: (publishOutput: OutputSnapshotPublisher<TOutput>, publishSnapshot: ExecutionSnapshotPublisher<TOutput>) => Promise<RunResult<TOutput>>, resolveEvaluations?: () => Promise<EvaluationResult[]>): Execution<TOutput>;
-//# sourceMappingURL=execution.d.ts.map

package/dist/runtime/execution.js

@@ -74,4 +74,3 @@ export function createExecution(sessionId, execute, resolveEvaluations) {
         evaluations,
     };
 }
-//# sourceMappingURL=execution.js.map

package/dist/runtime/session-events.d.ts

@@ -9,4 +9,3 @@ export declare class SessionEventWriter {
 }
 export declare function messagesFromEvents(events: SessionEvent[], includeRun?: number): ProviderMessage[];
 export declare function normalizePersistedToolResults(value: unknown[]): ProviderToolResult[] | undefined;
-//# sourceMappingURL=session-events.d.ts.map

package/dist/runtime/session-events.js

@@ -237,4 +237,3 @@ function isProviderName(value) {
     return (value === "amarsia" ||
         (typeof value === "string" && isBuiltInProvider(value)));
 }
-//# sourceMappingURL=session-events.js.map

package/dist/runtime/structured-output.d.ts

@@ -1,3 +1,2 @@
 export declare function parseStructuredOutput(text: string, schema: Record<string, unknown>): unknown;
 export declare function validateStructuredValue(value: unknown, schema: Record<string, unknown>): void;
-//# sourceMappingURL=structured-output.d.ts.map

package/dist/runtime/structured-output.js

@@ -123,4 +123,3 @@ function matchesType(value, type) {
 function isObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-//# sourceMappingURL=structured-output.js.map

package/dist/storage/browser-indexeddb.d.ts

@@ -18,4 +18,3 @@ export declare class BrowserIndexedDbSessionStore implements SessionStore {
     append(_sessionId: string, _events: SessionEvent[]): Promise<void>;
     listSessionIds(): Promise<string[]>;
 }
-//# sourceMappingURL=browser-indexeddb.d.ts.map

package/dist/storage/browser-indexeddb.js

@@ -23,4 +23,3 @@ export class BrowserIndexedDbSessionStore {
         throw new Error("Browser IndexedDB session storage is not implemented yet.");
     }
 }
-//# sourceMappingURL=browser-indexeddb.js.map

package/dist/storage/create-store.d.ts

@@ -7,4 +7,3 @@ export interface CreateSessionStoreOptions {
     agentName: string;
 }
 export declare function createSessionStore(options: CreateSessionStoreOptions): SessionStore;
-//# sourceMappingURL=create-store.d.ts.map

package/dist/storage/create-store.js

@@ -11,4 +11,3 @@ export function createSessionStore(options) {
     }
     throw new Error(`Storage strategy "${String(strategy)}" is not implemented.`);
 }
-//# sourceMappingURL=create-store.js.map

package/dist/storage/edge-store.d.ts

@@ -17,4 +17,3 @@ export declare class EdgeSessionStore implements SessionStore {
     append(_sessionId: string, _events: SessionEvent[]): Promise<void>;
     listSessionIds(): Promise<string[]>;
 }
-//# sourceMappingURL=edge-store.d.ts.map

package/dist/storage/edge-store.js

@@ -22,4 +22,3 @@ export class EdgeSessionStore {
         throw new Error("Edge session storage is not implemented yet.");
     }
 }
-//# sourceMappingURL=edge-store.js.map

package/dist/storage/migrate.d.ts

@@ -5,4 +5,3 @@ export interface SessionStoreMigrationResult {
 }
 export declare function migrateSessionStore(source: SessionStore, destination: SessionStore): Promise<SessionStoreMigrationResult>;
 export declare function exportSessionJsonl(store: SessionStore, sessionId: string): Promise<string>;
-//# sourceMappingURL=migrate.d.ts.map

package/dist/storage/migrate.js

@@ -32,4 +32,3 @@ function assertCompatibleHistory(sessionId, source, destination) {
 function incompatibleHistory(sessionId) {
     return new Error(`Cannot migrate session "${sessionId}" because the destination contains conflicting history.`);
 }
-//# sourceMappingURL=migrate.js.map

package/dist/storage/node-jsonl.d.ts

@@ -11,4 +11,3 @@ export declare class NodeJsonlSessionStore implements SessionStore {
     subscribeAll(listener: (sessionId: string, events: SessionEvent[]) => void): () => void;
 }
 export declare function sessionAgentDirectoryName(agent: string): string;
-//# sourceMappingURL=node-jsonl.d.ts.map

package/dist/storage/node-jsonl.js

@@ -239,4 +239,3 @@ function isMissingFileError(error) {
         "code" in error &&
         error.code === "ENOENT");
 }
-//# sourceMappingURL=node-jsonl.js.map

package/dist/storage/node-sqlite.d.ts

@@ -11,4 +11,3 @@ export declare class NodeSqliteSessionStore implements SessionStore {
     subscribeAll(listener: (sessionId: string, events: SessionEvent[]) => void): () => void;
     describeLocation(_sessionId: string): Promise<string>;
 }
-//# sourceMappingURL=node-sqlite.d.ts.map

package/dist/storage/node-sqlite.js

@@ -139,7 +139,7 @@ function loadDatabaseConstructor() {
         return "default" in loaded ? loaded.default : loaded;
     }
     catch (error) {
-        throw new Error('Orcha\'s optional SQLite dependency is unavailable. Reinstall "orchajs" with optional dependencies enabled or use the "node-jsonl" strategy.', { cause: error });
+        throw new Error('SQLite storage requires the optional "better-sqlite3" package. Install it in the application or use the default "node-jsonl" strategy.', { cause: error });
     }
 }
 function validateSessionId(sessionId) {
@@ -155,4 +155,3 @@ function safelyNotify(notify) {
         // Observers cannot invalidate a durable write.
     }
 }
-//# sourceMappingURL=node-sqlite.js.map

package/dist/storage/react-native-jsonl.d.ts

@@ -18,4 +18,3 @@ export declare class ReactNativeJsonlSessionStore implements SessionStore {
     append(_sessionId: string, _events: SessionEvent[]): Promise<void>;
     listSessionIds(): Promise<string[]>;
 }
-//# sourceMappingURL=react-native-jsonl.d.ts.map

package/dist/storage/react-native-jsonl.js

@@ -23,4 +23,3 @@ export class ReactNativeJsonlSessionStore {
         throw new Error("React Native JSONL session storage is not implemented yet.");
     }
 }
-//# sourceMappingURL=react-native-jsonl.js.map

package/dist/testing.d.ts

@@ -2,4 +2,3 @@ import type { OrchaClient } from "./runtime/create-orcha.js";
 import type { AgentTestCaseSummary, AgentTestReport, RunTestsOptions } from "./types.js";
 export declare function listTests(orcha: OrchaClient, options?: RunTestsOptions): Promise<AgentTestCaseSummary[]>;
 export declare function runTests(orcha: OrchaClient, options?: RunTestsOptions): Promise<AgentTestReport>;
-//# sourceMappingURL=testing.d.ts.map

package/dist/testing.js

@@ -544,4 +544,3 @@ function isRecord(value) {
         value !== null &&
         !Array.isArray(value));
 }
-//# sourceMappingURL=testing.js.map

package/dist/types.d.ts

@@ -474,4 +474,3 @@ export interface RunTestsOptions {
         test: string;
     }) => void;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist-cjs/amarsia/metadata.js

@@ -207,4 +207,3 @@ function sortStable(value) {
 0 && (module.exports = {
   createAmarsiaProjectMetadata
 });
-//# sourceMappingURL=metadata.js.map

package/dist-cjs/amarsia/sync.js

@@ -68,4 +68,3 @@ async function postProjectMetadata(options) {
 0 && (module.exports = {
   syncAmarsiaProject
 });
-//# sourceMappingURL=sync.js.map

package/dist-cjs/cli-agents-template.js

@@ -1093,4 +1093,3 @@ needed for faithful continuation but are omitted from evaluation transcripts.
 0 && (module.exports = {
   AGENTS_MD
 });
-//# sourceMappingURL=cli-agents-template.js.map

package/dist-cjs/compiler/build-project.js

@@ -177,4 +177,3 @@ function createProviderRuntimeSource(providerNames) {
 0 && (module.exports = {
   buildProject
 });
-//# sourceMappingURL=build-project.js.map

package/dist-cjs/compiler/compile.js

@@ -555,4 +555,3 @@ function validateNumber(agentName, field, value, constraints) {
   compileRegistry,
   serializeBundle
 });
-//# sourceMappingURL=compile.js.map

package/dist-cjs/env.js

@@ -38,4 +38,3 @@ function loadProjectEnvironment(projectRoot) {
 0 && (module.exports = {
   loadProjectEnvironment
 });
-//# sourceMappingURL=env.js.map

package/dist-cjs/errors.js

@@ -38,4 +38,3 @@ class OrchaError extends Error {
 0 && (module.exports = {
   OrchaError
 });
-//# sourceMappingURL=errors.js.map

package/dist-cjs/file-content.js

@@ -99,4 +99,3 @@ function normalizeMimeType(mimeType, source) {
   normalizeUrlContent,
   readLocalFileContent
 });
-//# sourceMappingURL=file-content.js.map

package/dist-cjs/index.js

@@ -41,4 +41,3 @@ var import_migrate = require("./storage/migrate.js");
   migrateSessionStore,
   orcha
 });
-//# sourceMappingURL=index.js.map

package/dist-cjs/integrations/esbuild.js

@@ -43,4 +43,3 @@ function orchaPlugin(options = {}) {
 0 && (module.exports = {
   orchaPlugin
 });
-//# sourceMappingURL=esbuild.js.map

package/dist-cjs/orcha.js

@@ -49,4 +49,3 @@ const orcha = (0, import_create_orcha.createOrcha)(
 0 && (module.exports = {
   orcha
 });
-//# sourceMappingURL=orcha.js.map

package/dist-cjs/playground/server.js

@@ -686,4 +686,3 @@ function validateMutationRequest(request, mutationToken) {
 0 && (module.exports = {
   startPlayground
 });
-//# sourceMappingURL=server.js.map

package/dist-cjs/playground/source.js

@@ -152,4 +152,3 @@ function parseObject(source, label) {
 0 && (module.exports = {
   readPlaygroundAgentSource
 });
-//# sourceMappingURL=source.js.map

package/dist-cjs/project-loader.js

@@ -83,4 +83,3 @@ function restoreEnvironment(name, value) {
 0 && (module.exports = {
   loadProject
 });
-//# sourceMappingURL=project-loader.js.map

package/dist-cjs/providers/anthropic.js

@@ -416,4 +416,3 @@ function getReasoningConfiguration(request) {
 0 && (module.exports = {
   anthropicProvider
 });
-//# sourceMappingURL=anthropic.js.map

package/dist-cjs/providers/bedrock.js

@@ -575,4 +575,3 @@ function isRecord(value) {
   bedrockProvider,
   generateBedrockContent
 });
-//# sourceMappingURL=bedrock.js.map

package/dist-cjs/providers/catalog.js

@@ -57,4 +57,3 @@ function isBuiltInProvider(name) {
   builtInProviderCatalog,
   isBuiltInProvider
 });
-//# sourceMappingURL=catalog.js.map

package/dist-cjs/providers/deepseek.js

@@ -312,4 +312,3 @@ function isRecord(value) {
 0 && (module.exports = {
   deepSeekProvider
 });
-//# sourceMappingURL=deepseek.js.map

package/dist-cjs/providers/dispatcher.js

@@ -39,4 +39,3 @@ function createProviderResponseGenerator(providers) {
 0 && (module.exports = {
   createProviderResponseGenerator
 });
-//# sourceMappingURL=dispatcher.js.map

package/dist-cjs/providers/google-gemini.js

@@ -373,4 +373,3 @@ function isRecord(value) {
   generateGoogleContent,
   toGoogleContentClient
 });
-//# sourceMappingURL=google-gemini.js.map

package/dist-cjs/providers/google-genai.js

@@ -48,4 +48,3 @@ async function generateGoogleGenAI(configuration, request) {
 0 && (module.exports = {
   googleGenAIProvider
 });
-//# sourceMappingURL=google-genai.js.map

package/dist-cjs/providers/index.js

@@ -53,10 +53,12 @@ function loadProvider(name) {
     return provider;
   }).catch((error) => {
     loadedProviders.delete(name);
-    if ((name === "googlegenai" || name === "vertexai") && error instanceof Error && error.message.includes("@google/genai")) {
+    const dependency = missingProviderDependency(name, error);
+    if (dependency) {
+      const nodeRequirement = dependency === "@google/genai" ? " Node.js 20 or newer is also required." : "";
       throw new import_errors.OrchaError(
         "provider_error",
-        `Provider "${name}" requires Node.js 20 or newer and the optional "@google/genai" package.`,
+        `Provider "${name}" requires the optional "${dependency}" package.${nodeRequirement} Install it in the application that uses this provider.`,
         { cause: error }
       );
     }
@@ -65,6 +67,18 @@ function loadProvider(name) {
   loadedProviders.set(name, loading);
   return loading;
 }
+function missingProviderDependency(name, error) {
+  if (!(error instanceof Error)) {
+    return void 0;
+  }
+  if (name === "bedrock" && error.message.includes("@aws-sdk/client-bedrock-runtime")) {
+    return "@aws-sdk/client-bedrock-runtime";
+  }
+  if ((name === "googlegenai" || name === "vertexai") && error.message.includes("@google/genai")) {
+    return "@google/genai";
+  }
+  return void 0;
+}
 function isProviderAdapter(value) {
   return typeof value === "object" && value !== null && "name" in value && "generate" in value && typeof value.generate === "function";
 }
@@ -73,4 +87,3 @@ function isProviderAdapter(value) {
   generateProviderResponse,
   isBuiltInProvider
 });
-//# sourceMappingURL=index.js.map

package/dist-cjs/providers/openai.js

@@ -327,4 +327,3 @@ function isRecord(value) {
 0 && (module.exports = {
   openAIProvider
 });
-//# sourceMappingURL=openai.js.map

package/dist-cjs/providers/sse.js

@@ -80,4 +80,3 @@ async function* readServerSentEvents(response) {
 0 && (module.exports = {
   readServerSentEvents
 });
-//# sourceMappingURL=sse.js.map

package/dist-cjs/providers/types.js

@@ -15,4 +15,3 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var types_exports = {};
 module.exports = __toCommonJS(types_exports);
-//# sourceMappingURL=types.js.map

package/dist-cjs/providers/vertex-ai.js

@@ -69,4 +69,3 @@ async function generateVertexAI(configuration, request) {
 0 && (module.exports = {
   vertexAIProvider
 });
-//# sourceMappingURL=vertex-ai.js.map

package/dist-cjs/runtime/actions/context.js

@@ -103,4 +103,3 @@ function isAllowedHost(hostname, allowedHosts) {
 0 && (module.exports = {
   createLocalActionContext
 });
-//# sourceMappingURL=context.js.map

package/dist-cjs/runtime/actions/execute.js

@@ -40,7 +40,7 @@ async function executeLocalAction(options) {
     return (0, import_native.executeNativeAction)(options.action, options.parameters, context);
   }
   if (process.env.ORCHA_INCLUDE_SANDBOX !== "0") {
-    const { executeSandboxedAction } = await import("./sandbox.js");
+    const { executeSandboxedAction } = await loadSandboxRuntime();
     return executeSandboxedAction(
       options.action,
       options.parameters,
@@ -52,8 +52,22 @@ async function executeLocalAction(options) {
     "The production bundle was built without the QuickJS sandbox."
   );
 }
+async function loadSandboxRuntime() {
+  try {
+    return await import("./sandbox.js");
+  } catch (error) {
+    if (error instanceof Error && (error.message.includes("quickjs-emscripten-core") || error.message.includes(
+      "@jitl/quickjs-singlefile-cjs-release-sync"
+    ))) {
+      throw new Error(
+        'Sandboxed actions require the optional "quickjs-emscripten-core" and "@jitl/quickjs-singlefile-cjs-release-sync" packages. Install both in the application that selects the sandbox runtime.',
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   executeLocalAction
 });
-//# sourceMappingURL=execute.js.map

package/dist-cjs/runtime/actions/native.js

@@ -65,4 +65,3 @@ return __orchaActionModule.default;`
 0 && (module.exports = {
   executeNativeAction
 });
-//# sourceMappingURL=native.js.map

package/dist-cjs/runtime/actions/sandbox.js

@@ -165,4 +165,3 @@ function createSandboxProgram(action, parameters, context) {
 0 && (module.exports = {
   executeSandboxedAction
 });
-//# sourceMappingURL=sandbox.js.map

package/dist-cjs/runtime/agent.js

@@ -2839,4 +2839,3 @@ function failure(sessionId, code, message, options = {}) {
 0 && (module.exports = {
   RuntimeAgent
 });
-//# sourceMappingURL=agent.js.map

package/dist-cjs/runtime/context.js

@@ -41,4 +41,3 @@ function getOrchaRuntimeContext(client) {
   getOrchaRuntimeContext,
   setOrchaRuntimeContext
 });
-//# sourceMappingURL=context.js.map