Skip to content

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.yaml
index 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 SDK
if: 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 output
diff --git a/fern/README.md b/fern/README.md
index 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: 1
diff --git a/fern/generators.yml b/fern/generators.yml
index 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}/turns
stream: true
api:
specs:
diff --git a/fern/openapi/openapi.json b/fern/openapi/openapi.json
index 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.json
index 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.ts
index 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.ts
index 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 bridge
diff --git a/packages/harness/src/core/sandbox/constants.ts b/packages/harness/src/core/sandbox/constants.ts
index 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.ts
index 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.ts
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.json
index 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.md
index 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 awai
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);
}
diff --git a/packages/sdk/reference.md b/packages/sdk/reference.md
index 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&lt;TrueHarness.SessionEventItem, TrueHarness.ListSessionEventsResponse&gt;</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listEvents</a>(session_id, { ...params }) -> core.Page&lt;TrueHarness.SessionEventItem, TrueHarness.ListSessionEventsResponse&gt;</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&lt;TrueHarness.Turn, TrueHarness.ListTurnsResponse&gt;</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">listTurns</a>(session_id, { ...params }) -> core.Page&lt;TrueHarness.Turn, TrueHarness.ListTurnsResponse&gt;</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&lt;TrueHarness.TurnStreamingEvent&gt;</code></summary>
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">createTurn</a>(session_id, { ...params }) -> core.Stream&lt;TrueHarness.TurnStreamingEvent&gt;</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&lt;TrueHarness.SessionEvent, TrueHarness.ListTurnEventsResponse&gt;</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&lt;TrueHarness.SessionEvent, TrueHarness.ListTurnEventsResponse&gt;</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&lt;TrueHarness.TurnStreamingEvent&gt;</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&lt;TrueHarness.TurnStreamingEvent&gt;</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.ts
index 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.ts
index 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.example
index 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 postgres
diff --git a/packages/server/src/apis/sessions.ts b/packages/server/src/apis/sessions.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 \`auto
export 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.ts
deleted file mode 100644
index 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.ts
similarity index 70%
rename from packages/server/src/runtime/dbSessionResources.ts
rename to packages/server/src/runtime/sessionResources.ts
index 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.ts
index 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 = z
export 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.ts
index 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.ts
index 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.ts
similarity index 95%
rename from packages/server/tests/unit/runtime/getDbMcpConnection.test.ts
rename to packages/server/tests/unit/runtime/getMcpConnection.test.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.sh
new file mode 100755
index 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)