@downcity/agent 1.1.22 → 1.1.23

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. package/README.md +6 -5
  2. package/bin/core/AgentContextTypes.d.ts +21 -2
  3. package/bin/core/AgentContextTypes.d.ts.map +1 -1
  4. package/bin/index.d.ts +5 -1
  5. package/bin/index.d.ts.map +1 -1
  6. package/bin/index.js.map +1 -1
  7. package/bin/runtime/server/http/Server.d.ts +1 -1
  8. package/bin/runtime/server/http/Server.d.ts.map +1 -1
  9. package/bin/runtime/server/http/Server.js +4 -0
  10. package/bin/runtime/server/http/Server.js.map +1 -1
  11. package/bin/runtime/server/http/control/ExecuteBySession.js +1 -1
  12. package/bin/runtime/server/http/control/ExecuteBySession.js.map +1 -1
  13. package/bin/runtime/server/http/control/StreamBySession.d.ts +3 -3
  14. package/bin/runtime/server/http/control/StreamBySession.js +6 -6
  15. package/bin/runtime/server/http/control/StreamBySession.js.map +1 -1
  16. package/bin/runtime/server/http/execute/execute.js +1 -1
  17. package/bin/runtime/server/http/execute/execute.js.map +1 -1
  18. package/bin/runtime/server/http/sdk/Router.d.ts +14 -0
  19. package/bin/runtime/server/http/sdk/Router.d.ts.map +1 -0
  20. package/bin/runtime/server/http/sdk/Router.js +18 -0
  21. package/bin/runtime/server/http/sdk/Router.js.map +1 -0
  22. package/bin/runtime/server/http/sdk/SessionRoutes.d.ts +15 -0
  23. package/bin/runtime/server/http/sdk/SessionRoutes.d.ts.map +1 -0
  24. package/bin/runtime/server/http/sdk/SessionRoutes.js +190 -0
  25. package/bin/runtime/server/http/sdk/SessionRoutes.js.map +1 -0
  26. package/bin/sdk/AgentSdkTypes.d.ts +1 -124
  27. package/bin/sdk/AgentSdkTypes.d.ts.map +1 -1
  28. package/bin/sdk/RemoteAgent.d.ts +27 -8
  29. package/bin/sdk/RemoteAgent.d.ts.map +1 -1
  30. package/bin/sdk/RemoteAgent.js +266 -38
  31. package/bin/sdk/RemoteAgent.js.map +1 -1
  32. package/bin/sdk/Session.d.ts +31 -10
  33. package/bin/sdk/Session.d.ts.map +1 -1
  34. package/bin/sdk/Session.js +181 -73
  35. package/bin/sdk/Session.js.map +1 -1
  36. package/bin/sdk/SessionEventMapper.d.ts +32 -0
  37. package/bin/sdk/SessionEventMapper.d.ts.map +1 -0
  38. package/bin/sdk/{StreamEvents.js → SessionEventMapper.js} +43 -28
  39. package/bin/sdk/SessionEventMapper.js.map +1 -0
  40. package/bin/sdk/session/ServicePort.d.ts +51 -4
  41. package/bin/sdk/session/ServicePort.d.ts.map +1 -1
  42. package/bin/sdk/session/ServicePort.js +17 -10
  43. package/bin/sdk/session/ServicePort.js.map +1 -1
  44. package/bin/sdk/session/runtime/SessionEventHub.d.ts +24 -0
  45. package/bin/sdk/session/runtime/SessionEventHub.d.ts.map +1 -0
  46. package/bin/sdk/session/runtime/SessionEventHub.js +39 -0
  47. package/bin/sdk/session/runtime/SessionEventHub.js.map +1 -0
  48. package/bin/sdk/session/runtime/SessionPromptRuntime.d.ts +68 -0
  49. package/bin/sdk/session/runtime/SessionPromptRuntime.d.ts.map +1 -0
  50. package/bin/sdk/session/runtime/SessionPromptRuntime.js +170 -0
  51. package/bin/sdk/session/runtime/SessionPromptRuntime.js.map +1 -0
  52. package/bin/service/builtins/chat/runtime/ChatQueueWorker.js +1 -1
  53. package/bin/service/builtins/chat/runtime/ChatQueueWorker.js.map +1 -1
  54. package/bin/service/builtins/chat/runtime/ChatSession.d.ts +1 -1
  55. package/bin/service/builtins/chat/runtime/ChatSession.js +1 -1
  56. package/bin/service/builtins/contact/runtime/ChatRuntime.js +1 -1
  57. package/bin/service/builtins/contact/runtime/ChatRuntime.js.map +1 -1
  58. package/bin/types/sdk/AgentSessionEvent.d.ts +160 -0
  59. package/bin/types/sdk/AgentSessionEvent.d.ts.map +1 -0
  60. package/bin/types/sdk/AgentSessionEvent.js +9 -0
  61. package/bin/types/sdk/AgentSessionEvent.js.map +1 -0
  62. package/bin/types/sdk/AgentSessionPrompt.d.ts +21 -0
  63. package/bin/types/sdk/AgentSessionPrompt.d.ts.map +1 -0
  64. package/bin/types/sdk/AgentSessionPrompt.js +9 -0
  65. package/bin/types/sdk/AgentSessionPrompt.js.map +1 -0
  66. package/bin/types/sdk/AgentSessionTurn.d.ts +59 -0
  67. package/bin/types/sdk/AgentSessionTurn.d.ts.map +1 -0
  68. package/bin/types/sdk/AgentSessionTurn.js +10 -0
  69. package/bin/types/sdk/AgentSessionTurn.js.map +1 -0
  70. package/bin/types/sdk/AgentUiChunkEvent.d.ts +100 -0
  71. package/bin/types/sdk/AgentUiChunkEvent.d.ts.map +1 -0
  72. package/bin/types/sdk/AgentUiChunkEvent.js +9 -0
  73. package/bin/types/sdk/AgentUiChunkEvent.js.map +1 -0
  74. package/package.json +2 -1
  75. package/scripts/session-prompt-runtime.test.mjs +167 -0
  76. package/src/core/AgentContextTypes.ts +24 -2
  77. package/src/index.ts +11 -3
  78. package/src/runtime/server/http/Server.ts +5 -1
  79. package/src/runtime/server/http/control/ExecuteBySession.ts +1 -1
  80. package/src/runtime/server/http/control/StreamBySession.ts +11 -11
  81. package/src/runtime/server/http/execute/execute.ts +1 -1
  82. package/src/runtime/server/http/sdk/Router.ts +22 -0
  83. package/src/runtime/server/http/sdk/SessionRoutes.ts +232 -0
  84. package/src/sdk/AgentSdkTypes.ts +1 -137
  85. package/src/sdk/RemoteAgent.ts +368 -49
  86. package/src/sdk/Session.ts +235 -86
  87. package/src/sdk/{StreamEvents.ts → SessionEventMapper.ts} +50 -40
  88. package/src/sdk/session/ServicePort.ts +74 -12
  89. package/src/sdk/session/runtime/SessionEventHub.ts +47 -0
  90. package/src/sdk/session/runtime/SessionPromptRuntime.ts +269 -0
  91. package/src/service/builtins/chat/runtime/ChatQueueWorker.ts +1 -1
  92. package/src/service/builtins/chat/runtime/ChatSession.ts +1 -1
  93. package/src/service/builtins/contact/runtime/ChatRuntime.ts +1 -1
  94. package/src/session/README.md +8 -7
  95. package/src/types/sdk/AgentSessionEvent.ts +195 -0
  96. package/src/types/sdk/AgentSessionPrompt.ts +21 -0
  97. package/src/types/sdk/AgentSessionTurn.ts +65 -0
  98. package/src/types/sdk/AgentUiChunkEvent.ts +108 -0
  99. package/tsconfig.tsbuildinfo +1 -1
  100. package/bin/sdk/AsyncQueue.d.ts +0 -26
  101. package/bin/sdk/AsyncQueue.d.ts.map +0 -1
  102. package/bin/sdk/AsyncQueue.js +0 -75
  103. package/bin/sdk/AsyncQueue.js.map +0 -1
  104. package/bin/sdk/StreamEvents.d.ts +0 -36
  105. package/bin/sdk/StreamEvents.d.ts.map +0 -1
  106. package/bin/sdk/StreamEvents.js.map +0 -1
  107. package/src/sdk/AsyncQueue.ts +0 -92
@@ -1,26 +0,0 @@
1
- /**
2
- * SDK AsyncQueue。
3
- *
4
- * 关键点(中文)
5
- * - 用于把 callback 风格的 stream 事件桥接成 `AsyncIterable`。
6
- * - 保持实现轻量,不引入额外第三方依赖。
7
- */
8
- /**
9
- * 极简异步队列。
10
- */
11
- export declare class AsyncQueue<T> implements AsyncIterable<T> {
12
- private readonly state;
13
- /**
14
- * 推入一个值。
15
- */
16
- push(value: T): void;
17
- /**
18
- * 关闭队列。
19
- */
20
- close(): void;
21
- /**
22
- * 返回异步迭代器。
23
- */
24
- [Symbol.asyncIterator](): AsyncIterator<T>;
25
- }
26
- //# sourceMappingURL=AsyncQueue.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AsyncQueue.d.ts","sourceRoot":"","sources":["../../src/sdk/AsyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAIpB;IAEF;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAapB;;OAEG;IACH,KAAK,IAAI,IAAI;IAab;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAqB3C"}
@@ -1,75 +0,0 @@
1
- /**
2
- * SDK AsyncQueue。
3
- *
4
- * 关键点(中文)
5
- * - 用于把 callback 风格的 stream 事件桥接成 `AsyncIterable`。
6
- * - 保持实现轻量,不引入额外第三方依赖。
7
- */
8
- /**
9
- * 极简异步队列。
10
- */
11
- export class AsyncQueue {
12
- state = {
13
- values: [],
14
- waiters: [],
15
- closed: false,
16
- };
17
- /**
18
- * 推入一个值。
19
- */
20
- push(value) {
21
- if (this.state.closed)
22
- return;
23
- const waiter = this.state.waiters.shift();
24
- if (waiter) {
25
- waiter({
26
- done: false,
27
- value,
28
- });
29
- return;
30
- }
31
- this.state.values.push(value);
32
- }
33
- /**
34
- * 关闭队列。
35
- */
36
- close() {
37
- if (this.state.closed)
38
- return;
39
- this.state.closed = true;
40
- while (this.state.waiters.length > 0) {
41
- const waiter = this.state.waiters.shift();
42
- if (!waiter)
43
- continue;
44
- waiter({
45
- done: true,
46
- value: undefined,
47
- });
48
- }
49
- }
50
- /**
51
- * 返回异步迭代器。
52
- */
53
- [Symbol.asyncIterator]() {
54
- return {
55
- next: () => {
56
- if (this.state.values.length > 0) {
57
- return Promise.resolve({
58
- done: false,
59
- value: this.state.values.shift(),
60
- });
61
- }
62
- if (this.state.closed) {
63
- return Promise.resolve({
64
- done: true,
65
- value: undefined,
66
- });
67
- }
68
- return new Promise((resolve) => {
69
- this.state.waiters.push(resolve);
70
- });
71
- },
72
- };
73
- }
74
- }
75
- //# sourceMappingURL=AsyncQueue.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AsyncQueue.js","sourceRoot":"","sources":["../../src/sdk/AsyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH;;GAEG;AACH,MAAM,OAAO,UAAU;IACJ,KAAK,GAAkB;QACtC,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,KAAK;KACd,CAAC;IAEF;;OAEG;IACH,IAAI,CAAC,KAAQ;QACX,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC;gBACL,IAAI,EAAE,KAAK;gBACX,KAAK;aACN,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,CAAC;gBACL,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,SAAc;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,GAAG,EAAE;gBACT,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC,OAAO,CAAC;wBACrB,IAAI,EAAE,KAAK;wBACX,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAO;qBACtC,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBACtB,OAAO,OAAO,CAAC,OAAO,CAAC;wBACrB,IAAI,EAAE,IAAI;wBACV,KAAK,EAAE,SAAc;qBACtB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;oBAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}
@@ -1,36 +0,0 @@
1
- /**
2
- * SDK Stream 事件映射辅助。
3
- *
4
- * 关键点(中文)
5
- * - 把底层 AI SDK `UIMessageChunk` 归一到 `AgentSessionStreamEvent`。
6
- * - 仅保留 SDK 当前需要的稳定事件,不把所有底层细节直接暴露出去。
7
- */
8
- import type { UIMessageChunk } from "ai";
9
- import type { AgentSessionStreamEvent } from "../sdk/AgentSdkTypes.js";
10
- import type { AsyncQueue } from "../sdk/AsyncQueue.js";
11
- /**
12
- * 把单个 UI chunk 映射为 SDK stream 事件。
13
- */
14
- export declare function mapUiMessageChunkToSdkEvent(chunk: UIMessageChunk): AgentSessionStreamEvent | null;
15
- /**
16
- * 把 UI chunk 推入 SDK stream 队列。
17
- *
18
- * 关键点(中文)
19
- * - `tool-output-*` chunk 本身不总是携带 toolName。
20
- * - 这里用调用 id 维护一次流式执行内的工具名称映射,避免上层重复关心底层 chunk 细节。
21
- */
22
- export declare function pushUiMessageChunkAsSdkEvent(params: {
23
- /**
24
- * SDK stream 事件队列。
25
- */
26
- queue: AsyncQueue<AgentSessionStreamEvent>;
27
- /**
28
- * 底层 AI SDK UI chunk。
29
- */
30
- chunk: UIMessageChunk;
31
- /**
32
- * 当前 stream 生命周期内的 toolCallId 到 toolName 映射。
33
- */
34
- toolNameByCallId: Map<string, string>;
35
- }): void;
36
- //# sourceMappingURL=StreamEvents.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"StreamEvents.d.ts","sourceRoot":"","sources":["../../src/sdk/StreamEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBtD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,GACpB,uBAAuB,GAAG,IAAI,CA4DhC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAC3C;;OAEG;IACH,KAAK,EAAE,cAAc,CAAC;IACtB;;OAEG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,GAAG,IAAI,CAoBP"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"StreamEvents.js","sourceRoot":"","sources":["../../src/sdk/StreamEvents.ts"],"names":[],"mappings":"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"}
@@ -1,92 +0,0 @@
1
- /**
2
- * SDK AsyncQueue。
3
- *
4
- * 关键点(中文)
5
- * - 用于把 callback 风格的 stream 事件桥接成 `AsyncIterable`。
6
- * - 保持实现轻量,不引入额外第三方依赖。
7
- */
8
-
9
- type QueueState<T> = {
10
- /**
11
- * 已入队但尚未消费的值。
12
- */
13
- values: T[];
14
-
15
- /**
16
- * 等待中的消费者回调。
17
- */
18
- waiters: Array<(result: IteratorResult<T>) => void>;
19
-
20
- /**
21
- * 队列是否已关闭。
22
- */
23
- closed: boolean;
24
- };
25
-
26
- /**
27
- * 极简异步队列。
28
- */
29
- export class AsyncQueue<T> implements AsyncIterable<T> {
30
- private readonly state: QueueState<T> = {
31
- values: [],
32
- waiters: [],
33
- closed: false,
34
- };
35
-
36
- /**
37
- * 推入一个值。
38
- */
39
- push(value: T): void {
40
- if (this.state.closed) return;
41
- const waiter = this.state.waiters.shift();
42
- if (waiter) {
43
- waiter({
44
- done: false,
45
- value,
46
- });
47
- return;
48
- }
49
- this.state.values.push(value);
50
- }
51
-
52
- /**
53
- * 关闭队列。
54
- */
55
- close(): void {
56
- if (this.state.closed) return;
57
- this.state.closed = true;
58
- while (this.state.waiters.length > 0) {
59
- const waiter = this.state.waiters.shift();
60
- if (!waiter) continue;
61
- waiter({
62
- done: true,
63
- value: undefined as T,
64
- });
65
- }
66
- }
67
-
68
- /**
69
- * 返回异步迭代器。
70
- */
71
- [Symbol.asyncIterator](): AsyncIterator<T> {
72
- return {
73
- next: () => {
74
- if (this.state.values.length > 0) {
75
- return Promise.resolve({
76
- done: false,
77
- value: this.state.values.shift() as T,
78
- });
79
- }
80
- if (this.state.closed) {
81
- return Promise.resolve({
82
- done: true,
83
- value: undefined as T,
84
- });
85
- }
86
- return new Promise<IteratorResult<T>>((resolve) => {
87
- this.state.waiters.push(resolve);
88
- });
89
- },
90
- };
91
- }
92
- }