clawd-code-sdk 1.1.6__tar.gz → 1.1.7__tar.gz
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.
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/PKG-INFO +2 -2
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/pyproject.toml +1 -1
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/__init__.py +1 -1
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_errors.py +7 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_internal/query.py +2 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_internal/transport/subprocess_utils.py +25 -7
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/client.py +167 -12
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/__init__.py +103 -1
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/agents.py +22 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/base.py +118 -18
- clawd_code_sdk-1.1.7/src/clawd_code_sdk/models/context_usage.py +319 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/control.py +198 -2
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/hooks.py +139 -1
- clawd_code_sdk-1.1.7/src/clawd_code_sdk/models/input_types.py +1136 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/mcp.py +25 -4
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/messages.py +262 -8
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/options.py +47 -0
- clawd_code_sdk-1.1.7/src/clawd_code_sdk/models/output_types.py +1986 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/server_info.py +85 -4
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/session.py +3 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/settings.py +1050 -44
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/system_messages.py +216 -4
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/thinking.py +1 -1
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/usage.py +67 -0
- clawd_code_sdk-1.1.7/tests/test_sdk_0_3_types.py +187 -0
- clawd_code_sdk-1.1.6/src/clawd_code_sdk/models/context_usage.py +0 -151
- clawd_code_sdk-1.1.6/src/clawd_code_sdk/models/input_types.py +0 -387
- clawd_code_sdk-1.1.6/src/clawd_code_sdk/models/output_types.py +0 -907
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/.gitignore +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/LICENSE +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/README.md +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_bundled/.gitignore +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_internal/__init__.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_internal/session_mutations.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_internal/sessions.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_internal/transport/__init__.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_internal/transport/subprocess_cli.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/_version.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/anthropic_stream.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/instrumentation.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/list_sessions.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/mcp_utils.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/anthropic_types.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/content_blocks.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/permissions.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/prompt_requests.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/models/prompts.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/py.typed +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/session.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/storage/ARCHITECTURE.md +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/storage/__init__.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/storage/helpers.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/storage/models.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/storage/replay.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/src/clawd_code_sdk/usage.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/__init__.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/conftest.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/__init__.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_agents_and_settings.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_dynamic_control.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_hook_events.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_hooks.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_include_partial_messages.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_mcp_resources.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_mcp_tools.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_sdk_mcp_resources.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_sdk_mcp_tools.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_slash_commands.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_stderr_callback.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_storage_parsing.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_structured_output.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_subagent_invocation.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/e2e/test_tool_permissions.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/mcp_server.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/mock_claude_server.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_changelog.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_client.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_errors.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_image.png +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_integration.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_message_parser.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_sdk_mcp_integration.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_session.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_session_mutations.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_sessions.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_streaming_client.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_subprocess_buffering.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_tool_callbacks.py +0 -0
- {clawd_code_sdk-1.1.6 → clawd_code_sdk-1.1.7}/tests/test_transport.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
Metadata-Version: 2.
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
2
|
Name: clawd-code-sdk
|
|
3
|
-
Version: 1.1.
|
|
3
|
+
Version: 1.1.7
|
|
4
4
|
Summary: Python SDK for Claude Code
|
|
5
5
|
Project-URL: Documentation, https://github.com/phil65/claude-agent-sdk-python
|
|
6
6
|
Project-URL: Homepage, https://github.com/phil65/claude-agent-sdk-python
|
|
@@ -62,11 +62,18 @@ class MessageParseError(ClaudeSDKError):
|
|
|
62
62
|
# These correspond to the error types in types.AssistantMessageError
|
|
63
63
|
APIErrorType = Literal[
|
|
64
64
|
"authentication_failed",
|
|
65
|
+
"oauth_org_not_allowed",
|
|
66
|
+
"account_on_hold",
|
|
67
|
+
"verification_required",
|
|
65
68
|
"billing_error",
|
|
66
69
|
"rate_limit",
|
|
70
|
+
"overloaded",
|
|
67
71
|
"invalid_request",
|
|
72
|
+
"model_not_found",
|
|
68
73
|
"server_error",
|
|
69
74
|
"unknown",
|
|
75
|
+
"max_output_tokens",
|
|
76
|
+
"cloud_credential_error",
|
|
70
77
|
]
|
|
71
78
|
|
|
72
79
|
|
|
@@ -174,6 +174,8 @@ class Query:
|
|
|
174
174
|
matcher_cfg = {"matcher": matcher.get("matcher"), "hookCallbackIds": callback_ids}
|
|
175
175
|
if matcher.get("timeout") is not None:
|
|
176
176
|
matcher_cfg["timeout"] = matcher.get("timeout")
|
|
177
|
+
if matcher.get("on_failure") is not None:
|
|
178
|
+
matcher_cfg["onFailure"] = matcher.get("on_failure")
|
|
177
179
|
hooks_config[event].append(matcher_cfg)
|
|
178
180
|
return hooks_config or None
|
|
179
181
|
|
|
@@ -176,6 +176,12 @@ def to_cli_args(options: ClaudeAgentOptions) -> list[str]:
|
|
|
176
176
|
if options.permission_mode:
|
|
177
177
|
cmd.extend(["--permission-mode", options.permission_mode])
|
|
178
178
|
|
|
179
|
+
if options.permission_prompts:
|
|
180
|
+
cmd.extend(["--permission-prompts", options.permission_prompts])
|
|
181
|
+
|
|
182
|
+
if options.project_config_root is not None:
|
|
183
|
+
cmd.append(f"--project-config-root={options.project_config_root}")
|
|
184
|
+
|
|
179
185
|
session = options.get_session()
|
|
180
186
|
match session:
|
|
181
187
|
case NewSession(session_id=str() as sid):
|
|
@@ -187,7 +193,9 @@ def to_cli_args(options: ClaudeAgentOptions) -> list[str]:
|
|
|
187
193
|
if fork:
|
|
188
194
|
cmd.append("--fork-session")
|
|
189
195
|
if at_msg is not None:
|
|
190
|
-
cmd.
|
|
196
|
+
cmd.append(f"--resume-session-at={at_msg}")
|
|
197
|
+
if session.drops_turn is not None:
|
|
198
|
+
cmd.append(f"--resume-drops-turn={session.drops_turn}")
|
|
191
199
|
case ContinueLatest(fork=fork):
|
|
192
200
|
cmd.append("--continue")
|
|
193
201
|
if fork:
|
|
@@ -200,7 +208,7 @@ def to_cli_args(options: ClaudeAgentOptions) -> list[str]:
|
|
|
200
208
|
assert_never(unreachable)
|
|
201
209
|
|
|
202
210
|
if not session.persist:
|
|
203
|
-
cmd.append("--no-
|
|
211
|
+
cmd.append("--no-session-persistence")
|
|
204
212
|
|
|
205
213
|
# Handle settings and sandbox: merge sandbox into settings if both are provided
|
|
206
214
|
if settings_value := options.build_settings_value():
|
|
@@ -214,7 +222,11 @@ def to_cli_args(options: ClaudeAgentOptions) -> list[str]:
|
|
|
214
222
|
match options.mcp_servers:
|
|
215
223
|
case dict() as servers if servers:
|
|
216
224
|
servers_for_cli = {
|
|
217
|
-
name: {
|
|
225
|
+
name: {
|
|
226
|
+
k: v
|
|
227
|
+
for k, v in dataclasses.asdict(cfg).items()
|
|
228
|
+
if k != "instance" and v is not None
|
|
229
|
+
}
|
|
218
230
|
for name, cfg in servers.items()
|
|
219
231
|
}
|
|
220
232
|
dct = anyenv.dump_json({"mcpServers": servers_for_cli})
|
|
@@ -256,6 +268,8 @@ def to_cli_args(options: ClaudeAgentOptions) -> list[str]:
|
|
|
256
268
|
# Add plugin directories
|
|
257
269
|
for plugin in options.plugins:
|
|
258
270
|
match plugin:
|
|
271
|
+
case SdkPluginConfig(skip_mcp_discovery=True):
|
|
272
|
+
cmd.extend(["--plugin-dir-no-mcp", plugin.path])
|
|
259
273
|
case SdkPluginConfig():
|
|
260
274
|
cmd.extend(["--plugin-dir", plugin.path])
|
|
261
275
|
case _:
|
|
@@ -268,12 +282,16 @@ def to_cli_args(options: ClaudeAgentOptions) -> list[str]:
|
|
|
268
282
|
|
|
269
283
|
# Resolve thinking config → --max-thinking-tokens
|
|
270
284
|
match options.thinking:
|
|
271
|
-
case ThinkingConfigAdaptive():
|
|
272
|
-
cmd.
|
|
273
|
-
|
|
285
|
+
case ThinkingConfigAdaptive(display=display):
|
|
286
|
+
cmd.append("--thinking=adaptive")
|
|
287
|
+
if display:
|
|
288
|
+
cmd.extend(["--thinking-display", display])
|
|
289
|
+
case ThinkingConfigEnabled(budget_tokens=budget, display=display):
|
|
274
290
|
cmd.extend(["--max-thinking-tokens", str(budget)])
|
|
291
|
+
if display:
|
|
292
|
+
cmd.extend(["--thinking-display", display])
|
|
275
293
|
case ThinkingConfigDisabled():
|
|
276
|
-
cmd.
|
|
294
|
+
cmd.append("--thinking=disabled")
|
|
277
295
|
|
|
278
296
|
if options.effort is not None:
|
|
279
297
|
cmd.extend(["--effort", options.effort])
|
|
@@ -4,7 +4,7 @@ from __future__ import annotations
|
|
|
4
4
|
|
|
5
5
|
import os
|
|
6
6
|
from pathlib import Path
|
|
7
|
-
from typing import TYPE_CHECKING, Any, Self, cast
|
|
7
|
+
from typing import TYPE_CHECKING, Any, Literal, Self, cast
|
|
8
8
|
|
|
9
9
|
import anyenv
|
|
10
10
|
from pydantic import ValidationError
|
|
@@ -14,6 +14,7 @@ from clawd_code_sdk._internal.query import Query
|
|
|
14
14
|
from clawd_code_sdk.models import (
|
|
15
15
|
AssistantMessage,
|
|
16
16
|
ClaudeAgentOptions,
|
|
17
|
+
ClaudeCodeModelInfo,
|
|
17
18
|
ClaudeCodeServerInfo,
|
|
18
19
|
ClaudeOAuthWaitForCompletionResponse,
|
|
19
20
|
GetSettingsResponse,
|
|
@@ -25,25 +26,41 @@ from clawd_code_sdk.models import (
|
|
|
25
26
|
ResultErrorMessage,
|
|
26
27
|
ResultSuccessMessage,
|
|
27
28
|
SDKControlApplyFlagSettingsRequest,
|
|
29
|
+
SDKControlBackgroundTasksRequest,
|
|
28
30
|
SDKControlCancelAsyncMessageRequest,
|
|
29
31
|
SDKControlChannelEnableRequest,
|
|
30
32
|
SDKControlClaudeOAuthWaitForCompletionRequest,
|
|
31
33
|
SDKControlEndSessionRequest,
|
|
34
|
+
SDKControlGetBinaryVersionRequest,
|
|
32
35
|
SDKControlGetContextUsageRequest,
|
|
33
36
|
SDKControlGetContextUsageResponse,
|
|
37
|
+
SDKControlGetHooksListingRequest,
|
|
34
38
|
SDKControlGetSettingsRequest,
|
|
39
|
+
SDKControlGetTaskOutputRequest,
|
|
40
|
+
SDKControlGetTaskOutputResponse,
|
|
41
|
+
SDKControlGetUsageRequest,
|
|
35
42
|
SDKControlInitializeRequest,
|
|
36
43
|
SDKControlInterruptRequest,
|
|
44
|
+
SDKControlInterruptResponse,
|
|
45
|
+
SDKControlListModelsRequest,
|
|
46
|
+
SDKControlListPermissionRulesRequest,
|
|
37
47
|
SDKControlMcpAuthenticateRequest,
|
|
38
48
|
SDKControlMcpCallRequest,
|
|
39
49
|
SDKControlMcpClearAuthRequest,
|
|
40
50
|
SDKControlMcpOAuthCallbackUrlRequest,
|
|
51
|
+
SDKControlMcpReadResourceRequest,
|
|
52
|
+
SDKControlMcpReadResourceResponse,
|
|
41
53
|
SDKControlMcpReconnectRequest,
|
|
42
54
|
SDKControlMcpSetServersRequest,
|
|
43
55
|
SDKControlMcpStatusRequest,
|
|
44
56
|
SDKControlMcpToggleRequest,
|
|
45
57
|
SDKControlReadFileRequest,
|
|
46
58
|
SDKControlReadFileResponse,
|
|
59
|
+
SDKControlRegisterRepoRootRequest,
|
|
60
|
+
SDKControlReloadOutputStylesRequest,
|
|
61
|
+
SDKControlReloadOutputStylesResponse,
|
|
62
|
+
SDKControlReloadSkillsRequest,
|
|
63
|
+
SDKControlReloadSkillsResponse,
|
|
47
64
|
SDKControlRemoteControlRequest,
|
|
48
65
|
SDKControlRewindFilesRequest,
|
|
49
66
|
SDKControlSeedReadStateRequest,
|
|
@@ -52,6 +69,7 @@ from clawd_code_sdk.models import (
|
|
|
52
69
|
SDKControlSetPermissionModeRequest,
|
|
53
70
|
SDKControlSideQuestionRequest,
|
|
54
71
|
SDKControlStopTaskRequest,
|
|
72
|
+
SDKControlUpdateSettingsRequest,
|
|
55
73
|
SessionStateChangedMessage,
|
|
56
74
|
SideQuestionResponse,
|
|
57
75
|
StatusSystemMessage,
|
|
@@ -68,6 +86,7 @@ if TYPE_CHECKING:
|
|
|
68
86
|
from clawd_code_sdk import Transport
|
|
69
87
|
from clawd_code_sdk.models import (
|
|
70
88
|
ClaudeCodeAgentInfo,
|
|
89
|
+
ClaudeCodeCommandInfo,
|
|
71
90
|
ClaudeCodeSettings,
|
|
72
91
|
ExternalMcpServerConfig,
|
|
73
92
|
McpServerStatusEntry,
|
|
@@ -209,9 +228,30 @@ class ClaudeSDKClient:
|
|
|
209
228
|
title=title,
|
|
210
229
|
skills=options.skills,
|
|
211
230
|
plan_mode_instructions=options.plan_mode_instructions,
|
|
231
|
+
system_prompt_snapshot=options.system_prompt_snapshot,
|
|
232
|
+
forward_subagent_text=options.forward_subagent_text or None,
|
|
233
|
+
tool_aliases=options.tool_aliases,
|
|
234
|
+
per_task_stop_affordance=options.per_task_stop_affordance,
|
|
212
235
|
)
|
|
213
236
|
response = await query._send_control_request(request, timeout=initialize_timeout)
|
|
214
|
-
self._initialization_result = ClaudeCodeServerInfo.model_validate(response)
|
|
237
|
+
self._initialization_result = info = ClaudeCodeServerInfo.model_validate(response)
|
|
238
|
+
blocks_on_failure = any(
|
|
239
|
+
m.on_failure not in (None, "continue")
|
|
240
|
+
for matchers in (options.hooks or {}).values()
|
|
241
|
+
for m in matchers
|
|
242
|
+
)
|
|
243
|
+
if blocks_on_failure:
|
|
244
|
+
if not info.hook_on_failure_supported:
|
|
245
|
+
raise CLIConnectionError(
|
|
246
|
+
"The process answering initialize does not honor on_failure on hook "
|
|
247
|
+
"matchers, so a failing hook would not block. "
|
|
248
|
+
'Update Claude Code or remove on_failure="block".'
|
|
249
|
+
)
|
|
250
|
+
if info.hooks_applied is False:
|
|
251
|
+
raise CLIConnectionError(
|
|
252
|
+
"This session was already running and did not register your hooks, "
|
|
253
|
+
'so a hook set to on_failure="block" would never run.'
|
|
254
|
+
)
|
|
215
255
|
|
|
216
256
|
async def receive_messages(self) -> AsyncIterator[Message]:
|
|
217
257
|
"""Receive all messages from Claude."""
|
|
@@ -278,16 +318,27 @@ class ClaudeSDKClient:
|
|
|
278
318
|
"message": {"role": "user", "content": message_content},
|
|
279
319
|
"parent_tool_use_id": parent_tool_use_id,
|
|
280
320
|
"session_id": session_id,
|
|
281
|
-
"
|
|
321
|
+
"shouldQuery": should_query,
|
|
282
322
|
"priority": priority,
|
|
283
323
|
}
|
|
324
|
+
if self.options.verbatim_prompts:
|
|
325
|
+
wire_message["client_composed"] = True
|
|
284
326
|
await self._query.write_json(wire_message)
|
|
285
327
|
|
|
286
|
-
async def interrupt(self) -> None:
|
|
287
|
-
"""Send interrupt signal (only works with streaming mode).
|
|
328
|
+
async def interrupt(self, *, cancel_queued: bool = False) -> SDKControlInterruptResponse | None:
|
|
329
|
+
"""Send interrupt signal (only works with streaming mode).
|
|
330
|
+
|
|
331
|
+
Args:
|
|
332
|
+
cancel_queued: Also cancel queued (not yet started) user messages.
|
|
333
|
+
|
|
334
|
+
Returns:
|
|
335
|
+
Which queued messages are still queued / were cancelled
|
|
336
|
+
(None on CLIs that don't report it).
|
|
337
|
+
"""
|
|
288
338
|
query = self._ensure_connected()
|
|
289
|
-
request = SDKControlInterruptRequest()
|
|
290
|
-
await query._send_control_request(request)
|
|
339
|
+
request = SDKControlInterruptRequest(cancel_queued=cancel_queued or None)
|
|
340
|
+
result = await query._send_control_request(request)
|
|
341
|
+
return SDKControlInterruptResponse.model_validate(result) if result else None
|
|
291
342
|
|
|
292
343
|
async def set_permission_mode(self, mode: PermissionMode) -> None:
|
|
293
344
|
"""Change permission mode during conversation (only works with streaming mode).
|
|
@@ -469,10 +520,12 @@ class ClaudeSDKClient:
|
|
|
469
520
|
result = await query._send_control_request(request)
|
|
470
521
|
return GetSettingsResponse.model_validate(result)
|
|
471
522
|
|
|
472
|
-
async def get_context_usage(
|
|
523
|
+
async def get_context_usage(
|
|
524
|
+
self, detail: Literal["summary", "full"] | None = None
|
|
525
|
+
) -> SDKControlGetContextUsageResponse:
|
|
473
526
|
"""Get a breakdown of current context window usage by category."""
|
|
474
527
|
query = self._ensure_connected()
|
|
475
|
-
request = SDKControlGetContextUsageRequest()
|
|
528
|
+
request = SDKControlGetContextUsageRequest(detail=detail)
|
|
476
529
|
result = await query._send_control_request(request)
|
|
477
530
|
return SDKControlGetContextUsageResponse.model_validate(result)
|
|
478
531
|
|
|
@@ -546,12 +599,114 @@ class ClaudeSDKClient:
|
|
|
546
599
|
req = SDKControlChannelEnableRequest(server_name=server_name)
|
|
547
600
|
await query._send_control_request(req)
|
|
548
601
|
|
|
549
|
-
async def set_max_thinking_tokens(
|
|
550
|
-
|
|
602
|
+
async def set_max_thinking_tokens(
|
|
603
|
+
self,
|
|
604
|
+
max_thinking_tokens: int | None,
|
|
605
|
+
thinking_display: Literal["summarized", "omitted", "highlights"] | None = None,
|
|
606
|
+
) -> None:
|
|
607
|
+
"""Set the maximum number of thinking tokens (and optionally the display mode)."""
|
|
551
608
|
query = self._ensure_connected()
|
|
552
|
-
request = SDKControlSetMaxThinkingTokensRequest(
|
|
609
|
+
request = SDKControlSetMaxThinkingTokensRequest(
|
|
610
|
+
max_thinking_tokens=max_thinking_tokens, thinking_display=thinking_display
|
|
611
|
+
)
|
|
553
612
|
await query._send_control_request(request)
|
|
554
613
|
|
|
614
|
+
async def background_tasks(self, tool_use_id: str | None = None) -> bool:
|
|
615
|
+
"""Move running foreground tasks (or a single tool use) to the background.
|
|
616
|
+
|
|
617
|
+
Returns:
|
|
618
|
+
Whether anything was backgrounded.
|
|
619
|
+
"""
|
|
620
|
+
query = self._ensure_connected()
|
|
621
|
+
request = SDKControlBackgroundTasksRequest(tool_use_id=tool_use_id)
|
|
622
|
+
result = await query._send_control_request(request)
|
|
623
|
+
return bool((result or {}).get("backgrounded", True))
|
|
624
|
+
|
|
625
|
+
async def get_task_output(self, task_id: str) -> SDKControlGetTaskOutputResponse:
|
|
626
|
+
"""Read the output collected so far for a background task."""
|
|
627
|
+
query = self._ensure_connected()
|
|
628
|
+
request = SDKControlGetTaskOutputRequest(task_id=task_id)
|
|
629
|
+
result = await query._send_control_request(request)
|
|
630
|
+
return SDKControlGetTaskOutputResponse.model_validate(result)
|
|
631
|
+
|
|
632
|
+
async def get_usage(self, *, skip_behaviors: bool = False) -> dict[str, Any]:
|
|
633
|
+
"""Get the structured usage report (experimental, shape may change)."""
|
|
634
|
+
query = self._ensure_connected()
|
|
635
|
+
request = SDKControlGetUsageRequest(skip_behaviors=skip_behaviors or None)
|
|
636
|
+
return await query._send_control_request(request)
|
|
637
|
+
|
|
638
|
+
async def get_binary_version(self) -> dict[str, Any]:
|
|
639
|
+
"""Get version info of the running Claude Code binary."""
|
|
640
|
+
query = self._ensure_connected()
|
|
641
|
+
return await query._send_control_request(SDKControlGetBinaryVersionRequest())
|
|
642
|
+
|
|
643
|
+
async def list_models(self) -> list[ClaudeCodeModelInfo]:
|
|
644
|
+
"""Fetch the list of available models from the CLI."""
|
|
645
|
+
query = self._ensure_connected()
|
|
646
|
+
result = await query._send_control_request(SDKControlListModelsRequest())
|
|
647
|
+
return [ClaudeCodeModelInfo.model_validate(m) for m in (result or {}).get("models", [])]
|
|
648
|
+
|
|
649
|
+
async def reload_skills(self) -> list[ClaudeCodeCommandInfo]:
|
|
650
|
+
"""Re-scan skills from disk and return the refreshed skill list."""
|
|
651
|
+
query = self._ensure_connected()
|
|
652
|
+
result = await query._send_control_request(SDKControlReloadSkillsRequest())
|
|
653
|
+
return SDKControlReloadSkillsResponse.model_validate(result).skills
|
|
654
|
+
|
|
655
|
+
async def reload_output_styles(self) -> list[str]:
|
|
656
|
+
"""Re-scan output styles from disk and return the available style names."""
|
|
657
|
+
query = self._ensure_connected()
|
|
658
|
+
result = await query._send_control_request(SDKControlReloadOutputStylesRequest())
|
|
659
|
+
return SDKControlReloadOutputStylesResponse.model_validate(result).available_output_styles
|
|
660
|
+
|
|
661
|
+
async def read_mcp_resource(
|
|
662
|
+
self, server_name: str, uri: str
|
|
663
|
+
) -> SDKControlMcpReadResourceResponse:
|
|
664
|
+
"""Read a resource from a connected MCP server."""
|
|
665
|
+
query = self._ensure_connected()
|
|
666
|
+
request = SDKControlMcpReadResourceRequest(server_name=server_name, uri=uri)
|
|
667
|
+
result = await query._send_control_request(request)
|
|
668
|
+
return SDKControlMcpReadResourceResponse.model_validate(result)
|
|
669
|
+
|
|
670
|
+
async def update_settings(
|
|
671
|
+
self,
|
|
672
|
+
source: Literal["localSettings", "userSettings"],
|
|
673
|
+
settings: dict[str, Any],
|
|
674
|
+
) -> None:
|
|
675
|
+
"""Persist settings to the local or user settings file."""
|
|
676
|
+
query = self._ensure_connected()
|
|
677
|
+
request = SDKControlUpdateSettingsRequest(source=source, settings=settings)
|
|
678
|
+
await query._send_control_request(request)
|
|
679
|
+
|
|
680
|
+
async def list_permission_rules(self) -> dict[str, Any]:
|
|
681
|
+
"""List the effective permission rules (raw ``state`` payload)."""
|
|
682
|
+
query = self._ensure_connected()
|
|
683
|
+
result = await query._send_control_request(SDKControlListPermissionRulesRequest())
|
|
684
|
+
state: dict[str, Any] = (result or {}).get("state", {})
|
|
685
|
+
return state
|
|
686
|
+
|
|
687
|
+
async def register_repo_root(
|
|
688
|
+
self,
|
|
689
|
+
directory: str | Path,
|
|
690
|
+
*,
|
|
691
|
+
reload_claude_md: bool | None = None,
|
|
692
|
+
reload_plugins: bool | None = None,
|
|
693
|
+
reload_skills: bool | None = None,
|
|
694
|
+
) -> None:
|
|
695
|
+
"""Register an additional repository root for the session (like /add-dir)."""
|
|
696
|
+
query = self._ensure_connected()
|
|
697
|
+
request = SDKControlRegisterRepoRootRequest(
|
|
698
|
+
directory=str(directory),
|
|
699
|
+
reload_claude_md=reload_claude_md,
|
|
700
|
+
reload_plugins=reload_plugins,
|
|
701
|
+
reload_skills=reload_skills,
|
|
702
|
+
)
|
|
703
|
+
await query._send_control_request(request)
|
|
704
|
+
|
|
705
|
+
async def get_hooks_listing(self) -> dict[str, Any]:
|
|
706
|
+
"""Get the listing of configured hooks (same data as /hooks)."""
|
|
707
|
+
query = self._ensure_connected()
|
|
708
|
+
return await query._send_control_request(SDKControlGetHooksListingRequest())
|
|
709
|
+
|
|
555
710
|
async def supported_agents(self) -> list[ClaudeCodeAgentInfo]:
|
|
556
711
|
"""Get the list of available subagents for the current session.
|
|
557
712
|
|