Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

30.6 KB
Raw Blame

@truefoundry/trueforge-core

0.180.0

Patch Changes

  • 5dd0089: Fail the turn with an explanatory error (Output blocked: the model's content safety filter stopped the response. Rephrase the request and retry.) when the content filter stops the response, instead of finishing with empty output.
  • 36a0bfa: Preserve supervisord ENTRYPOINT on Daytona custom-environment buildInfo snapshots so the sandbox NATS bridge starts (Daytona otherwise defaults to sleep infinity).
  • 0a1606d: Blocked large tool response messages now state the exact content size and which limit blocked it, in characters (Content too large (50,000 characters; this response exceeds the 24,000-character limit for a single response). Result saved to: …, at the default thresholds; responses blocked by the parallel total instead say the parallel responses together exceed the combined limit), and the file-dump message prompts the model to plan reads against the total instead of guessing with small incremental reads.
  • 5fd9cca: Prefix model and MCP failures so logs and the chat error show which system failed.
  • 26c77c4: Add optional AgentSpec-shaped model ({ name: provider/model, params? }) on model.message events, stamp it from the bound agent definition for new turns, and backfill the session tip turn's events / turn output from the session agent model FQN.
  • be2bb87: When a model stops at its output token limit, fail the turn with Output truncated: hit the <N> token limit. Raise max_tokens and retry. (or "the provider's default token limit" when none was sent) instead of max_tokens breached. The tokens used are included when they differ from the limit.
  • 248e768: Enable fine-grained tool streaming via TrueFoundry anthropic-beta header and Anthropic toolStreaming, and report invalid tool-arg JSON as a distinct parse error
  • 05cef0b: Add 502 and 503 status codes to SSRF fetch retry logic. These errors indicate temporary upstream failures and are now eligible for automatic retries across model, MCP, and outbound fetch operations.

0.180.0-rc.3

Patch Changes

  • 5fd9cca: Prefix model and MCP failures so logs and the chat error show which system failed.

0.180.0-rc.2

Patch Changes

  • 0a1606d: The sandbox file-dump message for a blocked large tool response now states its exact size (Content too large (50,000 characters). Result saved to: …) and prompts the model to plan reads against that total, instead of guessing with small incremental reads.

0.180.0-rc.1

Patch Changes

  • 5dd0089: Fail the turn with an explanatory error (Output blocked: the model's content safety filter stopped the response. Rephrase the request and retry.) when the content filter stops the response, instead of finishing with empty output.
  • 36a0bfa: Preserve supervisord ENTRYPOINT on Daytona custom-environment buildInfo snapshots so the sandbox NATS bridge starts (Daytona otherwise defaults to sleep infinity).
  • 26c77c4: Add optional AgentSpec-shaped model ({ name: provider/model, params? }) on model.message events, stamp it from the bound agent definition for new turns, and backfill the session tip turn's events / turn output from the session agent model FQN.
  • be2bb87: When a model stops at its output token limit, fail the turn with Output truncated: hit the <N> token limit. Raise max_tokens and retry. (or "the provider's default token limit" when none was sent) instead of max_tokens breached. The tokens used are included when they differ from the limit.
  • 248e768: Enable fine-grained tool streaming via TrueFoundry anthropic-beta header and Anthropic toolStreaming, and report invalid tool-arg JSON as a distinct parse error
  • 05cef0b: Add 502 and 503 status codes to SSRF fetch retry logic. These errors indicate temporary upstream failures and are now eligible for automatic retries across model, MCP, and outbound fetch operations.

0.179.0

Patch Changes

  • 97f7d7f: Bump @modelcontextprotocol/sdk from 1.30.1 to 1.31.0.
  • bbe23c8: Preserve supervisord ENTRYPOINT on Daytona custom-environment buildInfo snapshots so the sandbox NATS bridge starts (Daytona otherwise defaults to sleep infinity).
  • f975575: On Daytona sandbox create, reactivate inactive snapshots with a clear retry error, and raise a P1 for unexpected create failures (not authz).
  • 8cc8453: extractErrorLogFields appends each cause stack after the outer stack, joined with Caused by:. A wrapper captures the boundary rather than the throw site, so the origin frames stay on the same traceback.
  • e1f470f: Raise the default model HTTP headers and body timeouts to 2 minutes so slow first-token and idle stream responses are not dropped.
  • bbe23c8: Add 502 and 503 status codes to SSRF fetch retry logic. These errors indicate temporary upstream failures and are now eligible for automatic retries across model, MCP, and outbound fetch operations.

0.179.0-rc.2

Patch Changes

  • bbe23c8: Preserve supervisord ENTRYPOINT on Daytona custom-environment buildInfo snapshots so the sandbox NATS bridge starts (Daytona otherwise defaults to sleep infinity).
  • bbe23c8: Add 502 and 503 status codes to SSRF fetch retry logic. These errors indicate temporary upstream failures and are now eligible for automatic retries across model, MCP, and outbound fetch operations.

0.179.0-rc.1

Patch Changes

  • 97f7d7f: Bump @modelcontextprotocol/sdk from 1.30.1 to 1.31.0.
  • f975575: On Daytona sandbox create, reactivate inactive snapshots with a clear retry error, and raise a P1 for unexpected create failures (not authz).
  • 8cc8453: extractErrorLogFields appends each cause stack after the outer stack, joined with Caused by:. A wrapper captures the boundary rather than the throw site, so the origin frames stay on the same traceback.
  • e1f470f: Raise the default model HTTP headers and body timeouts to 2 minutes so slow first-token and idle stream responses are not dropped.

0.178.0

Patch Changes

  • 8b6c4bf: Raise the default model HTTP body timeout to 60s and shorten the default MCP request timeout to 2 minutes.
  • 8c24138: Raise the default agent config.iteration_limit from 100 to 512.
  • b6a7781: Raise the default model HTTP headers timeout to 60 seconds so slow first-token responses are not dropped.
  • 06884d0: Raise the default model HTTP headers and body timeouts to 2 minutes so slow first-token and idle stream responses are not dropped.

0.178.0-rc.2

Patch Changes

  • 06884d0: Raise the default model HTTP headers and body timeouts to 2 minutes so slow first-token and idle stream responses are not dropped.

0.178.0-rc.1

Patch Changes

  • 8b6c4bf: Raise the default model HTTP body timeout to 60s and shorten the default MCP request timeout to 2 minutes.
  • 8c24138: Raise the default agent config.iteration_limit from 100 to 512.
  • b6a7781: Raise the default model HTTP headers timeout to 60 seconds so slow first-token responses are not dropped.

0.177.0

Patch Changes

  • 5b7abb6: Default sandbox environment on provider configure (with provider status-column drop), capabilities/resolve via default env status, and a controller loop that builds the latest pending environment version per env. Core: generic SandboxProvider/Sandbox, HarnessSandbox, and Daytona build/getBuildStatus on the provider.
  • 5b7abb6: Bump dependencies to address known vulnerabilities (Dependabot), including undici, AI SDK providers, zod, and related transitive fixes.
  • 5b7abb6: Reset in-flight sub-agents and open tool calls when a turn starts with a user message, without emitting public thread.done for cancelled children.
  • b9429a0: Raise the default model HTTP body timeout to 60s and shorten the default MCP request timeout to 2 minutes.
  • fc99f4e: Raise the default model HTTP headers timeout to 60 seconds so slow first-token responses are not dropped.
  • 4fde7e9: Split outbound HTTP into an agnostic SSRF createOutboundFetch plus separate generic/model/MCP Agents (OUTBOUND_HTTP_*, MODEL_HTTP_*, MCP_HTTP_*) with configurable connect/headers/body timeouts and retries.
  • 5b7abb6: Add sandbox-environment CRUD (tables, PUT upsert, subject ownership, soft-delete). Versions land as pending for a future controller. AgentSpec config.sandbox.environment_name names a caller-owned env; name default is reserved; delete returns 409 while agents reference it. Turn create clones the env snapshot (when built) and applies resources, env vars, and networking.
  • fde4d4a: Sync sandbox-environment networking secrets to Daytona org secrets on PUT (plaintext is never stored), keep Daytona refs in sandbox_environment_secret, and mount those secret names at sandbox create time.
  • 5b7abb6: Treat paused as a live turn. updateTurnNonTerminalState switches running and paused and appends turn.update without session metrics. Terminal writes and freezeAndGetTurn accept a paused tip. createTurn rejects a paused predecessor until it is frozen. updateTurnState is now updateTurnTerminalState.

0.177.0-rc.3

Patch Changes

  • fc99f4e: Raise the default model HTTP headers timeout to 60 seconds so slow first-token responses are not dropped.

0.177.0-rc.2

Patch Changes

  • b9429a0: Raise the default model HTTP body timeout to 60s and shorten the default MCP request timeout to 2 minutes.

0.177.0-rc.1

Patch Changes

  • 5b7abb6: Default sandbox environment on provider configure (with provider status-column drop), capabilities/resolve via default env status, and a controller loop that builds the latest pending environment version per env. Core: generic SandboxProvider/Sandbox, HarnessSandbox, and Daytona build/getBuildStatus on the provider.
  • 5b7abb6: Bump dependencies to address known vulnerabilities (Dependabot), including undici, AI SDK providers, zod, and related transitive fixes.
  • 5b7abb6: Reset in-flight sub-agents and open tool calls when a turn starts with a user message, without emitting public thread.done for cancelled children.
  • 4fde7e9: Split outbound HTTP into an agnostic SSRF createOutboundFetch plus separate generic/model/MCP Agents (OUTBOUND_HTTP_*, MODEL_HTTP_*, MCP_HTTP_*) with configurable connect/headers/body timeouts and retries.
  • 5b7abb6: Add sandbox-environment CRUD (tables, PUT upsert, subject ownership, soft-delete). Versions land as pending for a future controller. AgentSpec config.sandbox.environment_name names a caller-owned env; name default is reserved; delete returns 409 while agents reference it. Turn create clones the env snapshot (when built) and applies resources, env vars, and networking.
  • fde4d4a: Sync sandbox-environment networking secrets to Daytona org secrets on PUT (plaintext is never stored), keep Daytona refs in sandbox_environment_secret, and mount those secret names at sandbox create time.
  • 5b7abb6: Treat paused as a live turn. updateTurnNonTerminalState switches running and paused and appends turn.update without session metrics. Terminal writes and freezeAndGetTurn accept a paused tip. createTurn rejects a paused predecessor until it is frozen. updateTurnState is now updateTurnTerminalState.

0.3.0

Minor Changes

  • 829ac6e: Add OSS web-search provider settings and catalog (Parallel): singleton settings/catalog APIs, optional API key, and UI adapter without mode config so built-in web search works outside TrueFoundry mode.
  • cf55de9: Add Redis Sentinel + TLS with exclusive transport fail-fast (REDIS_CONNECTION DU). Redis is optional at config load for controller/migrate; server still requires it at connect. Sentinel shared-client errors no longer stop the peering heartbeat.

Patch Changes

  • 33cbe52: Default MCP tool approval to @write and @destructive again. Unlabeled tools still run without a pause unless named or covered by @all.
  • 4726a31: Let a session owner mark a session shared so any subject in the tenant can read it by id, including turns and events (not subscribe or sandbox downloads).
  • 0c82412: Add POST /sessions/{session_id}/turns/{turn_id}/events for tip HITL / policy events.
  • 5adde28: Add turn_inbound_events store API for durable tip HITL send-event inbox (insert / list unconsumed / mark consumed), with Postgres and SQLite migrations.
  • bbc4f7d: Add user.mcp_auth_continue ({ "type": "user.mcp_auth_continue" }) on POST /events, session events, and the SSE stream. Add paused to turn state.
  • b342a21: Add user.tool_approval_policy send-event schema (allow_session, optional ISO expire_at). Send-only like user.tool_approval / user.tool_response — not on the durable stream.
  • 5b209be: Persist exact streamed reasoning_content on model.message session events (omit from thread context).
  • 1b1050a: [truefoundry] Surface nested Error.cause and the sandbox URL when TFY sandbox fetch calls fail, so undici "fetch failed" errors include ECONNREFUSED (and similar) instead of an opaque message. Log when a TFY sandbox file upload starts and finishes.

0.3.0-rc.0

Minor Changes

  • 829ac6e: Add OSS web-search provider settings and catalog (Parallel): singleton settings/catalog APIs, optional API key, and UI adapter without mode config so built-in web search works outside TrueFoundry mode.
  • cf55de9: Add Redis Sentinel + TLS with exclusive transport fail-fast (REDIS_CONNECTION DU). Redis is optional at config load for controller/migrate; server still requires it at connect. Sentinel shared-client errors no longer stop the peering heartbeat.

Patch Changes

  • 5b209be: Persist exact streamed reasoning_content on model.message session events (omit from thread context).
  • 1b1050a: [truefoundry] Surface nested Error.cause and the sandbox URL when TFY sandbox fetch calls fail, so undici "fetch failed" errors include ECONNREFUSED (and similar) instead of an opaque message. Log when a TFY sandbox file upload starts and finishes.

0.2.1

Patch Changes

  • f905d9f: Keep a shared remote MCP transport open while sibling tool calls are in flight so a session-expired reset cannot fail them with a non-retried close error.
  • 6a97f6a: Block RFC1918, CGNAT, reserved, link-local, and loopback destinations on outbound MCP and model-provider HTTP, plus in-cluster hostnames, with optional host allow/block lists and NETWORK_POLICY_ENABLED (default on).
  • e5e651c: Upload TFY sandbox files via POST /files/upload so large files are not stuffed onto exec argv.

0.2.0

Minor Changes

  • a70543b: Agent access is decided only by the Authorizer: standalone/OIDC lets everyone list and use agents and restricts update/delete to the creator; TrueFoundry uses external permissions api.

    You can read a session, turn, events, metrics, schedule, or its runs if you created it, or if you manage the named agent it is bound to. Creating still requires permission to use that agent. Only the creator can update, delete, or cancel a session, create a turn, or download sandbox files. Only the creator can update, delete, pause, resume, or run a schedule. An OIDC settings admin can no longer see other users' schedules.

  • 9bfcdaa: Replace string creator fields (created_by / triggered_by) with a non-null created_by_subject JSON object on agent, session, schedule, and schedule_run. Ownership and list filters use tenant_id + created_by_subject.subject_id.

  • 0297727: Add context-management compaction triggers with model-aware defaults and migrate persisted legacy token thresholds.

  • 8f1a2dc: [truefoundry] Add a TrueFoundry-managed model registry. When TRUEFOUNDRY_SERVICEFOUNDRY_SERVER_URL is set, models are listed from the TrueFoundry ServiceFoundry server and turns are routed through the tenant's default AI Gateway with the caller's token. Mutually exclusive with OIDC. Supports internal mutual TLS to the ServiceFoundry server via TRUEFOUNDRY_MTLS_ENABLED/TRUEFOUNDRY_MTLS_CERTS_DIR.

  • e4c4b56: Add built-in web search/fetch system tools (Parallel via parallel-web), gated by AgentSpec.config.web_search (default off) and TrueFoundry-mode host env TRUEFOUNDRY_WEB_SEARCH_PROVIDER. New drafts seed web_search.enabled from /capabilities when a provider is configured.

Patch Changes

  • 354991d: Prefer OpenUI for inline charts over sandbox plot images when OpenUI is available.
  • fad55d8: Persist turn ownership as active_executor_id on the turn row, mint plain ULID turn ids, and peer cancel via the DB owner instead of embedding the executor in the turn id.
  • d89b2ff: Persist zero-initialized metrics on agent sessions.
  • 172bf14: Add caller-scoped session metrics meters, charts, and chart-data under /internal/metrics via a server-owned ISessionMetricsStore.
  • d89b2ff: Fold session metrics totals on createTurn and terminal writes.
  • db37b6e: Sandbox skills: unify git and registry mounts onto .tfy-desired-skills.json (SkillMounter + skill_downloader), and always attach a mounter so existing skills are cleaned up.
  • 762ecc0: [truefoundry] TrueFoundry skills catalog: proxy GET /skills and /skills/versions from ServiceFoundry; settings skill writes return 424. SkillManifest is a type-discriminated oneOf of GitSkill | TrueFoundryRegistrySkill (type: truefoundry; name is FQN, display_name is short). AvailableSkill exposes optional metadata (display_name, repository_name, version). AgentSpec skill refs allow opaque FQN names, optional preload (registry), and max 50. UI draft skill mounts map catalog id to AgentSpec name.
  • fc38f74: AgentSpec skills: TrueFoundry save/turn resolve via SFY; standalone git validate/resolve on the skill store.
  • 01ee934: Abort timed-out remote MCP client.connect() so the handshake does not leak sockets.
  • 940c4e5: Prefer MCP Python SDK 2.0 snake_case tool annotation fields, with camelCase fallback for older SDKs, without changing destructive-tool detection behavior.
  • c40129c: Cap Daytona status-refresh calls at 1 minute so a stalled provider cannot hang request handlers.
  • a655537: Update published dependency ranges (AI SDK, Hono, MCP SDK, Redis, assistant-ui, and related packages).
  • 4111287: Add POST /api/internal/list-permissions via Authorizer.getPermissions (owner grants for schedules/sessions; agents include USE, with TrueFoundry agents mapped from SFY USE_AGENT/MANAGE_AGENT/DELETE_AGENT).
  • a000b47: List sessions accepts metadata[key]=value query params (OpenAPI deepObject) for exact metadata containment filtering. Bare JSON-string metadata query params are rejected. Metadata keys are limited to 32 characters and cannot include [] or whitespace so they do not collide with the bracket query form.
  • 551b6a8: Default MCP tool approval to @destructive only. Selecting Other/read-only tools clears approval; selecting destructive tools keeps it on. Migrate mounts still carrying the old @write+@destructive default.
  • 2cb51a5: Raise remote MCP undici bodyTimeout to 30m so idle SSE streams are not killed at 5m; warn on Body Timeout and stringify other transport errors.
  • c83145a: Abort remote MCP HTTP response bodies over 50MB (MCP_TOOL_CALL_MAX_RESPONSE_BYTES) so oversized tool results cannot OOM the process.
  • 0ec8dc6: Omit session total_cost_in_usd when cost is unavailable (instead of defaulting to 0), matching turn metrics.
  • bf5233d: Fail Redis request-reply waits when the executor heartbeat expires during polling instead of waiting until replyTimeoutMs.
  • a36ffaf: Namespace all Redis keys and pub/sub channels under tfg: so TrueForge can share a Redis instance without colliding with other apps.
  • 38ce068: Add tenant-unique optional session external_id, Sessions.getOrCreateByExternalId, and an idempotent POST /internal/sessions/get-or-create-by-external-id endpoint and SDK method.
  • b654052: Add caller-owned session metadata (Record<string, string> with size limits) on create, update, and read. Persist as a new session.metadata jsonb column; leave session custom unchanged.
  • 11865b4: Add optional session source. Persist as nullable JSONB with a list filter index; expose on session responses and list via source_type / source_id. Schedule dispatch sets source on create; public create/update do not accept it.
  • 44f9cbe: [truefoundry] TrueFoundry mode: env-backed Daytona | truefoundry sandbox via TRUEFOUNDRY_SANDBOX_* (static SETTINGS JSON). Settings OpenAPI stays Daytona-only (SandboxProviderManifest); truefoundry is store-internal (StoredSandboxProviderManifest).
  • ba79ce5: [truefoundry] Add TFY sandbox agent instructions to discover the working directory via pwd before writing files.
  • afe816e: [truefoundry] Default cache_control to { type: 'ephemeral' } for truefoundry provider model calls (overridable via request body).
  • a5f220f: Dedupe LLM resolve within a turn so parent and sub-agents sharing a model name call deps.llm once.
  • a655537: Add a turn.update event schema with paused/running status and action_required_on_events.
  • 5d72138: Keep npx @truefoundry/trueforge working on native Windows: import Kysely migrations with pathToFileURL, and keep sandbox guest paths POSIX. Source development stays Unix/WSL; CI also runs unit and SQLite store tests on Windows.

0.2.0-rc.6

Minor Changes

  • e4c4b56: Add built-in web search/fetch system tools (Parallel via parallel-web), gated by AgentSpec.config.web_search (default off) and TrueFoundry-mode host env TRUEFOUNDRY_WEB_SEARCH_PROVIDER. New drafts seed web_search.enabled from /capabilities when a provider is configured.

Patch Changes

  • 551b6a8: Default MCP tool approval to @destructive only. Selecting Other/read-only tools clears approval; selecting destructive tools keeps it on. Migrate mounts still carrying the old @write+@destructive default.
  • c83145a: Abort remote MCP HTTP response bodies over 50MB (MCP_TOOL_CALL_MAX_RESPONSE_BYTES) so oversized tool results cannot OOM the process.
  • a655537: Add a turn.update event schema with paused/running status and action_required_on_events.

0.2.0-rc.5

Patch Changes

  • 01ee934: Abort timed-out remote MCP client.connect() so the handshake does not leak sockets.
  • 2cb51a5: Raise remote MCP undici bodyTimeout to 30m so idle SSE streams are not killed at 5m; warn on Body Timeout and stringify other transport errors.
  • bf5233d: Fail Redis request-reply waits when the executor heartbeat expires during polling instead of waiting until replyTimeoutMs.

0.2.0-rc.4

Patch Changes

  • ba79ce5: [truefoundry] Add TFY sandbox agent instructions to discover the working directory via pwd before writing files.

0.2.0-rc.3

Patch Changes

  • db37b6e: Sandbox skills: unify git and registry mounts onto .tfy-desired-skills.json (SkillMounter + skill_downloader), and always attach a mounter so existing skills are cleaned up.
  • 762ecc0: [truefoundry] TrueFoundry skills catalog: proxy GET /skills and /skills/versions from ServiceFoundry; settings skill writes return 424. SkillManifest is a type-discriminated oneOf of GitSkill | TrueFoundryRegistrySkill (type: truefoundry; name is FQN, display_name is short). AvailableSkill exposes optional metadata (display_name, repository_name, version). AgentSpec skill refs allow opaque FQN names, optional preload (registry), and max 50. UI draft skill mounts map catalog id to AgentSpec name.
  • fc38f74: AgentSpec skills: TrueFoundry save/turn resolve via SFY; standalone git validate/resolve on the skill store.
  • 4111287: Add POST /api/internal/list-permissions via Authorizer.getPermissions (owner grants for schedules/sessions; agents include USE, with TrueFoundry agents mapped from SFY USE_AGENT/MANAGE_AGENT/DELETE_AGENT).
  • a36ffaf: Namespace all Redis keys and pub/sub channels under tfg: so TrueForge can share a Redis instance without colliding with other apps.
  • 44f9cbe: [truefoundry] TrueFoundry mode: env-backed Daytona | truefoundry sandbox via TRUEFOUNDRY_SANDBOX_* (static SETTINGS JSON). Settings OpenAPI stays Daytona-only (SandboxProviderManifest); truefoundry is store-internal (StoredSandboxProviderManifest).
  • afe816e: [truefoundry] Default cache_control to { type: 'ephemeral' } for truefoundry provider model calls (overridable via request body).
  • a5f220f: Dedupe LLM resolve within a turn so parent and sub-agents sharing a model name call deps.llm once.

0.2.0-rc.2

Patch Changes

  • a000b47: List sessions accepts metadata[key]=value query params (OpenAPI deepObject) for exact metadata containment filtering. Bare JSON-string metadata query params are rejected. Metadata keys are limited to 32 characters and cannot include [] or whitespace so they do not collide with the bracket query form.
  • 0ec8dc6: Omit session total_cost_in_usd when cost is unavailable (instead of defaulting to 0), matching turn metrics.
  • 11865b4: Add optional session source. Persist as nullable JSONB with a list filter index; expose on session responses and list via source_type / source_id. Schedule dispatch sets source on create; public create/update do not accept it.
  • 5d72138: Keep npx @truefoundry/trueforge working on native Windows: import Kysely migrations with pathToFileURL, and keep sandbox guest paths POSIX. Source development stays Unix/WSL; CI also runs unit and SQLite store tests on Windows.

0.2.0-rc.1

Minor Changes

  • a70543b: Agent access is decided only by the Authorizer: standalone/OIDC lets everyone list and use agents and restricts update/delete to the creator; TrueFoundry uses external permissions api.

    You can read a session, turn, events, metrics, schedule, or its runs if you created it, or if you manage the named agent it is bound to. Creating still requires permission to use that agent. Only the creator can update, delete, or cancel a session, create a turn, or download sandbox files. Only the creator can update, delete, pause, resume, or run a schedule. An OIDC settings admin can no longer see other users' schedules.

  • 9bfcdaa: Replace string creator fields (created_by / triggered_by) with a non-null created_by_subject JSON object on agent, session, schedule, and schedule_run. Ownership and list filters use tenant_id + created_by_subject.subject_id.

  • 8f1a2dc: [truefoundry] Add a TrueFoundry-managed model registry. When TRUEFOUNDRY_SERVICEFOUNDRY_SERVER_URL is set, models are listed from the TrueFoundry ServiceFoundry server and turns are routed through the tenant's default AI Gateway with the caller's token. Mutually exclusive with OIDC. Supports internal mutual TLS to the ServiceFoundry server via TRUEFOUNDRY_MTLS_ENABLED/TRUEFOUNDRY_MTLS_CERTS_DIR.

Patch Changes

  • d89b2ff: Persist zero-initialized metrics on agent sessions.
  • 172bf14: Add caller-scoped session metrics meters, charts, and chart-data under /internal/metrics via a server-owned ISessionMetricsStore.
  • d89b2ff: Fold session metrics totals on createTurn and terminal writes.
  • c40129c: Cap Daytona status-refresh calls at 1 minute so a stalled provider cannot hang request handlers.
  • 38ce068: Add tenant-unique optional session external_id, Sessions.getOrCreateByExternalId, and an idempotent POST /internal/sessions/get-or-create-by-external-id endpoint and SDK method.
  • b654052: Add caller-owned session metadata (Record<string, string> with size limits) on create, update, and read. Persist as a new session.metadata jsonb column; leave session custom unchanged.

0.2.0-rc.0

Minor Changes

  • 0297727: Add context-management compaction triggers with model-aware defaults and migrate persisted legacy token thresholds.

Patch Changes

  • 940c4e5: Prefer MCP Python SDK 2.0 snake_case tool annotation fields, with camelCase fallback for older SDKs, without changing destructive-tool detection behavior.
  • a655537: Update published dependency ranges (AI SDK, Hono, MCP SDK, Redis, assistant-ui, and related packages).

0.1.4

Patch Changes

  • 42eee39: Enable a standalone in-memory local sandbox fallback (no settings row), persist fancy v1:type:raw sandbox ids, drop tenant-prefix ownership checks, keep TFY sandbox writes cwd-relative (no /opt / /usr/local), let each sandbox provider own PATH (no hardcoded Daytona tail in Sandbox), and grant only the Code Mode socket parent in SRT (not host /tmp).
  • d7a640f: Align OpenAPI type names across AgentSpec, settings, catalogs, and chat pickers: Catalog/Configured/Available resource views, AgentSpec nested Model/Skill/InitialUserMessage, PutRequest → UpdateRequest, MCP acronym casing, GetMeResponse, and explicit names for nested AgentSpec/capabilities schemas.
  • 7ae5376: Update SANDBOX_IMAGE_URI to the image pushed by CI.
  • 889caca: Persist model.message with omitted null content and deferred call_tool wrapper tool_info, matching the live stream.
  • 2ca7fb2: Remove unused config.sandbox.network_policy (git auth inject) from the public AgentSpec.
  • 43d780e: Load SANDBOX_IMAGE_URI from sandboxImage.json so CI can rewrite the pin.

0.1.4-rc.0

Patch Changes

  • 42eee39: Enable a standalone in-memory local sandbox fallback (no settings row), persist fancy v1:type:raw sandbox ids, drop tenant-prefix ownership checks, keep TFY sandbox writes cwd-relative (no /opt / /usr/local), let each sandbox provider own PATH (no hardcoded Daytona tail in Sandbox), and grant only the Code Mode socket parent in SRT (not host /tmp).
  • d7a640f: Align OpenAPI type names across AgentSpec, settings, catalogs, and chat pickers: Catalog/Configured/Available resource views, AgentSpec nested Model/Skill/InitialUserMessage, PutRequest → UpdateRequest, MCP acronym casing, GetMeResponse, and explicit names for nested AgentSpec/capabilities schemas.
  • 7ae5376: Update SANDBOX_IMAGE_URI to the image pushed by CI.
  • 889caca: Persist model.message with omitted null content and deferred call_tool wrapper tool_info, matching the live stream.
  • 2ca7fb2: Remove unused config.sandbox.network_policy (git auth inject) from the public AgentSpec.
  • 43d780e: Load SANDBOX_IMAGE_URI from sandboxImage.json so CI can rewrite the pin.

0.1.3

Patch Changes

  • 08700d1: Pin mcp==1.29.0 in the sandbox image so Code Mode can import mcp.types.
  • c546350: Pass tenantName on SandboxOptions instead of injecting TFY_TENANT_NAME via exec env.

0.1.2

Patch Changes

  • 363a522: Wire shared sandbox Code Mode once in SessionHandle from main toolSets before building threads.
  • 5b981ab: Cancel a session even when the owning executor is gone (restart) or Redis cannot confirm abort. Freeze the running turn in the store so a new turn can start. freezeAndGetTurn now takes the cancellation reason (barge-in stays cancelled-for-next-turn; explicit cancel stays client-cancelled). Redis timeout and transport failures still freeze, with a warning that the cancel is not clean.

0.1.1

Patch Changes

  • 69237db: Await Daytona snapshot registration on sandbox provider configure so auth failures return 422 instead of a false pending status, and keep GET status refreshes persisted.
  • 7783fc0: Instruct ask_user_question to mark a first option as (Recommended) when context clearly favors one.

0.1.0

Minor Changes

  • b56c003: Initial 0.1.0-rc.1 prerelease of all public packages.

0.1.0-rc.0

Minor Changes

  • b56c003: Initial 0.1.0-rc.1 prerelease of all public packages.