@truefoundry/trueforge-core 0.0.0 → 0.1.0

package/dist/core/runtime/metrics.js

@@ -0,0 +1,89 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/runtime/metrics.ts
+var metrics_exports = {};
+__export(metrics_exports, {
+  AgentThreadMetricsSchema: () => AgentThreadMetricsSchema,
+  addAgentThreadMetrics: () => addAgentThreadMetrics,
+  createEmptyAgentThreadMetrics: () => createEmptyAgentThreadMetrics,
+  updateMetricsFromUsage: () => updateMetricsFromUsage
+});
+module.exports = __toCommonJS(metrics_exports);
+var import_zod_openapi = require("@hono/zod-openapi");
+var AgentThreadMetricsSchema = import_zod_openapi.z.object({
+  total_input_tokens: import_zod_openapi.z.number().int().nonnegative(),
+  total_output_tokens: import_zod_openapi.z.number().int().nonnegative(),
+  total_tokens: import_zod_openapi.z.number().int().nonnegative(),
+  total_cache_read_tokens: import_zod_openapi.z.number().int().nonnegative().optional(),
+  total_cache_write_tokens: import_zod_openapi.z.number().int().nonnegative().optional(),
+  total_reasoning_tokens: import_zod_openapi.z.number().int().nonnegative().optional(),
+  total_cost_in_usd: import_zod_openapi.z.number().nonnegative().optional(),
+  iterations: import_zod_openapi.z.number().int().nonnegative(),
+  total_tool_calls: import_zod_openapi.z.number().int().nonnegative(),
+  total_summarizations: import_zod_openapi.z.number().int().nonnegative(),
+  total_sub_agents: import_zod_openapi.z.number().int().nonnegative()
+}).openapi("AgentThreadMetrics");
+function sumOptional(a, b) {
+  if (a === void 0 && b === void 0) {
+    return void 0;
+  }
+  return (a ?? 0) + (b ?? 0);
+}
+function createEmptyAgentThreadMetrics() {
+  return {
+    total_input_tokens: 0,
+    total_output_tokens: 0,
+    total_tokens: 0,
+    iterations: 0,
+    total_tool_calls: 0,
+    total_summarizations: 0,
+    total_sub_agents: 0
+  };
+}
+function updateMetricsFromUsage(target, usage) {
+  target.total_input_tokens += usage.input_tokens;
+  target.total_output_tokens += usage.output_tokens;
+  target.total_tokens += usage.total_tokens;
+  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, usage.cache_read_tokens);
+  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, usage.cache_write_tokens);
+  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, usage.reasoning_tokens);
+  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, usage.cost_in_usd);
+}
+function addAgentThreadMetrics(target, source) {
+  target.total_input_tokens += source.total_input_tokens;
+  target.total_output_tokens += source.total_output_tokens;
+  target.total_tokens += source.total_tokens;
+  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, source.total_cache_read_tokens);
+  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, source.total_cache_write_tokens);
+  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, source.total_reasoning_tokens);
+  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, source.total_cost_in_usd);
+  target.iterations += source.iterations;
+  target.total_tool_calls += source.total_tool_calls;
+  target.total_summarizations += source.total_summarizations;
+  target.total_sub_agents += source.total_sub_agents;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentThreadMetricsSchema,
+  addAgentThreadMetrics,
+  createEmptyAgentThreadMetrics,
+  updateMetricsFromUsage
+});
+//# sourceMappingURL=metrics.js.map

package/dist/core/runtime/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/runtime/metrics.ts"],"sourcesContent":["import { z } from '@hono/zod-openapi';\nimport type { CompletionUsage } from '../llm/LLMTypes';\n\n/** Billable aggregate — thread/orchestrator totals (`total_*`). */\nexport const AgentThreadMetricsSchema = z\n  .object({\n    total_input_tokens: z.number().int().nonnegative(),\n    total_output_tokens: z.number().int().nonnegative(),\n    total_tokens: z.number().int().nonnegative(),\n    total_cache_read_tokens: z.number().int().nonnegative().optional(),\n    total_cache_write_tokens: z.number().int().nonnegative().optional(),\n    total_reasoning_tokens: z.number().int().nonnegative().optional(),\n    total_cost_in_usd: z.number().nonnegative().optional(),\n    iterations: z.number().int().nonnegative(),\n    total_tool_calls: z.number().int().nonnegative(),\n    total_summarizations: z.number().int().nonnegative(),\n    total_sub_agents: z.number().int().nonnegative(),\n  })\n  .openapi('AgentThreadMetrics');\n\nexport type AgentThreadMetrics = z.infer<typeof AgentThreadMetricsSchema>;\n\nfunction sumOptional(a: number | undefined, b: number | undefined): number | undefined {\n  if (a === undefined && b === undefined) {\n    return undefined;\n  }\n  return (a ?? 0) + (b ?? 0);\n}\n\nexport function createEmptyAgentThreadMetrics(): AgentThreadMetrics {\n  return {\n    total_input_tokens: 0,\n    total_output_tokens: 0,\n    total_tokens: 0,\n    iterations: 0,\n    total_tool_calls: 0,\n    total_summarizations: 0,\n    total_sub_agents: 0,\n  };\n}\n\n/** Fold one per-call completion usage into aggregated thread metrics. */\nexport function updateMetricsFromUsage(target: AgentThreadMetrics, usage: CompletionUsage): void {\n  target.total_input_tokens += usage.input_tokens;\n  target.total_output_tokens += usage.output_tokens;\n  target.total_tokens += usage.total_tokens;\n  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, usage.cache_read_tokens);\n  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, usage.cache_write_tokens);\n  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, usage.reasoning_tokens);\n  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, usage.cost_in_usd);\n}\n\nexport function addAgentThreadMetrics(target: AgentThreadMetrics, source: AgentThreadMetrics): void {\n  target.total_input_tokens += source.total_input_tokens;\n  target.total_output_tokens += source.total_output_tokens;\n  target.total_tokens += source.total_tokens;\n  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, source.total_cache_read_tokens);\n  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, source.total_cache_write_tokens);\n  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, source.total_reasoning_tokens);\n  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, source.total_cost_in_usd);\n  target.iterations += source.iterations;\n  target.total_tool_calls += source.total_tool_calls;\n  target.total_summarizations += source.total_summarizations;\n  target.total_sub_agents += source.total_sub_agents;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAkB;AAIX,IAAM,2BAA2B,qBACrC,OAAO;AAAA,EACN,oBAAoB,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACjD,qBAAqB,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAClD,cAAc,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC3C,yBAAyB,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EACjE,0BAA0B,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EAClE,wBAAwB,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EAChE,mBAAmB,qBAAE,OAAO,EAAE,YAAY,EAAE,SAAS;AAAA,EACrD,YAAY,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACzC,kBAAkB,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC/C,sBAAsB,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACnD,kBAAkB,qBAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AACjD,CAAC,EACA,QAAQ,oBAAoB;AAI/B,SAAS,YAAY,GAAuB,GAA2C;AACrF,MAAI,MAAM,UAAa,MAAM,QAAW;AACtC,WAAO;AAAA,EACT;AACA,UAAQ,KAAK,MAAM,KAAK;AAC1B;AAEO,SAAS,gCAAoD;AAClE,SAAO;AAAA,IACL,oBAAoB;AAAA,IACpB,qBAAqB;AAAA,IACrB,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,sBAAsB;AAAA,IACtB,kBAAkB;AAAA,EACpB;AACF;AAGO,SAAS,uBAAuB,QAA4B,OAA8B;AAC/F,SAAO,sBAAsB,MAAM;AACnC,SAAO,uBAAuB,MAAM;AACpC,SAAO,gBAAgB,MAAM;AAC7B,SAAO,0BAA0B,YAAY,OAAO,yBAAyB,MAAM,iBAAiB;AACpG,SAAO,2BAA2B,YAAY,OAAO,0BAA0B,MAAM,kBAAkB;AACvG,SAAO,yBAAyB,YAAY,OAAO,wBAAwB,MAAM,gBAAgB;AACjG,SAAO,oBAAoB,YAAY,OAAO,mBAAmB,MAAM,WAAW;AACpF;AAEO,SAAS,sBAAsB,QAA4B,QAAkC;AAClG,SAAO,sBAAsB,OAAO;AACpC,SAAO,uBAAuB,OAAO;AACrC,SAAO,gBAAgB,OAAO;AAC9B,SAAO,0BAA0B,YAAY,OAAO,yBAAyB,OAAO,uBAAuB;AAC3G,SAAO,2BAA2B,YAAY,OAAO,0BAA0B,OAAO,wBAAwB;AAC9G,SAAO,yBAAyB,YAAY,OAAO,wBAAwB,OAAO,sBAAsB;AACxG,SAAO,oBAAoB,YAAY,OAAO,mBAAmB,OAAO,iBAAiB;AACzF,SAAO,cAAc,OAAO;AAC5B,SAAO,oBAAoB,OAAO;AAClC,SAAO,wBAAwB,OAAO;AACtC,SAAO,oBAAoB,OAAO;AACpC;","names":[]}

package/dist/core/runtime/metrics.mjs

@@ -0,0 +1,61 @@
+// src/core/runtime/metrics.ts
+import { z } from "@hono/zod-openapi";
+var AgentThreadMetricsSchema = z.object({
+  total_input_tokens: z.number().int().nonnegative(),
+  total_output_tokens: z.number().int().nonnegative(),
+  total_tokens: z.number().int().nonnegative(),
+  total_cache_read_tokens: z.number().int().nonnegative().optional(),
+  total_cache_write_tokens: z.number().int().nonnegative().optional(),
+  total_reasoning_tokens: z.number().int().nonnegative().optional(),
+  total_cost_in_usd: z.number().nonnegative().optional(),
+  iterations: z.number().int().nonnegative(),
+  total_tool_calls: z.number().int().nonnegative(),
+  total_summarizations: z.number().int().nonnegative(),
+  total_sub_agents: z.number().int().nonnegative()
+}).openapi("AgentThreadMetrics");
+function sumOptional(a, b) {
+  if (a === void 0 && b === void 0) {
+    return void 0;
+  }
+  return (a ?? 0) + (b ?? 0);
+}
+function createEmptyAgentThreadMetrics() {
+  return {
+    total_input_tokens: 0,
+    total_output_tokens: 0,
+    total_tokens: 0,
+    iterations: 0,
+    total_tool_calls: 0,
+    total_summarizations: 0,
+    total_sub_agents: 0
+  };
+}
+function updateMetricsFromUsage(target, usage) {
+  target.total_input_tokens += usage.input_tokens;
+  target.total_output_tokens += usage.output_tokens;
+  target.total_tokens += usage.total_tokens;
+  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, usage.cache_read_tokens);
+  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, usage.cache_write_tokens);
+  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, usage.reasoning_tokens);
+  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, usage.cost_in_usd);
+}
+function addAgentThreadMetrics(target, source) {
+  target.total_input_tokens += source.total_input_tokens;
+  target.total_output_tokens += source.total_output_tokens;
+  target.total_tokens += source.total_tokens;
+  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, source.total_cache_read_tokens);
+  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, source.total_cache_write_tokens);
+  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, source.total_reasoning_tokens);
+  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, source.total_cost_in_usd);
+  target.iterations += source.iterations;
+  target.total_tool_calls += source.total_tool_calls;
+  target.total_summarizations += source.total_summarizations;
+  target.total_sub_agents += source.total_sub_agents;
+}
+export {
+  AgentThreadMetricsSchema,
+  addAgentThreadMetrics,
+  createEmptyAgentThreadMetrics,
+  updateMetricsFromUsage
+};
+//# sourceMappingURL=metrics.mjs.map

package/dist/core/runtime/metrics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/runtime/metrics.ts"],"sourcesContent":["import { z } from '@hono/zod-openapi';\nimport type { CompletionUsage } from '../llm/LLMTypes';\n\n/** Billable aggregate — thread/orchestrator totals (`total_*`). */\nexport const AgentThreadMetricsSchema = z\n  .object({\n    total_input_tokens: z.number().int().nonnegative(),\n    total_output_tokens: z.number().int().nonnegative(),\n    total_tokens: z.number().int().nonnegative(),\n    total_cache_read_tokens: z.number().int().nonnegative().optional(),\n    total_cache_write_tokens: z.number().int().nonnegative().optional(),\n    total_reasoning_tokens: z.number().int().nonnegative().optional(),\n    total_cost_in_usd: z.number().nonnegative().optional(),\n    iterations: z.number().int().nonnegative(),\n    total_tool_calls: z.number().int().nonnegative(),\n    total_summarizations: z.number().int().nonnegative(),\n    total_sub_agents: z.number().int().nonnegative(),\n  })\n  .openapi('AgentThreadMetrics');\n\nexport type AgentThreadMetrics = z.infer<typeof AgentThreadMetricsSchema>;\n\nfunction sumOptional(a: number | undefined, b: number | undefined): number | undefined {\n  if (a === undefined && b === undefined) {\n    return undefined;\n  }\n  return (a ?? 0) + (b ?? 0);\n}\n\nexport function createEmptyAgentThreadMetrics(): AgentThreadMetrics {\n  return {\n    total_input_tokens: 0,\n    total_output_tokens: 0,\n    total_tokens: 0,\n    iterations: 0,\n    total_tool_calls: 0,\n    total_summarizations: 0,\n    total_sub_agents: 0,\n  };\n}\n\n/** Fold one per-call completion usage into aggregated thread metrics. */\nexport function updateMetricsFromUsage(target: AgentThreadMetrics, usage: CompletionUsage): void {\n  target.total_input_tokens += usage.input_tokens;\n  target.total_output_tokens += usage.output_tokens;\n  target.total_tokens += usage.total_tokens;\n  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, usage.cache_read_tokens);\n  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, usage.cache_write_tokens);\n  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, usage.reasoning_tokens);\n  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, usage.cost_in_usd);\n}\n\nexport function addAgentThreadMetrics(target: AgentThreadMetrics, source: AgentThreadMetrics): void {\n  target.total_input_tokens += source.total_input_tokens;\n  target.total_output_tokens += source.total_output_tokens;\n  target.total_tokens += source.total_tokens;\n  target.total_cache_read_tokens = sumOptional(target.total_cache_read_tokens, source.total_cache_read_tokens);\n  target.total_cache_write_tokens = sumOptional(target.total_cache_write_tokens, source.total_cache_write_tokens);\n  target.total_reasoning_tokens = sumOptional(target.total_reasoning_tokens, source.total_reasoning_tokens);\n  target.total_cost_in_usd = sumOptional(target.total_cost_in_usd, source.total_cost_in_usd);\n  target.iterations += source.iterations;\n  target.total_tool_calls += source.total_tool_calls;\n  target.total_summarizations += source.total_summarizations;\n  target.total_sub_agents += source.total_sub_agents;\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAIX,IAAM,2BAA2B,EACrC,OAAO;AAAA,EACN,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACjD,qBAAqB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAClD,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC3C,yBAAyB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EACjE,0BAA0B,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EAClE,wBAAwB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EAChE,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS;AAAA,EACrD,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACzC,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EAC/C,sBAAsB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACnD,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AACjD,CAAC,EACA,QAAQ,oBAAoB;AAI/B,SAAS,YAAY,GAAuB,GAA2C;AACrF,MAAI,MAAM,UAAa,MAAM,QAAW;AACtC,WAAO;AAAA,EACT;AACA,UAAQ,KAAK,MAAM,KAAK;AAC1B;AAEO,SAAS,gCAAoD;AAClE,SAAO;AAAA,IACL,oBAAoB;AAAA,IACpB,qBAAqB;AAAA,IACrB,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,sBAAsB;AAAA,IACtB,kBAAkB;AAAA,EACpB;AACF;AAGO,SAAS,uBAAuB,QAA4B,OAA8B;AAC/F,SAAO,sBAAsB,MAAM;AACnC,SAAO,uBAAuB,MAAM;AACpC,SAAO,gBAAgB,MAAM;AAC7B,SAAO,0BAA0B,YAAY,OAAO,yBAAyB,MAAM,iBAAiB;AACpG,SAAO,2BAA2B,YAAY,OAAO,0BAA0B,MAAM,kBAAkB;AACvG,SAAO,yBAAyB,YAAY,OAAO,wBAAwB,MAAM,gBAAgB;AACjG,SAAO,oBAAoB,YAAY,OAAO,mBAAmB,MAAM,WAAW;AACpF;AAEO,SAAS,sBAAsB,QAA4B,QAAkC;AAClG,SAAO,sBAAsB,OAAO;AACpC,SAAO,uBAAuB,OAAO;AACrC,SAAO,gBAAgB,OAAO;AAC9B,SAAO,0BAA0B,YAAY,OAAO,yBAAyB,OAAO,uBAAuB;AAC3G,SAAO,2BAA2B,YAAY,OAAO,0BAA0B,OAAO,wBAAwB;AAC9G,SAAO,yBAAyB,YAAY,OAAO,wBAAwB,OAAO,sBAAsB;AACxG,SAAO,oBAAoB,YAAY,OAAO,mBAAmB,OAAO,iBAAiB;AACzF,SAAO,cAAc,OAAO;AAC5B,SAAO,oBAAoB,OAAO;AAClC,SAAO,wBAAwB,OAAO;AACtC,SAAO,oBAAoB,OAAO;AACpC;","names":[]}

package/dist/core/sandbox/Sandbox.d.ts

@@ -0,0 +1,119 @@
+import type { Logger } from 'winston';
+import { InstructionBuilder } from '../InstructionBuilder';
+import type { MappedMCPTool } from '../mcp/convertMCPServers';
+import { type IToolSet } from '../mcp/IMCPServer';
+import { LocalToolMCP } from '../mcp/LocalToolMCP';
+import type { AgentTracing } from '../tracing/AgentTracing';
+import { type SandboxProvider } from './provider/Provider';
+import type { ISkillMounter } from './skills/ISkillMounter';
+export interface SandboxInfo {
+    sandbox_id: string;
+}
+export declare const SKILL_DOWNLOAD_TIMEOUT_SECONDS = 180;
+export declare function buildWriteAndRunScriptCommand(params: {
+    scriptPath: string;
+    scriptContent: string;
+}): string;
+export interface SandboxStoredFile {
+    filePath: string;
+    sandboxCreated?: SandboxInfo | undefined;
+}
+export interface SandboxOptions {
+    provider: SandboxProvider;
+    existingSandboxId?: string | undefined;
+    skillMounter?: ISkillMounter | undefined;
+    fileDownloadEnabled?: boolean | undefined;
+    /** Pre-resolved credential-store file content (null = clear / no git auth). */
+    resolvedGitCredentialsContent?: string | null | undefined;
+    /**
+     * Blocks destructive tools in code mode so they go through the approval flow
+     * instead. Must be `true` — approvals are always enabled (the kill switch is gone).
+     */
+    blockDestructiveToolsInCodeMode: true;
+    /** Used to derive the Code Mode NATS wait as request + connect. */
+    mcpRequestTimeoutMs: number;
+    mcpConnectTimeoutMs: number;
+    execExtraEnv?: Readonly<Record<string, string>> | undefined;
+    tracing: AgentTracing;
+    logger: Logger;
+}
+export declare const SANDBOX_EXEC_TOOL_NAME = "exec";
+export declare const SANDBOX_SCHEMA_INFER_TAG = "sandbox-schema-infer";
+export declare function createSandboxLargeToolResponseGuidance(): string;
+export declare const SANDBOX_MCP_SERVER_ID = "sandbox";
+export declare class Sandbox extends LocalToolMCP {
+    readonly name = "sandbox";
+    readonly displayName = "Sandbox";
+    readonly description = "Persistent sandbox environment for code execution";
+    static readonly FILE_UPLOADS_DIR = "/tmp/uploads";
+    private readonly provider;
+    private readonly existingSandboxId?;
+    private readonly tenantName;
+    private existingSandboxInfo;
+    private sandboxCreationPromise?;
+    private sandboxInitPromise?;
+    private codeExecToolSets;
+    private readonly fileDownloadEnabled;
+    private readonly requestTimeoutSeconds;
+    private readonly execExtraEnv?;
+    private readonly skillMounter?;
+    private cachedSkillsSection?;
+    private readonly mcpClientScriptBase64;
+    private readonly logger;
+    private readonly resolvedGitCredentialsContent;
+    private codeModeDispatcher;
+    private codeModeTransport;
+    private tools;
+    constructor(options: SandboxOptions);
+    private buildMcpServersEnvelope;
+    protected getTools(): import("..").ToolDefinition[];
+    configureCodeMode(servers: readonly IToolSet[]): void;
+    estimateSkillsTokens(): number;
+    private renderSkillsSection;
+    buildInstruction(builder: InstructionBuilder): void;
+    private buildFileUploadsSection;
+    private buildSchemaSection;
+    private buildFileOutputSection;
+    private buildSkillsSection;
+    private buildMCPSection;
+    private get requiredSandboxInfo();
+    private ensureSandboxCreated;
+    private handleExec;
+    getToolResultDumpDir(): Promise<{
+        dir: string;
+        sandboxCreated: SandboxInfo | undefined;
+    }>;
+    uploadFile(params: {
+        targetDir: string;
+        fileName: string;
+        content: Buffer;
+    }): Promise<{
+        filePath: string;
+        sandboxCreated: SandboxInfo | undefined;
+    }>;
+    uploadUserFile(input: {
+        fileName: string;
+        content: Buffer;
+        mime: string;
+    }): Promise<SandboxStoredFile>;
+    writeArtifact(input: {
+        fileName: string;
+        content: Buffer;
+        sourceTool?: MappedMCPTool | undefined;
+    }): Promise<SandboxStoredFile>;
+    /**
+     * Upload the MCP client Python script to the sandbox on the first tool call.
+     * The sandbox filesystem is persistent within a session, so this only needs to run once.
+     */
+    private ensureSandboxInitialized;
+    private writeGitCredentials;
+    private initSandboxEnvironment;
+    /**
+     * Lazily start Code Mode transport. Single-flight and idempotent inside the transport.
+     * Skipped when code mode was never configured. Connect failures resolve to `undefined`
+     * (no Code Mode env for that exec); mcp_client then errors at call time — no HTTPS fallback.
+     */
+    private ensureCodeModeStarted;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=Sandbox.d.ts.map

package/dist/core/sandbox/Sandbox.d.ts.map

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