The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Resolve sandbox providers from the DB store instead of boot-time env.
debajyoti-truefoundrycfb5f6fa75c3
diff --git a/.github/workflows/generate-sdk.yaml b/.github/workflows/generate-sdk.yamlindex c21d2f5ef..3b6719869 100644--- a/.github/workflows/generate-sdk.yaml+++ b/.github/workflows/generate-sdk.yaml@@ -91,25 +91,10 @@ jobs:echo "needed=false" >> "$GITHUB_OUTPUT"fi- # Pinned in one place so CI and local runs agree; upgrades are manual edits.- - name: Install Fern+ # Same entrypoint as local `pnpm sdk:generate` (re-runs openapi:write; idempotent).+ - name: Generate OpenAPI document and TypeScript SDKif: steps.decide.outputs.needed == 'true'- run: npm install -g "fern-api@$(jq -r .version fern/fern.config.json)"-- - name: Check API is valid- if: steps.decide.outputs.needed == 'true'- run: fern check-- # `--generate-tests` is the only thing that makes Fern emit a full package rather than loose sources.- - name: Generate TypeScript SDK- if: steps.decide.outputs.needed == 'true'- run: fern generate --group ts-sdk --version 0.0.0 --local --generate-tests --log-level debug-- # Fern generates no CI for this output mode, so this is what proves the SDK compiles.- - name: Verify the generated SDK builds- if: steps.decide.outputs.needed == 'true'- working-directory: packages/sdk- run: bash .fern/verify.sh+ run: pnpm sdk:generate# Forks get a read-only token, so only the commit is skipped. TODO: an approval flow that can push to the fork.- name: Commit generated outputdiff --git a/fern/README.md b/fern/README.mdindex 81b418871..74cb3aea5 100644--- a/fern/README.md+++ b/fern/README.md@@ -1,6 +1,7 @@# Fern-OpenAPI and the TypeScript SDK are generated in CI. Edit server routes, not-`openapi/openapi.json` or `packages/sdk`.+OpenAPI and the TypeScript SDK are generated in CI (and locally via+`pnpm sdk:generate`). Edit server routes, not `openapi/openapi.json` or+`packages/sdk`.Bump: 1diff --git a/fern/generators.yml b/fern/generators.ymlindex a6d8a8a9e..9accfdae2 100644--- a/fern/generators.yml+++ b/fern/generators.yml@@ -12,7 +12,7 @@ readme:# Fern keys this lookup on the stream flag, so the string form misses and fails.defaultEndpoint:method: POST- path: /api/v1/sessions/{sessionId}/turns+ path: /api/v1/sessions/{session_id}/turnsstream: trueapi:specs:diff --git a/fern/openapi/openapi.json b/fern/openapi/openapi.jsonindex 649c4c5ca..923f80f20 100644--- a/fern/openapi/openapi.json+++ b/fern/openapi/openapi.json@@ -3543,14 +3543,14 @@"x-fern-sdk-method-name": "create"}},- "/api/v1/sessions/{sessionId}": {+ "/api/v1/sessions/{session_id}": {"delete": {"description": "Delete a session and all related turns, events, and internal state. Idempotent if already gone.","parameters": [{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -3580,7 +3580,7 @@{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -3627,7 +3627,7 @@{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -3699,14 +3699,14 @@"x-fern-sdk-method-name": "update"}},- "/api/v1/sessions/{sessionId}/cancel": {+ "/api/v1/sessions/{session_id}/cancel": {"post": {"description": "Cancel the running last turn for a session.","parameters": [{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -3768,14 +3768,14 @@"x-fern-sdk-method-name": "cancel"}},- "/api/v1/sessions/{sessionId}/events": {+ "/api/v1/sessions/{session_id}/events": {"get": {"description": "List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor.","parameters": [{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -3865,14 +3865,14 @@"x-fern-sdk-method-name": "list_events"}},- "/api/v1/sessions/{sessionId}/turns": {+ "/api/v1/sessions/{session_id}/turns": {"get": {"description": "List turns for a session (newest first by default), token-paginated.","parameters": [{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -3957,7 +3957,7 @@{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -4033,14 +4033,14 @@}}},- "/api/v1/sessions/{sessionId}/turns/{turnId}": {+ "/api/v1/sessions/{session_id}/turns/{turn_id}": {"get": {"description": "Fetch a single turn by ID.","parameters": [{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -4052,7 +4052,7 @@{"description": "Turn identifier.","in": "path",- "name": "turnId",+ "name": "turn_id","required": true,"schema": {"description": "Turn identifier.",@@ -4093,14 +4093,14 @@"x-fern-sdk-method-name": "get_turn"}},- "/api/v1/sessions/{sessionId}/turns/{turnId}/events": {+ "/api/v1/sessions/{session_id}/turns/{turn_id}/events": {"get": {"description": "Paginated persisted events for a turn (insertion order by default).","parameters": [{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -4112,7 +4112,7 @@{"description": "Turn identifier.","in": "path",- "name": "turnId",+ "name": "turn_id","required": true,"schema": {"description": "Turn identifier.",@@ -4200,14 +4200,14 @@"x-fern-sdk-method-name": "list_turn_events"}},- "/api/v1/sessions/{sessionId}/turns/{turnId}/subscribe": {+ "/api/v1/sessions/{session_id}/turns/{turn_id}/subscribe": {"get": {"description": "Subscribe to the live SSE stream for a turn. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).","parameters": [{"description": "Session identifier.","in": "path",- "name": "sessionId",+ "name": "session_id","required": true,"schema": {"description": "Session identifier.",@@ -4219,7 +4219,7 @@{"description": "Turn identifier.","in": "path",- "name": "turnId",+ "name": "turn_id","required": true,"schema": {"description": "Turn identifier.",diff --git a/package.json b/package.jsonindex 4106f37ad..43abe7d1a 100644--- a/package.json+++ b/package.json@@ -23,6 +23,7 @@"smoke": "docker compose up --build --wait && node -e \"Promise.all([fetch('http://127.0.0.1:8791/healthz'), fetch('http://127.0.0.1:8791/')]).then(async ([health, ui]) => { if (!health.ok) throw new Error('healthz returned ' + health.status); const html = await ui.text(); if (!ui.ok || !html.includes('id=\\\"root\\\"')) throw new Error('UI did not return its app shell'); console.log('healthz and UI OK'); })\"","smoke:down": "docker compose down","openapi:write": "pnpm --filter @truefoundry/server openapi:write",+ "sdk:generate": "bash scripts/generate-sdk.sh","ui:shot": "node ui-shots/shot.mjs","ui:clean": "node ui-shots/clean.mjs","pack:dry": "pnpm --filter @truefoundry/utils-core pack:dry",diff --git a/packages/harness/src/core/index.ts b/packages/harness/src/core/index.tsindex 6f0b38d70..c451fcbed 100644--- a/packages/harness/src/core/index.ts+++ b/packages/harness/src/core/index.ts@@ -172,14 +172,8 @@ export type {} from './mcp/auth';// Sandbox (concrete implementation; provider details exported for composition)-export {- DaytonaSandboxProviderSettingsSchema,- SandboxProviderSettingsSchema,- createSandboxProvider,-} from './sandbox/provider/createSandboxProvider';-export type { CreateSandboxProviderInput, SandboxProviderSettings } from './sandbox/provider/createSandboxProvider';export { DaytonaSandboxProvider } from './sandbox/provider/DaytonaProvider';-export type { DaytonaSandboxSettings } from './sandbox/provider/DaytonaProvider';+export type { DaytonaSandboxProviderOptions } from './sandbox/provider/DaytonaProvider';export type { SandboxExecParams, SandboxInit, SandboxProvider } from './sandbox/provider/Provider';export { TFYSandboxProvider } from './sandbox/provider/TFYSandboxProvider';export { SKILL_DOWNLOAD_TIMEOUT_SECONDS, Sandbox, buildWriteAndRunScriptCommand } from './sandbox/Sandbox';diff --git a/packages/harness/src/core/sandbox/Sandbox.ts b/packages/harness/src/core/sandbox/Sandbox.tsindex b48942496..35ed9bd85 100644--- a/packages/harness/src/core/sandbox/Sandbox.ts+++ b/packages/harness/src/core/sandbox/Sandbox.ts@@ -15,7 +15,7 @@ import {} from '../runtime/DeferredTool';import type { AgentTracing } from '../tracing/AgentTracing';import { extractErrorLogFields } from '../util/errorLogFields';-import { SANDBOX_FILE_UPLOADS_DIR, SANDBOX_NATS_WS_PORT } from './constants';+import { DEFAULT_SANDBOX_NATS_WS_PORT, SANDBOX_FILE_UPLOADS_DIR } from './constants';import { ensureExecSuccess, shellEscape, type SandboxProvider } from './provider/Provider';import { validateNoPathTraversal, validateSandboxOwnedByTenant } from './SandboxErrors';import { SandboxNatsBridge } from './SandboxNatsBridge';@@ -145,7 +145,7 @@ function injectMCPClientEnv(params: {TFY_MCP_SERVERS: Buffer.from(JSON.stringify(params.mcpServers)).toString('base64'),}),...(params.natsBridgeSubjectPrefix && {- TFY_NATS_URL: `ws://localhost:${String(SANDBOX_NATS_WS_PORT)}`,+ TFY_NATS_URL: `ws://localhost:${String(DEFAULT_SANDBOX_NATS_WS_PORT)}`,TFY_NATS_SUBJECT_PREFIX: params.natsBridgeSubjectPrefix,// W3C trace context captured per-exec so each NATS request carries the originating// Sandbox: exec span as parent. Without this, MCP spans dispatched via the bridgediff --git a/packages/harness/src/core/sandbox/constants.ts b/packages/harness/src/core/sandbox/constants.tsindex 38d556096..2bc24fc55 100644--- a/packages/harness/src/core/sandbox/constants.ts+++ b/packages/harness/src/core/sandbox/constants.ts@@ -1,5 +1,11 @@/** Stable directory inside the sandbox for user file uploads (mkdir during sandbox init). */export const SANDBOX_FILE_UPLOADS_DIR = '/tmp/uploads';-/** Port of the pod-local NATS WebSocket broker used by the sandbox→gateway MCP bridge. */-export const SANDBOX_NATS_WS_PORT = 4444;+/** Default port of the pod-local NATS WebSocket broker used by the sandbox→gateway MCP bridge. */+export const DEFAULT_SANDBOX_NATS_WS_PORT = 4444;++/**+ * Default lifetime of a Daytona signed preview URL for the NATS bridge.+ * Matches the gateway's default AGENT_RESPONSE_MAX_EXECUTION_TIME_MS (1 hour).+ */+export const DEFAULT_PREVIEW_URL_EXPIRY_SECONDS = 3600;diff --git a/packages/harness/src/core/sandbox/provider/DaytonaProvider.ts b/packages/harness/src/core/sandbox/provider/DaytonaProvider.tsindex 157ca6148..7ba9823a4 100644--- a/packages/harness/src/core/sandbox/provider/DaytonaProvider.ts+++ b/packages/harness/src/core/sandbox/provider/DaytonaProvider.ts@@ -11,6 +11,7 @@ import {SandboxNotAvailableError,SandboxPathIsDirectoryError,} from '../SandboxErrors';+import { DEFAULT_PREVIEW_URL_EXPIRY_SECONDS, DEFAULT_SANDBOX_NATS_WS_PORT } from '../constants';import type { ExecResult, SandboxExecParams, SandboxFileInfo, SandboxProvider } from './Provider';const SANDBOX_NOT_FOUND_STATUS = 404;@@ -24,21 +25,19 @@ function httpUrlToWsUrl(url: string): string {return parsed.toString();}-export interface DaytonaSandboxSettings {+export interface DaytonaSandboxProviderOptions {+ apiKey: string;+ tenantName: string;snapshotName: string;timeoutMs: number;autoStopIntervalInMinutes: number;autoArchiveIntervalInMinutes: number;autoDeleteIntervalInMinutes: number;-}--export interface DaytonaSandboxProviderOptions {- apiKey: string;- tenantName: string;- settings: DaytonaSandboxSettings;- fileMaxBytes: number;- natsBridgePort: number;- previewUrlExpirySeconds: number;+ fileMaxBytesForDownload: number;+ /** Defaults to the built-in sandbox NATS WebSocket port (4444). */+ natsBridgePort?: number;+ /** Defaults to 1 hour (same as the gateway's max agent execution time). */+ previewUrlExpirySeconds?: number;logger: Logger;}@@ -51,8 +50,12 @@ function getDaytonaClient(apiKey: string): Daytona {export class DaytonaSandboxProvider implements SandboxProvider {private readonly apiKey: string;private readonly tenantName: string;- private readonly settings: DaytonaSandboxSettings;- private readonly fileMaxBytes: number;+ private readonly snapshotName: string;+ private readonly timeoutMs: number;+ private readonly autoStopIntervalInMinutes: number;+ private readonly autoArchiveIntervalInMinutes: number;+ private readonly autoDeleteIntervalInMinutes: number;+ private readonly fileMaxBytesForDownload: number;private readonly natsBridgePort: number;private readonly previewUrlExpirySeconds: number;private readonly logger: Logger;@@ -64,10 +67,14 @@ export class DaytonaSandboxProvider implements SandboxProvider {constructor(options: DaytonaSandboxProviderOptions) {this.apiKey = options.apiKey;this.tenantName = options.tenantName;- this.settings = options.settings;- this.fileMaxBytes = options.fileMaxBytes;- this.natsBridgePort = options.natsBridgePort;- this.previewUrlExpirySeconds = options.previewUrlExpirySeconds;+ this.snapshotName = options.snapshotName;+ this.timeoutMs = options.timeoutMs;+ this.autoStopIntervalInMinutes = options.autoStopIntervalInMinutes;+ this.autoArchiveIntervalInMinutes = options.autoArchiveIntervalInMinutes;+ this.autoDeleteIntervalInMinutes = options.autoDeleteIntervalInMinutes;+ this.fileMaxBytesForDownload = options.fileMaxBytesForDownload;+ this.natsBridgePort = options.natsBridgePort ?? DEFAULT_SANDBOX_NATS_WS_PORT;+ this.previewUrlExpirySeconds = options.previewUrlExpirySeconds ?? DEFAULT_PREVIEW_URL_EXPIRY_SECONDS;this.logger = options.logger.child({ module: 'DaytonaProvider' });this.daytona = getDaytonaClient(this.apiKey);}@@ -82,13 +89,13 @@ export class DaytonaSandboxProvider implements SandboxProvider {? await this.restoreExistingSandbox(sandboxId): await this.daytona.create({name: `${this.tenantName}.${randomUUID()}`,- snapshot: this.settings.snapshotName,- autoStopInterval: this.settings.autoStopIntervalInMinutes,- autoArchiveInterval: this.settings.autoArchiveIntervalInMinutes,- autoDeleteInterval: this.settings.autoDeleteIntervalInMinutes,+ snapshot: this.snapshotName,+ autoStopInterval: this.autoStopIntervalInMinutes,+ autoArchiveInterval: this.autoArchiveIntervalInMinutes,+ autoDeleteInterval: this.autoDeleteIntervalInMinutes,});- const entry = { sandbox, defaultTimeoutMs: this.settings.timeoutMs };+ const entry = { sandbox, defaultTimeoutMs: this.timeoutMs };DaytonaSandboxProvider.cachedSandboxes.set(sandbox.name, entry);return entry;}@@ -212,8 +219,8 @@ export class DaytonaSandboxProvider implements SandboxProvider {if (info.isDir) {throw new SandboxPathIsDirectoryError(params.path);}- if (info.size > this.fileMaxBytes) {- throw new SandboxFileTooLargeError(params.path, info.size, this.fileMaxBytes);+ if (info.size > this.fileMaxBytesForDownload) {+ throw new SandboxFileTooLargeError(params.path, info.size, this.fileMaxBytesForDownload);}return await sandbox.fs.downloadFile(params.path);diff --git a/packages/harness/src/core/sandbox/provider/TFYSandboxProvider.ts b/packages/harness/src/core/sandbox/provider/TFYSandboxProvider.tsindex ed3d0a057..acf171eb4 100644--- a/packages/harness/src/core/sandbox/provider/TFYSandboxProvider.ts+++ b/packages/harness/src/core/sandbox/provider/TFYSandboxProvider.ts@@ -27,7 +27,7 @@ export interface TFYSandboxProviderOptions {serverUrl: string;natsBridgeUrl: string;tenantName: string;- fileMaxBytes: number;+ fileMaxBytesForDownload: number;defaultExecTimeoutMs?: number | undefined;logger: Logger;}@@ -41,7 +41,7 @@ export class TFYSandboxProvider implements SandboxProvider {private readonly serverUrl: string;private readonly natsBridgeUrl: string;private readonly tenantName: string;- private readonly fileMaxBytes: number;+ private readonly fileMaxBytesForDownload: number;private readonly defaultExecTimeoutSeconds: number;private readonly logger: Logger;@@ -49,7 +49,7 @@ export class TFYSandboxProvider implements SandboxProvider {this.serverUrl = options.serverUrl.replace(/\/+$/, '');this.natsBridgeUrl = options.natsBridgeUrl;this.tenantName = options.tenantName;- this.fileMaxBytes = options.fileMaxBytes;+ this.fileMaxBytesForDownload = options.fileMaxBytesForDownload;this.defaultExecTimeoutSeconds = Math.ceil((options.defaultExecTimeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1000) / 1000);this.logger = options.logger.child({ module: 'TFYSandboxProvider' });}@@ -127,8 +127,8 @@ export class TFYSandboxProvider implements SandboxProvider {if (info.isDir) {throw new SandboxPathIsDirectoryError(params.path);}- if (info.size > this.fileMaxBytes) {- throw new SandboxFileTooLargeError(params.path, info.size, this.fileMaxBytes);+ if (info.size > this.fileMaxBytesForDownload) {+ throw new SandboxFileTooLargeError(params.path, info.size, this.fileMaxBytesForDownload);}const result = await this.exec({diff --git a/packages/harness/src/core/sandbox/provider/createSandboxProvider.ts b/packages/harness/src/core/sandbox/provider/createSandboxProvider.tsdeleted file mode 100644index 60ff97ad6..000000000--- a/packages/harness/src/core/sandbox/provider/createSandboxProvider.ts+++ /dev/null@@ -1,68 +0,0 @@-/**- * Sandbox provider registry: typed settings (discriminated on `type`) and a- * factory mapping them onto a {@link SandboxProvider}.- *- * Adding a provider = add its settings schema to the union + a case to the- * switch. The switch is exhaustive: since the function declares a- * `SandboxProvider` return type, a union member without a matching case makes- * it no longer return on all paths and fails compilation (TS2366).- */-import type { Logger } from 'winston';-import { z } from 'zod';-import { SANDBOX_NATS_WS_PORT } from '../constants';-import { DaytonaSandboxProvider } from './DaytonaProvider';-import type { SandboxProvider } from './Provider';--/**- * Daytona-backed sandboxes. Keys and defaults match the gateway's- * SANDBOX_SETTINGS JSON (sandboxComposition.ts), plus the `type` discriminator.- */-export const DaytonaSandboxProviderSettingsSchema = z- .object({- type: z.literal('daytona'),- apiKey: z.string().min(1, 'apiKey is required'),- snapshotName: z.string().min(1, 'snapshotName is required'),- timeoutMs: z.number().int().positive().default(60_000),- autoStopIntervalInMinutes: z.number().int().nonnegative().default(5),- autoArchiveIntervalInMinutes: z.number().int().nonnegative().default(60),- autoDeleteIntervalInMinutes: z.number().int().nonnegative().default(43_200),- })- .strict();--/** All supported sandbox backends, discriminated on `type`. */-export const SandboxProviderSettingsSchema = z.discriminatedUnion('type', [DaytonaSandboxProviderSettingsSchema]);--export type SandboxProviderSettings = z.infer<typeof SandboxProviderSettingsSchema>;--export interface CreateSandboxProviderInput {- settings: SandboxProviderSettings;- /** Namespaces sandbox names and ownership checks. */- tenantName: string;- /** Max bytes for a single file download out of the sandbox. */- fileMaxBytes: number;- /** Lifetime of signed preview URLs minted for the sandbox NATS bridge. */- previewUrlExpirySeconds: number;- logger: Logger;-}--/** Builds the provider for the given settings. Construction is cheap and does no I/O. */-export function createSandboxProvider(input: CreateSandboxProviderInput): SandboxProvider {- const { settings } = input;- // Currently only Daytona is registered; switch on settings.type when more backends are added- // so the return type stays exhaustive (TS2366).- return new DaytonaSandboxProvider({- apiKey: settings.apiKey,- tenantName: input.tenantName,- settings: {- snapshotName: settings.snapshotName,- timeoutMs: settings.timeoutMs,- autoStopIntervalInMinutes: settings.autoStopIntervalInMinutes,- autoArchiveIntervalInMinutes: settings.autoArchiveIntervalInMinutes,- autoDeleteIntervalInMinutes: settings.autoDeleteIntervalInMinutes,- },- fileMaxBytes: input.fileMaxBytes,- natsBridgePort: SANDBOX_NATS_WS_PORT,- previewUrlExpirySeconds: input.previewUrlExpirySeconds,- logger: input.logger,- });-}diff --git a/packages/harness/tests/core/sandbox/provider/createSandboxProvider.test.ts b/packages/harness/tests/core/sandbox/provider/createSandboxProvider.test.tsdeleted file mode 100644index 4a50ce02d..000000000--- a/packages/harness/tests/core/sandbox/provider/createSandboxProvider.test.ts+++ /dev/null@@ -1,79 +0,0 @@-/**- * Library-level sandbox provider registry: settings union parsing and the- * settings → provider factory (public harness, no gateway config involved).- */-import {- createSandboxProvider,- SandboxProviderSettingsSchema,-} from '../../../../src/core/sandbox/provider/createSandboxProvider';-import { DaytonaSandboxProvider } from '../../../../src/core/sandbox/provider/DaytonaProvider';-import { makeSilentLogger } from '../../harnessMocks';--describe('SandboxProviderSettingsSchema', () => {- it('parses minimal daytona settings and applies defaults', () => {- const settings = SandboxProviderSettingsSchema.parse({- type: 'daytona',- apiKey: 'key-1',- snapshotName: 'snap-1',- });- expect(settings).toEqual({- type: 'daytona',- apiKey: 'key-1',- snapshotName: 'snap-1',- timeoutMs: 60_000,- autoStopIntervalInMinutes: 5,- autoArchiveIntervalInMinutes: 60,- autoDeleteIntervalInMinutes: 43_200,- });- });-- it('keeps explicit overrides', () => {- const settings = SandboxProviderSettingsSchema.parse({- type: 'daytona',- apiKey: 'key-1',- snapshotName: 'snap-1',- timeoutMs: 5_000,- autoStopIntervalInMinutes: 0,- });- expect(settings.timeoutMs).toBe(5_000);- expect(settings.autoStopIntervalInMinutes).toBe(0);- });-- it('rejects an unknown provider type', () => {- expect(() => SandboxProviderSettingsSchema.parse({ type: 'e2b', apiKey: 'k', snapshotName: 's' })).toThrow();- });-- it('rejects missing apiKey / snapshotName', () => {- expect(() => SandboxProviderSettingsSchema.parse({ type: 'daytona', snapshotName: 's' })).toThrow();- expect(() => SandboxProviderSettingsSchema.parse({ type: 'daytona', apiKey: 'k' })).toThrow();- expect(() => SandboxProviderSettingsSchema.parse({ type: 'daytona', apiKey: '', snapshotName: 's' })).toThrow();- });-- it('rejects unknown keys (strict schema)', () => {- expect(() =>- SandboxProviderSettingsSchema.parse({- type: 'daytona',- apiKey: 'k',- snapshotName: 's',- snapshot_name: 'typo',- }),- ).toThrow();- });-});--describe('createSandboxProvider', () => {- it('builds a DaytonaSandboxProvider for type "daytona"', () => {- const provider = createSandboxProvider({- settings: SandboxProviderSettingsSchema.parse({- type: 'daytona',- apiKey: 'key-1',- snapshotName: 'snap-1',- }),- tenantName: 'tenant-1',- fileMaxBytes: 1024,- previewUrlExpirySeconds: 60,- logger: makeSilentLogger(),- });- expect(provider).toBeInstanceOf(DaytonaSandboxProvider);- });-});diff --git a/packages/sdk/.fern/metadata.json b/packages/sdk/.fern/metadata.jsonindex 04ab6bc9f..cdbdd2d0c 100644--- a/packages/sdk/.fern/metadata.json+++ b/packages/sdk/.fern/metadata.json@@ -26,7 +26,7 @@"streamType": "web","useDefaultRequestParameterValues": true},- "originGitCommit": "c68f72c27b9ce6d2bfd0f7a67be173c1aec5a8cc",+ "originGitCommit": "2b3669cdde6474fd8a7defbb670126df4d0be147","originGitCommitIsDirty": true,"invokedBy": "manual","requestedVersion": "0.0.0",diff --git a/packages/sdk/README.md b/packages/sdk/README.mdindex fae45d4b7..9bb5045e3 100644--- a/packages/sdk/README.md+++ b/packages/sdk/README.md@@ -48,7 +48,7 @@ Instantiate and use the client with the following:import { TrueHarness } from "trueharness";const client = new TrueHarness({ baseUrl: "YOUR_BASE_URL" });-const response = await client.sessions.createTurn("sessionId");+const response = await client.sessions.createTurn("session_id");for await (const item of response) {console.log(item);}@@ -96,7 +96,7 @@ The SDK uses async iterators, so you can consume the responses using a `for awaiimport { TrueHarness } from "trueharness";const client = new TrueHarness({ baseUrl: "YOUR_BASE_URL" });-const response = await client.sessions.createTurn("sessionId");+const response = await client.sessions.createTurn("session_id");for await (const item of response) {console.log(item);}diff --git a/packages/sdk/reference.md b/packages/sdk/reference.mdindex 77bbf9d8d..a36c89853 100644--- a/packages/sdk/reference.md+++ b/packages/sdk/reference.md@@ -305,7 +305,7 @@ await client.sessions.create({</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">get</a>(sessionId) -> TrueHarness.GetSessionResponse</code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">get</a>(session_id) -> TrueHarness.GetSessionResponse</code></summary><dl><dd>@@ -332,7 +332,7 @@ Fetch a session by ID.<dd>```typescript-await client.sessions.get("sessionId");+await client.sessions.get("session_id");```</dd>@@ -348,7 +348,7 @@ await client.sessions.get("sessionId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -368,7 +368,7 @@ await client.sessions.get("sessionId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">delete</a>(sessionId) -> void</code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">delete</a>(session_id) -> void</code></summary><dl><dd>@@ -395,7 +395,7 @@ Delete a session and all related turns, events, and internal state. Idempotent i<dd>```typescript-await client.sessions.delete("sessionId");+await client.sessions.delete("session_id");```</dd>@@ -411,7 +411,7 @@ await client.sessions.delete("sessionId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -431,7 +431,7 @@ await client.sessions.delete("sessionId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">update</a>(sessionId, { ...params }) -> TrueHarness.GetSessionResponse</code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">update</a>(session_id, { ...params }) -> TrueHarness.GetSessionResponse</code></summary><dl><dd>@@ -458,7 +458,7 @@ Update a session's inline agent spec. An empty body is a valid no-op that refres<dd>```typescript-await client.sessions.update("sessionId");+await client.sessions.update("session_id");```</dd>@@ -474,7 +474,7 @@ await client.sessions.update("sessionId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -502,7 +502,7 @@ await client.sessions.update("sessionId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">cancel</a>(sessionId, { ...params }) -> TrueHarness.CancelSessionResponse</code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">cancel</a>(session_id, { ...params }) -> TrueHarness.CancelSessionResponse</code></summary><dl><dd>@@ -529,7 +529,7 @@ Cancel the running last turn for a session.<dd>```typescript-await client.sessions.cancel("sessionId");+await client.sessions.cancel("session_id");```</dd>@@ -545,7 +545,7 @@ await client.sessions.cancel("sessionId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -573,7 +573,7 @@ await client.sessions.cancel("sessionId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listEvents</a>(sessionId, { ...params }) -> core.Page<TrueHarness.SessionEventItem, TrueHarness.ListSessionEventsResponse></code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listEvents</a>(session_id, { ...params }) -> core.Page<TrueHarness.SessionEventItem, TrueHarness.ListSessionEventsResponse></code></summary><dl><dd>@@ -600,7 +600,7 @@ List session events as `{ turn_id, event }` across the active turn branch (newes<dd>```typescript-await client.sessions.listEvents("sessionId");+await client.sessions.listEvents("session_id");```</dd>@@ -616,7 +616,7 @@ await client.sessions.listEvents("sessionId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -644,7 +644,7 @@ await client.sessions.listEvents("sessionId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurns</a>(sessionId, { ...params }) -> core.Page<TrueHarness.Turn, TrueHarness.ListTurnsResponse></code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurns</a>(session_id, { ...params }) -> core.Page<TrueHarness.Turn, TrueHarness.ListTurnsResponse></code></summary><dl><dd>@@ -671,7 +671,7 @@ List turns for a session (newest first by default), token-paginated.<dd>```typescript-await client.sessions.listTurns("sessionId");+await client.sessions.listTurns("session_id");```</dd>@@ -687,7 +687,7 @@ await client.sessions.listTurns("sessionId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -715,7 +715,7 @@ await client.sessions.listTurns("sessionId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurn</a>(sessionId, { ...params }) -> core.Stream<TrueHarness.TurnStreamingEvent></code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurn</a>(session_id, { ...params }) -> core.Stream<TrueHarness.TurnStreamingEvent></code></summary><dl><dd>@@ -743,7 +743,7 @@ Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`).<dd>```typescript-const response = await client.sessions.createTurn("sessionId");+const response = await client.sessions.createTurn("session_id");for await (const item of response) {console.log(item);}@@ -762,7 +762,7 @@ for await (const item of response) {<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -790,7 +790,7 @@ for await (const item of response) {</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">getTurn</a>(sessionId, turnId) -> TrueHarness.GetTurnResponse</code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">getTurn</a>(session_id, turn_id) -> TrueHarness.GetTurnResponse</code></summary><dl><dd>@@ -817,7 +817,7 @@ Fetch a single turn by ID.<dd>```typescript-await client.sessions.getTurn("sessionId", "turnId");+await client.sessions.getTurn("session_id", "turn_id");```</dd>@@ -833,7 +833,7 @@ await client.sessions.getTurn("sessionId", "turnId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -841,7 +841,7 @@ await client.sessions.getTurn("sessionId", "turnId");<dl><dd>-**turnId:** `string` — Turn identifier.+**turn_id:** `string` — Turn identifier.</dd></dl>@@ -861,7 +861,7 @@ await client.sessions.getTurn("sessionId", "turnId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurnEvents</a>(sessionId, turnId, { ...params }) -> core.Page<TrueHarness.SessionEvent, TrueHarness.ListTurnEventsResponse></code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurnEvents</a>(session_id, turn_id, { ...params }) -> core.Page<TrueHarness.SessionEvent, TrueHarness.ListTurnEventsResponse></code></summary><dl><dd>@@ -888,7 +888,7 @@ Paginated persisted events for a turn (insertion order by default).<dd>```typescript-await client.sessions.listTurnEvents("sessionId", "turnId");+await client.sessions.listTurnEvents("session_id", "turn_id");```</dd>@@ -904,7 +904,7 @@ await client.sessions.listTurnEvents("sessionId", "turnId");<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -912,7 +912,7 @@ await client.sessions.listTurnEvents("sessionId", "turnId");<dl><dd>-**turnId:** `string` — Turn identifier.+**turn_id:** `string` — Turn identifier.</dd></dl>@@ -940,7 +940,7 @@ await client.sessions.listTurnEvents("sessionId", "turnId");</dl></details>-<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">subscribeToTurn</a>(sessionId, turnId, { ...params }) -> core.Stream<TrueHarness.TurnStreamingEvent></code></summary>+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">subscribeToTurn</a>(session_id, turn_id, { ...params }) -> core.Stream<TrueHarness.TurnStreamingEvent></code></summary><dl><dd>@@ -967,7 +967,7 @@ Subscribe to the live SSE stream for a turn. Pass `after_sequence_number` to res<dd>```typescript-const response = await client.sessions.subscribeToTurn("sessionId", "turnId");+const response = await client.sessions.subscribeToTurn("session_id", "turn_id");for await (const item of response) {console.log(item);}@@ -986,7 +986,7 @@ for await (const item of response) {<dl><dd>-**sessionId:** `string` — Session identifier.+**session_id:** `string` — Session identifier.</dd></dl>@@ -994,7 +994,7 @@ for await (const item of response) {<dl><dd>-**turnId:** `string` — Turn identifier.+**turn_id:** `string` — Turn identifier.</dd></dl>diff --git a/packages/sdk/src/api/resources/sessions/client/Client.ts b/packages/sdk/src/api/resources/sessions/client/Client.tsindex de5c0b073..19970ebc1 100644--- a/packages/sdk/src/api/resources/sessions/client/Client.ts+++ b/packages/sdk/src/api/resources/sessions/client/Client.ts@@ -248,7 +248,7 @@ export class SessionsClient {/*** Fetch a session by ID.*- * @param {string} sessionId - Session identifier.+ * @param {string} session_id - Session identifier.* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.** @throws {@link TrueHarness.NotFoundError}@@ -256,17 +256,17 @@ export class SessionsClient {* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.get("sessionId")+ * await client.sessions.get("session_id")*/public get(- sessionId: string,+ session_id: string,requestOptions?: SessionsClient.RequestOptions,): core.HttpResponsePromise<TrueHarness.GetSessionResponse> {- return core.HttpResponsePromise.fromPromise(this.__get(sessionId, requestOptions));+ return core.HttpResponsePromise.fromPromise(this.__get(session_id, requestOptions));}private async __get(- sessionId: string,+ session_id: string,requestOptions?: SessionsClient.RequestOptions,): Promise<core.WithRawResponse<TrueHarness.GetSessionResponse>> {const _headers: core.Fetcher.Args["headers"] = mergeHeaders(this._options?.headers, requestOptions?.headers);@@ -274,7 +274,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}`,),method: "GET",headers: _headers,@@ -320,27 +320,27 @@ export class SessionsClient {}}- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/sessions/{sessionId}");+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/sessions/{session_id}");}/*** Delete a session and all related turns, events, and internal state. Idempotent if already gone.*- * @param {string} sessionId - Session identifier.+ * @param {string} session_id - Session identifier.* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.** @throws {@link errors.TrueHarnessError}* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.delete("sessionId")+ * await client.sessions.delete("session_id")*/- public delete(sessionId: string, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<void> {- return core.HttpResponsePromise.fromPromise(this.__delete(sessionId, requestOptions));+ public delete(session_id: string, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<void> {+ return core.HttpResponsePromise.fromPromise(this.__delete(session_id, requestOptions));}private async __delete(- sessionId: string,+ session_id: string,requestOptions?: SessionsClient.RequestOptions,): Promise<core.WithRawResponse<void>> {const _headers: core.Fetcher.Args["headers"] = mergeHeaders(this._options?.headers, requestOptions?.headers);@@ -348,7 +348,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}`,),method: "DELETE",headers: _headers,@@ -375,14 +375,14 @@ export class SessionsClient {_response.error,_response.rawResponse,"DELETE",- "/api/v1/sessions/{sessionId}",+ "/api/v1/sessions/{session_id}",);}/*** Update a session's inline agent spec. An empty body is a valid no-op that refreshes `updated_at`.*- * @param {string} sessionId - Session identifier.+ * @param {string} session_id - Session identifier.* @param {TrueHarness.UpdateSessionRequest} request* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.*@@ -393,18 +393,18 @@ export class SessionsClient {* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.update("sessionId")+ * await client.sessions.update("session_id")*/public update(- sessionId: string,+ session_id: string,request: TrueHarness.UpdateSessionRequest = {},requestOptions?: SessionsClient.RequestOptions,): core.HttpResponsePromise<TrueHarness.GetSessionResponse> {- return core.HttpResponsePromise.fromPromise(this.__update(sessionId, request, requestOptions));+ return core.HttpResponsePromise.fromPromise(this.__update(session_id, request, requestOptions));}private async __update(- sessionId: string,+ session_id: string,request: TrueHarness.UpdateSessionRequest = {},requestOptions?: SessionsClient.RequestOptions,): Promise<core.WithRawResponse<TrueHarness.GetSessionResponse>> {@@ -413,7 +413,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}`,),method: "PATCH",headers: _headers,@@ -496,14 +496,14 @@ export class SessionsClient {_response.error,_response.rawResponse,"PATCH",- "/api/v1/sessions/{sessionId}",+ "/api/v1/sessions/{session_id}",);}/*** Cancel the running last turn for a session.*- * @param {string} sessionId - Session identifier.+ * @param {string} session_id - Session identifier.* @param {TrueHarness.CancelSessionRequest} request* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.*@@ -513,18 +513,18 @@ export class SessionsClient {* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.cancel("sessionId")+ * await client.sessions.cancel("session_id")*/public cancel(- sessionId: string,+ session_id: string,request: TrueHarness.CancelSessionRequest = {},requestOptions?: SessionsClient.RequestOptions,): core.HttpResponsePromise<TrueHarness.CancelSessionResponse> {- return core.HttpResponsePromise.fromPromise(this.__cancel(sessionId, request, requestOptions));+ return core.HttpResponsePromise.fromPromise(this.__cancel(session_id, request, requestOptions));}private async __cancel(- sessionId: string,+ session_id: string,request: TrueHarness.CancelSessionRequest = {},requestOptions?: SessionsClient.RequestOptions,): Promise<core.WithRawResponse<TrueHarness.CancelSessionResponse>> {@@ -533,7 +533,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/cancel`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/cancel`,),method: "POST",headers: _headers,@@ -605,14 +605,14 @@ export class SessionsClient {_response.error,_response.rawResponse,"POST",- "/api/v1/sessions/{sessionId}/cancel",+ "/api/v1/sessions/{session_id}/cancel",);}/*** List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor.*- * @param {string} sessionId - Session identifier.+ * @param {string} session_id - Session identifier.* @param {TrueHarness.ListEventsSessionsRequest} request* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.*@@ -622,10 +622,10 @@ export class SessionsClient {* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.listEvents("sessionId")+ * await client.sessions.listEvents("session_id")*/public async listEvents(- sessionId: string,+ session_id: string,request: TrueHarness.ListEventsSessionsRequest = {},requestOptions?: SessionsClient.RequestOptions,): Promise<core.Page<TrueHarness.SessionEventItem, TrueHarness.ListSessionEventsResponse>> {@@ -647,7 +647,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/events`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/events`,),method: "GET",headers: _headers,@@ -710,7 +710,7 @@ export class SessionsClient {_response.error,_response.rawResponse,"GET",- "/api/v1/sessions/{sessionId}/events",+ "/api/v1/sessions/{session_id}/events",);},);@@ -731,7 +731,7 @@ export class SessionsClient {/*** List turns for a session (newest first by default), token-paginated.*- * @param {string} sessionId - Session identifier.+ * @param {string} session_id - Session identifier.* @param {TrueHarness.ListTurnsSessionsRequest} request* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.*@@ -741,10 +741,10 @@ export class SessionsClient {* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.listTurns("sessionId")+ * await client.sessions.listTurns("session_id")*/public async listTurns(- sessionId: string,+ session_id: string,request: TrueHarness.ListTurnsSessionsRequest = {},requestOptions?: SessionsClient.RequestOptions,): Promise<core.Page<TrueHarness.Turn, TrueHarness.ListTurnsResponse>> {@@ -765,7 +765,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/turns`,),method: "GET",headers: _headers,@@ -828,7 +828,7 @@ export class SessionsClient {_response.error,_response.rawResponse,"GET",- "/api/v1/sessions/{sessionId}/turns",+ "/api/v1/sessions/{session_id}/turns",);},);@@ -851,15 +851,15 @@ export class SessionsClient {* Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`).*/public createTurn(- sessionId: string,+ session_id: string,request: TrueHarness.CreateTurnRequest = {},requestOptions?: SessionsClient.RequestOptions,): core.HttpResponsePromise<core.Stream<TrueHarness.TurnStreamingEvent>> {- return core.HttpResponsePromise.fromPromise(this.__createTurn(sessionId, request, requestOptions));+ return core.HttpResponsePromise.fromPromise(this.__createTurn(session_id, request, requestOptions));}private async __createTurn(- sessionId: string,+ session_id: string,request: TrueHarness.CreateTurnRequest = {},requestOptions?: SessionsClient.RequestOptions,): Promise<core.WithRawResponse<core.Stream<TrueHarness.TurnStreamingEvent>>> {@@ -868,7 +868,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/turns`,),method: "POST",headers: _headers,@@ -961,15 +961,15 @@ export class SessionsClient {_response.error,_response.rawResponse,"POST",- "/api/v1/sessions/{sessionId}/turns",+ "/api/v1/sessions/{session_id}/turns",);}/*** Fetch a single turn by ID.*- * @param {string} sessionId - Session identifier.- * @param {string} turnId - Turn identifier.+ * @param {string} session_id - Session identifier.+ * @param {string} turn_id - Turn identifier.* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.** @throws {@link TrueHarness.NotFoundError}@@ -977,19 +977,19 @@ export class SessionsClient {* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.getTurn("sessionId", "turnId")+ * await client.sessions.getTurn("session_id", "turn_id")*/public getTurn(- sessionId: string,- turnId: string,+ session_id: string,+ turn_id: string,requestOptions?: SessionsClient.RequestOptions,): core.HttpResponsePromise<TrueHarness.GetTurnResponse> {- return core.HttpResponsePromise.fromPromise(this.__getTurn(sessionId, turnId, requestOptions));+ return core.HttpResponsePromise.fromPromise(this.__getTurn(session_id, turn_id, requestOptions));}private async __getTurn(- sessionId: string,- turnId: string,+ session_id: string,+ turn_id: string,requestOptions?: SessionsClient.RequestOptions,): Promise<core.WithRawResponse<TrueHarness.GetTurnResponse>> {const _headers: core.Fetcher.Args["headers"] = mergeHeaders(this._options?.headers, requestOptions?.headers);@@ -997,7 +997,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/turns/${core.url.encodePathParam(turn_id)}`,),method: "GET",headers: _headers,@@ -1047,15 +1047,15 @@ export class SessionsClient {_response.error,_response.rawResponse,"GET",- "/api/v1/sessions/{sessionId}/turns/{turnId}",+ "/api/v1/sessions/{session_id}/turns/{turn_id}",);}/*** Paginated persisted events for a turn (insertion order by default).*- * @param {string} sessionId - Session identifier.- * @param {string} turnId - Turn identifier.+ * @param {string} session_id - Session identifier.+ * @param {string} turn_id - Turn identifier.* @param {TrueHarness.ListTurnEventsSessionsRequest} request* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.*@@ -1065,11 +1065,11 @@ export class SessionsClient {* @throws {@link errors.TrueHarnessTimeoutError}** @example- * await client.sessions.listTurnEvents("sessionId", "turnId")+ * await client.sessions.listTurnEvents("session_id", "turn_id")*/public async listTurnEvents(- sessionId: string,- turnId: string,+ session_id: string,+ turn_id: string,request: TrueHarness.ListTurnEventsSessionsRequest = {},requestOptions?: SessionsClient.RequestOptions,): Promise<core.Page<TrueHarness.SessionEvent, TrueHarness.ListTurnEventsResponse>> {@@ -1099,7 +1099,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}/events`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/turns/${core.url.encodePathParam(turn_id)}/events`,),method: "GET",headers: _headers,@@ -1162,7 +1162,7 @@ export class SessionsClient {_response.error,_response.rawResponse,"GET",- "/api/v1/sessions/{sessionId}/turns/{turnId}/events",+ "/api/v1/sessions/{session_id}/turns/{turn_id}/events",);},);@@ -1184,17 +1184,19 @@ export class SessionsClient {* Subscribe to the live SSE stream for a turn. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).*/public subscribeToTurn(- sessionId: string,- turnId: string,+ session_id: string,+ turn_id: string,request: TrueHarness.SubscribeToTurnSessionsRequest = {},requestOptions?: SessionsClient.RequestOptions,): core.HttpResponsePromise<core.Stream<TrueHarness.TurnStreamingEvent>> {- return core.HttpResponsePromise.fromPromise(this.__subscribeToTurn(sessionId, turnId, request, requestOptions));+ return core.HttpResponsePromise.fromPromise(+ this.__subscribeToTurn(session_id, turn_id, request, requestOptions),+ );}private async __subscribeToTurn(- sessionId: string,- turnId: string,+ session_id: string,+ turn_id: string,request: TrueHarness.SubscribeToTurnSessionsRequest = {},requestOptions?: SessionsClient.RequestOptions,): Promise<core.WithRawResponse<core.Stream<TrueHarness.TurnStreamingEvent>>> {@@ -1207,7 +1209,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}/subscribe`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/turns/${core.url.encodePathParam(turn_id)}/subscribe`,),method: "GET",headers: _headers,@@ -1228,7 +1230,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- `api/v1/sessions/${core.url.encodePathParam(sessionId)}/turns/${core.url.encodePathParam(turnId)}/subscribe`,+ `api/v1/sessions/${core.url.encodePathParam(session_id)}/turns/${core.url.encodePathParam(turn_id)}/subscribe`,),method: "GET",headers: { ..._headers, "Last-Event-ID": lastEventId },@@ -1329,7 +1331,7 @@ export class SessionsClient {_response.error,_response.rawResponse,"GET",- "/api/v1/sessions/{sessionId}/turns/{turnId}/subscribe",+ "/api/v1/sessions/{session_id}/turns/{turn_id}/subscribe",);}}diff --git a/packages/sdk/tests/wire/sessions.test.ts b/packages/sdk/tests/wire/sessions.test.tsindex e96f37588..7871c880e 100644--- a/packages/sdk/tests/wire/sessions.test.ts+++ b/packages/sdk/tests/wire/sessions.test.ts@@ -274,13 +274,13 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId")+ .get("/api/v1/sessions/session_id").respondWith().statusCode(200).jsonBody(rawResponseBody).build();- const response = await client.sessions.get("sessionId");+ const response = await client.sessions.get("session_id");expect(response).toEqual({data: {agentSpec: {@@ -332,14 +332,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId")+ .get("/api/v1/sessions/session_id").respondWith().statusCode(404).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.get("sessionId");+ return await client.sessions.get("session_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -347,9 +347,9 @@ describe("SessionsClient", () => {const server = mockServerPool.createServer();const client = new TrueHarness({ maxRetries: 0, environment: server.baseUrl });- server.mockEndpoint().delete("/api/v1/sessions/sessionId").respondWith().statusCode(200).build();+ server.mockEndpoint().delete("/api/v1/sessions/session_id").respondWith().statusCode(200).build();- const response = await client.sessions.delete("sessionId");+ const response = await client.sessions.delete("session_id");expect(response).toEqual(undefined);});@@ -381,14 +381,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .patch("/api/v1/sessions/sessionId")+ .patch("/api/v1/sessions/session_id").jsonBody(rawRequestBody).respondWith().statusCode(200).jsonBody(rawResponseBody).build();- const response = await client.sessions.update("sessionId");+ const response = await client.sessions.update("session_id");expect(response).toEqual({data: {agentSpec: {@@ -440,7 +440,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .patch("/api/v1/sessions/sessionId")+ .patch("/api/v1/sessions/session_id").jsonBody(rawRequestBody).respondWith().statusCode(400)@@ -448,7 +448,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.update("sessionId");+ return await client.sessions.update("session_id");}).rejects.toThrow(TrueHarnessTypes.BadRequestError);});@@ -460,7 +460,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .patch("/api/v1/sessions/sessionId")+ .patch("/api/v1/sessions/session_id").jsonBody(rawRequestBody).respondWith().statusCode(404)@@ -468,7 +468,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.update("sessionId");+ return await client.sessions.update("session_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -480,7 +480,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .patch("/api/v1/sessions/sessionId")+ .patch("/api/v1/sessions/session_id").jsonBody(rawRequestBody).respondWith().statusCode(422)@@ -488,7 +488,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.update("sessionId");+ return await client.sessions.update("session_id");}).rejects.toThrow(TrueHarnessTypes.UnprocessableEntityError);});@@ -500,14 +500,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/api/v1/sessions/sessionId/cancel")+ .post("/api/v1/sessions/session_id/cancel").jsonBody(rawRequestBody).respondWith().statusCode(200).jsonBody(rawResponseBody).build();- const response = await client.sessions.cancel("sessionId");+ const response = await client.sessions.cancel("session_id");expect(response).toEqual({});});@@ -519,7 +519,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/api/v1/sessions/sessionId/cancel")+ .post("/api/v1/sessions/session_id/cancel").jsonBody(rawRequestBody).respondWith().statusCode(404)@@ -527,7 +527,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.cancel("sessionId");+ return await client.sessions.cancel("session_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -539,7 +539,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/api/v1/sessions/sessionId/cancel")+ .post("/api/v1/sessions/session_id/cancel").jsonBody(rawRequestBody).respondWith().statusCode(412)@@ -547,7 +547,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.cancel("sessionId");+ return await client.sessions.cancel("session_id");}).rejects.toThrow(TrueHarnessTypes.PreconditionFailedError);});@@ -573,7 +573,7 @@ describe("SessionsClient", () => {server.mockEndpoint({ once: false })- .get("/api/v1/sessions/sessionId/events")+ .get("/api/v1/sessions/session_id/events").respondWith().statusCode(200).jsonBody(rawResponseBody)@@ -604,7 +604,7 @@ describe("SessionsClient", () => {previousPageToken: "previous_page_token",},};- const page = await client.sessions.listEvents("sessionId");+ const page = await client.sessions.listEvents("session_id");expect(expected.data).toEqual(page.data);expect(page.hasNextPage()).toBe(true);@@ -620,14 +620,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/events")+ .get("/api/v1/sessions/session_id/events").respondWith().statusCode(400).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.listEvents("sessionId");+ return await client.sessions.listEvents("session_id");}).rejects.toThrow(TrueHarnessTypes.BadRequestError);});@@ -639,14 +639,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/events")+ .get("/api/v1/sessions/session_id/events").respondWith().statusCode(404).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.listEvents("sessionId");+ return await client.sessions.listEvents("session_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -670,7 +670,7 @@ describe("SessionsClient", () => {server.mockEndpoint({ once: false })- .get("/api/v1/sessions/sessionId/turns")+ .get("/api/v1/sessions/session_id/turns").respondWith().statusCode(200).jsonBody(rawResponseBody)@@ -702,7 +702,7 @@ describe("SessionsClient", () => {previousPageToken: "previous_page_token",},};- const page = await client.sessions.listTurns("sessionId");+ const page = await client.sessions.listTurns("session_id");expect(expected.data).toEqual(page.data);expect(page.hasNextPage()).toBe(true);@@ -718,14 +718,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns")+ .get("/api/v1/sessions/session_id/turns").respondWith().statusCode(400).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.listTurns("sessionId");+ return await client.sessions.listTurns("session_id");}).rejects.toThrow(TrueHarnessTypes.BadRequestError);});@@ -737,14 +737,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns")+ .get("/api/v1/sessions/session_id/turns").respondWith().statusCode(404).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.listTurns("sessionId");+ return await client.sessions.listTurns("session_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -757,14 +757,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/api/v1/sessions/sessionId/turns")+ .post("/api/v1/sessions/session_id/turns").jsonBody(rawRequestBody).respondWith().statusCode(200).sseBody(rawResponseBody).build();- const response = await client.sessions.createTurn("sessionId");+ const response = await client.sessions.createTurn("session_id");const events: unknown[] = [];for await (const event of response) {events.push(event);@@ -794,7 +794,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/api/v1/sessions/sessionId/turns")+ .post("/api/v1/sessions/session_id/turns").jsonBody(rawRequestBody).respondWith().statusCode(400)@@ -802,7 +802,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.createTurn("sessionId");+ return await client.sessions.createTurn("session_id");}).rejects.toThrow(TrueHarnessTypes.BadRequestError);});@@ -814,7 +814,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/api/v1/sessions/sessionId/turns")+ .post("/api/v1/sessions/session_id/turns").jsonBody(rawRequestBody).respondWith().statusCode(404)@@ -822,7 +822,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.createTurn("sessionId");+ return await client.sessions.createTurn("session_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -834,7 +834,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/api/v1/sessions/sessionId/turns")+ .post("/api/v1/sessions/session_id/turns").jsonBody(rawRequestBody).respondWith().statusCode(412)@@ -842,7 +842,7 @@ describe("SessionsClient", () => {.build();await expect(async () => {- return await client.sessions.createTurn("sessionId");+ return await client.sessions.createTurn("session_id");}).rejects.toThrow(TrueHarnessTypes.PreconditionFailedError);});@@ -863,13 +863,13 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId")+ .get("/api/v1/sessions/session_id/turns/turn_id").respondWith().statusCode(200).jsonBody(rawResponseBody).build();- const response = await client.sessions.getTurn("sessionId", "turnId");+ const response = await client.sessions.getTurn("session_id", "turn_id");expect(response).toEqual({data: {createdAt: "created_at",@@ -899,14 +899,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId")+ .get("/api/v1/sessions/session_id/turns/turn_id").respondWith().statusCode(404).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.getTurn("sessionId", "turnId");+ return await client.sessions.getTurn("session_id", "turn_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -929,7 +929,7 @@ describe("SessionsClient", () => {server.mockEndpoint({ once: false })- .get("/api/v1/sessions/sessionId/turns/turnId/events")+ .get("/api/v1/sessions/session_id/turns/turn_id/events").respondWith().statusCode(200).jsonBody(rawResponseBody)@@ -957,7 +957,7 @@ describe("SessionsClient", () => {previousPageToken: "previous_page_token",},};- const page = await client.sessions.listTurnEvents("sessionId", "turnId");+ const page = await client.sessions.listTurnEvents("session_id", "turn_id");expect(expected.data).toEqual(page.data);expect(page.hasNextPage()).toBe(true);@@ -973,14 +973,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId/events")+ .get("/api/v1/sessions/session_id/turns/turn_id/events").respondWith().statusCode(400).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.listTurnEvents("sessionId", "turnId");+ return await client.sessions.listTurnEvents("session_id", "turn_id");}).rejects.toThrow(TrueHarnessTypes.BadRequestError);});@@ -992,14 +992,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId/events")+ .get("/api/v1/sessions/session_id/turns/turn_id/events").respondWith().statusCode(404).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.listTurnEvents("sessionId", "turnId");+ return await client.sessions.listTurnEvents("session_id", "turn_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -1012,13 +1012,13 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId/subscribe")+ .get("/api/v1/sessions/session_id/turns/turn_id/subscribe").respondWith().statusCode(200).sseBody(rawResponseBody).build();- const response = await client.sessions.subscribeToTurn("sessionId", "turnId");+ const response = await client.sessions.subscribeToTurn("session_id", "turn_id");const events: unknown[] = [];for await (const event of response) {events.push(event);@@ -1048,14 +1048,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId/subscribe")+ .get("/api/v1/sessions/session_id/turns/turn_id/subscribe").respondWith().statusCode(400).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.subscribeToTurn("sessionId", "turnId");+ return await client.sessions.subscribeToTurn("session_id", "turn_id");}).rejects.toThrow(TrueHarnessTypes.BadRequestError);});@@ -1067,14 +1067,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId/subscribe")+ .get("/api/v1/sessions/session_id/turns/turn_id/subscribe").respondWith().statusCode(404).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.subscribeToTurn("sessionId", "turnId");+ return await client.sessions.subscribeToTurn("session_id", "turn_id");}).rejects.toThrow(TrueHarnessTypes.NotFoundError);});@@ -1086,14 +1086,14 @@ describe("SessionsClient", () => {server.mockEndpoint()- .get("/api/v1/sessions/sessionId/turns/turnId/subscribe")+ .get("/api/v1/sessions/session_id/turns/turn_id/subscribe").respondWith().statusCode(412).jsonBody(rawResponseBody).build();await expect(async () => {- return await client.sessions.subscribeToTurn("sessionId", "turnId");+ return await client.sessions.subscribeToTurn("session_id", "turn_id");}).rejects.toThrow(TrueHarnessTypes.PreconditionFailedError);});});diff --git a/packages/server/.env.example b/packages/server/.env.exampleindex 9f121e605..0741ec09f 100644--- a/packages/server/.env.example+++ b/packages/server/.env.example@@ -59,28 +59,14 @@ PUBLIC_BASE_URL=http://localhost:8790# OAUTH_CLIENT_NAME=truefoundry-harness# ----------------------------------------------------------------------------# Sandbox (optional). When unset, agent specs with config.sandbox.enabled are+# Sandbox process knobs. Provider identity/credentials are configured via+# PUT /api/v1/settings/sandbox-providers (copy from GET .../catalog). Without a+# configured provider, agent specs with config.sandbox.enabled (or skills) are# rejected at session creation.-#-# SANDBOX_SETTINGS is a JSON object discriminated on "type". Supported today:-# {"type":"daytona","snapshotName":"<daytona-snapshot>"}-# Optional daytona fields (defaults): timeoutMs (60000),-# autoStopIntervalInMinutes (5), autoArchiveIntervalInMinutes (60),-# autoDeleteIntervalInMinutes (43200).-#-# The provider API key goes in SANDBOX_API_KEY (recommended, keeps the-# credential out of the JSON blob) or as "apiKey" inside SANDBOX_SETTINGS;-# SANDBOX_API_KEY wins when both are set.# ----------------------------------------------------------------------------# SANDBOX_API_KEY=<daytona-api-key>-# SANDBOX_SETTINGS='{"type": "daytona", "snapshotName":"truefoundry-platform-dev-2d5edee","timeoutMs":60000,"autoStopIntervalInMinutes":5,"autoArchiveIntervalInMinutes":60,"autoDeleteIntervalInMinutes":7200}'--# Max bytes for a single file download out of the sandbox. Default 20 MB.-# SANDBOX_FILE_MAX_BYTES=20971520-# Lifetime of the signed preview URL minted for the sandbox NATS bridge-# (effectively the max duration of one turn's sandbox connection). Default 1 hour.-# SANDBOX_PREVIEW_URL_EXPIRY_SECONDS=3600+# Max bytes for a single file download out of the sandbox. Default 20 MB (same as gateway).+# SANDBOX_FILE_MAX_BYTES_FOR_DOWNLOAD=20971520# ---------------------------------------------------------------------------# Postgres (required). Used by the server pool and by Compose postgresdiff --git a/packages/server/src/apis/sessions.ts b/packages/server/src/apis/sessions.tsindex ab2fd4f22..ae4d700ed 100644--- a/packages/server/src/apis/sessions.ts+++ b/packages/server/src/apis/sessions.ts@@ -20,6 +20,7 @@ import { z } from 'zod';import configuration from '../config';import type { IMcpServerStore } from '../db/mcpServerStore';import type { IModelProviderStore } from '../db/modelProviderStore';+import type { ISandboxProviderStore } from '../db/sandboxProviderStore';import type { ISkillStore } from '../db/skillStore';import {cancelSessionRoute,@@ -31,8 +32,8 @@ import {updateSessionRoute,} from '../routes/sessionRoutes';import type { ActiveTurnRegistry } from '../runtime/activeTurns';-import { validateAgentSpecDb } from '../runtime/dbSessionResources';import { executorFromTurnId } from '../runtime/peeringIds';+import { validateAgentSpec } from '../runtime/sessionResources';import type { Session } from '../schemas/session';/** The server is single-tenant; every record lives under one fixed tenant scope. */@@ -66,7 +67,7 @@ export interface SessionsRouterDeps {modelProviderStore: IModelProviderStore;mcpServerStore: IMcpServerStore;skillStore: ISkillStore;- sandboxSupported: boolean;+ sandboxProviderStore: ISandboxProviderStore;redis?: RedisClientType | undefined;requestReplyRouter: RequestReplyRouter;}@@ -183,13 +184,13 @@ export async function cancelSessionTurn(export function createSessionsRouter(deps: SessionsRouterDeps) {const createSessionHandler: RouteHandler<typeof createSessionRoute> = async c => {const body = c.req.valid('json');- await validateAgentSpecDb({+ await validateAgentSpec({spec: body.agent_spec,tenant_id: TENANT_ID,modelProviderStore: deps.modelProviderStore,mcpServerStore: deps.mcpServerStore,skillStore: deps.skillStore,- sandboxSupported: deps.sandboxSupported,+ sandboxProviderStore: deps.sandboxProviderStore,});const session = await deps.sessions.create({tenant_id: TENANT_ID,@@ -200,7 +201,7 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {};const getSessionHandler: RouteHandler<typeof getSessionRoute> = async c => {- const { sessionId } = c.req.valid('param');+ const { session_id: sessionId } = c.req.valid('param');const record = await deps.sessionStore.getSession({ tenant_id: TENANT_ID, session_id: sessionId });if (!record) {return c.json({ error: { message: `Session not found: ${sessionId}` } }, 404);@@ -209,22 +210,22 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {};const deleteSessionHandler: RouteHandler<typeof deleteSessionRoute> = async c => {- const { sessionId } = c.req.valid('param');+ const { session_id: sessionId } = c.req.valid('param');await deps.sessionStore.deleteSession({ tenant_id: TENANT_ID, session_id: sessionId });return c.body(null, 204);};const updateSessionHandler: RouteHandler<typeof updateSessionRoute> = async c => {- const { sessionId } = c.req.valid('param');+ const { session_id: sessionId } = c.req.valid('param');const body = c.req.valid('json');if (body.agent_spec) {- await validateAgentSpecDb({+ await validateAgentSpec({spec: body.agent_spec,tenant_id: TENANT_ID,modelProviderStore: deps.modelProviderStore,mcpServerStore: deps.mcpServerStore,skillStore: deps.skillStore,- sandboxSupported: deps.sandboxSupported,+ sandboxProviderStore: deps.sandboxProviderStore,});}try {@@ -268,7 +269,7 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {};const cancelSessionHandler: RouteHandler<typeof cancelSessionRoute> = async c => {- const { sessionId } = c.req.valid('param');+ const { session_id: sessionId } = c.req.valid('param');const record = await deps.sessionStore.getSession({ tenant_id: TENANT_ID, session_id: sessionId });if (!record) {return c.json({ error: { message: `Session not found: ${sessionId}` } }, 404);@@ -283,7 +284,7 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {};const listSessionEventsHandler: RouteHandler<typeof listSessionEventsRoute> = async c => {- const { sessionId } = c.req.valid('param');+ const { session_id: sessionId } = c.req.valid('param');const query = c.req.valid('query');const session = await deps.sessions.get({ tenant_id: TENANT_ID, session_id: sessionId });if (!session) {diff --git a/packages/server/src/apis/turns.ts b/packages/server/src/apis/turns.tsindex 35d36a40c..34f37ec3e 100644--- a/packages/server/src/apis/turns.ts+++ b/packages/server/src/apis/turns.ts@@ -21,7 +21,6 @@ import {McpConnectionError,VercelAILLM,type IOAuthTokenStore,- type SandboxProvider,type VercelAIProviderConfig,} from '@truefoundry/utils-core/core';import type { Context } from 'hono';@@ -31,6 +30,7 @@ import type { Logger } from 'winston';import configuration from '../config';import type { IMcpServerStore } from '../db/mcpServerStore';import type { IModelProviderStore } from '../db/modelProviderStore';+import type { ISandboxProviderStore } from '../db/sandboxProviderStore';import type { ISkillStore } from '../db/skillStore';import {createAndExecuteTurnRoute,@@ -40,10 +40,15 @@ import {subscribeTurnRoute,} from '../routes/turnRoutes';import type { ActiveTurnRegistry } from '../runtime/activeTurns';-import { getDbMcpConnection, getDbProviderConfig, resolveDbGitSkills } from '../runtime/dbSessionResources';import { StreamGoneError, type EventSubscriptionRegistry } from '../runtime/event-subscription';import { mintPeeredTurnId } from '../runtime/peeringIds';-import { buildTurnSandbox } from '../runtime/sandboxFactory';+import {+ buildTurnSandbox,+ getMcpConnection,+ getProviderConfig,+ resolveGitSkills,+ resolveSandboxProvider,+} from '../runtime/sessionResources';import { TENANT_ID } from './sessions';export function toWireTurn(record: TurnRecordWithoutSnapshot): Turn {@@ -67,8 +72,7 @@ export interface TurnsRouterDeps {skillStore: ISkillStore;/** Resumable live turn-event transport: create-turn writes, subscribe polls. */eventSubscriptions: EventSubscriptionRegistry<TurnStreamingEvent>;- /** Shared provider from SANDBOX_SETTINGS; undefined = sandbox unsupported. */- sandboxProvider?: SandboxProvider;+ sandboxProviderStore: ISandboxProviderStore;logger: Logger;}@@ -80,14 +84,14 @@ function createTurnResolver(deps: {mcpServerStore: IMcpServerStore;tokenStore: IOAuthTokenStore;skillStore: ISkillStore;- sandboxProvider?: SandboxProvider | undefined;+ sandboxProviderStore: ISandboxProviderStore;logger: Logger;signal: AbortSignal;modelName: string;providerConfig: VercelAIProviderConfig;}): TurnResourceResolver {- const { mcpServerStore, tokenStore, skillStore, logger, signal, modelName, providerConfig } = deps;- const sandboxProvider = deps.sandboxProvider;+ const { mcpServerStore, tokenStore, skillStore, sandboxProviderStore, logger, signal, modelName, providerConfig } =+ deps;return new TurnResourceResolver({llm: name => {if (name !== modelName) {@@ -100,32 +104,39 @@ function createTurnResolver(deps: {});},mcp: async name =>- getDbMcpConnection({+ getMcpConnection({tenant_id: TENANT_ID,name,store: mcpServerStore,tokenStore,clientName: configuration.OAUTH_CLIENT_NAME,}),- ...(sandboxProvider- ? {- sandboxProvider: async ({ spec, existingSandboxId, tracing }) => {- const gitSkills = await resolveDbGitSkills({- tenant_id: TENANT_ID,- skills: spec.skills ?? [],- store: skillStore,- });- return buildTurnSandbox({- provider: sandboxProvider,- logger,- gitSkills,- fileDownloadEnabled: spec.config?.sandbox?.file_downloads ?? false,- existingSandboxId,- tracing,- });- },- }- : {}),+ sandboxProvider: async ({ spec, existingSandboxId, tracing }) => {+ const provider = await resolveSandboxProvider({+ tenant_id: TENANT_ID,+ store: sandboxProviderStore,+ logger,+ });+ if (provider === undefined) {+ throw new HTTPException(422, {+ message: 'no sandbox provider configured — PUT /settings/sandbox-providers',+ });+ }+ const gitSkills = await resolveGitSkills({+ tenant_id: TENANT_ID,+ skills: spec.skills ?? [],+ store: skillStore,+ });+ return buildTurnSandbox({+ provider,+ logger,+ gitSkills,+ fileDownloadEnabled: spec.config?.sandbox?.file_downloads ?? false,+ existingSandboxId,+ tracing,+ tenantName: TENANT_ID,+ });+ },logger,});}@@ -210,7 +221,7 @@ export function resolveAfterSequenceNumber(c: Context, bodyAfterSequenceNumber?:/** DB-backed turns (mounted at /api/v1/sessions). */export function createTurnsRouter(deps: TurnsRouterDeps) {const listTurnsHandler: RouteHandler<typeof listTurnsRoute> = async c => {- const { sessionId } = c.req.valid('param');+ const { session_id: sessionId } = c.req.valid('param');const query = c.req.valid('query');const session = await deps.sessions.get({ tenant_id: TENANT_ID, session_id: sessionId });if (!session) {@@ -231,7 +242,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {};const getTurnHandler: RouteHandler<typeof getTurnRoute> = async c => {- const { sessionId, turnId } = c.req.valid('param');+ const { session_id: sessionId, turn_id: turnId } = c.req.valid('param');const turn = await TurnHandle.get({store: deps.sessionStore,session_id: sessionId,@@ -244,7 +255,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {};const listTurnEventsHandler: RouteHandler<typeof listTurnEventsRoute> = async c => {- const { sessionId, turnId } = c.req.valid('param');+ const { session_id: sessionId, turn_id: turnId } = c.req.valid('param');const query = c.req.valid('query');const turn = await TurnHandle.get({store: deps.sessionStore,@@ -270,7 +281,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {};const createAndExecuteTurnHandler: RouteHandler<typeof createAndExecuteTurnRoute> = async c => {- const { sessionId } = c.req.valid('param');+ const { session_id: sessionId } = c.req.valid('param');const body = c.req.valid('json');const session = await deps.sessions.get({ tenant_id: TENANT_ID, session_id: sessionId });@@ -280,7 +291,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {const abortController = new AbortController();const modelName = session.agent_spec.model.name;- const providerConfig = await getDbProviderConfig({+ const providerConfig = await getProviderConfig({tenant_id: TENANT_ID,name: modelName,store: deps.modelProviderStore,@@ -289,7 +300,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {mcpServerStore: deps.mcpServerStore,tokenStore: deps.tokenStore,skillStore: deps.skillStore,- sandboxProvider: deps.sandboxProvider,+ sandboxProviderStore: deps.sandboxProviderStore,logger: deps.logger,signal: abortController.signal,modelName,@@ -379,7 +390,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {};const subscribeTurnHandler: RouteHandler<typeof subscribeTurnRoute> = async c => {- const { sessionId, turnId } = c.req.valid('param');+ const { session_id: sessionId, turn_id: turnId } = c.req.valid('param');const query = c.req.valid('query');const afterSequenceNumber = resolveAfterSequenceNumber(c, query.after_sequence_number);diff --git a/packages/server/src/app.ts b/packages/server/src/app.tsindex c0a0df352..d421d5e62 100644--- a/packages/server/src/app.ts+++ b/packages/server/src/app.ts@@ -2,7 +2,7 @@import { swaggerUI } from '@hono/swagger-ui';import { OpenAPIHono } from '@hono/zod-openapi';import type { ISessionStore, Sessions, TurnStreamingEvent } from '@truefoundry/utils-core/agent-session';-import type { IOAuthTokenStore, SandboxProvider } from '@truefoundry/utils-core/core';+import type { IOAuthTokenStore } from '@truefoundry/utils-core/core';import type { RequestReplyRouter } from '@truefoundry/utils-core/request-reply';import type { Context } from 'hono';import { HTTPException } from 'hono/http-exception';@@ -58,8 +58,6 @@ export interface ServerDeps {sessionStore: ISessionStore;sessions: Sessions;activeTurns: ActiveTurnRegistry;- /** Shared SandboxProvider from SANDBOX_SETTINGS; undefined = sandbox unsupported. */- sandboxProvider?: SandboxProvider;/** Primary Redis client (server-owned); undefined in single-binary mode. */redis?: RedisClientType | undefined;/** Request-reply dispatch table served by this replica's executor. */@@ -111,7 +109,7 @@ export function createServerApp(deps: ServerDeps) {modelProviderStore: deps.modelProviderStore,mcpServerStore: deps.mcpServerStore,skillStore: deps.skillStore,- sandboxSupported: deps.sandboxProvider !== undefined,+ sandboxProviderStore: deps.sandboxProviderStore,redis: deps.redis,requestReplyRouter: deps.requestReplyRouter,}),@@ -127,7 +125,7 @@ export function createServerApp(deps: ServerDeps) {tokenStore: deps.tokenStore,skillStore: deps.skillStore,eventSubscriptions: deps.eventSubscriptions,- ...(deps.sandboxProvider ? { sandboxProvider: deps.sandboxProvider } : {}),+ sandboxProviderStore: deps.sandboxProviderStore,logger: deps.logger,}),);diff --git a/packages/server/src/config.ts b/packages/server/src/config.tsindex 7754bbeff..a176e3dc0 100644--- a/packages/server/src/config.ts+++ b/packages/server/src/config.ts@@ -173,26 +173,10 @@ export interface ServerConfiguration {*/OAUTH_CLIENT_NAME: string;/**- * Sandbox provider settings as a JSON object discriminated on `type`- * (see SandboxProviderSettingsSchema in the harness; today: "daytona").- * Unset = sandbox unsupported: specs with `config.sandbox.enabled` are- * rejected at session creation. Validated at boot by the sandbox factory.- * Env: `SANDBOX_SETTINGS`.+ * Max bytes for a single file download out of the sandbox.+ * Env: `SANDBOX_FILE_MAX_BYTES_FOR_DOWNLOAD`. Default 20 MB (same as gateway).*/- SANDBOX_SETTINGS: string | undefined;- /**- * Provider API key, kept out of the SANDBOX_SETTINGS JSON blob; overrides- * an inline `apiKey` when both are set. Env: `SANDBOX_API_KEY`.- */- SANDBOX_API_KEY: string | undefined;- /** Max bytes for a single file download out of the sandbox. Env: `SANDBOX_FILE_MAX_BYTES`. Default 20 MB. */- SANDBOX_FILE_MAX_BYTES: number;- /**- * Lifetime of the signed preview URL minted for the sandbox NATS bridge;- * effectively the max duration of one turn's sandbox connection.- * Env: `SANDBOX_PREVIEW_URL_EXPIRY_SECONDS`. Default 1 hour.- */- SANDBOX_PREVIEW_URL_EXPIRY_SECONDS: number;+ SANDBOX_FILE_MAX_BYTES_FOR_DOWNLOAD: number;/*** Max seconds to wait for turn cancellation + connection drain on SIGTERM/SIGINT.* Env: `GRACEFUL_TIMEOUT_SECONDS`. Default 30.@@ -306,18 +290,11 @@ const configuration: ServerConfiguration = {FRONTEND_DIR: path.resolve(getEnv('FRONTEND_DIR', { defaultValue: DEFAULT_FRONTEND_DIR }) ?? DEFAULT_FRONTEND_DIR),PUBLIC_BASE_URL: getEnv('PUBLIC_BASE_URL', { required: true }) ?? '',OAUTH_CLIENT_NAME: getEnv('OAUTH_CLIENT_NAME', { defaultValue: 'truefoundry-harness' }) ?? 'truefoundry-harness',- SANDBOX_SETTINGS: getEnv('SANDBOX_SETTINGS'),- SANDBOX_API_KEY: getEnv('SANDBOX_API_KEY'),- SANDBOX_FILE_MAX_BYTES: parsePositiveInt({- envKey: 'SANDBOX_FILE_MAX_BYTES',- raw: getEnv('SANDBOX_FILE_MAX_BYTES'),+ SANDBOX_FILE_MAX_BYTES_FOR_DOWNLOAD: parsePositiveInt({+ envKey: 'SANDBOX_FILE_MAX_BYTES_FOR_DOWNLOAD',+ raw: getEnv('SANDBOX_FILE_MAX_BYTES_FOR_DOWNLOAD'),defaultValue: 20_971_520,}),- SANDBOX_PREVIEW_URL_EXPIRY_SECONDS: parsePositiveInt({- envKey: 'SANDBOX_PREVIEW_URL_EXPIRY_SECONDS',- raw: getEnv('SANDBOX_PREVIEW_URL_EXPIRY_SECONDS'),- defaultValue: 3600,- }),GRACEFUL_TIMEOUT_SECONDS: parsePositiveInt({envKey: 'GRACEFUL_TIMEOUT_SECONDS',raw: getEnv('GRACEFUL_TIMEOUT_SECONDS'),diff --git a/packages/server/src/main.ts b/packages/server/src/main.tsindex 3befa2084..1275bb0bf 100644--- a/packages/server/src/main.ts+++ b/packages/server/src/main.ts@@ -17,7 +17,6 @@ try {{ migrateToLatest },{ Sessions, CancellationReason },{ ActiveTurnRegistry },- { createServerSandboxProvider },{ connectRedis },{ RequestReplyExecutor, RequestReplyRouter },{ PostgresSessionStore },@@ -39,7 +38,6 @@ try {import('./db/migratePostgres'),import('@truefoundry/utils-core/agent-session'),import('./runtime/activeTurns'),- import('./runtime/sandboxFactory'),import('./runtime/redis'),import('@truefoundry/utils-core/request-reply'),import('./db/postgres/session-store/PostgresSessionStore'),@@ -71,9 +69,7 @@ try {await migrateToLatest(db);const sessionStore = new PostgresSessionStore(db);- // Throws on malformed SANDBOX_SETTINGS; undefined when sandbox is not configured.const skillStore = new PostgresSkillStore(db);- const sandboxProvider = createServerSandboxProvider({ logger });const activeTurns = new ActiveTurnRegistry();let redis: RedisClientType | undefined;@@ -99,7 +95,6 @@ try {sessionStore,sessions: new Sessions({ sessionStore }),activeTurns,- ...(sandboxProvider ? { sandboxProvider } : {}),redis,requestReplyRouter,eventSubscriptions,diff --git a/packages/server/src/routes/sessionRoutes.ts b/packages/server/src/routes/sessionRoutes.tsindex 95cafd1e5..627f33d63 100644--- a/packages/server/src/routes/sessionRoutes.ts+++ b/packages/server/src/routes/sessionRoutes.ts@@ -19,7 +19,7 @@ import { TOKEN_PAGINATION } from './fernExtensions';const SESSIONS_TAG = 'Sessions';export const SessionIdParamsSchema = z.object({- sessionId: z.string().min(1).max(64).describe('Session identifier.'),+ session_id: z.string().min(1).max(64).describe('Session identifier.'),});export const createSessionRoute = createRoute({@@ -55,7 +55,7 @@ export const createSessionRoute = createRoute({export const getSessionRoute = createRoute({method: 'get',- path: '/{sessionId}',+ path: '/{session_id}',tags: [SESSIONS_TAG],summary: 'Get a session',description: 'Fetch a session by ID.',@@ -78,7 +78,7 @@ export const getSessionRoute = createRoute({export const deleteSessionRoute = createRoute({method: 'delete',- path: '/{sessionId}',+ path: '/{session_id}',tags: [SESSIONS_TAG],summary: 'Delete a session',description: 'Delete a session and all related turns, events, and internal state. Idempotent if already gone.',@@ -96,7 +96,7 @@ export const deleteSessionRoute = createRoute({export const updateSessionRoute = createRoute({method: 'patch',- path: '/{sessionId}',+ path: '/{session_id}',tags: [SESSIONS_TAG],summary: 'Update a session',description: "Update a session's inline agent spec. An empty body is a valid no-op that refreshes `updated_at`.",@@ -157,7 +157,7 @@ export const listSessionsRoute = createRoute({export const cancelSessionRoute = createRoute({method: 'post',- path: '/{sessionId}/cancel',+ path: '/{session_id}/cancel',tags: [SESSIONS_TAG],summary: 'Cancel a running turn in a session',description: 'Cancel the running last turn for a session.',@@ -189,7 +189,7 @@ export const cancelSessionRoute = createRoute({export const listSessionEventsRoute = createRoute({method: 'get',- path: '/{sessionId}/events',+ path: '/{session_id}/events',tags: [SESSIONS_TAG],summary: 'List session events',description:diff --git a/packages/server/src/routes/turnRoutes.ts b/packages/server/src/routes/turnRoutes.tsindex 4091eb211..d93c68425 100644--- a/packages/server/src/routes/turnRoutes.ts+++ b/packages/server/src/routes/turnRoutes.ts@@ -21,12 +21,12 @@ import { SessionIdParamsSchema } from './sessionRoutes';const SESSIONS_TAG = 'Sessions';export const TurnIdParamsSchema = SessionIdParamsSchema.extend({- turnId: z.string().min(1).describe('Turn identifier.'),+ turn_id: z.string().min(1).describe('Turn identifier.'),});export const listTurnsRoute = createRoute({method: 'get',- path: '/{sessionId}/turns',+ path: '/{session_id}/turns',tags: [SESSIONS_TAG],summary: 'List turns in a session',description: 'List turns for a session (newest first by default), token-paginated.',@@ -55,7 +55,7 @@ export const listTurnsRoute = createRoute({export const getTurnRoute = createRoute({method: 'get',- path: '/{sessionId}/turns/{turnId}',+ path: '/{session_id}/turns/{turn_id}',tags: [SESSIONS_TAG],summary: 'Get a turn',description: 'Fetch a single turn by ID.',@@ -78,7 +78,7 @@ export const getTurnRoute = createRoute({export const listTurnEventsRoute = createRoute({method: 'get',- path: '/{sessionId}/turns/{turnId}/events',+ path: '/{session_id}/turns/{turn_id}/events',tags: [SESSIONS_TAG],summary: 'List turn events',description: 'Paginated persisted events for a turn (insertion order by default).',@@ -107,7 +107,7 @@ export const listTurnEventsRoute = createRoute({export const createAndExecuteTurnRoute = createRoute({method: 'post',- path: '/{sessionId}/turns',+ path: '/{session_id}/turns',tags: [SESSIONS_TAG],summary: 'Create and execute a turn in a session',description: `Create a turn within a session and stream its execution as Server-Sent Events.@@ -148,7 +148,7 @@ Use \`previous_turn_id\` to chain to the session's last turn (defaults to \`autoexport const subscribeTurnRoute = createRoute({method: 'get',- path: '/{sessionId}/turns/{turnId}/subscribe',+ path: '/{session_id}/turns/{turn_id}/subscribe',tags: [SESSIONS_TAG],summary: 'Subscribe to a running turn',description:diff --git a/packages/server/src/runtime/sandboxFactory.ts b/packages/server/src/runtime/sandboxFactory.tsdeleted file mode 100644index 348a5a407..000000000--- a/packages/server/src/runtime/sandboxFactory.ts+++ /dev/null@@ -1,100 +0,0 @@-/**- * Boot-time sandbox provider from `SANDBOX_SETTINGS`, plus a shared Sandbox- * builder that takes already-resolved git skill mounts (no skill store).- *- * Called from main.ts so a malformed SANDBOX_SETTINGS aborts startup instead- * of failing mid-turn. Skill expansion stays in the DB turn resolvers.- */-import {- createSandboxProvider,- Sandbox,- SandboxProviderSettingsSchema,- SkillMounter,- type AgentTracing,- type GitSkill,- type SandboxProvider,-} from '@truefoundry/utils-core/core';-import type { Logger } from 'winston';-import { ZodError } from 'zod';-import { TENANT_ID } from '../apis/sessions';-import configuration from '../config';--function parseSandboxSettings(rawJson: string) {- let raw: unknown;- try {- raw = JSON.parse(rawJson);- } catch (error) {- throw new Error(- `Environment variable SANDBOX_SETTINGS must be valid JSON: ${error instanceof Error ? error.message : String(error)}`,- { cause: error },- );- }- // SANDBOX_API_KEY overrides an inline `apiKey` so the credential can stay out- // of the settings blob (mirrors the gateway's SANDBOX_API_KEY + SANDBOX_SETTINGS split).- const merged =- typeof raw === 'object' && raw !== null && !Array.isArray(raw)- ? { ...raw, ...(configuration.SANDBOX_API_KEY !== undefined ? { apiKey: configuration.SANDBOX_API_KEY } : {}) }- : raw;- try {- return SandboxProviderSettingsSchema.parse(merged);- } catch (error) {- if (error instanceof ZodError) {- throw new Error(`Environment variable SANDBOX_SETTINGS is invalid: ${error.message}`, { cause: error });- }- throw error;- }-}--/**- * Builds a Sandbox for one turn from resolved git mounts. Callers expand- * skills from ISkillStore before invoking this.- */-export function buildTurnSandbox(input: {- provider: SandboxProvider;- logger: Logger;- gitSkills: readonly GitSkill[];- fileDownloadEnabled: boolean;- existingSandboxId?: string | undefined;- tracing: AgentTracing;-}): Sandbox {- const skillMounter = input.gitSkills.length > 0 ? new SkillMounter([...input.gitSkills]) : undefined;- return new Sandbox({- provider: input.provider,- existingSandboxId: input.existingSandboxId,- fileDownloadEnabled: input.fileDownloadEnabled,- blockDestructiveToolsInCodeMode: true,- // Sandbox reads its tenant from TFY_TENANT_NAME (see Sandbox constructor)- // for the ownership check against provider-created sandbox ids- // (`<tenant>.<uuid>`). Must match the tenantName given to the provider.- execExtraEnv: { TFY_TENANT_NAME: TENANT_ID },- ...(skillMounter ? { skillMounter } : {}),- tracing: input.tracing,- logger: input.logger,- });-}--/**- * Builds the shared SandboxProvider, or undefined when sandbox is not configured.- * Throws on any misconfiguration.- */-export function createServerSandboxProvider(deps: { logger: Logger }): SandboxProvider | undefined {- if (configuration.SANDBOX_SETTINGS === undefined) {- if (configuration.SANDBOX_API_KEY !== undefined) {- throw new Error(- 'SANDBOX_API_KEY is set but SANDBOX_SETTINGS is missing. ' +- 'Set SANDBOX_SETTINGS (e.g. {"type":"daytona","snapshotName":"..."}) or unset SANDBOX_API_KEY.',- );- }- return undefined;- }-- const settings = parseSandboxSettings(configuration.SANDBOX_SETTINGS);- const logger = deps.logger.child({ module: 'sandboxFactory' });- return createSandboxProvider({- settings,- tenantName: TENANT_ID,- fileMaxBytes: configuration.SANDBOX_FILE_MAX_BYTES,- previewUrlExpirySeconds: configuration.SANDBOX_PREVIEW_URL_EXPIRY_SECONDS,- logger,- });-}diff --git a/packages/server/src/runtime/dbSessionResources.ts b/packages/server/src/runtime/sessionResources.tssimilarity index 70%rename from packages/server/src/runtime/dbSessionResources.tsrename to packages/server/src/runtime/sessionResources.tsindex f064aec2e..497f1ccb8 100644--- a/packages/server/src/runtime/dbSessionResources.ts+++ b/packages/server/src/runtime/sessionResources.ts@@ -1,22 +1,31 @@/**- * DB-backed model/MCP/skill resolution for /api/v1/sessions admit and turns.+ * Store-backed model/MCP/skill/sandbox resolution for session admit and turns.*/import type { AgentSpec } from '@truefoundry/utils-core/agent-session';import {+ DaytonaSandboxProvider,isMcpAuthRequired,resolveMcpAuth,+ Sandbox,+ SkillMounter,+ type AgentTracing,type GitSkill,type IOAuthTokenStore,type RemoteMcpHeaders,+ type SandboxProvider,type VercelAIProviderConfig,} from '@truefoundry/utils-core/core';import { HTTPException } from 'hono/http-exception';+import type { Logger } from 'winston';+import configuration from '../config';import type { IMcpServerStore, McpServerRecord } from '../db/mcpServerStore';import type { IModelProviderStore } from '../db/modelProviderStore';+import type { ISandboxProviderStore } from '../db/sandboxProviderStore';import type { ISkillStore } from '../db/skillStore';import { resolveConfiguredMcpRequestHeaders } from '../schemas/mcpServer';+import { toDaytonaSandboxProviderInput } from '../schemas/sandboxProvider';-export interface DbMcpConnection {+export interface McpConnection {url: string;headers: RemoteMcpHeaders;}@@ -34,11 +43,11 @@ export function parseModelFqn(name: string): { providerName: string; modelName:}/**- * Load turn-ready LLM config for a DB-configured FQN (`provider/model`).+ * Load turn-ready LLM config for a configured FQN (`provider/model`).* Missing provider/model → HTTPException(400) (e.g. deleted after admit).* Malformed FQN after admit is an invariant → plain Error (500).*/-export async function getDbProviderConfig({+export async function getProviderConfig({tenant_id,name,store,@@ -104,11 +113,11 @@ function dcrHeadersResolver(params: {}/**- * Load MCP url + headers for a DB-configured server.+ * Load MCP url + headers for a configured server.* DCR uses resolveMcpAuth; header / no-auth use resolveConfiguredMcpRequestHeaders.* Throws HTTPException(400) if the server is not registered.*/-export async function getDbMcpConnection({+export async function getMcpConnection({tenant_id,name,store,@@ -120,7 +129,7 @@ export async function getDbMcpConnection({store: IMcpServerStore;tokenStore: IOAuthTokenStore;clientName: string;-}): Promise<DbMcpConnection> {+}): Promise<McpConnection> {const record = await store.getServer({ tenant_id, name });if (record === undefined) {throw new HTTPException(400, {@@ -146,10 +155,10 @@ export async function getDbMcpConnection({/*** Expand agent_spec skill names into git mounts from the skill store.- * Wire url/path/ref/description on the request are ignored — the DB row wins.+ * Wire url/path/ref/description on the request are ignored — the store row wins.* Throws HTTPException(400) if any name is not registered.*/-export async function resolveDbGitSkills({+export async function resolveGitSkills({tenant_id,skills,store,@@ -178,24 +187,77 @@ export async function resolveDbGitSkills({}/**- * Cross-checks an AgentSpec against DB-configured models / MCP / skills and+ * Build a runtime SandboxProvider from the configured store row, or undefined+ * when no provider is configured. Construction is cheap (no I/O beyond the store read).+ */+export async function resolveSandboxProvider({+ tenant_id,+ store,+ logger,+}: {+ tenant_id: string;+ store: ISandboxProviderStore;+ logger: Logger;+}): Promise<SandboxProvider | undefined> {+ const record = await store.getSandboxProvider(tenant_id);+ if (record === undefined) {+ return undefined;+ }+ return new DaytonaSandboxProvider({+ ...toDaytonaSandboxProviderInput(record.manifest),+ tenantName: tenant_id,+ fileMaxBytesForDownload: configuration.SANDBOX_FILE_MAX_BYTES_FOR_DOWNLOAD,+ logger,+ });+}++/**+ * Builds a Sandbox for one turn from a resolved provider and git mounts.+ * `tenantName` must match the name given to DaytonaSandboxProvider (ownership check).+ */+export function buildTurnSandbox(input: {+ provider: SandboxProvider;+ logger: Logger;+ gitSkills: readonly GitSkill[];+ fileDownloadEnabled: boolean;+ existingSandboxId?: string | undefined;+ tracing: AgentTracing;+ tenantName: string;+}): Sandbox {+ const skillMounter = input.gitSkills.length > 0 ? new SkillMounter([...input.gitSkills]) : undefined;+ return new Sandbox({+ provider: input.provider,+ existingSandboxId: input.existingSandboxId,+ fileDownloadEnabled: input.fileDownloadEnabled,+ blockDestructiveToolsInCodeMode: true,+ // Sandbox reads its tenant from TFY_TENANT_NAME for the ownership check+ // against provider-created sandbox ids (`<tenant>.<uuid>`).+ execExtraEnv: { TFY_TENANT_NAME: input.tenantName },+ ...(skillMounter ? { skillMounter } : {}),+ tracing: input.tracing,+ logger: input.logger,+ });+}++/**+ * Cross-checks an AgentSpec against configured models / MCP / skills and* sandbox capability. Throws HTTPException: 400 unknown refs, 422 missing sandbox.* Skills are admitted by name only; mounts expand at turn time.*/-export async function validateAgentSpecDb({+export async function validateAgentSpec({spec,tenant_id,modelProviderStore,mcpServerStore,skillStore,- sandboxSupported,+ sandboxProviderStore,}: {spec: AgentSpec;tenant_id: string;modelProviderStore: IModelProviderStore;mcpServerStore: IMcpServerStore;skillStore: ISkillStore;- sandboxSupported: boolean;+ sandboxProviderStore: ISandboxProviderStore;}): Promise<void> {// FQN shape is enforced by AgentSpecSchema; parse failure here is an invariant.const parsed = parseModelFqn(spec.model.name);@@ -246,11 +308,14 @@ export async function validateAgentSpecDb({const wantsSandbox = spec.config?.sandbox?.enabled === true;const hasSkills = (spec.skills?.length ?? 0) > 0;- if ((wantsSandbox || hasSkills) && !sandboxSupported) {- throw new HTTPException(422, {- message: hasSkills- ? 'skills require a sandbox provider — set SANDBOX_SETTINGS (and SANDBOX_API_KEY)'- : 'sandbox is enabled in the agent spec but this server has no sandbox provider configured — set SANDBOX_SETTINGS (and SANDBOX_API_KEY)',- });+ if (wantsSandbox || hasSkills) {+ const record = await sandboxProviderStore.getSandboxProvider(tenant_id);+ if (record === undefined) {+ throw new HTTPException(422, {+ message: hasSkills+ ? 'skills require a sandbox provider — configure via PUT /settings/sandbox-providers'+ : 'sandbox is enabled but no sandbox provider is configured — PUT /settings/sandbox-providers',+ });+ }}}diff --git a/packages/server/src/schemas/sandboxProvider.ts b/packages/server/src/schemas/sandboxProvider.tsindex f24459286..50359f326 100644--- a/packages/server/src/schemas/sandboxProvider.ts+++ b/packages/server/src/schemas/sandboxProvider.ts@@ -6,6 +6,7 @@* Singleton per tenant — no identity `name` (unlike model providers / skills).*/import { z } from '@hono/zod-openapi';+import type { DaytonaSandboxProviderOptions } from '@truefoundry/utils-core/core';const DaytonaSandboxProviderAuthSchema = z.object({@@ -58,3 +59,25 @@ export const GetSandboxProviderResponseSchema = zexport type DaytonaSandboxProvider = z.infer<typeof DaytonaSandboxProviderSchema>;export type SandboxProvider = z.infer<typeof SandboxProviderSchema>;export type PutSandboxProviderRequest = SandboxProvider;++/** Wire/persisted snake_case → DaytonaSandboxProvider ctor fields from the manifest. */+export function toDaytonaSandboxProviderInput(+ manifest: SandboxProviderManifest,+): Pick<+ DaytonaSandboxProviderOptions,+ | 'apiKey'+ | 'snapshotName'+ | 'timeoutMs'+ | 'autoStopIntervalInMinutes'+ | 'autoArchiveIntervalInMinutes'+ | 'autoDeleteIntervalInMinutes'+> {+ return {+ apiKey: manifest.auth.api_key,+ snapshotName: manifest.snapshot_name,+ timeoutMs: manifest.exec_timeout_ms,+ autoStopIntervalInMinutes: manifest.auto_stop_interval_in_minutes,+ autoArchiveIntervalInMinutes: manifest.auto_archive_interval_in_minutes,+ autoDeleteIntervalInMinutes: manifest.auto_delete_interval_in_minutes,+ };+}diff --git a/packages/server/tests/unit/apis/deletedSessionCrud.test.ts b/packages/server/tests/unit/apis/deletedSessionCrud.test.tsindex 27a6995fe..3c00150e5 100644--- a/packages/server/tests/unit/apis/deletedSessionCrud.test.ts+++ b/packages/server/tests/unit/apis/deletedSessionCrud.test.ts@@ -9,6 +9,7 @@ import { migrateSqliteToLatest } from '../../../src/db/migrateSqlite';import { createSqliteDb } from '../../../src/db/sqlite/client';import { SqliteMcpServerStore } from '../../../src/db/sqlite/mcp-server-store/SqliteMcpServerStore';import { SqliteModelProviderStore } from '../../../src/db/sqlite/model-provider-store/SqliteModelProviderStore';+import { SqliteSandboxProviderStore } from '../../../src/db/sqlite/sandbox-provider-store/SqliteSandboxProviderStore';import { SqliteSessionStore } from '../../../src/db/sqlite/session-store/SqliteSessionStore';import { SqliteSkillStore } from '../../../src/db/sqlite/skill-store/SqliteSkillStore';import { SqliteOAuthTokenStore } from '../../../src/db/sqlite/token-store/SqliteOAuthTokenStore';@@ -27,6 +28,7 @@ describe('public CRUD after session deletion', () => {const mcpServerStore = new SqliteMcpServerStore(db);const tokenStore = new SqliteOAuthTokenStore(db);const skillStore = new SqliteSkillStore(db);+ const sandboxProviderStore = new SqliteSandboxProviderStore(db);const app = new OpenAPIHono();app.route(@@ -38,7 +40,7 @@ describe('public CRUD after session deletion', () => {modelProviderStore,mcpServerStore,skillStore,- sandboxSupported: false,+ sandboxProviderStore,redis: createClient(),requestReplyRouter: new RequestReplyRouter(),}),@@ -54,6 +56,7 @@ describe('public CRUD after session deletion', () => {tokenStore,skillStore,eventSubscriptions: new EventSubscriptionRegistry(undefined),+ sandboxProviderStore,logger: createLogger({ silent: true }),}),);diff --git a/packages/server/tests/unit/apis/turnStreamAfterDelete.test.ts b/packages/server/tests/unit/apis/turnStreamAfterDelete.test.tsindex 3944d03db..da06b52c0 100644--- a/packages/server/tests/unit/apis/turnStreamAfterDelete.test.ts+++ b/packages/server/tests/unit/apis/turnStreamAfterDelete.test.ts@@ -7,6 +7,7 @@ import { migrateSqliteToLatest } from '../../../src/db/migrateSqlite';import { createSqliteDb } from '../../../src/db/sqlite/client';import { SqliteMcpServerStore } from '../../../src/db/sqlite/mcp-server-store/SqliteMcpServerStore';import { SqliteModelProviderStore } from '../../../src/db/sqlite/model-provider-store/SqliteModelProviderStore';+import { SqliteSandboxProviderStore } from '../../../src/db/sqlite/sandbox-provider-store/SqliteSandboxProviderStore';import { SqliteSessionStore } from '../../../src/db/sqlite/session-store/SqliteSessionStore';import { SqliteSkillStore } from '../../../src/db/sqlite/skill-store/SqliteSkillStore';import { SqliteOAuthTokenStore } from '../../../src/db/sqlite/token-store/SqliteOAuthTokenStore';@@ -68,6 +69,7 @@ describe('turn SSE after session deletion', () => {tokenStore: new SqliteOAuthTokenStore(db),skillStore: new SqliteSkillStore(db),eventSubscriptions: new EventSubscriptionRegistry(undefined),+ sandboxProviderStore: new SqliteSandboxProviderStore(db),logger,}),);diff --git a/packages/server/tests/unit/runtime/getDbMcpConnection.test.ts b/packages/server/tests/unit/runtime/getMcpConnection.test.tssimilarity index 95%rename from packages/server/tests/unit/runtime/getDbMcpConnection.test.tsrename to packages/server/tests/unit/runtime/getMcpConnection.test.tsindex 6b6577059..0c37820ea 100644--- a/packages/server/tests/unit/runtime/getDbMcpConnection.test.ts+++ b/packages/server/tests/unit/runtime/getMcpConnection.test.ts@@ -3,9 +3,9 @@ import { migrateSqliteToLatest } from '../../../src/db/migrateSqlite';import { createSqliteDb } from '../../../src/db/sqlite/client';import { SqliteMcpServerStore } from '../../../src/db/sqlite/mcp-server-store/SqliteMcpServerStore';import { SqliteOAuthTokenStore } from '../../../src/db/sqlite/token-store/SqliteOAuthTokenStore';-import { getDbMcpConnection } from '../../../src/runtime/dbSessionResources';+import { getMcpConnection } from '../../../src/runtime/sessionResources';-describe('getDbMcpConnection', () => {+describe('getMcpConnection', () => {let mcpServerStore: SqliteMcpServerStore;let tokenStore: SqliteOAuthTokenStore;@@ -71,7 +71,7 @@ describe('getDbMcpConnection', () => {},});- const connection = await getDbMcpConnection({+ const connection = await getMcpConnection({tenant_id: TENANT_ID,name: 'oauth-mcp',store: mcpServerStore,@@ -124,7 +124,7 @@ describe('getDbMcpConnection', () => {},});- const connection = await getDbMcpConnection({+ const connection = await getMcpConnection({tenant_id: TENANT_ID,name: 'tokened-mcp',store: mcpServerStore,@@ -150,7 +150,7 @@ describe('getDbMcpConnection', () => {},});- const connection = await getDbMcpConnection({+ const connection = await getMcpConnection({tenant_id: TENANT_ID,name: 'open-mcp',store: mcpServerStore,@@ -174,7 +174,7 @@ describe('getDbMcpConnection', () => {},});- const connection = await getDbMcpConnection({+ const connection = await getMcpConnection({tenant_id: TENANT_ID,name: 'header-mcp',store: mcpServerStore,diff --git a/packages/server/tests/unit/runtime/sessionResources.test.ts b/packages/server/tests/unit/runtime/sessionResources.test.tsnew file mode 100644index 000000000..6cc2f64d9--- /dev/null+++ b/packages/server/tests/unit/runtime/sessionResources.test.ts@@ -0,0 +1,115 @@+import { AgentSpecSchema } from '@truefoundry/utils-core/agent-session';+import { HTTPException } from 'hono/http-exception';+import { TENANT_ID } from '../../../src/apis/sessions';+import { migrateSqliteToLatest } from '../../../src/db/migrateSqlite';+import { createSqliteDb } from '../../../src/db/sqlite/client';+import { SqliteMcpServerStore } from '../../../src/db/sqlite/mcp-server-store/SqliteMcpServerStore';+import { SqliteModelProviderStore } from '../../../src/db/sqlite/model-provider-store/SqliteModelProviderStore';+import { SqliteSandboxProviderStore } from '../../../src/db/sqlite/sandbox-provider-store/SqliteSandboxProviderStore';+import { SqliteSkillStore } from '../../../src/db/sqlite/skill-store/SqliteSkillStore';+import { validateAgentSpec } from '../../../src/runtime/sessionResources';++describe('validateAgentSpec sandbox gate', () => {+ async function setup() {+ const db = createSqliteDb(':memory:');+ await migrateSqliteToLatest(db);+ const modelProviderStore = new SqliteModelProviderStore(db);+ await modelProviderStore.upsertProvider({+ tenant_id: TENANT_ID,+ name: 'test-provider',+ manifest: {+ type: 'openai',+ auth: { api_key: 'sk-test' },+ models: [+ {+ model_id: 'test-model',+ name: 'test-model',+ properties: { context_length: 128000, max_output_tokens: 4096 },+ },+ ],+ },+ });+ return {+ modelProviderStore,+ mcpServerStore: new SqliteMcpServerStore(db),+ skillStore: new SqliteSkillStore(db),+ sandboxProviderStore: new SqliteSandboxProviderStore(db),+ };+ }++ it('rejects sandbox.enabled when no sandbox provider is configured', async () => {+ const stores = await setup();+ await expect(+ validateAgentSpec({+ spec: AgentSpecSchema.parse({+ model: { name: 'test-provider/test-model' },+ instructions: 'test',+ config: { sandbox: { enabled: true } },+ }),+ tenant_id: TENANT_ID,+ ...stores,+ }),+ ).rejects.toMatchObject({+ status: 422,+ message: expect.stringContaining('PUT /settings/sandbox-providers'),+ } satisfies Partial<HTTPException>);+ });++ it('rejects skills when no sandbox provider is configured', async () => {+ const stores = await setup();+ await stores.skillStore.upsertSkill({+ tenant_id: TENANT_ID,+ name: 'demo',+ manifest: {+ type: 'git',+ name: 'demo',+ url: 'https://github.com/example/skills',+ ref: 'main',+ description: 'demo skill',+ },+ });++ await expect(+ validateAgentSpec({+ spec: AgentSpecSchema.parse({+ model: { name: 'test-provider/test-model' },+ instructions: 'test',+ skills: [{ name: 'demo' }],+ }),+ tenant_id: TENANT_ID,+ ...stores,+ }),+ ).rejects.toMatchObject({+ status: 422,+ message: expect.stringContaining('skills require a sandbox provider'),+ } satisfies Partial<HTTPException>);+ });++ it('admits sandbox.enabled when a sandbox provider row exists', async () => {+ const stores = await setup();+ await stores.sandboxProviderStore.upsertSandboxProvider({+ tenant_id: TENANT_ID,+ manifest: {+ type: 'daytona',+ snapshot_name: 'snap',+ auth: { api_key: 'dtn-test' },+ exec_timeout_ms: 60_000,+ auto_stop_interval_in_minutes: 5,+ auto_archive_interval_in_minutes: 60,+ auto_delete_interval_in_minutes: 7200,+ },+ });++ await expect(+ validateAgentSpec({+ spec: AgentSpecSchema.parse({+ model: { name: 'test-provider/test-model' },+ instructions: 'test',+ config: { sandbox: { enabled: true } },+ }),+ tenant_id: TENANT_ID,+ ...stores,+ }),+ ).resolves.toBeUndefined();+ });+});diff --git a/packages/server/tests/unit/schemas/sandboxProvider.test.ts b/packages/server/tests/unit/schemas/sandboxProvider.test.tsnew file mode 100644index 000000000..7ff5874ec--- /dev/null+++ b/packages/server/tests/unit/schemas/sandboxProvider.test.ts@@ -0,0 +1,24 @@+import { toDaytonaSandboxProviderInput, type SandboxProviderManifest } from '../../../src/schemas/sandboxProvider';++describe('toDaytonaSandboxProviderInput', () => {+ it('maps a Daytona wire/DB manifest to DaytonaSandboxProvider ctor fields', () => {+ const manifest: SandboxProviderManifest = {+ type: 'daytona',+ snapshot_name: 'truefoundry-platform-dev-2d5edee',+ auth: { api_key: 'dtn-test' },+ exec_timeout_ms: 60_000,+ auto_stop_interval_in_minutes: 5,+ auto_archive_interval_in_minutes: 60,+ auto_delete_interval_in_minutes: 7200,+ };++ expect(toDaytonaSandboxProviderInput(manifest)).toEqual({+ apiKey: 'dtn-test',+ snapshotName: 'truefoundry-platform-dev-2d5edee',+ timeoutMs: 60_000,+ autoStopIntervalInMinutes: 5,+ autoArchiveIntervalInMinutes: 60,+ autoDeleteIntervalInMinutes: 7200,+ });+ });+});diff --git a/scripts/generate-sdk.sh b/scripts/generate-sdk.shnew file mode 100755index 000000000..bfb7c6052--- /dev/null+++ b/scripts/generate-sdk.sh@@ -0,0 +1,18 @@+#!/usr/bin/env bash+# Regenerates fern/openapi/openapi.json and packages/sdk (same steps as CI).+# Requires Docker (Fern --local) and network access for the Fern CLI/image.+set -euo pipefail++cd "$(dirname "$0")/.."++fern_version="$(jq -r .version fern/fern.config.json)"+fern() {+ pnpm dlx "fern-api@${fern_version}" "$@"+}++pnpm --filter @truefoundry/utils-core build+pnpm openapi:write+fern check+# --force skips the overwrite prompt when packages/sdk already exists (needed non-interactively / in CI).+fern generate --group ts-sdk --version 0.0.0 --local --generate-tests --force --log-level debug+(cd packages/sdk && bash .fern/verify.sh)