@copilotkit/shared 2.0.0-rc.2 → 2.0.0-rc.21

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 (287) hide show
  1. package/README.md +3 -14
  2. package/dist/a2ui-envelope.cjs +2 -2
  3. package/dist/a2ui-envelope.cjs.map +1 -1
  4. package/dist/a2ui-envelope.d.cts +1 -1
  5. package/dist/a2ui-envelope.d.cts.map +1 -1
  6. package/dist/a2ui-envelope.d.mts +1 -1
  7. package/dist/a2ui-envelope.d.mts.map +1 -1
  8. package/dist/a2ui-envelope.mjs +2 -2
  9. package/dist/a2ui-envelope.mjs.map +1 -1
  10. package/dist/a2ui-prompts.cjs +21 -62
  11. package/dist/a2ui-prompts.cjs.map +1 -1
  12. package/dist/a2ui-prompts.d.cts +8 -1
  13. package/dist/a2ui-prompts.d.cts.map +1 -1
  14. package/dist/a2ui-prompts.d.mts +8 -1
  15. package/dist/a2ui-prompts.d.mts.map +1 -1
  16. package/dist/a2ui-prompts.mjs +22 -62
  17. package/dist/a2ui-prompts.mjs.map +1 -1
  18. package/dist/attachments/types.d.cts +1 -3
  19. package/dist/attachments/types.d.cts.map +1 -1
  20. package/dist/attachments/types.d.mts +1 -3
  21. package/dist/attachments/types.d.mts.map +1 -1
  22. package/dist/finalize-events.cjs +16 -0
  23. package/dist/finalize-events.cjs.map +1 -1
  24. package/dist/finalize-events.d.cts.map +1 -1
  25. package/dist/finalize-events.d.mts.map +1 -1
  26. package/dist/finalize-events.mjs +16 -0
  27. package/dist/finalize-events.mjs.map +1 -1
  28. package/dist/generative-ui/basic-functions.cjs +1 -1
  29. package/dist/generative-ui/basic-functions.cjs.map +1 -1
  30. package/dist/generative-ui/basic-functions.mjs +1 -1
  31. package/dist/generative-ui/basic-functions.mjs.map +1 -1
  32. package/dist/generative-ui/child-refs.cjs +3 -3
  33. package/dist/generative-ui/child-refs.cjs.map +1 -1
  34. package/dist/generative-ui/child-refs.d.cts.map +1 -1
  35. package/dist/generative-ui/child-refs.d.mts.map +1 -1
  36. package/dist/generative-ui/child-refs.mjs +3 -3
  37. package/dist/generative-ui/child-refs.mjs.map +1 -1
  38. package/dist/generative-ui/compact-schema.cjs +187 -0
  39. package/dist/generative-ui/compact-schema.cjs.map +1 -0
  40. package/dist/generative-ui/compact-schema.d.cts +55 -0
  41. package/dist/generative-ui/compact-schema.d.cts.map +1 -0
  42. package/dist/generative-ui/compact-schema.d.mts +55 -0
  43. package/dist/generative-ui/compact-schema.d.mts.map +1 -0
  44. package/dist/generative-ui/compact-schema.mjs +185 -0
  45. package/dist/generative-ui/compact-schema.mjs.map +1 -0
  46. package/dist/generative-ui/prompt-spec.cjs +225 -0
  47. package/dist/generative-ui/prompt-spec.cjs.map +1 -0
  48. package/dist/generative-ui/prompt-spec.d.cts +94 -0
  49. package/dist/generative-ui/prompt-spec.d.cts.map +1 -0
  50. package/dist/generative-ui/prompt-spec.d.mts +94 -0
  51. package/dist/generative-ui/prompt-spec.d.mts.map +1 -0
  52. package/dist/generative-ui/prompt-spec.mjs +220 -0
  53. package/dist/generative-ui/prompt-spec.mjs.map +1 -0
  54. package/dist/generative-ui/prompt.cjs +10 -36
  55. package/dist/generative-ui/prompt.cjs.map +1 -1
  56. package/dist/generative-ui/prompt.d.cts +2 -1
  57. package/dist/generative-ui/prompt.d.cts.map +1 -1
  58. package/dist/generative-ui/prompt.d.mts +2 -1
  59. package/dist/generative-ui/prompt.d.mts.map +1 -1
  60. package/dist/generative-ui/prompt.mjs +12 -38
  61. package/dist/generative-ui/prompt.mjs.map +1 -1
  62. package/dist/generative-ui/render-ui-args.cjs +1 -0
  63. package/dist/generative-ui/render-ui-args.cjs.map +1 -1
  64. package/dist/generative-ui/render-ui-args.d.cts.map +1 -1
  65. package/dist/generative-ui/render-ui-args.d.mts.map +1 -1
  66. package/dist/generative-ui/render-ui-args.mjs +1 -0
  67. package/dist/generative-ui/render-ui-args.mjs.map +1 -1
  68. package/dist/generative-ui/schema-render.cjs +242 -0
  69. package/dist/generative-ui/schema-render.cjs.map +1 -0
  70. package/dist/generative-ui/schema-render.d.cts +44 -0
  71. package/dist/generative-ui/schema-render.d.cts.map +1 -0
  72. package/dist/generative-ui/schema-render.d.mts +44 -0
  73. package/dist/generative-ui/schema-render.d.mts.map +1 -0
  74. package/dist/generative-ui/schema-render.mjs +239 -0
  75. package/dist/generative-ui/schema-render.mjs.map +1 -0
  76. package/dist/generative-ui/types.cjs +2 -2
  77. package/dist/generative-ui/types.cjs.map +1 -1
  78. package/dist/generative-ui/types.d.cts +7 -7
  79. package/dist/generative-ui/types.d.cts.map +1 -1
  80. package/dist/generative-ui/types.d.mts +7 -7
  81. package/dist/generative-ui/types.d.mts.map +1 -1
  82. package/dist/generative-ui/types.mjs +2 -2
  83. package/dist/generative-ui/types.mjs.map +1 -1
  84. package/dist/generative-ui/validate-operation.cjs +2 -2
  85. package/dist/generative-ui/validate-operation.cjs.map +1 -1
  86. package/dist/generative-ui/validate-operation.mjs +2 -2
  87. package/dist/generative-ui/validate-operation.mjs.map +1 -1
  88. package/dist/index.cjs +18 -15
  89. package/dist/index.cjs.map +1 -1
  90. package/dist/index.d.cts +11 -10
  91. package/dist/index.d.cts.map +1 -1
  92. package/dist/index.d.mts +11 -10
  93. package/dist/index.d.mts.map +1 -1
  94. package/dist/index.mjs +10 -8
  95. package/dist/index.mjs.map +1 -1
  96. package/dist/index.umd.js +864 -450
  97. package/dist/index.umd.js.map +1 -1
  98. package/dist/package.cjs +1 -1
  99. package/dist/package.mjs +1 -1
  100. package/dist/standard-schema.cjs +20 -7
  101. package/dist/standard-schema.cjs.map +1 -1
  102. package/dist/standard-schema.d.cts +15 -16
  103. package/dist/standard-schema.d.cts.map +1 -1
  104. package/dist/standard-schema.d.mts +15 -16
  105. package/dist/standard-schema.d.mts.map +1 -1
  106. package/dist/standard-schema.mjs +20 -8
  107. package/dist/standard-schema.mjs.map +1 -1
  108. package/dist/telemetry/lambda-client.cjs +1 -1
  109. package/dist/telemetry/lambda-client.cjs.map +1 -1
  110. package/dist/telemetry/lambda-client.d.cts.map +1 -1
  111. package/dist/telemetry/lambda-client.d.mts.map +1 -1
  112. package/dist/telemetry/lambda-client.mjs +1 -1
  113. package/dist/telemetry/lambda-client.mjs.map +1 -1
  114. package/dist/telemetry/telemetry-disabled.cjs +3 -6
  115. package/dist/telemetry/telemetry-disabled.cjs.map +1 -1
  116. package/dist/telemetry/telemetry-disabled.d.cts +0 -5
  117. package/dist/telemetry/telemetry-disabled.d.cts.map +1 -1
  118. package/dist/telemetry/telemetry-disabled.d.mts +0 -5
  119. package/dist/telemetry/telemetry-disabled.d.mts.map +1 -1
  120. package/dist/telemetry/telemetry-disabled.mjs +4 -6
  121. package/dist/telemetry/telemetry-disabled.mjs.map +1 -1
  122. package/dist/types/message.d.cts +1 -18
  123. package/dist/types/message.d.cts.map +1 -1
  124. package/dist/types/message.d.mts +1 -18
  125. package/dist/types/message.d.mts.map +1 -1
  126. package/dist/utils/errors.cjs +5 -42
  127. package/dist/utils/errors.cjs.map +1 -1
  128. package/dist/utils/errors.d.cts +16 -34
  129. package/dist/utils/errors.d.cts.map +1 -1
  130. package/dist/utils/errors.d.mts +16 -34
  131. package/dist/utils/errors.d.mts.map +1 -1
  132. package/dist/utils/errors.mjs +6 -41
  133. package/dist/utils/errors.mjs.map +1 -1
  134. package/dist/utils/index.cjs +1 -2
  135. package/dist/utils/index.cjs.map +1 -1
  136. package/dist/utils/index.d.cts +5 -6
  137. package/dist/utils/index.d.cts.map +1 -1
  138. package/dist/utils/index.d.mts +5 -6
  139. package/dist/utils/index.d.mts.map +1 -1
  140. package/dist/utils/index.mjs +5 -6
  141. package/dist/utils/index.mjs.map +1 -1
  142. package/dist/utils/inspector-visibility.cjs +25 -3
  143. package/dist/utils/inspector-visibility.cjs.map +1 -1
  144. package/dist/utils/inspector-visibility.d.cts +26 -3
  145. package/dist/utils/inspector-visibility.d.cts.map +1 -1
  146. package/dist/utils/inspector-visibility.d.mts +26 -3
  147. package/dist/utils/inspector-visibility.d.mts.map +1 -1
  148. package/dist/utils/inspector-visibility.mjs +25 -4
  149. package/dist/utils/inspector-visibility.mjs.map +1 -1
  150. package/dist/utils/json-schema.cjs +4 -79
  151. package/dist/utils/json-schema.cjs.map +1 -1
  152. package/dist/utils/json-schema.d.cts +1 -4
  153. package/dist/utils/json-schema.d.cts.map +1 -1
  154. package/dist/utils/json-schema.d.mts +1 -4
  155. package/dist/utils/json-schema.d.mts.map +1 -1
  156. package/dist/utils/json-schema.mjs +5 -78
  157. package/dist/utils/json-schema.mjs.map +1 -1
  158. package/dist/utils/process-env.cjs +14 -0
  159. package/dist/utils/process-env.cjs.map +1 -0
  160. package/dist/utils/process-env.d.cts +10 -0
  161. package/dist/utils/process-env.d.cts.map +1 -0
  162. package/dist/utils/process-env.d.mts +10 -0
  163. package/dist/utils/process-env.d.mts.map +1 -0
  164. package/dist/utils/process-env.mjs +13 -0
  165. package/dist/utils/process-env.mjs.map +1 -0
  166. package/dist/utils/random-id.cjs +13 -26
  167. package/dist/utils/random-id.cjs.map +1 -1
  168. package/dist/utils/random-id.d.cts +6 -3
  169. package/dist/utils/random-id.d.cts.map +1 -1
  170. package/dist/utils/random-id.d.mts +6 -3
  171. package/dist/utils/random-id.d.mts.map +1 -1
  172. package/dist/utils/random-id.mjs +14 -25
  173. package/dist/utils/random-id.mjs.map +1 -1
  174. package/package.json +8 -32
  175. package/scripts/verify-cjs-exports.cjs +1 -1
  176. package/src/__tests__/a2ui-envelope.test.ts +18 -13
  177. package/src/__tests__/a2ui-prompts.test.ts +47 -14
  178. package/src/__tests__/fixtures/prompt-goldens.json +354 -0
  179. package/src/__tests__/prompt-spec.test.ts +191 -0
  180. package/src/__tests__/root-entry-browser-safety.test.ts +5 -7
  181. package/src/__tests__/schema-render.test.ts +245 -0
  182. package/src/__tests__/standard-schema.test.ts +61 -101
  183. package/src/a2ui-envelope.ts +7 -6
  184. package/src/a2ui-prompts.ts +47 -96
  185. package/src/attachments/types.ts +1 -3
  186. package/src/finalize-events.ts +16 -0
  187. package/src/generative-ui/__tests__/render-ui-args.test.ts +7 -7
  188. package/src/generative-ui/__tests__/validate-operation.test.ts +19 -13
  189. package/src/generative-ui/basic-functions.ts +1 -1
  190. package/src/generative-ui/child-refs.ts +5 -4
  191. package/src/generative-ui/compact-schema.ts +277 -0
  192. package/src/generative-ui/index.ts +3 -0
  193. package/src/generative-ui/prompt-spec.ts +335 -0
  194. package/src/generative-ui/prompt.ts +25 -75
  195. package/src/generative-ui/render-ui-args.ts +3 -0
  196. package/src/generative-ui/schema-render.ts +377 -0
  197. package/src/generative-ui/types.ts +10 -7
  198. package/src/generative-ui/validate-operation.ts +2 -2
  199. package/src/index.ts +3 -16
  200. package/src/standard-schema.ts +24 -27
  201. package/src/telemetry/lambda-client.ts +8 -3
  202. package/src/telemetry/model-host.test.ts +2 -5
  203. package/src/telemetry/telemetry-disabled.ts +7 -12
  204. package/src/types/message.ts +1 -19
  205. package/src/utils/__tests__/errors.test.ts +44 -0
  206. package/src/utils/__tests__/json-schema.test.ts +3 -479
  207. package/src/utils/__tests__/process-env.test.ts +22 -0
  208. package/src/utils/__tests__/random-id.test.ts +37 -0
  209. package/src/utils/errors.ts +28 -85
  210. package/src/utils/index.ts +1 -2
  211. package/src/utils/inspector-visibility.test.ts +26 -0
  212. package/src/utils/inspector-visibility.ts +35 -3
  213. package/src/utils/json-schema.ts +5 -152
  214. package/src/utils/process-env.ts +14 -0
  215. package/src/utils/random-id.ts +17 -37
  216. package/tsconfig.json +3 -1
  217. package/tsdown.config.ts +2 -19
  218. package/dist/event-transforms/index.cjs +0 -15
  219. package/dist/event-transforms/index.d.cts +0 -4
  220. package/dist/event-transforms/index.d.mts +0 -4
  221. package/dist/event-transforms/index.mjs +0 -5
  222. package/dist/event-transforms/open-generative-ui-middleware.cjs +0 -286
  223. package/dist/event-transforms/open-generative-ui-middleware.cjs.map +0 -1
  224. package/dist/event-transforms/open-generative-ui-middleware.d.cts +0 -60
  225. package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +0 -1
  226. package/dist/event-transforms/open-generative-ui-middleware.d.mts +0 -60
  227. package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +0 -1
  228. package/dist/event-transforms/open-generative-ui-middleware.mjs +0 -283
  229. package/dist/event-transforms/open-generative-ui-middleware.mjs.map +0 -1
  230. package/dist/event-transforms/recorded-events.cjs +0 -59
  231. package/dist/event-transforms/recorded-events.cjs.map +0 -1
  232. package/dist/event-transforms/recorded-events.d.cts +0 -23
  233. package/dist/event-transforms/recorded-events.d.cts.map +0 -1
  234. package/dist/event-transforms/recorded-events.d.mts +0 -23
  235. package/dist/event-transforms/recorded-events.d.mts.map +0 -1
  236. package/dist/event-transforms/recorded-events.mjs +0 -58
  237. package/dist/event-transforms/recorded-events.mjs.map +0 -1
  238. package/dist/telemetry/events.d.cts +0 -72
  239. package/dist/telemetry/events.d.cts.map +0 -1
  240. package/dist/telemetry/events.d.mts +0 -72
  241. package/dist/telemetry/events.d.mts.map +0 -1
  242. package/dist/telemetry/index.cjs +0 -18
  243. package/dist/telemetry/index.d.cts +0 -5
  244. package/dist/telemetry/index.d.mts +0 -5
  245. package/dist/telemetry/index.mjs +0 -6
  246. package/dist/telemetry/telemetry-client.cjs +0 -165
  247. package/dist/telemetry/telemetry-client.cjs.map +0 -1
  248. package/dist/telemetry/telemetry-client.d.cts +0 -87
  249. package/dist/telemetry/telemetry-client.d.cts.map +0 -1
  250. package/dist/telemetry/telemetry-client.d.mts +0 -87
  251. package/dist/telemetry/telemetry-client.d.mts.map +0 -1
  252. package/dist/telemetry/telemetry-client.mjs +0 -164
  253. package/dist/telemetry/telemetry-client.mjs.map +0 -1
  254. package/dist/telemetry/utils.cjs +0 -14
  255. package/dist/telemetry/utils.cjs.map +0 -1
  256. package/dist/telemetry/utils.mjs +0 -13
  257. package/dist/telemetry/utils.mjs.map +0 -1
  258. package/dist/utils/conditions.cjs +0 -32
  259. package/dist/utils/conditions.cjs.map +0 -1
  260. package/dist/utils/conditions.d.cts +0 -31
  261. package/dist/utils/conditions.d.cts.map +0 -1
  262. package/dist/utils/conditions.d.mts +0 -31
  263. package/dist/utils/conditions.d.mts.map +0 -1
  264. package/dist/utils/conditions.mjs +0 -31
  265. package/dist/utils/conditions.mjs.map +0 -1
  266. package/dist/utils/console-styling.cjs +0 -91
  267. package/dist/utils/console-styling.cjs.map +0 -1
  268. package/dist/utils/console-styling.d.cts +0 -65
  269. package/dist/utils/console-styling.d.cts.map +0 -1
  270. package/dist/utils/console-styling.d.mts +0 -65
  271. package/dist/utils/console-styling.d.mts.map +0 -1
  272. package/dist/utils/console-styling.mjs +0 -85
  273. package/dist/utils/console-styling.mjs.map +0 -1
  274. package/src/__tests__/zod-regression.test.ts +0 -319
  275. package/src/event-transforms/index.ts +0 -5
  276. package/src/event-transforms/open-generative-ui-middleware.ts +0 -392
  277. package/src/event-transforms/recorded-events.test.ts +0 -166
  278. package/src/event-transforms/recorded-events.ts +0 -74
  279. package/src/telemetry/events.ts +0 -68
  280. package/src/telemetry/index.ts +0 -9
  281. package/src/telemetry/telemetry-blank-license-identity.test.ts +0 -128
  282. package/src/telemetry/telemetry-client.test.ts +0 -798
  283. package/src/telemetry/telemetry-client.ts +0 -328
  284. package/src/telemetry/utils.ts +0 -15
  285. package/src/utils/__tests__/conditions.test.ts +0 -161
  286. package/src/utils/conditions.ts +0 -116
  287. package/src/utils/console-styling.ts +0 -126
@@ -1,9 +0,0 @@
1
- export * from "./telemetry-client";
2
- export * from "./sampling";
3
- export {
4
- firstNonBlankTelemetryId,
5
- lambdaClient,
6
- parseTelemetryIdFromLicense,
7
- parseAndWarnTelemetryId,
8
- } from "./lambda-client";
9
- export type { LambdaSendOptions } from "./lambda-client";
@@ -1,128 +0,0 @@
1
- import { expect, test, vi } from "vitest";
2
- import { lambdaClient } from "./lambda-client";
3
- import { TelemetryClient } from "./telemetry-client";
4
-
5
- const { segmentTrackMock } = vi.hoisted(() => ({
6
- segmentTrackMock: vi.fn(),
7
- }));
8
-
9
- vi.mock("@segment/analytics-node", () => ({
10
- Analytics: class {
11
- track = segmentTrackMock;
12
- },
13
- }));
14
-
15
- const instanceCreatedEvent = {
16
- actionsAmount: 0,
17
- endpointTypes: [],
18
- endpointsAmount: 0,
19
- "cloud.api_key_provided": false,
20
- };
21
-
22
- /** Build the signature-agnostic legacy token shape used at this boundary. */
23
- function jwtWithTelemetryId(telemetryId: string): string {
24
- const payload = Buffer.from(
25
- JSON.stringify({ telemetry_id: telemetryId }),
26
- ).toString("base64url");
27
- return `header.${payload}.sig`;
28
- }
29
-
30
- /** Creates one isolated Shared telemetry capture with a fixed sampling decision. */
31
- function setupSharedCapture(randomValue: number, telemetryId: string = " \t ") {
32
- const priorSampleRate = process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE;
33
- delete process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE;
34
- segmentTrackMock.mockReset();
35
- const randomSpy = vi.spyOn(Math, "random").mockReturnValue(randomValue);
36
- const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => undefined);
37
- const client = new TelemetryClient({
38
- packageName: "@copilotkit/shared",
39
- packageVersion: "test",
40
- telemetryDisabled: false,
41
- sampleRate: 0.05,
42
- });
43
- client.setLicenseToken(jwtWithTelemetryId(telemetryId));
44
-
45
- return {
46
- client,
47
- randomSpy,
48
- teardown: () => {
49
- randomSpy.mockRestore();
50
- warnSpy.mockRestore();
51
- segmentTrackMock.mockReset();
52
- if (priorSampleRate === undefined) {
53
- delete process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE;
54
- } else {
55
- process.env.COPILOTKIT_TELEMETRY_SAMPLE_RATE = priorSampleRate;
56
- }
57
- },
58
- };
59
- }
60
-
61
- test("Shared whitespace-only legacy claim stays subject to the Segment gate", async () => {
62
- const sinkSpy = vi.spyOn(lambdaClient, "send").mockResolvedValue(undefined);
63
- const { client, randomSpy, teardown } = setupSharedCapture(0.99);
64
-
65
- try {
66
- await client.capture("oss.runtime.instance_created", instanceCreatedEvent);
67
-
68
- // An unusable claim must not buy identified status. The gate it now
69
- // fails is Segment's alone: the lambda copy goes either way, and what
70
- // proves the claim was rejected is that it goes marked anonymous.
71
- expect(randomSpy).toHaveBeenCalledTimes(1);
72
- expect(segmentTrackMock).not.toHaveBeenCalled();
73
- expect(sinkSpy.mock.calls[0][0].globalProperties).toMatchObject({
74
- telemetry_identified: false,
75
- });
76
- } finally {
77
- sinkSpy.mockRestore();
78
- teardown();
79
- }
80
- });
81
-
82
- test("Shared sampled whitespace-only legacy claim sends no identity header", async () => {
83
- const fetchSpy = vi
84
- .spyOn(globalThis, "fetch")
85
- .mockResolvedValue(new Response("", { status: 202 }));
86
- const { client, randomSpy, teardown } = setupSharedCapture(0);
87
-
88
- try {
89
- await client.capture("oss.runtime.instance_created", instanceCreatedEvent);
90
-
91
- expect(randomSpy).toHaveBeenCalledTimes(1);
92
- expect(fetchSpy).toHaveBeenCalledTimes(1);
93
- const request = fetchSpy.mock.calls[0]?.[1];
94
- expect(
95
- new Headers(request?.headers).get("X-CopilotKit-Telemetry-Id"),
96
- ).toBeNull();
97
- } finally {
98
- fetchSpy.mockRestore();
99
- teardown();
100
- }
101
- });
102
-
103
- test.each(["bad\nid", "bad\u0000id", "tenant-🚀"])(
104
- "Shared header-invalid legacy claim %j stays subject to the Segment gate",
105
- async (invalidTelemetryId) => {
106
- const sinkSpy = vi.spyOn(lambdaClient, "send").mockResolvedValue(undefined);
107
- const { client, randomSpy, teardown } = setupSharedCapture(
108
- 0.99,
109
- invalidTelemetryId,
110
- );
111
-
112
- try {
113
- await client.capture(
114
- "oss.runtime.instance_created",
115
- instanceCreatedEvent,
116
- );
117
-
118
- expect(randomSpy).toHaveBeenCalledTimes(1);
119
- expect(segmentTrackMock).not.toHaveBeenCalled();
120
- expect(sinkSpy.mock.calls[0][0].globalProperties).toMatchObject({
121
- telemetry_identified: false,
122
- });
123
- } finally {
124
- sinkSpy.mockRestore();
125
- teardown();
126
- }
127
- },
128
- );