google-agents-cli-extensions 1.14.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. core/claude/README.md +35 -0
  2. core/claude/template/.agents/skills/agents-cli-claude/SKILL.md +106 -0
  3. core/claude/template/.agents/skills/agents-cli-claude/references/claude.md +386 -0
  4. core/claude/template/.agents/skills/agents-cli-claude/references/migrate-claude-agent.md +318 -0
  5. core/claude/template/.agents/skills/agents-cli-claude/references/migrate-from-aws.md +132 -0
  6. core/claude/template/.dockerignore +28 -0
  7. core/claude/template/.env +18 -0
  8. core/claude/template/.env.example +17 -0
  9. core/claude/template/.template/templateconfig.yaml +31 -0
  10. core/claude/template/AGENTS.md +33 -0
  11. core/claude/template/Dockerfile +55 -0
  12. core/claude/template/agent_config/README.md +9 -0
  13. core/claude/template/agents-cli-extension.yaml +49 -0
  14. core/claude/template/app/__init__.py +15 -0
  15. core/claude/template/app/agent.py +49 -0
  16. core/claude/template/app/app_utils/a2a.py +245 -0
  17. core/claude/template/app/app_utils/bq_analytics/__init__.py +124 -0
  18. core/claude/template/app/app_utils/bq_analytics/recorder.py +593 -0
  19. core/claude/template/app/app_utils/bq_analytics/redaction.py +209 -0
  20. core/claude/template/app/app_utils/bq_analytics/schema.py +394 -0
  21. core/claude/template/app/app_utils/bq_analytics/tables.py +104 -0
  22. core/claude/template/app/app_utils/bq_analytics/uploader.py +188 -0
  23. core/claude/template/app/app_utils/claude.py +297 -0
  24. core/claude/template/app/app_utils/completions.py +225 -0
  25. core/claude/template/app/app_utils/conversation.py +29 -0
  26. core/claude/template/app/app_utils/memory_bank.py +308 -0
  27. core/claude/template/app/app_utils/project_settings.py +91 -0
  28. core/claude/template/app/app_utils/reasoning_engine.py +237 -0
  29. core/claude/template/app/app_utils/remote_agents.py +349 -0
  30. core/claude/template/app/app_utils/remote_auth.py +159 -0
  31. core/claude/template/app/app_utils/replies.py +143 -0
  32. core/claude/template/app/app_utils/session_store.py +174 -0
  33. core/claude/template/app/app_utils/settings.py +24 -0
  34. core/claude/template/app/app_utils/telemetry/__init__.py +114 -0
  35. core/claude/template/app/app_utils/telemetry/call_counts.py +44 -0
  36. core/claude/template/app/app_utils/telemetry/cli_relay.py +266 -0
  37. core/claude/template/app/app_utils/telemetry/config.py +133 -0
  38. core/claude/template/app/app_utils/telemetry/logs.py +175 -0
  39. core/claude/template/app/app_utils/telemetry/metrics.py +270 -0
  40. core/claude/template/app/app_utils/telemetry/request_flush.py +104 -0
  41. core/claude/template/app/app_utils/telemetry/subagent_spans.py +80 -0
  42. core/claude/template/app/app_utils/telemetry/traces.py +166 -0
  43. core/claude/template/app/app_utils/turn_events.py +463 -0
  44. core/claude/template/app/app_utils/turn_options.py +219 -0
  45. core/claude/template/app/app_utils/workspaces.py +65 -0
  46. core/claude/template/app/fast_api_app.py +71 -0
  47. core/claude/template/app/feature_tools.py +27 -0
  48. core/claude/template/pyproject.toml +100 -0
  49. core/claude/template/scripts/eval_generate.py +340 -0
  50. core/claude/template/scripts/publish.py +66 -0
  51. core/claude/template/scripts/run.py +85 -0
  52. core/claude/template/scripts/unsupported.py +48 -0
  53. core/claude/template/tests/eval/datasets/basic-dataset.json +31 -0
  54. core/claude/template/tests/eval/eval_config.yaml +17 -0
  55. core/claude/template/tests/eval/response_quality.py +60 -0
  56. core/claude/template/tests/integration/test_server_e2e.py +168 -0
  57. core/claude/template/tests/load_test/.results/.placeholder +0 -0
  58. core/claude/template/tests/load_test/README.md +24 -0
  59. core/claude/template/tests/load_test/load_test.py +118 -0
  60. core/claude/template/tests/unit/conftest.py +63 -0
  61. core/claude/template/tests/unit/helpers.py +32 -0
  62. core/claude/template/tests/unit/test_a2a.py +432 -0
  63. core/claude/template/tests/unit/test_bq_analytics.py +928 -0
  64. core/claude/template/tests/unit/test_bq_redaction.py +89 -0
  65. core/claude/template/tests/unit/test_claude.py +825 -0
  66. core/claude/template/tests/unit/test_completions.py +369 -0
  67. core/claude/template/tests/unit/test_fast_api_app.py +59 -0
  68. core/claude/template/tests/unit/test_feature_tools.py +55 -0
  69. core/claude/template/tests/unit/test_memory_bank.py +625 -0
  70. core/claude/template/tests/unit/test_reasoning_engine.py +295 -0
  71. core/claude/template/tests/unit/test_remote_agents.py +517 -0
  72. core/claude/template/tests/unit/test_telemetry.py +991 -0
  73. core/claude/template/tests/unit/test_turn_events.py +309 -0
  74. core/claude/template/tests/unit/test_turn_options.py +394 -0
  75. core/claude/template/uv.lock +3029 -0
  76. core/langchain/README.md +54 -0
  77. core/langchain/template/.agents/skills/agents-cli-langchain/SKILL.md +84 -0
  78. core/langchain/template/.agents/skills/agents-cli-langchain/references/langchain.md +120 -0
  79. core/langchain/template/.agents/skills/agents-cli-langchain/references/samples.md +42 -0
  80. core/langchain/template/.template/templateconfig.yaml +32 -0
  81. core/langchain/template/AGENTS.md +35 -0
  82. core/langchain/template/agents-cli-extension.yaml +54 -0
  83. core/langchain/template/app/__init__.py +19 -0
  84. core/langchain/template/app/agent.py +61 -0
  85. core/langchain/template/app/app_utils/a2a.py +176 -0
  86. core/langchain/template/app/app_utils/content.py +37 -0
  87. core/langchain/template/app/app_utils/telemetry.py +154 -0
  88. core/langchain/template/app/fast_api_app.py +68 -0
  89. core/langchain/template/langgraph.json +7 -0
  90. core/langchain/template/pyproject.toml +102 -0
  91. core/langchain/template/scripts/_content.py +40 -0
  92. core/langchain/template/scripts/eval_generate.py +202 -0
  93. core/langchain/template/scripts/publish.py +59 -0
  94. core/langchain/template/scripts/run.py +59 -0
  95. core/langchain/template/scripts/unsupported.py +48 -0
  96. core/langchain/template/tests/eval/datasets/basic-dataset.json +16 -0
  97. core/langchain/template/tests/eval/eval_config.yaml +32 -0
  98. core/langchain/template/tests/eval/response_quality.py +60 -0
  99. core/langchain/template/tests/integration/test_server_e2e.py +173 -0
  100. core/langchain/template/tests/load_test/.results/.placeholder +0 -0
  101. core/langchain/template/tests/load_test/README.md +20 -0
  102. core/langchain/template/tests/load_test/load_test.py +82 -0
  103. core/langchain/template/uv.lock +3820 -0
  104. google_agents_cli_extensions-1.14.2.dist-info/METADATA +133 -0
  105. google_agents_cli_extensions-1.14.2.dist-info/RECORD +107 -0
  106. google_agents_cli_extensions-1.14.2.dist-info/WHEEL +4 -0
  107. google_agents_cli_extensions-1.14.2.dist-info/licenses/LICENSE +201 -0
@@ -0,0 +1,394 @@
1
+ # Copyright 2026 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ """How `app/app_utils/turn_options.py` builds the options for one served turn."""
16
+
17
+ from __future__ import annotations
18
+
19
+ import uuid
20
+ from unittest.mock import AsyncMock, patch
21
+
22
+ import anyio
23
+ import pytest
24
+ from claude_agent_sdk import ClaudeAgentOptions, HookMatcher, InMemorySessionStore
25
+
26
+ from app.app_utils import claude, settings, turn_options
27
+ from tests.unit.helpers import workspaces_root, write_local_transcript
28
+
29
+ pytestmark = pytest.mark.usefixtures("isolated")
30
+
31
+
32
+ def _options_for(*args, **kwargs) -> ClaudeAgentOptions:
33
+ return anyio.run(turn_options.turn_options, *args, **kwargs)
34
+
35
+
36
+ class TestTurnOptions:
37
+ def test_conversation_starts_then_resumes_its_session(self):
38
+ first = _options_for(ClaudeAgentOptions(), "ctx-1")
39
+ write_local_transcript("ctx-1")
40
+ later = _options_for(ClaudeAgentOptions(), "ctx-1")
41
+
42
+ session = turn_options.session_id_for("ctx-1")
43
+ assert (first.session_id, first.resume) == (session, None)
44
+ assert (later.session_id, later.resume) == (None, session)
45
+ # Same conversation, same workspace: that is where the CLI keys it.
46
+ assert first.cwd == later.cwd == str(workspaces_root() / session)
47
+ assert first.include_partial_messages is True
48
+
49
+ def test_a_uuid_conversation_id_is_the_session_id(self):
50
+ # A2A clients send UUID context ids: the caller, the CLI and the spans
51
+ # then all see the same id.
52
+ context_id = "3e3a0114-1fa0-463c-a119-b599a1beb275"
53
+ assert _options_for(ClaudeAgentOptions(), context_id).session_id == context_id
54
+ # Any other spelling, or a non-UUID id, gets a stable derived UUID.
55
+ for other in (context_id.upper(), "ctx-1"):
56
+ session = _options_for(ClaudeAgentOptions(), other).session_id
57
+ assert session != other
58
+ assert str(uuid.UUID(session)) == session
59
+ assert _options_for(ClaudeAgentOptions(), other).session_id == session
60
+
61
+ def test_prompts_are_delivered_verbatim(self):
62
+ # Remote callers write the prompt: no "@/path" file reads, no slash commands.
63
+ assert _options_for(ClaudeAgentOptions(), "c").verbatim_prompts is True
64
+
65
+ def test_agent_running_in_the_project_root_needs_no_copy(self, isolated):
66
+ (isolated / "CLAUDE.md").write_text("Be terse.")
67
+ options = _options_for(ClaudeAgentOptions(cwd=str(isolated)), "c")
68
+ assert options.cwd == str(isolated)
69
+ assert options.setting_sources == ["project"]
70
+
71
+ def test_an_agents_own_directory_keeps_its_claude_settings(
72
+ self, isolated, tmp_path
73
+ ):
74
+ (isolated / ".claude").mkdir()
75
+ (isolated / ".claude" / "settings.json").write_text("{}")
76
+ repo = tmp_path / "repo"
77
+ (repo / ".claude").mkdir(parents=True)
78
+ (repo / ".claude" / "settings.json").write_text('{"model": "repo"}')
79
+ (repo / "CLAUDE.md").write_text("The repo's notes.")
80
+ (repo / ".mcp.json").write_text('{"mcpServers": {}}')
81
+
82
+ options = _options_for(ClaudeAgentOptions(cwd=str(repo)), "c")
83
+
84
+ # Nothing is copied over or deleted in a directory the agent points at.
85
+ assert (repo / ".claude" / "settings.json").read_text() == '{"model": "repo"}'
86
+ assert (repo / "CLAUDE.md").read_text() == "The repo's notes."
87
+ assert (repo / ".mcp.json").exists()
88
+ assert options.setting_sources == []
89
+
90
+ def test_conversations_get_their_own_workspace(self):
91
+ a = _options_for(ClaudeAgentOptions(), "ctx-a")
92
+ b = _options_for(ClaudeAgentOptions(), "ctx-b")
93
+ assert a.cwd != b.cwd
94
+
95
+ def test_server_defaults_apply_only_where_unset(self, tmp_path):
96
+ defaults = _options_for(ClaudeAgentOptions(), "c")
97
+ assert defaults.permission_mode == "dontAsk"
98
+ assert defaults.env["CLAUDE_CODE_DISABLE_AUTO_MEMORY"] == "1"
99
+ assert defaults.env["ENABLE_TOOL_SEARCH"] == "false"
100
+ assert defaults.env["CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"] == "1"
101
+ # Without project settings to copy, the CLI loads none.
102
+ assert defaults.setting_sources == []
103
+
104
+ own = _options_for(
105
+ ClaudeAgentOptions(
106
+ permission_mode="default",
107
+ cwd=str(tmp_path / "own"),
108
+ env={"CLAUDE_CODE_DISABLE_AUTO_MEMORY": "0"},
109
+ setting_sources=["user"],
110
+ ),
111
+ "c",
112
+ )
113
+ assert own.permission_mode == "default"
114
+ assert own.cwd == str(tmp_path / "own")
115
+ assert own.env["CLAUDE_CODE_DISABLE_AUTO_MEMORY"] == "0"
116
+ assert own.setting_sources == ["user"]
117
+
118
+ def test_own_permission_callback_is_not_shadowed(self):
119
+ async def allow(tool_name, tool_input, context):
120
+ return None
121
+
122
+ options = _options_for(ClaudeAgentOptions(can_use_tool=allow), "c")
123
+ assert options.permission_mode is None
124
+
125
+ @pytest.mark.parametrize(
126
+ ("options", "bare"),
127
+ [
128
+ (ClaudeAgentOptions(tools=[]), True),
129
+ (ClaudeAgentOptions(), False),
130
+ (ClaudeAgentOptions(tools=["WebSearch"]), False),
131
+ (ClaudeAgentOptions(tools=[], setting_sources=["user"]), False),
132
+ (ClaudeAgentOptions(tools=[], skills="all"), False),
133
+ (
134
+ ClaudeAgentOptions(tools=[], plugins=[{"type": "local", "path": "p"}]),
135
+ False,
136
+ ),
137
+ (
138
+ ClaudeAgentOptions(tools=[], hooks={"PreToolUse": [HookMatcher()]}),
139
+ False,
140
+ ),
141
+ (ClaudeAgentOptions(tools=[], env={"CLAUDE_CODE_SIMPLE": "0"}), False),
142
+ ],
143
+ )
144
+ def test_bare_mode_only_for_agents_that_lose_nothing_to_it(self, options, bare):
145
+ # Bare mode drops the reminders that make the model refuse plain
146
+ # instructions, but also built-in tools, settings, skills, plugins and hooks.
147
+ env = _options_for(options, "c").env
148
+ assert (env.get("CLAUDE_CODE_SIMPLE") == "1") == bare
149
+
150
+ def test_project_settings_rule_out_bare_mode(self, isolated):
151
+ (isolated / "CLAUDE.md").write_text("Be terse.")
152
+ options = _options_for(ClaudeAgentOptions(tools=[]), "c")
153
+ assert "CLAUDE_CODE_SIMPLE" not in options.env
154
+
155
+ def test_project_claude_settings_ship_with_the_agent(self, isolated):
156
+ (isolated / ".claude" / "agents").mkdir(parents=True)
157
+ (isolated / ".claude" / "agents" / "reviewer.md").write_text("---\n---\n")
158
+ (isolated / "CLAUDE.md").write_text("Always answer in French.")
159
+
160
+ options = _options_for(ClaudeAgentOptions(), "ctx-1")
161
+
162
+ workspace = workspaces_root() / turn_options.session_id_for("ctx-1")
163
+ assert options.setting_sources == ["project"]
164
+ assert (workspace / "CLAUDE.md").read_text() == "Always answer in French."
165
+ assert (workspace / ".claude" / "agents" / "reviewer.md").is_file()
166
+
167
+ def test_project_mcp_servers_ship_with_the_agent(self, isolated):
168
+ (isolated / ".mcp.json").write_text('{"mcpServers": {}}')
169
+
170
+ options = _options_for(ClaudeAgentOptions(), "ctx-1")
171
+
172
+ workspace = workspaces_root() / turn_options.session_id_for("ctx-1")
173
+ assert options.setting_sources == ["project"]
174
+ assert (workspace / ".mcp.json").read_text() == '{"mcpServers": {}}'
175
+
176
+ def test_agents_that_load_project_settings_get_the_copy(self, isolated):
177
+ (isolated / "CLAUDE.md").write_text("Be terse.")
178
+ options = _options_for(ClaudeAgentOptions(setting_sources=["project"]), "c")
179
+ assert (
180
+ workspaces_root() / turn_options.session_id_for("c") / "CLAUDE.md"
181
+ ).is_file()
182
+ assert options.setting_sources == ["project"]
183
+
184
+ @pytest.mark.parametrize(
185
+ ("setting_sources", "allowed"),
186
+ [
187
+ (None, ["mcp__w__get_weather", "Bash(touch:*)"]),
188
+ (["project", "local"], ["mcp__w__get_weather", "Bash(touch:*)", "Read"]),
189
+ ([], ["mcp__w__get_weather"]),
190
+ ],
191
+ )
192
+ def test_project_permission_rules_apply_in_the_workspace(
193
+ self, isolated, setting_sources, allowed
194
+ ):
195
+ # The CLI ignores allow rules from an untrusted workspace's settings,
196
+ # and a fresh workspace is never trusted.
197
+ (isolated / ".claude").mkdir()
198
+ (isolated / ".claude" / "settings.json").write_text(
199
+ '{"permissions": {"allow": ["Bash(touch:*)", "mcp__w__get_weather"]}}'
200
+ )
201
+ (isolated / ".claude" / "settings.local.json").write_text(
202
+ '{"permissions": {"allow": ["Read"]}}'
203
+ )
204
+ options = _options_for(
205
+ ClaudeAgentOptions(
206
+ allowed_tools=["mcp__w__get_weather"], setting_sources=setting_sources
207
+ ),
208
+ "c",
209
+ )
210
+ assert options.allowed_tools == allowed
211
+
212
+ def test_the_developers_own_claude_settings_are_not_loaded(self, isolated):
213
+ # The project root's files belong to the developer's coding assistant.
214
+ project = isolated.parent
215
+ (project / ".claude").mkdir()
216
+ (project / ".claude" / "settings.json").write_text(
217
+ '{"permissions": {"allow": ["Bash(*)"]}}'
218
+ )
219
+ (project / "CLAUDE.md").write_text("You are a coding assistant.")
220
+
221
+ options = _options_for(ClaudeAgentOptions(), "ctx-1")
222
+
223
+ workspace = workspaces_root() / turn_options.session_id_for("ctx-1")
224
+ assert options.setting_sources == []
225
+ assert options.allowed_tools == []
226
+ assert not (workspace / "CLAUDE.md").exists()
227
+ assert not (workspace / ".claude").exists()
228
+
229
+ def test_settings_the_agent_writes_into_its_workspace_are_dropped(self, isolated):
230
+ (isolated / ".claude" / "agents").mkdir(parents=True)
231
+ (isolated / ".claude" / "agents" / "reviewer.md").write_text("---\n---\n")
232
+ _options_for(ClaudeAgentOptions(), "ctx-1")
233
+ # An agent that can write files adds settings and an MCP server to its
234
+ # workspace, hoping the next turn loads them.
235
+ workspace = workspaces_root() / turn_options.session_id_for("ctx-1")
236
+ (workspace / ".claude" / "settings.json").write_text(
237
+ '{"permissions": {"allow": ["Bash(*)"]}, "hooks": {}}'
238
+ )
239
+ (workspace / ".mcp.json").write_text('{"mcpServers": {"x": {"command": "sh"}}}')
240
+
241
+ options = _options_for(ClaudeAgentOptions(), "ctx-1")
242
+
243
+ assert options.allowed_tools == []
244
+ assert not (workspace / ".claude" / "settings.json").exists()
245
+ assert not (workspace / ".mcp.json").exists()
246
+ assert (workspace / ".claude" / "agents" / "reviewer.md").is_file()
247
+
248
+ @pytest.mark.parametrize(
249
+ "settings",
250
+ ["{", "[]", '{"permissions": []}', '{"permissions": {"allow": "Bash"}}'],
251
+ )
252
+ def test_malformed_project_settings_add_no_rules(self, isolated, settings):
253
+ (isolated / ".claude").mkdir()
254
+ (isolated / ".claude" / "settings.json").write_text(settings)
255
+ assert _options_for(ClaudeAgentOptions(), "c").allowed_tools == []
256
+
257
+ def test_the_cli_does_not_get_the_cloud_sql_password(self, monkeypatch):
258
+ from app.app_utils.session_store import PostgresSessionStore
259
+
260
+ monkeypatch.setenv("INSTANCE_CONNECTION_NAME", "proj:us-east1:db")
261
+ monkeypatch.setenv("DB_PASS", "secret")
262
+ with patch.object(
263
+ PostgresSessionStore, "exists", AsyncMock(return_value=False)
264
+ ):
265
+ options = _options_for(ClaudeAgentOptions(), "ctx-1")
266
+
267
+ # The server's store has it; the CLI and its tools see it blanked.
268
+ assert isinstance(options.session_store, PostgresSessionStore)
269
+ assert options.env["DB_PASS"] == ""
270
+
271
+ def test_the_cli_always_calls_gemini_platform(self, monkeypatch):
272
+ monkeypatch.setenv("ANTHROPIC_API_KEY", "sk-server")
273
+ options = _options_for(
274
+ ClaudeAgentOptions(
275
+ env={
276
+ "ANTHROPIC_API_KEY": "sk-agent",
277
+ "ANTHROPIC_AUTH_TOKEN": "token",
278
+ "CLAUDE_CODE_USE_VERTEX": "0",
279
+ }
280
+ ),
281
+ "ctx-1",
282
+ )
283
+ assert options.env["CLAUDE_CODE_USE_VERTEX"] == "1"
284
+ assert options.env["ANTHROPIC_API_KEY"] == ""
285
+ assert options.env["ANTHROPIC_AUTH_TOKEN"] == ""
286
+
287
+ def test_model_calls_are_tagged_as_agents_cli_traffic(self):
288
+ env = _options_for(ClaudeAgentOptions(), "c").env
289
+ assert env["ANTHROPIC_CUSTOM_HEADERS"] == (
290
+ "x-goog-api-client: "
291
+ f"agents-cli-app/{settings.AGENTS_CLI_VERSION}+claude-agent-sdk"
292
+ )
293
+
294
+ @pytest.mark.parametrize("from_agent", [True, False])
295
+ def test_the_tag_keeps_custom_headers(self, monkeypatch, from_agent):
296
+ own = "X-Team: search"
297
+ if from_agent:
298
+ options = ClaudeAgentOptions(env={"ANTHROPIC_CUSTOM_HEADERS": own})
299
+ else:
300
+ monkeypatch.setenv("ANTHROPIC_CUSTOM_HEADERS", own)
301
+ options = ClaudeAgentOptions()
302
+ headers = _options_for(options, "c").env["ANTHROPIC_CUSTOM_HEADERS"]
303
+ assert headers.splitlines()[0] == own
304
+ assert headers.splitlines()[1].startswith("x-goog-api-client: agents-cli-app/")
305
+
306
+ @pytest.mark.parametrize(
307
+ ("var", "value"),
308
+ [
309
+ ("DO_NOT_TRACK", "1"),
310
+ ("AGENTS_CLI_TELEMETRY", "0"),
311
+ ("AGENTS_CLI_TELEMETRY", "Off"),
312
+ ],
313
+ )
314
+ @pytest.mark.parametrize("from_agent", [True, False])
315
+ def test_opting_out_of_telemetry_drops_the_tag(
316
+ self, monkeypatch, var, value, from_agent
317
+ ):
318
+ if from_agent:
319
+ options = ClaudeAgentOptions(env={var: value})
320
+ else:
321
+ monkeypatch.setenv(var, value)
322
+ options = ClaudeAgentOptions()
323
+ assert "ANTHROPIC_CUSTOM_HEADERS" not in _options_for(options, "c").env
324
+
325
+ def test_opting_out_keeps_custom_headers(self, monkeypatch):
326
+ # The opt-out only drops the tag; the agent's own headers still go out.
327
+ monkeypatch.setenv("AGENTS_CLI_TELEMETRY", "0")
328
+ options = ClaudeAgentOptions(env={"ANTHROPIC_CUSTOM_HEADERS": "X-Team: search"})
329
+ env = _options_for(options, "c").env
330
+ assert env["ANTHROPIC_CUSTOM_HEADERS"] == "X-Team: search"
331
+
332
+ def test_cloud_sql_env_gives_one_postgres_store_per_process(self, monkeypatch):
333
+ from app.app_utils.session_store import PostgresSessionStore
334
+
335
+ monkeypatch.setenv("INSTANCE_CONNECTION_NAME", "proj:us-east1:db")
336
+ monkeypatch.setenv("DB_PASS", "secret")
337
+ exists = AsyncMock(side_effect=[False, True])
338
+ with patch.object(PostgresSessionStore, "exists", exists):
339
+ first = _options_for(ClaudeAgentOptions(), "ctx-1")
340
+ later = _options_for(ClaudeAgentOptions(), "ctx-1")
341
+
342
+ assert isinstance(first.session_store, PostgresSessionStore)
343
+ assert later.session_store is first.session_store
344
+ session = turn_options.session_id_for("ctx-1")
345
+ assert (first.session_id, later.resume) == (session, session)
346
+ key = exists.call_args.args[0]
347
+ assert key["session_id"] == session
348
+ assert key["project_key"] == claude.claude_agent_sdk.project_key_for_directory(
349
+ workspaces_root() / session
350
+ )
351
+
352
+ def test_agents_own_store_wins_over_cloud_sql(self, monkeypatch):
353
+ monkeypatch.setenv("INSTANCE_CONNECTION_NAME", "proj:us-east1:db")
354
+ monkeypatch.setenv("DB_PASS", "secret")
355
+ own = InMemorySessionStore()
356
+ options = _options_for(ClaudeAgentOptions(session_store=own), "ctx-1")
357
+ assert options.session_store is own
358
+ assert options.session_id == turn_options.session_id_for("ctx-1")
359
+
360
+ def test_resumes_from_an_agents_own_store(self):
361
+ own = InMemorySessionStore()
362
+ session = turn_options.session_id_for("ctx-1")
363
+ project_key = claude.claude_agent_sdk.project_key_for_directory(
364
+ workspaces_root() / session
365
+ )
366
+ anyio.run(
367
+ own.append,
368
+ {"project_key": project_key, "session_id": session},
369
+ [{"type": "user"}],
370
+ )
371
+ options = _options_for(ClaudeAgentOptions(session_store=own), "ctx-1")
372
+ assert options.resume == session
373
+
374
+ def test_another_agent_does_not_resume_the_conversation(self, monkeypatch):
375
+ # Services running different agents can share a machine and a database.
376
+ store = InMemorySessionStore()
377
+ monkeypatch.setattr(settings, "AGENT_NAME", "agent_a")
378
+ first = _options_for(ClaudeAgentOptions(session_store=store), "ctx-1")
379
+ key = {
380
+ "project_key": claude.claude_agent_sdk.project_key_for_directory(first.cwd),
381
+ "session_id": first.session_id,
382
+ }
383
+ anyio.run(store.append, key, [{"type": "user"}])
384
+
385
+ monkeypatch.setattr(settings, "AGENT_NAME", "agent_b")
386
+ other = _options_for(ClaudeAgentOptions(session_store=store), "ctx-1")
387
+ assert other.cwd != first.cwd
388
+ assert other.resume is None
389
+ monkeypatch.setattr(settings, "AGENT_NAME", "agent_a")
390
+ again = _options_for(ClaudeAgentOptions(session_store=store), "ctx-1")
391
+ assert again.resume == first.session_id
392
+
393
+ def test_without_cloud_sql_there_is_no_store(self):
394
+ assert _options_for(ClaudeAgentOptions(), "ctx-1").session_store is None