Repository navigation
Version Packages (rc) - #471
Merged
Merged
Conversation
github-actions
Bot
requested review from
bhaveshpatel640,
chiragjn,
debajyoti-truefoundry,
heerambavi1998,
sr07asthana and
thesujai
as code owners
August 27, 2026 09:05
github-actions
Bot
force-pushed
the
changeset-release/main
branch
3 times, most recently
from
August 28, 2026 08:14
92e1022 to
a17f05b
Compare
github-actions
Bot
requested review from
govindavashishtha,
kumarsks619,
qaifi-tf,
sajal-truefoundry,
sayan-truefoundry and
vinit-truefoundry
as code owners
August 28, 2026 08:14
github-actions
Bot
force-pushed
the
changeset-release/main
branch
15 times, most recently
from
August 31, 2026 19:58
42e6f7f to
1294bca
Compare
github-actions
Bot
force-pushed
the
changeset-release/main
branch
29 times, most recently
from
September 4, 2026 07:54
e1542c3 to
906a450
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.
mainis currently in pre mode so this branch has prereleases rather than normal releases. If you want to exit prereleases, runchangeset pre exitonmain.Releases
@truefoundry/trueforge@0.2.0-rc.1
Minor Changes
8491843: Add a slot-driven agent Metrics tab with aggregate cards, time-range filtering, and Harness-backed line charts.
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.
49164e7: Add optional mutual TLS for the HTTPS listener and schedule controller→server hop via
TRUEFORGE_MTLS_ENABLED/TRUEFORGE_MTLS_CERTS_DIR. Off by default; independent of ServiceFoundryTRUEFOUNDRY_MTLS_*.9bfcdaa: Replace string creator fields (
created_by/triggered_by) with a non-nullcreated_by_subjectJSON object on agent, session, schedule, and schedule_run. Ownership and list filters usetenant_id+created_by_subject.subject_id.a3a1395: Adds first-class cron schedules for existing agents: persist them, manage them via /api/v1/schedules, validate cron policy at write time, and advance due runs through a single-dispatcher claim path.
4b1aa55: Enforce external agent authorization on agent list, get, snippets, update, delete, and referenced-agent use.
ef316d2: Add optional
OIDC_ALLOWED_EMAILSallowlist (exact addresses and*globs) so OIDC logins can be limited to approved emails or domains.2025cef: Store Postgres app tables and Kysely migration bookkeeping in a dedicated
trueforgeschema, with an automatic one-time move frompublicso existing installs keep their data and migration history.8f1a2dc: Add a TrueFoundry-managed model registry. When
TRUEFOUNDRY_SERVICEFOUNDRY_SERVER_URLis 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 viaTRUEFOUNDRY_MTLS_ENABLED/TRUEFOUNDRY_MTLS_CERTS_DIR.4137af1: Unify request-scoped RequestContext across standalone, OIDC, and TrueFoundry auth.
/auth/mereturns{ data: { type, tenant_id, subject, roles } }(typeisoidc-connected|default; OpenAPI/SDK regen deferred to CI).Patch Changes
/internal/metricsvia a server-ownedISessionMetricsStore.agent.metadataon Postgres and SQLite; storeupdateAgentcan patch manifest and/or metadata.external_id(string | nullon create) with a tenant-scoped partial unique index (Postgres and SQLite).external_id. FilterlistAgentsbyexternal_ids. Keep general ServiceFoundry HTTP at 10s and agent CRUD calls at 3s.agent.metadata; remote identity is stored inexternal_id.tfgandtrueforgein create requests.dbfor TrueFoundryAgentStore advisory-lock transactions.dist/controller-main.js) that runs the periodic control loops (schedule dispatch) as a single-replica process for distributed mode (STANDALONE=false). It targets the server API via the newSERVER_URLenv (defaulthttp://localhost:$PORT). Standalone mode keeps running the controller inside the server process.created_by_meto list sessions and list schedules so callers can restrict results to resources they created (excluding managed-agent visibility).VITE_BASE_PATHapply to both the UI public path and API/auth URLs (defaults to/).resolveInvokeHeadersontoIMcpServerWithAuthStore(notIMcpServerStore) so DB backends stay CRUD-only and turn/MCP invoke paths take the request-scoped with-auth store for configured headers and TrueFoundry gateway Bearer.IMcpServerStore) from Connect UX auth (IMcpServerWithAuthStore/McpServerWithAuthStore) so DB backends stay CRUD + OAuth client columns while authorize/status/revoke compose in via a token store.POSTGRES_SSL_MODEassslmodeon the Postgres connection URL.DATABASE_URLfor hosted mode so managed Postgres (e.g. Railway) can be wired without discretePOSTGRES_*vars.agent_idonschedule(backfilled fromagent), FK toagent(id)ON DELETE CASCADE (replacing the(tenant_id, agent_name)FK), and(tenant_id, agent_id)index for per-agent listing.limit/page_token) and filters by comma-separatedagent_names.scheduled_forfirst), with the same creator-or-admin access as other schedule routes.external_id,Sessions.getOrCreateByExternalId, and an idempotentPOST /internal/sessions/get-or-create-by-external-idendpoint and SDK method.metadata(Record<string, string>with size limits) on create, update, and read. Persist as a newsession.metadatajsonb column; leave sessioncustomunchanged.code/erroron the FE landing like local DCR success/failure.resolveInvokeHeaders), so gateway Bearer comes from the request-scoped store rather than being threaded through turn/tools APIs.x-tfg-mcp-headers, merged into the invoke headers for the named server. Lets a caller that authenticates as one identity give each MCP server the identity it should actually see.@truefoundry/trueforge-core@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-nullcreated_by_subjectJSON object on agent, session, schedule, and schedule_run. Ownership and list filters usetenant_id+created_by_subject.subject_id.8f1a2dc: Add a TrueFoundry-managed model registry. When
TRUEFOUNDRY_SERVICEFOUNDRY_SERVER_URLis 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 viaTRUEFOUNDRY_MTLS_ENABLED/TRUEFOUNDRY_MTLS_CERTS_DIR.Patch Changes
/internal/metricsvia a server-ownedISessionMetricsStore.external_id,Sessions.getOrCreateByExternalId, and an idempotentPOST /internal/sessions/get-or-create-by-external-idendpoint and SDK method.metadata(Record<string, string>with size limits) on create, update, and read. Persist as a newsession.metadatajsonb column; leave sessioncustomunchanged.@truefoundry/trueforge-ui@0.3.0-rc.1
Minor Changes
?tab=so opening an agent lands on Overview.listMcppages via DraftCatalogProvider.is_create_agentdrives resume from the sessions browser.@truefoundry/assistant-ui-runtimeto0.1.25./scheduleswith listing, popover-based filters, and create/edit drawer wired to the schedule API. New schedules save as paused, open a Test Schedule review with MCP connect status, and support Activate Anyway. List schedules uses server token pagination and multi-agent filters. Agents shows a Schedules count column (warning when any are paused) loaded via a batched list for on-screen agents. Add Table primitives with client-side and token pagination plus portal DropdownMenu so row actions are not clipped by overflow. Export a reusable popover select with single- and multi-select modes.TRUEFOUNDRY_SERVICEFOUNDRY_SERVER_URLis 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 viaTRUEFOUNDRY_MTLS_ENABLED/TRUEFOUNDRY_MTLS_CERTS_DIR.Patch Changes
agent-2glyph on the agents-library trigger, and squared-off chrome-action geometry on the save-agent trigger. Also fixesagent-2.svgto usecurrentColorso it is legible in dark mode.client.internal.agents.getCodeSnippetsinstead of a rawclient.fetch.{name}-copyvia saveAgent), Manage Schedules, and Delete (wired through harnessdeleteAgent).SyntaxHighlighter/AgentCodeBlock) copy control uses the bordered secondary button, and a trailing source newline no longer paints an empty last line while Copy still keeps the exact source.trueforgetheme font and load it from Google Fonts when styles are injected./sessions/:id+ square-arrow-out-up-right); without a router it keeps the in-shell resume fallback.isNew=true, then clear the flag from the URL./settingsroute when Settings chrome is unavailable (no catalog orcapabilities.settings.enabledis false), matching the sidebar Settings button gate.code/erroron the FE landing like local DCR success/failure.PageHeaderacross chat and list chrome so title size/height stay consistent, and drop decorative title icons.@truefoundry/trueforge-sdk@0.1.4-rc.1
Patch Changes
created_by_meto list sessions and list schedules so callers can restrict results to resources they created (excluding managed-agent visibility).internal.agents.getCodeSnippetsAPI under the new SDKinternalnamespace.external_id,Sessions.getOrCreateByExternalId, and an idempotentPOST /internal/sessions/get-or-create-by-external-idendpoint and SDK method.metadata(Record<string, string>with size limits) on create, update, and read. Persist as a newsession.metadatajsonb column; leave sessioncustomunchanged.code/erroron the FE landing like local DCR success/failure.Note
High Risk
Merging publishes an RC that bundles auth/RBAC, database schema moves, creator-field migrations, schedules dispatch, and TrueFoundry integration—high blast radius for upgrades even though this PR is mostly version/changelog metadata.
Overview
This is an automated Changesets prerelease PR: it does not implement new product code in the diff, but cuts and documents the next RC npm publish by bumping package versions, syncing OpenAPI
info.version, and refreshing SDKUser-Agent/ Fern headers.@truefoundry/trueforge@0.2.0-rc.1 (with trueforge-core and trueforge-sdk@0.1.4-rc.1, trueforge-ui@0.3.0-rc.1) rolls up a large batch already on
main: Authorizer-centric RBAC andcreated_by_subjectownership, cron schedules plus a separate controller entrypoint, Postgrestrueforgeschema migration, TrueFoundry model registry / MCP gateway wiring, session metadata and external_id, internal session metrics, OIDC email allowlists, optional mTLS, and broad UI work (agent library detail tabs, global Schedules/Sessions pages, metrics tab, New Chat vs New Agent split).OpenAPI JSON in
.github/fern/openapi/anddocs/moves 0.2.0-rc.0 → 0.2.0-rc.1 to match the server package.Reviewed by Cursor Bugbot for commit 0fbdd35. Bugbot is set up for automated code reviews on this repo. Configure here.