@nodetool-ai/agents 0.7.0-rc.23 → 0.8.1

package/dist/index.js

@@ -1,81 +1,174 @@
 /**
  * @nodetool-ai/agents -- Agent system for planning and executing multi-step LLM tasks.
  */
+export { PERMISSION_GATE_CONTEXT_KEY } from "./types.js";
+export { GAME_ASSET_NODE_RUNNER_CONTEXT_KEY } from "./capabilities/game-asset-source.js";
 // Tools
 export { Tool } from "./tools/base-tool.js";
+export { searchTools, formatToolSearchResult, formatDeferredToolsReminder, TOOL_SEARCH_DESCRIPTION } from "./tools/tool-search.js";
 export { FinishStepTool } from "./tools/finish-step-tool.js";
-export { CalculatorTool } from "./tools/calculator-tool.js";
-export { StatisticsTool, GeometryTool, TrigonometryTool, ConversionTool } from "./tools/math-tools.js";
-export { OpenAIWebSearchTool, OpenAIImageGenerationTool, OpenAITextToSpeechTool } from "./tools/openai-tools.js";
-export { ReadFileTool, WriteFileTool, ListDirectoryTool } from "./tools/filesystem-tools.js";
-export { DownloadFileTool, HttpRequestTool } from "./tools/http-tools.js";
-export { EditFileTool, GlobTool, GrepTool } from "./tools/claude-code-tools.js";
-export { RunCodeTool } from "./tools/code-tools.js";
-export { MiniJSAgentTool } from "./tools/js-code-tool.js";
-export { GoogleSearchTool, GoogleNewsTool, GoogleImagesTool } from "./tools/search-tools.js";
-export { GoogleGroundedSearchTool, GoogleImageGenerationTool } from "./tools/google-tools.js";
-export { DataForSEOSearchTool, DataForSEONewsTool, DataForSEOImagesTool } from "./tools/dataseo-tools.js";
-export { SerpApiProvider, DataForSeoProvider } from "./tools/serp-providers/index.js";
-export { BrowserTool, ScreenshotTool, htmlToText } from "./tools/browser-tools.js";
-export { SearchEmailTool, ArchiveEmailTool, AddLabelToEmailTool } from "./tools/email-tools.js";
-export { ListWorkflowsTool, GetWorkflowTool, CreateWorkflowTool, RunWorkflowTool, ValidateWorkflowTool, GetExampleWorkflowTool, ExportWorkflowDigraphTool, ListNodesTool, SearchNodesTool, GetNodeInfoTool, ListJobsTool, GetJobTool, GetJobLogsTool, StartBackgroundJobTool, ListAssetsTool, GetAssetTool, ListModelsTool, getAllMcpTools } from "./tools/mcp-tools.js";
-export { ExtractPDFTextTool, ExtractPDFTablesTool, ConvertPDFToMarkdownTool, ConvertMarkdownToPDFTool, ConvertDocumentTool } from "./tools/pdf-tools.js";
-export { VecTextSearchTool, VecIndexTool, VecHybridSearchTool, VecRecursiveSplitAndIndexTool, VecMarkdownSplitAndIndexTool, VecBatchIndexTool } from "./tools/vector-tools.js";
-export { registerTool, resolveTool, listTools, getAllTools } from "./tools/tool-registry.js";
-export { WorkspaceReadTool, WorkspaceWriteTool, WorkspaceListTool } from "./tools/workspace-tools.js";
-export { ListProviderModelsTool } from "./tools/model-tools.js";
-export { FindModelTool } from "./tools/find-model-tool.js";
-export { GenerateImageTool, EditImageTool, GenerateVideoTool, AnimateImageTool, GenerateSpeechTool, TranscribeAudioTool, EmbedTextTool } from "./tools/media-tools.js";
-export { GENERIC_AI_NODES, CORE_BASELINE_NAMESPACES, PROVIDER_NAMESPACES, buildGraphPlannerSystemPrompt } from "./prompts/graph-planner-prompt.js";
-export { SaveAssetTool, ReadAssetTool } from "./tools/asset-tools.js";
+export { getThreadTodos, clearThreadTodos } from "./tools/todo-tools.js";
+export { IMAGE_CONTENT_FIELD, IMAGE_CONTENTS_FIELD, extractInjectableImages, registerTemporaryImageHandle, stripImagePayload } from "./tools/image-injection.js";
+export { SerpApiProvider, DataForSeoProvider, BraveProvider, ApifyProvider, createSerpProvider } from "./tools/serp-providers/index.js";
+export { createSearchTool, getConfiguredSerpProvider, resolveSerpProvider } from "./tools/serp-tool-factory.js";
+export { htmlToText } from "./tools/browser-tools.js";
+export { getAllMcpTools, createWorkflowDocumentTools } from "./tools/mcp-tools.js";
+export { TOOL_PERMISSION_CATEGORIES, permissionCategoryFor, decidePermission, headlessGate, headlessDenialReason } from "./tools/tool-permissions.js";
+export { gateTools } from "./capabilities/gate-tools.js";
+export { gateFromContext } from "./capabilities/gate-from-context.js";
+export { PERMISSION_CATEGORIES, loadCapabilityModule, listCapabilityModules, loadAllCapabilityModules, findCapability, capabilityCategorySnapshot, capabilityModuleIssues, capabilityModuleDrift, DECLARED_CAPABILITY_MODULES, toolFromCapability, toolFromLazyCapability, toolForCapabilityName, capabilityFromTool, capabilitySpec, capabilityCategoryFor, capabilityModuleOf, listCapabilitySpecs, createCapabilityRun, contextSecretAvailability, resolveCapabilityMessage, UNGATED } from "./capabilities/index.js";
+export { SecurityMonitor, createSecurityMonitorConsult } from "./security-monitor.js";
+export { SECURITY_MONITOR_SYSTEM_PROMPT, buildSecurityMonitorUserPrompt } from "./prompts/security-monitor-prompt.js";
+export { BUILTIN_TOOL_NAMES, availableBuiltinToolNames, getBuiltinTools } from "./tools/builtin-tools.js";
+export { isYtDlpEnabled } from "./yt-dlp-gate.js";
+export { BLENDER_DISABLED_ERROR, isBlenderEnabled } from "./blender-gate.js";
+export { GOOGLE_WORKSPACE_TOOL_NAMES, getGoogleWorkspaceTools } from "./tools/google-workspace-tools.js";
+export { APIFY_TOOL_NAMES, SERPAPI_TOOL_NAMES, getApifyTools, getSerpApiTools } from "./tools/external-capability-tools.js";
+export { getMediaTools } from "./tools/media-tools.js";
+export { persistOutput, workspaceDir as workspaceDirFromContext, inferImageMime, timestampedName, MIME_TO_EXT } from "./tools/asset-persist.js";
+export { GENERIC_AI_NODES, CORE_BASELINE_NAMESPACES, WORKFLOW_AUTHORING_KNOWLEDGE, renderWorkflowAuthoringKnowledge, resolveAvailableGenericNodes } from "./prompts/workflow-authoring-knowledge.js";
+export { NODETOOL_PRODUCT_KNOWLEDGE } from "./prompts/product-knowledge.js";
+export { installedSandboxPacks } from "./prompts/sandbox-pack-catalog.js";
 export { ControlNodeTool, sanitizeToolName } from "./tools/control-tool.js";
-export { CreatePlanTool } from "./tools/create-plan-tool.js";
-export { CreateTaskPlanTool } from "./tools/create-task-tool.js";
+export { runSubAgent, forwardSubAgentStream, tagSubAgentMessage, settleStepResult, enterSubAgentDepth, SubAgentTool, DEFAULT_SUBAGENT_MAX_DEPTH } from "./subagent.js";
+export { RunSubtaskTool, SUBTASK_DEPTH_KEY, TOOL_CALL_ID_FIELD } from "./tools/run-subtask-tool.js";
+export { StartSubtaskTool } from "./tools/start-subtask-tool.js";
+export { WaitSubtasksTool } from "./tools/wait-subtasks-tool.js";
+export { BackgroundSubtaskRegistry, DEFAULT_WAIT_TIMEOUT_MS, MAX_WAIT_TIMEOUT_MS } from "./background-subtasks.js";
+export { RunSearchTool, READ_ONLY_TOOL_NAMES } from "./tools/run-search-tool.js";
+export { buildReadOnlySearchPrompt, READ_ONLY_SEARCH_DESCRIPTION } from "./prompts/read-only-search-prompt.js";
 export { PlanBuilder, AddTaskTool, RemoveTaskTool, FinishPlanTool } from "./tools/plan-builder-tools.js";
-export { isAgenticProvider, rejectAgenticProvider } from "./reject-agentic-provider.js";
-// Graph-native planner tools
-export { AddNodeTool } from "./tools/add-node-tool.js";
-export { AddEdgeTool } from "./tools/add-edge-tool.js";
-export { FinishGraphTool } from "./tools/finish-graph-tool.js";
-export { LocalSearchNodesTool } from "./tools/local-search-nodes-tool.js";
-export { LocalGetNodeInfoTool } from "./tools/local-get-node-info-tool.js";
-export { LocalListNodesTool } from "./tools/local-list-nodes-tool.js";
 // Shared JS sandbox engine
-export { buildSandbox, runInSandbox, serializeResult } from "./js-sandbox.js";
+export { buildSandbox, runInSandbox, serializeResult, resolveSandboxLimits, createSandboxClock } from "./js-sandbox.js";
+export { DEFAULT_TIMEOUT_MS, MAX_OUTPUT_SIZE, MAX_LOOP_ITERATIONS, DEFAULT_SUSPEND_ALLOWANCE_MS, EXPOSED_BRIDGE_NAMES, GUEST_HELPER_NAMES, RESERVED_SANDBOX_NAMES } from "./js-sandbox.js";
+// Mounting NodeTool's own guest modules (`@nodetool-ai/sandbox-nodetool/*`)
+// for one body. The Code node calls this through its hidden import of this
+// package, the way it already loads the toolbelt.
+export { mountCapabilityModules } from "./codeact/capability-modules.js";
+export { ungatedCapabilityRun } from "./capabilities/invoke.js";
+// Code Node authoring: the sandbox capability manifest and prompt rendering
+export { getSandboxManifest, sandboxManifestNames, SANDBOX_MANIFEST_NODE_TYPE } from "./code-gen/sandbox-manifest.js";
+export { renderSandboxApiReference, extractApiReferences, unknownApiReferences } from "./code-gen/sandbox-prompt.js";
+export { buildCodeGenSystemPrompt, buildCodeGenUserPrompt, buildCodeGenRetryPrompt } from "./code-gen/prompt.js";
+export { analyzeGeneratedCode, collectBoundNames } from "./code-gen/analyze.js";
+export { SubmitCodeTool } from "./tools/submit-code-tool.js";
+export { CodePlanner } from "./code-planner.js";
 // Constants
-export { DEFAULT_TOKEN_LIMIT, MAX_TOOL_RESULT_CHARS } from "./constants.js";
+export { DEFAULT_MAX_CONCURRENT_AGENTS, DEFAULT_MAX_STEP_ITERATIONS, MAX_TOOL_RESULT_CHARS, truncateToolResult } from "./constants.js";
 // Utilities
 export { extractJSON } from "./utils/json-parser.js";
 export { removeBase64Images } from "./utils/remove-base64-images.js";
 export { wrapGeneratorsParallel } from "./utils/wrap-generators-parallel.js";
 // Core execution
-export { StepExecutor } from "./step-executor.js";
-export { AgentExecutor, FinishTool, jsonSchemaForOutputType } from "./agent-executor.js";
-// Agents
-export { BaseAgent } from "./base-agent.js";
-export { SimpleAgent } from "./simple-agent.js";
-export { Agent, loadSkillsFromDirectory } from "./agent.js";
-export { MultiModeAgent } from "./multi-mode-agent.js";
-export { SubAgentPlanner } from "./sub-agent-planner.js";
+export { CodeActExecutor, DEFAULT_CODEACT_MAX_ITERATIONS, EXECUTE_CODE_TOOL_NAME, CODEACT_RESIDENT_TOOL_NAMES, CODEACT_DEFER_THRESHOLD } from "./codeact/codeact-executor.js";
+export { buildCodeActSystemPrompt } from "./codeact/prompt.js";
+export { MCP_GUEST_CONTRACT, MCP_SANDBOX_ACTION_SNIPPET, MCP_SANDBOX_ASSET_SNIPPET, MCP_SANDBOX_PROBE_SNIPPET, MCP_SANDBOX_RESOURCE_URI, MCP_SANDBOX_PROMPTS, buildMcpSandboxCatalog } from "./codeact/mcp-guest-contract.js";
+export { sandboxPackageSkills, wrapUntrustedPackageDocs } from "./codeact/sandbox-package-docs.js";
+export { SANDBOX_PACKAGE_DOCS_TOOL_NAME, SANDBOX_PACKAGE_LIST_TOOL_NAME, sandboxPackageDocsTool, sandboxPackageListTool } from "./capabilities/packs.js";
+export { scanModuleExports } from "./codeact/sandbox-package-listing.js";
+export { buildToolBridge, renderToolCatalog, renderToolSignature, toolSignature, CODEACT_PRELUDE, CODEACT_INJECTED_GLOBALS, DEFAULT_MAX_TOOL_CALLS_PER_ACTION } from "./codeact/tool-api.js";
+export { assembleSandboxToolbelt, sandboxToolBridgeGlobals, NODETOOL_PRELUDE } from "./sandbox-toolbelt.js";
+export { compactResourceIds, compactAssetUris } from "./codeact/compact-ids.js";
+export { createChatCodeActSession } from "./codeact/chat-codeact.js";
+export { GRAPH_MODEL_PRELUDE, GRAPH_MODEL_PROMPT_SECTION, GRAPH_MODEL_TOOL_NAMES, hasGraphModelTools } from "./codeact/graph-model.js";
+export { NODETOOL_API_NAMESPACE_TOOLS, NODETOOL_API_PRELUDE_FULL, buildNodetoolApiPromptSection, hasNodetoolApiTools, nodetoolApiCoveredToolNames } from "./codeact/nodetool-api.js";
+export { installedPackAllowlist, sandboxPackagesForChat } from "./codeact/sandbox-packages.js";
+export { GRAPH_DSL_PACKAGE, GRAPH_DSL_PROMPT_SECTION, hasGraphDslTools, withGraphDslPackage } from "./codeact/graph-dsl-package.js";
+export { FABRIC_PACKAGE, FABRIC_PROMPT_SECTION, catalogServesFabric, withFabricPackage } from "./codeact/fabric-package.js";
+// Skills in the prompt: the always-on catalog, and the bodies a `/name`
+// invocation pulls in.
+export { findInvokedSkillNames, formatSkillCatalogForPrompt, formatInvokedSkillsForPrompt } from "./skill-prompt.js";
+// The skills that ship with the build, and the merge that puts them in the
+// same catalog as the user's own rows.
+export { loadSystemSkills, findSystemSkill, isSystemSkillName, mergeSystemSkills, systemSkillsDir, parseSkillMarkdown, clearSystemSkillCache } from "./system-skills.js";
+// Which shipped prompting skill covers a model line — `find_model` attaches
+// the answer to every matching route.
+export { MODEL_PROMPTING_SKILLS, promptingSkillFor } from "./model-prompting-skills.js";
+export { formatMemoriesForPrompt } from "./tools/memory-tools.js";
 // Planning & orchestration
 export { TaskPlanner } from "./task-planner.js";
 export { TaskExecutor } from "./task-executor.js";
 export { ParallelTaskExecutor } from "./parallel-task-executor.js";
+// GraphPlanner evaluation harness
+export { runGraphPlannerEval, formatEvalReport, checkExpectations } from "./evals/graph-planner-eval.js";
+export { GRAPH_PLANNER_EVAL_CASES } from "./evals/graph-planner-cases.js";
+// End-to-end graph evaluation harness (plan → execute → judge)
+export { runGraphE2eEval, formatGraphE2eReport, checkRunOutputs, outputsByName, previewOutputValue } from "./evals/graph-e2e-eval.js";
+export { GRAPH_E2E_EVAL_CASES } from "./evals/graph-e2e-cases.js";
+export { judgeGoalAchievement, parseJudgeVerdict, renderValueForJudge } from "./evals/goal-judge.js";
+// Code node authoring evaluation harness (CodePlanner)
+export { runCodeGenEval, formatCodeGenReport, checkCodeGenExpectations } from "./evals/code-gen-eval.js";
+export { CODE_GEN_EVAL_CASES } from "./evals/code-gen-cases.js";
+// Tool-loop evaluation harness (frontend ui_* tool surface)
+export { runToolLoopEval, formatToolLoopReport, checkToolLoopExpectations } from "./evals/tool-loop-eval.js";
+export { createToolLoopBridge, DEFAULT_TOOL_NAMES } from "./evals/tool-loop-bridge.js";
+export { TOOL_LOOP_EVAL_CASES, TOOL_LOOP_NODE_CATALOG } from "./evals/tool-loop-cases.js";
+export { scoreToolLoopChecks, countCriticalFailures, CRITICAL_FAILURE_SCORE_CAP } from "./evals/tool-loop-eval.js";
+// Interactive escalation: an `ask_user` tool backed by a scripted user, plus
+// the workflow-tool cases that require escalating before acting.
+export { createEscalationChannel, checkEscalationExpectations, DEFAULT_ESCALATION_TOOL_NAME } from "./evals/escalation.js";
+export { WORKFLOW_ESCALATION_TOOL_LOOP_CASES } from "./evals/escalation-cases.js";
+// Editor-surface tool-loop suites (script, sketch, timeline, storyboard, 3D)
+export { createScriptToolBridge, SCRIPT_TOOL_LOOP_CASES } from "./evals/surfaces/script.js";
+export { gradeCodeCases, deepEqual as codeCaseDeepEqual } from "./capabilities/code-grading.js";
+export { createJsScriptToolBridge, JS_SCRIPT_TOOL_LOOP_CASES } from "./evals/surfaces/js-script.js";
+export { createSketchToolBridge, getLastSketchToolBridge, SKETCH_TOOL_LOOP_CASES } from "./evals/surfaces/sketch.js";
+export { createTimelineToolBridge, TIMELINE_TOOL_LOOP_CASES } from "./evals/surfaces/timeline.js";
+export { createStoryboardToolBridge, STORYBOARD_TOOL_LOOP_CASES } from "./evals/surfaces/storyboard.js";
+export { createModel3DToolBridge, MODEL3D_TOOL_LOOP_CASES } from "./evals/surfaces/model3d.js";
+export { createAppToolBridge, APP_TOOL_LOOP_CASES } from "./evals/surfaces/app.js";
+export { runToolLoop, DEFAULT_MAX_ITERATIONS as DEFAULT_TOOL_LOOP_ITERATIONS } from "./app-build/tool-loop.js";
+export { createMemoryToolBridge, MEMORY_TOOL_LOOP_CASES } from "./evals/surfaces/memory.js";
+export { createCreativePipelineBridge, CREATIVE_PIPELINE_TOOL_LOOP_CASES, ATLAS_BRIEF, LANTERN_BRIEF } from "./evals/surfaces/creative-pipeline.js";
+// Sub-agent execution evaluation harness (RunSubtaskTool + inherited toolset)
+export { runSubtaskEval, formatSubtaskReport, checkSubtaskExpectations } from "./evals/subtask-eval.js";
+export { SUBTASK_EVAL_CASES, createInstrumentedTools, createToolRecorder, INSTRUMENTED_TOOL_NAMES } from "./evals/subtask-cases.js";
+// CodeAct evaluation harness (code actions vs JSON tool calls)
+export { runCodeActEval, formatCodeActReport, checkCodeActExpectations } from "./evals/codeact-eval.js";
+export { CODEACT_EVAL_CASES, createCodeActTools, createCodeActRecorder } from "./evals/codeact-cases.js";
+export { CODEACT_API_EVAL_CASES, uncoveredNodetoolApiNamespaces } from "./evals/codeact-api-cases.js";
+export { CODEACT_API_CORE_CASES } from "./evals/codeact-api-core.js";
+export { CODEACT_API_SURFACE_CASES } from "./evals/codeact-api-surfaces.js";
+export { CODEACT_SANDBOX_PACK_EVAL_CASES, SANDBOX_PACK_DOCS_TOOL, shippedPackCatalog } from "./evals/codeact-sandbox-pack-cases.js";
+// Planning-mode evaluation harness (TaskPlanner DAG)
+export { runTaskPlannerEval, formatTaskPlanReport, checkTaskPlanExpectations, criticalPathDepth, AGENT_NODE_SYSTEM_PROMPT } from "./evals/task-planner-eval.js";
+export { TASK_PLANNER_EVAL_CASES } from "./evals/task-planner-cases.js";
+export { createPlannerTools, PLANNER_TOOL_NAMES } from "./evals/planner-tools.js";
+// Mini-app build evaluation harness (`nodetool eval app-build`)
+export { runAppBuildEval, formatAppBuildReport, checkAppBuild, APP_BUILD_TRAITS } from "./evals/app-build-eval.js";
+export { APP_BUILD_EVAL_CASES, APP_BUILD_DETERMINISTIC_CASE_IDS, uncoveredAppBuildTraits } from "./evals/app-build-cases.js";
 // Graph-native planning & execution
-export { GraphBuilder, AGENT_STEP_NODE_TYPE } from "./graph-builder.js";
-export { GraphPlanner } from "./graph-planner.js";
-export { AgentStepExecutor } from "./agent-step-executor.js";
-export { AgentWorkflowRunner } from "./agent-workflow-runner.js";
-// Multi-agent team system
-export { 
-// In-memory implementations
-MessageBus, TaskBoard, 
-// Edge-native implementations
-EdgeMessageBus, EdgeTaskBoard, 
-// DB-backed implementation
-DbTaskBoard, 
-// Orchestration
-TeamExecutor, 
-// Tools
-createTeamTools, SendMessageTool, BroadcastTool, CheckMessagesTool, CreateTaskTool, ListTasksTool, ClaimTaskTool, CompleteTaskTool, FailTaskTool, DecomposeTaskTool } from "./team/index.js";
+export { evaluateGraphDsl } from "./graph-dsl.js";
+export { GraphBuilder, AGENT_NODE_TYPE } from "./graph-builder.js";
+export { declareDynamicSlotsFromEdges, toSlotTypeRecord } from "./dynamic-slots.js";
+export { normalizeModelProperties } from "./normalize-model-properties.js";
+export { authorGraph, AUTHOR_GRAPH_MAX_ITERATIONS } from "./author-graph.js";
+export { applyRunPolicy } from "./run-policy.js";
+export { SupervisorAgent, DEFAULT_MAX_SUPERVISOR_COST_USD, DEFAULT_SUPERVISOR_MAX_OUTPUT_TOKENS } from "./supervisor/supervisor-agent.js";
+export { buildVerdictSchema } from "./supervisor/verdict-schema.js";
+export { buildSupervisorPrompt } from "./supervisor/prompt.js";
+export { createSupervisorTools, GetRunStateTool, ReadNodeOutputTool } from "./supervisor/tools.js";
+export { validateAgainstSchema, formatViolations } from "./utils/json-schema-validate.js";
+export { issueFingerprint } from "./app-build/types.js";
+export { BUILD_SPEC_SCHEMA, buildSpecPrompt, operationsExercised, parseBuildSpec, resolveSpecWidget, runSpecStage, specFromFile, validateBuildSpec } from "./app-build/spec.js";
+export { completeInteractions } from "./app-build/interactions.js";
+export { runAuthorStage, renderAuthorSystemPrompt, renderComplaintPrompt, AUTHORED_APP_ID, DEFAULT_AUTHOR_TURNS } from "./app-build/author.js";
+export { buildApp, DEFAULT_MAX_REPAIRS, DEFAULT_BUILD_TIMEOUT_MS, DEFAULT_BUILD_COST_CAP_USD } from "./app-build/build.js";
+export { DEFAULT_JUDGE_TIMEOUT_MS, JUDGE_MODEL_CANDIDATES, judgeInteraction, parseJudgeAnswer, renderJudgePrompt, resolveJudgeModelSpec, runJudgeStage } from "./app-build/judge.js";
+export { renderBuildReportMarkdown } from "./app-build/markdown.js";
+// The build as a service: what `POST /api/applications/build` calls, minus
+// request parsing.
+export { runApplicationBuild } from "./app-build/build-service.js";
+// The Code-body executor `run_code`/`test_code` share (hermetic), and what
+// the JS-script run endpoint executes a script document with (with the
+// Code-node toolbelt).
+export { runCodeBody } from "./capabilities/code.js";
+export { bakeCustomAnimation, CUSTOM_ANIMATION_BAKE_TIMEOUT_SECONDS } from "./custom-animation-bake.js";
+export { createJsScriptAppRunner } from "./js-script-app-runner.js";
+// Jobs to be done — the agent-intent layer. Each job is one objective taken end
+// to end across whatever surfaces it needs, recorded in full (transcript, tool
+// calls, outcome, friction) so an outer agent can diagnose the run and propose
+// a fix to the harness or the prompt. See `src/jtbd/types.ts`.
+export { JOBS_TO_BE_DONE, findJob, defineJob, runJob, runJobSuite, deriveFriction, optimizeFromRun, renderRunForReview, parseProposals, DEFAULT_JOB_SYSTEM_PROMPT } from "./jtbd/index.js";
+export { ExternalMcpTool, McpClientPool, getCachedExternalMcpTools, getExternalMcpTools, normalizeCallResult } from "./tools/external-mcp-tools.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/js-sandbox-worker/host.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Main-thread side of the off-thread QuickJS sandbox.
+ *
+ * It resolves the worker entry for whichever environment the process is in,
+ * keeps a small warm pool, and serves every bridge call the guest makes as an
+ * RPC over the port. Cancellation is `worker.terminate()`, immediately: it is
+ * equally instant for a spinning guest and a parked one, and the logs and
+ * emitted values already live in the main-thread accumulators — port FIFO
+ * delivered every RPC the guest made before the abort. The deadline backstop
+ * terminates a worker that answers nothing at all.
+ *
+ * This is the one module in `js-sandbox-worker/` that reaches for Node, and it
+ * does so through `importNodeBuiltin`, so importing it off Node resolves
+ * nothing and the caller falls back in-process.
+ */
+import { SANDBOX_DISPATCHER_BINDINGS, type HostToWorkerMessage, type ResultMessage, type RunMessage, type WorkerToHostMessage } from "./protocol.js";
+/** Workers alive at once. A fifth concurrent run waits for a free one. */
+export declare const MAX_SANDBOX_WORKERS = 4;
+/** Slack on top of the run's own budget before the backstop fires. */
+export declare const DEADLINE_MARGIN_MS = 5000;
+export type WorkerEntry = {
+    /** A compiled entry: hand the file URL straight to `new Worker()`. */
+    readonly kind: "file";
+    readonly href: string;
+} | {
+    /**
+     * A TypeScript entry (tsx dev, vitest). The worker starts from an eval'd
+     * bootstrap that registers tsx's transform and then imports the entry —
+     * tsx's own `--import` hook deliberately skips worker threads, and
+     * Node's built-in strip-only loader rejects the syntax the workspace
+     * packages use, so the explicit `tsx/esm/api` registration is the one
+     * path that works.
+     */
+    readonly kind: "bootstrap";
+    readonly href: string;
+    /** File URL of `tsx/esm/api`, resolved from this package. */
+    readonly tsxApiHref: string;
+    readonly execArgv: readonly string[];
+};
+/**
+ * The worker entry for this environment, or `null` when there is none.
+ *
+ * Three shapes, decided by where this module itself was loaded from:
+ *
+ * | `import.meta.url` ends in | Entry | Mechanism |
+ * |---|---|---|
+ * | `.ts` (tsx, vitest) | sibling `worker-entry.ts` | explicit `execArgv` loading tsx |
+ * | `.js` (compiled `dist/`) | sibling `worker-entry.js` | plain `new Worker(url)` |
+ * | `server.mjs` (esbuild bundle) | `js-sandbox-worker/worker-entry.js` next to it | plain `new Worker(url)` |
+ *
+ * The `.ts` entry wins whenever this module is a `.ts` file, which is what
+ * keeps a stale `dist/` from being loaded under tsx. `execArgv` is passed
+ * explicitly rather than inherited: a vitest worker does not necessarily carry
+ * the loader flags its parent was started with.
+ */
+export declare function resolveWorkerEntry(): Promise<WorkerEntry | null>;
+/** The slice of a worker this module uses, so a test can supply a stub. */
+export interface SandboxWorkerHandle {
+    postMessage(message: HostToWorkerMessage): void;
+    /** Route one message to the active run. Replaces any previous sink. */
+    onMessage(handler: (message: WorkerToHostMessage) => void): void;
+    /** Called when the thread dies — an `error` event or an unexpected `exit`. */
+    onDeath(handler: (error: Error) => void): void;
+    terminate(): void;
+    /**
+     * Hold and release the process for this worker. A leased worker refs, so a
+     * run in flight cannot be cut short by the event loop draining; an idle
+     * pooled worker unrefs, so a warm pool never keeps the process alive on its
+     * own. Optional: a handle with no thread behind it has nothing to manage.
+     */
+    ref?(): void;
+    unref?(): void;
+}
+export type SandboxWorkerFactory = () => Promise<SandboxWorkerHandle | null>;
+/** Spawn a real `worker_threads` worker at the resolved entry. */
+export declare const defaultSandboxWorkerFactory: SandboxWorkerFactory;
+type Lease = {
+    readonly handle: SandboxWorkerHandle;
+    /** Return the worker to the pool, or drop it when the thread is gone. */
+    release(discard: boolean): void;
+};
+/**
+ * Warm workers, one run in flight each.
+ *
+ * Workers are spawned lazily up to the cap and reused after every run: a fresh
+ * QuickJS engine costs a WASM instantiation, so the pool is what keeps a short
+ * run short. A worker that was terminated is dropped rather than reused, and
+ * the next acquire spawns its replacement.
+ */
+export declare class SandboxWorkerPool {
+    private readonly factory;
+    private readonly max;
+    private readonly idle;
+    private readonly waiting;
+    private live;
+    constructor(factory?: SandboxWorkerFactory, max?: number);
+    acquire(): Promise<Lease | null>;
+    /** Terminate every idle worker. In-flight runs keep the ones they hold. */
+    destroy(): void;
+    private take;
+    private spawnChain;
+    private give;
+}
+/** The process-wide pool. A test passes its own instead. */
+export declare function defaultSandboxWorkerPool(): SandboxWorkerPool;
+export interface RunInWorkerOptions {
+    /** The run payload, minus its `type` tag. */
+    readonly run: Omit<RunMessage, "type">;
+    /**
+     * The main-side bridge table an RPC path is looked up in: the same record
+     * `deriveBridgeShape` was given, plus the dispatchers and function globals.
+     * A path resolves member by member and must land on a function.
+     */
+    readonly dispatch: Readonly<Record<string, unknown>>;
+    readonly onLog: (line: string) => void;
+    readonly onProgress: (percent: number, message?: string) => void;
+    readonly signal?: AbortSignal;
+    /** Suspended-time credit; pushed to the worker whenever it moves. */
+    readonly suspendedMs?: () => number;
+    /** Synchronous `stream.open` answer, re-read after every bridge call. */
+    readonly isStreamOpen?: (handle: string) => boolean;
+    readonly pool?: SandboxWorkerPool;
+}
+/**
+ * Run one guest program on a pooled worker and return how it settled.
+ *
+ * The result is always a `ResultMessage`: the guest's own outcome, a cancelled
+ * result synthesized when the abort terminated the thread, or a failed result carrying
+ * whatever killed the thread. The caller maps a `failure: "worker"` message
+ * through `describeEngineFailure`. Returns `null` when no worker could be
+ * acquired at all, which is the caller's signal to run in-process.
+ */
+export declare function runInWorker(options: RunInWorkerOptions): Promise<ResultMessage | null>;
+/** Guest binding names for the dispatchers, re-exported for the caller. */
+export { SANDBOX_DISPATCHER_BINDINGS };
+//# sourceMappingURL=host.d.ts.map

package/dist/js-sandbox-worker/host.d.ts.map

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