@executor-js/execution 0.0.1 → 0.1.0

package/README.md

@@ -1,4 +1,4 @@
-# @executor/execution
+# @executor-js/execution
 
 Sandboxed JavaScript execution for an executor. Hands a `tools.<namespace>.<name>(...)` proxy into a code sandbox so an agent (or any caller) can run generated TypeScript/JavaScript that invokes the executor's registered tools.
 
@@ -7,22 +7,22 @@ Supports pause/resume for elicitation-driven flows: tools that need user input (
 ## Install
 
 ```sh
-bun add @executor/sdk @executor/execution @executor/runtime-quickjs
+bun add @executor-js/sdk @executor-js/execution @executor-js/runtime-quickjs
 # or
-npm install @executor/sdk @executor/execution @executor/runtime-quickjs
+npm install @executor-js/sdk @executor-js/execution @executor-js/runtime-quickjs
 ```
 
-`@executor/runtime-quickjs` is the sandbox runtime. It's not a dependency of `@executor/execution` — you bring your own so consumers with a different runtime don't ship ~13 MB of WASM they never use.
+`@executor-js/runtime-quickjs` is the sandbox runtime. It's not a dependency of `@executor-js/execution` — you bring your own so consumers with a different runtime don't ship ~13 MB of WASM they never use.
 
 ## Usage
 
 ```ts
-import { createExecutor } from "@executor/sdk";
-import { createExecutionEngine } from "@executor/execution";
-import { makeQuickJsExecutor } from "@executor/runtime-quickjs";
+import { createExecutor } from "@executor-js/sdk";
+import { createExecutionEngine } from "@executor-js/execution";
+import { makeQuickJsExecutor } from "@executor-js/runtime-quickjs";
 
 const executor = await createExecutor({
-  scope: { name: "my-app" },
+  onElicitation: "accept-all",
 });
 
 const engine = createExecutionEngine({
@@ -56,6 +56,11 @@ console.log(result);
 When the host doesn't support inline elicitation, use `executeWithPause` to intercept the first request as a pause point:
 
 ```ts
+import type { ExecutionEngine } from "@executor-js/execution";
+
+declare const engine: ExecutionEngine;
+declare const code: string;
+
 const started = await engine.executeWithPause(code);
 
 if (started.status === "paused") {
@@ -71,6 +76,10 @@ if (started.status === "paused") {
 ## Workflow description for LLMs
 
 ```ts
+import type { ExecutionEngine } from "@executor-js/execution";
+
+declare const engine: ExecutionEngine;
+
 const docs = await engine.getDescription();
 // Returns the canonical "use tools.search(), then tools.describe.tool(), then call …"
 // workflow prose + per-namespace tool listing. Feed this to an LLM so it knows
@@ -79,10 +88,10 @@ const docs = await engine.getDescription();
 
 ## Using with Effect
 
-If you're building on `@executor/sdk` (the raw Effect entry), import from the `/core` subpath. The returned engine is Effect-native: `execute`, `executeWithPause`, and `resume` all become `Effect.Effect<...>`, and `onElicitation` is an `ElicitationHandler` returning `Effect.Effect<ElicitationResponse>`.
+If you're building on `@executor-js/sdk/core` (the raw Effect entry), import from the `/core` subpath. The returned engine is Effect-native: `execute`, `executeWithPause`, and `resume` all become `Effect.Effect<...>`, and `onElicitation` is an `ElicitationHandler` returning `Effect.Effect<ElicitationResponse>`.
 
 ```ts
-import { createExecutionEngine } from "@executor/execution";
+import { createExecutionEngine } from "@executor-js/execution/core";
 ```
 
 ## Status

package/dist/{chunk-BF7CHG2T.js → chunk-QO23HCJR.js}

@@ -1,26 +1,65 @@
 // src/errors.ts
 import * as Data from "effect/Data";
+import { CodeExecutionError } from "@executor-js/codemode-core";
 var ExecutionToolError = class extends Data.TaggedError("ExecutionToolError") {
 };
 
 // src/tool-invoker.ts
 import { Effect } from "effect";
+import * as Cause from "effect/Cause";
+var extractSourceNamespace = (path) => {
+  const idx = path.indexOf(".");
+  return idx === -1 ? path : path.slice(0, idx);
+};
+var stringifyUnknown = (value) => {
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+};
+var hasStringMessage = (value) => value !== null && typeof value === "object" && "message" in value && typeof value.message === "string";
+var messageFromErrorLike = (value) => {
+  if (value instanceof Error || hasStringMessage(value)) {
+    return value.message;
+  }
+  return void 0;
+};
+var renderToolErrorMessage = (error) => messageFromErrorLike(error) ?? (typeof error === "undefined" ? "Tool execution failed" : stringifyUnknown(error));
 var makeExecutorToolInvoker = (executor, options) => ({
-  invoke: ({ path, args }) => Effect.gen(function* () {
+  invoke: Effect.fn("mcp.tool.dispatch")(function* ({ path, args }) {
+    yield* Effect.annotateCurrentSpan({
+      "mcp.tool.name": path,
+      "mcp.tool.source_id": extractSourceNamespace(path)
+    });
     const result = yield* executor.tools.invoke(path, args, options.invokeOptions).pipe(
-      Effect.catchTag(
-        "ElicitationDeclinedError",
-        (err) => Effect.fail(
+      Effect.catchCause((cause) => {
+        const err = cause.reasons.find(Cause.isFailReason)?.error;
+        if (!isElicitationDeclinedError(err)) {
+          return Effect.fail(
+            new ExecutionToolError({
+              message: renderToolErrorMessage(err),
+              cause: err ?? cause
+            })
+          );
+        }
+        return Effect.fail(
           new ExecutionToolError({
             message: `Tool "${err.toolId}" requires approval but the request was ${err.action === "cancel" ? "cancelled" : "declined"} by the user.`,
             cause: err
           })
-        )
-      )
+        );
+      })
     );
     const r = result;
     if (r !== null && typeof r === "object" && "error" in r && r.error !== null && r.error !== void 0) {
-      return yield* Effect.fail(r.error);
+      const error = r.error;
+      return yield* Effect.fail(
+        new ExecutionToolError({
+          message: renderToolErrorMessage(error),
+          cause: error
+        })
+      );
     }
     if (r !== null && typeof r === "object" && "data" in r) {
       return r.data;
@@ -28,6 +67,20 @@ var makeExecutorToolInvoker = (executor, options) => ({
     return r;
   })
 });
+var isElicitationDeclinedError = (value) => value !== null && typeof value === "object" && "_tag" in value && value._tag === "ElicitationDeclinedError" && "toolId" in value && typeof value.toolId === "string" && "action" in value && (value.action === "cancel" || value.action === "decline");
+var paginate = (all, offset, limit) => {
+  const total = all.length;
+  const start = Math.min(Math.max(offset, 0), total);
+  const items = all.slice(start, start + limit);
+  const consumed = start + items.length;
+  const hasMore = consumed < total;
+  return {
+    items,
+    total,
+    hasMore,
+    nextOffset: hasMore ? consumed : null
+  };
+};
 var SEARCH_FIELD_WEIGHTS = {
   path: 12,
   sourceId: 8,
@@ -148,27 +201,49 @@ var scoreToolMatch = (tool, query) => {
     score
   };
 };
-var searchTools = (executor, query, limit = 12, options) => Effect.gen(function* () {
+var searchTools = Effect.fn("executor.tools.search")(function* (executor, query, limit = 12, options) {
+  const offset = options?.offset ?? 0;
+  yield* Effect.annotateCurrentSpan({
+    "executor.search.query_length": query.length,
+    "executor.search.limit": limit,
+    "executor.search.offset": offset,
+    ...options?.namespace ? { "executor.search.namespace": options.namespace } : {}
+  });
+  const empty = {
+    items: [],
+    total: 0,
+    hasMore: false,
+    nextOffset: null
+  };
   if (normalizeSearchText(query).length === 0) {
-    return [];
+    return empty;
   }
-  const all = yield* executor.tools.list().pipe(Effect.orDie);
-  return all.filter((tool) => matchesNamespace(tool, options?.namespace)).map((tool) => scoreToolMatch(tool, query)).filter((tool) => tool !== null).sort((left, right) => right.score - left.score || left.path.localeCompare(right.path)).slice(0, limit);
+  const all = yield* executor.tools.list({ includeAnnotations: false }).pipe(Effect.orDie);
+  const ranked = all.filter((tool) => matchesNamespace(tool, options?.namespace)).map((tool) => scoreToolMatch(tool, query)).filter((tool) => tool !== null).sort((left, right) => right.score - left.score || left.path.localeCompare(right.path));
+  const page = paginate(ranked, offset, limit);
+  yield* Effect.annotateCurrentSpan({
+    "executor.search.candidate_count": all.length,
+    "executor.search.match_count": ranked.length,
+    "executor.search.result_count": page.items.length,
+    "executor.search.has_more": page.hasMore
+  });
+  return page;
 });
-var listExecutorSources = (executor, options) => Effect.gen(function* () {
+var listExecutorSources = Effect.fn("executor.sources.list")(function* (executor, options) {
   const normalizedQuery = normalizeSearchText(options?.query ?? "");
-  const limit = options?.limit ?? 200;
+  const limit = options?.limit ?? 50;
+  const offset = options?.offset ?? 0;
   const sources = yield* executor.sources.list().pipe(Effect.orDie);
   const filtered = normalizedQuery.length === 0 ? sources : sources.filter((source) => {
     const haystack = normalizeSearchText([source.id, source.name, source.kind].join(" "));
     return tokenizeSearchText(normalizedQuery).every((token) => haystack.includes(token));
   });
-  const allTools = yield* executor.tools.list().pipe(Effect.orDie);
+  const allTools = yield* executor.tools.list({ includeAnnotations: false }).pipe(Effect.orDie);
   const toolCountBySource = /* @__PURE__ */ new Map();
   for (const tool of allTools) {
     toolCountBySource.set(tool.sourceId, (toolCountBySource.get(tool.sourceId) ?? 0) + 1);
   }
-  const withCounts = filtered.map(
+  const sortedWithCounts = filtered.map(
     (source) => ({
       id: source.id,
       name: source.name,
@@ -178,10 +253,18 @@ var listExecutorSources = (executor, options) => Effect.gen(function* () {
       canRefresh: source.canRefresh,
       toolCount: toolCountBySource.get(source.id) ?? 0
     })
-  );
-  return withCounts.sort((left, right) => left.name.localeCompare(right.name) || left.id.localeCompare(right.id)).slice(0, limit);
+  ).sort((left, right) => left.name.localeCompare(right.name) || left.id.localeCompare(right.id));
+  const page = paginate(sortedWithCounts, offset, limit);
+  yield* Effect.annotateCurrentSpan({
+    "executor.sources.candidate_count": sources.length,
+    "executor.sources.match_count": sortedWithCounts.length,
+    "executor.sources.result_count": page.items.length,
+    "executor.sources.has_more": page.hasMore
+  });
+  return page;
 });
-var describeTool = (executor, path) => Effect.gen(function* () {
+var describeTool = Effect.fn("executor.tools.describe")(function* (executor, path) {
+  yield* Effect.annotateCurrentSpan({ "mcp.tool.name": path });
   const schema = yield* executor.tools.schema(path);
   if (schema === null) {
     return { path, name: path };
@@ -199,19 +282,25 @@ var describeTool = (executor, path) => Effect.gen(function* () {
 // src/description.ts
 import { Effect as Effect2 } from "effect";
 var buildExecuteDescription = (executor) => Effect2.gen(function* () {
-  const sources = yield* executor.sources.list().pipe(Effect2.orDie);
-  const tools = yield* executor.tools.list().pipe(Effect2.orDie);
-  const namespaces = /* @__PURE__ */ new Set();
-  for (const tool of tools) namespaces.add(tool.sourceId);
-  return formatDescription([...namespaces], sources);
-});
-var formatDescription = (namespaces, sources) => {
+  const sources = yield* executor.sources.list().pipe(Effect2.orDie, Effect2.withSpan("executor.sources.list"));
+  const description = yield* Effect2.sync(() => formatDescription(sources)).pipe(
+    Effect2.withSpan("schema.compile.description", {
+      attributes: { "executor.source_count": sources.length }
+    })
+  );
+  yield* Effect2.annotateCurrentSpan({
+    "executor.source_count": sources.length,
+    "schema.kind": "execute"
+  });
+  return description;
+}).pipe(Effect2.withSpan("schema.describe.execute"));
+var formatDescription = (sources) => {
   const lines = [
     "Execute TypeScript in a sandboxed runtime with access to configured API tools.",
     "",
     "## Workflow",
     "",
-    '1. `const matches = await tools.search({ query: "<intent + key nouns>", limit: 12 });`',
+    '1. `const { items: matches } = await tools.search({ query: "<intent + key nouns>", limit: 12 });`',
     '2. `const path = matches[0]?.path; if (!path) return "No matching tools found.";`',
     "3. `const details = await tools.describe.tool({ path });`",
     "4. Use `details.inputTypeScript` / `details.outputTypeScript` and `details.typeScriptDefinitions` for compact shapes.",
@@ -220,9 +309,10 @@ var formatDescription = (namespaces, sources) => {
     "",
     "## Rules",
     "",
-    "- `tools.search()` returns ranked matches, best-first. Use short intent phrases like `github issues`, `repo details`, or `create calendar event`.",
+    "- `tools.search()` returns paginated, ranked matches: `{ items, total, hasMore, nextOffset }`. Best-first. Use short intent phrases like `github issues`, `repo details`, or `create calendar event`.",
     '- When you already know the namespace, narrow with `tools.search({ namespace: "github", query: "issues" })`.',
-    "- Use `tools.executor.sources.list()` to inspect configured sources and their tool counts. Returns `[{ id, toolCount, ... }]`.",
+    "- `tools.executor.sources.list()` returns the same paged shape: `{ items: [{ id, toolCount, ... }], total, hasMore, nextOffset }`.",
+    "- If `hasMore` is true and you didn't find what you need, fetch the next page: `tools.search({ query, offset: nextOffset, limit })`. Same `offset` parameter on `tools.executor.sources.list({ offset, limit })`.",
     "- Always use the namespace prefix when calling tools: `tools.<namespace>.<tool>(args)`. Example: `tools.home_assistant_rest_api.states.getState(...)` \u2014 not `tools.states.getState(...)`.",
     "- The `tools` object is a lazy proxy \u2014 `Object.keys(tools)` won't work. Use `tools.search()` or `tools.executor.sources.list()` instead.",
     '- Pass an object to system tools, e.g. `tools.search({ query: "..." })`, `tools.executor.sources.list()`, and `tools.describe.tool({ path })`.',
@@ -231,15 +321,14 @@ var formatDescription = (namespaces, sources) => {
     "- Do not use `fetch` \u2014 all API calls go through `tools.*`.",
     "- If execution pauses for interaction, resume it with the returned `resumePayload`."
   ];
-  if (namespaces.length > 0) {
+  if (sources.length > 0) {
     lines.push("");
     lines.push("## Available namespaces");
     lines.push("");
-    const sorted = [...namespaces].sort();
-    for (const ns of sorted) {
-      const source = sources.find((s) => s.id === ns);
-      const label = source?.name ?? ns;
-      lines.push(`- \`${ns}\`${label !== ns ? ` \u2014 ${label}` : ""}`);
+    const sorted = [...sources].sort((a, b) => a.id.localeCompare(b.id));
+    for (const source of sorted) {
+      const label = source.name;
+      lines.push(`- \`${source.id}\`${label !== source.id ? ` \u2014 ${label}` : ""}`);
     }
   }
   return lines.join("\n");
@@ -320,6 +409,17 @@ var readOptionalLimit = (value, toolName) => {
   }
   return Math.floor(value);
 };
+var readOptionalOffset = (value, toolName) => {
+  if (value === void 0) {
+    return 0;
+  }
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    return new ExecutionToolError({
+      message: `${toolName} offset must be a non-negative number when provided`
+    });
+  }
+  return Math.floor(value);
+};
 var makeFullInvoker = (executor, invokeOptions) => {
   const base = makeExecutorToolInvoker(executor, { invokeOptions });
   return {
@@ -328,7 +428,7 @@ var makeFullInvoker = (executor, invokeOptions) => {
         if (!isRecord(args)) {
           return Effect3.fail(
             new ExecutionToolError({
-              message: "tools.search expects an object: { query?: string; namespace?: string; limit?: number }"
+              message: "tools.search expects an object: { query?: string; namespace?: string; limit?: number; offset?: number }"
             })
           );
         }
@@ -350,15 +450,24 @@ var makeFullInvoker = (executor, invokeOptions) => {
         if (limit instanceof ExecutionToolError) {
           return Effect3.fail(limit);
         }
+        const offset = readOptionalOffset(args.offset, "tools.search");
+        if (offset instanceof ExecutionToolError) {
+          return Effect3.fail(offset);
+        }
         return searchTools(executor, args.query ?? "", limit, {
-          namespace: args.namespace
-        });
+          namespace: args.namespace,
+          offset
+        }).pipe(
+          Effect3.withSpan("mcp.tool.dispatch", {
+            attributes: { "mcp.tool.name": path, "executor.tool.builtin": true }
+          })
+        );
       }
       if (path === "executor.sources.list") {
         if (args !== void 0 && !isRecord(args)) {
           return Effect3.fail(
             new ExecutionToolError({
-              message: "tools.executor.sources.list expects an object: { query?: string; limit?: number }"
+              message: "tools.executor.sources.list expects an object: { query?: string; limit?: number; offset?: number }"
             })
           );
         }
@@ -376,10 +485,22 @@ var makeFullInvoker = (executor, invokeOptions) => {
         if (limit instanceof ExecutionToolError) {
           return Effect3.fail(limit);
         }
+        const offset = readOptionalOffset(
+          isRecord(args) ? args.offset : void 0,
+          "tools.executor.sources.list"
+        );
+        if (offset instanceof ExecutionToolError) {
+          return Effect3.fail(offset);
+        }
         return listExecutorSources(executor, {
           query: isRecord(args) && typeof args.query === "string" ? args.query : void 0,
-          limit
-        });
+          limit,
+          offset
+        }).pipe(
+          Effect3.withSpan("mcp.tool.dispatch", {
+            attributes: { "mcp.tool.name": path, "executor.tool.builtin": true }
+          })
+        );
       }
       if (path === "describe.tool") {
         if (!isRecord(args)) {
@@ -399,27 +520,37 @@ var makeFullInvoker = (executor, invokeOptions) => {
             })
           );
         }
-        return describeTool(executor, args.path);
+        return describeTool(executor, args.path).pipe(
+          Effect3.withSpan("mcp.tool.dispatch", {
+            attributes: {
+              "mcp.tool.name": path,
+              "executor.tool.builtin": true,
+              "executor.tool.target_path": args.path
+            }
+          })
+        );
       }
       return base.invoke({ path, args });
     }
   };
 };
-var runEffect = (effect) => Effect3.runPromise(effect);
 var createExecutionEngine = (config) => {
   const { executor, codeExecutor } = config;
   const pausedExecutions = /* @__PURE__ */ new Map();
   let nextId = 0;
   const awaitCompletionOrPause = (fiber, pauseSignal) => Effect3.race(
     Fiber.join(fiber).pipe(
-      Effect3.orDie,
       Effect3.map((result) => ({ status: "completed", result }))
     ),
     Deferred.await(pauseSignal).pipe(
       Effect3.map((paused) => ({ status: "paused", execution: paused }))
     )
   );
-  const startPausableExecution = (code) => Effect3.gen(function* () {
+  const startPausableExecution = Effect3.fn("mcp.execute")(function* (code) {
+    yield* Effect3.annotateCurrentSpan({
+      "mcp.execute.mode": "pausable",
+      "mcp.execute.code_length": code.length
+    });
     const pauseSignalRef = yield* Ref.make(yield* Deferred.make());
     let fiber;
     const elicitationHandler = (ctx) => Effect3.gen(function* () {
@@ -438,11 +569,16 @@ var createExecutionEngine = (config) => {
       return yield* Deferred.await(responseDeferred);
     });
     const invoker = makeFullInvoker(executor, { onElicitation: elicitationHandler });
-    fiber = yield* Effect3.forkDaemon(codeExecutor.execute(code, invoker));
+    fiber = yield* Effect3.forkDetach(
+      codeExecutor.execute(code, invoker).pipe(Effect3.withSpan("executor.code.exec"))
+    );
     const initialSignal = yield* Ref.get(pauseSignalRef);
     return yield* awaitCompletionOrPause(fiber, initialSignal);
   });
-  const resumeExecution = (executionId, response) => Effect3.gen(function* () {
+  const resumeExecution = Effect3.fn("mcp.execute.resume")(function* (executionId, response) {
+    yield* Effect3.annotateCurrentSpan({
+      "mcp.execute.resume.action": response.action
+    });
     const paused = pausedExecutions.get(executionId);
     if (!paused) return null;
     pausedExecutions.delete(executionId);
@@ -454,16 +590,21 @@ var createExecutionEngine = (config) => {
     });
     return yield* awaitCompletionOrPause(paused.fiber, nextSignal);
   });
+  const runInlineExecution = Effect3.fn("mcp.execute")(function* (code, options) {
+    yield* Effect3.annotateCurrentSpan({
+      "mcp.execute.mode": "inline",
+      "mcp.execute.code_length": code.length
+    });
+    const invoker = makeFullInvoker(executor, {
+      onElicitation: options.onElicitation
+    });
+    return yield* codeExecutor.execute(code, invoker).pipe(Effect3.withSpan("executor.code.exec"));
+  });
   return {
-    execute: async (code, options) => {
-      const invoker = makeFullInvoker(executor, {
-        onElicitation: options.onElicitation
-      });
-      return runEffect(codeExecutor.execute(code, invoker));
-    },
-    executeWithPause: (code) => runEffect(startPausableExecution(code)),
-    resume: (executionId, response) => runEffect(resumeExecution(executionId, response)),
-    getDescription: () => runEffect(buildExecuteDescription(executor))
+    execute: runInlineExecution,
+    executeWithPause: startPausableExecution,
+    resume: resumeExecution,
+    getDescription: buildExecuteDescription(executor)
   };
 };
 
@@ -478,4 +619,4 @@ export {
   formatPausedExecution,
   createExecutionEngine
 };
-//# sourceMappingURL=chunk-BF7CHG2T.js.map
+//# sourceMappingURL=chunk-QO23HCJR.js.map

package/dist/chunk-QO23HCJR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/tool-invoker.ts","../src/description.ts","../src/engine.ts"],"sourcesContent":["import * as Data from \"effect/Data\";\n\nexport class ExecutionToolError extends Data.TaggedError(\"ExecutionToolError\")<{\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n\n// `CodeExecutionError` lives in `@executor-js/codemode-core` — the `CodeExecutor`\n// interface uses it as the default error channel, so the runtime packages\n// can import the same class directly.\nexport { CodeExecutionError } from \"@executor-js/codemode-core\";\n","import { Effect } from \"effect\";\nimport * as Cause from \"effect/Cause\";\nimport type {\n  Executor,\n  ToolId,\n  Tool,\n  ToolSchema,\n  InvokeOptions,\n  Source,\n} from \"@executor-js/sdk/core\";\nimport type { SandboxToolInvoker } from \"@executor-js/codemode-core\";\nimport { ExecutionToolError } from \"./errors\";\n\n/**\n * Extract the source namespace from a tool path. Tool paths look like\n * \"<sourceId>.<op>\" or \"<sourceId>.<group>.<op>\" — we take the first\n * segment as a cheap, non-lookup stand-in for the source id so the span\n * attribute is always populated without hitting `executor.sources.list()`\n * per call.\n */\nconst extractSourceNamespace = (path: string): string => {\n  const idx = path.indexOf(\".\");\n  return idx === -1 ? path : path.slice(0, idx);\n};\n\nconst stringifyUnknown = (value: unknown): string => {\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return String(value);\n  }\n};\n\nconst hasStringMessage = (value: unknown): value is { readonly message: string } =>\n  value !== null &&\n  typeof value === \"object\" &&\n  \"message\" in value &&\n  typeof value.message === \"string\";\n\nconst messageFromErrorLike = (value: unknown): string | undefined => {\n  if (value instanceof Error || hasStringMessage(value)) {\n    return value.message;\n  }\n  return undefined;\n};\n\nconst renderToolErrorMessage = (error: unknown): string =>\n  messageFromErrorLike(error) ??\n  (typeof error === \"undefined\" ? \"Tool execution failed\" : stringifyUnknown(error));\n\n/**\n * Bridges QuickJS `tools.someSource.someOp(args)` calls into\n * `executor.tools.invoke(toolId, args)`.\n *\n * Wrapped in `Effect.fn(\"mcp.tool.dispatch\")` so every tool call becomes a\n * span in the Effect tracer. Attributes:\n *   - `mcp.tool.name`      — full tool path (e.g. \"github.repos.get\")\n *   - `mcp.tool.source_id` — first segment of the path (namespace)\n *\n * `mcp.tool.kind` (openapi | mcp | graphql | code) is NOT annotated here\n * because it would require a `sources.list()` lookup on every invocation.\n * Callers that already know the source kind can annotate at their own span.\n */\nexport const makeExecutorToolInvoker = (\n  executor: Executor,\n  options: { readonly invokeOptions: InvokeOptions },\n): SandboxToolInvoker => ({\n  invoke: Effect.fn(\"mcp.tool.dispatch\")(function* ({ path, args }) {\n    yield* Effect.annotateCurrentSpan({\n      \"mcp.tool.name\": path,\n      \"mcp.tool.source_id\": extractSourceNamespace(path),\n    });\n\n    const result = yield* executor.tools.invoke(path as ToolId, args, options.invokeOptions).pipe(\n      Effect.catchCause((cause): Effect.Effect<never, ExecutionToolError> => {\n        const err = cause.reasons.find(Cause.isFailReason)?.error;\n        if (!isElicitationDeclinedError(err)) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: renderToolErrorMessage(err),\n              cause: err ?? cause,\n            }),\n          );\n        }\n        return Effect.fail(\n          new ExecutionToolError({\n            message: `Tool \"${err.toolId}\" requires approval but the request was ${err.action === \"cancel\" ? \"cancelled\" : \"declined\"} by the user.`,\n            cause: err,\n          }),\n        );\n      }),\n    );\n    const r = result as { readonly error?: unknown; readonly data?: unknown } | unknown;\n    if (\n      r !== null &&\n      typeof r === \"object\" &&\n      \"error\" in r &&\n      (r as { error?: unknown }).error !== null &&\n      (r as { error?: unknown }).error !== undefined\n    ) {\n      const error = (r as { error: unknown }).error;\n      return yield* Effect.fail(\n        new ExecutionToolError({\n          message: renderToolErrorMessage(error),\n          cause: error,\n        }),\n      );\n    }\n    if (r !== null && typeof r === \"object\" && \"data\" in r) {\n      return (r as { data: unknown }).data;\n    }\n    return r;\n  }),\n});\n\nconst isElicitationDeclinedError = (\n  value: unknown,\n): value is { readonly _tag: \"ElicitationDeclinedError\"; readonly toolId: string; readonly action: \"cancel\" | \"decline\" } =>\n  value !== null &&\n  typeof value === \"object\" &&\n  \"_tag\" in value &&\n  value._tag === \"ElicitationDeclinedError\" &&\n  \"toolId\" in value &&\n  typeof value.toolId === \"string\" &&\n  \"action\" in value &&\n  (value.action === \"cancel\" || value.action === \"decline\");\n\nexport type ToolDiscoveryResult = {\n  readonly path: string;\n  readonly name: string;\n  readonly description?: string;\n  readonly sourceId: string;\n  readonly score: number;\n};\n\nexport type ExecutorSourceListItem = {\n  readonly id: string;\n  readonly name: string;\n  readonly kind: string;\n  readonly runtime?: boolean;\n  readonly canRemove?: boolean;\n  readonly canRefresh?: boolean;\n  readonly toolCount: number;\n};\n\n/**\n * Page of results from a list-style discovery tool. Shared by\n * `tools.search` and `tools.executor.sources.list` so the model sees one\n * consistent shape:\n *\n *   - `items`      — the page (slice).\n *   - `total`      — count after filtering, before pagination. The model\n *                    can use this to detect truncation.\n *   - `hasMore`    — convenience flag for `(offset + items.length) < total`.\n *   - `nextOffset` — concrete offset for the next page when `hasMore`,\n *                    `null` otherwise. Pre-computing it removes a class of\n *                    off-by-one mistakes when the model paginates.\n */\nexport type PagedResult<T> = {\n  readonly items: readonly T[];\n  readonly total: number;\n  readonly hasMore: boolean;\n  readonly nextOffset: number | null;\n};\n\nconst paginate = <T>(all: readonly T[], offset: number, limit: number): PagedResult<T> => {\n  const total = all.length;\n  const start = Math.min(Math.max(offset, 0), total);\n  const items = all.slice(start, start + limit);\n  const consumed = start + items.length;\n  const hasMore = consumed < total;\n  return {\n    items,\n    total,\n    hasMore,\n    nextOffset: hasMore ? consumed : null,\n  };\n};\n\ntype SearchableTool = Pick<Tool, \"id\" | \"sourceId\" | \"name\" | \"description\">;\n\ntype PreparedField = {\n  readonly raw: string;\n  readonly tokens: readonly string[];\n};\n\nconst SEARCH_FIELD_WEIGHTS = {\n  path: 12,\n  sourceId: 8,\n  name: 10,\n  description: 5,\n} as const;\n\nconst normalizeSearchText = (value: string): string =>\n  value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .replace(/[_./:-]+/g, \" \")\n    .toLowerCase()\n    .trim();\n\nconst tokenizeSearchText = (value: string): string[] =>\n  normalizeSearchText(value)\n    .split(/[^a-z0-9]+/)\n    .map((token) => token.trim())\n    .filter(Boolean);\n\nconst prepareField = (value?: string): PreparedField => ({\n  raw: normalizeSearchText(value ?? \"\"),\n  tokens: tokenizeSearchText(value ?? \"\"),\n});\n\nconst scorePreparedField = (\n  query: string,\n  queryTokens: readonly string[],\n  field: PreparedField,\n  weight: number,\n): {\n  readonly score: number;\n  readonly matchedTokens: ReadonlySet<string>;\n  readonly exactPhraseMatch: boolean;\n} => {\n  if (field.raw.length === 0) {\n    return {\n      score: 0,\n      matchedTokens: new Set<string>(),\n      exactPhraseMatch: false,\n    };\n  }\n\n  let score = 0;\n  const matchedTokens = new Set<string>();\n  const exactPhraseMatch = query.length > 0 && field.raw.includes(query);\n\n  if (query.length > 0) {\n    if (field.raw === query) {\n      score += weight * 14;\n    } else if (field.raw.startsWith(query)) {\n      score += weight * 9;\n    } else if (exactPhraseMatch) {\n      score += weight * 6;\n    }\n  }\n\n  for (const token of queryTokens) {\n    if (field.tokens.includes(token)) {\n      score += weight * 4;\n      matchedTokens.add(token);\n      continue;\n    }\n\n    if (\n      field.tokens.some((candidate) => candidate.startsWith(token) || token.startsWith(candidate))\n    ) {\n      score += weight * 2;\n      matchedTokens.add(token);\n      continue;\n    }\n\n    if (field.raw.includes(token)) {\n      score += weight;\n      matchedTokens.add(token);\n    }\n  }\n\n  return {\n    score,\n    matchedTokens,\n    exactPhraseMatch,\n  };\n};\n\nconst matchesNamespace = (tool: SearchableTool, namespace?: string): boolean => {\n  if (!namespace || normalizeSearchText(namespace).length === 0) {\n    return true;\n  }\n\n  const namespaceTokens = tokenizeSearchText(namespace);\n  if (namespaceTokens.length === 0) {\n    return true;\n  }\n\n  const sourceTokens = tokenizeSearchText(tool.sourceId);\n  const pathTokens = tokenizeSearchText(tool.id);\n\n  const isPrefixMatch = (tokens: readonly string[]): boolean =>\n    namespaceTokens.every((token, index) => tokens[index] === token);\n\n  return isPrefixMatch(sourceTokens) || isPrefixMatch(pathTokens);\n};\n\nconst scoreToolMatch = (tool: SearchableTool, query: string): ToolDiscoveryResult | null => {\n  const normalizedQuery = normalizeSearchText(query);\n  const queryTokens = tokenizeSearchText(query);\n\n  if (normalizedQuery.length === 0 || queryTokens.length === 0) {\n    return null;\n  }\n\n  const path = prepareField(tool.id);\n  const sourceId = prepareField(tool.sourceId);\n  const name = prepareField(tool.name);\n  const description = prepareField(tool.description);\n\n  const fieldScores = [\n    scorePreparedField(normalizedQuery, queryTokens, path, SEARCH_FIELD_WEIGHTS.path),\n    scorePreparedField(normalizedQuery, queryTokens, sourceId, SEARCH_FIELD_WEIGHTS.sourceId),\n    scorePreparedField(normalizedQuery, queryTokens, name, SEARCH_FIELD_WEIGHTS.name),\n    scorePreparedField(normalizedQuery, queryTokens, description, SEARCH_FIELD_WEIGHTS.description),\n  ];\n\n  const matchedTokens = new Set<string>();\n  let score = 0;\n  let exactPhraseMatch = false;\n\n  for (const fieldScore of fieldScores) {\n    score += fieldScore.score;\n    exactPhraseMatch ||= fieldScore.exactPhraseMatch;\n    for (const token of fieldScore.matchedTokens) {\n      matchedTokens.add(token);\n    }\n  }\n\n  if (matchedTokens.size === 0) {\n    return null;\n  }\n\n  const coverage = matchedTokens.size / queryTokens.length;\n  const minimumCoverage = queryTokens.length <= 2 ? 1 : 0.6;\n\n  if (coverage < minimumCoverage && !exactPhraseMatch) {\n    return null;\n  }\n\n  if (coverage === 1) {\n    score += 25;\n  } else {\n    score += Math.round(coverage * 10);\n  }\n\n  if (path.tokens[0] === queryTokens[0] || name.tokens[0] === queryTokens[0]) {\n    score += 8;\n  }\n\n  if (\n    normalizeSearchText(tool.id) === normalizedQuery ||\n    normalizeSearchText(tool.name) === normalizedQuery\n  ) {\n    score += 20;\n  }\n\n  return {\n    path: tool.id,\n    name: tool.name,\n    description: tool.description,\n    sourceId: tool.sourceId,\n    score,\n  };\n};\n\n/** What `tools.search()` calls inside the sandbox. */\nexport const searchTools = Effect.fn(\"executor.tools.search\")(function* (\n  executor: Executor,\n  query: string,\n  limit = 12,\n  options?: { readonly namespace?: string; readonly offset?: number },\n) {\n  const offset = options?.offset ?? 0;\n  yield* Effect.annotateCurrentSpan({\n    \"executor.search.query_length\": query.length,\n    \"executor.search.limit\": limit,\n    \"executor.search.offset\": offset,\n    ...(options?.namespace ? { \"executor.search.namespace\": options.namespace } : {}),\n  });\n\n  const empty: PagedResult<ToolDiscoveryResult> = {\n    items: [],\n    total: 0,\n    hasMore: false,\n    nextOffset: null,\n  };\n\n  if (normalizeSearchText(query).length === 0) {\n    return empty;\n  }\n\n  const all = yield* executor.tools.list({ includeAnnotations: false }).pipe(Effect.orDie);\n  const ranked = all\n    .filter((tool: Tool) => matchesNamespace(tool, options?.namespace))\n    .map((tool: Tool) => scoreToolMatch(tool, query))\n    .filter((tool): tool is ToolDiscoveryResult => tool !== null)\n    .sort((left, right) => right.score - left.score || left.path.localeCompare(right.path));\n\n  const page = paginate(ranked, offset, limit);\n\n  yield* Effect.annotateCurrentSpan({\n    \"executor.search.candidate_count\": all.length,\n    \"executor.search.match_count\": ranked.length,\n    \"executor.search.result_count\": page.items.length,\n    \"executor.search.has_more\": page.hasMore,\n  });\n  return page;\n});\n\n/** What `tools.executor.sources.list()` calls inside the sandbox. */\nexport const listExecutorSources = Effect.fn(\"executor.sources.list\")(function* (\n  executor: Executor,\n  options?: {\n    readonly query?: string;\n    readonly limit?: number;\n    readonly offset?: number;\n  },\n) {\n  const normalizedQuery = normalizeSearchText(options?.query ?? \"\");\n  const limit = options?.limit ?? 50;\n  const offset = options?.offset ?? 0;\n  const sources = yield* executor.sources.list().pipe(Effect.orDie);\n\n  const filtered =\n    normalizedQuery.length === 0\n      ? sources\n      : sources.filter((source: Source) => {\n          const haystack = normalizeSearchText([source.id, source.name, source.kind].join(\" \"));\n          return tokenizeSearchText(normalizedQuery).every((token) => haystack.includes(token));\n        });\n\n  // Single query for all tools, then count per source in memory.\n  const allTools = yield* executor.tools.list({ includeAnnotations: false }).pipe(Effect.orDie);\n  const toolCountBySource = new Map<string, number>();\n  for (const tool of allTools) {\n    toolCountBySource.set(tool.sourceId, (toolCountBySource.get(tool.sourceId) ?? 0) + 1);\n  }\n\n  const sortedWithCounts = filtered\n    .map(\n      (source: Source) =>\n        ({\n          id: source.id,\n          name: source.name,\n          kind: source.kind,\n          runtime: source.runtime,\n          canRemove: source.canRemove,\n          canRefresh: source.canRefresh,\n          toolCount: toolCountBySource.get(source.id) ?? 0,\n        }) satisfies ExecutorSourceListItem,\n    )\n    .sort((left, right) => left.name.localeCompare(right.name) || left.id.localeCompare(right.id));\n\n  const page = paginate(sortedWithCounts, offset, limit);\n\n  yield* Effect.annotateCurrentSpan({\n    \"executor.sources.candidate_count\": sources.length,\n    \"executor.sources.match_count\": sortedWithCounts.length,\n    \"executor.sources.result_count\": page.items.length,\n    \"executor.sources.has_more\": page.hasMore,\n  });\n  return page;\n});\n\n/** What `tools.describe.tool()` calls inside the sandbox. */\nexport const describeTool = Effect.fn(\"executor.tools.describe\")(function* (\n  executor: Executor,\n  path: string,\n) {\n  yield* Effect.annotateCurrentSpan({ \"mcp.tool.name\": path });\n\n  // Single tools.schema() call — it already fetches the tool row\n  // internally. No need to also call tools.list() just for name/description.\n  const schema: ToolSchema | null = yield* executor.tools.schema(path);\n\n  // tools.schema() returns null if the tool doesn't exist. Fall back to\n  // a minimal stub so callers can still render something.\n  if (schema === null) {\n    return { path, name: path };\n  }\n\n  // The schema's id is the tool path; name/description come from the\n  // tool row which tools.schema() already loaded.\n  return {\n    path,\n    name: schema.name ?? path,\n    description: schema.description,\n    inputTypeScript: schema.inputTypeScript,\n    outputTypeScript: schema.outputTypeScript,\n    typeScriptDefinitions: schema.typeScriptDefinitions,\n  };\n});\n","import { Effect } from \"effect\";\nimport type { Executor, Source } from \"@executor-js/sdk/core\";\n\n/**\n * Builds a tool description dynamically.\n *\n * Structure:\n *   1. Workflow (top — critical, least likely to be truncated)\n *   2. Available namespaces (bottom)\n */\nexport const buildExecuteDescription = (executor: Executor): Effect.Effect<string> =>\n  Effect.gen(function* () {\n    const sources: readonly Source[] = yield* executor.sources\n      .list()\n      .pipe(Effect.orDie, Effect.withSpan(\"executor.sources.list\"));\n\n    const description = yield* Effect.sync(() => formatDescription(sources)).pipe(\n      Effect.withSpan(\"schema.compile.description\", {\n        attributes: { \"executor.source_count\": sources.length },\n      }),\n    );\n\n    yield* Effect.annotateCurrentSpan({\n      \"executor.source_count\": sources.length,\n      \"schema.kind\": \"execute\",\n    });\n\n    return description;\n  }).pipe(Effect.withSpan(\"schema.describe.execute\"));\n\nconst formatDescription = (sources: readonly Source[]): string => {\n  const lines: string[] = [\n    \"Execute TypeScript in a sandboxed runtime with access to configured API tools.\",\n    \"\",\n    \"## Workflow\",\n    \"\",\n    '1. `const { items: matches } = await tools.search({ query: \"<intent + key nouns>\", limit: 12 });`',\n    '2. `const path = matches[0]?.path; if (!path) return \"No matching tools found.\";`',\n    \"3. `const details = await tools.describe.tool({ path });`\",\n    \"4. Use `details.inputTypeScript` / `details.outputTypeScript` and `details.typeScriptDefinitions` for compact shapes.\",\n    \"5. Use `tools.executor.sources.list()` when you need configured source inventory.\",\n    \"6. Call the tool: `const result = await tools.<path>(input);`\",\n    \"\",\n    \"## Rules\",\n    \"\",\n    \"- `tools.search()` returns paginated, ranked matches: `{ items, total, hasMore, nextOffset }`. Best-first. Use short intent phrases like `github issues`, `repo details`, or `create calendar event`.\",\n    '- When you already know the namespace, narrow with `tools.search({ namespace: \"github\", query: \"issues\" })`.',\n    \"- `tools.executor.sources.list()` returns the same paged shape: `{ items: [{ id, toolCount, ... }], total, hasMore, nextOffset }`.\",\n    \"- If `hasMore` is true and you didn't find what you need, fetch the next page: `tools.search({ query, offset: nextOffset, limit })`. Same `offset` parameter on `tools.executor.sources.list({ offset, limit })`.\",\n    \"- Always use the namespace prefix when calling tools: `tools.<namespace>.<tool>(args)`. Example: `tools.home_assistant_rest_api.states.getState(...)` — not `tools.states.getState(...)`.\",\n    \"- The `tools` object is a lazy proxy — `Object.keys(tools)` won't work. Use `tools.search()` or `tools.executor.sources.list()` instead.\",\n    '- Pass an object to system tools, e.g. `tools.search({ query: \"...\" })`, `tools.executor.sources.list()`, and `tools.describe.tool({ path })`.',\n    \"- `tools.describe.tool()` returns compact TypeScript shapes. Use `inputTypeScript`, `outputTypeScript`, and `typeScriptDefinitions`.\",\n    \"- For tools that return large collections (e.g. `getStates`, `getAll`), filter results in code rather than calling per-item tools.\",\n    \"- Do not use `fetch` — all API calls go through `tools.*`.\",\n    \"- If execution pauses for interaction, resume it with the returned `resumePayload`.\",\n  ];\n\n  if (sources.length > 0) {\n    lines.push(\"\");\n    lines.push(\"## Available namespaces\");\n    lines.push(\"\");\n    const sorted = [...sources].sort((a, b) => a.id.localeCompare(b.id));\n    for (const source of sorted) {\n      const label = source.name;\n      lines.push(`- \\`${source.id}\\`${label !== source.id ? ` — ${label}` : \"\"}`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n};\n","import { Deferred, Effect, Fiber, Ref } from \"effect\";\nimport type * as Cause from \"effect/Cause\";\n\nimport type {\n  Executor,\n  InvokeOptions,\n  ElicitationResponse,\n  ElicitationHandler,\n  ElicitationContext,\n} from \"@executor-js/sdk/core\";\nimport { CodeExecutionError } from \"@executor-js/codemode-core\";\nimport type { CodeExecutor, ExecuteResult, SandboxToolInvoker } from \"@executor-js/codemode-core\";\n\nimport {\n  makeExecutorToolInvoker,\n  searchTools,\n  listExecutorSources,\n  describeTool,\n} from \"./tool-invoker\";\nimport { ExecutionToolError } from \"./errors\";\nimport { buildExecuteDescription } from \"./description\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type ExecutionEngineConfig<\n  E extends Cause.YieldableError = CodeExecutionError,\n> = {\n  readonly executor: Executor;\n  readonly codeExecutor: CodeExecutor<E>;\n};\n\nexport type ExecutionResult =\n  | { readonly status: \"completed\"; readonly result: ExecuteResult }\n  | { readonly status: \"paused\"; readonly execution: PausedExecution };\n\nexport type PausedExecution = {\n  readonly id: string;\n  readonly elicitationContext: ElicitationContext;\n};\n\n/** Internal representation with Effect runtime state for pause/resume. */\ntype InternalPausedExecution<E> = PausedExecution & {\n  readonly response: Deferred.Deferred<typeof ElicitationResponse.Type>;\n  readonly fiber: Fiber.Fiber<ExecuteResult, E>;\n  readonly pauseSignalRef: Ref.Ref<Deferred.Deferred<InternalPausedExecution<E>>>;\n};\n\nexport type ResumeResponse = {\n  readonly action: \"accept\" | \"decline\" | \"cancel\";\n  readonly content?: Record<string, unknown>;\n};\n\n// ---------------------------------------------------------------------------\n// Result formatting\n// ---------------------------------------------------------------------------\n\nconst MAX_PREVIEW_CHARS = 30_000;\n\nconst truncate = (value: string, max: number): string =>\n  value.length > max\n    ? `${value.slice(0, max)}\\n... [truncated ${value.length - max} chars]`\n    : value;\n\nexport const formatExecuteResult = (\n  result: ExecuteResult,\n): {\n  text: string;\n  structured: Record<string, unknown>;\n  isError: boolean;\n} => {\n  const resultText =\n    result.result != null\n      ? typeof result.result === \"string\"\n        ? result.result\n        : JSON.stringify(result.result, null, 2)\n      : null;\n\n  const logText = result.logs && result.logs.length > 0 ? result.logs.join(\"\\n\") : null;\n\n  if (result.error) {\n    const parts = [`Error: ${result.error}`, ...(logText ? [`\\nLogs:\\n${logText}`] : [])];\n    return {\n      text: truncate(parts.join(\"\\n\"), MAX_PREVIEW_CHARS),\n      structured: { status: \"error\", error: result.error, logs: result.logs ?? [] },\n      isError: true,\n    };\n  }\n\n  const parts = [\n    ...(resultText ? [truncate(resultText, MAX_PREVIEW_CHARS)] : [\"(no result)\"]),\n    ...(logText ? [`\\nLogs:\\n${logText}`] : []),\n  ];\n  return {\n    text: parts.join(\"\\n\"),\n    structured: { status: \"completed\", result: result.result ?? null, logs: result.logs ?? [] },\n    isError: false,\n  };\n};\n\nexport const formatPausedExecution = (\n  paused: PausedExecution,\n): {\n  text: string;\n  structured: Record<string, unknown>;\n} => {\n  const req = paused.elicitationContext.request;\n  const lines: string[] = [`Execution paused: ${req.message}`];\n\n  if (req._tag === \"UrlElicitation\") {\n    lines.push(`\\nOpen this URL in a browser:\\n${req.url}`);\n    lines.push(\"\\nAfter the browser flow, resume with the executionId below:\");\n  } else {\n    lines.push(\"\\nResume with the executionId below and a response matching the requested schema:\");\n    const schema = req.requestedSchema;\n    if (schema && Object.keys(schema).length > 0) {\n      lines.push(`\\nRequested schema:\\n${JSON.stringify(schema, null, 2)}`);\n    }\n  }\n\n  lines.push(`\\nexecutionId: ${paused.id}`);\n\n  return {\n    text: lines.join(\"\\n\"),\n    structured: {\n      status: \"waiting_for_interaction\",\n      executionId: paused.id,\n      interaction: {\n        kind: req._tag === \"UrlElicitation\" ? \"url\" : \"form\",\n        message: req.message,\n        ...(req._tag === \"UrlElicitation\" ? { url: req.url } : {}),\n        ...(req._tag === \"FormElicitation\" ? { requestedSchema: req.requestedSchema } : {}),\n      },\n    },\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Full invoker (base + discover + describe)\n// ---------------------------------------------------------------------------\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst readOptionalLimit = (value: unknown, toolName: string): number | ExecutionToolError => {\n  if (value === undefined) {\n    return 12;\n  }\n\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    return new ExecutionToolError({\n      message: `${toolName} limit must be a positive number when provided`,\n    });\n  }\n\n  return Math.floor(value);\n};\n\nconst readOptionalOffset = (value: unknown, toolName: string): number | ExecutionToolError => {\n  if (value === undefined) {\n    return 0;\n  }\n\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n    return new ExecutionToolError({\n      message: `${toolName} offset must be a non-negative number when provided`,\n    });\n  }\n\n  return Math.floor(value);\n};\n\nconst makeFullInvoker = (executor: Executor, invokeOptions: InvokeOptions): SandboxToolInvoker => {\n  const base = makeExecutorToolInvoker(executor, { invokeOptions });\n  return {\n    invoke: ({ path, args }) => {\n      if (path === \"search\") {\n        if (!isRecord(args)) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message:\n                \"tools.search expects an object: { query?: string; namespace?: string; limit?: number; offset?: number }\",\n            }),\n          );\n        }\n\n        if (args.query !== undefined && typeof args.query !== \"string\") {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.search query must be a string when provided\",\n            }),\n          );\n        }\n\n        if (args.namespace !== undefined && typeof args.namespace !== \"string\") {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.search namespace must be a string when provided\",\n            }),\n          );\n        }\n\n        const limit = readOptionalLimit(args.limit, \"tools.search\");\n        if (limit instanceof ExecutionToolError) {\n          return Effect.fail(limit);\n        }\n\n        const offset = readOptionalOffset(args.offset, \"tools.search\");\n        if (offset instanceof ExecutionToolError) {\n          return Effect.fail(offset);\n        }\n\n        return searchTools(executor, args.query ?? \"\", limit, {\n          namespace: args.namespace,\n          offset,\n        }).pipe(\n          Effect.withSpan(\"mcp.tool.dispatch\", {\n            attributes: { \"mcp.tool.name\": path, \"executor.tool.builtin\": true },\n          }),\n        );\n      }\n      if (path === \"executor.sources.list\") {\n        if (args !== undefined && !isRecord(args)) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message:\n                \"tools.executor.sources.list expects an object: { query?: string; limit?: number; offset?: number }\",\n            }),\n          );\n        }\n\n        if (isRecord(args) && args.query !== undefined && typeof args.query !== \"string\") {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.executor.sources.list query must be a string when provided\",\n            }),\n          );\n        }\n\n        const limit = readOptionalLimit(\n          isRecord(args) ? args.limit : undefined,\n          \"tools.executor.sources.list\",\n        );\n        if (limit instanceof ExecutionToolError) {\n          return Effect.fail(limit);\n        }\n\n        const offset = readOptionalOffset(\n          isRecord(args) ? args.offset : undefined,\n          \"tools.executor.sources.list\",\n        );\n        if (offset instanceof ExecutionToolError) {\n          return Effect.fail(offset);\n        }\n\n        return listExecutorSources(executor, {\n          query: isRecord(args) && typeof args.query === \"string\" ? args.query : undefined,\n          limit,\n          offset,\n        }).pipe(\n          Effect.withSpan(\"mcp.tool.dispatch\", {\n            attributes: { \"mcp.tool.name\": path, \"executor.tool.builtin\": true },\n          }),\n        );\n      }\n      if (path === \"describe.tool\") {\n        if (!isRecord(args)) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.describe.tool expects an object: { path: string }\",\n            }),\n          );\n        }\n\n        if (typeof args.path !== \"string\" || args.path.trim().length === 0) {\n          return Effect.fail(new ExecutionToolError({ message: \"describe.tool requires a path\" }));\n        }\n\n        if (\"includeSchemas\" in args) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.describe.tool no longer accepts includeSchemas\",\n            }),\n          );\n        }\n\n        return describeTool(executor, args.path).pipe(\n          Effect.withSpan(\"mcp.tool.dispatch\", {\n            attributes: {\n              \"mcp.tool.name\": path,\n              \"executor.tool.builtin\": true,\n              \"executor.tool.target_path\": args.path,\n            },\n          }),\n        );\n      }\n      return base.invoke({ path, args });\n    },\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Execution Engine\n// ---------------------------------------------------------------------------\n\nexport type ExecutionEngine<E extends Cause.YieldableError = CodeExecutionError> = {\n  /**\n   * Execute code with elicitation handled inline by the provided handler.\n   * Use this when the host supports elicitation (e.g. MCP with elicitation capability).\n   *\n   * Fails with the code executor's typed error `E` (defaults to\n   * `CodeExecutionError`). Runtimes surface their own `Data.TaggedError`\n   * subclass, which flows through here unchanged.\n   */\n  readonly execute: (\n    code: string,\n    options: { readonly onElicitation: ElicitationHandler },\n  ) => Effect.Effect<ExecuteResult, E>;\n\n  /**\n   * Execute code, intercepting the first elicitation as a pause point.\n   * Use this when the host doesn't support inline elicitation.\n   * Returns either a completed result or a paused execution that can be resumed.\n   */\n  readonly executeWithPause: (code: string) => Effect.Effect<ExecutionResult, E>;\n\n  /**\n   * Resume a paused execution. Returns a completed result, a new pause, or\n   * null if the executionId was not found.\n   */\n  readonly resume: (\n    executionId: string,\n    response: ResumeResponse,\n  ) => Effect.Effect<ExecutionResult | null, E>;\n\n  /**\n   * Get the dynamic tool description (workflow + namespaces).\n   */\n  readonly getDescription: Effect.Effect<string>;\n};\n\nexport const createExecutionEngine = <\n  E extends Cause.YieldableError = CodeExecutionError,\n>(\n  config: ExecutionEngineConfig<E>,\n): ExecutionEngine<E> => {\n  const { executor, codeExecutor } = config;\n  const pausedExecutions = new Map<string, InternalPausedExecution<E>>();\n  let nextId = 0;\n\n  /**\n   * Race a running fiber against a pause signal. Returns when either\n   * the fiber completes or an elicitation handler fires (whichever\n   * comes first). Re-used by both executeWithPause and resume.\n   */\n  const awaitCompletionOrPause = (\n    fiber: Fiber.Fiber<ExecuteResult, E>,\n    pauseSignal: Deferred.Deferred<InternalPausedExecution<E>>,\n  ): Effect.Effect<ExecutionResult, E> =>\n    Effect.race(\n      Fiber.join(fiber).pipe(\n        Effect.map((result): ExecutionResult => ({ status: \"completed\", result })),\n      ),\n      Deferred.await(pauseSignal).pipe(\n        Effect.map((paused): ExecutionResult => ({ status: \"paused\", execution: paused })),\n      ),\n    );\n\n  /**\n   * Start an execution in pause/resume mode.\n   *\n   * The sandbox is forked as a daemon because paused executions can outlive the\n   * caller scope that returned the first pause, such as an HTTP request handler.\n   */\n  const startPausableExecution = Effect.fn(\"mcp.execute\")(function* (code: string) {\n    yield* Effect.annotateCurrentSpan({\n      \"mcp.execute.mode\": \"pausable\",\n      \"mcp.execute.code_length\": code.length,\n    });\n\n    // Ref holds the current pause signal. The elicitation handler reads\n    // it each time it fires, so resume() can swap in a fresh Deferred\n    // before unblocking the fiber.\n    const pauseSignalRef = yield* Ref.make(yield* Deferred.make<InternalPausedExecution<E>>());\n\n    // Will be set once the fiber is forked.\n    let fiber: Fiber.Fiber<ExecuteResult, E>;\n\n    const elicitationHandler: ElicitationHandler = (ctx) =>\n      Effect.gen(function* () {\n        const responseDeferred = yield* Deferred.make<typeof ElicitationResponse.Type>();\n        const id = `exec_${++nextId}`;\n\n        const paused: InternalPausedExecution<E> = {\n          id,\n          elicitationContext: ctx,\n          response: responseDeferred,\n          fiber: fiber!,\n          pauseSignalRef,\n        };\n        pausedExecutions.set(id, paused);\n\n        const currentSignal = yield* Ref.get(pauseSignalRef);\n        yield* Deferred.succeed(currentSignal, paused);\n\n        // Suspend until resume() completes responseDeferred.\n        return yield* Deferred.await(responseDeferred);\n      });\n\n    const invoker = makeFullInvoker(executor, { onElicitation: elicitationHandler });\n    fiber = yield* Effect.forkDetach(\n      codeExecutor.execute(code, invoker).pipe(Effect.withSpan(\"executor.code.exec\")),\n    );\n\n    const initialSignal = yield* Ref.get(pauseSignalRef);\n    return (yield* awaitCompletionOrPause(fiber, initialSignal)) as ExecutionResult;\n  });\n\n  /**\n   * Resume a paused execution. Swaps in a fresh pause signal, completes\n   * the response Deferred to unblock the fiber, then races completion\n   * against the next pause.\n   */\n  const resumeExecution = Effect.fn(\"mcp.execute.resume\")(function* (\n    executionId: string,\n    response: ResumeResponse,\n  ) {\n    yield* Effect.annotateCurrentSpan({\n      \"mcp.execute.resume.action\": response.action,\n    });\n\n    const paused = pausedExecutions.get(executionId);\n    if (!paused) return null;\n    pausedExecutions.delete(executionId);\n\n    // Swap in a fresh pause signal BEFORE unblocking the fiber, so the\n    // next elicitation handler call signals this new Deferred.\n    const nextSignal = yield* Deferred.make<InternalPausedExecution<E>>();\n    yield* Ref.set(paused.pauseSignalRef, nextSignal);\n\n    yield* Deferred.succeed(paused.response, {\n      action: response.action as typeof ElicitationResponse.Type.action,\n      content: response.content,\n    });\n\n    return (yield* awaitCompletionOrPause(paused.fiber, nextSignal)) as ExecutionResult;\n  });\n\n  /**\n   * Inline-elicitation execute path. Wrapped so every call produces an\n   * `mcp.execute` span with the inner `executor.code.exec` as a child.\n   */\n  const runInlineExecution = Effect.fn(\"mcp.execute\")(function* (\n    code: string,\n    options: { readonly onElicitation: ElicitationHandler },\n  ) {\n    yield* Effect.annotateCurrentSpan({\n      \"mcp.execute.mode\": \"inline\",\n      \"mcp.execute.code_length\": code.length,\n    });\n    const invoker = makeFullInvoker(executor, {\n      onElicitation: options.onElicitation,\n    });\n    return yield* codeExecutor\n      .execute(code, invoker)\n      .pipe(Effect.withSpan(\"executor.code.exec\"));\n  });\n\n  return {\n    execute: runInlineExecution,\n    executeWithPause: startPausableExecution,\n    resume: resumeExecution,\n    getDescription: buildExecuteDescription(executor),\n  };\n};\n"],"mappings":"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","names":["Effect","Effect","parts","Effect"]}

package/dist/core.js

@@ -8,7 +8,7 @@ import {
   listExecutorSources,
   makeExecutorToolInvoker,
   searchTools
-} from "./chunk-BF7CHG2T.js";
+} from "./chunk-QO23HCJR.js";
 export {
   ExecutionToolError,
   buildExecuteDescription,

package/dist/description.d.ts

@@ -1,5 +1,5 @@
 import { Effect } from "effect";
-import type { Executor } from "@executor-js/sdk";
+import type { Executor } from "@executor-js/sdk/core";
 /**
  * Builds a tool description dynamically.
  *

package/dist/description.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"description.d.ts","sourceRoot":"","sources":["../src/description.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,QAAQ,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAS7E,CAAC"}
+{"version":3,"file":"description.d.ts","sourceRoot":"","sources":["../src/description.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,uBAAuB,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,QAAQ,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAkB5B,CAAC"}

package/dist/description.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=description.test.d.ts.map

package/dist/description.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description.test.d.ts","sourceRoot":"","sources":["../src/description.test.ts"],"names":[],"mappings":""}

package/dist/engine.d.ts

@@ -1,8 +1,11 @@
-import type { Executor, ElicitationHandler, ElicitationContext } from "@executor-js/sdk";
+import { Effect } from "effect";
+import type * as Cause from "effect/Cause";
+import type { Executor, ElicitationHandler, ElicitationContext } from "@executor-js/sdk/core";
+import { CodeExecutionError } from "@executor-js/codemode-core";
 import type { CodeExecutor, ExecuteResult } from "@executor-js/codemode-core";
-export type ExecutionEngineConfig = {
+export type ExecutionEngineConfig<E extends Cause.YieldableError = CodeExecutionError> = {
     readonly executor: Executor;
-    readonly codeExecutor: CodeExecutor;
+    readonly codeExecutor: CodeExecutor<E>;
 };
 export type ExecutionResult = {
     readonly status: "completed";
@@ -28,29 +31,33 @@ export declare const formatPausedExecution: (paused: PausedExecution) => {
     text: string;
     structured: Record<string, unknown>;
 };
-export type ExecutionEngine = {
+export type ExecutionEngine<E extends Cause.YieldableError = CodeExecutionError> = {
     /**
      * Execute code with elicitation handled inline by the provided handler.
      * Use this when the host supports elicitation (e.g. MCP with elicitation capability).
+     *
+     * Fails with the code executor's typed error `E` (defaults to
+     * `CodeExecutionError`). Runtimes surface their own `Data.TaggedError`
+     * subclass, which flows through here unchanged.
      */
     readonly execute: (code: string, options: {
         readonly onElicitation: ElicitationHandler;
-    }) => Promise<ExecuteResult>;
+    }) => Effect.Effect<ExecuteResult, E>;
     /**
      * Execute code, intercepting the first elicitation as a pause point.
      * Use this when the host doesn't support inline elicitation.
      * Returns either a completed result or a paused execution that can be resumed.
      */
-    readonly executeWithPause: (code: string) => Promise<ExecutionResult>;
+    readonly executeWithPause: (code: string) => Effect.Effect<ExecutionResult, E>;
     /**
      * Resume a paused execution. Returns a completed result, a new pause, or
      * null if the executionId was not found.
      */
-    readonly resume: (executionId: string, response: ResumeResponse) => Promise<ExecutionResult | null>;
+    readonly resume: (executionId: string, response: ResumeResponse) => Effect.Effect<ExecutionResult | null, E>;
     /**
      * Get the dynamic tool description (workflow + namespaces).
      */
-    readonly getDescription: () => Promise<string>;
+    readonly getDescription: Effect.Effect<string>;
 };
-export declare const createExecutionEngine: (config: ExecutionEngineConfig) => ExecutionEngine;
+export declare const createExecutionEngine: <E extends Cause.YieldableError = CodeExecutionError>(config: ExecutionEngineConfig<E>) => ExecutionEngine<E>;
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EAGR,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAsB,MAAM,yBAAyB,CAAC;AAe/F,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CACjD,CAAC;AASF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AAaF,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,aAAa,KACpB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CA6BlB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,QAAQ,eAAe,KACtB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA+BrC,CAAC;AA6HF,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAA;KAAE,KACpD,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAEtE;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC;AAKF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,qBAAqB,KAAG,eA6GrE,CAAC"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAc,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,QAAQ,EAGR,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAsB,MAAM,4BAA4B,CAAC;AAelG,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,KAAK,CAAC,cAAc,GAAG,kBAAkB,IACjD;IACF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CACjD,CAAC;AASF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AAaF,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,aAAa,KACpB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CA6BlB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,QAAQ,eAAe,KACtB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA+BrC,CAAC;AA0KF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,KAAK,CAAC,cAAc,GAAG,kBAAkB,IAAI;IACjF;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAA;KAAE,KACpD,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAE/E;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,KACrB,MAAM,CAAC,MAAM,CAAC,eAAe,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,CAAC,SAAS,KAAK,CAAC,cAAc,GAAG,kBAAkB,EAEnD,QAAQ,qBAAqB,CAAC,CAAC,CAAC,KAC/B,eAAe,CAAC,CAAC,CAiInB,CAAC"}

package/dist/errors.d.ts

@@ -6,5 +6,5 @@ export declare class ExecutionToolError extends ExecutionToolError_base<{
     readonly cause?: unknown;
 }> {
 }
-export {};
+export { CodeExecutionError } from "@executor-js/codemode-core";
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG;AAKL,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -4,58 +4,93 @@ import {
   createExecutionEngine,
   formatExecuteResult,
   formatPausedExecution
-} from "./chunk-BF7CHG2T.js";
+} from "./chunk-QO23HCJR.js";
 
 // src/promise.ts
 import { Effect } from "effect";
+import { ToolId } from "@executor-js/sdk/core";
+var fromPromise = (try_) => Effect.tryPromise({ try: try_, catch: (cause) => cause }).pipe(Effect.orDie);
+var toPromiseInvokeOptions = (options) => {
+  const onElicitation = options?.onElicitation;
+  if (!onElicitation) return void 0;
+  if (onElicitation === "accept-all") return { onElicitation };
+  return {
+    onElicitation: (ctx) => onElicitation({
+      ...ctx,
+      toolId: ToolId.make(ctx.toolId)
+    })
+  };
+};
 var wrapPromiseExecutor = (pe) => ({
-  scope: pe.scope,
+  scopes: pe.scopes,
   tools: {
-    invoke: (id, args, options) => Effect.tryPromise({
-      try: () => pe.tools.invoke(id, args, options),
-      catch: (cause) => cause
-    }),
-    list: (filter) => Effect.tryPromise({
-      try: () => pe.tools.list(filter),
-      catch: (cause) => cause
-    }).pipe(Effect.orDie),
-    schema: (id) => Effect.tryPromise({
-      try: () => pe.tools.schema(id),
-      catch: (cause) => cause
-    }),
-    definitions: () => Effect.tryPromise({
-      try: () => pe.tools.definitions(),
-      catch: (cause) => cause
-    }).pipe(Effect.orDie)
+    invoke: (id, args, options) => fromPromise(() => pe.tools.invoke(id, args, toPromiseInvokeOptions(options))),
+    list: (filter) => fromPromise(() => pe.tools.list(filter)),
+    schema: (id) => fromPromise(() => pe.tools.schema(id)),
+    definitions: () => fromPromise(() => pe.tools.definitions())
   },
   sources: {
-    list: () => Effect.tryPromise({
-      try: () => pe.sources.list(),
-      catch: (cause) => cause
-    }).pipe(Effect.orDie)
-  }
+    list: () => fromPromise(() => pe.sources.list()),
+    remove: (id) => fromPromise(() => pe.sources.remove(id)),
+    refresh: (id) => fromPromise(() => pe.sources.refresh(id)),
+    detect: (url) => fromPromise(() => pe.sources.detect(url)),
+    definitions: (id) => fromPromise(() => pe.sources.definitions(id))
+  },
+  secrets: {
+    get: (id) => fromPromise(() => pe.secrets.get(id)),
+    status: (id) => fromPromise(() => pe.secrets.status(id)),
+    set: (input) => fromPromise(() => pe.secrets.set(input)),
+    remove: (id) => fromPromise(() => pe.secrets.remove(id)),
+    list: () => fromPromise(() => pe.secrets.list()),
+    providers: () => fromPromise(() => pe.secrets.providers())
+  },
+  connections: {
+    get: (id) => fromPromise(() => pe.connections.get(id)),
+    list: () => fromPromise(() => pe.connections.list()),
+    create: (input) => fromPromise(() => pe.connections.create(input)),
+    updateTokens: (input) => fromPromise(() => pe.connections.updateTokens(input)),
+    setIdentityLabel: (id, label) => fromPromise(() => pe.connections.setIdentityLabel(id, label)),
+    accessToken: (id) => fromPromise(() => pe.connections.accessToken(id)),
+    remove: (id) => fromPromise(() => pe.connections.remove(id)),
+    providers: () => fromPromise(() => pe.connections.providers())
+  },
+  oauth: {
+    probe: (input) => fromPromise(() => pe.oauth.probe(input)),
+    start: (input) => fromPromise(() => pe.oauth.start(input)),
+    complete: (input) => fromPromise(() => pe.oauth.complete(input)),
+    cancel: (sessionId, tokenScope) => fromPromise(() => pe.oauth.cancel(sessionId, tokenScope))
+  },
+  policies: {
+    list: () => fromPromise(() => pe.policies.list()),
+    create: (input) => fromPromise(() => pe.policies.create(input)),
+    update: (input) => fromPromise(() => pe.policies.update(input)),
+    remove: (id) => fromPromise(() => pe.policies.remove(id)),
+    resolve: (id) => fromPromise(() => pe.policies.resolve(id))
+  },
+  close: () => fromPromise(() => pe.close())
+});
+var toPromiseExecutionEngine = (engine) => ({
+  execute: (code, options) => Effect.runPromise(
+    engine.execute(code, {
+      onElicitation: (ctx) => Effect.tryPromise(() => options.onElicitation(ctx)).pipe(Effect.orDie)
+    })
+  ),
+  executeWithPause: (code) => Effect.runPromise(engine.executeWithPause(code)),
+  resume: (executionId, response) => Effect.runPromise(engine.resume(executionId, response)),
+  getDescription: () => Effect.runPromise(engine.getDescription)
 });
-var createExecutionEngine2 = (config) => {
-  const engine = createExecutionEngine({
+var createExecutionEngine2 = (config) => toPromiseExecutionEngine(
+  createExecutionEngine({
     executor: wrapPromiseExecutor(config.executor),
     codeExecutor: config.codeExecutor
-  });
-  return {
-    execute: (code, options) => engine.execute(code, {
-      onElicitation: (ctx) => Effect.tryPromise(() => options.onElicitation(ctx)).pipe(
-        Effect.orDie
-      )
-    }),
-    executeWithPause: (code) => engine.executeWithPause(code),
-    resume: (executionId, response) => engine.resume(executionId, response),
-    getDescription: () => engine.getDescription()
-  };
-};
+  })
+);
 export {
   ExecutionToolError,
   buildExecuteDescription,
   createExecutionEngine2 as createExecutionEngine,
   formatExecuteResult,
-  formatPausedExecution
+  formatPausedExecution,
+  toPromiseExecutionEngine
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/promise.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// @executor/execution/promise — Promise-native surface for the execution\n// engine. Accepts a Promise-style Executor (from @executor/sdk) and an\n// async `onElicitation` handler — no Effect imports required by callers.\n//\n// Under the hood the engine is Effect-based, so we wrap the incoming\n// Promise executor into the minimal Effect shape the engine consumes,\n// and bridge the elicitation handler via `Effect.tryPromise`.\n// ---------------------------------------------------------------------------\n\nimport { Effect } from \"effect\";\n\nimport type {\n  ElicitationContext,\n  ElicitationResponse,\n  Executor as PromiseExecutor,\n} from \"@executor/sdk\";\nimport type { CodeExecutor, ExecuteResult } from \"@executor/codemode-core\";\n\nimport {\n  createExecutionEngine as createEffectExecutionEngine,\n  type ExecutionResult,\n  type PausedExecution,\n  type ResumeResponse,\n} from \"./engine\";\n\nexport type ElicitationHandler = (\n  ctx: ElicitationContext,\n) => Promise<ElicitationResponse>;\n\nexport type ExecutionEngineConfig = {\n  readonly executor: PromiseExecutor;\n  readonly codeExecutor: CodeExecutor;\n};\n\nexport type ExecutionEngine = {\n  readonly execute: (\n    code: string,\n    options: { readonly onElicitation: ElicitationHandler },\n  ) => Promise<ExecuteResult>;\n  readonly executeWithPause: (code: string) => Promise<ExecutionResult>;\n  readonly resume: (\n    executionId: string,\n    response: ResumeResponse,\n  ) => Promise<ExecutionResult | null>;\n  readonly getDescription: () => Promise<string>;\n};\n\n/**\n * Wrap a Promise-style executor into the Effect shape the engine consumes.\n * Only the four method families the engine actually touches need wrapping:\n * `tools.{invoke,list,schema}` and `sources.list`.\n */\nconst wrapPromiseExecutor = (pe: PromiseExecutor): any => ({\n  scope: (pe as any).scope,\n  tools: {\n    invoke: (id: unknown, args: unknown, options: unknown) =>\n      Effect.tryPromise({\n        try: () => (pe.tools as any).invoke(id, args, options),\n        catch: (cause) => cause,\n      }),\n    list: (filter?: unknown) =>\n      Effect.tryPromise({\n        try: () => (pe.tools as any).list(filter),\n        catch: (cause) => cause,\n      }).pipe(Effect.orDie),\n    schema: (id: unknown) =>\n      Effect.tryPromise({\n        try: () => (pe.tools as any).schema(id),\n        catch: (cause) => cause,\n      }),\n    definitions: () =>\n      Effect.tryPromise({\n        try: () => (pe.tools as any).definitions(),\n        catch: (cause) => cause,\n      }).pipe(Effect.orDie),\n  },\n  sources: {\n    list: () =>\n      Effect.tryPromise({\n        try: () => (pe.sources as any).list(),\n        catch: (cause) => cause,\n      }).pipe(Effect.orDie),\n  },\n});\n\nexport const createExecutionEngine = (\n  config: ExecutionEngineConfig,\n): ExecutionEngine => {\n  const engine = createEffectExecutionEngine({\n    executor: wrapPromiseExecutor(config.executor),\n    codeExecutor: config.codeExecutor,\n  });\n  return {\n    execute: (code, options) =>\n      engine.execute(code, {\n        onElicitation: (ctx) =>\n          Effect.tryPromise(() => options.onElicitation(ctx)).pipe(\n            Effect.orDie,\n          ),\n      }),\n    executeWithPause: (code) => engine.executeWithPause(code),\n    resume: (executionId, response) => engine.resume(executionId, response),\n    getDescription: () => engine.getDescription(),\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Re-exports — plain types/helpers that don't carry Effect signatures.\n// ---------------------------------------------------------------------------\n\nexport {\n  formatExecuteResult,\n  formatPausedExecution,\n} from \"./engine\";\n\nexport type { ExecutionResult, PausedExecution, ResumeResponse };\n\nexport { buildExecuteDescription } from \"./description\";\nexport { ExecutionToolError } from \"./errors\";\n"],"mappings":";;;;;;;;;AAUA,SAAS,cAAc;AA2CvB,IAAM,sBAAsB,CAAC,QAA8B;AAAA,EACzD,OAAQ,GAAW;AAAA,EACnB,OAAO;AAAA,IACL,QAAQ,CAAC,IAAa,MAAe,YACnC,OAAO,WAAW;AAAA,MAChB,KAAK,MAAO,GAAG,MAAc,OAAO,IAAI,MAAM,OAAO;AAAA,MACrD,OAAO,CAAC,UAAU;AAAA,IACpB,CAAC;AAAA,IACH,MAAM,CAAC,WACL,OAAO,WAAW;AAAA,MAChB,KAAK,MAAO,GAAG,MAAc,KAAK,MAAM;AAAA,MACxC,OAAO,CAAC,UAAU;AAAA,IACpB,CAAC,EAAE,KAAK,OAAO,KAAK;AAAA,IACtB,QAAQ,CAAC,OACP,OAAO,WAAW;AAAA,MAChB,KAAK,MAAO,GAAG,MAAc,OAAO,EAAE;AAAA,MACtC,OAAO,CAAC,UAAU;AAAA,IACpB,CAAC;AAAA,IACH,aAAa,MACX,OAAO,WAAW;AAAA,MAChB,KAAK,MAAO,GAAG,MAAc,YAAY;AAAA,MACzC,OAAO,CAAC,UAAU;AAAA,IACpB,CAAC,EAAE,KAAK,OAAO,KAAK;AAAA,EACxB;AAAA,EACA,SAAS;AAAA,IACP,MAAM,MACJ,OAAO,WAAW;AAAA,MAChB,KAAK,MAAO,GAAG,QAAgB,KAAK;AAAA,MACpC,OAAO,CAAC,UAAU;AAAA,IACpB,CAAC,EAAE,KAAK,OAAO,KAAK;AAAA,EACxB;AACF;AAEO,IAAMA,yBAAwB,CACnC,WACoB;AACpB,QAAM,SAAS,sBAA4B;AAAA,IACzC,UAAU,oBAAoB,OAAO,QAAQ;AAAA,IAC7C,cAAc,OAAO;AAAA,EACvB,CAAC;AACD,SAAO;AAAA,IACL,SAAS,CAAC,MAAM,YACd,OAAO,QAAQ,MAAM;AAAA,MACnB,eAAe,CAAC,QACd,OAAO,WAAW,MAAM,QAAQ,cAAc,GAAG,CAAC,EAAE;AAAA,QAClD,OAAO;AAAA,MACT;AAAA,IACJ,CAAC;AAAA,IACH,kBAAkB,CAAC,SAAS,OAAO,iBAAiB,IAAI;AAAA,IACxD,QAAQ,CAAC,aAAa,aAAa,OAAO,OAAO,aAAa,QAAQ;AAAA,IACtE,gBAAgB,MAAM,OAAO,eAAe;AAAA,EAC9C;AACF;","names":["createExecutionEngine"]}
+{"version":3,"sources":["../src/promise.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// @executor-js/execution/promise — Promise-native surface for the execution\n// engine.\n// ---------------------------------------------------------------------------\n//\n// `engine.ts` is Effect-native; this module runs each method with\n// `Effect.runPromise` at the boundary so hosts that can't compose Effects\n// (the MCP SDK tool handlers, plain async call sites) can still use the\n// engine. Callers already inside an Effect context should import directly\n// from `@executor-js/execution` to keep trace context intact.\n// ---------------------------------------------------------------------------\n\nimport { Effect } from \"effect\";\nimport type * as Cause from \"effect/Cause\";\n\nimport type {\n  ElicitationContext,\n  ElicitationResponse,\n  Executor as EffectExecutor,\n} from \"@executor-js/sdk/core\";\nimport { ToolId } from \"@executor-js/sdk/core\";\nimport type { Executor as PromiseExecutor } from \"@executor-js/sdk/promise\";\nimport type { CodeExecutionError, CodeExecutor, ExecuteResult } from \"@executor-js/codemode-core\";\n\nimport {\n  createExecutionEngine as createEffectExecutionEngine,\n  type ExecutionEngine as EffectExecutionEngine,\n  type ExecutionResult,\n  type PausedExecution,\n  type ResumeResponse,\n} from \"./engine\";\n\nexport type ElicitationHandler = (\n  ctx: ElicitationContext,\n) => Promise<ElicitationResponse>;\n\nexport type ExecutionEngineConfig<\n  E extends Cause.YieldableError = CodeExecutionError,\n> = {\n  readonly executor: PromiseExecutor;\n  readonly codeExecutor: CodeExecutor<E>;\n};\n\nexport type ExecutionEngine = {\n  readonly execute: (\n    code: string,\n    options: { readonly onElicitation: ElicitationHandler },\n  ) => Promise<ExecuteResult>;\n  readonly executeWithPause: (code: string) => Promise<ExecutionResult>;\n  readonly resume: (\n    executionId: string,\n    response: ResumeResponse,\n  ) => Promise<ExecutionResult | null>;\n  readonly getDescription: () => Promise<string>;\n};\n\n/**\n * Wrap a Promise-style executor into the Effect shape the engine consumes.\n */\nconst fromPromise = <A>(try_: () => Promise<A>): Effect.Effect<A> =>\n  Effect.tryPromise({ try: try_, catch: (cause) => cause }).pipe(Effect.orDie);\n\ntype EffectInvokeOptions = Parameters<EffectExecutor[\"tools\"][\"invoke\"]>[2];\ntype PromiseInvokeOptions = Parameters<PromiseExecutor[\"tools\"][\"invoke\"]>[2];\n\nconst toPromiseInvokeOptions = (\n  options: EffectInvokeOptions,\n): PromiseInvokeOptions => {\n  const onElicitation = options?.onElicitation;\n  if (!onElicitation) return undefined;\n  if (onElicitation === \"accept-all\") return { onElicitation };\n\n  return {\n    onElicitation: (ctx) =>\n      onElicitation({\n        ...ctx,\n        toolId: ToolId.make(ctx.toolId),\n      }),\n  };\n};\n\nconst wrapPromiseExecutor = (pe: PromiseExecutor): EffectExecutor => ({\n  scopes: pe.scopes,\n  tools: {\n    invoke: (id, args, options) =>\n      fromPromise(() => pe.tools.invoke(id, args, toPromiseInvokeOptions(options))),\n    list: (filter) => fromPromise(() => pe.tools.list(filter)),\n    schema: (id) => fromPromise(() => pe.tools.schema(id)),\n    definitions: () => fromPromise(() => pe.tools.definitions()),\n  },\n  sources: {\n    list: () => fromPromise(() => pe.sources.list()),\n    remove: (id) => fromPromise(() => pe.sources.remove(id)),\n    refresh: (id) => fromPromise(() => pe.sources.refresh(id)),\n    detect: (url) => fromPromise(() => pe.sources.detect(url)),\n    definitions: (id) => fromPromise(() => pe.sources.definitions(id)),\n  },\n  secrets: {\n    get: (id) => fromPromise(() => pe.secrets.get(id)),\n    status: (id) => fromPromise(() => pe.secrets.status(id)),\n    set: (input) => fromPromise(() => pe.secrets.set(input)),\n    remove: (id) => fromPromise(() => pe.secrets.remove(id)),\n    list: () => fromPromise(() => pe.secrets.list()),\n    providers: () => fromPromise(() => pe.secrets.providers()),\n  },\n  connections: {\n    get: (id) => fromPromise(() => pe.connections.get(id)),\n    list: () => fromPromise(() => pe.connections.list()),\n    create: (input) => fromPromise(() => pe.connections.create(input)),\n    updateTokens: (input) => fromPromise(() => pe.connections.updateTokens(input)),\n    setIdentityLabel: (id, label) => fromPromise(() => pe.connections.setIdentityLabel(id, label)),\n    accessToken: (id) => fromPromise(() => pe.connections.accessToken(id)),\n    remove: (id) => fromPromise(() => pe.connections.remove(id)),\n    providers: () => fromPromise(() => pe.connections.providers()),\n  },\n  oauth: {\n    probe: (input) => fromPromise(() => pe.oauth.probe(input)),\n    start: (input) => fromPromise(() => pe.oauth.start(input)),\n    complete: (input) => fromPromise(() => pe.oauth.complete(input)),\n    cancel: (sessionId, tokenScope) => fromPromise(() => pe.oauth.cancel(sessionId, tokenScope)),\n  },\n  policies: {\n    list: () => fromPromise(() => pe.policies.list()),\n    create: (input) => fromPromise(() => pe.policies.create(input)),\n    update: (input) => fromPromise(() => pe.policies.update(input)),\n    remove: (id) => fromPromise(() => pe.policies.remove(id)),\n    resolve: (id) => fromPromise(() => pe.policies.resolve(id)),\n  },\n  close: () => fromPromise(() => pe.close()),\n});\n\n/**\n * Promise-wrap an Effect-native `ExecutionEngine` (from `./engine`).\n * Exposed separately so callers that already hold an Effect engine\n * (apps/cloud's execution-stack composes both) can convert it for hosts\n * that need the Promise surface (host-mcp).\n */\nexport const toPromiseExecutionEngine = <E extends Cause.YieldableError>(\n  engine: EffectExecutionEngine<E>,\n): ExecutionEngine => ({\n  execute: (code, options) =>\n    Effect.runPromise(\n      engine.execute(code, {\n        onElicitation: (ctx) =>\n          Effect.tryPromise(() => options.onElicitation(ctx)).pipe(Effect.orDie),\n      }),\n    ),\n  executeWithPause: (code) => Effect.runPromise(engine.executeWithPause(code)),\n  resume: (executionId, response) => Effect.runPromise(engine.resume(executionId, response)),\n  getDescription: () => Effect.runPromise(engine.getDescription),\n});\n\nexport const createExecutionEngine = <\n  E extends Cause.YieldableError = CodeExecutionError,\n>(\n  config: ExecutionEngineConfig<E>,\n): ExecutionEngine =>\n  toPromiseExecutionEngine(\n    createEffectExecutionEngine({\n      executor: wrapPromiseExecutor(config.executor),\n      codeExecutor: config.codeExecutor,\n    }),\n  );\n\n// ---------------------------------------------------------------------------\n// Re-exports — plain types/helpers that don't carry Effect signatures.\n// ---------------------------------------------------------------------------\n\nexport { formatExecuteResult, formatPausedExecution } from \"./engine\";\n\nexport type { ExecutionResult, PausedExecution, ResumeResponse };\n\nexport { buildExecuteDescription } from \"./description\";\nexport { ExecutionToolError } from \"./errors\";\n"],"mappings":"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","names":["createExecutionEngine"]}

package/dist/promise.d.ts

@@ -1,10 +1,12 @@
-import type { ElicitationContext, ElicitationResponse, Executor as PromiseExecutor } from "@executor-js/sdk";
-import type { CodeExecutor, ExecuteResult } from "@executor-js/codemode-core";
-import { type ExecutionResult, type PausedExecution, type ResumeResponse } from "./engine";
+import type * as Cause from "effect/Cause";
+import type { ElicitationContext, ElicitationResponse } from "@executor-js/sdk/core";
+import type { Executor as PromiseExecutor } from "@executor-js/sdk/promise";
+import type { CodeExecutionError, CodeExecutor, ExecuteResult } from "@executor-js/codemode-core";
+import { type ExecutionEngine as EffectExecutionEngine, type ExecutionResult, type PausedExecution, type ResumeResponse } from "./engine";
 export type ElicitationHandler = (ctx: ElicitationContext) => Promise<ElicitationResponse>;
-export type ExecutionEngineConfig = {
+export type ExecutionEngineConfig<E extends Cause.YieldableError = CodeExecutionError> = {
     readonly executor: PromiseExecutor;
-    readonly codeExecutor: CodeExecutor;
+    readonly codeExecutor: CodeExecutor<E>;
 };
 export type ExecutionEngine = {
     readonly execute: (code: string, options: {
@@ -14,8 +16,15 @@ export type ExecutionEngine = {
     readonly resume: (executionId: string, response: ResumeResponse) => Promise<ExecutionResult | null>;
     readonly getDescription: () => Promise<string>;
 };
-export declare const createExecutionEngine: (config: ExecutionEngineConfig) => ExecutionEngine;
-export { formatExecuteResult, formatPausedExecution, } from "./engine";
+/**
+ * Promise-wrap an Effect-native `ExecutionEngine` (from `./engine`).
+ * Exposed separately so callers that already hold an Effect engine
+ * (apps/cloud's execution-stack composes both) can convert it for hosts
+ * that need the Promise surface (host-mcp).
+ */
+export declare const toPromiseExecutionEngine: <E extends Cause.YieldableError>(engine: EffectExecutionEngine<E>) => ExecutionEngine;
+export declare const createExecutionEngine: <E extends Cause.YieldableError = CodeExecutionError>(config: ExecutionEngineConfig<E>) => ExecutionEngine;
+export { formatExecuteResult, formatPausedExecution } from "./engine";
 export type { ExecutionResult, PausedExecution, ResumeResponse };
 export { buildExecuteDescription } from "./description";
 export { ExecutionToolError } from "./errors";

package/dist/promise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../src/promise.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,IAAI,eAAe,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,kBAAkB,KACpB,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAA;KAAE,KACpD,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,CACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC;AAwCF,eAAO,MAAM,qBAAqB,GAChC,QAAQ,qBAAqB,KAC5B,eAiBF,CAAC;AAMF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../src/promise.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAElG,OAAO,EAEL,KAAK,eAAe,IAAI,qBAAqB,EAC7C,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,kBAAkB,KACpB,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,KAAK,CAAC,cAAc,GAAG,kBAAkB,IACjD;IACF,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAA;KAAE,KACpD,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,CACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC;AA6EF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,KAAK,CAAC,cAAc,EACrE,QAAQ,qBAAqB,CAAC,CAAC,CAAC,KAC/B,eAWD,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAChC,CAAC,SAAS,KAAK,CAAC,cAAc,GAAG,kBAAkB,EAEnD,QAAQ,qBAAqB,CAAC,CAAC,CAAC,KAC/B,eAMA,CAAC;AAMJ,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/tool-invoker.d.ts

@@ -1,9 +1,18 @@
 import { Effect } from "effect";
-import type { Executor, InvokeOptions } from "@executor-js/sdk";
+import type { Executor, InvokeOptions } from "@executor-js/sdk/core";
 import type { SandboxToolInvoker } from "@executor-js/codemode-core";
 /**
  * Bridges QuickJS `tools.someSource.someOp(args)` calls into
  * `executor.tools.invoke(toolId, args)`.
+ *
+ * Wrapped in `Effect.fn("mcp.tool.dispatch")` so every tool call becomes a
+ * span in the Effect tracer. Attributes:
+ *   - `mcp.tool.name`      — full tool path (e.g. "github.repos.get")
+ *   - `mcp.tool.source_id` — first segment of the path (namespace)
+ *
+ * `mcp.tool.kind` (openapi | mcp | graphql | code) is NOT annotated here
+ * because it would require a `sources.list()` lookup on every invocation.
+ * Callers that already know the source kind can annotate at their own span.
  */
 export declare const makeExecutorToolInvoker: (executor: Executor, options: {
     readonly invokeOptions: InvokeOptions;
@@ -24,22 +33,60 @@ export type ExecutorSourceListItem = {
     readonly canRefresh?: boolean;
     readonly toolCount: number;
 };
+/**
+ * Page of results from a list-style discovery tool. Shared by
+ * `tools.search` and `tools.executor.sources.list` so the model sees one
+ * consistent shape:
+ *
+ *   - `items`      — the page (slice).
+ *   - `total`      — count after filtering, before pagination. The model
+ *                    can use this to detect truncation.
+ *   - `hasMore`    — convenience flag for `(offset + items.length) < total`.
+ *   - `nextOffset` — concrete offset for the next page when `hasMore`,
+ *                    `null` otherwise. Pre-computing it removes a class of
+ *                    off-by-one mistakes when the model paginates.
+ */
+export type PagedResult<T> = {
+    readonly items: readonly T[];
+    readonly total: number;
+    readonly hasMore: boolean;
+    readonly nextOffset: number | null;
+};
 /** What `tools.search()` calls inside the sandbox. */
-export declare const searchTools: (executor: Executor, query: string, limit?: number, options?: {
+export declare const searchTools: (executor: Executor, query: string, limit?: any, options?: {
     readonly namespace?: string;
-}) => Effect.Effect<ReadonlyArray<ToolDiscoveryResult>>;
+    readonly offset?: number;
+} | undefined) => Effect.Effect<PagedResult<ToolDiscoveryResult>, never, never>;
 /** What `tools.executor.sources.list()` calls inside the sandbox. */
 export declare const listExecutorSources: (executor: Executor, options?: {
     readonly query?: string;
     readonly limit?: number;
-}) => Effect.Effect<ReadonlyArray<ExecutorSourceListItem>>;
+    readonly offset?: number;
+} | undefined) => Effect.Effect<PagedResult<{
+    id: string;
+    name: string;
+    kind: string;
+    runtime: boolean;
+    canRemove: boolean;
+    canRefresh: boolean;
+    toolCount: number;
+}>, never, never>;
 /** What `tools.describe.tool()` calls inside the sandbox. */
 export declare const describeTool: (executor: Executor, path: string) => Effect.Effect<{
     path: string;
     name: string;
-    description?: string;
-    inputTypeScript?: string;
-    outputTypeScript?: string;
-    typeScriptDefinitions?: Record<string, string>;
-}, unknown>;
+    description?: undefined;
+    inputTypeScript?: undefined;
+    outputTypeScript?: undefined;
+    typeScriptDefinitions?: undefined;
+} | {
+    path: string;
+    name: string;
+    description: string | undefined;
+    inputTypeScript: string | undefined;
+    outputTypeScript: string | undefined;
+    typeScriptDefinitions: {
+        readonly [x: string]: string;
+    } | undefined;
+}, import("@executor-js/storage-core").StorageFailure, never>;
 //# sourceMappingURL=tool-invoker.d.ts.map

package/dist/tool-invoker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-invoker.d.ts","sourceRoot":"","sources":["../src/tool-invoker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACV,QAAQ,EAIR,aAAa,EAEd,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,QAAQ,EAClB,SAAS;IAAE,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;CAAE,KACjD,kBA4BD,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAsLF,sDAAsD;AACtD,eAAO,MAAM,WAAW,GACtB,UAAU,QAAQ,EAClB,OAAO,MAAM,EACb,cAAU,EACV,UAAU;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KACxC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAa/C,CAAC;AAEL,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,GAC9B,UAAU,QAAQ,EAClB,UAAU;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAC7D,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAqClD,CAAC;AAEL,6DAA6D;AAC7D,eAAO,MAAM,YAAY,GACvB,UAAU,QAAQ,EAClB,MAAM,MAAM,KACX,MAAM,CAAC,MAAM,CACd;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,EACD,OAAO,CAuBL,CAAC"}
+{"version":3,"file":"tool-invoker.d.ts","sourceRoot":"","sources":["../src/tool-invoker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EACV,QAAQ,EAIR,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAwCrE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,QAAQ,EAClB,SAAS;IAAE,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;CAAE,KACjD,kBA+CD,CAAC;AAcH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAoMF,sDAAsD;AACtD,eAAO,MAAM,WAAW;yBAIW,MAAM;sBAAoB,MAAM;+EAqCjE,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;qBAGX,MAAM;qBACN,MAAM;sBACL,MAAM;;;;;;;;;iBA+C1B,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;6DA0BvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@executor-js/execution",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "homepage": "https://github.com/RhysSullivan/executor/tree/main/packages/core/execution",
   "bugs": {
     "url": "https://github.com/RhysSullivan/executor/issues"
@@ -39,17 +39,17 @@
     "typecheck:slow": "bunx tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@executor-js/codemode-core": "0.0.1",
-    "@executor-js/sdk": "0.0.1",
-    "effect": "^3.21.0"
+    "@executor-js/codemode-core": "0.1.0",
+    "@executor-js/sdk": "0.1.0",
+    "effect": "4.0.0-beta.59"
   },
   "devDependencies": {
-    "@effect/vitest": "^0.29.0",
-    "@executor-js/runtime-quickjs": "0.0.1",
+    "@effect/vitest": "4.0.0-beta.59",
+    "@executor-js/runtime-quickjs": "0.1.0",
     "@types/node": "^24.3.1",
     "bun-types": "^1.2.22",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.3"
+    "vitest": "^4.1.5"
   }
 }

package/dist/chunk-BF7CHG2T.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors.ts","../src/tool-invoker.ts","../src/description.ts","../src/engine.ts"],"sourcesContent":["import * as Data from \"effect/Data\";\n\nexport class ExecutionToolError extends Data.TaggedError(\"ExecutionToolError\")<{\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n","import { Effect } from \"effect\";\nimport type {\n  Executor,\n  ToolId,\n  Tool,\n  ToolSchema,\n  InvokeOptions,\n  Source,\n} from \"@executor/sdk\";\nimport type { SandboxToolInvoker } from \"@executor/codemode-core\";\nimport { ExecutionToolError } from \"./errors\";\n\n/**\n * Bridges QuickJS `tools.someSource.someOp(args)` calls into\n * `executor.tools.invoke(toolId, args)`.\n */\nexport const makeExecutorToolInvoker = (\n  executor: Executor,\n  options: { readonly invokeOptions: InvokeOptions },\n): SandboxToolInvoker => ({\n  invoke: ({ path, args }) =>\n    Effect.gen(function* () {\n      const result = yield* executor.tools.invoke(path as ToolId, args, options.invokeOptions).pipe(\n        Effect.catchTag(\"ElicitationDeclinedError\", (err) =>\n          Effect.fail(\n            new ExecutionToolError({\n              message: `Tool \"${err.toolId}\" requires approval but the request was ${err.action === \"cancel\" ? \"cancelled\" : \"declined\"} by the user.`,\n              cause: err,\n            }),\n          ),\n        ),\n      );\n      const r = result as { readonly error?: unknown; readonly data?: unknown } | unknown;\n      if (\n        r !== null &&\n        typeof r === \"object\" &&\n        \"error\" in r &&\n        (r as { error?: unknown }).error !== null &&\n        (r as { error?: unknown }).error !== undefined\n      ) {\n        return yield* Effect.fail((r as { error: unknown }).error);\n      }\n      if (r !== null && typeof r === \"object\" && \"data\" in r) {\n        return (r as { data: unknown }).data;\n      }\n      return r;\n    }),\n});\n\nexport type ToolDiscoveryResult = {\n  readonly path: string;\n  readonly name: string;\n  readonly description?: string;\n  readonly sourceId: string;\n  readonly score: number;\n};\n\nexport type ExecutorSourceListItem = {\n  readonly id: string;\n  readonly name: string;\n  readonly kind: string;\n  readonly runtime?: boolean;\n  readonly canRemove?: boolean;\n  readonly canRefresh?: boolean;\n  readonly toolCount: number;\n};\n\ntype SearchableTool = Pick<Tool, \"id\" | \"sourceId\" | \"name\" | \"description\">;\n\ntype PreparedField = {\n  readonly raw: string;\n  readonly tokens: readonly string[];\n};\n\nconst SEARCH_FIELD_WEIGHTS = {\n  path: 12,\n  sourceId: 8,\n  name: 10,\n  description: 5,\n} as const;\n\nconst normalizeSearchText = (value: string): string =>\n  value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .replace(/[_./:-]+/g, \" \")\n    .toLowerCase()\n    .trim();\n\nconst tokenizeSearchText = (value: string): string[] =>\n  normalizeSearchText(value)\n    .split(/[^a-z0-9]+/)\n    .map((token) => token.trim())\n    .filter(Boolean);\n\nconst prepareField = (value?: string): PreparedField => ({\n  raw: normalizeSearchText(value ?? \"\"),\n  tokens: tokenizeSearchText(value ?? \"\"),\n});\n\nconst scorePreparedField = (\n  query: string,\n  queryTokens: readonly string[],\n  field: PreparedField,\n  weight: number,\n): {\n  readonly score: number;\n  readonly matchedTokens: ReadonlySet<string>;\n  readonly exactPhraseMatch: boolean;\n} => {\n  if (field.raw.length === 0) {\n    return {\n      score: 0,\n      matchedTokens: new Set<string>(),\n      exactPhraseMatch: false,\n    };\n  }\n\n  let score = 0;\n  const matchedTokens = new Set<string>();\n  const exactPhraseMatch = query.length > 0 && field.raw.includes(query);\n\n  if (query.length > 0) {\n    if (field.raw === query) {\n      score += weight * 14;\n    } else if (field.raw.startsWith(query)) {\n      score += weight * 9;\n    } else if (exactPhraseMatch) {\n      score += weight * 6;\n    }\n  }\n\n  for (const token of queryTokens) {\n    if (field.tokens.includes(token)) {\n      score += weight * 4;\n      matchedTokens.add(token);\n      continue;\n    }\n\n    if (\n      field.tokens.some((candidate) => candidate.startsWith(token) || token.startsWith(candidate))\n    ) {\n      score += weight * 2;\n      matchedTokens.add(token);\n      continue;\n    }\n\n    if (field.raw.includes(token)) {\n      score += weight;\n      matchedTokens.add(token);\n    }\n  }\n\n  return {\n    score,\n    matchedTokens,\n    exactPhraseMatch,\n  };\n};\n\nconst matchesNamespace = (tool: SearchableTool, namespace?: string): boolean => {\n  if (!namespace || normalizeSearchText(namespace).length === 0) {\n    return true;\n  }\n\n  const namespaceTokens = tokenizeSearchText(namespace);\n  if (namespaceTokens.length === 0) {\n    return true;\n  }\n\n  const sourceTokens = tokenizeSearchText(tool.sourceId);\n  const pathTokens = tokenizeSearchText(tool.id);\n\n  const isPrefixMatch = (tokens: readonly string[]): boolean =>\n    namespaceTokens.every((token, index) => tokens[index] === token);\n\n  return isPrefixMatch(sourceTokens) || isPrefixMatch(pathTokens);\n};\n\nconst scoreToolMatch = (tool: SearchableTool, query: string): ToolDiscoveryResult | null => {\n  const normalizedQuery = normalizeSearchText(query);\n  const queryTokens = tokenizeSearchText(query);\n\n  if (normalizedQuery.length === 0 || queryTokens.length === 0) {\n    return null;\n  }\n\n  const path = prepareField(tool.id);\n  const sourceId = prepareField(tool.sourceId);\n  const name = prepareField(tool.name);\n  const description = prepareField(tool.description);\n\n  const fieldScores = [\n    scorePreparedField(normalizedQuery, queryTokens, path, SEARCH_FIELD_WEIGHTS.path),\n    scorePreparedField(normalizedQuery, queryTokens, sourceId, SEARCH_FIELD_WEIGHTS.sourceId),\n    scorePreparedField(normalizedQuery, queryTokens, name, SEARCH_FIELD_WEIGHTS.name),\n    scorePreparedField(normalizedQuery, queryTokens, description, SEARCH_FIELD_WEIGHTS.description),\n  ];\n\n  const matchedTokens = new Set<string>();\n  let score = 0;\n  let exactPhraseMatch = false;\n\n  for (const fieldScore of fieldScores) {\n    score += fieldScore.score;\n    exactPhraseMatch ||= fieldScore.exactPhraseMatch;\n    for (const token of fieldScore.matchedTokens) {\n      matchedTokens.add(token);\n    }\n  }\n\n  if (matchedTokens.size === 0) {\n    return null;\n  }\n\n  const coverage = matchedTokens.size / queryTokens.length;\n  const minimumCoverage = queryTokens.length <= 2 ? 1 : 0.6;\n\n  if (coverage < minimumCoverage && !exactPhraseMatch) {\n    return null;\n  }\n\n  if (coverage === 1) {\n    score += 25;\n  } else {\n    score += Math.round(coverage * 10);\n  }\n\n  if (path.tokens[0] === queryTokens[0] || name.tokens[0] === queryTokens[0]) {\n    score += 8;\n  }\n\n  if (\n    normalizeSearchText(tool.id) === normalizedQuery ||\n    normalizeSearchText(tool.name) === normalizedQuery\n  ) {\n    score += 20;\n  }\n\n  return {\n    path: tool.id,\n    name: tool.name,\n    description: tool.description,\n    sourceId: tool.sourceId,\n    score,\n  };\n};\n\n/** What `tools.search()` calls inside the sandbox. */\nexport const searchTools = (\n  executor: Executor,\n  query: string,\n  limit = 12,\n  options?: { readonly namespace?: string },\n): Effect.Effect<ReadonlyArray<ToolDiscoveryResult>> =>\n  Effect.gen(function* () {\n    if (normalizeSearchText(query).length === 0) {\n      return [];\n    }\n\n    const all = yield* executor.tools.list().pipe(Effect.orDie);\n    return all\n      .filter((tool: Tool) => matchesNamespace(tool, options?.namespace))\n      .map((tool: Tool) => scoreToolMatch(tool, query))\n      .filter((tool): tool is ToolDiscoveryResult => tool !== null)\n      .sort((left, right) => right.score - left.score || left.path.localeCompare(right.path))\n      .slice(0, limit);\n  });\n\n/** What `tools.executor.sources.list()` calls inside the sandbox. */\nexport const listExecutorSources = (\n  executor: Executor,\n  options?: { readonly query?: string; readonly limit?: number },\n): Effect.Effect<ReadonlyArray<ExecutorSourceListItem>> =>\n  Effect.gen(function* () {\n    const normalizedQuery = normalizeSearchText(options?.query ?? \"\");\n    const limit = options?.limit ?? 200;\n    const sources = yield* executor.sources.list().pipe(Effect.orDie);\n\n    const filtered =\n      normalizedQuery.length === 0\n        ? sources\n        : sources.filter((source: Source) => {\n            const haystack = normalizeSearchText([source.id, source.name, source.kind].join(\" \"));\n            return tokenizeSearchText(normalizedQuery).every((token) => haystack.includes(token));\n          });\n\n    // Single query for all tools, then count per source in memory.\n    const allTools = yield* executor.tools.list().pipe(Effect.orDie);\n    const toolCountBySource = new Map<string, number>();\n    for (const tool of allTools) {\n      toolCountBySource.set(tool.sourceId, (toolCountBySource.get(tool.sourceId) ?? 0) + 1);\n    }\n\n    const withCounts = filtered.map(\n      (source: Source) =>\n        ({\n          id: source.id,\n          name: source.name,\n          kind: source.kind,\n          runtime: source.runtime,\n          canRemove: source.canRemove,\n          canRefresh: source.canRefresh,\n          toolCount: toolCountBySource.get(source.id) ?? 0,\n        }) satisfies ExecutorSourceListItem,\n    );\n\n    return withCounts\n      .sort((left, right) => left.name.localeCompare(right.name) || left.id.localeCompare(right.id))\n      .slice(0, limit);\n  });\n\n/** What `tools.describe.tool()` calls inside the sandbox. */\nexport const describeTool = (\n  executor: Executor,\n  path: string,\n): Effect.Effect<\n  {\n    path: string;\n    name: string;\n    description?: string;\n    inputTypeScript?: string;\n    outputTypeScript?: string;\n    typeScriptDefinitions?: Record<string, string>;\n  },\n  unknown\n> =>\n  Effect.gen(function* () {\n    // Single tools.schema() call — it already fetches the tool row\n    // internally. No need to also call tools.list() just for name/description.\n    const schema: ToolSchema | null = yield* executor.tools.schema(path);\n\n    // tools.schema() returns null if the tool doesn't exist. Fall back to\n    // a minimal stub so callers can still render something.\n    if (schema === null) {\n      return { path, name: path };\n    }\n\n    // The schema's id is the tool path; name/description come from the\n    // tool row which tools.schema() already loaded.\n    return {\n      path,\n      name: schema.name ?? path,\n      description: schema.description,\n      inputTypeScript: schema.inputTypeScript,\n      outputTypeScript: schema.outputTypeScript,\n      typeScriptDefinitions: schema.typeScriptDefinitions,\n    };\n  });\n","import { Effect } from \"effect\";\nimport type { Executor, Tool, Source } from \"@executor/sdk\";\n\n/**\n * Builds a tool description dynamically.\n *\n * Structure:\n *   1. Workflow (top — critical, least likely to be truncated)\n *   2. Available namespaces (bottom)\n */\nexport const buildExecuteDescription = (executor: Executor): Effect.Effect<string> =>\n  Effect.gen(function* () {\n    const sources: readonly Source[] = yield* executor.sources.list().pipe(Effect.orDie);\n    const tools: readonly Tool[] = yield* executor.tools.list().pipe(Effect.orDie);\n\n    const namespaces = new Set<string>();\n    for (const tool of tools) namespaces.add(tool.sourceId);\n\n    return formatDescription([...namespaces], sources);\n  });\n\nconst formatDescription = (namespaces: readonly string[], sources: readonly Source[]): string => {\n  const lines: string[] = [\n    \"Execute TypeScript in a sandboxed runtime with access to configured API tools.\",\n    \"\",\n    \"## Workflow\",\n    \"\",\n    '1. `const matches = await tools.search({ query: \"<intent + key nouns>\", limit: 12 });`',\n    '2. `const path = matches[0]?.path; if (!path) return \"No matching tools found.\";`',\n    \"3. `const details = await tools.describe.tool({ path });`\",\n    \"4. Use `details.inputTypeScript` / `details.outputTypeScript` and `details.typeScriptDefinitions` for compact shapes.\",\n    \"5. Use `tools.executor.sources.list()` when you need configured source inventory.\",\n    \"6. Call the tool: `const result = await tools.<path>(input);`\",\n    \"\",\n    \"## Rules\",\n    \"\",\n    \"- `tools.search()` returns ranked matches, best-first. Use short intent phrases like `github issues`, `repo details`, or `create calendar event`.\",\n    '- When you already know the namespace, narrow with `tools.search({ namespace: \"github\", query: \"issues\" })`.',\n    \"- Use `tools.executor.sources.list()` to inspect configured sources and their tool counts. Returns `[{ id, toolCount, ... }]`.\",\n    \"- Always use the namespace prefix when calling tools: `tools.<namespace>.<tool>(args)`. Example: `tools.home_assistant_rest_api.states.getState(...)` — not `tools.states.getState(...)`.\",\n    \"- The `tools` object is a lazy proxy — `Object.keys(tools)` won't work. Use `tools.search()` or `tools.executor.sources.list()` instead.\",\n    '- Pass an object to system tools, e.g. `tools.search({ query: \"...\" })`, `tools.executor.sources.list()`, and `tools.describe.tool({ path })`.',\n    \"- `tools.describe.tool()` returns compact TypeScript shapes. Use `inputTypeScript`, `outputTypeScript`, and `typeScriptDefinitions`.\",\n    \"- For tools that return large collections (e.g. `getStates`, `getAll`), filter results in code rather than calling per-item tools.\",\n    \"- Do not use `fetch` — all API calls go through `tools.*`.\",\n    \"- If execution pauses for interaction, resume it with the returned `resumePayload`.\",\n  ];\n\n  if (namespaces.length > 0) {\n    lines.push(\"\");\n    lines.push(\"## Available namespaces\");\n    lines.push(\"\");\n    const sorted = [...namespaces].sort();\n    for (const ns of sorted) {\n      const source = sources.find((s) => s.id === ns);\n      const label = source?.name ?? ns;\n      lines.push(`- \\`${ns}\\`${label !== ns ? ` — ${label}` : \"\"}`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n};\n","import { Deferred, Effect, Fiber, Ref } from \"effect\";\n\nimport type {\n  Executor,\n  InvokeOptions,\n  ElicitationResponse,\n  ElicitationHandler,\n  ElicitationContext,\n} from \"@executor/sdk\";\nimport type { CodeExecutor, ExecuteResult, SandboxToolInvoker } from \"@executor/codemode-core\";\n\nimport {\n  makeExecutorToolInvoker,\n  searchTools,\n  listExecutorSources,\n  describeTool,\n} from \"./tool-invoker\";\nimport { ExecutionToolError } from \"./errors\";\nimport { buildExecuteDescription } from \"./description\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type ExecutionEngineConfig = {\n  readonly executor: Executor;\n  readonly codeExecutor: CodeExecutor;\n};\n\nexport type ExecutionResult =\n  | { readonly status: \"completed\"; readonly result: ExecuteResult }\n  | { readonly status: \"paused\"; readonly execution: PausedExecution };\n\nexport type PausedExecution = {\n  readonly id: string;\n  readonly elicitationContext: ElicitationContext;\n};\n\n/** Internal representation with Effect runtime state for pause/resume. */\ntype InternalPausedExecution = PausedExecution & {\n  readonly response: Deferred.Deferred<typeof ElicitationResponse.Type>;\n  readonly fiber: Fiber.Fiber<ExecuteResult, unknown>;\n  readonly pauseSignalRef: Ref.Ref<Deferred.Deferred<InternalPausedExecution>>;\n};\n\nexport type ResumeResponse = {\n  readonly action: \"accept\" | \"decline\" | \"cancel\";\n  readonly content?: Record<string, unknown>;\n};\n\n// ---------------------------------------------------------------------------\n// Result formatting\n// ---------------------------------------------------------------------------\n\nconst MAX_PREVIEW_CHARS = 30_000;\n\nconst truncate = (value: string, max: number): string =>\n  value.length > max\n    ? `${value.slice(0, max)}\\n... [truncated ${value.length - max} chars]`\n    : value;\n\nexport const formatExecuteResult = (\n  result: ExecuteResult,\n): {\n  text: string;\n  structured: Record<string, unknown>;\n  isError: boolean;\n} => {\n  const resultText =\n    result.result != null\n      ? typeof result.result === \"string\"\n        ? result.result\n        : JSON.stringify(result.result, null, 2)\n      : null;\n\n  const logText = result.logs && result.logs.length > 0 ? result.logs.join(\"\\n\") : null;\n\n  if (result.error) {\n    const parts = [`Error: ${result.error}`, ...(logText ? [`\\nLogs:\\n${logText}`] : [])];\n    return {\n      text: truncate(parts.join(\"\\n\"), MAX_PREVIEW_CHARS),\n      structured: { status: \"error\", error: result.error, logs: result.logs ?? [] },\n      isError: true,\n    };\n  }\n\n  const parts = [\n    ...(resultText ? [truncate(resultText, MAX_PREVIEW_CHARS)] : [\"(no result)\"]),\n    ...(logText ? [`\\nLogs:\\n${logText}`] : []),\n  ];\n  return {\n    text: parts.join(\"\\n\"),\n    structured: { status: \"completed\", result: result.result ?? null, logs: result.logs ?? [] },\n    isError: false,\n  };\n};\n\nexport const formatPausedExecution = (\n  paused: PausedExecution,\n): {\n  text: string;\n  structured: Record<string, unknown>;\n} => {\n  const req = paused.elicitationContext.request;\n  const lines: string[] = [`Execution paused: ${req.message}`];\n\n  if (req._tag === \"UrlElicitation\") {\n    lines.push(`\\nOpen this URL in a browser:\\n${req.url}`);\n    lines.push(\"\\nAfter the browser flow, resume with the executionId below:\");\n  } else {\n    lines.push(\"\\nResume with the executionId below and a response matching the requested schema:\");\n    const schema = req.requestedSchema;\n    if (schema && Object.keys(schema).length > 0) {\n      lines.push(`\\nRequested schema:\\n${JSON.stringify(schema, null, 2)}`);\n    }\n  }\n\n  lines.push(`\\nexecutionId: ${paused.id}`);\n\n  return {\n    text: lines.join(\"\\n\"),\n    structured: {\n      status: \"waiting_for_interaction\",\n      executionId: paused.id,\n      interaction: {\n        kind: req._tag === \"UrlElicitation\" ? \"url\" : \"form\",\n        message: req.message,\n        ...(req._tag === \"UrlElicitation\" ? { url: req.url } : {}),\n        ...(req._tag === \"FormElicitation\" ? { requestedSchema: req.requestedSchema } : {}),\n      },\n    },\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Full invoker (base + discover + describe)\n// ---------------------------------------------------------------------------\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst readOptionalLimit = (value: unknown, toolName: string): number | ExecutionToolError => {\n  if (value === undefined) {\n    return 12;\n  }\n\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    return new ExecutionToolError({\n      message: `${toolName} limit must be a positive number when provided`,\n    });\n  }\n\n  return Math.floor(value);\n};\n\nconst makeFullInvoker = (executor: Executor, invokeOptions: InvokeOptions): SandboxToolInvoker => {\n  const base = makeExecutorToolInvoker(executor, { invokeOptions });\n  return {\n    invoke: ({ path, args }) => {\n      if (path === \"search\") {\n        if (!isRecord(args)) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message:\n                \"tools.search expects an object: { query?: string; namespace?: string; limit?: number }\",\n            }),\n          );\n        }\n\n        if (args.query !== undefined && typeof args.query !== \"string\") {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.search query must be a string when provided\",\n            }),\n          );\n        }\n\n        if (args.namespace !== undefined && typeof args.namespace !== \"string\") {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.search namespace must be a string when provided\",\n            }),\n          );\n        }\n\n        const limit = readOptionalLimit(args.limit, \"tools.search\");\n        if (limit instanceof ExecutionToolError) {\n          return Effect.fail(limit);\n        }\n\n        return searchTools(executor, args.query ?? \"\", limit, {\n          namespace: args.namespace,\n        });\n      }\n      if (path === \"executor.sources.list\") {\n        if (args !== undefined && !isRecord(args)) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message:\n                \"tools.executor.sources.list expects an object: { query?: string; limit?: number }\",\n            }),\n          );\n        }\n\n        if (isRecord(args) && args.query !== undefined && typeof args.query !== \"string\") {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.executor.sources.list query must be a string when provided\",\n            }),\n          );\n        }\n\n        const limit = readOptionalLimit(\n          isRecord(args) ? args.limit : undefined,\n          \"tools.executor.sources.list\",\n        );\n        if (limit instanceof ExecutionToolError) {\n          return Effect.fail(limit);\n        }\n\n        return listExecutorSources(executor, {\n          query: isRecord(args) && typeof args.query === \"string\" ? args.query : undefined,\n          limit,\n        });\n      }\n      if (path === \"describe.tool\") {\n        if (!isRecord(args)) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.describe.tool expects an object: { path: string }\",\n            }),\n          );\n        }\n\n        if (typeof args.path !== \"string\" || args.path.trim().length === 0) {\n          return Effect.fail(new ExecutionToolError({ message: \"describe.tool requires a path\" }));\n        }\n\n        if (\"includeSchemas\" in args) {\n          return Effect.fail(\n            new ExecutionToolError({\n              message: \"tools.describe.tool no longer accepts includeSchemas\",\n            }),\n          );\n        }\n\n        return describeTool(executor, args.path);\n      }\n      return base.invoke({ path, args });\n    },\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Execution Engine\n// ---------------------------------------------------------------------------\n\nexport type ExecutionEngine = {\n  /**\n   * Execute code with elicitation handled inline by the provided handler.\n   * Use this when the host supports elicitation (e.g. MCP with elicitation capability).\n   */\n  readonly execute: (\n    code: string,\n    options: { readonly onElicitation: ElicitationHandler },\n  ) => Promise<ExecuteResult>;\n\n  /**\n   * Execute code, intercepting the first elicitation as a pause point.\n   * Use this when the host doesn't support inline elicitation.\n   * Returns either a completed result or a paused execution that can be resumed.\n   */\n  readonly executeWithPause: (code: string) => Promise<ExecutionResult>;\n\n  /**\n   * Resume a paused execution. Returns a completed result, a new pause, or\n   * null if the executionId was not found.\n   */\n  readonly resume: (\n    executionId: string,\n    response: ResumeResponse,\n  ) => Promise<ExecutionResult | null>;\n\n  /**\n   * Get the dynamic tool description (workflow + namespaces).\n   */\n  readonly getDescription: () => Promise<string>;\n};\n\nconst runEffect = <A>(effect: Effect.Effect<A, unknown>): Promise<A> =>\n  Effect.runPromise(effect as Effect.Effect<A, never>);\n\nexport const createExecutionEngine = (config: ExecutionEngineConfig): ExecutionEngine => {\n  const { executor, codeExecutor } = config;\n  const pausedExecutions = new Map<string, InternalPausedExecution>();\n  let nextId = 0;\n\n  /**\n   * Race a running fiber against a pause signal. Returns when either\n   * the fiber completes or an elicitation handler fires (whichever\n   * comes first). Re-used by both executeWithPause and resume.\n   */\n  const awaitCompletionOrPause = (\n    fiber: Fiber.Fiber<ExecuteResult, unknown>,\n    pauseSignal: Deferred.Deferred<InternalPausedExecution>,\n  ): Effect.Effect<ExecutionResult> =>\n    Effect.race(\n      Fiber.join(fiber).pipe(\n        Effect.orDie,\n        Effect.map((result): ExecutionResult => ({ status: \"completed\", result })),\n      ),\n      Deferred.await(pauseSignal).pipe(\n        Effect.map((paused): ExecutionResult => ({ status: \"paused\", execution: paused })),\n      ),\n    );\n\n  /**\n   * Start an execution in pause/resume mode.\n   *\n   * The sandbox is forked as a daemon because paused executions can outlive the\n   * caller scope that returned the first pause, such as an HTTP request handler.\n   */\n  const startPausableExecution = (code: string): Effect.Effect<ExecutionResult> =>\n    Effect.gen(function* () {\n      // Ref holds the current pause signal. The elicitation handler reads\n      // it each time it fires, so resume() can swap in a fresh Deferred\n      // before unblocking the fiber.\n      const pauseSignalRef = yield* Ref.make(yield* Deferred.make<InternalPausedExecution>());\n\n      // Will be set once the fiber is forked.\n      let fiber: Fiber.Fiber<ExecuteResult, unknown>;\n\n      const elicitationHandler: ElicitationHandler = (ctx) =>\n        Effect.gen(function* () {\n          const responseDeferred = yield* Deferred.make<typeof ElicitationResponse.Type>();\n          const id = `exec_${++nextId}`;\n\n          const paused: InternalPausedExecution = {\n            id,\n            elicitationContext: ctx,\n            response: responseDeferred,\n            fiber: fiber!,\n            pauseSignalRef,\n          };\n          pausedExecutions.set(id, paused);\n\n          const currentSignal = yield* Ref.get(pauseSignalRef);\n          yield* Deferred.succeed(currentSignal, paused);\n\n          // Suspend until resume() completes responseDeferred.\n          return yield* Deferred.await(responseDeferred);\n        });\n\n      const invoker = makeFullInvoker(executor, { onElicitation: elicitationHandler });\n      fiber = yield* Effect.forkDaemon(codeExecutor.execute(code, invoker));\n\n      const initialSignal = yield* Ref.get(pauseSignalRef);\n      return yield* awaitCompletionOrPause(fiber, initialSignal);\n    });\n\n  /**\n   * Resume a paused execution. Swaps in a fresh pause signal, completes\n   * the response Deferred to unblock the fiber, then races completion\n   * against the next pause.\n   */\n  const resumeExecution = (\n    executionId: string,\n    response: ResumeResponse,\n  ): Effect.Effect<ExecutionResult | null> =>\n    Effect.gen(function* () {\n      const paused = pausedExecutions.get(executionId);\n      if (!paused) return null;\n      pausedExecutions.delete(executionId);\n\n      // Swap in a fresh pause signal BEFORE unblocking the fiber, so the\n      // next elicitation handler call signals this new Deferred.\n      const nextSignal = yield* Deferred.make<InternalPausedExecution>();\n      yield* Ref.set(paused.pauseSignalRef, nextSignal);\n\n      yield* Deferred.succeed(paused.response, {\n        action: response.action,\n        content: response.content,\n      });\n\n      return yield* awaitCompletionOrPause(paused.fiber, nextSignal);\n    });\n\n  return {\n    execute: async (code, options) => {\n      const invoker = makeFullInvoker(executor, {\n        onElicitation: options.onElicitation,\n      });\n      return runEffect(codeExecutor.execute(code, invoker));\n    },\n\n    executeWithPause: (code) => runEffect(startPausableExecution(code)),\n\n    resume: (executionId, response) => runEffect(resumeExecution(executionId, response)),\n\n    getDescription: () => runEffect(buildExecuteDescription(executor)),\n  };\n};\n"],"mappings":"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","names":["Effect","Effect","parts","Effect"]}