Version Packages (rc)

[github-actions]

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.

⚠️⚠️⚠️⚠️⚠️⚠️

main is currently in pre mode so this branch has prereleases rather than normal releases. If you want to exit prereleases, run changeset pre exit on main.

⚠️⚠️⚠️⚠️⚠️⚠️

Releases

@truefoundry/trueforge@0.2.0-rc.1

Minor Changes

• 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.
• ef316d2: Add optional OIDC_ALLOWED_EMAILS allowlist (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 trueforge schema, with an automatic one-time move from public so existing installs keep their data and migration history.
• 8f1a2dc: 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.
• a60f4c2: Add GET /api/v1/agents/{agent_id}/code-snippets with TypeScript TrueForge SDK stream and non-stream samples.
• 58940a7: Report a Daytona key that cannot register snapshots as missing key permissions (403) instead of an invalid API key (422), and name the grants to add in the Daytona dashboard.
• c40129c: Cap Daytona status-refresh calls at 1 minute so a stalled provider cannot hang request handlers.
• f4fb4bd: Accept DATABASE_URL for hosted mode so managed Postgres (e.g. Railway) can be wired without discrete POSTGRES_* vars.
• 3bc2ed8: List schedules is token-paginated (limit / page_token) and filters by comma-separated agent_names.
• feb94aa: Add GET /api/v1/schedules/{schedule_id}/runs to list a schedule's runs (newest scheduled_for first), with the same creator-or-admin access as other schedule routes.
• 8e64757: Add POST /api/v1/schedules/runs to trigger an immediate schedule run
• 4ced8ef: Dispatch schedule runs through the session/turn API: get-or-create a session keyed by run id, then create a turn only when that session has none.
• 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.
• Updated dependencies [648273b]
• Updated dependencies [d89b2ff]
• Updated dependencies [648273b]
• Updated dependencies [172bf14]
• Updated dependencies [d89b2ff]
• Updated dependencies [c40129c]
• Updated dependencies [52987a7]
• Updated dependencies [38ce068]
• Updated dependencies [8f1a2dc]
  • @truefoundry/trueforge-sdk@0.1.4-rc.1
  • @truefoundry/trueforge-core@0.2.0-rc.1

@truefoundry/trueforge-core@0.2.0-rc.1

Minor Changes

• 8f1a2dc: 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.

@truefoundry/trueforge-ui@0.3.0-rc.1

Minor Changes

• a189482: Add routed agent detail pages with lazy Overview, Sessions, and Use In Code tabs backed by the optional AgentSessionsServer port and built-in TrueForge adapter.
• a189482: Add the agent library Sessions tab and an all-user Sessions sidebar page (including drafts) with agent and time filters, shareable query params, and the same two-pane timeline. Library agent details keep the active tab in ?tab= so opening an agent lands on Overview.
• 8f1a2dc: 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

• a189482: Load agent Use In Code snippets through client.internal.agents.getCodeSnippets instead of a raw client.fetch.
• Updated dependencies [648273b]
• Updated dependencies [648273b]
• Updated dependencies [52987a7]
• Updated dependencies [38ce068]
  • @truefoundry/trueforge-sdk@0.1.4-rc.1

@truefoundry/trueforge-sdk@0.1.4-rc.1

Patch Changes

• 648273b: Regenerate SDK from updated OpenAPI spec.
• 648273b: Regenerate SDK from updated OpenAPI spec.
• 52987a7: Add internal.agents.getCodeSnippets API under the new SDK internal namespace.
• 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.

---

Note

High Risk
The release bundles auth allowlisting, a Postgres schema migration, OIDC-exclusive AI Gateway routing, and schedule dispatch into sessions—areas that affect security, data layout, and production behavior even though this PR only bumps versions.

Overview
Automated Changesets release PR that bumps @truefoundry/trueforge, trueforge-core, trueforge-ui, and trueforge-sdk from rc.0 → rc.1, updates package CHANGELOG entries, sets OpenAPI info.version to 0.2.0-rc.1, and refreshes SDK User-Agent / Fern version headers.

The diff is mostly versioning and release notes; merging publishes the accumulated feature work described in those changelogs—not new runtime code in this branch.

Server (@truefoundry/trueforge 0.2.0-rc.1): agent cron schedules (/api/v1/schedules, pagination, run listing, manual runs, session/turn dispatch), optional OIDC_ALLOWED_EMAILS, Postgres tables moved into a dedicated trueforge schema with a one-time migration from public, TrueFoundry-managed models via ServiceFoundry / AI Gateway (mutually exclusive with OIDC, optional mTLS), session external_id + idempotent get-or-create, session metrics APIs under /internal/metrics, agent code-snippets GET route, DATABASE_URL for hosted Postgres, and Daytona timeout/error tweaks.

UI (trueforge-ui 0.3.0-rc.1): routed agent detail pages (Overview / Sessions / Use In Code), library and global Sessions views with filters and shareable URLs, snippets via client.internal.agents.getCodeSnippets, plus the managed model registry UX.

SDK (0.1.4-rc.1): OpenAPI regen, internal.agents.getCodeSnippets, and Sessions.getOrCreateByExternalId.

^{Reviewed by Cursor Bugbot for commit c6becda. Bugbot is set up for automated code reviews on this repo. Configure here.}