Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.
Python agent-orchestrationaiai-agentschatopsdiscordlangchainmcpmicrosoft-teamsmulti-agentopen-sourceopenaiself-hostedslack
release: batch — runtime 0.3.2, core 0.17.3, console 0.27.3, sidecar 1.9.4, plugins 0.9.6/0.3.7/0.1.4 (#262)
Louis Amaudruzd330c9dcdb93
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex e01c6107d..5e5f7eed6 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -44,6 +44,17 @@ version of their own to them without also giving them a release of their own.### [Unreleased]+### [0.17.3] - 2026-08-19++#### Fixed+- The Mattermost bridge now bridges the channels a new bot is already a member+ of. A bot's websocket opens only after Mattermost has added it to the team's+ default channels, so it never witnessed its own joins — the first agent on an+ instance bridged nothing, and creating a second adopted Town Square and+ Off-Topic late and attributed to the wrong action. Current membership is now+ reconciled on connect rather than relying on live join broadcasts alone+ (CHOO-2203).+### [0.17.2] - 2026-08-18#### Fixed@@ -659,8 +670,37 @@ version of their own to them without also giving them a release of their own.### [Unreleased]+### [0.27.3] - 2026-08-19++#### Added++- Set an agent's **instructions** — what it is for, addressed to the agent+ itself — as a first-class field edited from its page, applied to whichever+ mechanism its provider uses (a Claude repo-agent, a Codex or OpenCode launch+ profile) rather than being a per-provider setting only (CHOO-2228).+- **Build switch-core from your checkout** for the managed local stack. A dev+ build launched from a Switch checkout can run switch/gateway/setup from the+ working tree (`up -d --build`) instead of this build's pinned GHCR images, via+ a toggle on the local server's page. Dev builds only, and only when an ancestor+ of the app's directory carries the Dockerfiles and `core/pyproject.toml` (#258).++#### Changed++- Local-server mode now bundles and pulls **switch-core `0.17.3`** (was+ `0.17.2`): the bundle pin / `COMPATIBLE_SWITCH_VERSION` is raised to the+ current core release.+#### Fixed+- CLI first-run prompts that leave a spawned session alive but never answering+ are now cleared or detected before the session starts — Claude Code auto-trust+ (silently broken since a config-key rename), its first-run setup wizard, and+ the bypass-permissions warning (CHOO-2213).+- @mentions in the embedded Mattermost view are readable in the light theme+ again — the link/mention colour pointed at the text-selection-highlight+ background and rendered at ~1.4:1 on the white channel (CHOO-2203).+- A newly onboarded agent's default Mattermost rooms show in the sidebar without+ waiting for a background reconcile to happen to fire (CHOO-2203).- **Sign-in details** for a managed server's bundled chat now stays open. Thedialog was rendered inside the messaging app's dropdown menu, so the sameclick that opened it closed the menu — and the menu took the dialog with it,@@ -1881,6 +1921,8 @@ The Switch protocol client and MCP runtime### [Unreleased]+### [0.3.2] - 2026-08-19+#### Fixed- An environment naming an agent but carrying no token now resolves against thelocal agent store instead of refusing to start. Any partial `SWITCH_*`@@ -1988,6 +2030,14 @@ by Switch Console rather than published on its own.### [Unreleased]+### [1.9.4]++#### Fixed+- The remote session spawner clears the CLI first-run prompts that would+ otherwise leave a spawned session alive but never answering, matching the+ desktop-side fix (CHOO-2213). Behavior change only — the client↔sidecar wire+ (ready line, endpoints, on-disk layout) is unchanged, so the major stays `1`.+### [1.9.3]#### Added@@ -2063,6 +2113,13 @@ compatibility signal. History for those is in the git log.### [Unreleased]+### [0.9.6] - 2026-08-19++#### Changed+- Pin `@sandboxaq/[email protected]` (was `0.3.1`) — picks up the+ runtime's store-based credential resolution (CHOO-1862); the plugin version+ bumps so installs re-download.+#### Fixed- **The `configure` skill no longer breaks the standalone path it exists to setup.** It wrote `SWITCH_API_ENDPOINT` and `SWITCH_AGENT_ID` into@@ -2250,6 +2307,16 @@ manifest history.### [Unreleased]+### [0.3.7] - 2026-08-19++#### Changed+- Pin `@sandboxaq/[email protected]` (was `0.3.1`) — picks up the+ runtime's store-based credential resolution (CHOO-1862); the plugin version+ bumps so installs re-download.+- The room-workflow skill lists the full set of reasons `switch_unavailable` can+ be the only tool, and points at the `configure` skill as the remedy for the+ ones it can fix (CHOO-1862).+### [0.3.6] - 2026-08-18#### Changed@@ -2388,6 +2455,14 @@ the app version that wrote it rather than a version of its own.### [Unreleased]+### [0.1.4] - 2026-08-19++#### Changed+- Pin `@sandboxaq/[email protected]` (was `0.3.1`) — picks up the+ runtime's store-based credential resolution (CHOO-1862). The pin lives in+ `distribution.ts` and `opencode.json`; the version bumps so a re-written+ install is stamped fresh.+### [0.1.3] - 2026-08-18#### Changeddiff --git a/artifacts.yaml b/artifacts.yamlindex b2d37e15e..78fb3e9a4 100644--- a/artifacts.yaml+++ b/artifacts.yaml@@ -60,13 +60,13 @@artifacts:switch-core:description: The backend service, and the gateway API it serves.- version: 0.17.2+ version: 0.17.3declared_in: core/pyproject.tomlpublished_as: switch-coreswitch-console:description: The desktop app.- version: 0.27.2+ version: 0.27.3declared_in: console/apps/switch-console-desktop/package.json# Which switch-core release this app build bundles and pulls for# local-server mode. DELIBERATELY NOT switch-core's version above.@@ -78,11 +78,11 @@ artifacts:# main. This moves only when Switch Console is ready to bundle that release —# in lockstep with the bundled compose.pins:- switch-core: 0.17.2+ switch-core: 0.17.3agent-runtime:description: The Switch protocol client and MCP runtime, published to a registry.- version: 0.3.1+ version: 0.3.2declared_in: console/packages/switch-agent-runtime/package.jsonsidecar:@@ -90,7 +90,7 @@ artifacts:The remote runtime Switch Console deploys to an agent host. Deployed ratherthan published, so nothing else declares its version — this file is itsonly source and the constant is generated from it.- version: 1.9.3+ version: 1.9.4# ── Published under the switch-core release ────────────────────────────────# No version of their own: `helm package` and the image build stamp them with@@ -127,12 +127,12 @@ artifacts:switch-connector:description: The Claude Code connector plugin.- version: 0.9.5+ version: 0.9.6declared_in: connectors/claude-code-plugin/.claude-plugin/plugin.jsonswitch-connector-codex:description: The Codex connector plugin.- version: 0.3.6+ version: 0.3.7declared_in: connectors/codex-plugin/.codex-plugin/plugin.jsonswitch-connector-opencode:@@ -140,7 +140,7 @@ artifacts:The OpenCode connector. Unlike the other two it is written by SwitchConsole rather than installed from the marketplace, because OpenCode hasno plugin marketplace to install it from.- version: 0.1.3+ version: 0.1.4declared_in: connectors/opencode-plugin/package.jsoncontracts:diff --git a/connectors/claude-code-plugin/.claude-plugin/plugin.json b/connectors/claude-code-plugin/.claude-plugin/plugin.jsonindex c1b30a2f5..879a19bce 100644--- a/connectors/claude-code-plugin/.claude-plugin/plugin.json+++ b/connectors/claude-code-plugin/.claude-plugin/plugin.json@@ -1,5 +1,5 @@{"name": "switch-connector",- "version": "0.9.5",+ "version": "0.9.6","description": "Connect Claude Code to a Switch platform instance as a participating agent"}diff --git a/connectors/claude-code-plugin/.mcp.json b/connectors/claude-code-plugin/.mcp.jsonindex 8005caa58..adeec2b3b 100644--- a/connectors/claude-code-plugin/.mcp.json+++ b/connectors/claude-code-plugin/.mcp.json@@ -2,7 +2,7 @@"mcpServers": {"switch": {"command": "npx",- "args": ["-y", "@sandboxaq/[email protected]"]+ "args": ["-y", "@sandboxaq/[email protected]"]}}}diff --git a/connectors/codex-plugin/.codex-plugin/plugin.json b/connectors/codex-plugin/.codex-plugin/plugin.jsonindex 61a49d7e8..884cdb82e 100644--- a/connectors/codex-plugin/.codex-plugin/plugin.json+++ b/connectors/codex-plugin/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "switch-connector-codex",- "version": "0.3.6",+ "version": "0.3.7","description": "Connect Codex to a Switch platform instance as a participating agent","skills": "./skills/","mcpServers": "./.mcp.json"diff --git a/connectors/codex-plugin/.mcp.json b/connectors/codex-plugin/.mcp.jsonindex e361df68b..a4383acaf 100644--- a/connectors/codex-plugin/.mcp.json+++ b/connectors/codex-plugin/.mcp.json@@ -2,7 +2,7 @@"mcpServers": {"switch": {"command": "npx",- "args": ["-y", "@sandboxaq/[email protected]"],+ "args": ["-y", "@sandboxaq/[email protected]"],"env_vars": ["SWITCH_API_ENDPOINT","SWITCH_API_TOKEN",diff --git a/connectors/opencode-plugin/opencode.json b/connectors/opencode-plugin/opencode.jsonindex 7d086111b..ff5b747cc 100644--- a/connectors/opencode-plugin/opencode.json+++ b/connectors/opencode-plugin/opencode.json@@ -3,7 +3,7 @@"mcp": {"switch": {"type": "local",- "command": ["npx", "-y", "@sandboxaq/[email protected]"],+ "command": ["npx", "-y", "@sandboxaq/[email protected]"],"enabled": true,"timeout": 60000}diff --git a/connectors/opencode-plugin/package.json b/connectors/opencode-plugin/package.jsonindex 409f691f3..1c67505b1 100644--- a/connectors/opencode-plugin/package.json+++ b/connectors/opencode-plugin/package.json@@ -1,6 +1,6 @@{"name": "switch-connector-opencode",- "version": "0.1.3",+ "version": "0.1.4","description": "Connect OpenCode to a Switch platform instance as a participating agent","private": true,"type": "module",diff --git a/console/apps/switch-console-desktop/package.json b/console/apps/switch-console-desktop/package.jsonindex b5602ee85..81e9cc409 100644--- a/console/apps/switch-console-desktop/package.json+++ b/console/apps/switch-console-desktop/package.json@@ -1,6 +1,6 @@{"name": "@switch-console/desktop",- "version": "0.27.2",+ "version": "0.27.3","description": "A cross-platform Electron app that orchestrates multiple coding agents in parallel","keywords": ["claude",diff --git a/console/apps/switch-console-desktop/src/shared/app-identity.canary.ts b/console/apps/switch-console-desktop/src/shared/app-identity.canary.tsindex 203625ed2..77d16946e 100644--- a/console/apps/switch-console-desktop/src/shared/app-identity.canary.ts+++ b/console/apps/switch-console-desktop/src/shared/app-identity.canary.ts@@ -17,4 +17,4 @@ export const RELEASE_REPO_NAME = 'switch';// against `switch-console.pins.switch-core` in artifacts.yaml by `just artifacts`,// so they can no longer drift apart — this used to say "keep in sync" and rely// on whoever edited one remembering the other (CHOO-1865).-export const COMPATIBLE_SWITCH_VERSION = '0.17.2';+export const COMPATIBLE_SWITCH_VERSION = '0.17.3';diff --git a/console/apps/switch-console-desktop/src/shared/app-identity.ts b/console/apps/switch-console-desktop/src/shared/app-identity.tsindex 6603889f3..90896b9a7 100644--- a/console/apps/switch-console-desktop/src/shared/app-identity.ts+++ b/console/apps/switch-console-desktop/src/shared/app-identity.ts@@ -60,4 +60,4 @@ export const RELEASE_REPO_NAME = 'switch';// core/pyproject.toml is the first step of cutting a switch-core release, and a// derived pin would immediately point local-server mode at images that are not// on the registry yet.-export const COMPATIBLE_SWITCH_VERSION = '0.17.2';+export const COMPATIBLE_SWITCH_VERSION = '0.17.3';diff --git a/console/packages/plugins/src/distribution.ts b/console/packages/plugins/src/distribution.tsindex 2fafcf893..4492806ec 100644--- a/console/packages/plugins/src/distribution.ts+++ b/console/packages/plugins/src/distribution.ts@@ -27,4 +27,4 @@ export const SWITCH_MARKETPLACE_SOURCE = 'sandbox-quantum/switch';* has got to, which during a release is a version npm does not have yet. A* pin has to lag it deliberately, and the lag is the point.*/-export const SWITCH_AGENT_RUNTIME_PIN = '@sandboxaq/[email protected]';+export const SWITCH_AGENT_RUNTIME_PIN = '@sandboxaq/[email protected]';diff --git a/console/packages/shared/src/artifacts.ts b/console/packages/shared/src/artifacts.tsindex 5f38d11c8..7f9185a96 100644--- a/console/packages/shared/src/artifacts.ts+++ b/console/packages/shared/src/artifacts.ts@@ -20,17 +20,17 @@ export interface ContractRange {* `CONTRACTS` below. The two must never be derived from one another.*/export const ARTIFACT_VERSIONS = {- 'switch-core': '0.17.2',- 'switch-console': '0.27.2',- 'agent-runtime': '0.3.1',- sidecar: '1.9.3',- gateway: '0.17.2',- setup: '0.17.2',- 'helm-chart': '0.17.2',- compose: '0.17.2',- 'switch-connector': '0.9.5',- 'switch-connector-codex': '0.3.6',- 'switch-connector-opencode': '0.1.3',+ 'switch-core': '0.17.3',+ 'switch-console': '0.27.3',+ 'agent-runtime': '0.3.2',+ sidecar: '1.9.4',+ gateway: '0.17.3',+ setup: '0.17.3',+ 'helm-chart': '0.17.3',+ compose: '0.17.3',+ 'switch-connector': '0.9.6',+ 'switch-connector-codex': '0.3.7',+ 'switch-connector-opencode': '0.1.4',} as const satisfies Record<string, string>;export type ArtifactName = keyof typeof ARTIFACT_VERSIONS;diff --git a/console/packages/switch-agent-runtime/package.json b/console/packages/switch-agent-runtime/package.jsonindex e214e965d..3d797fded 100644--- a/console/packages/switch-agent-runtime/package.json+++ b/console/packages/switch-agent-runtime/package.json@@ -1,6 +1,6 @@{"name": "@sandboxaq/switch-agent-runtime",- "version": "0.3.1",+ "version": "0.3.2","description": "Switch agent protocol client, and the local MCP runtime built on it","license": "Apache-2.0","author": {diff --git a/console/packages/switch-agent-runtime/src/artifacts.ts b/console/packages/switch-agent-runtime/src/artifacts.tsindex 5f38d11c8..7f9185a96 100644--- a/console/packages/switch-agent-runtime/src/artifacts.ts+++ b/console/packages/switch-agent-runtime/src/artifacts.ts@@ -20,17 +20,17 @@ export interface ContractRange {* `CONTRACTS` below. The two must never be derived from one another.*/export const ARTIFACT_VERSIONS = {- 'switch-core': '0.17.2',- 'switch-console': '0.27.2',- 'agent-runtime': '0.3.1',- sidecar: '1.9.3',- gateway: '0.17.2',- setup: '0.17.2',- 'helm-chart': '0.17.2',- compose: '0.17.2',- 'switch-connector': '0.9.5',- 'switch-connector-codex': '0.3.6',- 'switch-connector-opencode': '0.1.3',+ 'switch-core': '0.17.3',+ 'switch-console': '0.27.3',+ 'agent-runtime': '0.3.2',+ sidecar: '1.9.4',+ gateway: '0.17.3',+ setup: '0.17.3',+ 'helm-chart': '0.17.3',+ compose: '0.17.3',+ 'switch-connector': '0.9.6',+ 'switch-connector-codex': '0.3.7',+ 'switch-connector-opencode': '0.1.4',} as const satisfies Record<string, string>;export type ArtifactName = keyof typeof ARTIFACT_VERSIONS;diff --git a/core/pyproject.toml b/core/pyproject.tomlindex 0979f0d0a..2d3298dde 100644--- a/core/pyproject.toml+++ b/core/pyproject.toml@@ -1,6 +1,6 @@[project]name = "switch-core"-version = "0.17.2"+version = "0.17.3"description = "Switch — AI agent orchestration and governance platform"readme = "README.md"requires-python = ">=3.12"diff --git a/core/switch_core/artifacts.py b/core/switch_core/artifacts.pyindex fb1bbdf47..641b0574c 100644--- a/core/switch_core/artifacts.py+++ b/core/switch_core/artifacts.py@@ -20,17 +20,17 @@ class ContractRange(NamedTuple):# Where each artifact is. Says nothing about compatibility — that is# CONTRACTS below. The two must never be derived from one another.ARTIFACT_VERSIONS: Final[dict[str, str]] = {- "switch-core": "0.17.2",- "switch-console": "0.27.2",- "agent-runtime": "0.3.1",- "sidecar": "1.9.3",- "gateway": "0.17.2",- "setup": "0.17.2",- "helm-chart": "0.17.2",- "compose": "0.17.2",- "switch-connector": "0.9.5",- "switch-connector-codex": "0.3.6",- "switch-connector-opencode": "0.1.3",+ "switch-core": "0.17.3",+ "switch-console": "0.27.3",+ "agent-runtime": "0.3.2",+ "sidecar": "1.9.4",+ "gateway": "0.17.3",+ "setup": "0.17.3",+ "helm-chart": "0.17.3",+ "compose": "0.17.3",+ "switch-connector": "0.9.6",+ "switch-connector-codex": "0.3.7",+ "switch-connector-opencode": "0.1.4",}CONTRACTS: Final[dict[str, dict[str, ContractRange]]] = {diff --git a/core/uv.lock b/core/uv.lockindex 0b159d0dc..5086cc09f 100644--- a/core/uv.lock+++ b/core/uv.lock@@ -2445,7 +2445,7 @@ wheels = [[[package]]name = "switch-core"-version = "0.17.2"+version = "0.17.3"source = { editable = "." }dependencies = [{ name = "aiohttp" },