@zimtsui/typechat 0.0.98 → 0.0.99

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 (258) hide show
  1. package/DEVELOPMENT.md +3 -8
  2. package/README.md +5 -177
  3. package/assets/verbatim/instruction.md +1 -1
  4. package/assets/verbatim/response.handlebars +1 -1
  5. package/build/adaptor.d.ts +9 -9
  6. package/build/adaptor.js +15 -17
  7. package/build/adaptor.js.map +1 -1
  8. package/build/endpoint-spec.d.ts +1 -1
  9. package/build/endpoint-spec.js +1 -1
  10. package/build/engine/message.d.ts +75 -0
  11. package/build/engine/message.js +165 -0
  12. package/build/engine/message.js.map +1 -0
  13. package/build/engine/middleware.d.ts +11 -0
  14. package/build/engine/middleware.js +1 -0
  15. package/build/engine/middleware.js.map +1 -0
  16. package/build/engine/parts-validator.d.ts +9 -0
  17. package/build/engine/parts-validator.js +11 -0
  18. package/build/engine/parts-validator.js.map +1 -0
  19. package/build/engine/recoverable.d.ts +13 -0
  20. package/build/engine/recoverable.js +29 -0
  21. package/build/engine/recoverable.js.map +1 -0
  22. package/build/engine/session.d.ts +8 -32
  23. package/build/engine/session.js +0 -19
  24. package/build/engine/session.js.map +1 -1
  25. package/build/engine/structuring-validator.d.ts +15 -0
  26. package/build/engine/structuring-validator.js +64 -0
  27. package/build/engine/structuring-validator.js.map +1 -0
  28. package/build/engine/transport.d.ts +6 -3
  29. package/build/engine.d.ts +40 -39
  30. package/build/engine.js +100 -64
  31. package/build/engine.js.map +1 -1
  32. package/build/engines/anthropic/billing.js.map +1 -0
  33. package/build/engines/anthropic/message-codec.d.ts +22 -0
  34. package/build/engines/anthropic/message-codec.js +79 -0
  35. package/build/engines/anthropic/message-codec.js.map +1 -0
  36. package/build/engines/anthropic/message.d.ts +22 -0
  37. package/build/engines/anthropic/message.js +25 -0
  38. package/build/engines/anthropic/message.js.map +1 -0
  39. package/build/{compatible-engine.d/anthropic/choice-codec.d.ts → engines/anthropic/structuring-choice-codec.d.ts} +2 -2
  40. package/build/engines/anthropic/structuring-choice-codec.js +23 -0
  41. package/build/engines/anthropic/structuring-choice-codec.js.map +1 -0
  42. package/build/{api-types → engines}/anthropic/tool-codec.d.ts +5 -4
  43. package/build/{api-types → engines}/anthropic/tool-codec.js +16 -14
  44. package/build/engines/anthropic/tool-codec.js.map +1 -0
  45. package/build/engines/anthropic/transport.d.ts +37 -0
  46. package/build/{compatible-engine.d → engines}/anthropic/transport.js +8 -12
  47. package/build/engines/anthropic/transport.js.map +1 -0
  48. package/build/engines/anthropic.d.ts +22 -0
  49. package/build/engines/anthropic.js +46 -0
  50. package/build/engines/anthropic.js.map +1 -0
  51. package/build/engines/google/billing.js.map +1 -0
  52. package/build/engines/google/message-codec.d.ts +24 -0
  53. package/build/engines/google/message-codec.js +113 -0
  54. package/build/engines/google/message-codec.js.map +1 -0
  55. package/build/engines/google/message.d.ts +37 -0
  56. package/build/engines/google/message.js +58 -0
  57. package/build/engines/google/message.js.map +1 -0
  58. package/build/engines/google/restful-request.js.map +1 -0
  59. package/build/{compatible-engine.d/google/choice-codec.d.ts → engines/google/structuring-choice-codec.d.ts} +2 -2
  60. package/build/engines/google/structuring-choice-codec.js +23 -0
  61. package/build/engines/google/structuring-choice-codec.js.map +1 -0
  62. package/build/{api-types → engines}/google/tool-codec.d.ts +5 -4
  63. package/build/{api-types → engines}/google/tool-codec.js +15 -13
  64. package/build/engines/google/tool-codec.js.map +1 -0
  65. package/build/{native-engines.d → engines}/google/transport.d.ts +13 -14
  66. package/build/{native-engines.d → engines}/google/transport.js +18 -13
  67. package/build/engines/google/transport.js.map +1 -0
  68. package/build/engines/google.d.ts +41 -0
  69. package/build/engines/google.js +151 -0
  70. package/build/engines/google.js.map +1 -0
  71. package/build/engines/openai-chatcompletions/billing.js.map +1 -0
  72. package/build/engines/openai-chatcompletions/message-codec.d.ts +22 -0
  73. package/build/engines/openai-chatcompletions/message-codec.js +80 -0
  74. package/build/engines/openai-chatcompletions/message-codec.js.map +1 -0
  75. package/build/{compatible-engine.d/openai-chatcompletions/choice-codec.d.ts → engines/openai-chatcompletions/structuring-choice-codec.d.ts} +2 -2
  76. package/build/engines/openai-chatcompletions/structuring-choice-codec.js +22 -0
  77. package/build/engines/openai-chatcompletions/structuring-choice-codec.js.map +1 -0
  78. package/build/engines/openai-chatcompletions/tool-codec.d.ts +17 -0
  79. package/build/{api-types → engines}/openai-chatcompletions/tool-codec.js +19 -17
  80. package/build/engines/openai-chatcompletions/tool-codec.js.map +1 -0
  81. package/build/{compatible-engine.d → engines}/openai-chatcompletions/transport.d.ts +13 -15
  82. package/build/{compatible-engine.d → engines}/openai-chatcompletions/transport.js +8 -18
  83. package/build/engines/openai-chatcompletions/transport.js.map +1 -0
  84. package/build/engines/openai-chatcompletions.d.ts +22 -0
  85. package/build/engines/openai-chatcompletions.js +48 -0
  86. package/build/engines/openai-chatcompletions.js.map +1 -0
  87. package/build/engines/openai-responses/billing.js.map +1 -0
  88. package/build/engines/openai-responses/message-codec.d.ts +24 -0
  89. package/build/{compatible-engine.d → engines}/openai-responses/message-codec.js +55 -51
  90. package/build/engines/openai-responses/message-codec.js.map +1 -0
  91. package/build/engines/openai-responses/message.d.ts +25 -0
  92. package/build/engines/openai-responses/message.js +43 -0
  93. package/build/engines/openai-responses/message.js.map +1 -0
  94. package/build/engines/openai-responses/structuring-choice-codec.d.ts +3 -0
  95. package/build/engines/openai-responses/structuring-choice-codec.js +22 -0
  96. package/build/engines/openai-responses/structuring-choice-codec.js.map +1 -0
  97. package/build/engines/openai-responses/structuring-validator.d.ts +12 -0
  98. package/build/engines/openai-responses/structuring-validator.js +64 -0
  99. package/build/engines/openai-responses/structuring-validator.js.map +1 -0
  100. package/build/engines/openai-responses/tool-codec.d.ts +17 -0
  101. package/build/{api-types → engines}/openai-responses/tool-codec.js +19 -17
  102. package/build/engines/openai-responses/tool-codec.js.map +1 -0
  103. package/build/{native-engines.d → engines}/openai-responses/tool.d.ts +1 -3
  104. package/build/{native-engines.d → engines}/openai-responses/tool.js +3 -3
  105. package/build/engines/openai-responses/tool.js.map +1 -0
  106. package/build/{compatible-engine.d → engines}/openai-responses/transport.d.ts +16 -12
  107. package/build/{native-engines.d → engines}/openai-responses/transport.js +11 -9
  108. package/build/engines/openai-responses/transport.js.map +1 -0
  109. package/build/engines/openai-responses.d.ts +41 -0
  110. package/build/engines/openai-responses.js +134 -0
  111. package/build/engines/openai-responses.js.map +1 -0
  112. package/build/exports.d.ts +5 -5
  113. package/build/exports.js +5 -5
  114. package/build/exports.js.map +1 -1
  115. package/build/function.d.ts +7 -7
  116. package/build/function.js +19 -19
  117. package/build/function.js.map +1 -1
  118. package/build/repetition.d.ts +2 -2
  119. package/build/repetition.js +21 -20
  120. package/build/repetition.js.map +1 -1
  121. package/build/structuring-choice.d.ts +15 -0
  122. package/build/structuring-choice.js +18 -0
  123. package/build/structuring-choice.js.map +1 -0
  124. package/build/tsconfig.tsbuildinfo +1 -1
  125. package/build/verbatim/codec/declarations.js +0 -2
  126. package/build/verbatim/codec/declarations.js.map +1 -1
  127. package/build/verbatim/codec/quotation.js +0 -3
  128. package/build/verbatim/codec/quotation.js.map +1 -1
  129. package/build/verbatim/codec/request.js +4 -4
  130. package/build/verbatim/codec/request.js.map +1 -1
  131. package/build/verbatim/codec/response.js +0 -3
  132. package/build/verbatim/codec/response.js.map +1 -1
  133. package/package.json +2 -4
  134. package/build/api-types/anthropic/billing.js.map +0 -1
  135. package/build/api-types/anthropic/tool-codec.js.map +0 -1
  136. package/build/api-types/google/billing.js.map +0 -1
  137. package/build/api-types/google/restful-request.js.map +0 -1
  138. package/build/api-types/google/tool-codec.js.map +0 -1
  139. package/build/api-types/openai-chatcompletions/billing.js.map +0 -1
  140. package/build/api-types/openai-chatcompletions/tool-codec.d.ts +0 -16
  141. package/build/api-types/openai-chatcompletions/tool-codec.js.map +0 -1
  142. package/build/api-types/openai-responses/billing.js.map +0 -1
  143. package/build/api-types/openai-responses/tool-codec.d.ts +0 -16
  144. package/build/api-types/openai-responses/tool-codec.js.map +0 -1
  145. package/build/compatible-engine/session.d.ts +0 -56
  146. package/build/compatible-engine/session.js +0 -85
  147. package/build/compatible-engine/session.js.map +0 -1
  148. package/build/compatible-engine/structuring.d.ts +0 -36
  149. package/build/compatible-engine/structuring.js +0 -34
  150. package/build/compatible-engine/structuring.js.map +0 -1
  151. package/build/compatible-engine/validation.d.ts +0 -28
  152. package/build/compatible-engine/validation.js +0 -104
  153. package/build/compatible-engine/validation.js.map +0 -1
  154. package/build/compatible-engine.d/agentloop.d.ts +0 -12
  155. package/build/compatible-engine.d/agentloop.js +0 -52
  156. package/build/compatible-engine.d/agentloop.js.map +0 -1
  157. package/build/compatible-engine.d/anthropic/choice-codec.js +0 -27
  158. package/build/compatible-engine.d/anthropic/choice-codec.js.map +0 -1
  159. package/build/compatible-engine.d/anthropic/message-codec.d.ts +0 -34
  160. package/build/compatible-engine.d/anthropic/message-codec.js +0 -85
  161. package/build/compatible-engine.d/anthropic/message-codec.js.map +0 -1
  162. package/build/compatible-engine.d/anthropic/transport.d.ts +0 -38
  163. package/build/compatible-engine.d/anthropic/transport.js.map +0 -1
  164. package/build/compatible-engine.d/anthropic.d.ts +0 -25
  165. package/build/compatible-engine.d/anthropic.js +0 -47
  166. package/build/compatible-engine.d/anthropic.js.map +0 -1
  167. package/build/compatible-engine.d/google/choice-codec.js +0 -27
  168. package/build/compatible-engine.d/google/choice-codec.js.map +0 -1
  169. package/build/compatible-engine.d/google/message-codec.d.ts +0 -34
  170. package/build/compatible-engine.d/google/message-codec.js +0 -95
  171. package/build/compatible-engine.d/google/message-codec.js.map +0 -1
  172. package/build/compatible-engine.d/google/transport.d.ts +0 -35
  173. package/build/compatible-engine.d/google/transport.js +0 -97
  174. package/build/compatible-engine.d/google/transport.js.map +0 -1
  175. package/build/compatible-engine.d/google.d.ts +0 -25
  176. package/build/compatible-engine.d/google.js +0 -64
  177. package/build/compatible-engine.d/google.js.map +0 -1
  178. package/build/compatible-engine.d/openai-chatcompletions/choice-codec.js +0 -31
  179. package/build/compatible-engine.d/openai-chatcompletions/choice-codec.js.map +0 -1
  180. package/build/compatible-engine.d/openai-chatcompletions/message-codec.d.ts +0 -22
  181. package/build/compatible-engine.d/openai-chatcompletions/message-codec.js +0 -68
  182. package/build/compatible-engine.d/openai-chatcompletions/message-codec.js.map +0 -1
  183. package/build/compatible-engine.d/openai-chatcompletions/transport.js.map +0 -1
  184. package/build/compatible-engine.d/openai-chatcompletions.d.ts +0 -25
  185. package/build/compatible-engine.d/openai-chatcompletions.js +0 -49
  186. package/build/compatible-engine.d/openai-chatcompletions.js.map +0 -1
  187. package/build/compatible-engine.d/openai-responses/choice-codec.d.ts +0 -5
  188. package/build/compatible-engine.d/openai-responses/choice-codec.js +0 -30
  189. package/build/compatible-engine.d/openai-responses/choice-codec.js.map +0 -1
  190. package/build/compatible-engine.d/openai-responses/message-codec.d.ts +0 -36
  191. package/build/compatible-engine.d/openai-responses/message-codec.js.map +0 -1
  192. package/build/compatible-engine.d/openai-responses/transport.js +0 -91
  193. package/build/compatible-engine.d/openai-responses/transport.js.map +0 -1
  194. package/build/compatible-engine.d/openai-responses.d.ts +0 -25
  195. package/build/compatible-engine.d/openai-responses.js +0 -47
  196. package/build/compatible-engine.d/openai-responses.js.map +0 -1
  197. package/build/compatible-engine.d.ts +0 -27
  198. package/build/compatible-engine.js +0 -34
  199. package/build/compatible-engine.js.map +0 -1
  200. package/build/engine/validation.d.ts +0 -6
  201. package/build/engine/validation.js +0 -1
  202. package/build/engine/validation.js.map +0 -1
  203. package/build/native-engines.d/google/message-codec.d.ts +0 -26
  204. package/build/native-engines.d/google/message-codec.js +0 -70
  205. package/build/native-engines.d/google/message-codec.js.map +0 -1
  206. package/build/native-engines.d/google/session.d.ts +0 -58
  207. package/build/native-engines.d/google/session.js +0 -101
  208. package/build/native-engines.d/google/session.js.map +0 -1
  209. package/build/native-engines.d/google/transport.js.map +0 -1
  210. package/build/native-engines.d/google/validation.d.ts +0 -28
  211. package/build/native-engines.d/google/validation.js +0 -26
  212. package/build/native-engines.d/google/validation.js.map +0 -1
  213. package/build/native-engines.d/google.d/agentloop.d.ts +0 -12
  214. package/build/native-engines.d/google.d/agentloop.js +0 -57
  215. package/build/native-engines.d/google.d/agentloop.js.map +0 -1
  216. package/build/native-engines.d/google.d/exports.d.ts +0 -2
  217. package/build/native-engines.d/google.d/exports.js +0 -3
  218. package/build/native-engines.d/google.d/exports.js.map +0 -1
  219. package/build/native-engines.d/google.d.ts +0 -44
  220. package/build/native-engines.d/google.js +0 -100
  221. package/build/native-engines.d/google.js.map +0 -1
  222. package/build/native-engines.d/openai-responses/choice-codec.d.ts +0 -5
  223. package/build/native-engines.d/openai-responses/choice-codec.js +0 -30
  224. package/build/native-engines.d/openai-responses/choice-codec.js.map +0 -1
  225. package/build/native-engines.d/openai-responses/message-codec.d.ts +0 -25
  226. package/build/native-engines.d/openai-responses/message-codec.js +0 -99
  227. package/build/native-engines.d/openai-responses/message-codec.js.map +0 -1
  228. package/build/native-engines.d/openai-responses/session.d.ts +0 -61
  229. package/build/native-engines.d/openai-responses/session.js +0 -86
  230. package/build/native-engines.d/openai-responses/session.js.map +0 -1
  231. package/build/native-engines.d/openai-responses/structuring.d.ts +0 -19
  232. package/build/native-engines.d/openai-responses/structuring.js +0 -19
  233. package/build/native-engines.d/openai-responses/structuring.js.map +0 -1
  234. package/build/native-engines.d/openai-responses/tool.js.map +0 -1
  235. package/build/native-engines.d/openai-responses/transport.d.ts +0 -40
  236. package/build/native-engines.d/openai-responses/transport.js.map +0 -1
  237. package/build/native-engines.d/openai-responses/validation.d.ts +0 -28
  238. package/build/native-engines.d/openai-responses/validation.js +0 -101
  239. package/build/native-engines.d/openai-responses/validation.js.map +0 -1
  240. package/build/native-engines.d/openai-responses.d/agentloop.d.ts +0 -12
  241. package/build/native-engines.d/openai-responses.d/agentloop.js +0 -61
  242. package/build/native-engines.d/openai-responses.d/agentloop.js.map +0 -1
  243. package/build/native-engines.d/openai-responses.d/exports.d.ts +0 -2
  244. package/build/native-engines.d/openai-responses.d/exports.js +0 -3
  245. package/build/native-engines.d/openai-responses.d/exports.js.map +0 -1
  246. package/build/native-engines.d/openai-responses.d.ts +0 -46
  247. package/build/native-engines.d/openai-responses.js +0 -82
  248. package/build/native-engines.d/openai-responses.js.map +0 -1
  249. /package/build/{api-types → engines}/anthropic/billing.d.ts +0 -0
  250. /package/build/{api-types → engines}/anthropic/billing.js +0 -0
  251. /package/build/{api-types → engines}/google/billing.d.ts +0 -0
  252. /package/build/{api-types → engines}/google/billing.js +0 -0
  253. /package/build/{api-types → engines}/google/restful-request.d.ts +0 -0
  254. /package/build/{api-types → engines}/google/restful-request.js +0 -0
  255. /package/build/{api-types → engines}/openai-chatcompletions/billing.d.ts +0 -0
  256. /package/build/{api-types → engines}/openai-chatcompletions/billing.js +0 -0
  257. /package/build/{api-types → engines}/openai-responses/billing.d.ts +0 -0
  258. /package/build/{api-types → engines}/openai-responses/billing.js +0 -0
package/DEVELOPMENT.md CHANGED
@@ -3,14 +3,9 @@
3
3
  ```mermaid
4
4
  classDiagram
5
5
 
6
- Engine <|.. CompatibleEngine
6
+ Engine <|-- NativeEngine
7
7
 
8
- Engine <|.. OpenAIResponsesNativeEngine
9
- OpenAIResponsesNativeEngine o--> OpenAIResponsesNativeHelpers
10
- OpenAIResponsesNativeHelpers o--> OpenAIResponsesHelpers
11
-
12
- CompatibleEngine <|.. OpenAICompatibleEngine
13
- OpenAICompatibleEngine o--> OpenAIResponsesCompatibleHelpers
14
- OpenAIResponsesCompatibleHelpers o--> OpenAIResponsesHelpers
8
+ NativeRoleMessage --|> RoleMessage
15
9
 
10
+ NativeEngine --> NativeRoleMessage
16
11
  ```
package/README.md CHANGED
@@ -6,188 +6,16 @@ TypeChat 是一个强类型的 LLM 推理服务商 API 适配器。
6
6
 
7
7
  ## 支持服务商 API 类型
8
8
 
9
- - OpenAI Chat Completions
9
+ - OpenAI ChatCompletions
10
10
  - OpenAI Responses
11
11
  - Google
12
12
  - Anthropic
13
13
 
14
- ## 配置
15
-
16
- ```ts
17
- import { type Config } from '@zimtsui/typechat';
18
-
19
-
20
- // 配置推理服务商 API 接入点
21
- export const config: Config = {
22
- endpoints: {
23
- 'gpt-5.4-mini': {
24
- name: 'GPT-5.4 mini',
25
- apiType: 'openai-responses',
26
- baseUrl: 'https://api.openai.com/v1',
27
- apiKey: process.env.OPENAI_API_KEY!,
28
- model: 'gpt-5.4-mini',
29
- },
30
- 'gemini-3-flash': {
31
- name: 'Gemini 3 Flash',
32
- apiType: 'google',
33
- baseUrl: 'https://generativelanguage.googleapis.com',
34
- apiKey: process.env.GOOGLE_API_KEY!,
35
- model: 'gemini-3-flash',
36
- },
37
- },
38
- };
39
- ```
40
-
41
- ## 对话
42
-
43
- ```ts
44
- import { Adaptor, RoleMessage, type Session } from '@zimtsui/typechat';
45
- import { config } from './config.ts';
46
-
47
-
48
- // 创建会话
49
- const session: Session<never, never> = {
50
- developerMessage: new RoleMessage.Developer([
51
- RoleMessage.Part.Text.paragraph('You are a helpful assistant.'),
52
- ]),
53
- chatMessages: [
54
- new RoleMessage.User([ RoleMessage.Part.Text.paragraph('Hello!') ]),
55
- ],
56
- };
57
-
58
- // 选择推理引擎
59
- const adaptor = Adaptor.create(config);
60
- const engine = adaptor.makeCompatibleEngine<{}, {}>({
61
- endpoint: 'gpt-5.4-mini',
62
- functionDeclarationMap: {},
63
- verbatimDeclarationMap: {},
64
- });
65
-
66
- const response = await engine.stateless({}, session);
67
- console.log(response.getText());
68
- ```
69
-
70
- ## 智能体
71
-
72
- ```ts
73
- import { Adaptor, agentloop, RoleMessage, Function, type Session, Structuring } from '@zimtsui/typechat';
74
- import { Type } from 'typebox';
75
- import { config } from './config.ts';
76
-
77
- // 声明函数工具
78
- const fdm = {
79
- get_weather: {
80
- description: '获取指定城市的天气',
81
- parameters: Type.Object({
82
- city: Type.String(),
83
- unit: Type.Optional(Type.Union([Type.Literal('C'), Type.Literal('F')]))
84
- }),
85
- },
86
- submit_result: {
87
- description: '提交最终结果',
88
- parameters: Type.Object({
89
- weather: Type.String(),
90
- advice: Type.String(),
91
- }),
92
- },
93
- } satisfies Function.Decl.Map.Proto;
94
- type fdm = typeof fdm;
95
- type fdu = Function.Decl.From<fdm>;
96
-
97
- // 实现函数工具
98
- export class Submission {
99
- public constructor(public weather: string, public advice: string) {}
100
- }
101
- const fnm: Function.Map<fdm> = {
102
- async get_weather({ city, unit }) {
103
- const data = { city, unit: unit ?? 'C', temperature: 26, sky: 'sunny' };
104
- return JSON.stringify(data);
105
- },
106
- async submit_result({ weather, advice }) {
107
- throw new Submission(weather, advice);
108
- },
109
- };
110
-
111
- // 创建会话
112
- const session: Session<fdu, never> = {
113
- developerMessage: new RoleMessage.Developer([
114
- RoleMessage.Part.Text.paragraph('你的工作是为用户查询天气,并给出穿衣建议。调用工具提交最终结果'),
115
- ]),
116
- chatMessages: [
117
- new RoleMessage.User([ RoleMessage.Part.Text.paragraph('请查询现在北京的天气,并给穿衣建议。') ]),
118
- ],
119
- };
120
-
121
- // 选择推理引擎
122
- const adaptor = Adaptor.create(config);
123
- const engine = adaptor.makeCompatibleEngine<fdm, {}>({
124
- endpoint: 'gpt-5.4-mini',
125
- functionDeclarationMap: fdm,
126
- verbatimDeclarationMap: {},
127
- structuringChoice: Structuring.Choice.FCall.REQUIRED,
128
- });
129
-
130
- // 使用 agentloop 驱动智能体循环,最多 8 轮对话
131
- try {
132
- for await (const text of agentloop({}, session, engine, fnm, 8)) console.log(text);
133
- } catch (e) {
134
- if (e instanceof Submission) {} else throw e;
135
- console.log(e.weather);
136
- console.log(e.advice);
137
- }
138
- ```
139
-
140
- ### XML 逐字频道
14
+ ## [配置](./examples/config.ts)
15
+ ## [对话](./examples/chat.ts)
16
+ ## [智能体](./examples/agent.ts)
17
+ ### [XML 逐字频道](./examples/verbatim.ts)
141
18
 
142
19
  When a LLM outputs structured data in JSON format (e.g., legacy LLM function calling), if there are too many special characters in a string property (e.g., a large LaTeX document, or a complex shell command), the LLM is prone to make mistakes in JSON escaping.
143
20
 
144
21
  XML Verbatim Channel is designed to avoid escaping in LLM messages.
145
-
146
- ```ts
147
- import { Adaptor, RoleMessage, type Session, Structuring, Verbatim } from '@zimtsui/typechat';
148
- import Assets from '@zimtsui/typechat/assets';
149
- import * as Codec from '@zimtsui/typechat/codec';
150
- import { config } from './config.ts';
151
- import { MIMEType } from 'whatwg-mimetype';
152
-
153
- // 声明 XML Verbatim 频道
154
- const vdm = {
155
- bash: {
156
- description: '执行 Bash 命令',
157
- parameters: {
158
- command: {
159
- description: 'Bash 命令',
160
- mimeType: new MIMEType('text/plain'),
161
- required: true as const,
162
- },
163
- },
164
- },
165
- } satisfies Verbatim.Decl.Map.Proto;
166
- type vdm = typeof vdm;
167
- type vdu = Verbatim.Decl.From<vdm>;
168
-
169
-
170
- // 创建会话
171
- const session: Session<never, vdu> = {
172
- developerMessage: new RoleMessage.Developer([
173
- RoleMessage.Part.Text.paragraph(Assets.verbatim.instruction),
174
- RoleMessage.Part.Text.paragraph('# Available Verbatim Channels'),
175
- RoleMessage.Part.Text.paragraph(Codec.Declarations.encode(vdm)),
176
- ]),
177
- chatMessages: [
178
- new RoleMessage.User([ RoleMessage.Part.Text.paragraph('请使用 Bash 命令查询当前系统时间。') ]),
179
- ],
180
- };
181
-
182
- // 选择推理引擎
183
- const adaptor = Adaptor.create(config);
184
- const engine = adaptor.makeCompatibleEngine<{}, vdm>({
185
- endpoint: 'gpt-5.4-mini',
186
- functionDeclarationMap: {},
187
- verbatimDeclarationMap: vdm,
188
- structuringChoice: Structuring.Choice.VRequest.ANYONE,
189
- });
190
-
191
- const response = await engine.stateless({}, session);
192
- console.log(response.getOnlyVerbatimRequest().args.command);
193
- ```
@@ -35,7 +35,7 @@ You can make a request through a channel in the form of
35
35
 
36
36
  - The only attribute of <verbatim:request> is `name`. Additional attributes will be ignored.
37
37
  - The only attribute of <verbatim:parameter> is `name`. Additional attributes will be ignored.
38
- - All arguments must be wrapped in CDATA.
38
+ - All arguments must be wrapped in CDATA. The CDATA sections will be extracted not by standard XML parsers, but by regular expressions instead. Therefore, they can directly contain `]]>`, which is not allowed in standard CDATA.
39
39
 
40
40
  ## Response from Channels
41
41
 
@@ -1 +1 @@
1
- <verbatim:response name="{{this.name}}" mime-type="{{XmlAttr this.mimeType}}"><![CDATA[{{{this.text}}}]]></verbatim:response>
1
+ <verbatim:response name="{{AssertXmlAttr this.name}}" mime-type="{{XmlAttr this.mimeType}}"><![CDATA[{{{this.text}}}]]></verbatim:response>
@@ -1,27 +1,27 @@
1
1
  import { Config } from './config.ts';
2
2
  import { Function } from './function.ts';
3
- import { type CompatibleEngine } from './compatible-engine.ts';
4
3
  import { Throttle } from './throttle.ts';
5
- import { OpenAIResponsesNativeEngine } from './native-engines.d/openai-responses.ts';
6
- import { GoogleNativeEngine } from './native-engines.d/google.ts';
4
+ import { GoogleEngine } from './engines/google.ts';
5
+ import { OpenAIResponsesEngine } from './engines/openai-responses.ts';
7
6
  import type { Verbatim } from './verbatim.ts';
7
+ import { Engine } from './engine.ts';
8
8
  export declare class Adaptor {
9
9
  config: Config;
10
10
  static create(config: Config): Adaptor;
11
11
  protected throttles: Map<string, Throttle>;
12
12
  protected constructor(config: Config);
13
- makeCompatibleEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.CompatibleEngineOptions<fdm, vdm>): CompatibleEngine<fdm, vdm>;
14
- makeOpenAIResponsesNativeEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.OpenAIResponsesNativeEngineOptions<fdm, vdm>): OpenAIResponsesNativeEngine<fdm, vdm>;
15
- makeGoogleNativeEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.GoogleNativeEngineOptions<fdm, vdm>): GoogleNativeEngine<fdm, vdm>;
13
+ makeEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.Params<fdm, vdm>): Engine<fdm, vdm>;
14
+ makeGoogleEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.GoogleParams<fdm, vdm>): GoogleEngine<fdm, vdm>;
15
+ makeOpenAIResponsesEngine<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto>(adaptorOptions: Adaptor.OpenAIResponsesParams<fdm, vdm>): OpenAIResponsesEngine<fdm, vdm>;
16
16
  }
17
17
  export declare namespace Adaptor {
18
- interface CompatibleEngineOptions<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> extends Omit<CompatibleEngine.Options<fdm, vdm>, 'endpointSpec' | 'throttle'> {
18
+ interface Params<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> extends Omit<Engine.Options<fdm, vdm>, 'endpointSpec' | 'throttle'> {
19
19
  endpoint: string;
20
20
  }
21
- interface OpenAIResponsesNativeEngineOptions<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> extends Omit<OpenAIResponsesNativeEngine.Options<fdm, vdm>, 'endpointSpec' | 'throttle'> {
21
+ interface GoogleParams<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> extends Omit<GoogleEngine.Options<fdm, vdm>, 'endpointSpec' | 'throttle'> {
22
22
  endpoint: string;
23
23
  }
24
- interface GoogleNativeEngineOptions<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> extends Omit<GoogleNativeEngine.Options<fdm, vdm>, 'endpointSpec' | 'throttle'> {
24
+ interface OpenAIResponsesParams<in out fdm extends Function.Decl.Map.Proto, in out vdm extends Verbatim.Decl.Map.Proto> extends Omit<OpenAIResponsesEngine.Options<fdm, vdm>, 'endpointSpec' | 'throttle'> {
25
25
  endpoint: string;
26
26
  }
27
27
  }
package/build/adaptor.js CHANGED
@@ -1,10 +1,8 @@
1
1
  import { Throttle } from "./throttle.js";
2
- import { GoogleCompatibleEngine } from "./compatible-engine.d/google.js";
3
- import { OpenAIResponsesCompatibleEngine } from "./compatible-engine.d/openai-responses.js";
4
- import { AnthropicCompatibleEngine } from "./compatible-engine.d/anthropic.js";
5
- import { OpenAIResponsesNativeEngine } from "./native-engines.d/openai-responses.js";
6
- import { GoogleNativeEngine } from "./native-engines.d/google.js";
7
- import { OpenAIChatCompletionsCompatibleEngine } from "./compatible-engine.d/openai-chatcompletions.js";
2
+ import { GoogleEngine } from "./engines/google.js";
3
+ import { OpenAIResponsesEngine } from "./engines/openai-responses.js";
4
+ import { OpenAIChatCompletionsEngine } from "./engines/openai-chatcompletions.js";
5
+ import { AnthropicEngine } from "./engines/anthropic.js";
8
6
  export class Adaptor {
9
7
  config;
10
8
  static create(config) {
@@ -18,7 +16,7 @@ export class Adaptor {
18
16
  this.throttles.set(endpointId, new Throttle(rpm));
19
17
  }
20
18
  }
21
- makeCompatibleEngine(adaptorOptions) {
19
+ makeEngine(adaptorOptions) {
22
20
  const endpointSpec = this.config.endpoints[adaptorOptions.endpoint];
23
21
  if (endpointSpec) { }
24
22
  else
@@ -33,19 +31,19 @@ export class Adaptor {
33
31
  throttle,
34
32
  };
35
33
  if (endpointSpec.apiType === 'openai-responses')
36
- return new OpenAIResponsesCompatibleEngine.Instance(options);
34
+ return OpenAIResponsesEngine.create(options);
37
35
  else if (endpointSpec.apiType === 'google')
38
- return new GoogleCompatibleEngine.Instance(options);
36
+ return GoogleEngine.create(options);
39
37
  else if (endpointSpec.apiType === 'anthropic')
40
- return new AnthropicCompatibleEngine.Instance(options);
38
+ return AnthropicEngine.create(options);
41
39
  else if (endpointSpec.apiType === 'openai-chatcompletions')
42
- return new OpenAIChatCompletionsCompatibleEngine.Instance(options);
40
+ return OpenAIChatCompletionsEngine.create(options);
43
41
  else
44
42
  throw new Error();
45
43
  }
46
- makeOpenAIResponsesNativeEngine(adaptorOptions) {
44
+ makeGoogleEngine(adaptorOptions) {
47
45
  const endpointSpec = this.config.endpoints[adaptorOptions.endpoint];
48
- if (endpointSpec?.apiType === 'openai-responses') { }
46
+ if (endpointSpec?.apiType === 'google') { }
49
47
  else
50
48
  throw new Error();
51
49
  const throttle = this.throttles.get(adaptorOptions.endpoint);
@@ -57,11 +55,11 @@ export class Adaptor {
57
55
  endpointSpec,
58
56
  throttle,
59
57
  };
60
- return new OpenAIResponsesNativeEngine.Instance(options);
58
+ return new GoogleEngine.Instance(options);
61
59
  }
62
- makeGoogleNativeEngine(adaptorOptions) {
60
+ makeOpenAIResponsesEngine(adaptorOptions) {
63
61
  const endpointSpec = this.config.endpoints[adaptorOptions.endpoint];
64
- if (endpointSpec?.apiType === 'google') { }
62
+ if (endpointSpec?.apiType === 'openai-responses') { }
65
63
  else
66
64
  throw new Error();
67
65
  const throttle = this.throttles.get(adaptorOptions.endpoint);
@@ -73,7 +71,7 @@ export class Adaptor {
73
71
  endpointSpec,
74
72
  throttle,
75
73
  };
76
- return new GoogleNativeEngine.Instance(options);
74
+ return new OpenAIResponsesEngine.Instance(options);
77
75
  }
78
76
  }
79
77
  //# sourceMappingURL=adaptor.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../src/adaptor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,qCAAqC,EAAE,MAAM,iDAAiD,CAAC;AAGxG,MAAM,OAAO,OAAO;IAMa;IALtB,MAAM,CAAC,MAAM,CAAC,MAAc;QAC/B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAES,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAClD,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACvC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAE,CAAC,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC;YAC/E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;IAEM,oBAAoB,CAGzB,cAAyD;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,YAAY,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACxC,MAAM,OAAO,GAAuC;YAChD,GAAG,cAAc;YACjB,YAAY;YACZ,QAAQ;SACX,CAAC;QACF,IAAI,YAAY,CAAC,OAAO,KAAK,kBAAkB;YAC3C,OAAO,IAAI,+BAA+B,CAAC,QAAQ,CAAW,OAAO,CAAC,CAAC;aACtE,IAAI,YAAY,CAAC,OAAO,KAAK,QAAQ;YACtC,OAAO,IAAI,sBAAsB,CAAC,QAAQ,CAAW,OAAO,CAAC,CAAC;aAC7D,IAAI,YAAY,CAAC,OAAO,KAAK,WAAW;YACzC,OAAO,IAAI,yBAAyB,CAAC,QAAQ,CAAW,OAAO,CAAC,CAAC;aAChE,IAAI,YAAY,CAAC,OAAO,KAAK,wBAAwB;YACtD,OAAO,IAAI,qCAAqC,CAAC,QAAQ,CAAW,OAAO,CAAC,CAAC;;YAC5E,MAAM,IAAI,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEM,+BAA+B,CAGpC,cAAoE;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,YAAY,EAAE,OAAO,KAAK,kBAAkB,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACxC,MAAM,OAAO,GAAkD;YAC3D,GAAG,cAAc;YACjB,YAAY;YACZ,QAAQ;SACX,CAAC;QACF,OAAO,IAAI,2BAA2B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IAEM,sBAAsB,CAG3B,cAA2D;QACzD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,YAAY,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC,CAAA,CAAC;;YAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACxC,MAAM,OAAO,GAAyC;YAClD,GAAG,cAAc;YACjB,YAAY;YACZ,QAAQ;SACX,CAAC;QACF,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;CACJ"}
1
+ {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../src/adaptor.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { Type, type Static } from "typebox";
1
+ import { Type, type Static } from 'typebox';
2
2
  export type EndpointSpec = Static<typeof EndpointSpec.schema>;
3
3
  export declare namespace EndpointSpec {
4
4
  const schema: Type.TObject<{
@@ -1,4 +1,4 @@
1
- import { Type } from "typebox";
1
+ import { Type } from 'typebox';
2
2
  export var EndpointSpec;
3
3
  (function (EndpointSpec) {
4
4
  EndpointSpec.schema = Type.Object({
@@ -0,0 +1,75 @@
1
+ import { Function } from '../function.ts';
2
+ import { Verbatim } from '../verbatim.ts';
3
+ declare const NOMINAL: unique symbol;
4
+ export declare namespace RoleMessage {
5
+ class Developer {
6
+ protected parts: unknown[];
7
+ protected [NOMINAL]: never;
8
+ constructor(parts: unknown[]);
9
+ allTextParts(): boolean;
10
+ getParts(): unknown[];
11
+ getOnlyTextParts(): RoleMessage.Developer.Part.Text[];
12
+ getTextParts(): RoleMessage.Developer.Part.Text[];
13
+ getText(): string;
14
+ }
15
+ namespace Developer {
16
+ namespace Part {
17
+ class Text {
18
+ text: string;
19
+ protected [NOMINAL]: never;
20
+ static paragraph(text: string): Text;
21
+ constructor(text: string);
22
+ }
23
+ }
24
+ }
25
+ class Ai<out fdu extends Function.Decl.Proto, out vdu extends Verbatim.Decl.Proto> {
26
+ protected parts: unknown[];
27
+ protected [NOMINAL]: never;
28
+ constructor(parts: unknown[]);
29
+ getParts(): unknown[];
30
+ allChat(): boolean;
31
+ getTextParts(): RoleMessage.Ai.Part.Text<vdu>[];
32
+ getChat(): string;
33
+ getText(): string;
34
+ getFunctionCalls(): Function.Call.Of<fdu>[];
35
+ getVerbatimRequests(): Verbatim.Request.Of<vdu>[];
36
+ getOnlyFunctionCall(): Function.Call.Of<fdu>;
37
+ getOnlyVerbatimRequest(): Verbatim.Request.Of<vdu>;
38
+ }
39
+ namespace Ai {
40
+ type From<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto> = RoleMessage.Ai<Function.Decl.From<fdm>, Verbatim.Decl.From<vdm>>;
41
+ namespace Part {
42
+ class Text<out vdu extends Verbatim.Decl.Proto> {
43
+ text: string;
44
+ vreqs: Verbatim.Request.Of<vdu>[];
45
+ protected [NOMINAL]: never;
46
+ static paragraph(text: string): Text<never>;
47
+ constructor(text: string, vreqs: Verbatim.Request.Of<vdu>[]);
48
+ }
49
+ namespace Text {
50
+ type From<vdm extends Verbatim.Decl.Map.Proto> = Text<Verbatim.Decl.From<vdm>>;
51
+ }
52
+ }
53
+ }
54
+ class User<out fdu extends Function.Decl.Proto> {
55
+ protected parts: unknown[];
56
+ protected [NOMINAL]: never;
57
+ constructor(parts: unknown[]);
58
+ getParts(): unknown[];
59
+ getFunctionResponses(): Function.Response.Of<fdu>[];
60
+ getOnlyFunctionResponse(): Function.Response.Of<fdu>;
61
+ getTextParts(): RoleMessage.User.Part.Text[];
62
+ }
63
+ namespace User {
64
+ type From<fdm extends Function.Decl.Map.Proto> = RoleMessage.User<Function.Decl.From<fdm>>;
65
+ namespace Part {
66
+ class Text {
67
+ text: string;
68
+ protected [NOMINAL]: never;
69
+ static paragraph(text: string): Text;
70
+ constructor(text: string);
71
+ }
72
+ }
73
+ }
74
+ }
75
+ export {};
@@ -0,0 +1,165 @@
1
+ import { Function } from "../function.js";
2
+ const NOMINAL = Symbol();
3
+ export var RoleMessage;
4
+ (function (RoleMessage) {
5
+ class Developer {
6
+ parts;
7
+ constructor(parts) {
8
+ this.parts = parts;
9
+ }
10
+ allTextParts() {
11
+ return this.parts.every(part => part instanceof RoleMessage.Developer.Part.Text);
12
+ }
13
+ getParts() {
14
+ return this.parts;
15
+ }
16
+ getOnlyTextParts() {
17
+ if (this.allTextParts()) { }
18
+ else
19
+ throw new Error();
20
+ return this.getTextParts();
21
+ }
22
+ getTextParts() {
23
+ const textParts = [];
24
+ for (const part of this.parts)
25
+ if (part instanceof RoleMessage.Developer.Part.Text) {
26
+ const textPart = part;
27
+ textParts.push(textPart);
28
+ }
29
+ return textParts;
30
+ }
31
+ getText() {
32
+ return this.getTextParts().map(part => part.text).join('');
33
+ }
34
+ }
35
+ RoleMessage.Developer = Developer;
36
+ (function (Developer) {
37
+ let Part;
38
+ (function (Part) {
39
+ class Text {
40
+ text;
41
+ static paragraph(text) {
42
+ return new Text(text.trimEnd() + '\n\n');
43
+ }
44
+ constructor(text) {
45
+ this.text = text;
46
+ }
47
+ }
48
+ Part.Text = Text;
49
+ })(Part = Developer.Part || (Developer.Part = {}));
50
+ })(Developer = RoleMessage.Developer || (RoleMessage.Developer = {}));
51
+ class Ai {
52
+ parts;
53
+ constructor(parts) {
54
+ this.parts = parts;
55
+ }
56
+ getParts() {
57
+ return this.parts;
58
+ }
59
+ allChat() {
60
+ return this.parts.every(part => part instanceof RoleMessage.Ai.Part.Text && !part.vreqs.length);
61
+ }
62
+ getTextParts() {
63
+ return this.parts.filter(part => part instanceof RoleMessage.Ai.Part.Text);
64
+ }
65
+ getChat() {
66
+ return this.getTextParts().filter(part => !part.vreqs.length).map(part => part.text).join('');
67
+ }
68
+ getText() {
69
+ return this.getTextParts().map(part => part.text).join('');
70
+ }
71
+ getFunctionCalls() {
72
+ const fcalls = [];
73
+ for (const part of this.parts)
74
+ if (part instanceof Function.Call) {
75
+ const fcall = part;
76
+ fcalls.push(fcall);
77
+ }
78
+ return fcalls;
79
+ }
80
+ getVerbatimRequests() {
81
+ return this.getTextParts().flatMap(part => part.vreqs);
82
+ }
83
+ getOnlyFunctionCall() {
84
+ const fcalls = this.getFunctionCalls();
85
+ if (fcalls.length === 1) { }
86
+ else
87
+ throw new Error();
88
+ return fcalls[0];
89
+ }
90
+ getOnlyVerbatimRequest() {
91
+ const vreqs = this.getVerbatimRequests();
92
+ if (vreqs.length === 1) { }
93
+ else
94
+ throw new Error();
95
+ return vreqs[0];
96
+ }
97
+ }
98
+ RoleMessage.Ai = Ai;
99
+ (function (Ai) {
100
+ let Part;
101
+ (function (Part) {
102
+ class Text {
103
+ text;
104
+ vreqs;
105
+ static paragraph(text) {
106
+ return new RoleMessage.Ai.Part.Text(text.trimEnd() + '\n\n', []);
107
+ }
108
+ constructor(text, vreqs) {
109
+ this.text = text;
110
+ this.vreqs = vreqs;
111
+ }
112
+ }
113
+ Part.Text = Text;
114
+ })(Part = Ai.Part || (Ai.Part = {}));
115
+ })(Ai = RoleMessage.Ai || (RoleMessage.Ai = {}));
116
+ class User {
117
+ parts;
118
+ constructor(parts) {
119
+ this.parts = parts;
120
+ }
121
+ getParts() {
122
+ return this.parts;
123
+ }
124
+ getFunctionResponses() {
125
+ const fress = [];
126
+ for (const part of this.parts)
127
+ if (part instanceof Function.Response) {
128
+ const fres = part;
129
+ fress.push(fres);
130
+ }
131
+ return fress;
132
+ }
133
+ getOnlyFunctionResponse() {
134
+ if (this.parts.length === 1) { }
135
+ else
136
+ throw new Error();
137
+ const part = this.parts[0];
138
+ if (part instanceof Function.Response) { }
139
+ else
140
+ throw new Error();
141
+ const fres = part;
142
+ return fres;
143
+ }
144
+ getTextParts() {
145
+ return this.parts.filter(part => part instanceof RoleMessage.User.Part.Text);
146
+ }
147
+ }
148
+ RoleMessage.User = User;
149
+ (function (User) {
150
+ let Part;
151
+ (function (Part) {
152
+ class Text {
153
+ text;
154
+ static paragraph(text) {
155
+ return new RoleMessage.User.Part.Text(text.trimEnd() + '\n\n');
156
+ }
157
+ constructor(text) {
158
+ this.text = text;
159
+ }
160
+ }
161
+ Part.Text = Text;
162
+ })(Part = User.Part || (User.Part = {}));
163
+ })(User = RoleMessage.User || (RoleMessage.User = {}));
164
+ })(RoleMessage || (RoleMessage = {}));
165
+ //# sourceMappingURL=message.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/engine/message.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import { Function } from '../function.ts';
2
+ import { type InferenceContext } from '../inference-context.ts';
3
+ import { Session } from './session.ts';
4
+ import { RoleMessage } from './message.ts';
5
+ import { Verbatim } from '../verbatim.ts';
6
+ export interface Middleware<in out fdu extends Function.Decl.Proto, in out vdu extends Verbatim.Decl.Proto> {
7
+ (wfctx: InferenceContext, session: Session<fdu, vdu>, next: () => Promise<RoleMessage.Ai<fdu, vdu>>): Promise<RoleMessage.Ai<fdu, vdu>>;
8
+ }
9
+ export declare namespace Middleware {
10
+ type From<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto> = Middleware<Function.Decl.From<fdm>, Verbatim.Decl.From<vdm>>;
11
+ }
@@ -0,0 +1 @@
1
+ //# sourceMappingURL=middleware.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/engine/middleware.ts"],"names":[],"mappings":""}
@@ -0,0 +1,9 @@
1
+ import { Function } from '../function.ts';
2
+ import { Verbatim } from '../verbatim.ts';
3
+ import { RoleMessage } from './message.ts';
4
+ export declare class PartsValidator<in out fdu extends Function.Decl.Proto, in out vdu extends Verbatim.Decl.Proto> {
5
+ validate(message: RoleMessage.Ai<fdu, vdu>): void;
6
+ }
7
+ export declare namespace PartsValidator {
8
+ type From<fdm extends Function.Decl.Map.Proto, vdm extends Verbatim.Decl.Map.Proto> = PartsValidator<Function.Decl.From<fdm>, Verbatim.Decl.From<vdm>>;
9
+ }
@@ -0,0 +1,11 @@
1
+ import { isRepeating } from "../repetition.js";
2
+ export class PartsValidator {
3
+ validate(message) {
4
+ if (message.getParts().length) { }
5
+ else
6
+ throw new SyntaxError('Empty message.');
7
+ if (isRepeating(message.getText()))
8
+ throw new SyntaxError('Repeating');
9
+ }
10
+ }
11
+ //# sourceMappingURL=parts-validator.js.map