Repository navigation
v2.0.0 #368
v2.0.0
#368
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Read
docs/dev/upgrading-to-2.0.mdbefore upgrading. The first start migrates the database (V046–V049) and moves agent roles offusers.roles; the only way back to 1.x is the backup taken before it. In production the auth server refuses to start withoutMATE_SECRET_KEY. An installation upgraded from 1.x has one workspace, Default, holding everything it had, and answers its clients as 1.x did:shared/test/test_client_contract.pyruns the OpenAI-compatible API with a personal access token, the widget and/run_ssethrough the proxy against the real app, unchanged since 1.6.Added
/list-apps, the Work Room, the OpenAI-compatible API, MCP and A2A, the widget, triggers and Slack, alerts and rate limits, traces and replay. A row of another workspace answers 404. Agent names stay unique across the installation. Seedocs/user/workspaces.mdcode(the code executor, stdio MCP servers, hardcoded agents),server_credentials(Google Drive, Calendar, Supabase Storage, the shop's vendor settings) andemail(a trigger's or alert's email through the server's SMTP). Default has all three, as 1.x did, and always uses the platform's keys.X-MATE-Workspaceheader.OAUTH_ALLOWED_DOMAINSandOAUTH_ALLOWED_EMAILSstill apply. Seedocs/user/users-and-roles.mdworkspacecounts tokens and dollars over the whole workspace's usage, and the Whole workspace alert rule (stored asglobal) measures it. A user's budget or alert counts their usage in the workspace only. Seedocs/user/rate-limits.mdanddocs/user/alerts.mdworkspace_id.google,openai,anthropic,openrouter,deepseek,mistral,groq,xaiorollama, and set the workspace's image model. A key is looked up on every model call: the agent's own key, else the workspace's key for the model's provider, else the platform's keys in the environment when the workspace may use them, else the call fails withThis workspace has no key for <provider>. That covers the agent's model and its fallback, sub-agents, the compaction summarizer, native Gemini and File Search, the image tool, memory block embeddings, the eval judge and improver, Work Room titles and the hallucination guardrail. A key is saved only whenMATE_SECRET_KEYis set, is shown as••••1234once saved, and the audit entry names the provider only. Admins of the workspace see which providers have a key. Seedocs/user/workspaces.mddocs/dev/upgrading-to-2.0.md: what to do before upgrading, what the first start changes, how to check it and how to go back.shared/test/test_client_contract.pymakes the calls 1.x clients make against the real app: the OpenAI-compatible API with a personal access token, the widget and/run_ssethrough the proxy with admin credentials. A change to it is a breaking change.shared/test/test_cross_workspace.pycalls every dashboard route as a member of another workspace and fails when one answers with a row it should not, unless the route is listed as platform-only.shared/test/test_workspace_end_to_end.pysets up a workspace over HTTP and suspends it;shared/test/test_provider_keys_end_to_end.pyruns a workspace on its own OpenRouter key and checks that no request carries a platform key. Seedocs/dev/auth-and-access.mdChanged
MATE_SECRET_KEYis required in production (Workspaces phase 4a: schema for provider keys, MATE_SECRET_KEY required in production (#277) #347) - withMATE_ENV=productionthe auth server refuses to start without it, unlessMATE_ALLOW_INSECURE_DEFAULTSis set. Elsewhere it still only warns. Seedocs/dev/deployment.mdusers.roleskeeps onlyadmin,pendingandwidget. Agent roles are edited on Members; the Users page editsadminandpending. A user inserted with agent roles, as 1.x code writes them, gets them on the membership. Going back to 1.x after the first start loses the agent roles, which 1.x reads fromusers.roles: restore the backup instead.adminrole is a platform administrator and an owner of Default. Owners and admins of a workspace administer only that one; the installation's pages (settings, the wizard, binary builds, Platform → Workspaces) stay with platform administrators. Takingadminaway makes an owner of Default a member (Workspaces phase 3j: what the review of phase 3 found (#277) #342).ALLOWED_API_ROLESis matched on the user's agent roles in that workspace. A token stops working when its workspace is closed or suspended, or its owner is no longer a member of it.workspace_idfield.user_roles, the user's agent roles in the agent's workspace, where it listedusers.roles(Workspaces phase 3j: what the review of phase 3 found (#277) #342).MCP_EXPOSED_AGENTSdefaulted tochess_mate_root, so an installation with an agent of that name served it at/agents/chess_mate_root/mcp. Unset or empty, it now exposes none. SetMCP_EXPOSED_AGENTS=chess_mate_rootif you relied on the default.channel_integrations.team_idunique, so a Slack event finds one workspace. It fails on an installation with two integrations for one team; the upgrade guide has the query that finds them.parent_agents.alert()calls are the shared dialog.status: migratedagainst the code #205, Re-check the developer guides markedstatus: migratedagainst the code #206, Docs: user guides name UI elements that differ from the dashboard #236) - no guide is markedstatus: migratedany more, and the guides name the dashboard's buttons, fields and tiers as it shows them.Security
OUTBOUND_ALLOW_PRIVATE_NETWORKis set.widget_<key id>_id ortrigger_runner.tasks/getandtasks/cancelthrough one agent find none of another's tasks.Fixed
AGENT_FRAMEWORK=langgraph, only stores written into the agent'stool_configwere used. Both runtimes now add the stores assigned on the File Search page.parent_agentsstores names with\uescapes, which the lookup missed. Building the tree, a rename and a project move now match both spellings./docswas blank withCSP_MODE=enforce(Proxy: the agent server's Swagger UI at /docs gets the CSP nonce #366) - the proxy forwarded its Swagger UI without the response's nonce on the inline script that starts it. It now adds it, as/admin-docsdoes.This discussion was created from the release v2.0.0.
All reactions