@anthropic-ai/claude-agent-sdk 0.2.76 → 0.2.78

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.
package/manifest.json CHANGED
@@ -1,46 +1,46 @@
1
1
  {
2
- "version": "2.1.76",
3
- "buildDate": "2026-03-14T00:18:17Z",
2
+ "version": "2.1.78",
3
+ "buildDate": "2026-03-17T21:07:53Z",
4
4
  "platforms": {
5
5
  "darwin-arm64": {
6
6
  "binary": "claude",
7
- "checksum": "ffe922f4f4ac542f4edbeeabbce2a7492308d034c66a2427caec5c31c39b71c8",
8
- "size": 190891760
7
+ "checksum": "0a4939f36bc0194021c56fa5c8470ad84e2282f2f404f1598a940c2044117168",
8
+ "size": 191585264
9
9
  },
10
10
  "darwin-x64": {
11
11
  "binary": "claude",
12
- "checksum": "2a13d9a3ca0fe330fd786341897af2e5250066bbbb1fdcb6cfdffa50cf0f90fe",
13
- "size": 196972016
12
+ "checksum": "14d9193a85a6b191b090fd2a1ce261905cccf0bf6728239d7c2147719641963c",
13
+ "size": 197665520
14
14
  },
15
15
  "linux-arm64": {
16
16
  "binary": "claude",
17
- "checksum": "40f753c07f070df34ca83e400f746a8279a3fd343967a453d9fbfab2f3ca7acd",
18
- "size": 232783142
17
+ "checksum": "75cf87465197883df61dcbb187d4ad3fc031bf91927658159929dcd2959542dc",
18
+ "size": 233493894
19
19
  },
20
20
  "linux-x64": {
21
21
  "binary": "claude",
22
- "checksum": "801a085676c3d54392c42e8e43c44947df7c52132356575f7d9267c4f22d6992",
23
- "size": 235555347
22
+ "checksum": "b120a4139a4477a2719aeb0b2c790a5c2fe2d904e47f4e2adf3cab33b342d03a",
23
+ "size": 236265617
24
24
  },
25
25
  "linux-arm64-musl": {
26
26
  "binary": "claude",
27
- "checksum": "18fb9e236149bd475d9c5b9ec033f5c93d2dec0dca1f7b34cec96fd42379497c",
28
- "size": 223318614
27
+ "checksum": "2882a6412fd1109aedc9be76e798888cefbaecc1d7d20f0024932a80bbf051f7",
28
+ "size": 224029366
29
29
  },
30
30
  "linux-x64-musl": {
31
31
  "binary": "claude",
32
- "checksum": "f17ad0fe5448799cdaa7ae5fd77132e0003942195da91546a4f5e7b2f7bf2f05",
33
- "size": 226152835
32
+ "checksum": "7786b1b3aa8a4293800b6b34c93fd973d09865da1de2b970ba976c39f1bb50ac",
33
+ "size": 226863105
34
34
  },
35
35
  "win32-x64": {
36
36
  "binary": "claude.exe",
37
- "checksum": "bb40de8e810d985698e14eec9935036621bf37c495a609f5b70db7aa9f927b83",
38
- "size": 240100000
37
+ "checksum": "c979e148d5431d3eaf00383d0a65a1793e7a9f160f0dc06561a85b17c7a8bd78",
38
+ "size": 240781984
39
39
  },
40
40
  "win32-arm64": {
41
41
  "binary": "claude.exe",
42
- "checksum": "1dac83677e68a48368f945e693a5dd039baff21115871223c622df362c0cd61b",
43
- "size": 236293792
42
+ "checksum": "eea099a2565559e44b6d884e74c827456d10bd4353b27004fc47a99142535265",
43
+ "size": 236975776
44
44
  }
45
45
  }
46
46
  }
package/manifest.zst.json CHANGED
@@ -1,46 +1,54 @@
1
1
  {
2
- "version": "2.1.76",
3
- "buildDate": "2026-03-14T00:18:18Z",
2
+ "version": "2.1.78",
3
+ "buildDate": "2026-03-17T21:07:54Z",
4
4
  "platforms": {
5
5
  "darwin-arm64": {
6
6
  "binary": "claude.zst",
7
- "checksum": "a647ff5ef493f83ef3d6a052809275ac3d8a3ea6696c9ae2a67a6f83709d2f29",
8
- "size": 40603063
7
+ "checksum": "148a4b2de4eddaa55074c834ac43a286fa25a46d3a8de245c80b34a30a95be7c",
8
+ "size": 40774423,
9
+ "bundle": {
10
+ "checksum": "090086a7ec4eafce647fd8fa927a0ae2c0b7ece08117a84e2acac7ec4f9d7c8c",
11
+ "size": 40776882
12
+ }
9
13
  },
10
14
  "darwin-x64": {
11
15
  "binary": "claude.zst",
12
- "checksum": "0fba387dca32189351516afefb9e1b5dccc9479a6dfde536e7a7d8978cfc7a69",
13
- "size": 43058333
16
+ "checksum": "bad1120714973e14e436cbdab3700882c78a854b9bd95548e51c22e3e4d3f681",
17
+ "size": 43230583,
18
+ "bundle": {
19
+ "checksum": "35ce66c31da98f1f87fea6faf9093452c44792174bf5742a534e764fcad8275b",
20
+ "size": 43237721
21
+ }
14
22
  },
15
23
  "linux-arm64": {
16
24
  "binary": "claude.zst",
17
- "checksum": "9be2a45dce712889a7b0b97f886bbd91a20a7b9b371111dcffbe148b79136708",
18
- "size": 52519446
25
+ "checksum": "af5a53693774b8b56d7c90f92a052c9f5fc73865159e205039f4389a9ea9cb42",
26
+ "size": 52691628
19
27
  },
20
28
  "linux-x64": {
21
29
  "binary": "claude.zst",
22
- "checksum": "0a1633e17dad0a24a376f176c1047fc9992a92a24032dc5153ebc7cf808727c3",
23
- "size": 53293198
30
+ "checksum": "f5e64fab3573b31e7226b6fec2200c83945268d5357faf4a785db3f0d84e8511",
31
+ "size": 53444096
24
32
  },
25
33
  "linux-arm64-musl": {
26
34
  "binary": "claude.zst",
27
- "checksum": "947ac7d6458eca6a4a78d44947dd1d1b0b597102b26ab8252d08c3e386d83f1e",
28
- "size": 50466672
35
+ "checksum": "8d6ba73814e6566f5b18faa6c36945cd1d43a20d238c4a7cdee857de0fc09f55",
36
+ "size": 50651246
29
37
  },
30
38
  "linux-x64-musl": {
31
39
  "binary": "claude.zst",
32
- "checksum": "107d51ed764b3eb117ae0c00cf5612ea43873267e515e91d0ac3b21ba7b919d7",
33
- "size": 51244232
40
+ "checksum": "5cebee26f5b1a0901bfbdbe9c1c69a1c4d52a78343b84d1c9eeca1910e373dfe",
41
+ "size": 51411117
34
42
  },
35
43
  "win32-x64": {
36
44
  "binary": "claude.exe.zst",
37
- "checksum": "aa61d7decd8aa6a463b608a1b80fd7ee057c76698906e0f09a3d0b61ae5ef2d0",
38
- "size": 54021140
45
+ "checksum": "cb677c7815e9fa7a003e8e59ef36dc8be52a82c543715706e15fbcb8cfaac8fd",
46
+ "size": 54198863
39
47
  },
40
48
  "win32-arm64": {
41
49
  "binary": "claude.exe.zst",
42
- "checksum": "13e413df534e53304c5e76a4b899699d52f0d9844f0195248fb1107971779fa8",
43
- "size": 52073953
50
+ "checksum": "f7adab559053932cc7392de310472a942abb534eb85fa94fef73cc8de7070a86",
51
+ "size": 52257502
44
52
  }
45
53
  }
46
54
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anthropic-ai/claude-agent-sdk",
3
- "version": "0.2.76",
3
+ "version": "0.2.78",
4
4
  "main": "sdk.mjs",
5
5
  "types": "sdk.d.ts",
6
6
  "exports": {
@@ -58,5 +58,5 @@
58
58
  "@img/sharp-win32-arm64": "^0.34.2",
59
59
  "@img/sharp-win32-x64": "^0.34.2"
60
60
  },
61
- "claudeCodeVersion": "2.1.76"
61
+ "claudeCodeVersion": "2.1.78"
62
62
  }
package/sdk-tools.d.ts CHANGED
@@ -110,17 +110,6 @@ export type AgentOutput =
110
110
  * Whether the calling agent has Read/Bash tools to check progress
111
111
  */
112
112
  canReadOutputFile?: boolean;
113
- }
114
- | {
115
- status: "queued_to_running";
116
- /**
117
- * The ID of the running agent
118
- */
119
- agentId: string;
120
- /**
121
- * The prompt that was queued
122
- */
123
- prompt: string;
124
113
  };
125
114
  export type FileReadOutput =
126
115
  | {
@@ -285,10 +274,6 @@ export interface AgentInput {
285
274
  * Optional model override for this agent. Takes precedence over the agent definition's model frontmatter. If omitted, uses the agent definition's model, or inherits from the parent.
286
275
  */
287
276
  model?: "sonnet" | "opus" | "haiku";
288
- /**
289
- * Optional agent ID to resume from. If provided, the agent will continue from the previous execution transcript.
290
- */
291
- resume?: string;
292
277
  /**
293
278
  * Set to true to run this agent in the background. You will be notified when it completes.
294
279
  */
package/sdk.d.ts CHANGED
@@ -26,6 +26,10 @@ export declare type AccountInfo = {
26
26
  subscriptionType?: string;
27
27
  tokenSource?: string;
28
28
  apiKeySource?: string;
29
+ /**
30
+ * Active API backend. Anthropic OAuth login only applies when "firstParty"; for 3P providers the other fields are absent and auth is external (AWS creds, gcloud ADC, etc.).
31
+ */
32
+ apiProvider?: 'firstParty' | 'bedrock' | 'vertex' | 'foundry';
29
33
  };
30
34
 
31
35
  /**
@@ -138,6 +142,22 @@ export declare type CanUseTool = (toolName: string, input: Record<string, unknow
138
142
  blockedPath?: string;
139
143
  /** Explains why this permission request was triggered. */
140
144
  decisionReason?: string;
145
+ /**
146
+ * Full permission prompt sentence rendered by the bridge (e.g.
147
+ * "Claude wants to read foo.txt"). Use this as the primary prompt
148
+ * text when present instead of reconstructing from toolName+input.
149
+ */
150
+ title?: string;
151
+ /**
152
+ * Short noun phrase for the tool action (e.g. "Read file"), suitable
153
+ * for button labels or compact UI.
154
+ */
155
+ displayName?: string;
156
+ /**
157
+ * Human-readable subtitle from the bridge (e.g. "Claude will have
158
+ * read and write access to files in ~/Downloads").
159
+ */
160
+ description?: string;
141
161
  /**
142
162
  * Unique identifier for this specific tool call within the assistant message.
143
163
  * Multiple tool calls in the same assistant message will have different toolUseIDs.
@@ -236,9 +256,11 @@ declare namespace coreTypes {
236
256
  PromptRequest,
237
257
  PromptResponse,
238
258
  RewindFilesResult,
259
+ SDKAPIRetryMessage,
239
260
  SDKAssistantMessageError,
240
261
  SDKAssistantMessage,
241
262
  SDKAuthStatusMessage,
263
+ SDKBridgeMetadataMessage,
242
264
  SDKCompactBoundaryMessage,
243
265
  SDKElicitationCompleteMessage,
244
266
  SDKFilesPersistedEvent,
@@ -275,6 +297,7 @@ declare namespace coreTypes {
275
297
  SetupHookInput,
276
298
  SetupHookSpecificOutput,
277
299
  SlashCommand,
300
+ StopFailureHookInput,
278
301
  StopHookInput,
279
302
  SubagentStartHookInput,
280
303
  SubagentStartHookSpecificOutput,
@@ -463,7 +486,7 @@ export declare type GetSessionMessagesOptions = {
463
486
  offset?: number;
464
487
  };
465
488
 
466
- export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "Setup", "TeammateIdle", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded"];
489
+ export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "Setup", "TeammateIdle", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded"];
467
490
 
468
491
  /**
469
492
  * Hook callback function for responding to events during execution.
@@ -482,9 +505,9 @@ export declare interface HookCallbackMatcher {
482
505
  timeout?: number;
483
506
  }
484
507
 
485
- export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PostCompact' | 'PermissionRequest' | 'Setup' | 'TeammateIdle' | 'TaskCompleted' | 'Elicitation' | 'ElicitationResult' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'InstructionsLoaded';
508
+ export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'StopFailure' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PostCompact' | 'PermissionRequest' | 'Setup' | 'TeammateIdle' | 'TaskCompleted' | 'Elicitation' | 'ElicitationResult' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'InstructionsLoaded';
486
509
 
487
- export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PostCompactHookInput | PermissionRequestHookInput | SetupHookInput | TeammateIdleHookInput | TaskCompletedHookInput | ElicitationHookInput | ElicitationResultHookInput | ConfigChangeHookInput | InstructionsLoadedHookInput | WorktreeCreateHookInput | WorktreeRemoveHookInput;
510
+ export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | StopFailureHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PostCompactHookInput | PermissionRequestHookInput | SetupHookInput | TeammateIdleHookInput | TaskCompletedHookInput | ElicitationHookInput | ElicitationResultHookInput | ConfigChangeHookInput | InstructionsLoadedHookInput | WorktreeCreateHookInput | WorktreeRemoveHookInput;
488
511
 
489
512
  export declare type HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput;
490
513
 
@@ -498,7 +521,7 @@ export declare type InstructionsLoadedHookInput = BaseHookInput & {
498
521
  hook_event_name: 'InstructionsLoaded';
499
522
  file_path: string;
500
523
  memory_type: 'User' | 'Project' | 'Local' | 'Managed';
501
- load_reason: 'session_start' | 'nested_traversal' | 'path_glob_match' | 'include';
524
+ load_reason: 'session_start' | 'nested_traversal' | 'path_glob_match' | 'include' | 'compact';
502
525
  globs?: string[];
503
526
  trigger_file_path?: string;
504
527
  parent_file_path?: string;
@@ -1448,6 +1471,19 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
1448
1471
  * @param maxThinkingTokens - Maximum tokens for thinking, or null to clear the limit
1449
1472
  */
1450
1473
  setMaxThinkingTokens(maxThinkingTokens: number | null): Promise<void>;
1474
+ /**
1475
+ * Merge the provided settings into the flag settings layer, dynamically
1476
+ * updating the active configuration. Top-level keys are shallow-merged
1477
+ * across successive calls — a second call with `{permissions: {...}}`
1478
+ * replaces the entire `permissions` object from a prior call. The resulting
1479
+ * flag settings are then deep-merged with file-based settings at read time.
1480
+ *
1481
+ * Equivalent to passing an object to the `settings` option of `query()`,
1482
+ * but applies mid-session. Only available in streaming input mode.
1483
+ *
1484
+ * @param settings - A partial settings object to merge into the flag settings
1485
+ */
1486
+ applyFlagSettings(settings: Settings): Promise<void>;
1451
1487
  /**
1452
1488
  * Get the full initialization result, including supported commands, models,
1453
1489
  * account info, and output style configuration.
@@ -1517,6 +1553,9 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
1517
1553
 
1518
1554
 
1519
1555
 
1556
+
1557
+
1558
+
1520
1559
  /**
1521
1560
  * Dynamically set the MCP servers for this session.
1522
1561
  * This replaces the current set of dynamically-added MCP servers with the provided set.
@@ -1589,6 +1628,8 @@ declare const SandboxFilesystemConfigSchema: () => z.ZodOptional<z.ZodObject<{
1589
1628
  allowWrite: z.ZodOptional<z.ZodArray<z.ZodString>>;
1590
1629
  denyWrite: z.ZodOptional<z.ZodArray<z.ZodString>>;
1591
1630
  denyRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
1631
+ allowRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
1632
+ allowManagedReadPathsOnly: z.ZodOptional<z.ZodBoolean>;
1592
1633
  }, z.core.$strip>>;
1593
1634
 
1594
1635
  export declare type SandboxIgnoreViolations = NonNullable<SandboxSettings['ignoreViolations']>;
@@ -1630,6 +1671,8 @@ declare const SandboxSettingsSchema: () => z.ZodObject<{
1630
1671
  allowWrite: z.ZodOptional<z.ZodArray<z.ZodString>>;
1631
1672
  denyWrite: z.ZodOptional<z.ZodArray<z.ZodString>>;
1632
1673
  denyRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
1674
+ allowRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
1675
+ allowManagedReadPathsOnly: z.ZodOptional<z.ZodBoolean>;
1633
1676
  }, z.core.$strip>>;
1634
1677
  ignoreViolations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
1635
1678
  enableWeakerNestedSandbox: z.ZodOptional<z.ZodBoolean>;
@@ -1641,6 +1684,21 @@ declare const SandboxSettingsSchema: () => z.ZodObject<{
1641
1684
  }, z.core.$strip>>;
1642
1685
  }, z.core.$loose>;
1643
1686
 
1687
+ /**
1688
+ * Emitted when an API request fails with a retryable error and will be retried after a delay. error_status is null for connection errors (e.g. timeouts) that had no HTTP response.
1689
+ */
1690
+ export declare type SDKAPIRetryMessage = {
1691
+ type: 'system';
1692
+ subtype: 'api_retry';
1693
+ attempt: number;
1694
+ max_retries: number;
1695
+ retry_delay_ms: number;
1696
+ error_status: number | null;
1697
+ error: SDKAssistantMessageError;
1698
+ uuid: UUID;
1699
+ session_id: string;
1700
+ };
1701
+
1644
1702
  export declare type SDKAssistantMessage = {
1645
1703
  type: 'assistant';
1646
1704
  message: BetaMessage;
@@ -1663,6 +1721,14 @@ export declare type SDKAuthStatusMessage = {
1663
1721
 
1664
1722
  export declare type SdkBeta = 'context-1m-2025-08-07';
1665
1723
 
1724
+ export declare type SDKBridgeMetadataMessage = {
1725
+ type: 'system';
1726
+ subtype: 'bridge_metadata';
1727
+ slash_commands: string[];
1728
+ uuid: UUID;
1729
+ session_id: string;
1730
+ };
1731
+
1666
1732
  export declare type SDKCompactBoundaryMessage = {
1667
1733
  type: 'system';
1668
1734
  subtype: 'compact_boundary';
@@ -1816,6 +1882,8 @@ declare type SDKControlPermissionRequest = {
1816
1882
  permission_suggestions?: coreTypes.PermissionUpdate[];
1817
1883
  blocked_path?: string;
1818
1884
  decision_reason?: string;
1885
+ title?: string;
1886
+ display_name?: string;
1819
1887
  tool_use_id: string;
1820
1888
  agent_id?: string;
1821
1889
  description?: string;
@@ -1827,7 +1895,7 @@ declare type SDKControlRequest = {
1827
1895
  request: SDKControlRequestInner;
1828
1896
  };
1829
1897
 
1830
- declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlMcpSetServersRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlRemoteControlRequest | SDKControlSetProactiveRequest | SDKControlGenerateSessionTitleRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest;
1898
+ declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlMcpSetServersRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlSetProactiveRequest | SDKControlGenerateSessionTitleRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest;
1831
1899
 
1832
1900
  declare type SDKControlResponse = {
1833
1901
  type: 'control_response';
@@ -1994,7 +2062,7 @@ export declare type SdkMcpToolDefinition<Schema extends AnyZodRawShape = AnyZodR
1994
2062
  handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>;
1995
2063
  };
1996
2064
 
1997
- export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage;
2065
+ export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKBridgeMetadataMessage;
1998
2066
 
1999
2067
  export declare type SDKPartialAssistantMessage = {
2000
2068
  type: 'stream_event';
@@ -2336,6 +2404,10 @@ export declare type SDKUserMessage = {
2336
2404
  isSynthetic?: boolean;
2337
2405
  tool_use_result?: unknown;
2338
2406
  priority?: 'now' | 'next' | 'later';
2407
+ /**
2408
+ * ISO timestamp when the message was created on the originating process. Older emitters omit it; consumers should fall back to receive time.
2409
+ */
2410
+ timestamp?: string;
2339
2411
  uuid?: UUID;
2340
2412
  session_id: string;
2341
2413
  };
@@ -2347,6 +2419,10 @@ export declare type SDKUserMessageReplay = {
2347
2419
  isSynthetic?: boolean;
2348
2420
  tool_use_result?: unknown;
2349
2421
  priority?: 'now' | 'next' | 'later';
2422
+ /**
2423
+ * ISO timestamp when the message was created on the originating process. Older emitters omit it; consumers should fall back to receive time.
2424
+ */
2425
+ timestamp?: string;
2350
2426
  uuid: UUID;
2351
2427
  session_id: string;
2352
2428
  isReplay: true;
@@ -3059,6 +3135,14 @@ export declare interface Settings {
3059
3135
  * Additional paths to deny reading within the sandbox. Merged with paths from Read(...) deny permission rules.
3060
3136
  */
3061
3137
  denyRead?: string[];
3138
+ /**
3139
+ * Paths to re-allow reading within denyRead regions. Takes precedence over denyRead for matching paths.
3140
+ */
3141
+ allowRead?: string[];
3142
+ /**
3143
+ * When true (set in managed settings), only allowRead paths from policySettings are used.
3144
+ */
3145
+ allowManagedReadPathsOnly?: boolean;
3062
3146
  };
3063
3147
  ignoreViolations?: {
3064
3148
  [k: string]: string[];
@@ -3338,6 +3422,13 @@ export declare interface SpawnOptions {
3338
3422
 
3339
3423
  declare type StdoutMessage = coreTypes.SDKMessage | coreTypes.SDKStreamlinedTextMessage | coreTypes.SDKStreamlinedToolUseSummaryMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
3340
3424
 
3425
+ export declare type StopFailureHookInput = BaseHookInput & {
3426
+ hook_event_name: 'StopFailure';
3427
+ error: SDKAssistantMessageError;
3428
+ error_details?: string;
3429
+ last_assistant_message?: string;
3430
+ };
3431
+
3341
3432
  export declare type StopHookInput = BaseHookInput & {
3342
3433
  hook_event_name: 'Stop';
3343
3434
  stop_hook_active: boolean;