The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Changelog
0.180.0
Patch Changes
- ca29d8f: Render lightbulb icon on Skills section header in Agent Config panel.
- 58d7159: Dense Agents library rows: nest creator under the name, two-line configuration, and per-page sessions/spend/14d sparkline/last-run when metrics are available.
- 7f2be59: Prefix public
AnalyticsEventsnames withtrueforge.so host sinks (e.g. PostHog) can namespace product events. - 58d7159: Keep the Build Agent config when starting a new chat, confirm before Reset, and honor a stored sandbox environment name.
- 0a1606d: Default the reasoning effort to
mediumwhen the selected model offers it, instead of defaulting to the lowest effort. TrueFoundry model listing now passesmergeParamsto the provider-integrations API so provider-level parameter defaults are included in each model's advertised parameters. - 2bbdf4e: Show the full model name in a tooltip when the new-chat model selector label is truncated.
- 6bf93de: Keep Build Agent skills selected after a turn by matching session FQN mounts against catalog attach keys and display names during draft preference reconcile.
- 99c39ee: Hide the session share URL when access is Only you.
- 58d7159: Route shared-session viewers to the read-only session view and hide in-flight turns.
- 942a0e5: Show the full MCP tool and skill description in a tooltip when the truncated label is hovered in the picker modals.
- f10e3b8: Default reasoning effort now follows
medium→high→lowin both the draft (New Chat) composer and the agent builder (Agent Config) when the selected model does not offermedium, instead of falling back to the lowest offered effort. - aa58442: Reject folder drops in chat attachments so they cannot block message send.
- aea048e: Clear instructions/MCP/skills when revisiting Build Agent after save, and add a Reset control on the chat header.
- c6ef7d1: Adopt the loaded session agent spec when resuming chat history so New Chat draft edits no longer PATCH over the saved sandbox environment; lock composer environment selection after a session exists; read/write sandbox
environmentNameso resumed chats show the correct environment; and keep showing a deleted environment from the agent spec. - 58d7159: Show check and triangle-alert icons on sandbox environment Ready and Failed status badges.
- 531350e: Emit
trueforge.sdk.http_timeoutwith the request endpoint for every SDK HTTP timeout, and show a clear "Request timed out" toast instead of "Something went wrong" with a bare "timeout" detail. - 5c22006: Show the session creator avatar in the sessions list meta row, with the subject name on hover.
- e4caefb: Surface cancelled turn reasons and failed sub-agents on the Agent Sessions timeline and metrics; project unfinished nested sub-agents as cancelled when the parent turn is already terminal, remap abort-shaped child thread.done errors (e.g. LLM stream aborted) to cancelled on cancelled turns, and close unfinished sub-agent chart bars at turn.done when thread.done is missing.
- 9208cc8: Allow tenant members to use sandbox environments created by other members while keeping update and delete actions restricted to the creator.
- 5da156a: Add a host-overridable Register Skills action next to the Skills modal title. The default slot waits for capabilities, routes to Settings → Skills or a platform URL, and hides when neither applies.
- 8d4cc1c: Show a full-pane "Unable to load session" for inaccessible session deep links and sessions-browser details instead of toasting and redirecting away.
- Updated dependencies [5d9b938]
- Updated dependencies [aa58442]
- Updated dependencies [c6ef7d1]
- Updated dependencies [5c22006]
- Updated dependencies [e4caefb]
0.180.0-rc.5
Patch Changes
- f10e3b8: Default reasoning effort now follows
medium→high→lowin both the draft (New Chat) composer and the agent builder (Agent Config) when the selected model does not offermedium, instead of falling back to the lowest offered effort.
0.180.0-rc.4
Patch Changes
- 0a1606d: Default the reasoning effort to
mediumwhen the selected model offers it (falling back to the lowest real effort otherwise), instead of defaulting to the lowest effort. TrueFoundry model listing now passesmergeParamsto the provider-integrations API so provider-level parameter defaults are included in each model's advertised parameters.
0.180.0-rc.3
Patch Changes
- 58d7159: Dense Agents library rows: nest creator under the name, two-line configuration, and per-page sessions/spend/14d sparkline/last-run when metrics are available.
- 58d7159: Keep the Build Agent config when starting a new chat, confirm before Reset, and honor a stored sandbox environment name.
- 58d7159: Route shared-session viewers to the read-only session view and hide in-flight turns.
- 58d7159: Show check and triangle-alert icons on sandbox environment Ready and Failed status badges.
0.180.0-rc.2
Patch Changes
- Updated dependencies [5d9b938]
0.180.0-rc.1
Patch Changes
- ca29d8f: Render lightbulb icon on Skills section header in Agent Config panel.
- 7f2be59: Prefix public
AnalyticsEventsnames withtrueforge.so host sinks (e.g. PostHog) can namespace product events. - 2bbdf4e: Show the full model name in a tooltip when the new-chat model selector label is truncated.
- 6bf93de: Keep Build Agent skills selected after a turn by matching session FQN mounts against catalog attach keys and display names during draft preference reconcile.
- 99c39ee: Hide the session share URL when access is Only you.
- 942a0e5: Show the full MCP tool and skill description in a tooltip when the truncated label is hovered in the picker modals.
- aa58442: Reject folder drops in chat attachments so they cannot block message send.
- aea048e: Clear instructions/MCP/skills when revisiting Build Agent after save, and add a Reset control on the chat header.
- c6ef7d1: Adopt the loaded session agent spec when resuming chat history so New Chat draft edits no longer PATCH over the saved sandbox environment; lock composer environment selection after a session exists; read/write sandbox
environmentNameso resumed chats show the correct environment; and keep showing a deleted environment from the agent spec. - 531350e: Emit
trueforge.sdk.http_timeoutwith the request endpoint for every SDK HTTP timeout, and show a clear "Request timed out" toast instead of "Something went wrong" with a bare "timeout" detail. - 5c22006: Show the session creator avatar in the sessions list meta row, with the subject name on hover.
- e4caefb: Surface cancelled turn reasons and failed sub-agents on the Agent Sessions timeline and metrics; project unfinished nested sub-agents as cancelled when the parent turn is already terminal, remap abort-shaped child thread.done errors (e.g. LLM stream aborted) to cancelled on cancelled turns, and close unfinished sub-agent chart bars at turn.done when thread.done is missing.
- 9208cc8: Allow tenant members to use sandbox environments created by other members while keeping update and delete actions restricted to the creator.
- 5da156a: Add a host-overridable Register Skills action next to the Skills modal title. The default slot waits for capabilities, routes to Settings → Skills or a platform URL, and hides when neither applies.
- 8d4cc1c: Show a full-pane "Unable to load session" for inaccessible session deep links and sessions-browser details instead of toasting and redirecting away.
- Updated dependencies [aa58442]
- Updated dependencies [c6ef7d1]
- Updated dependencies [5c22006]
- Updated dependencies [e4caefb]
0.179.0
Patch Changes
- 1513e91: Show cancelled turn reasons in chat and session detail via an orange cancelled banner, projecting the wire reason on message metadata from turn.done (including live commits).
- bf619ad: Show Web search as a Built-in connector toggle in New Chat, persist an explicit chat draft choice across New Chat / reload, and restore capability-forced off only when the user never chose off.
- 18d4051: Keep draft spec sync on its existing debounce by flushing the agent config drawer only when it unmounts.
- 95f5c5c: Remove the sandbox-environments frontend feature flag and always enable environments UI.
- 6c07afa: Toast API errors when creating or updating a sandbox environment so failures are visible outside the drawer form.
- 84f71bf: Confirm before opening external markdown links or loading external markdown images, with per-host "Don't ask again" in localStorage.
- f5672f1: Show MCP auth resume turn boundaries and unanswered ask_user prompts in Sessions view.
- 1674b71: Allow opening model settings dropdown by clicking the model parameters summary in Agent Config.
- f0aa52d: Adopt the loaded session agent spec when resuming chat history so New Chat draft edits no longer PATCH over the saved sandbox environment; lock composer environment selection after a session exists; read/write sandbox
environmentNameso resumed chats show the correct environment; and keep showing a deleted environment from the agent spec. - 694a572: Reject duplicate sandbox environment names on create (POST) instead of overwriting via upsert.
- e25945d: Add configurable sandbox resource caps and limit environment variable and secret names in the UI.
- 6b42368: Point the Environments secrets "Learn more" link at the Sandbox docs section on how environment changes reach a running session.
- 09f07f0: Show the sandbox disabled-with-skills tooltip only on the switch, not the whole row.
- 7a81826: Explain higher session-level turn counts when the tip lineage is shorter than session total
- bbe23c8: Surface cancelled turn reasons and failed sub-agents on the Agent Sessions timeline and metrics; project unfinished nested sub-agents as cancelled when the parent turn is already terminal, remap abort-shaped child thread.done errors (e.g. LLM stream aborted) to cancelled on cancelled turns, and close unfinished sub-agent chart bars at turn.done when thread.done is missing.
- a2f2877: Allow tenant members to use sandbox environments created by other members while keeping update and delete actions restricted to the creator.
- Updated dependencies [1513e91]
- Updated dependencies [f5672f1]
- Updated dependencies [f0aa52d]
- Updated dependencies [694a572]
- Updated dependencies [bbe23c8]
0.179.0-rc.3
Patch Changes
- a2f2877: Allow tenant members to use sandbox environments created by other members while keeping update and delete actions restricted to the creator.
0.179.0-rc.2
Patch Changes
- f0aa52d: Adopt the loaded session agent spec when resuming chat history so New Chat draft edits no longer PATCH over the saved sandbox environment; lock composer environment selection after a session exists; read/write sandbox
environmentNameso resumed chats show the correct environment; and keep showing a deleted environment from the agent spec. - bbe23c8: Surface cancelled turn reasons and failed sub-agents on the Agent Sessions timeline and metrics; project unfinished nested sub-agents as cancelled when the parent turn is already terminal, remap abort-shaped child thread.done errors (e.g. LLM stream aborted) to cancelled on cancelled turns, and close unfinished sub-agent chart bars at turn.done when thread.done is missing.
- Updated dependencies [f0aa52d]
- Updated dependencies [bbe23c8]
0.179.0-rc.1
Patch Changes
- 1513e91: Show cancelled turn reasons in chat and session detail via an orange cancelled banner, projecting the wire reason on message metadata from turn.done (including live commits).
- bf619ad: Show Web search as a Built-in connector toggle in New Chat, persist an explicit chat draft choice across New Chat / reload, and restore capability-forced off only when the user never chose off.
- 18d4051: Keep draft spec sync on its existing debounce by flushing the agent config drawer only when it unmounts.
- 95f5c5c: Remove the sandbox-environments frontend feature flag and always enable environments UI.
- 6c07afa: Toast API errors when creating or updating a sandbox environment so failures are visible outside the drawer form.
- 84f71bf: Confirm before opening external markdown links or loading external markdown images, with per-host "Don't ask again" in localStorage.
- f5672f1: Show MCP auth resume turn boundaries and unanswered ask_user prompts in Sessions view.
- 1674b71: Allow opening model settings dropdown by clicking the model parameters summary in Agent Config.
- 694a572: Reject duplicate sandbox environment names on create (POST) instead of overwriting via upsert.
- e25945d: Add configurable sandbox resource caps and limit environment variable and secret names in the UI.
- 6b42368: Point the Environments secrets "Learn more" link at the Sandbox docs section on how environment changes reach a running session.
- 09f07f0: Show the sandbox disabled-with-skills tooltip only on the switch, not the whole row.
- 7a81826: Explain higher session-level turn counts when the tip lineage is shorter than session total
- Updated dependencies [1513e91]
- Updated dependencies [f5672f1]
- Updated dependencies [694a572]
0.178.0
Patch Changes
- 8578796: Remove the sandbox-environments frontend feature flag and always enable environments UI.
- 53de2fb: Encode sandbox artifact paths when building file-download links, so names containing spaces,
#,?,&,%or non-ASCII characters resolve to the intended file instead of a truncated or misparsed URL. - f55571c: Toast API errors when creating or updating a sandbox environment so failures are visible outside the drawer form.
- ef9b204: Polish Environments UI: hyphen for default Updated, Building status label, form-only create drawer, secrets docs link and allowed-hosts copy, hide Manage Environments when sandbox is off.
- 5300f50: Add a frontend feature flag for sandbox-environment management.
- 8c24138: Raise the default agent
config.iteration_limitfrom 100 to 512. - e452b06: Preserve token and cost metrics on failed and cancelled turns in the UI adapter and types so turn headers and session totals include billable usage from non-done terminal turns.
- d40c380: Remove YAML create/edit from the environment form drawer so environments are configured only through the UI form.
- 9bb142d: Reject duplicate sandbox environment names on create (POST) instead of overwriting via upsert.
- a82cd2b: Clarify the agent runtime Environment field description.
- 8578796: Add configurable sandbox resource caps and limit environment variable and secret names in the UI.
- 8578796: Point the Environments secrets "Learn more" link at the Sandbox docs section on how environment changes reach a running session.
- c2ccca5: Show clearer empty-state errors when schedules, agents, or environments fail to load, and map browser network noise to the fallback in getErrorMessage.
- 6d91541: Display session metadata at the top of the session detail header
- 8d39138: Add a host-pluggable analytics contract (
analytics.track/AnalyticsProvider) with a shared event catalog and first-wave click instrumentation. Hosts own the vendor sink; the SDK never ships PostHog. - fa99771: Show file-type icons, filenames, and sizes for composer and sent message attachments.
- Updated dependencies [8c24138]
- Updated dependencies [e452b06]
- Updated dependencies [68ea7ae]
- Updated dependencies [9bb142d]
- Updated dependencies [6d91541]
- Updated dependencies [d01ddc0]
0.178.0-rc.3
Patch Changes
- f55571c: Toast API errors when creating or updating a sandbox environment so failures are visible outside the drawer form.
- 9bb142d: Reject duplicate sandbox environment names on create (POST) instead of overwriting via upsert.
- Updated dependencies [9bb142d]
0.178.0-rc.2
Patch Changes
- 8578796: Remove the sandbox-environments frontend feature flag and always enable environments UI.
- 8578796: Add configurable sandbox resource caps and limit environment variable and secret names in the UI.
- 8578796: Point the Environments secrets "Learn more" link at the Sandbox docs section on how environment changes reach a running session.
0.178.0-rc.1
Patch Changes
- 53de2fb: Encode sandbox artifact paths when building file-download links, so names containing spaces,
#,?,&,%or non-ASCII characters resolve to the intended file instead of a truncated or misparsed URL. - ef9b204: Polish Environments UI: hyphen for default Updated, Building status label, form-only create drawer, secrets docs link and allowed-hosts copy, hide Manage Environments when sandbox is off.
- 5300f50: Add a frontend feature flag for sandbox-environment management.
- 8c24138: Raise the default agent
config.iteration_limitfrom 100 to 512. - e452b06: Preserve token and cost metrics on failed and cancelled turns in the UI adapter and types so turn headers and session totals include billable usage from non-done terminal turns.
- d40c380: Remove YAML create/edit from the environment form drawer so environments are configured only through the UI form.
- a82cd2b: Clarify the agent runtime Environment field description.
- c2ccca5: Show clearer empty-state errors when schedules, agents, or environments fail to load, and map browser network noise to the fallback in getErrorMessage.
- 6d91541: Display session metadata at the top of the session detail header
- 8d39138: Add a host-pluggable analytics contract (
analytics.track/AnalyticsProvider) with a shared event catalog and first-wave click instrumentation. Hosts own the vendor sink; the SDK never ships PostHog. - fa99771: Show file-type icons, filenames, and sizes for composer and sent message attachments.
- Updated dependencies [8c24138]
- Updated dependencies [e452b06]
- Updated dependencies [68ea7ae]
- Updated dependencies [6d91541]
- Updated dependencies [d01ddc0]
0.177.0
Patch Changes
- 3f55e56: Count all event turn.created rows (including MCP-auth resume turns) for the agent session detail strip Turns, Tokens, and Tool calls; keep transcript sections on renderable turns only. Stop overriding strip turn count from getSession metrics. Count pending human-wait tool calls (tool.response_required, e.g. ask-user) in strip Tool calls so they match Agent steps. Strip Tool calls counts only the main agent thread (sub-agent tool calls stay on the Sub-agents tile). Timeline/transcript turn bands fold non-renderable resume turns into the prior user turn (no phantom T2 / user markers). Compress idle between event-turns before folding display bands; aggregate cost/context/tooltip metrics per display band so MCP-auth resumes do not duplicate T1 chart keys or undercount tokens.
- d4bf49c: Polish MCP auth and Ask User pause chrome: lettered A/B/C options with Continue, outlined Connect, and screenshot-matching stack above the composer.
- 5b7abb6: Bump
monaco-editorto^0.57.0to address known vulnerabilities, and point the frontend Monaco worker plugin at the 0.56+ export paths so production builds resolve workers correctly. - 29e7aab: Add
DELETEfor settings catalog entries (model providers, MCP servers, skills), rejected with 409 naming the agents that still reference the entry; a model-provider update that drops a model in use is rejected the same way. Deleting an MCP server also clears its stored OAuth grants. Settings now confirms removals (including connectors) and keeps a refused removal's reason in the dialog; removing a provider's last model removes the provider. The connector list offers Connect on added-but-unauthenticated OAuth servers. - 5b7abb6: Preview sandbox files the assistant generates in the chat, in a side panel, and full page, instead of requiring a download to see them.
- d4bf49c: Keep the composer interactive during running and paused turns: Cancel only when empty, Send supersedes the prior client stream without cancelSession (preserving superseded in-flight turns in the transcript), and stacked pause chrome is abandoned after a later user message. Hosts that override ComposerSendButton and still branch only on isRunning should update to use hasContent.
- 01b27f0: Show cost-per-turn breakdown rows in the session metrics strip tooltip, and make tooltips interactive by default so rich popups stay open while hovering their content. Keep the timeline chart tooltip non-interactive so cursor-anchored hover is not stolen from the canvas.
- 5b7abb6: Avoid redundant list-permissions API calls by sharing tenant permission state through CanCreateAgentProvider.
- 029b6a9: Stop gating the Environments page on
listSandboxProvidersso create/update works when the sandbox provider is supplied externally or that catalog API returns 403. - 2b76ce3: Add Environments page for sandbox environment CRUD (
/environments), with UI Form and YAML editors, sidebar Envs nav, and a SandboxEnvironmentServer port. - 968b883: Add a frontend feature flag for sandbox-environment management.
- 7cc39c2: Support deep-linking the agents library with
?agent_name=to seed and sync the search box. - 7555c40: Make the sidebar layout mobile-friendly with a Claude-style nav drawer, show a desktop-only notice for Build Agent, Sessions, Schedules, and Environments on small screens, keep user message actions visible on touch (hover-only from
mdup), and show the Agents listing as cards on small screens. - b9429a0: Preserve token and cost metrics on failed and cancelled turns in the UI adapter and types so turn headers and session totals include billable usage from non-done terminal turns.
- 2b76ce3: Refresh agent environment pickers after Manage Environments create/activate/delete so the ready list does not stay stale while the draft UI stays mounted.
- 5b7abb6: Use session detail API metrics for the agent session strip Turns/Duration/Cost instead of list-row hints or turn-by-turn aggregation. Include optional totalCostInUsd on TurnDoneMetrics so turn.done cost matches the wire contract.
- 5b7abb6: Add a reload button before the agent filter on the Sessions page to fetch latest data without requiring a browser refresh.
- 2b76ce3: Update SandboxEnvironmentStatus from 'active' to 'ready' to align with backend environment version readiness, remove static default environment injection from draft selectors, fix sandbox provider readiness check latching false on EnvironmentsPage, and drain all sandbox environment pages with limit up to 1000 in agent draft pickers.
- Updated dependencies [5b7abb6]
- Updated dependencies [d4bf49c]
- Updated dependencies [d4bf49c]
- Updated dependencies [2b76ce3]
- Updated dependencies [5b7abb6]
- Updated dependencies [b9429a0]
- Updated dependencies [5b7abb6]
- Updated dependencies [fc99f4e]
- Updated dependencies [6813758]
- Updated dependencies [5b7abb6]
- Updated dependencies [5b7abb6]
- Updated dependencies [8057109]
- Updated dependencies [2b76ce3]
0.177.0-rc.5
Patch Changes
- Updated dependencies [8057109]
0.177.0-rc.4
Patch Changes
- Updated dependencies [fc99f4e]
0.177.0-rc.3
Patch Changes
- b9429a0: Preserve token and cost metrics on failed and cancelled turns in the UI adapter and types so turn headers and session totals include billable usage from non-done terminal turns.
- Updated dependencies [b9429a0]
0.177.0-rc.2
Patch Changes
- 968b883: Add a frontend feature flag for sandbox-environment management.
0.177.0-rc.1
Patch Changes
- 3f55e56: Count all event turn.created rows (including MCP-auth resume turns) for the agent session detail strip Turns, Tokens, and Tool calls; keep transcript sections on renderable turns only. Stop overriding strip turn count from getSession metrics. Count pending human-wait tool calls (tool.response_required, e.g. ask-user) in strip Tool calls so they match Agent steps. Strip Tool calls counts only the main agent thread (sub-agent tool calls stay on the Sub-agents tile). Timeline/transcript turn bands fold non-renderable resume turns into the prior user turn (no phantom T2 / user markers). Compress idle between event-turns before folding display bands; aggregate cost/context/tooltip metrics per display band so MCP-auth resumes do not duplicate T1 chart keys or undercount tokens.
- d4bf49c: Polish MCP auth and Ask User pause chrome: lettered A/B/C options with Continue, outlined Connect, and screenshot-matching stack above the composer.
- 5b7abb6: Bump
monaco-editorto^0.57.0to address known vulnerabilities, and point the frontend Monaco worker plugin at the 0.56+ export paths so production builds resolve workers correctly. - 29e7aab: Add
DELETEfor settings catalog entries (model providers, MCP servers, skills), rejected with 409 naming the agents that still reference the entry; a model-provider update that drops a model in use is rejected the same way. Deleting an MCP server also clears its stored OAuth grants. Settings now confirms removals (including connectors) and keeps a refused removal's reason in the dialog; removing a provider's last model removes the provider. The connector list offers Connect on added-but-unauthenticated OAuth servers. - 5b7abb6: Preview sandbox files the assistant generates in the chat, in a side panel, and full page, instead of requiring a download to see them.
- d4bf49c: Keep the composer interactive during running and paused turns: Cancel only when empty, Send supersedes the prior client stream without cancelSession (preserving superseded in-flight turns in the transcript), and stacked pause chrome is abandoned after a later user message. Hosts that override ComposerSendButton and still branch only on isRunning should update to use hasContent.
- 01b27f0: Show cost-per-turn breakdown rows in the session metrics strip tooltip, and make tooltips interactive by default so rich popups stay open while hovering their content. Keep the timeline chart tooltip non-interactive so cursor-anchored hover is not stolen from the canvas.
- 5b7abb6: Avoid redundant list-permissions API calls by sharing tenant permission state through CanCreateAgentProvider.
- 029b6a9: Stop gating the Environments page on
listSandboxProvidersso create/update works when the sandbox provider is supplied externally or that catalog API returns 403. - 2b76ce3: Add Environments page for sandbox environment CRUD (
/environments), with UI Form and YAML editors, sidebar Envs nav, and a SandboxEnvironmentServer port. - 7cc39c2: Support deep-linking the agents library with
?agent_name=to seed and sync the search box. - 7555c40: Make the sidebar layout mobile-friendly with a Claude-style nav drawer, show a desktop-only notice for Build Agent, Sessions, Schedules, and Environments on small screens, keep user message actions visible on touch (hover-only from
mdup), and show the Agents listing as cards on small screens. - 2b76ce3: Refresh agent environment pickers after Manage Environments create/activate/delete so the ready list does not stay stale while the draft UI stays mounted.
- 5b7abb6: Use session detail API metrics for the agent session strip Turns/Duration/Cost instead of list-row hints or turn-by-turn aggregation. Include optional totalCostInUsd on TurnDoneMetrics so turn.done cost matches the wire contract.
- 5b7abb6: Add a reload button before the agent filter on the Sessions page to fetch latest data without requiring a browser refresh.
- 2b76ce3: Update SandboxEnvironmentStatus from 'active' to 'ready' to align with backend environment version readiness, remove static default environment injection from draft selectors, fix sandbox provider readiness check latching false on EnvironmentsPage, and drain all sandbox environment pages with limit up to 1000 in agent draft pickers.
- Updated dependencies [5b7abb6]
- Updated dependencies [d4bf49c]
- Updated dependencies [d4bf49c]
- Updated dependencies [2b76ce3]
- Updated dependencies [5b7abb6]
- Updated dependencies [5b7abb6]
- Updated dependencies [6813758]
- Updated dependencies [5b7abb6]
- Updated dependencies [5b7abb6]
- Updated dependencies [2b76ce3]
0.4.0
Minor Changes
- c6b78d9: Make sandbox provider port types identity-only; move Daytona lifecycle fields (
execTimeoutMs, auto-stop/archive/delete intervals) onto hostDaytonaSandboxConfig. - f4ee3dc: Share sessions with tenant members (popover,
sharedPATCH, share routes), toast and redirect on forbidden/missing deep links, and stop the New Chat → named-history max-update-depth loop. - a855122: Rename the published runtime package to
@truefoundry/trueforge-assistant-ui-runtime, move it into the TrueForge workspace, rename its public runtime APIs to TrueForge, and remove the legacy TrueFoundry server adapter and server configuration. - 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.
- 829ac6e: Add web-search provider settings catalog port and Settings UI so admins can configure Parallel web search (API key + mode) in standalone/OIDC deployments.
Patch Changes
- c783700: Show schedule tasks, agent context, and failed run reasons in the schedules table.
- dd421b7: Add an action to restore the recent 30-day session list from a timestamp-pinned session.
- 73e146e: Make the compaction threshold an Auto/Custom selector: Auto omits
trigger(runtime derives ~80% of the model context window); Custom reveals a number input defaulting to 50000. - 33cbe52: Default MCP tool approval to
@writeand@destructiveagain. Unlabeled tools still run without a pause unless named or covered by@all. - ff0cee5: Improve session timeline tooltips with sandbox tool details and grouped sub-agent tool calls.
- 72a1168: Use the shared searchable agent picker in the sessions filter.
- ad66480: Hide tool approval Allow/Deny actions and the "Awaiting Response" spinner for paused approvals on session detail (read-only replay).
- fdd8520: Drive Agents and Schedules table pagination from API next/previous page tokens instead of row-count heuristics.
- 20f4179: Refresh trueforge light theme tokens toward indigo-tinted surfaces and cooler gray text.
- 0da3794: Stop the MCP OAuth opener from closing the popup as soon as the callback broadcasts, so the success/failure screen can show before the popup closes itself.
- Updated dependencies [829ac6e]
- Updated dependencies [829ac6e]
- Updated dependencies [829ac6e]
- Updated dependencies [c783700]
- Updated dependencies [c6b78d9]
- Updated dependencies [33cbe52]
- Updated dependencies [f4ee3dc]
- Updated dependencies [fdd8520]
- Updated dependencies [829ac6e]
- Updated dependencies [a855122]
- Updated dependencies [829ac6e]
- Updated dependencies [829ac6e]
0.4.0-rc.0
Minor Changes
- a855122: Rename the published runtime package to
@truefoundry/trueforge-assistant-ui-runtime, move it into the TrueForge workspace, rename its public runtime APIs to TrueForge, and remove the legacy TrueFoundry server adapter and server configuration. - 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.
- 829ac6e: Add web-search provider settings catalog port and Settings UI so admins can configure Parallel web search (API key + mode) in standalone/OIDC deployments.
Patch Changes
- 0da3794: Stop the MCP OAuth opener from closing the popup as soon as the callback broadcasts, so the success/failure screen can show before the popup closes itself.
- Updated dependencies [829ac6e]
- Updated dependencies [a855122]
- Updated dependencies [829ac6e]
- Updated dependencies [829ac6e]
0.3.1
Patch Changes
- 56b3a59: Keep newly saved builders editable until the user leaves the build-agent page, then start fresh when they return.
- a122ba1: Show successful MCP authentication in chat, automatically continue after every required server connects, and indicate while the turn is starting. Confirm OAuth against the chat MCP connector read (
getMcpConnector) so non-admins are not blocked by settings-only catalog GETs, and ignore authorize callbacks after the prompt unmounts. - acad1a1: Add chat-history rename for servers that implement
renameSession, including TrueForge harness title updates. - a08c75a: Show absolute session activity timestamps on hover, label deferred MCP tools in the session timeline, and fix Safari collapsing contentSized modal bodies (flex-auto).
0.3.0
Minor Changes
51127c4: Gate
config.webSearchon host capabilities: New Chat auto-enables with no toggle; New Agent / edit show a Runtime Config switch (default on when absent).d269b01: Add a live advanced agent configuration drawer with shared model, runtime, MCP tool, skill, and Save Agent editors.
e74e953: Keep agent configuration visible on the left in full-width builder layouts, add a responsive instructions and initial-messages drawer with explicit save, make mobile config overlays closable, save the current instruction draft, align builder chrome, and preserve open widgets across chat runtime 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.
8491843: Add a slot-driven agent Metrics tab with aggregate cards, time-range filtering, and Harness-backed line charts.
e3973a5: Open agent model settings inline and support typed custom model parameters.
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.555bef0: Add a composer approval-nav banner (overridable
ApprovalNavBannerslot) that counts pending tool approvals, pauses the composer, and jumps/expands/flashes the focused approval — including nested subagent tools.3539da2: Add
brand.mode(icon-title|icon-only|logo) so hosts pick chrome look first;namealways labels the mark, andresolveBrandChromemaps mode to layout chrome.16feb29: Add
customActionRenderersso hosts can pause the composer on client-side tools with their own UI and resume viaonSubmit(content).74eae6c: Remove pagination from list MCP servers across the API, SDK, and UI; return and search the complete configured MCP catalog client-side.
bc11131: MCP selectors (composer + agent config) infinite-scroll through
listMcppages via DraftCatalogProvider.0297727: Add context-management compaction triggers with model-aware defaults and migrate persisted legacy token thresholds.
860e322: Split New Chat vs New Agent: simple chat keeps the Connectors/Skills picker; New Agent keeps Agent Config + Save Agent. Session metadata
is_create_agentdrives resume from the sessions browser.12b02ff: Open Runtime Config in a right-side drawer and label scheduled sessions consistently.
0cc59f8: Wire schedule test runs and show last five run status chips on the schedules table. Bump
@truefoundry/assistant-ui-runtimeto0.1.25.0cc59f8: Add global Schedules page at
/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.788636d: Sidebar layout is a permanent icon+label nav rail (no expand/collapse). Recent chats are hidden from the sidebar and mobile drawer; the drawer shows nav actions only.
04d2ee6: Add a
sidebarTextsemantic token for sidebar nav labels, refresh trueforge sidebar colors, set trueforge baseradiusto0.375rem(6px), and set sidebar / thread-list control corners to0.75rem(12px).Expose design-system
Button(Button.Primary/.Secondary/.Ghost/.Destructive).ButtonVariantis nowprimary | secondary | ghost | destructive(defaultrenamed toprimary;outlineremoved — usesecondary). Button sizes arelarge(default) andsmall(iconfor icon-only).7e25f68: Open Save Agent in a right-side drawer with only the agent name while preserving configuration from Agent Config.
8f1a2dc: [truefoundry] 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.f8b5eeb: Add optional resource permissions and gate agent, schedule, and session mutations.
Patch Changes
- 51127c4: Open Save Agent drawer on Clone with
{name}-cloneprefilled; stay on Agents list after save. - d29717b: Clarify MCP API key entry: Bearer placeholders, auto-prefix Authorization values, and a header-name hint on the form.
- a273ed8: Preload Monaco when the UI shell mounts so tool request/response editors open faster.
- 347a7e7: Refresh composer and composer-trigger styling: 0.75rem composer corners with a light-theme primary-token gradient hairline (faded top → solid bottom) and a neutral hairline in dark, an icon-only tools trigger in place of the "Tools" caption and count badge, the shared
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. - 2a0ae4c: Show connector catalog logos in the composer Tools picker, matching the Connectors settings page.
- 2a0ae4c: Align AttachmentCard with assistant-ui's default square thumbnail, filename tooltip, and overlay remove control.
- 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 catalogidto AgentSpecname. - a189482: Load agent Use In Code snippets through
client.internal.agents.getCodeSnippetsinstead of a rawclient.fetch. - 26a9b80: Add an agent-scoped Schedules tab and route library schedule actions into it.
- 1b8a3f7: Add documentation links to the code snippets view and shell actions.
- 584e815: Gate Save Agent (create) on tenant CREATE from list-permissions, keep Update Agent on agent MANAGE, unwrap
{ type, permissions }, and bump@truefoundry/assistant-ui-runtimeto0.1.39. - d2fdfc9: Add agent-filtered chat history labels, preserve Try Agent and explicit history-filter intent in URL query state while resolving backend IDs, reset active chats when users change filters, keep Try Agent highlighted as chat, and route fresh agent builders at
/build-agentbefore their session URL is assigned. - 8296c52: Make Runtime Config, MCP Servers, and Skills blocks clickable with a hover action icon, explain disabled sandbox and large-tool-response toggles in tooltips, and replace boxed capability cards with divider-separated columns.
- 8c31eae: Round-trip agent description through save/load and show it in the library and agent details.
- 0e01eba: Polish metric charts with sharp dot-free lines, distinct series colors, and a quieter Metrics tab background.
- c4ee138: Agent list and details overflow menu: Edit, Clone (
{name}-copyvia saveAgent), Manage Schedules, and Delete (wired through harnessdeleteAgent). - 629b6e9: Paginate the Agent Sessions list on scroll instead of a "Load more" button, showing a skeleton row while the next page loads.
- c4ee138: AgentSessions list pane uses a quieter surface, and the resize grip stays gray until hover, press, or focus.
- 629b6e9: Fix Agents library table scrolling when rows exceed the viewport
- 26a9b80: Allow sending user messages that contain attachments without text.
- d7136a1: Avatar fallbacks use a light primary-button gradient in light mode, a solid primary gradient in dark mode, and show a single initial character.
- 4e72afc: Announce boot loading with a light-themed orb for contrast outside ThemeProvider.
- 26a9b80: Add an empty state and Build Agent action to the schedule agent picker.
- 4c522e2: Bump
@truefoundry/assistant-ui-runtimeto0.1.30. - 4c522e2: Bump
@truefoundry/assistant-ui-runtimeto0.1.31. - fd1bf7f: Bump
@truefoundry/assistant-ui-runtimeto0.1.38for assistant completion timestamps and keep-alive turn streams on session switch. - 4be60e7: Bump
@truefoundry/assistant-ui-runtimeto0.1.41for turn-scoped sandbox artifact downloads and to stop stale session history from merging after a session switch. - d719155: Keep composer catalogs cached when starting a new chat.
- b11cfc3: Wire remote chat session deletion and improve the history delete action styling.
- fe6a14b: Improve session timelines with sub-agent wait states, grouped point-event markers, clean linear ticks, and readable summary durations.
- c4ee138: Agent Code (
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. - c0359ca: Strip a trailing slash from the
base_urlpassed to agent code-snippets. - 57f1fc2: Improve compact agent building with model configuration bottom sheets, provider-first model selection, and a contextual composer actions menu.
- e3973a5: Show the selected connector and skill count beside the composer tools icon.
- 26a9b80: Hide model selection in the Build Agent composer and correct concurrent sub-agent timeline bars.
- 629b6e9: Show Created by (avatar + name) on Agents and Schedules tables when creator info is present.
- 26a9b80: Require direct switch clicks in the Runtime Config sidebar.
- 531f0ce: Keep close-on-click dropdown menus and bottom sheets open when a click or drag lands on their own scrollbar, so scrolling a long menu no longer dismisses it before a choice is made.
- 1ec19f0: Replace API key replacement with connector configuration editing from the connector list and details view.
- c4ee138: Agents, Sessions, and Schedules empty states use a shared centered empty-box screen with title and supporting copy.
- b482cdd: Show the four primary agent metrics in a compact summary-card layout.
- b32d2be: Filter chat history to sessions created by the current user, and bump
@truefoundry/assistant-ui-runtimeto0.1.34. - a9430bd: Accept optional
base_urlon agent code-snippets (FE public host); fall back to request origin +PUBLIC_BASE_URLpath. - 3ca4e2e: fixed the button component icon and padding, delete conflicting local prettier.json in trueforge-ui package
- a655537: Update published dependency ranges (AI SDK, Hono, MCP SDK, Redis, assistant-ui, and related packages).
- 54e4ec4: Keep Settings hidden until the server explicitly enables it.
- 0cc59f8: Use Google Sans as the default
trueforgetheme font and load it from Google Fonts when styles are injected. - 64ca089: Hide Clear chat while the thread is fresh (New Chat, New Agent, and Try Agent) since there is nothing to clear.
- 4c522e2: Hide session cost metrics when cost data is unavailable.
- 4e7b67a: Check live per-user MCP authentication before loading tools in the agent builder.
- aa4be44: Open markdown links in assistant messages in a new tab
- 551b6a8: Default MCP tool approval to
@destructiveonly. Selecting Other/read-only tools clears approval; selecting destructive tools keeps it on. Migrate mounts still carrying the old@write+@destructivedefault. - 64ca089: Add a book-icon preload toggle and dashed add button to Agent Config MCP server pills.
- d269b01: Improve MCP and skill selectors with consistent search sizing, explicit MCP selection controls, grouped tool summaries, and removable MCP chips.
- 64ca089: Revamp the MCP tools selector modal with focus rows, connect empty state, and grouped selected-tools summary.
- 551b6a8: Let Build Agent pick which MCP tools require human approval, saved as
require_approval_for_toolson the agent spec, and make unchecked tool checkboxes legible in both tool selectors. The agent Overview tab now expands each attached MCP server into its tools, with read/write/destructive labels and approval state. - d2fdfc9: Section MCP tools in the Build Agent selector by read-only, others, and destructive annotations, with a read-only enable-all toggle.
- d7136a1: Assistant message loading indicator uses ThinkingOrb with left-to-right shimmering Working... text.
- ea86853: Move the agent metrics time range filter into the active Metrics tab row.
- bc11131: New Chat enables sandbox on the live draft agent config when capabilities report sandbox as available.
- d5b479d: Clamp optional sessions/schedules chrome and unregister
/sessions,/schedules, and/library/:agentIdwhen those server ports are omitted, matching the Settings Lego gate. - b316430: Slide SideDrawer/BottomSheet and add a light fade+scale enter on dropdowns and popup cards.
- dc2151f: Paginate
GET /api/v1/agentswithlimit/page_tokenand apaginationenvelope; optionalagent_namefilters by case-insensitive substring. Agents library uses rows-per-page and prev/next against the token-paginated API. Schedule create and the schedules listing agent filter use a searchable agent combobox backed by the same filtered list API. - 26a9b80: Show agent names without an icon in the Agents table.
- d7015fd: show mcp server tool name on tool approval
- d7136a1: Flip PopoverSelect menus when the preferred side lacks viewport room (e.g. table rows-per-page).
- 629b6e9: Portal PopoverSelect menus so table page-size and other selects are not clipped by overflow parents.
- 98ab384: Preserve the active agent draft when returning to Build Agent from another page.
- 04460fb: Prevent the schedule search field from shrinking and clipping its placeholder.
- ef278dd: Stop highlighting New Chat while trying a named agent, and clear the Try Agent URL and history filter when starting a new chat.
- 079f832: Show an optional tooltip when sandbox artifact downloads are read-only.
- 4cea38c: Show draft and named sessions in the history panel, exclude agent-builder sessions, cache session pages, and switch history sessions in place without remounting the chat runtime.
- fa0730b: Reduce the agent code snippet font size to match its surrounding controls.
- 2284d3b: Polish the MCP tool selector controls, loading state, and API error messages.
- c4ee138: Resume Chat / Resume Agent building opens in a new tab when routed (
/sessions/:id+ square-arrow-out-up-right); without a router it keeps the in-shell resume fallback. - 788636d: Open the create schedule drawer when Agents "+ Schedule" navigates with
isNew=true, then clear the flag from the URL. - e3973a5: Group schedule recurrence controls and display the cadence in an attached summary footer.
- d7136a1: Stop draining the full agents catalog on Schedules mount; load agents only when the filter opens (infinite scroll).
- f2ca338: Show active/paused schedule counts in the Agents library, pin selected MCPs when reopening the tools modal, and align paused schedule badge colors.
- ffbb239: Add a hover ellipsis delete menu with confirmation dialog on Sessions list rows.
- 333230d: Improve Agent Sessions with a resizable divider, accurate turn grouping, optional cost display, and reliable timeline tooltips with sub-agent details. Simplify schedule recurrence and default new schedules to the local timezone.
- d7136a1: Settings sidebar uses a subtle primary tint for the selected section instead of a solid fill.
- c4ee138: Unregister the
/settingsroute when Settings chrome is unavailable (no catalog orcapabilities.settings.enabledis false), matching the sidebar Settings button gate. - ceeb56f: Show turn and duration statistics alongside the featured agent metric cards.
- 531f0ce: Cap the skill version menu height and scroll it, so skills with many versions no longer run off screen. While it is open, scrolling is confined to the menu.
- 77c5c33: [truefoundry] Show TrueFoundry skill repositories and versions in skill pickers, load version choices lazily, preserve the chosen version FQN when attaching skills, keep picker ordering stable while open, and add registry-only preload controls to selected skill pills.
- c4ee138: Split New Chat and New Agent draft preference stores. New Chat remembers only model (+ reasoning), skills, and MCP; New Agent keeps the full seed including runtime config.
- 4c1260e: [truefoundry] Wire TrueFoundry MCP authorize, status, and delete through ServiceFoundry; stub list auth_status; gate oauth2 invoke mid-turn with authRequired; paginate MCP server lists. UI treats SFY consent
code/erroron the FE landing like local DCR success/failure. - 4e72afc: Use an animated thinking orb for application boot and server initialization.
- c4ee138: Per-turn Tokens in Agent Sessions shows a keyboard-accessible Input / Output / Cached tooltip (Input is uncached).
- a655537: Add a
turn.updateevent schema with paused/running status andaction_required_on_events. - bc11131: Share a single
PageHeaderacross chat and list chrome so title size/height stay consistent, and drop decorative title icons. - 1b5b674: Add a host-overridable user avatar slot with initials and display-name chrome across every built-in layout, wired to the current authenticated frontend user.
- 26a9b80: Show weekly schedule days before the time controls.
- 1b8a3f7: Match the Build Agent configuration panel width to the agent playground and identify sessions created by schedule runs.
- adaf532: Widen the sidebar rail and its nav buttons so labels like "Build Agent" have more breathing room.
- 5d72138: Keep
npx @truefoundry/trueforgeworking on native Windows: import Kysely migrations withpathToFileURL, and keep sandbox guest paths POSIX. Source development stays Unix/WSL; CI also runs unit and SQLite store tests on Windows. - Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [2dcb3a0]
- Updated dependencies [a000b47]
- Updated dependencies [74eae6c]
- Updated dependencies [9501536]
- Updated dependencies [0ec8dc6]
- Updated dependencies [dc2151f]
- Updated dependencies [134dcb9]
- Updated dependencies [52987a7]
- Updated dependencies [38ce068]
- Updated dependencies [b654052]
- Updated dependencies [11865b4]
- Updated dependencies [4c1260e]
- Updated dependencies [44f9cbe]
- Updated dependencies [f175245]
0.3.0-rc.11
Patch Changes
- 4be60e7: Bump
@truefoundry/assistant-ui-runtimeto0.1.41for turn-scoped sandbox artifact downloads and to stop stale session history from merging after a session switch. - 551b6a8: Default MCP tool approval to
@destructiveonly. Selecting Other/read-only tools clears approval; selecting destructive tools keeps it on. Migrate mounts still carrying the old@write+@destructivedefault. - 551b6a8: Let Build Agent pick which MCP tools require human approval, saved as
require_approval_for_toolson the agent spec, and make unchecked tool checkboxes legible in both tool selectors. The agent Overview tab now expands each attached MCP server into its tools, with read/write/destructive labels and approval state. - ffbb239: Add a hover ellipsis delete menu with confirmation dialog on Sessions list rows.
- a655537: Add a
turn.updateevent schema with paused/running status andaction_required_on_events. - Updated dependencies [648273b]
- Updated dependencies [648273b]
0.3.0-rc.10
Patch Changes
- 584e815: Gate Save Agent (create) on tenant CREATE from list-permissions, keep Update Agent on agent MANAGE, unwrap
{ type, permissions }, and bump@truefoundry/assistant-ui-runtimeto0.1.39.
0.3.0-rc.9
Patch Changes
- fd1bf7f: Bump
@truefoundry/assistant-ui-runtimeto0.1.38for assistant completion timestamps and keep-alive turn streams on session switch. - 079f832: Show an optional tooltip when sandbox artifact downloads are read-only.
- Updated dependencies [648273b]
- Updated dependencies [134dcb9]
0.3.0-rc.8
Patch Changes
- Updated dependencies [648273b]
0.3.0-rc.7
Patch Changes
- 531f0ce: Keep close-on-click dropdown menus and bottom sheets open when a click or drag lands on their own scrollbar, so scrolling a long menu no longer dismisses it before a choice is made.
- 531f0ce: Cap the skill version menu height and scroll it, so skills with many versions no longer run off screen. While it is open, scrolling is confined to the menu.
- Updated dependencies [648273b]
0.3.0-rc.6
Patch Changes
- 8c31eae: Round-trip agent description through save/load and show it in the library and agent details.
- d7136a1: Avatar fallbacks use a light primary-button gradient in light mode, a solid primary gradient in dark mode, and show a single initial character.
- d7136a1: Assistant message loading indicator uses ThinkingOrb with left-to-right shimmering Working... text.
- b316430: Slide SideDrawer/BottomSheet and add a light fade+scale enter on dropdowns and popup cards.
- dc2151f: Paginate
GET /api/v1/agentswithlimit/page_tokenand apaginationenvelope; optionalagent_namefilters by case-insensitive substring. Agents library uses rows-per-page and prev/next against the token-paginated API. Schedule create and the schedules listing agent filter use a searchable agent combobox backed by the same filtered list API. - d7136a1: Flip PopoverSelect menus when the preferred side lacks viewport room (e.g. table rows-per-page).
- 04460fb: Prevent the schedule search field from shrinking and clipping its placeholder.
- fa0730b: Reduce the agent code snippet font size to match its surrounding controls.
- d7136a1: Stop draining the full agents catalog on Schedules mount; load agents only when the filter opens (infinite scroll).
- d7136a1: Settings sidebar uses a subtle primary tint for the selected section instead of a solid fill.
- Updated dependencies [648273b]
- Updated dependencies [9501536]
- Updated dependencies [dc2151f]
0.3.0-rc.5
Patch Changes
- 4e72afc: Announce boot loading with a light-themed orb for contrast outside ThemeProvider.
- ea86853: Move the agent metrics time range filter into the active Metrics tab row.
- 98ab384: Preserve the active agent draft when returning to Build Agent from another page.
- 4e72afc: Use an animated thinking orb for application boot and server initialization.
0.3.0-rc.4
Patch Changes
- 629b6e9: Paginate the Agent Sessions list on scroll instead of a "Load more" button, showing a skeleton row while the next page loads.
- 629b6e9: Fix Agents library table scrolling when rows exceed the viewport
- 629b6e9: Show Created by (avatar + name) on Agents and Schedules tables when creator info is present.
- 629b6e9: Portal PopoverSelect menus so table page-size and other selects are not clipped by overflow parents.
- ef278dd: Stop highlighting New Chat while trying a named agent, and clear the Try Agent URL and history filter when starting a new chat.
- ceeb56f: Show turn and duration statistics alongside the featured agent metric cards.
- Updated dependencies [648273b]
0.3.0-rc.3
Minor Changes
- 1d31116: Open agent model settings inline and support typed custom model parameters.
- 74eae6c: Remove pagination from list MCP servers across the API, SDK, and UI; return and search the complete configured MCP catalog client-side.
- 12b02ff: Open Runtime Config in a right-side drawer and label scheduled sessions consistently.
- 7e25f68: Open Save Agent in a right-side drawer with only the agent name while preserving configuration from Agent Config.
- f8b5eeb: Add optional resource permissions and gate agent, schedule, and session mutations.
Patch Changes
- 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 catalogidto AgentSpecname. - 26a9b80: Add an agent-scoped Schedules tab and route library schedule actions into it.
- 1b8a3f7: Add documentation links to the code snippets view and shell actions.
- d2fdfc9: Add agent-filtered chat history labels, preserve Try Agent and explicit history-filter intent in URL query state while resolving backend IDs, reset active chats when users change filters, keep Try Agent highlighted as chat, and route fresh agent builders at
/build-agentbefore their session URL is assigned. - 26a9b80: Allow sending user messages that contain attachments without text.
- 26a9b80: Add an empty state and Build Agent action to the schedule agent picker.
- 4c522e2: Bump
@truefoundry/assistant-ui-runtimeto0.1.30. - 4c522e2: Bump
@truefoundry/assistant-ui-runtimeto0.1.31. - d719155: Keep composer catalogs cached when starting a new chat.
- c0359ca: Strip a trailing slash from the
base_urlpassed to agent code-snippets. - 57f1fc2: Improve compact agent building with model configuration bottom sheets, provider-first model selection, and a contextual composer actions menu.
- e3973a5: Show the selected connector and skill count beside the composer tools icon.
- 26a9b80: Hide model selection in the Build Agent composer and correct concurrent sub-agent timeline bars.
- 26a9b80: Require direct switch clicks in the Runtime Config sidebar.
- 1ec19f0: Replace API key replacement with connector configuration editing from the connector list and details view.
- b482cdd: Show the four primary agent metrics in a compact summary-card layout.
- b32d2be: Filter chat history to sessions created by the current user, and bump
@truefoundry/assistant-ui-runtimeto0.1.34. - a9430bd: Accept optional
base_urlon agent code-snippets (FE public host); fall back to request origin +PUBLIC_BASE_URLpath. - 54e4ec4: Keep Settings hidden until the server explicitly enables it.
- 4c522e2: Hide session cost metrics when cost data is unavailable.
- 4e7b67a: Check live per-user MCP authentication before loading tools in the agent builder.
- d2fdfc9: Section MCP tools in the Build Agent selector by read-only, others, and destructive annotations, with a read-only enable-all toggle.
- 26a9b80: Show agent names without an icon in the Agents table.
- 4cea38c: Show draft and named sessions in the history panel, exclude agent-builder sessions, cache session pages, and switch history sessions in place without remounting the chat runtime.
- 2284d3b: Polish the MCP tool selector controls, loading state, and API error messages.
- e3973a5: Group schedule recurrence controls and display the cadence in an attached summary footer.
- f2ca338: Show active/paused schedule counts in the Agents library, pin selected MCPs when reopening the tools modal, and align paused schedule badge colors.
- 77c5c33: [truefoundry] Show TrueFoundry skill repositories and versions in skill pickers, load version choices lazily, preserve the chosen version FQN when attaching skills, keep picker ordering stable while open, and add registry-only preload controls to selected skill pills.
- 26a9b80: Show weekly schedule days before the time controls.
- 1b8a3f7: Match the Build Agent configuration panel width to the agent playground and identify sessions created by schedule runs.
- adaf532: Widen the sidebar rail and its nav buttons so labels like "Build Agent" have more breathing room.
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [74eae6c]
- Updated dependencies [44f9cbe]
0.3.0-rc.2
Minor Changes
04d2ee6: Add a
sidebarTextsemantic token for sidebar nav labels, refresh trueforge sidebar colors, set trueforge baseradiusto0.375rem(6px), and set sidebar / thread-list control corners to0.75rem(12px).Expose design-system
Button(Button.Primary/.Secondary/.Ghost/.Destructive).ButtonVariantis nowprimary | secondary | ghost | destructive(defaultrenamed toprimary;outlineremoved — usesecondary). Button sizes arelarge(default) andsmall(iconfor icon-only).
Patch Changes
- 2a0ae4c: Show connector catalog logos in the composer Tools picker, matching the Connectors settings page.
- 2a0ae4c: Align AttachmentCard with assistant-ui's default square thumbnail, filename tooltip, and overlay remove control.
- fe6a14b: Improve session timelines with sub-agent wait states, grouped point-event markers, clean linear ticks, and readable summary durations.
- d5b479d: Clamp optional sessions/schedules chrome and unregister
/sessions,/schedules, and/library/:agentIdwhen those server ports are omitted, matching the Settings Lego gate. - 5d72138: Keep
npx @truefoundry/trueforgeworking on native Windows: import Kysely migrations withpathToFileURL, and keep sandbox guest paths POSIX. Source development stays Unix/WSL; CI also runs unit and SQLite store tests on Windows. - Updated dependencies [a000b47]
- Updated dependencies [0ec8dc6]
- Updated dependencies [11865b4]
0.3.0-rc.1
Minor Changes
- d269b01: Add a live advanced agent configuration drawer with shared model, runtime, MCP tool, skill, and Save Agent editors.
- e74e953: Keep agent configuration visible on the left in full-width builder layouts, add a responsive instructions and initial-messages drawer with explicit save, make mobile config overlays closable, save the current instruction draft, align builder chrome, and preserve open widgets across chat runtime 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.
- 8491843: Add a slot-driven agent Metrics tab with aggregate cards, time-range filtering, and Harness-backed line charts.
- 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. - bc11131: MCP selectors (composer + agent config) infinite-scroll through
listMcppages via DraftCatalogProvider. - 860e322: Split New Chat vs New Agent: simple chat keeps the Connectors/Skills picker; New Agent keeps Agent Config + Save Agent. Session metadata
is_create_agentdrives resume from the sessions browser. - 0cc59f8: Wire schedule test runs and show last five run status chips on the schedules table. Bump
@truefoundry/assistant-ui-runtimeto0.1.25. - 0cc59f8: Add global Schedules page at
/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. - 788636d: Sidebar layout is a permanent icon+label nav rail (no expand/collapse). Recent chats are hidden from the sidebar and mobile drawer; the drawer shows nav actions only.
- 8f1a2dc: [truefoundry] 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
- 347a7e7: Refresh composer and composer-trigger styling: 0.75rem composer corners with a light-theme primary-token gradient hairline (faded top → solid bottom) and a neutral hairline in dark, an icon-only tools trigger in place of the "Tools" caption and count badge, the shared
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. - a189482: Load agent Use In Code snippets through
client.internal.agents.getCodeSnippetsinstead of a rawclient.fetch. - c4ee138: Agent list and details overflow menu: Edit, Clone (
{name}-copyvia saveAgent), Manage Schedules, and Delete (wired through harnessdeleteAgent). - c4ee138: AgentSessions list pane uses a quieter surface, and the resize grip stays gray until hover, press, or focus.
- c4ee138: Agent Code (
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. - c4ee138: Agents, Sessions, and Schedules empty states use a shared centered empty-box screen with title and supporting copy.
- 0cc59f8: Use Google Sans as the default
trueforgetheme font and load it from Google Fonts when styles are injected. - 64ca089: Hide Clear chat while the thread is fresh (New Chat, New Agent, and Try Agent) since there is nothing to clear.
- 64ca089: Add a book-icon preload toggle and dashed add button to Agent Config MCP server pills.
- d269b01: Improve MCP and skill selectors with consistent search sizing, explicit MCP selection controls, grouped tool summaries, and removable MCP chips.
- 64ca089: Revamp the MCP tools selector modal with focus rows, connect empty state, and grouped selected-tools summary.
- bc11131: New Chat enables sandbox on the live draft agent config when capabilities report sandbox as available.
- c4ee138: Resume Chat / Resume Agent building opens in a new tab when routed (
/sessions/:id+ square-arrow-out-up-right); without a router it keeps the in-shell resume fallback. - 788636d: Open the create schedule drawer when Agents "+ Schedule" navigates with
isNew=true, then clear the flag from the URL. - 333230d: Improve Agent Sessions with a resizable divider, accurate turn grouping, optional cost display, and reliable timeline tooltips with sub-agent details. Simplify schedule recurrence and default new schedules to the local timezone.
- c4ee138: Unregister the
/settingsroute when Settings chrome is unavailable (no catalog orcapabilities.settings.enabledis false), matching the sidebar Settings button gate. - c4ee138: Split New Chat and New Agent draft preference stores. New Chat remembers only model (+ reasoning), skills, and MCP; New Agent keeps the full seed including runtime config.
- 4c1260e: [truefoundry] Wire TrueFoundry MCP authorize, status, and delete through ServiceFoundry; stub list auth_status; gate oauth2 invoke mid-turn with authRequired; paginate MCP server lists. UI treats SFY consent
code/erroron the FE landing like local DCR success/failure. - c4ee138: Per-turn Tokens in Agent Sessions shows a keyboard-accessible Input / Output / Cached tooltip (Input is uncached).
- bc11131: Share a single
PageHeaderacross chat and list chrome so title size/height stay consistent, and drop decorative title icons. - Updated dependencies [648273b]
- Updated dependencies [648273b]
- Updated dependencies [2dcb3a0]
- Updated dependencies [52987a7]
- Updated dependencies [38ce068]
- Updated dependencies [b654052]
- Updated dependencies [4c1260e]
- Updated dependencies [f175245]
0.3.0-rc.0
Minor Changes
- 3539da2: Add
brand.mode(icon-title|icon-only|logo) so hosts pick chrome look first;namealways labels the mark, andresolveBrandChromemaps mode to layout chrome. - 16feb29: Add
customActionRenderersso hosts can pause the composer on client-side tools with their own UI and resume viaonSubmit(content). - 0297727: Add context-management compaction triggers with model-aware defaults and migrate persisted legacy token thresholds.
Patch Changes
- b11cfc3: Wire remote chat session deletion and improve the history delete action styling.
- 3ca4e2e: fixed the button component icon and padding, delete conflicting local prettier.json in trueforge-ui package
- a655537: Update published dependency ranges (AI SDK, Hono, MCP SDK, Redis, assistant-ui, and related packages).
- aa4be44: Open markdown links in assistant messages in a new tab
- d7015fd: show mcp server tool name on tool approval
- Updated dependencies [648273b]
Unreleased
Minor Changes
brand.mode— explicit chrome look. Setmode, then pass the fields it requires.namealways labels the mark (alt/aria-label):'icon-title'—name+ optionalicon(title shown in expanded chrome)'icon-only'—name+icon(alt kept, no title text)'logo'—name+icon+logo(wordmark in expanded chrome;nameis alt only)- Default — omit
brandfor the TrueForge wordmark / square mark
resolveBrandChrome()— mapsbrand.modeto{ expandedVariant, collapsedVariant, showTitle }.SidebarLayoutuses it; custom layouts should too.
Changed
BrandConfig— discriminated onmode(BrandMode). RemovedshowTitlefrom config; visible title follows the mode.
0.2.4
Patch Changes
- f1c5c6b: Fall back to the pending MCP authorization URL when the UI server does not expose a catalog.
0.2.3
Patch Changes
- abd9e38: Agents Library rows: show connectors before skills, use the composer's lightbulb icon for skills, and reveal the connector/skill names in a tooltip on hover.
- cc49d4a: Rename catalog, sandbox-file download, and MCP tools paths; Fern upsert becomes create_or_update. Sessions and turns default and max 25; session and turn event lists default and max 100.
- 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.
- 7e2e02c: Refresh composer catalogs whenever settings close, including navigating to a chat or named agent.
- Updated dependencies [cc49d4a]
0.2.3-rc.0
Patch Changes
- abd9e38: Agents Library rows: show connectors before skills, use the composer's lightbulb icon for skills, and reveal the connector/skill names in a tooltip on hover.
- cc49d4a: Rename catalog, sandbox-file download, and MCP tools paths; Fern upsert becomes create_or_update. Sessions and turns default and max 25; session and turn event lists default and max 100.
- 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.
- 7e2e02c: Refresh composer catalogs whenever settings close, including navigating to a chat or named agent.
- Updated dependencies [cc49d4a]
0.2.2
Patch Changes
- 3113aa4: Rename the MCP servers SDK method from
deleteAuthorizetodeleteAuthorization. - 45dc6cd: Replace MCP authorize
redirect_urlwith a same-originreturn_topath to prevent open redirects after OAuth. - Updated dependencies [3113aa4]
- Updated dependencies [45dc6cd]
0.2.1
Patch Changes
- c5223ad: Ship
react-domandreact-router-domas package dependencies instead of peers so consumers no longer need to install them separately. - 92ee970: Decode common escape sequences (
\n,\t,\r,\uXXXX, …) in user-facing API error messages and render them withwhitespace-pre-wrapso multi-line Zod validation output displays correctly. - 53104b1: Keep active and remembered draft sandbox settings synchronized with server capabilities.
0.2.0
Minor Changes
- 9a4d1a7: Add opt-in
withRouterURL sync for shell places (/,/agents/:agentName,/sessions/:sessionId,/settings), with path customization viaroutesandreact-router-domas an optional peer. Serve the app shell for client-side deep links from the TrueForge server.
Patch Changes
- Updated dependencies [5100c59]
0.1.0
Minor Changes
- 2f08a99: Remember plain-draft composer choices (model, skills, MCP connectors, config) across New Chat and reloads via localStorage. Edit-flow and immutable library agents are unchanged.
TrueForgeUIlayoutis optional and defaults to"sidebar". - b56c003: Initial 0.1.0-rc.1 prerelease of all public packages.
Patch Changes
- e9bf976: Wrap settings MCP, skills, model-provider, and sandbox create/put bodies as
{ manifest }. List/get items nest the stored document (nameplusmanifest, plus derived fields). Create returns 201. Chat lists and catalogs stay flat. Adapter catalogs follow the new SDK shapes. - a9e8187: Improve nested tool approval handling and bump
@truefoundry/assistant-ui-runtime. - 0730213: Save Agent dialog: add a per-connector preload toggle (writes
mcp_servers[].preload), render the capabilities as side-by-side cards, and declutter the modal — inline model/connector/skill chips (model shows its provider logo), the "Connectors" label, no subtitle, content-sized height, and tighter spacing. Tooltips now portal into the nearest<dialog>so they render above modal content. - Updated dependencies [e9bf976]
- Updated dependencies [b56c003]
0.1.0-rc.2
Minor Changes
- 2f08a99: Remember plain-draft composer choices (model, skills, MCP connectors, config) across New Chat and reloads via localStorage. Edit-flow and immutable library agents are unchanged.
TrueForgeUIlayoutis optional and defaults to"sidebar".
Patch Changes
- a9e8187: Improve nested tool approval handling and bump
@truefoundry/assistant-ui-runtime. - 0730213: Save Agent dialog: add a per-connector preload toggle (writes
mcp_servers[].preload), render the capabilities as side-by-side cards, and declutter the modal — inline model/connector/skill chips (model shows its provider logo), the "Connectors" label, no subtitle, content-sized height, and tighter spacing. Tooltips now portal into the nearest<dialog>so they render above modal content.
0.1.0-rc.1
Patch Changes
- e9bf976: Wrap settings MCP, skills, model-provider, and sandbox create/put bodies as
{ manifest }. List/get items nest the stored document (nameplusmanifest, plus derived fields). Create returns 201. Chat lists and catalogs stay flat. Adapter catalogs follow the new SDK shapes. - Updated dependencies [e9bf976]
0.1.0-rc.0
Minor Changes
- b56c003: Initial 0.1.0-rc.1 prerelease of all public packages.
Patch Changes
- Updated dependencies [b56c003]
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
Changed
@truefoundry/assistant-ui-runtime≥ 0.1.18 — depends on the consolidated runtime release that includes:getModels→properties.reasoningEffortsfor thinking-capable models- extras ancestor walk so nested/readonly AUI clients resolve
useTrueFoundryRespondToToolApproval(sub-agent Allow/Deny) - parallel enabled-models + provider-metadata CP fetches
ModelSelectorEntry.name/id=model_fqn(account/model-id)- gateway mount sanitization (
normalizeMcpMount/normalizeSkillMount, registryenableToolsdefault["@all"])
Fixed
- Sub-agent Allow/Deny — nested tool approvals inside
create_sub_agentnow calluseTrueFoundryRespondToToolApprovalwith the nested tool's approval id. The old bridge keyed off the outer sub-agent part (usually with no approval), so clicks silently no-op'd. Requires@truefoundry/assistant-ui-runtime≥ 0.1.19 so extras resolve through the readonly nested AUI client. - Sandbox provider contract — drop
snapshotNamefromSandboxProviderConfigand wraplistSandboxProvidersas{ data, snapshotSyncStatus }(Harnessstatus/status_reason). Re-exportsSandboxProviderListEntry/SandboxSnapshotSyncStatus.
Added
- Draft composer preferences — plain-draft model, skills, MCP connectors, and
config choices are remembered (in-memory +
localStorage) and seed the next New Chat after reload. Stale catalog entries are pruned once catalogs load. Edit-flow (agentIdset) and immutable library agents are unchanged. - Optional
layout—<TrueForgeUI />layoutprop defaults to"sidebar". type: "trueforge"built-in server —<TrueForgeUI server={{ type: 'trueforge', baseUrl?, token?, fetch? }} />resolves a full HarnessAgentUIServervia@truefoundry/trueforge-ui/plugins/trueforge-agent-server-adapter(createTrueForgeAgentUIServer), including chat, builder, and default settings catalogs. Depends on@truefoundry/trueforge-sdk(workspace:* in-monorepo; external in the bundle).- Light/dark brand logo —
theme.brand.logoaccepts aBrandLogoConfig({ src?, light?, dark?, href? }). The source is picked from the resolved theme mode, falling back to the other mode and thensrc, so a single configured mode covers both and{ light }alone never renders a missing image.hrefwraps the logo in a same-tab link. A bare string (logo: '/logo.svg') is shorthand for a mode-agnostic source. A config with no usable source falls back to the default mark rather than an empty<img>. BrandLogoslot — now in the slot table and resolved throughuseSlotby every layout, sooverrides={{ BrandLogo: MyMark }}reaches the sidebar header, widget FAB, and welcome screen.useBrandName()— the configured brand name or the default, so layouts no longer inline the fallback string.
Changed
- Theme preset rename — default preset id
truefoundry→trueforge(ThemePreset,PRESETS,data-preset, docs). - Styles auto-inject —
ThemeProviderinjects the SDK stylesheet at runtime. Hosts no longer need@import '@truefoundry/trueforge-ui/styles.css'(export kept for SSR). Semantic tokens and dark mode are scoped to.aui-theme-root(nohtml.dark/:rootretheme of the host page). - Dependency —
@truefoundry/assistant-ui-runtimepinned to0.1.13.ModelSelectorEntrynow requiresid, nestedprovider: ProviderEntry, andproperties: ModelProperties(replacing flatprovider/providerLogo/reasoningEfforts). Re-exportsProviderEntryandModelProperties.
Fixed
- History row mutability — prefer
custom.isMutablefrom the session (runtime stamp) over inferring fromagentName. Orphaned named refs (deleted agent, noagentName) open as immutable.openHistorySessionallowsisMutable: falsewithout an agent name. - Edit-bound draft history switch — do not reuse the mutable shell via
switchToThreadwhen the shell still carries an EditagentName/agentIdand the row is a different session. Remount throughopenHistorySessionso Update Agent chrome cannot overwrite the wrong library agent.
Breaking
- Server-port types owned by
@truefoundry/assistant-ui-runtime— this package no longer definesAgentChatServer/AgentBuilderServer/ catalog DTOs locally. Host-facing types are re-exported from@truefoundry/assistant-ui-runtime/serverviasrc/server/types.ts. Prefer importing types from@truefoundry/trueforge-ui(hosts should not need the runtime package for types). Requires runtime0.1.13. - Removed public pagination helpers —
PageResult,TokenPagination,ListSessionsResponse,ListTurnsResponse,ListSessionEventsResponse, and opaqueSessionEventare gone from this package. Chat list APIs use runtimeListResult<T>({ data, nextPageToken? }). AgentUIServer/ mounts follow the runtime contract — composed port matches runtimeAgentUIServerPort;SkillMount/McpServerMountstay opaqueobject(hosts widen via generics). ImplementgetCapabilities()on every builder host.- One brand component — removed the
BrandIconexport;BrandLogois the only product mark and renders the mark alone. Callers that also want the name as text pair it withuseBrandName()(as the sidebar header does), rather than relying on a second component that hard-codes one arrangement. Replace<BrandIcon />with<BrandLogo />, andoverrides={{ BrandIcon }}withoverrides={{ BrandLogo }}. brand.nameis required —theme.brandstays optional, but setting it now requiresname, since it labels the logo and a logo with no name has no accessible name.logoremains optional, sobrand: { name: 'Acme' }still pairs host text with the default mark.useBrand()returnsPartial<BrandConfig>, sincebrandmay be absent entirely.theme.brandis images-only — removedbrand.icon; there is one logo source. Removed theReactNodeand render-function variants of the logo value (and with them theBrandImagetype export), sobrand.logois nowstring | BrandLogoConfig. Component-valued marks move to the slot table:overrides={{ BrandLogo: MyMark }}, which is how every other atom is replaced. Also removedalt— the logo is labelled withbrand.name, so there is one place to set the accessible name.- Default brand name is
"TrueForge"(was"TrueFoundry"), used byBrandLogo, the sidebar header, anduseBrandName(). ShellModeshape — replacedtype: 'idle' | 'named' | 'draft'withstatus: 'idle' | 'active'plusisMutableon active bindings. Composer / Save Agent / welcome chrome key offisMutable, not draft|named. Hosts that inspectedmode.typemust switch tomode.status/mode.isMutable(seeshellIsMutable).- Renamed
TrueFoundryAssistantUI→TrueForgeUI(props typeTrueFoundryAssistantUIProps→TrueForgeUIProps). Update imports and JSX. TrueForgeUIagent props — replaced top-levelagentNameanddefaultAgentSpecwith a single discriminatedagentConfig. There is no compat shim; hosts must update call sites.- Icons use Lucide (
lucide-react) instead of Font Awesome. Default registry keys are unchanged (paperclip,xmark, …);theme.iconsvalues are Lucide components, React nodes, render fns, or SVGR SVGs — notIconDefinition. Drop@fortawesome/*if you only used them for this SDK. - Removed
tfy-web-componentsdependency and peer. Primitives, icons, theme, Markdown, and agent-chat molecules are owned by this SDK. themeprop is nowThemeConfig(object), not"light" | "dark". Mode lives attheme.mode. Example:theme={{ mode: "dark", preset: "claude" }}.AtomSlotsandSlotOverridesare derived fromdefaultSlots; consumer module augmentation ofAtomSlotsno longer adds override keys.theme.classNames.openuiaccepts onlyrootandscope; arbitrary extra keys are no longer supported.- Complete
SemanticTokensobjects must includesuccess,successForeground,warning, andwarningForeground. Button,IconButton, dialogs, sheets, avatars, and other low-level primitives are customized through tokens/CSS rather than slots. Compound APIs (Button.Primary,icon=string props) are gone.- Import styles with only
@import "@truefoundry/trueforge-ui/styles.css"(notfy-web-components/theme.css). layoutaccepts a built-in string or a hostReact.ComponentType.serverprop no longer accepts{ type: "custom", server }. Pass a readyAgentUIServerdirectly (server={agentServer}). Built-in configs (truefoundry/trueforge) are unchanged and now accept an optionalcatalog.
Added
Named agent header title — when an immutable (named) agent chat is open, the thread header shows the agent name on the left (sidebar / drawer / dock / widget layouts). Hidden for idle and draft/mutable chats.
AgentLibraryEntry.agentId?/agentSpec?— optional listing fields. Hosts that only return{ name }keep working;agentSpecenables Edit.Agents Library Edit — when
isComposerEnabledand the row hasagentSpec, Edit binds a mutable session seeded from that spec (isMutable: true). Try Agent remains immutable (isMutable: false).selectLibraryAgent/shellIsMutable/libraryAgentIdon shell context.selectAgent/openDraftremain as thin wrappers.Reasoning-effort selector beside the model picker in the draft composer. Shown only when the selected
ModelSelectiondeclaresreasoningEfforts; the effort is coerced into the spec on model change or explicit pick.Skills catalog —
getSkillCatalogwith an Available/Selected split; registry skills (catalogId) return to Available on remove, GitHub imports are deleted for good. New types:RegistrySkill,GithubSkill,DefinedSkill,SkillConfigBase,SkillCatalogEntry,CreateSkillRequestBase,SelectRegistrySkillRequest,ImportGithubSkillRequest,SkillCatalogServer.getSkillCatalog.Sandbox catalog — list/create/update/delete of connected sandboxes from a catalog. New types:
SandboxConfig,SandboxCatalogEntry,SandboxBase,CreateSandboxRequest,UpdateSandboxRequest,SandboxCatalogServer.apiKeyis never stored in the catalog and is optional on update (blank keeps the existing key).TrueForgeBuiltInServerConfigexported for hosts that build the built-in config separately.agentConfigshell modes onTrueForgeUI/ShellModeProvider:SingleAgent— locked named agent (namerequired)AgentLibrary— Agents Library only; idle empty state until pick; no New ChatAgentComposer— draft composer only (no library)AgentLibraryWithComposer— library + draft (default when omitted)
Clear Chat control in thread headers (sidebar / drawer / dock / widget). Resets the current named thread or opens a fresh draft.
ClearChatButton,SelectAgentEmptyState,AgentConfig,DEFAULT_AGENT_CONFIGexported from the main barrel.Owned
ThemeProviderwith light / dark / system, CSS token injection,theme.brand,theme.icons,theme.classNames,theme.className.Semantic success/warning and assistant-bubble tokens, plus complete Markdown, syntax-highlighter, OpenUI, and Monaco class-name hooks.
Presets:
truefoundry,claude,chatgpt,gemini.BrandLogo/BrandIcon/useBrand;Icon/IconRegistry.Registry-backed robot brand fallback and overridable welcome/OAuth state icons. The standalone OAuth callback now inherits the shell theme and slots.
In-repo Markdown (OpenUI fences + syntax-highlighter),
MonacoEditorCore,CodeEditor.Public slots for agent-library/save/select controls, draft composer selectors, code/content renderers, and file-download UI; nested SDK composition now honors those overrides.
Example app: preset switcher + custom layout demo;
VITE_TFY_AGENT_MODEto try shell modes.
Migration
Component rename
// Before
import { TrueFoundryAssistantUI } from '@truefoundry/trueforge-ui';
<TrueFoundryAssistantUI server={server} layout="sidebar" />;
// After
import { TrueForgeUI } from '@truefoundry/trueforge-ui';
<TrueForgeUI server={server} layout="sidebar" />;
agentConfig (host must update)
| Before | After |
|---|---|
agentName="support-agent" |
agentConfig={{ mode: "SingleAgent", name: "support-agent" }} |
omit agentName (+ optional defaultAgentSpec) |
omit agentConfig, or agentConfig={{ mode: "AgentLibraryWithComposer", defaultAgentSpec }} |
| — | agentConfig={{ mode: "AgentLibrary" }} — library only, pick agent to start |
| — | agentConfig={{ mode: "AgentComposer", defaultAgentSpec }} — draft only |
// Before
<TrueFoundryAssistantUI server={server} layout="sidebar" agentName="support-agent" />
<TrueFoundryAssistantUI
server={server}
layout="sidebar"
defaultAgentSpec={{ model: { name: "openai-main/gpt-4.1" } }}
/>
// After
<TrueForgeUI
server={server}
layout="sidebar"
agentConfig={{ mode: "SingleAgent", name: "support-agent" }}
/>
<TrueForgeUI
server={server}
layout="sidebar"
agentConfig={{
mode: "AgentLibraryWithComposer",
defaultAgentSpec: { model: { name: "openai-main/gpt-4.1" } },
}}
/>
ShellModeProvider likewise takes agentConfig instead of agentName /
defaultAgentSpec.
Other Unreleased migrations
- Drop
@import "tfy-web-components/theme.css"and thetfy-web-componentspackage. - Replace
theme="dark"withtheme={{ mode: "dark" }}. - Update Button/IconButton overrides to the new prop surface.
- Replace product marks via
theme.brand; action icons viatheme.icons(Lucide / SVG — not Font AwesomeIconDefinition). - Optionally set
layout={MyLayout}and style content viatheme.classNamesor.aui-markdown/.aui-syntax-highlighter/.aui-openui/.aui-monaco. - Remove consumer
AtomSlotsmodule augmentations and use the documentedSlotOverrideskeys. - Replace custom
theme.classNames.openuikeys withroot,scope, or host CSS targeting.aui-openui. - Add success/warning pairs to any complete custom
SemanticTokensmaps.
[0.1.0]
Breaking
- Main entry no longer re-exports tfy design-system values (
Button,IconButton,IconProvider,Modal,Dialog,Accordion*,Skeleton,LightTooltip,registerIcons, …). Import those fromtfy-web-components. Override typesButtonProps/ButtonSize/IconButtonPropsremain on@truefoundry/trueforge-ui. - Peer dependency ranges aligned with supported versions (
@truefoundry/assistant-ui-runtime^0.1.4,truefoundry-gateway-sdk^0.4.0-rc.1,tfy-web-components^0.0.31). - tfy/MUI peer stack (
@mui/material,@emotion/*, Font Awesome,@openuidev/*) moved fromdependenciestopeerDependencies; hosts must install them. MessageTimestampis presentational and requirescreatedAt.UserMessageActionBaris presentational (copy/edit/retry props); runtime wiring lives in containers.MessageActionBaraccepts optionalcreatedAtand passes it toMessageTimestamp.- Default stylesheet no longer loads Google Fonts from the CDN; override
--font-agent-uiin host CSS if needed. preparescript replaced withprepublishOnly(install no longer builds automatically).
Added
TrueForgeUIquick-start component withlayout:sidebar|drawer|dock|widget(slots outside the chat provider so toast overrides apply).- Curated re-exports:
useAui,useAuiState,AssistantStatefrom the main barrel and@truefoundry/trueforge-ui/assistant-ui;useThemefrom the main barrel. - Optional
onThreadOpenonThreadListContainerfor stack/drawer chrome. - npm package metadata:
repository,homepage,bugs,keywords. - Drawer / widget Escape-to-close; drawer backdrop dismiss; widget
aria-modal. - Drawer / widget focus management (
inerton background, focus dialog, restore). docs/api.mdcurated public API reference.- CI coverage floor + example app build.
- Apache-2.0
LICENSE,NOTICE,CONTRIBUTING.md,SECURITY.md,CODE_OF_CONDUCT.md. - GitHub issue/PR templates and CI workflow.
docs/(architecture, customization, compatibility).- ESLint + Prettier.
- Unit tests for tool-call parsing helpers and
computeAgentStepsSplit.
Changed
- Required peers are only
react/react-dom.@assistant-ui/core(^0.2.22),@assistant-ui/react(^0.14.24), andtfy-web-components@^0.0.32moved todependencies(still listed as optional peers for hosts that install them directly for customization). Happy path:yarn add @truefoundry/trueforge-ui. Yarnresolutionspin a single@assistant-ui/core/store/tapcopy to avoid duplicate AuiProvider. tfy-web-componentsresolves from npm (^0.0.32) instead of a localfile:tarball.- MUI / Emotion / OpenUI / Monaco / extra Font Awesome packages come from
tfy-web-components(not peers of this SDK). - Font Awesome packages this SDK imports (
fontawesome-svg-core,free-solid-svg-icons) moved todependencies. SlotOverridesisPartial<AtomSlots>only (noRecord<string, unknown>).TrueForgeUIlazy-layoutSuspensefallback is a pulse skeleton instead of blank.- README reordered: quick start (prefer
client) before advanced sections.
Removed
- Unused
TokensProvider/useTokens/defaultTokenspublic API (and related token types). Theme via CSS variables fromstyles.cssinstead. examples/vite-chatsample app.- Unused
classnamesdependency (provided bytfy-web-components@^0.0.32). - Direct design-system
devDependenciesduplicated from web-components (@mui/material,@emotion/*,@openuidev/*,monaco-editor,@fortawesome/free-regular-svg-icons,@fortawesome/react-fontawesome). - Standalone
@truefoundry/trueforge-ui/openui.cssexport — OpenUI styles ship insidestyles.css. - Unused packages:
lodash-es,react-markdown,remark-gfm,class-variance-authority. - Broken
pack:devscript.
Fixed
- Error toasts stack (up to 5), use compact theme sizing, and include a copy action.
- Atom/container architecture: atoms no longer import
@assistant-ui/*. - Error toasts truncate large gateway response bodies.
Note
github-markdown-cssremains a devDependency required to compiledist/styles.css(pulled in via tfy Markdown CSS).
[0.0.8] - 2026-07-24
Changed
- Package and dependency updates prior to the 0.1.0 open-source readiness pass.