@downcity/agent 1.1.217 → 1.1.224

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 (184) hide show
  1. package/bin/agent/local/Agent.d.ts +1 -34
  2. package/bin/agent/local/Agent.d.ts.map +1 -1
  3. package/bin/agent/local/Agent.js +1 -44
  4. package/bin/agent/local/Agent.js.map +1 -1
  5. package/bin/agent/local/services/AgentAssemblyService.d.ts.map +1 -1
  6. package/bin/agent/local/services/AgentAssemblyService.js +35 -2
  7. package/bin/agent/local/services/AgentAssemblyService.js.map +1 -1
  8. package/bin/agent/local/services/AgentSessions.d.ts +6 -0
  9. package/bin/agent/local/services/AgentSessions.d.ts.map +1 -1
  10. package/bin/agent/local/services/AgentSessions.js +43 -4
  11. package/bin/agent/local/services/AgentSessions.js.map +1 -1
  12. package/bin/agent/remote/RemoteAgent.d.ts +1 -35
  13. package/bin/agent/remote/RemoteAgent.d.ts.map +1 -1
  14. package/bin/agent/remote/RemoteAgent.js +1 -37
  15. package/bin/agent/remote/RemoteAgent.js.map +1 -1
  16. package/bin/agent/remote/RemoteSession.d.ts +26 -41
  17. package/bin/agent/remote/RemoteSession.d.ts.map +1 -1
  18. package/bin/agent/remote/RemoteSession.js +75 -107
  19. package/bin/agent/remote/RemoteSession.js.map +1 -1
  20. package/bin/agent/remote/RemoteTransport.d.ts +15 -27
  21. package/bin/agent/remote/RemoteTransport.d.ts.map +1 -1
  22. package/bin/agent/remote/transports/HttpRemoteAgentTransport.d.ts +10 -21
  23. package/bin/agent/remote/transports/HttpRemoteAgentTransport.d.ts.map +1 -1
  24. package/bin/agent/remote/transports/HttpRemoteAgentTransport.js +24 -46
  25. package/bin/agent/remote/transports/HttpRemoteAgentTransport.js.map +1 -1
  26. package/bin/agent/remote/transports/RpcRemoteAgentTransport.d.ts +10 -20
  27. package/bin/agent/remote/transports/RpcRemoteAgentTransport.d.ts.map +1 -1
  28. package/bin/agent/remote/transports/RpcRemoteAgentTransport.js +10 -16
  29. package/bin/agent/remote/transports/RpcRemoteAgentTransport.js.map +1 -1
  30. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.js +2 -2
  31. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.js.map +1 -1
  32. package/bin/executor/types/SessionHistoryPaths.d.ts +1 -1
  33. package/bin/executor/types/SessionRecords.d.ts +2 -0
  34. package/bin/executor/types/SessionRecords.d.ts.map +1 -1
  35. package/bin/executor/types/SessionRecords.js.map +1 -1
  36. package/bin/index.d.ts +6 -3
  37. package/bin/index.d.ts.map +1 -1
  38. package/bin/index.js +1 -0
  39. package/bin/index.js.map +1 -1
  40. package/bin/rpc/Client.d.ts +12 -34
  41. package/bin/rpc/Client.d.ts.map +1 -1
  42. package/bin/rpc/Client.js +31 -70
  43. package/bin/rpc/Client.js.map +1 -1
  44. package/bin/session/Session.d.ts +22 -4
  45. package/bin/session/Session.d.ts.map +1 -1
  46. package/bin/session/Session.js +95 -21
  47. package/bin/session/Session.js.map +1 -1
  48. package/bin/session/browse/Browse.d.ts.map +1 -1
  49. package/bin/session/browse/Browse.js +49 -18
  50. package/bin/session/browse/Browse.js.map +1 -1
  51. package/bin/session/recorder/JsonlSessionMessageStore.d.ts +51 -0
  52. package/bin/session/recorder/JsonlSessionMessageStore.d.ts.map +1 -0
  53. package/bin/session/recorder/JsonlSessionMessageStore.js +231 -0
  54. package/bin/session/recorder/JsonlSessionMessageStore.js.map +1 -0
  55. package/bin/session/recorder/SessionMessageCodec.d.ts +20 -0
  56. package/bin/session/recorder/SessionMessageCodec.d.ts.map +1 -0
  57. package/bin/session/recorder/SessionMessageCodec.js +257 -0
  58. package/bin/session/recorder/SessionMessageCodec.js.map +1 -0
  59. package/bin/session/recorder/SessionRecorder.d.ts +186 -0
  60. package/bin/session/recorder/SessionRecorder.d.ts.map +1 -0
  61. package/bin/session/recorder/SessionRecorder.js +655 -0
  62. package/bin/session/recorder/SessionRecorder.js.map +1 -0
  63. package/bin/session/recorder/SessionRecorderCompaction.d.ts +18 -0
  64. package/bin/session/recorder/SessionRecorderCompaction.d.ts.map +1 -0
  65. package/bin/session/recorder/SessionRecorderCompaction.js +142 -0
  66. package/bin/session/recorder/SessionRecorderCompaction.js.map +1 -0
  67. package/bin/session/recorder/SessionRecorderHistoryStore.d.ts +66 -0
  68. package/bin/session/recorder/SessionRecorderHistoryStore.d.ts.map +1 -0
  69. package/bin/session/recorder/SessionRecorderHistoryStore.js +195 -0
  70. package/bin/session/recorder/SessionRecorderHistoryStore.js.map +1 -0
  71. package/bin/session/runtime/SessionEventHub.d.ts +12 -5
  72. package/bin/session/runtime/SessionEventHub.d.ts.map +1 -1
  73. package/bin/session/runtime/SessionEventHub.js +11 -6
  74. package/bin/session/runtime/SessionEventHub.js.map +1 -1
  75. package/bin/session/runtime/SessionPromptRuntime.d.ts +9 -15
  76. package/bin/session/runtime/SessionPromptRuntime.d.ts.map +1 -1
  77. package/bin/session/runtime/SessionPromptRuntime.js +48 -30
  78. package/bin/session/runtime/SessionPromptRuntime.js.map +1 -1
  79. package/bin/session/services/SessionStateService.d.ts +9 -5
  80. package/bin/session/services/SessionStateService.d.ts.map +1 -1
  81. package/bin/session/services/SessionStateService.js +138 -74
  82. package/bin/session/services/SessionStateService.js.map +1 -1
  83. package/bin/session/services/SessionTurnService.d.ts +6 -7
  84. package/bin/session/services/SessionTurnService.d.ts.map +1 -1
  85. package/bin/session/services/SessionTurnService.js +84 -60
  86. package/bin/session/services/SessionTurnService.js.map +1 -1
  87. package/bin/session/services/SessionViewService.d.ts +8 -3
  88. package/bin/session/services/SessionViewService.d.ts.map +1 -1
  89. package/bin/session/services/SessionViewService.js +10 -5
  90. package/bin/session/services/SessionViewService.js.map +1 -1
  91. package/bin/session/storage/Paths.d.ts +1 -1
  92. package/bin/session/storage/Paths.d.ts.map +1 -1
  93. package/bin/session/storage/Paths.js +2 -2
  94. package/bin/session/storage/Paths.js.map +1 -1
  95. package/bin/session/storage/Persistence.d.ts +6 -0
  96. package/bin/session/storage/Persistence.d.ts.map +1 -1
  97. package/bin/session/storage/Persistence.js +7 -0
  98. package/bin/session/storage/Persistence.js.map +1 -1
  99. package/bin/session/storage/RuntimeSessionPort.d.ts +3 -3
  100. package/bin/session/storage/RuntimeSessionPort.d.ts.map +1 -1
  101. package/bin/session/storage/RuntimeSessionPort.js +2 -2
  102. package/bin/session/storage/RuntimeSessionPort.js.map +1 -1
  103. package/bin/types/agent/SessionActor.d.ts +15 -5
  104. package/bin/types/agent/SessionActor.d.ts.map +1 -1
  105. package/bin/types/rpc/RpcProtocol.d.ts +48 -61
  106. package/bin/types/rpc/RpcProtocol.d.ts.map +1 -1
  107. package/bin/types/runtime/agent/AgentContext.d.ts +5 -4
  108. package/bin/types/runtime/agent/AgentContext.d.ts.map +1 -1
  109. package/bin/types/runtime/agent/AgentContext.js.map +1 -1
  110. package/bin/types/session/SessionApproval.d.ts +97 -0
  111. package/bin/types/session/SessionApproval.d.ts.map +1 -0
  112. package/bin/types/session/SessionApproval.js +7 -0
  113. package/bin/types/session/SessionApproval.js.map +1 -0
  114. package/bin/types/session/SessionMessage.d.ts +223 -0
  115. package/bin/types/session/SessionMessage.d.ts.map +1 -0
  116. package/bin/types/session/SessionMessage.js +8 -0
  117. package/bin/types/session/SessionMessage.js.map +1 -0
  118. package/bin/types/session/SessionMutation.d.ts +116 -0
  119. package/bin/types/session/SessionMutation.d.ts.map +1 -0
  120. package/bin/types/session/SessionMutation.js +19 -0
  121. package/bin/types/session/SessionMutation.js.map +1 -0
  122. package/bin/types/session/SessionOptions.d.ts +9 -0
  123. package/bin/types/session/SessionOptions.d.ts.map +1 -1
  124. package/package.json +3 -3
  125. package/scripts/agent-env.test.mjs +4 -4
  126. package/scripts/remote-session-reconnect.test.mjs +7 -3
  127. package/scripts/session-action-message.test.mjs +98 -27
  128. package/scripts/session-history-inflight.test.mjs +2 -2
  129. package/scripts/session-list-title.test.mjs +6 -19
  130. package/scripts/session-prompt-runtime.test.mjs +7 -19
  131. package/scripts/session-recorder.test.mjs +199 -0
  132. package/scripts/session-title-event.test.mjs +10 -18
  133. package/src/agent/local/Agent.ts +1 -55
  134. package/src/agent/local/services/AgentAssemblyService.ts +39 -3
  135. package/src/agent/local/services/AgentSessions.ts +48 -3
  136. package/src/agent/remote/RemoteAgent.ts +1 -54
  137. package/src/agent/remote/RemoteSession.ts +106 -136
  138. package/src/agent/remote/RemoteTransport.ts +30 -30
  139. package/src/agent/remote/transports/HttpRemoteAgentTransport.ts +52 -77
  140. package/src/agent/remote/transports/RpcRemoteAgentTransport.ts +30 -34
  141. package/src/executor/store/history/jsonl/JsonlSessionHistoryStore.ts +2 -2
  142. package/src/executor/types/SessionHistoryPaths.ts +1 -1
  143. package/src/executor/types/SessionRecords.ts +2 -0
  144. package/src/index.ts +36 -10
  145. package/src/rpc/Client.ts +58 -95
  146. package/src/session/Session.ts +128 -37
  147. package/src/session/browse/Browse.ts +51 -22
  148. package/src/session/recorder/JsonlSessionMessageStore.ts +246 -0
  149. package/src/session/recorder/SessionMessageCodec.ts +284 -0
  150. package/src/session/recorder/SessionRecorder.ts +871 -0
  151. package/src/session/recorder/SessionRecorderCompaction.ts +188 -0
  152. package/src/session/recorder/SessionRecorderHistoryStore.ts +276 -0
  153. package/src/session/runtime/SessionEventHub.ts +25 -12
  154. package/src/session/runtime/SessionPromptRuntime.ts +60 -43
  155. package/src/session/services/SessionStateService.ts +159 -86
  156. package/src/session/services/SessionTurnService.ts +91 -73
  157. package/src/session/services/SessionViewService.ts +25 -13
  158. package/src/session/storage/Paths.ts +2 -2
  159. package/src/session/storage/Persistence.ts +13 -0
  160. package/src/session/storage/RuntimeSessionPort.ts +8 -9
  161. package/src/types/agent/SessionActor.ts +31 -8
  162. package/src/types/rpc/RpcProtocol.ts +44 -67
  163. package/src/types/runtime/agent/AgentContext.ts +9 -7
  164. package/src/types/session/SessionApproval.ts +108 -0
  165. package/src/types/session/SessionMessage.ts +253 -0
  166. package/src/types/session/SessionMutation.ts +141 -0
  167. package/src/types/session/SessionOptions.ts +25 -0
  168. package/tsconfig.tsbuildinfo +1 -1
  169. package/bin/session/SessionEventMapper.d.ts +0 -32
  170. package/bin/session/SessionEventMapper.d.ts.map +0 -1
  171. package/bin/session/SessionEventMapper.js +0 -131
  172. package/bin/session/SessionEventMapper.js.map +0 -1
  173. package/bin/types/sdk/AgentSessionEvent.d.ts +0 -302
  174. package/bin/types/sdk/AgentSessionEvent.d.ts.map +0 -1
  175. package/bin/types/sdk/AgentSessionEvent.js +0 -9
  176. package/bin/types/sdk/AgentSessionEvent.js.map +0 -1
  177. package/bin/types/sdk/InternalUiChunkEvent.d.ts +0 -100
  178. package/bin/types/sdk/InternalUiChunkEvent.d.ts.map +0 -1
  179. package/bin/types/sdk/InternalUiChunkEvent.js +0 -9
  180. package/bin/types/sdk/InternalUiChunkEvent.js.map +0 -1
  181. package/scripts/session-history-archive.test.mjs +0 -188
  182. package/src/session/SessionEventMapper.ts +0 -148
  183. package/src/types/sdk/AgentSessionEvent.ts +0 -370
  184. package/src/types/sdk/InternalUiChunkEvent.ts +0 -108
@@ -1,32 +0,0 @@
1
- /**
2
- * Session 事件映射辅助。
3
- *
4
- * 关键点(中文)
5
- * - 把底层 AI SDK `UIMessageChunk` 归一到内部 `InternalUiChunkEvent`。
6
- * - 再把内部 chunk 事件转换为 `session.subscribe()` 可见的 Session 事件。
7
- */
8
- import type { UIMessageChunk } from "ai";
9
- import type { AgentSessionEvent } from "../types/sdk/AgentSessionEvent.js";
10
- import type { InternalUiChunkEvent } from "../types/sdk/InternalUiChunkEvent.js";
11
- /**
12
- * 把单个 UI chunk 映射为内部 chunk 事件。
13
- */
14
- export declare function mapUiMessageChunkToAgentEvent(chunk: UIMessageChunk): InternalUiChunkEvent | null;
15
- /**
16
- * 把内部 chunk 事件映射为 Session actor 事件。
17
- *
18
- * 关键点(中文)
19
- * - Session 级事件只保留 turn 维度所需的最小字段。
20
- * - `finish` 与通用 `error` 由 turn 生命周期统一表达,不在这里直接透出。
21
- */
22
- export declare function mapAgentEventToSessionEvent(params: {
23
- /**
24
- * 当前内部 chunk 事件。
25
- */
26
- event: InternalUiChunkEvent;
27
- /**
28
- * 当前 turn 标识。
29
- */
30
- turnId: string;
31
- }): AgentSessionEvent | null;
32
- //# sourceMappingURL=SessionEventMapper.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"SessionEventMapper.d.ts","sourceRoot":"","sources":["../../src/session/SessionEventMapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAmBhF;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,GACpB,oBAAoB,GAAG,IAAI,CA4D7B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD;;OAEG;IACH,KAAK,EAAE,oBAAoB,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,iBAAiB,GAAG,IAAI,CAkC3B"}
@@ -1,131 +0,0 @@
1
- /**
2
- * Session 事件映射辅助。
3
- *
4
- * 关键点(中文)
5
- * - 把底层 AI SDK `UIMessageChunk` 归一到内部 `InternalUiChunkEvent`。
6
- * - 再把内部 chunk 事件转换为 `session.subscribe()` 可见的 Session 事件。
7
- */
8
- function toJsonValue(value) {
9
- if (value === undefined)
10
- return null;
11
- if (value === null)
12
- return null;
13
- if (typeof value === "string" ||
14
- typeof value === "number" ||
15
- typeof value === "boolean") {
16
- return value;
17
- }
18
- try {
19
- return JSON.parse(JSON.stringify(value));
20
- }
21
- catch {
22
- return String(value);
23
- }
24
- }
25
- /**
26
- * 把单个 UI chunk 映射为内部 chunk 事件。
27
- */
28
- export function mapUiMessageChunkToAgentEvent(chunk) {
29
- switch (chunk.type) {
30
- case "text-delta":
31
- return {
32
- type: "text-delta",
33
- text: chunk.delta,
34
- };
35
- case "reasoning-delta":
36
- return {
37
- type: "reasoning-delta",
38
- text: chunk.delta,
39
- };
40
- case "tool-input-available":
41
- return {
42
- type: "tool-call",
43
- toolCallId: chunk.toolCallId,
44
- toolName: chunk.toolName,
45
- args: toJsonValue(chunk.input),
46
- };
47
- case "tool-output-available":
48
- return {
49
- type: "tool-result",
50
- toolCallId: chunk.toolCallId,
51
- toolName: "unknown",
52
- result: toJsonValue(chunk.output),
53
- };
54
- case "tool-output-error":
55
- return {
56
- type: "tool-error",
57
- toolCallId: chunk.toolCallId,
58
- toolName: "unknown",
59
- error: chunk.errorText,
60
- };
61
- case "tool-input-error":
62
- return {
63
- type: "tool-error",
64
- toolCallId: chunk.toolCallId,
65
- toolName: chunk.toolName,
66
- error: chunk.errorText,
67
- };
68
- case "finish":
69
- return {
70
- type: "finish",
71
- ...(typeof chunk.finishReason === "string"
72
- ? { finishReason: chunk.finishReason }
73
- : {}),
74
- };
75
- case "error":
76
- return {
77
- type: "error",
78
- error: chunk.errorText,
79
- };
80
- case "abort":
81
- return {
82
- type: "error",
83
- error: String(chunk.reason || "execution aborted"),
84
- };
85
- default:
86
- return null;
87
- }
88
- }
89
- /**
90
- * 把内部 chunk 事件映射为 Session actor 事件。
91
- *
92
- * 关键点(中文)
93
- * - Session 级事件只保留 turn 维度所需的最小字段。
94
- * - `finish` 与通用 `error` 由 turn 生命周期统一表达,不在这里直接透出。
95
- */
96
- export function mapAgentEventToSessionEvent(params) {
97
- const { event, turnId } = params;
98
- switch (event.type) {
99
- case "text-delta":
100
- return {
101
- type: "text-delta",
102
- turnId,
103
- text: event.text,
104
- };
105
- case "reasoning-delta":
106
- return {
107
- type: "reasoning-delta",
108
- turnId,
109
- text: event.text,
110
- };
111
- case "tool-call":
112
- return {
113
- type: "tool-call",
114
- turnId,
115
- toolCallId: event.toolCallId,
116
- toolName: event.toolName,
117
- args: event.args,
118
- };
119
- case "tool-result":
120
- return {
121
- type: "tool-result",
122
- turnId,
123
- toolCallId: event.toolCallId,
124
- toolName: event.toolName,
125
- result: event.result,
126
- };
127
- default:
128
- return null;
129
- }
130
- }
131
- //# sourceMappingURL=SessionEventMapper.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"SessionEventMapper.js","sourceRoot":"","sources":["../../src/session/SessionEventMapper.ts"],"names":[],"mappings":"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"}
@@ -1,302 +0,0 @@
1
- /**
2
- * Agent Session 事件类型定义。
3
- *
4
- * 关键点(中文)
5
- * - `subscribe()` 暴露的是 session 级长期事件序列,而不是单次执行的局部结果。
6
- * - 事件只表达“当前 turn 正在发生什么”,不负责历史回放。
7
- */
8
- import type { JsonValue } from "../../types/common/Json.js";
9
- import type { SessionAssistantStepVisibility } from "../../executor/types/SessionRun.js";
10
- import type { AgentSessionActionEvent } from "../../types/sdk/AgentSessionAction.js";
11
- /**
12
- * 单个 turn 开始事件。
13
- */
14
- export interface AgentSessionTurnStartEvent {
15
- /**
16
- * 当前事件类型。
17
- */
18
- type: "turn-start";
19
- /**
20
- * 当前 turn 的稳定标识。
21
- *
22
- * 说明(中文)
23
- * - 同一个 turn 内的全部增量事件都会复用这个 turnId。
24
- * - 当 Session 排队进入下一轮时,会生成新的 turnId。
25
- */
26
- turnId: string;
27
- }
28
- /**
29
- * 普通文本增量事件。
30
- */
31
- export interface AgentSessionTextDeltaEvent {
32
- /**
33
- * 当前事件类型。
34
- */
35
- type: "text-delta";
36
- /**
37
- * 当前文本所属 turn。
38
- */
39
- turnId: string;
40
- /**
41
- * 当前这次新增的可见文本片段。
42
- */
43
- text: string;
44
- }
45
- /**
46
- * reasoning 文本增量事件。
47
- */
48
- export interface AgentSessionReasoningDeltaEvent {
49
- /**
50
- * 当前事件类型。
51
- */
52
- type: "reasoning-delta";
53
- /**
54
- * 当前 reasoning 所属 turn。
55
- */
56
- turnId: string;
57
- /**
58
- * 当前这次新增的 reasoning 文本片段。
59
- */
60
- text: string;
61
- }
62
- /**
63
- * 工具调用事件。
64
- */
65
- export interface AgentSessionToolCallEvent {
66
- /**
67
- * 当前事件类型。
68
- */
69
- type: "tool-call";
70
- /**
71
- * 当前工具调用所属 turn。
72
- */
73
- turnId: string;
74
- /**
75
- * 当前工具调用唯一标识。
76
- */
77
- toolCallId: string;
78
- /**
79
- * 当前工具名称。
80
- */
81
- toolName: "shell_exec" | "shell_session" | "shell_write" | string;
82
- /**
83
- * 当前工具输入参数。
84
- */
85
- args: JsonValue;
86
- }
87
- /**
88
- * 工具结果事件。
89
- */
90
- export interface AgentSessionToolResultEvent {
91
- /**
92
- * 当前事件类型。
93
- */
94
- type: "tool-result";
95
- /**
96
- * 当前工具结果所属 turn。
97
- */
98
- turnId: string;
99
- /**
100
- * 当前工具调用唯一标识。
101
- */
102
- toolCallId: string;
103
- /**
104
- * 当前工具名称。
105
- */
106
- toolName: "shell_exec" | "shell_session" | "shell_write" | string;
107
- /**
108
- * 当前工具输出结果。
109
- */
110
- result: JsonValue;
111
- }
112
- /**
113
- * 工具审批请求事件。
114
- */
115
- export interface AgentSessionToolApprovalRequestEvent {
116
- /**
117
- * 当前事件类型。
118
- */
119
- type: "tool-approval-request";
120
- /**
121
- * 当前审批所属 turn。
122
- */
123
- turnId: string;
124
- /**
125
- * 当前工具调用唯一标识。
126
- */
127
- toolCallId: string;
128
- /**
129
- * 当前工具名称。
130
- */
131
- toolName: "shell_exec" | "shell_session" | "shell_write" | string;
132
- /**
133
- * 当前审批请求唯一标识。
134
- */
135
- approvalId: string;
136
- /**
137
- * 请求执行的 sandbox 模式。
138
- */
139
- sandbox: "unrestricted";
140
- /**
141
- * 请求执行的命令文本。
142
- *
143
- * 说明(中文)
144
- * - `shell_exec` / `shell_session` start 中是命令文本。
145
- * - `shell_write` 中是 stdin 写入内容,用于兼容内部审批展示。
146
- */
147
- cmd: string;
148
- /**
149
- * 当前审批动作类型。
150
- */
151
- operation?: "exec" | "start" | "write";
152
- /**
153
- * 关联 shell_id;session 输入审批时用于标识目标会话。
154
- */
155
- shellId?: string;
156
- /**
157
- * stdin 写入内容预览;仅 session 输入审批存在。
158
- */
159
- inputPreview?: string;
160
- /**
161
- * stdin 写入字符数;仅 session 输入审批存在。
162
- */
163
- inputChars?: number;
164
- /**
165
- * 命令执行目录。
166
- */
167
- cwd: string;
168
- /**
169
- * Agent 给用户展示的申请原因。
170
- */
171
- reason: string;
172
- /**
173
- * 当前审批状态。
174
- */
175
- status: "pending";
176
- }
177
- /**
178
- * 工具审批结果事件。
179
- */
180
- export interface AgentSessionToolApprovalResultEvent {
181
- /**
182
- * 当前事件类型。
183
- */
184
- type: "tool-approval-result";
185
- /**
186
- * 当前审批所属 turn。
187
- */
188
- turnId: string;
189
- /**
190
- * 当前工具调用唯一标识。
191
- */
192
- toolCallId: string;
193
- /**
194
- * 当前工具名称。
195
- */
196
- toolName: "shell_exec" | "shell_session" | "shell_write" | string;
197
- /**
198
- * 当前审批请求唯一标识。
199
- */
200
- approvalId: string;
201
- /**
202
- * 用户最终决策。
203
- */
204
- decision: "approved" | "denied" | "expired";
205
- }
206
- /**
207
- * assistant step 完成事件。
208
- */
209
- export interface AgentSessionAssistantStepEvent {
210
- /**
211
- * 当前事件类型。
212
- */
213
- type: "assistant-step";
214
- /**
215
- * 当前 assistant step 所属 turn。
216
- */
217
- turnId: string;
218
- /**
219
- * 当前 step 文本。
220
- */
221
- text: string;
222
- /**
223
- * 当前 step 序号(从 1 开始)。
224
- */
225
- stepIndex: number;
226
- /**
227
- * 当前 step 可见性。
228
- */
229
- visibility?: SessionAssistantStepVisibility;
230
- }
231
- /**
232
- * Session 标题更新事件。
233
- */
234
- export interface AgentSessionTitleEvent {
235
- /**
236
- * 当前事件类型。
237
- */
238
- type: "session-title";
239
- /**
240
- * 当前 session 唯一标识。
241
- */
242
- sessionId: string;
243
- /**
244
- * 当前 session 最新标题。
245
- *
246
- * 说明(中文)
247
- * - 标题已持久化到 session meta。
248
- * - 新 session 通常在首条 user message 落盘后生成标题。
249
- */
250
- title: string;
251
- }
252
- /**
253
- * 单个 turn 完成事件。
254
- */
255
- export interface AgentSessionTurnFinishEvent {
256
- /**
257
- * 当前事件类型。
258
- */
259
- type: "turn-finish";
260
- /**
261
- * 当前已完成 turn 的稳定标识。
262
- */
263
- turnId: string;
264
- /**
265
- * 当前 turn 最终可见文本。
266
- */
267
- text: string;
268
- /**
269
- * 当前 turn 是否成功结束。
270
- */
271
- success: boolean;
272
- /**
273
- * 当前 turn 失败时的错误文本。
274
- */
275
- error?: string;
276
- }
277
- /**
278
- * Session 级错误事件。
279
- */
280
- export interface AgentSessionErrorEvent {
281
- /**
282
- * 当前事件类型。
283
- */
284
- type: "error";
285
- /**
286
- * 当前错误文本。
287
- */
288
- message: string;
289
- }
290
- /**
291
- * Session 订阅可见事件联合类型。
292
- */
293
- export type AgentSessionEvent = AgentSessionTurnStartEvent | AgentSessionTextDeltaEvent | AgentSessionReasoningDeltaEvent | AgentSessionToolCallEvent | AgentSessionToolResultEvent | AgentSessionToolApprovalRequestEvent | AgentSessionToolApprovalResultEvent | AgentSessionAssistantStepEvent | AgentSessionTitleEvent | AgentSessionActionEvent | AgentSessionTurnFinishEvent | AgentSessionErrorEvent;
294
- /**
295
- * Session 事件订阅回调。
296
- */
297
- export type AgentSessionSubscriber = (event: AgentSessionEvent) => void;
298
- /**
299
- * 取消 Session 订阅的返回函数。
300
- */
301
- export type AgentSessionUnsubscribe = () => void;
302
- //# sourceMappingURL=AgentSessionEvent.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AgentSessionEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"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"}
@@ -1,9 +0,0 @@
1
- /**
2
- * Agent Session 事件类型定义。
3
- *
4
- * 关键点(中文)
5
- * - `subscribe()` 暴露的是 session 级长期事件序列,而不是单次执行的局部结果。
6
- * - 事件只表达“当前 turn 正在发生什么”,不负责历史回放。
7
- */
8
- export {};
9
- //# sourceMappingURL=AgentSessionEvent.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AgentSessionEvent.js","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
@@ -1,100 +0,0 @@
1
- /**
2
- * SDK 内部 UI chunk 事件类型定义。
3
- *
4
- * 关键点(中文)
5
- * - 这是 Session 事件映射器的内部中间态,不从包根入口导出。
6
- * - 它只负责承接底层 AI SDK `UIMessageChunk`,再转成 `AgentSessionEvent`。
7
- */
8
- import type { JsonValue } from "../../types/common/Json.js";
9
- /**
10
- * SDK 内部 UI chunk 事件。
11
- */
12
- export type InternalUiChunkEvent = {
13
- /**
14
- * 文本增量事件。
15
- */
16
- type: "text-delta";
17
- /**
18
- * 当前追加的文本片段。
19
- */
20
- text: string;
21
- } | {
22
- /**
23
- * reasoning 增量事件。
24
- */
25
- type: "reasoning-delta";
26
- /**
27
- * 当前追加的 reasoning 文本片段。
28
- */
29
- text: string;
30
- } | {
31
- /**
32
- * 工具调用可用事件。
33
- */
34
- type: "tool-call";
35
- /**
36
- * 当前工具调用唯一标识。
37
- */
38
- toolCallId: string;
39
- /**
40
- * 工具名称。
41
- */
42
- toolName: string;
43
- /**
44
- * 工具输入参数。
45
- */
46
- args: JsonValue;
47
- } | {
48
- /**
49
- * 工具调用结果事件。
50
- */
51
- type: "tool-result";
52
- /**
53
- * 当前工具调用唯一标识。
54
- */
55
- toolCallId: string;
56
- /**
57
- * 工具名称。
58
- */
59
- toolName: string;
60
- /**
61
- * 工具输出结果。
62
- */
63
- result: JsonValue;
64
- } | {
65
- /**
66
- * 工具调用失败事件。
67
- */
68
- type: "tool-error";
69
- /**
70
- * 当前工具调用唯一标识。
71
- */
72
- toolCallId: string;
73
- /**
74
- * 工具名称。
75
- */
76
- toolName: string;
77
- /**
78
- * 错误文本。
79
- */
80
- error: string;
81
- } | {
82
- /**
83
- * 运行结束事件。
84
- */
85
- type: "finish";
86
- /**
87
- * 最终完成原因(若底层可提供)。
88
- */
89
- finishReason?: string;
90
- } | {
91
- /**
92
- * 运行错误事件。
93
- */
94
- type: "error";
95
- /**
96
- * 错误文本。
97
- */
98
- error: string;
99
- };
100
- //# sourceMappingURL=InternalUiChunkEvent.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"InternalUiChunkEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/InternalUiChunkEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB,GACD;IACE;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB,GACD;IACE;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IACE;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}
@@ -1,9 +0,0 @@
1
- /**
2
- * SDK 内部 UI chunk 事件类型定义。
3
- *
4
- * 关键点(中文)
5
- * - 这是 Session 事件映射器的内部中间态,不从包根入口导出。
6
- * - 它只负责承接底层 AI SDK `UIMessageChunk`,再转成 `AgentSessionEvent`。
7
- */
8
- export {};
9
- //# sourceMappingURL=InternalUiChunkEvent.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"InternalUiChunkEvent.js","sourceRoot":"","sources":["../../../src/types/sdk/InternalUiChunkEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}