Skip to content

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

95.7 KB
Raw Blame

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 AnalyticsEvents names with trueforge. 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 medium when the selected model offers it, instead of defaulting to the lowest effort. TrueFoundry model listing now passes mergeParams to 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 → low in both the draft (New Chat) composer and the agent builder (Agent Config) when the selected model does not offer medium, 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 environmentName so 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_timeout with 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 → low in both the draft (New Chat) composer and the agent builder (Agent Config) when the selected model does not offer medium, instead of falling back to the lowest offered effort.

0.180.0-rc.4

Patch Changes

  • 0a1606d: Default the reasoning effort to medium when the selected model offers it (falling back to the lowest real effort otherwise), instead of defaulting to the lowest effort. TrueFoundry model listing now passes mergeParams to 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

0.180.0-rc.1

Patch Changes

  • ca29d8f: Render lightbulb icon on Skills section header in Agent Config panel.
  • 7f2be59: Prefix public AnalyticsEvents names with trueforge. 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 environmentName so resumed chats show the correct environment; and keep showing a deleted environment from the agent spec.
  • 531350e: Emit trueforge.sdk.http_timeout with 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 environmentName so 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 environmentName so 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_limit from 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_limit from 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-editor to ^0.57.0 to address known vulnerabilities, and point the frontend Monaco worker plugin at the 0.56+ export paths so production builds resolve workers correctly.
  • 29e7aab: Add DELETE for 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 listSandboxProviders so 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 md up), 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

0.177.0-rc.4

Patch Changes

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-editor to ^0.57.0 to address known vulnerabilities, and point the frontend Monaco worker plugin at the 0.56+ export paths so production builds resolve workers correctly.
  • 29e7aab: Add DELETE for 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 listSandboxProviders so 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 md up), 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 host DaytonaSandboxConfig.
  • f4ee3dc: Share sessions with tenant members (popover, shared PATCH, 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 @write and @destructive again. 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.webSearch on 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 ApprovalNavBanner slot) 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; name always labels the mark, and resolveBrandChrome maps mode to layout chrome.

  • 16feb29: Add customActionRenderers so hosts can pause the composer on client-side tools with their own UI and resume via onSubmit(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 listMcp pages 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_agent drives 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-runtime to 0.1.25.

  • 0cc59f8: Add global Schedules page at /schedules with 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 sidebarText semantic token for sidebar nav labels, refresh trueforge sidebar colors, set trueforge base radius to 0.375rem (6px), and set sidebar / thread-list control corners to 0.75rem (12px).

    Expose design-system Button (Button.Primary / .Secondary / .Ghost / .Destructive). ButtonVariant is now primary | secondary | ghost | destructive (default renamed to primary; outline removed — use secondary). Button sizes are large (default) and small (icon for 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_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.

  • f8b5eeb: Add optional resource permissions and gate agent, schedule, and session mutations.

Patch Changes

  • 51127c4: Open Save Agent drawer on Clone with {name}-clone prefilled; 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-2 glyph on the agents-library trigger, and squared-off chrome-action geometry on the save-agent trigger. Also fixes agent-2.svg to use currentColor so 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 catalog id to AgentSpec name.
  • a189482: Load agent Use In Code snippets through client.internal.agents.getCodeSnippets instead of a raw client.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-runtime to 0.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-agent before 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}-copy via saveAgent), Manage Schedules, and Delete (wired through harness deleteAgent).
  • 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-runtime to 0.1.30.
  • 4c522e2: Bump @truefoundry/assistant-ui-runtime to 0.1.31.
  • fd1bf7f: Bump @truefoundry/assistant-ui-runtime to 0.1.38 for assistant completion timestamps and keep-alive turn streams on session switch.
  • 4be60e7: Bump @truefoundry/assistant-ui-runtime to 0.1.41 for 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_url passed 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-runtime to 0.1.34.
  • a9430bd: Accept optional base_url on agent code-snippets (FE public host); fall back to request origin + PUBLIC_BASE_URL path.
  • 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 trueforge theme 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 @destructive only. Selecting Other/read-only tools clears approval; selecting destructive tools keeps it on. Migrate mounts still carrying the old @write+@destructive default.
  • 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_tools on 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/:agentId when 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/agents with limit / page_token and a pagination envelope; optional agent_name filters 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 /settings route when Settings chrome is unavailable (no catalog or capabilities.settings.enabled is 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/error on 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.update event schema with paused/running status and action_required_on_events.
  • bc11131: Share a single PageHeader across 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/trueforge working on native Windows: import Kysely migrations with pathToFileURL, and keep sandbox guest paths POSIX. Source development stays Unix/WSL; CI also runs unit and SQLite store tests on Windows.
  • 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-runtime to 0.1.41 for turn-scoped sandbox artifact downloads and to stop stale session history from merging after a session switch.
  • 551b6a8: Default MCP tool approval to @destructive only. Selecting Other/read-only tools clears approval; selecting destructive tools keeps it on. Migrate mounts still carrying the old @write+@destructive default.
  • 551b6a8: Let Build Agent pick which MCP tools require human approval, saved as require_approval_for_tools on 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.update event schema with paused/running status and action_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-runtime to 0.1.39.

0.3.0-rc.9

Patch Changes

  • fd1bf7f: Bump @truefoundry/assistant-ui-runtime to 0.1.38 for 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

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/agents with limit / page_token and a pagination envelope; optional agent_name filters 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 catalog id to AgentSpec name.
  • 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-agent before 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-runtime to 0.1.30.
  • 4c522e2: Bump @truefoundry/assistant-ui-runtime to 0.1.31.
  • d719155: Keep composer catalogs cached when starting a new chat.
  • c0359ca: Strip a trailing slash from the base_url passed 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-runtime to 0.1.34.
  • a9430bd: Accept optional base_url on agent code-snippets (FE public host); fall back to request origin + PUBLIC_BASE_URL path.
  • 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 sidebarText semantic token for sidebar nav labels, refresh trueforge sidebar colors, set trueforge base radius to 0.375rem (6px), and set sidebar / thread-list control corners to 0.75rem (12px).

    Expose design-system Button (Button.Primary / .Secondary / .Ghost / .Destructive). ButtonVariant is now primary | secondary | ghost | destructive (default renamed to primary; outline removed — use secondary). Button sizes are large (default) and small (icon for 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/:agentId when those server ports are omitted, matching the Settings Lego gate.
  • 5d72138: Keep npx @truefoundry/trueforge working on native Windows: import Kysely migrations with pathToFileURL, and keep sandbox guest paths POSIX. Source development stays Unix/WSL; CI also runs unit and SQLite store tests on Windows.
  • 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 listMcp pages 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_agent drives 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-runtime to 0.1.25.
  • 0cc59f8: Add global Schedules page at /schedules with 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_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

  • 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-2 glyph on the agents-library trigger, and squared-off chrome-action geometry on the save-agent trigger. Also fixes agent-2.svg to use currentColor so it is legible in dark mode.
  • a189482: Load agent Use In Code snippets through client.internal.agents.getCodeSnippets instead of a raw client.fetch.
  • c4ee138: Agent list and details overflow menu: Edit, Clone ({name}-copy via saveAgent), Manage Schedules, and Delete (wired through harness deleteAgent).
  • 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 trueforge theme 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 /settings route when Settings chrome is unavailable (no catalog or capabilities.settings.enabled is 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/error on 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 PageHeader across 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; name always labels the mark, and resolveBrandChrome maps mode to layout chrome.
  • 16feb29: Add customActionRenderers so hosts can pause the composer on client-side tools with their own UI and resume via onSubmit(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. Set mode, then pass the fields it requires. name always labels the mark (alt / aria-label):
    • 'icon-title' — name + optional icon (title shown in expanded chrome)
    • 'icon-only' — name + icon (alt kept, no title text)
    • 'logo' — name + icon + logo (wordmark in expanded chrome; name is alt only)
    • Default — omit brand for the TrueForge wordmark / square mark
  • resolveBrandChrome() — maps brand.mode to { expandedVariant, collapsedVariant, showTitle }. SidebarLayout uses it; custom layouts should too.

Changed

  • BrandConfig — discriminated on mode (BrandMode). Removed showTitle from 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 deleteAuthorize to deleteAuthorization.
  • 45dc6cd: Replace MCP authorize redirect_url with a same-origin return_to path to prevent open redirects after OAuth.
  • Updated dependencies [3113aa4]
  • Updated dependencies [45dc6cd]

0.2.1

Patch Changes

  • c5223ad: Ship react-dom and react-router-dom as 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 with whitespace-pre-wrap so 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 withRouter URL sync for shell places (/, /agents/:agentName, /sessions/:sessionId, /settings), with path customization via routes and react-router-dom as an optional peer. Serve the app shell for client-side deep links from the TrueForge server.

Patch Changes

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. TrueForgeUI layout is 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 (name plus manifest, 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. TrueForgeUI layout is 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 (name plus manifest, 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

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.reasoningEfforts for 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, registry enableTools default ["@all"])

Fixed

  • Sub-agent Allow/Deny — nested tool approvals inside create_sub_agent now call useTrueFoundryRespondToToolApproval with 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 snapshotName from SandboxProviderConfig and wrap listSandboxProviders as { data, snapshotSyncStatus } (Harness status / status_reason). Re-exports SandboxProviderListEntry / 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 (agentId set) and immutable library agents are unchanged.
  • Optional layout — <TrueForgeUI /> layout prop defaults to "sidebar".
  • type: "trueforge" built-in server — <TrueForgeUI server={{ type: 'trueforge', baseUrl?, token?, fetch? }} /> resolves a full Harness AgentUIServer via @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.logo accepts a BrandLogoConfig ({ src?, light?, dark?, href? }). The source is picked from the resolved theme mode, falling back to the other mode and then src, so a single configured mode covers both and { light } alone never renders a missing image. href wraps 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>.
  • BrandLogo slot — now in the slot table and resolved through useSlot by every layout, so overrides={{ 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 — ThemeProvider injects 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 (no html.dark / :root retheme of the host page).
  • Dependency — @truefoundry/assistant-ui-runtime pinned to 0.1.13. ModelSelectorEntry now requires id, nested provider: ProviderEntry, and properties: ModelProperties (replacing flat provider / providerLogo / reasoningEfforts). Re-exports ProviderEntry and ModelProperties.

Fixed

  • History row mutability — prefer custom.isMutable from the session (runtime stamp) over inferring from agentName. Orphaned named refs (deleted agent, no agentName) open as immutable. openHistorySession allows isMutable: false without an agent name.
  • Edit-bound draft history switch — do not reuse the mutable shell via switchToThread when the shell still carries an Edit agentName/agentId and the row is a different session. Remount through openHistorySession so Update Agent chrome cannot overwrite the wrong library agent.

Breaking

  • Server-port types owned by @truefoundry/assistant-ui-runtime — this package no longer defines AgentChatServer / AgentBuilderServer / catalog DTOs locally. Host-facing types are re-exported from @truefoundry/assistant-ui-runtime/server via src/server/types.ts. Prefer importing types from @truefoundry/trueforge-ui (hosts should not need the runtime package for types). Requires runtime 0.1.13.
  • Removed public pagination helpers — PageResult, TokenPagination, ListSessionsResponse, ListTurnsResponse, ListSessionEventsResponse, and opaque SessionEvent are gone from this package. Chat list APIs use runtime ListResult<T> ({ data, nextPageToken? }).
  • AgentUIServer / mounts follow the runtime contract — composed port matches runtime AgentUIServerPort; SkillMount / McpServerMount stay opaque object (hosts widen via generics). Implement getCapabilities() on every builder host.
  • One brand component — removed the BrandIcon export; BrandLogo is the only product mark and renders the mark alone. Callers that also want the name as text pair it with useBrandName() (as the sidebar header does), rather than relying on a second component that hard-codes one arrangement. Replace <BrandIcon /> with <BrandLogo />, and overrides={{ BrandIcon }} with overrides={{ BrandLogo }}.
  • brand.name is required — theme.brand stays optional, but setting it now requires name, since it labels the logo and a logo with no name has no accessible name. logo remains optional, so brand: { name: 'Acme' } still pairs host text with the default mark. useBrand() returns Partial<BrandConfig>, since brand may be absent entirely.
  • theme.brand is images-only — removed brand.icon; there is one logo source. Removed the ReactNode and render-function variants of the logo value (and with them the BrandImage type export), so brand.logo is now string | BrandLogoConfig. Component-valued marks move to the slot table: overrides={{ BrandLogo: MyMark }}, which is how every other atom is replaced. Also removed alt — the logo is labelled with brand.name, so there is one place to set the accessible name.
  • Default brand name is "TrueForge" (was "TrueFoundry"), used by BrandLogo, the sidebar header, and useBrandName().
  • ShellMode shape — replaced type: 'idle' | 'named' | 'draft' with status: 'idle' | 'active' plus isMutable on active bindings. Composer / Save Agent / welcome chrome key off isMutable, not draft|named. Hosts that inspected mode.type must switch to mode.status / mode.isMutable (see shellIsMutable).
  • Renamed TrueFoundryAssistantUI → TrueForgeUI (props type TrueFoundryAssistantUIProps → TrueForgeUIProps). Update imports and JSX.
  • TrueForgeUI agent props — replaced top-level agentName and defaultAgentSpec with a single discriminated agentConfig. 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.icons values are Lucide components, React nodes, render fns, or SVGR SVGs — not IconDefinition. Drop @fortawesome/* if you only used them for this SDK.
  • Removed tfy-web-components dependency and peer. Primitives, icons, theme, Markdown, and agent-chat molecules are owned by this SDK.
  • theme prop is now ThemeConfig (object), not "light" | "dark". Mode lives at theme.mode. Example: theme={{ mode: "dark", preset: "claude" }}.
  • AtomSlots and SlotOverrides are derived from defaultSlots; consumer module augmentation of AtomSlots no longer adds override keys.
  • theme.classNames.openui accepts only root and scope; arbitrary extra keys are no longer supported.
  • Complete SemanticTokens objects must include success, successForeground, warning, and warningForeground.
  • 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" (no tfy-web-components/theme.css).
  • layout accepts a built-in string or a host React.ComponentType.
  • server prop no longer accepts { type: "custom", server }. Pass a ready AgentUIServer directly (server={agentServer}). Built-in configs (truefoundry / trueforge) are unchanged and now accept an optional catalog.

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; agentSpec enables Edit.

  • Agents Library Edit — when isComposerEnabled and the row has agentSpec, Edit binds a mutable session seeded from that spec (isMutable: true). Try Agent remains immutable (isMutable: false).

  • selectLibraryAgent / shellIsMutable / libraryAgentId on shell context. selectAgent / openDraft remain as thin wrappers.

  • Reasoning-effort selector beside the model picker in the draft composer. Shown only when the selected ModelSelection declares reasoningEfforts; the effort is coerced into the spec on model change or explicit pick.

  • Skills catalog — getSkillCatalog with 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. apiKey is never stored in the catalog and is optional on update (blank keeps the existing key).

  • TrueForgeBuiltInServerConfig exported for hosts that build the built-in config separately.

  • agentConfig shell modes on TrueForgeUI / ShellModeProvider:

    • SingleAgent — locked named agent (name required)
    • AgentLibrary — Agents Library only; idle empty state until pick; no New Chat
    • AgentComposer — 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_CONFIG exported from the main barrel.

  • Owned ThemeProvider with 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_MODE to 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

  1. Drop @import "tfy-web-components/theme.css" and the tfy-web-components package.
  2. Replace theme="dark" with theme={{ mode: "dark" }}.
  3. Update Button/IconButton overrides to the new prop surface.
  4. Replace product marks via theme.brand; action icons via theme.icons (Lucide / SVG — not Font Awesome IconDefinition).
  5. Optionally set layout={MyLayout} and style content via theme.classNames or .aui-markdown / .aui-syntax-highlighter / .aui-openui / .aui-monaco.
  6. Remove consumer AtomSlots module augmentations and use the documented SlotOverrides keys.
  7. Replace custom theme.classNames.openui keys with root, scope, or host CSS targeting .aui-openui.
  8. Add success/warning pairs to any complete custom SemanticTokens maps.

[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 from tfy-web-components. Override types ButtonProps / ButtonSize / IconButtonProps remain 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 from dependencies to peerDependencies; hosts must install them.
  • MessageTimestamp is presentational and requires createdAt.
  • UserMessageActionBar is presentational (copy/edit/retry props); runtime wiring lives in containers.
  • MessageActionBar accepts optional createdAt and passes it to MessageTimestamp.
  • Default stylesheet no longer loads Google Fonts from the CDN; override --font-agent-ui in host CSS if needed.
  • prepare script replaced with prepublishOnly (install no longer builds automatically).

Added

  • TrueForgeUI quick-start component with layout: sidebar | drawer | dock | widget (slots outside the chat provider so toast overrides apply).
  • Curated re-exports: useAui, useAuiState, AssistantState from the main barrel and @truefoundry/trueforge-ui/assistant-ui; useTheme from the main barrel.
  • Optional onThreadOpen on ThreadListContainer for 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 (inert on background, focus dialog, restore).
  • docs/api.md curated 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), and tfy-web-components@^0.0.32 moved to dependencies (still listed as optional peers for hosts that install them directly for customization). Happy path: yarn add @truefoundry/trueforge-ui. Yarn resolutions pin a single @assistant-ui/core / store / tap copy to avoid duplicate AuiProvider.
  • tfy-web-components resolves from npm (^0.0.32) instead of a local file: 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 to dependencies.
  • SlotOverrides is Partial<AtomSlots> only (no Record<string, unknown>).
  • TrueForgeUI lazy-layout Suspense fallback is a pulse skeleton instead of blank.
  • README reordered: quick start (prefer client) before advanced sections.

Removed

  • Unused TokensProvider / useTokens / defaultTokens public API (and related token types). Theme via CSS variables from styles.css instead.
  • examples/vite-chat sample app.
  • Unused classnames dependency (provided by tfy-web-components@^0.0.32).
  • Direct design-system devDependencies duplicated from web-components (@mui/material, @emotion/*, @openuidev/*, monaco-editor, @fortawesome/free-regular-svg-icons, @fortawesome/react-fontawesome).
  • Standalone @truefoundry/trueforge-ui/openui.css export — OpenUI styles ship inside styles.css.
  • Unused packages: lodash-es, react-markdown, remark-gfm, class-variance-authority.
  • Broken pack:dev script.

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-css remains a devDependency required to compile dist/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.