@meetsmore-oss/use-ai-server 1.6.0 → 1.8.0

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 (101) hide show
  1. package/dist/agents/AISDKAgent.d.ts +29 -6
  2. package/dist/agents/AISDKAgent.d.ts.map +1 -1
  3. package/dist/agents/AISDKAgent.maxSteps.test.d.ts +2 -0
  4. package/dist/agents/AISDKAgent.maxSteps.test.d.ts.map +1 -0
  5. package/dist/agents/toolApproval.d.ts.map +1 -1
  6. package/dist/agents/toolApproval.test.d.ts +2 -0
  7. package/dist/agents/toolApproval.test.d.ts.map +1 -0
  8. package/dist/agents/types.d.ts +5 -0
  9. package/dist/agents/types.d.ts.map +1 -1
  10. package/dist/index.d.ts +5 -1
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +1883 -276
  13. package/dist/instrumentation.d.ts +48 -2
  14. package/dist/instrumentation.d.ts.map +1 -1
  15. package/dist/instrumentation.test.d.ts +1 -1
  16. package/dist/mcp/RemoteMcpToolsProvider.d.ts +1 -1
  17. package/dist/server.d.ts +1 -0
  18. package/dist/server.d.ts.map +1 -1
  19. package/dist/span-processors.integration.test.d.ts +8 -0
  20. package/dist/span-processors.integration.test.d.ts.map +1 -0
  21. package/dist/src/agents/AISDKAgent.d.ts +29 -6
  22. package/dist/src/agents/AISDKAgent.d.ts.map +1 -1
  23. package/dist/src/agents/AISDKAgent.maxSteps.test.d.ts +2 -0
  24. package/dist/src/agents/AISDKAgent.maxSteps.test.d.ts.map +1 -0
  25. package/dist/src/agents/toolApproval.d.ts.map +1 -1
  26. package/dist/src/agents/toolApproval.test.d.ts +2 -0
  27. package/dist/src/agents/toolApproval.test.d.ts.map +1 -0
  28. package/dist/src/agents/types.d.ts +5 -0
  29. package/dist/src/agents/types.d.ts.map +1 -1
  30. package/dist/src/index.d.ts +5 -1
  31. package/dist/src/index.d.ts.map +1 -1
  32. package/dist/src/instrumentation.d.ts +48 -2
  33. package/dist/src/instrumentation.d.ts.map +1 -1
  34. package/dist/src/instrumentation.test.d.ts +1 -1
  35. package/dist/src/mcp/RemoteMcpToolsProvider.d.ts +1 -1
  36. package/dist/src/server.d.ts +1 -0
  37. package/dist/src/server.d.ts.map +1 -1
  38. package/dist/src/span-processors.integration.test.d.ts +8 -0
  39. package/dist/src/span-processors.integration.test.d.ts.map +1 -0
  40. package/dist/src/telemetry.d.ts +41 -0
  41. package/dist/src/telemetry.d.ts.map +1 -0
  42. package/dist/src/telemetry.test.d.ts +2 -0
  43. package/dist/src/telemetry.test.d.ts.map +1 -0
  44. package/dist/src/test-preload.d.ts +4 -0
  45. package/dist/src/test-preload.d.ts.map +1 -1
  46. package/dist/src/tools/defineServerTool.d.ts +54 -0
  47. package/dist/src/tools/defineServerTool.d.ts.map +1 -0
  48. package/dist/src/tools/defineServerTool.test.d.ts +2 -0
  49. package/dist/src/tools/defineServerTool.test.d.ts.map +1 -0
  50. package/dist/src/tools/index.d.ts +4 -0
  51. package/dist/src/tools/index.d.ts.map +1 -0
  52. package/dist/src/tools/serverToolExecutor.d.ts +20 -0
  53. package/dist/src/tools/serverToolExecutor.d.ts.map +1 -0
  54. package/dist/src/tools/serverToolExecutor.test.d.ts +2 -0
  55. package/dist/src/tools/serverToolExecutor.test.d.ts.map +1 -0
  56. package/dist/src/tools/types.d.ts +51 -0
  57. package/dist/src/tools/types.d.ts.map +1 -0
  58. package/dist/src/types.d.ts +36 -1
  59. package/dist/src/types.d.ts.map +1 -1
  60. package/dist/src/utils/index.d.ts +1 -1
  61. package/dist/src/utils/index.d.ts.map +1 -1
  62. package/dist/src/utils/toolConverter.d.ts.map +1 -1
  63. package/dist/src/utils/toolConverter.test.d.ts +2 -0
  64. package/dist/src/utils/toolConverter.test.d.ts.map +1 -0
  65. package/dist/src/utils/toolFilters.d.ts +16 -0
  66. package/dist/src/utils/toolFilters.d.ts.map +1 -1
  67. package/dist/src/utils/toolFilters.test.d.ts +2 -0
  68. package/dist/src/utils/toolFilters.test.d.ts.map +1 -0
  69. package/dist/telemetry.d.ts +41 -0
  70. package/dist/telemetry.d.ts.map +1 -0
  71. package/dist/telemetry.test.d.ts +2 -0
  72. package/dist/telemetry.test.d.ts.map +1 -0
  73. package/dist/test/test-utils.d.ts +1 -0
  74. package/dist/test/test-utils.d.ts.map +1 -1
  75. package/dist/test-preload.d.ts +4 -0
  76. package/dist/test-preload.d.ts.map +1 -1
  77. package/dist/tools/defineServerTool.d.ts +54 -0
  78. package/dist/tools/defineServerTool.d.ts.map +1 -0
  79. package/dist/tools/defineServerTool.test.d.ts +2 -0
  80. package/dist/tools/defineServerTool.test.d.ts.map +1 -0
  81. package/dist/tools/index.d.ts +4 -0
  82. package/dist/tools/index.d.ts.map +1 -0
  83. package/dist/tools/serverToolExecutor.d.ts +20 -0
  84. package/dist/tools/serverToolExecutor.d.ts.map +1 -0
  85. package/dist/tools/serverToolExecutor.test.d.ts +2 -0
  86. package/dist/tools/serverToolExecutor.test.d.ts.map +1 -0
  87. package/dist/tools/types.d.ts +51 -0
  88. package/dist/tools/types.d.ts.map +1 -0
  89. package/dist/tsconfig.tsbuildinfo +1 -1
  90. package/dist/types.d.ts +36 -1
  91. package/dist/types.d.ts.map +1 -1
  92. package/dist/utils/index.d.ts +1 -1
  93. package/dist/utils/index.d.ts.map +1 -1
  94. package/dist/utils/toolConverter.d.ts.map +1 -1
  95. package/dist/utils/toolConverter.test.d.ts +2 -0
  96. package/dist/utils/toolConverter.test.d.ts.map +1 -0
  97. package/dist/utils/toolFilters.d.ts +16 -0
  98. package/dist/utils/toolFilters.d.ts.map +1 -1
  99. package/dist/utils/toolFilters.test.d.ts +2 -0
  100. package/dist/utils/toolFilters.test.d.ts.map +1 -0
  101. package/package.json +5 -4
@@ -152,6 +152,20 @@ export interface AISDKAgentConfig {
152
152
  * @default 4096
153
153
  */
154
154
  maxOutputTokens?: number;
155
+ /**
156
+ * Temperature for model responses.
157
+ * Lower values (e.g., 0) make responses more deterministic.
158
+ * Higher values (e.g., 1) make responses more creative/random.
159
+ * Useful for testing where deterministic behavior is desired.
160
+ * @default undefined (uses model's default)
161
+ */
162
+ temperature?: number;
163
+ /**
164
+ * Maximum number of model step iterations per run.
165
+ * Each iteration performs one model invocation and may include tool calls.
166
+ * @default 10
167
+ */
168
+ maxSteps?: number;
155
169
  }
156
170
  /**
157
171
  * Agent implementation for AI SDK models (Anthropic, OpenAI, Google, etc.).
@@ -201,16 +215,17 @@ export declare class AISDKAgent implements Agent {
201
215
  private model;
202
216
  private name;
203
217
  private annotation?;
204
- private langfuse;
205
218
  private toolFilter?;
206
219
  private systemPrompt?;
207
220
  private cacheBreakpoint?;
208
221
  private maxOutputTokens;
222
+ private temperature?;
223
+ private maxSteps;
209
224
  constructor(config: AISDKAgentConfig);
210
225
  getName(): string;
211
226
  getAnnotation(): string | undefined;
212
227
  /**
213
- * Flushes pending Langfuse telemetry data.
228
+ * Flushes pending telemetry data (all registered span processors).
214
229
  * Useful for tests to ensure data is sent before querying.
215
230
  */
216
231
  flushTelemetry(): Promise<void>;
@@ -223,14 +238,22 @@ export declare class AISDKAgent implements Agent {
223
238
  */
224
239
  private resolveSystemPrompt;
225
240
  /**
226
- * Builds an array of system messages from config and runtime prompts.
227
- * Each prompt becomes a separate SystemModelMessage, preserving their distinct purposes.
241
+ * Builds an array of static system messages from config and runtime prompts.
242
+ * These are built once per run and remain constant across steps (cacheable prefix).
228
243
  *
229
244
  * @param configPrompt - Resolved system prompt from agent config (already resolved via resolveSystemPrompt)
230
- * @param runtimePrompt - System prompt from AgentInput (generated by server based on state)
245
+ * @param runtimePrompt - System prompt from AgentInput (static instructions from server)
231
246
  * @returns Array of SystemModelMessage objects, or undefined if both are empty
232
247
  */
233
- private buildSystemMessages;
248
+ private buildStaticSystemMessages;
249
+ /**
250
+ * Builds a dynamic state system message from the current session state.
251
+ * This is rebuilt each step to reflect state changes from tool executions (e.g., navigation).
252
+ *
253
+ * @param state - Current application state from session
254
+ * @returns A SystemModelMessage with the state, or undefined if no state
255
+ */
256
+ private buildStateMessage;
234
257
  /**
235
258
  * Filters tools using the configured filter function.
236
259
  * If no filter is configured, returns all tools.
@@ -1 +1 @@
1
- {"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,aAAa,EAA2D,MAAM,IAAI,CAAC;AAIpH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAuB/C,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAkBjF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC;IAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;IAEpC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,UAAW,YAAW,KAAK;IACtC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAoC;IACvD,OAAO,CAAC,YAAY,CAAC,CAA4C;IACjE,OAAO,CAAC,eAAe,CAAC,CAAoB;IAC5C,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,EAAE,gBAAgB;IAYpC,OAAO,IAAI,MAAM;IAIjB,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAyYxE;;;;;OAKG;YACW,mBAAmB;IAcjC;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,mBAAmB;IAoC3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAMpC;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAKlC;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAI9B;IAEX;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAWhD;IAEJ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAOtC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAM1B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAqC;IAEhF;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}
1
+ {"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=AISDKAgent.maxSteps.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AISDKAgent.maxSteps.test.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.maxSteps.test.ts"],"names":[],"mappings":""}
@@ -1 +1 @@
1
- {"version":3,"file":"toolApproval.d.ts","sourceRoot":"","sources":["../../../src/agents/toolApproval.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,UAAU,CAAC;AAKzE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzG;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAGlE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAIjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,YAAY,GAC3B,YAAY,CAsCd"}
1
+ {"version":3,"file":"toolApproval.d.ts","sourceRoot":"","sources":["../../../src/agents/toolApproval.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,UAAU,CAAC;AAKzE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzG;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAGlE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,YAAY,GAC3B,YAAY,CAsCd"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=toolApproval.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toolApproval.test.d.ts","sourceRoot":"","sources":["../../../src/agents/toolApproval.test.ts"],"names":[],"mappings":""}
@@ -157,5 +157,10 @@ export interface Agent {
157
157
  * ```
158
158
  */
159
159
  getAnnotation?(): string | undefined;
160
+ /**
161
+ * Flushes any pending telemetry data (e.g., Langfuse spans).
162
+ * Called during server shutdown to ensure all telemetry is persisted.
163
+ */
164
+ flushTelemetry?(): Promise<void>;
160
165
  }
161
166
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/types.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -5,6 +5,10 @@ export type { Agent, AgentInput, EventEmitter, AgentResult } from './agents';
5
5
  export { AISDKAgent, type AISDKAgentConfig, type MessageWithCacheContext, type CacheTtl, type CacheBreakpointResult, type CacheBreakpointFn } from './agents';
6
6
  export type { UseAIServerPlugin, MessageHandler } from './plugins';
7
7
  export { FeedbackPlugin } from './plugins';
8
+ export type { SpanProcessor } from './instrumentation';
8
9
  export { logger } from './logger';
9
- export { createClientToolExecutor, isRemoteTool, getToolAnnotations, createGlobFilter, and, or, not, } from './utils';
10
+ export { startRunSpan, flushTelemetry, type RunSpan } from './telemetry';
11
+ export { defineServerTool } from './tools';
12
+ export type { ServerToolConfig, ServerToolContext, ServerToolDefinition } from './tools';
13
+ export { createClientToolExecutor, isRemoteTool, isServerTool, getToolAnnotations, createGlobFilter, and, or, not, } from './utils';
10
14
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,QAAQ,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG9J,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,GAAG,EACH,EAAE,EACF,GAAG,GACJ,MAAM,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,QAAQ,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG9J,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGzF,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,GAAG,EACH,EAAE,EACF,GAAG,GACJ,MAAM,SAAS,CAAC"}