Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

Fix OpenCode session routing across FCC harnesses (#1708)

Ali Khokhar7c782dcdef6f
diff --git a/pyproject.toml b/pyproject.toml
index 1ca4b3a2..1978dc35 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "5.23.5"
+version = "5.23.6"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/src/free_claude_code/cli/launchers/aider.py b/src/free_claude_code/cli/launchers/aider.py
index 5ea15201..8a872ed2 100644
--- a/src/free_claude_code/cli/launchers/aider.py
+++ b/src/free_claude_code/cli/launchers/aider.py
@@ -1,6 +1,5 @@
"""Installed Aider launcher using native model settings for FCC routing."""
-import secrets
from collections.abc import Sequence
from free_claude_code.cli.environment import client_environment
@@ -13,11 +12,12 @@ from .runner import HarnessSpec, LaunchContext, PreparedLaunch, launch_harness
def _configure(
ctx: LaunchContext, args: list[str], files: LaunchResources
) -> PreparedLaunch:
- key_env = f"{AIDER_API_KEY_ENV_PREFIX}{secrets.token_hex(16).upper()}"
+ key_env = f"{AIDER_API_KEY_ENV_PREFIX}{ctx.launch_id.upper()}"
config = build_aider_config(
ctx.models,
messages_url=f"{ctx.proxy_root_url.rstrip('/')}/v1/messages",
api_key_env=key_env,
+ launch_id=ctx.launch_id,
)
settings_path = files.write_json("model-settings.yml", config.settings)
metadata_path = files.write_json("model-metadata.json", config.metadata)
diff --git a/src/free_claude_code/cli/launchers/aider_config.py b/src/free_claude_code/cli/launchers/aider_config.py
index f737f944..561686b4 100644
--- a/src/free_claude_code/cli/launchers/aider_config.py
+++ b/src/free_claude_code/cli/launchers/aider_config.py
@@ -25,6 +25,7 @@ def build_aider_config(
*,
messages_url: str,
api_key_env: str,
+ launch_id: str,
) -> AiderConfig:
"""Project a non-empty FCC Messages catalog into Aider's file contracts."""
@@ -47,6 +48,7 @@ def build_aider_config(
"model": f"anthropic/{model.wire_slug}",
"api_base": messages_url,
"api_key": f"os.environ/{api_key_env}",
+ "extra_headers": {"x-fcc-launch-id": launch_id},
},
}
if model.supports_reasoning is not None:
diff --git a/src/free_claude_code/cli/launchers/cline.py b/src/free_claude_code/cli/launchers/cline.py
index 5bf5cf32..e74da90d 100644
--- a/src/free_claude_code/cli/launchers/cline.py
+++ b/src/free_claude_code/cli/launchers/cline.py
@@ -26,7 +26,10 @@ def _configure(
ctx: LaunchContext, args: list[str], files: LaunchResources
) -> PreparedLaunch:
config = build_cline_config(
- ctx.models, proxy_root_url=ctx.proxy_root_url, auth_token=ctx.auth_token
+ ctx.models,
+ proxy_root_url=ctx.proxy_root_url,
+ auth_token=ctx.auth_token,
+ launch_id=ctx.launch_id,
)
providers_path = files.write_json("settings/providers.json", config.providers)
files.write_json("settings/models.json", config.models)
diff --git a/src/free_claude_code/cli/launchers/cline_config.py b/src/free_claude_code/cli/launchers/cline_config.py
index 6af0c267..deba4ba3 100644
--- a/src/free_claude_code/cli/launchers/cline_config.py
+++ b/src/free_claude_code/cli/launchers/cline_config.py
@@ -28,6 +28,7 @@ def build_cline_config(
*,
proxy_root_url: str,
auth_token: str,
+ launch_id: str,
now: datetime | None = None,
) -> ClineConfig:
"""Translate a non-empty FCC model snapshot into Cline's file contracts."""
@@ -42,6 +43,7 @@ def build_cline_config(
provider_settings: JsonObject = {
"provider": CLINE_PROVIDER_ID,
"apiKey": auth_token,
+ "headers": {"x-fcc-launch-id": launch_id},
"model": default_model,
"protocol": "openai-responses",
"baseUrl": proxy_v1_url(proxy_root_url),
diff --git a/src/free_claude_code/cli/launchers/hermes.py b/src/free_claude_code/cli/launchers/hermes.py
index df6c1efe..9dffa210 100644
--- a/src/free_claude_code/cli/launchers/hermes.py
+++ b/src/free_claude_code/cli/launchers/hermes.py
@@ -3,7 +3,6 @@
import json
import os
import re
-import secrets
from collections.abc import Sequence
from pathlib import Path
@@ -44,7 +43,7 @@ def _configure(
if os.name != "nt" and Path("/etc/hermes").exists():
raise ValueError("An existing Hermes managed policy cannot be replaced by FCC.")
managed = build_hermes_managed_config(
- ctx.models, proxy_root_url=ctx.proxy_root_url, nonce=secrets.token_hex(16)
+ ctx.models, proxy_root_url=ctx.proxy_root_url, nonce=ctx.launch_id
)
path = files.write_json("config.yaml", managed.config)
env = client_environment(
diff --git a/src/free_claude_code/cli/launchers/hermes_config.py b/src/free_claude_code/cli/launchers/hermes_config.py
index 06c213e4..706bca66 100644
--- a/src/free_claude_code/cli/launchers/hermes_config.py
+++ b/src/free_claude_code/cli/launchers/hermes_config.py
@@ -92,6 +92,7 @@ def build_hermes_managed_config(
"base_url": "",
"api_key": "",
"api_mode": "codex_responses",
+ "default_headers": {"x-fcc-launch-id": nonce},
},
"fallback_providers": [],
"fallback_model": [],
diff --git a/src/free_claude_code/cli/launchers/pi.py b/src/free_claude_code/cli/launchers/pi.py
index b1ec6665..d7e3d8eb 100644
--- a/src/free_claude_code/cli/launchers/pi.py
+++ b/src/free_claude_code/cli/launchers/pi.py
@@ -1,5 +1,6 @@
"""Installed Pi launcher using the bundled FCC provider extension."""
+import re
import sys
from collections.abc import Sequence
from pathlib import Path
@@ -13,8 +14,11 @@ from .runner import (
NativeCheck,
PreparedLaunch,
launch_harness,
+ version_at_least,
)
+_VERSION_PATTERN = re.compile(r"(?m)^\s*(\d+)\.(\d+)\.(\d+)\s*$")
+
def pi_extension_path() -> Path:
return Path(__file__).with_name("pi_extension.ts").resolve()
@@ -61,9 +65,9 @@ SPEC = HarnessSpec(
install_hint=pi_install_hint(),
configure=_configure,
compatibility_check=NativeCheck(
- ("--help",),
- lambda output: all(marker in output for marker in ("--extension", "--models")),
- "The 'pi' command is not a compatible Pi Coding Agent.",
+ ("--version",),
+ lambda output: version_at_least(output, _VERSION_PATTERN, (0, 80, 4)),
+ "FCC requires Pi 0.80.4 or newer for provider request headers.",
),
)
diff --git a/src/free_claude_code/cli/launchers/pi_extension.ts b/src/free_claude_code/cli/launchers/pi_extension.ts
index ba656321..a2ae9fd9 100644
--- a/src/free_claude_code/cli/launchers/pi_extension.ts
+++ b/src/free_claude_code/cli/launchers/pi_extension.ts
@@ -153,6 +153,12 @@ export default async function freeClaudeCode(pi: ExtensionAPI): Promise<void> {
models,
});
+ pi.on("before_provider_headers", (event, ctx) => {
+ if (ctx.model?.provider === "free-claude-code") {
+ event.headers["x-opencode-session"] = ctx.sessionManager.getSessionId();
+ }
+ });
+
pi.on("before_provider_request", (event, ctx) => {
const payload = event.payload;
if (
diff --git a/src/free_claude_code/cli/launchers/runner.py b/src/free_claude_code/cli/launchers/runner.py
index 7e05d37e..b633d2da 100644
--- a/src/free_claude_code/cli/launchers/runner.py
+++ b/src/free_claude_code/cli/launchers/runner.py
@@ -2,6 +2,7 @@
import os
import re
+import secrets
import subprocess
import sys
from collections.abc import Callable, Mapping, Sequence
@@ -40,6 +41,7 @@ class LaunchContext:
auth_token: str = field(repr=False)
base_env: Mapping[str, str] = field(repr=False)
models: tuple[ClientModel, ...]
+ launch_id: str = field(default_factory=lambda: secrets.token_hex(16))
@dataclass(frozen=True, slots=True)
diff --git a/src/free_claude_code/providers/opencode/provider.py b/src/free_claude_code/providers/opencode/provider.py
index d73562ed..8f6ae0da 100644
--- a/src/free_claude_code/providers/opencode/provider.py
+++ b/src/free_claude_code/providers/opencode/provider.py
@@ -138,6 +138,11 @@ class OpenCodeProvider(OpenAIChatProvider):
"session-id",
"x-session-id",
"x-claude-code-session-id",
+ "session_id",
+ "x-grok-session-id",
+ "x-meta-ai-gateway-session-id",
+ "x-tbh-session-id",
+ "x-fcc-launch-id",
):
session_id = headers.get(name)
if session_id and session_id.strip():
diff --git a/tests/api/test_opencode_session_headers.py b/tests/api/test_opencode_session_headers.py
index 395c3deb..f77977da 100644
--- a/tests/api/test_opencode_session_headers.py
+++ b/tests/api/test_opencode_session_headers.py
@@ -127,6 +127,10 @@ async def test_existing_session_id_reaches_opencode_without_forwarding_other_hea
"X-OpenCode-Session",
"X-Session-Id",
"X-Claude-Code-Session-Id",
+ "session_id",
+ "X-Grok-Session-Id",
+ "X-Meta-Ai-Gateway-Session-Id",
+ "X-Tbh-Session-Id",
):
for conversation in ("conversation-a", "conversation-a", "conversation-b"):
response = await client.post(
@@ -134,6 +138,7 @@ async def test_existing_session_id_reaches_opencode_without_forwarding_other_hea
json=payload(ingress, provider_id, selector),
headers=[
(name.encode(), conversation.encode()),
+ (b"X-Fcc-Launch-Id", b"launcher-fallback"),
(b"Cookie", b"private=cookie"),
(b"X-Private", b"caf\xe9"),
],
@@ -144,6 +149,7 @@ async def test_existing_session_id_reaches_opencode_without_forwarding_other_hea
assert upstream.headers["authorization"] == "Bearer test_opencode_key"
assert "cookie" not in upstream.headers
assert "x-private" not in upstream.headers
+ assert "x-fcc-launch-id" not in upstream.headers
assert {
name: value
for name, value in provider._client.default_headers.items()
@@ -165,6 +171,10 @@ async def test_session_header_precedence_and_absence_do_not_invent_or_reuse_iden
"x-opencode-session": "explicit-session",
"session-id": "native-session",
"X-Claude-Code-Session-Id": "claude-session",
+ "session_id": "dsh-session",
+ "x-grok-session-id": "grok-session",
+ "x-meta-ai-gateway-session-id": "muse-session",
+ "x-fcc-launch-id": "launcher-fallback",
},
)
assert response.status_code == 200, response.text
@@ -179,7 +189,42 @@ async def test_session_header_precedence_and_absence_do_not_invent_or_reuse_iden
@pytest.mark.parametrize("selector", ["responses-selector", "chat-selector"])
[email protected]("session_header", ["session-id", "X-Claude-Code-Session-Id"])
[email protected]("ingress", ["responses", "messages"])
+async def test_launch_fallback_is_stable_until_a_native_conversation_id_is_available(
+ selector, ingress
+):
+ async with wire_client() as (client, _provider, requests, _catalogs):
+ for launch_id, native_id in (
+ ("launch-a", ""),
+ ("launch-a", ""),
+ ("launch-a", "native-conversation"),
+ ("launch-b", ""),
+ ):
+ response = await client.post(
+ f"/v1/{ingress}",
+ json=payload(ingress, "opencode_zen", selector),
+ headers={"x-fcc-launch-id": launch_id, "session-id": native_id},
+ )
+ assert response.status_code == 200, response.text
+ assert requests[-1].headers["x-opencode-session"] == (
+ native_id or launch_id
+ )
+ assert "x-fcc-launch-id" not in requests[-1].headers
+
+
[email protected]("selector", ["responses-selector", "chat-selector"])
+ "session_header",
+ [
+ "session-id",
+ "X-Claude-Code-Session-Id",
+ "session_id",
+ "X-Grok-Session-Id",
+ "X-Meta-Ai-Gateway-Session-Id",
+ "X-Tbh-Session-Id",
+ "x-fcc-launch-id",
+ ],
+)
async def test_concurrent_conversations_keep_their_session_ids_during_retry(
selector, session_header
):
diff --git a/tests/cli/conftest.py b/tests/cli/conftest.py
index c84a0f8e..fc237c5b 100644
--- a/tests/cli/conftest.py
+++ b/tests/cli/conftest.py
@@ -44,7 +44,7 @@ class LaunchCapture:
exit_code: int = 23
versions: dict[str, str] = field(
default_factory=lambda: {
- "pi": "Pi Coding Agent --extension --models",
+ "pi": "0.80.4",
"opencode": "1.18.18",
"cline": "3.0.55",
"hermes": "Hermes Agent 0.20.4",
diff --git a/tests/cli/test_aider_config.py b/tests/cli/test_aider_config.py
index e24612f5..70c55668 100644
--- a/tests/cli/test_aider_config.py
+++ b/tests/cli/test_aider_config.py
@@ -44,6 +44,7 @@ def test_aider_config_projects_messages_route_and_canonical_catalog() -> None:
_models(),
messages_url="http://127.0.0.1:9191/v1/messages",
api_key_env="FCC_AIDER_PROXY_AUTH_A1B2C3",
+ launch_id="launch-a",
)
expected_metadata = {
@@ -77,6 +78,7 @@ def test_aider_config_projects_messages_route_and_canonical_catalog() -> None:
"model": f"anthropic/{wire_name}",
"api_base": "http://127.0.0.1:9191/v1/messages",
"api_key": "os.environ/FCC_AIDER_PROXY_AUTH_A1B2C3",
+ "extra_headers": {"x-fcc-launch-id": "launch-a"},
}
assert entries["nvidia_nim/vendor/model"]["accepts_settings"] == [
"reasoning_effort"
@@ -106,6 +108,7 @@ def test_aider_config_rejects_empty_catalog() -> None:
(),
messages_url="http://127.0.0.1:9191/v1/messages",
api_key_env="FCC_AIDER_PROXY_AUTH_A1B2C3",
+ launch_id="launch-a",
)
@@ -120,6 +123,7 @@ def test_aider_catalog_ids_take_precedence_over_generated_transport_spellings()
models,
messages_url="http://localhost:8182/v1/messages",
api_key_env="FCC_AIDER_PROXY_AUTH_COLLISION",
+ launch_id="launch-a",
)
entries = {entry["name"]: entry for entry in config.settings}
extra = entries["anthropic/provider/model"]["extra_params"]
@@ -147,4 +151,5 @@ def test_aider_config_rejects_invalid_api_key_environment_name(
_models(),
messages_url="http://127.0.0.1:9191/v1/messages",
api_key_env=api_key_env,
+ launch_id="launch-a",
)
diff --git a/tests/cli/test_aider_launcher.py b/tests/cli/test_aider_launcher.py
index 82b7ea42..8b6a6f1e 100644
--- a/tests/cli/test_aider_launcher.py
+++ b/tests/cli/test_aider_launcher.py
@@ -15,6 +15,7 @@ def test_aider_receives_native_files_and_a_private_credential_reference(
monkeypatch.setenv("fcc_aider_proxy_auth_stale", "stale-secret")
monkeypatch.setenv("USER_SETTING", "preserved")
key_names: list[str] = []
+ launch_ids: list[str] = []
def inspect(command, env):
settings_path = Path(env["AIDER_MODEL_SETTINGS_FILE"])
@@ -30,10 +31,18 @@ def test_aider_receives_native_files_and_a_private_credential_reference(
assert env[key_name] == "launcher-test-token"
key_names.append(key_name)
bare = next(entry for entry in settings if entry["name"] == env["AIDER_MODEL"])
+ launch_id = bare["extra_params"]["extra_headers"]["x-fcc-launch-id"]
+ assert launch_id
+ launch_ids.append(launch_id)
+ assert all(
+ entry["extra_params"]["extra_headers"] == {"x-fcc-launch-id": launch_id}
+ for entry in settings
+ )
assert bare["extra_params"] == {
"model": "anthropic/nvidia_nim/catalog-model:variant",
"api_base": "http://127.0.0.1:8182/v1/messages",
"api_key": f"os.environ/{key_name}",
+ "extra_headers": {"x-fcc-launch-id": launch_id},
}
assert env["AIDER_MODEL"] in metadata
assert "launcher-test-token" not in settings_path.read_text()
@@ -55,3 +64,4 @@ def test_aider_receives_native_files_and_a_private_credential_reference(
assert launch_capture.commands[0][-len(args) :] == args
launch("aider", [])
assert key_names[0] != key_names[1]
+ assert launch_ids[0] != launch_ids[1]
diff --git a/tests/cli/test_cline_launcher.py b/tests/cli/test_cline_launcher.py
index af8939d1..fe6c749c 100644
--- a/tests/cli/test_cline_launcher.py
+++ b/tests/cli/test_cline_launcher.py
@@ -45,6 +45,7 @@ def test_cline_config_uses_responses_and_only_known_metadata() -> None:
),
proxy_root_url="http://127.0.0.1:9191/",
auth_token="proxy-token",
+ launch_id="launch-a",
now=datetime(2026, 8, 15, 12, 30, tzinfo=UTC),
)
@@ -57,6 +58,7 @@ def test_cline_config_uses_responses_and_only_known_metadata() -> None:
"settings": {
"provider": "openai-native",
"apiKey": "proxy-token",
+ "headers": {"x-fcc-launch-id": "launch-a"},
"model": "nvidia_nim/vendor/model",
"protocol": "openai-responses",
"baseUrl": "http://127.0.0.1:9191/v1",
@@ -127,12 +129,15 @@ def test_cline_config_rejects_empty_model_catalog() -> None:
(),
proxy_root_url="http://127.0.0.1:9191",
auth_token="proxy-token",
+ launch_id="launch-a",
)
def test_cline_native_configuration_is_available_to_child(launch_capture) -> None:
from tests.cli.test_launcher_workflow import launch
+ launch_ids = []
+
def inspect(command, env):
providers_path = Path(env["CLINE_PROVIDER_SETTINGS_PATH"])
providers = json.loads(providers_path.read_text())
@@ -140,6 +145,8 @@ def test_cline_native_configuration_is_available_to_child(launch_capture) -> Non
settings = providers["providers"][CLINE_PROVIDER_ID]["settings"]
assert settings["baseUrl"] == "http://127.0.0.1:8182/v1"
assert settings["apiKey"] == "launcher-test-token"
+ launch_ids.append(settings["headers"]["x-fcc-launch-id"])
+ assert launch_ids[-1]
assert settings["model"] in models["providers"][CLINE_PROVIDER_ID]["models"]
assert env["CLINE_SESSION_BACKEND_MODE"] == "local"
assert command[:3] == ["cline", "--provider", "openai-native"]
@@ -148,3 +155,5 @@ def test_cline_native_configuration_is_available_to_child(launch_capture) -> Non
args = ["--model", "native-selection", "--data-dir", "native-data-dir"]
launch("cline", args)
assert launch_capture.commands[0][-len(args) :] == args
+ launch("cline", [])
+ assert launch_ids[0] != launch_ids[1]
diff --git a/tests/cli/test_hermes_config.py b/tests/cli/test_hermes_config.py
index 2ad3cdfa..a38e7d59 100644
--- a/tests/cli/test_hermes_config.py
+++ b/tests/cli/test_hermes_config.py
@@ -77,6 +77,7 @@ def test_hermes_config_pins_responses_catalog_and_fallbacks() -> None:
"base_url": "",
"api_key": "",
"api_mode": "codex_responses",
+ "default_headers": {"x-fcc-launch-id": "a1b2c3"},
}
assert managed.config["fallback_providers"] == []
assert managed.config["fallback_model"] == []
diff --git a/tests/cli/test_hermes_launcher.py b/tests/cli/test_hermes_launcher.py
index 2a3dcd6d..48af6cae 100644
--- a/tests/cli/test_hermes_launcher.py
+++ b/tests/cli/test_hermes_launcher.py
@@ -15,6 +15,8 @@ from tests.cli.test_launcher_workflow import launch
def test_hermes_uses_native_defaults_and_keeps_user_commands(
launch_capture: LaunchCapture,
) -> None:
+ launch_ids = []
+
def inspect(command, env):
config = json.loads(
(Path(env["HERMES_MANAGED_DIR"]) / "config.yaml").read_text()
@@ -26,6 +28,8 @@ def test_hermes_uses_native_defaults_and_keeps_user_commands(
assert entry["transport"] == "codex_responses"
assert entry["api"] == "http://127.0.0.1:8182/v1"
assert env[entry["key_env"]] == "launcher-test-token"
+ launch_ids.append(config["model"]["default_headers"]["x-fcc-launch-id"])
+ assert launch_ids[-1]
assert all(aux["provider"] == provider for aux in config["auxiliary"].values())
assert "launcher-test-token" not in json.dumps(config)
@@ -47,6 +51,8 @@ def test_hermes_uses_native_defaults_and_keeps_user_commands(
"model.provider",
"--json",
]
+ launch("hermes", [])
+ assert launch_ids[0] != launch_ids[1]
@pytest.mark.parametrize("output", ['"other-provider"', "{}", "", "not json"])
diff --git a/tests/cli/test_launcher_checks.py b/tests/cli/test_launcher_checks.py
index e59963f8..9f76f7b9 100644
--- a/tests/cli/test_launcher_checks.py
+++ b/tests/cli/test_launcher_checks.py
@@ -37,9 +37,11 @@ from tests.cli.test_launcher_workflow import HARNESSES, launch
("muse", "Muse Code 0.2.1", True),
("muse", "Muse Code 1.0.3 (1.0.3-R2198.1)", True),
("muse", "Muse Code 0.2.0", False),
- ("pi", "--extension --models", True),
- ("pi", "--extension", False),
- ("pi", "--models", False),
+ ("pi", "0.80.4", True),
+ ("pi", "0.85.0", True),
+ ("pi", "0.80.3", False),
+ ("pi", "0.80.4-beta", False),
+ ("pi", "--extension --models", False),
],
)
def test_native_compatibility_precedes_fcc_setup(
diff --git a/tests/cli/test_launcher_workflow.py b/tests/cli/test_launcher_workflow.py
index aceec734..9d6c66ec 100644
--- a/tests/cli/test_launcher_workflow.py
+++ b/tests/cli/test_launcher_workflow.py
@@ -129,6 +129,7 @@ def test_aider_native_settings_resolve_bare_and_transport_names_without_rewritin
(ClientModel(wire_name, wire_name, "Model", False),),
messages_url="http://localhost:8182/v1/messages",
api_key_env="FCC_AIDER_PROXY_AUTH_TEST123",
+ launch_id="launch-a",
)
entries = {entry["name"]: entry for entry in config.settings}
for name in (wire_name, f"anthropic/{wire_name}"):
diff --git a/tests/cli/test_pi_extension.py b/tests/cli/test_pi_extension.py
index c9f2734f..8a60a9bd 100644
--- a/tests/cli/test_pi_extension.py
+++ b/tests/cli/test_pi_extension.py
@@ -16,6 +16,65 @@ from free_claude_code.providers.github_copilot.types import CopilotEgress
from tests.providers.test_github_copilot_provider import Harness, collect
+def test_pi_sends_current_conversation_id_only_on_fcc_requests() -> None:
+ node = shutil.which("node")
+ if node is None:
+ pytest.skip("Node.js is not installed")
+ script = """
+const { default: extension } = await import(process.argv[1]);
+const handlers = new Map();
+process.env.FCC_PI_BASE_URL = "http://fcc.invalid";
+process.env.FCC_PI_API_KEY = "test-key";
+globalThis.fetch = async () => new Response(JSON.stringify({
+ object: "list",
+ data: [{ id: "opencode_zen/test", provider_model_ref: "opencode_zen/test" }],
+}));
+await extension({
+ registerProvider() {},
+ on(event, handler) { handlers.set(event, handler); },
+});
+const results = [];
+for (const [provider, session] of [
+ ["free-claude-code", "conversation-a"],
+ ["free-claude-code", "conversation-a"],
+ ["free-claude-code", "conversation-b"],
+ ["free-claude-code", "conversation-a"],
+ ["another-provider", "another-session"],
+]) {
+ const headers = { "x-existing": "preserve" };
+ await handlers.get("before_provider_headers")?.({ headers }, {
+ model: { provider },
+ sessionManager: { getSessionId() { return session; } },
+ });
+ results.push(headers);
+}
+console.log(JSON.stringify(results));
+"""
+ result = subprocess.run(
+ [
+ node,
+ "--experimental-strip-types",
+ "--input-type=module",
+ "--eval",
+ script,
+ pi_extension_path().as_uri(),
+ ],
+ capture_output=True,
+ check=False,
+ encoding="utf-8",
+ text=True,
+ timeout=10,
+ )
+ assert result.returncode == 0, result.stderr
+ assert json.loads(result.stdout) == [
+ {"x-existing": "preserve", "x-opencode-session": "conversation-a"},
+ {"x-existing": "preserve", "x-opencode-session": "conversation-a"},
+ {"x-existing": "preserve", "x-opencode-session": "conversation-b"},
+ {"x-existing": "preserve", "x-opencode-session": "conversation-a"},
+ {"x-existing": "preserve"},
+ ]
+
+
def _pi_request_payloads(cases: list[dict[str, object]]) -> list[dict[str, object]]:
node = shutil.which("node")
if node is None:
diff --git a/uv.lock b/uv.lock
index 3658e391..b5a6e31b 100644
--- a/uv.lock
+++ b/uv.lock
@@ -598,7 +598,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "5.23.5"
+version = "5.23.6"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },