@flexkit/agent-protocol 0.3.3 → 0.3.5

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.
package/dist/index.d.ts CHANGED
@@ -278,8 +278,28 @@ declare const dataPartSchema: z.ZodObject<{
278
278
  url: z.ZodString;
279
279
  }, z.core.$strip>>;
280
280
  messageId: z.ZodString;
281
+ monitorEvent: z.ZodOptional<z.ZodObject<{
282
+ description: z.ZodString;
283
+ events: z.ZodArray<z.ZodObject<{
284
+ createdAt: z.ZodString;
285
+ id: z.ZodString;
286
+ summary: z.ZodString;
287
+ }, z.core.$strip>>;
288
+ monitorId: z.ZodString;
289
+ total: z.ZodNumber;
290
+ }, z.core.$strip>>;
281
291
  text: z.ZodString;
282
292
  }, z.core.$strip>;
293
+ 'monitor-event': z.ZodObject<{
294
+ description: z.ZodString;
295
+ events: z.ZodArray<z.ZodObject<{
296
+ createdAt: z.ZodString;
297
+ id: z.ZodString;
298
+ summary: z.ZodString;
299
+ }, z.core.$strip>>;
300
+ monitorId: z.ZodString;
301
+ total: z.ZodNumber;
302
+ }, z.core.$strip>;
283
303
  }, z.core.$strip>;
284
304
  type DataPart = z.infer<typeof dataPartSchema>;
285
305
  type DataPartType = keyof DataPart;
@@ -291,9 +311,9 @@ type DataPartMessageType = `data-${DataPartType}`;
291
311
  /**
292
312
  * `approval_request`: a proposal waits on the recipient. `automation_result`: an
293
313
  * automation run finished and its notify rule asked for it. `automation_failure`:
294
- * an automation run failed.
314
+ * an automation run failed. `monitor_event`: a chat monitor woke the chat, or paused.
295
315
  */
296
- type ActivityItemKind = 'approval_request' | 'automation_result' | 'automation_failure';
316
+ type ActivityItemKind = 'approval_request' | 'automation_result' | 'automation_failure' | 'monitor_event';
297
317
  /** `done` = resolved by the system (e.g. the approval was decided); `dismissed` = hidden by the recipient. */
298
318
  type ActivityItemState = 'unread' | 'read' | 'done' | 'dismissed';
299
319
  type ActivityItemResolution = 'approved' | 'rejected' | 'expired' | 'cancelled';
@@ -396,6 +416,8 @@ interface AutomationProposalPreview {
396
416
  notifyCreator: boolean;
397
417
  notifyRule: AutomationNotifyRule;
398
418
  plugins: AutomationProposalPlugin[];
419
+ /** The description of the chat monitor this automation replaces; the monitor stops once it exists. */
420
+ replacesMonitor?: string;
399
421
  /** Run the automation once right after it is created (the approver can also choose this). */
400
422
  runOnceAfterCreate: boolean;
401
423
  skills: string[];
@@ -406,8 +428,27 @@ interface AutomationProposalPreview {
406
428
  triggers: string[];
407
429
  visibility: AutomationVisibility;
408
430
  }
431
+ /** One changed setting of an automation, in plain words. */
432
+ interface AutomationChangeField {
433
+ after: string;
434
+ before: string;
435
+ /** `name`, `instructions`, `triggers`, `enabled`, `notifyRule` or `mutationPolicy`. */
436
+ field: string;
437
+ label: string;
438
+ }
439
+ /**
440
+ * Extra context carried by `kind: 'automation'` approvals that change an
441
+ * existing automation: only the settings that change, before and after.
442
+ */
443
+ interface AutomationChangePreview {
444
+ automationId: string;
445
+ changes: AutomationChangeField[];
446
+ /** The automation's current name. */
447
+ name: string;
448
+ }
409
449
  interface AutomationApprovalPreview {
410
450
  automation?: AutomationProposalPreview;
451
+ automationChange?: AutomationChangePreview;
411
452
  operations: AutomationApprovalPreviewOperation[];
412
453
  schema?: SchemaChangePreviewSummary;
413
454
  }
@@ -509,16 +550,34 @@ interface AgentChatPart {
509
550
  /** `file` parts: public URL of a user attachment. */
510
551
  url?: string;
511
552
  }
553
+ /** Set on user-role messages the user did not write: `monitor_event` is a chat monitor's delivery. */
554
+ type AgentChatMessageKind = 'monitor_event';
512
555
  interface AgentChatMessage {
513
556
  createdAt: string;
514
557
  error: string | null;
515
558
  id: string;
559
+ /** May be absent from older API responses. */
560
+ kind?: AgentChatMessageKind | null;
516
561
  parts: AgentChatPart[] | null;
517
562
  role: AgentChatMessageRole;
518
563
  status: AgentChatMessageStatus;
519
564
  textContent: string;
520
565
  workflowRunId: string | null;
521
566
  }
567
+ type AgentMonitorStatus = 'active' | 'stopped' | 'expired' | 'completed' | 'paused_budget';
568
+ /** What a monitor watches: a long job, content changes, a polled query or a webhook. */
569
+ type AgentMonitorSourceType = 'job' | 'entity' | 'poll' | 'webhook';
570
+ /** A watcher the chat agent started; it wakes the chat when its job finishes. */
571
+ interface AgentChatMonitor {
572
+ createdAt: string;
573
+ description: string;
574
+ eventCount: number;
575
+ expiresAt: string;
576
+ id: string;
577
+ /** Absent from platforms that predate monitor sources. */
578
+ sourceType?: AgentMonitorSourceType;
579
+ status: AgentMonitorStatus;
580
+ }
522
581
  interface AgentChatTurn {
523
582
  assistantMessage: AgentChatMessage;
524
583
  userMessage: AgentChatMessage;
@@ -538,4 +597,4 @@ type AgentChatFollowUpResult = {
538
597
  turn: AgentChatTurn;
539
598
  };
540
599
 
541
- export { type ActivityItem, type ActivityItemKind, type ActivityItemResolution, type ActivityItemState, type ActivityItemsPage, type ActivitySummary, type AgentChat, type AgentChatAttachment, type AgentChatFollowUp, type AgentChatFollowUpDelivery, type AgentChatFollowUpResult, type AgentChatMessage, type AgentChatMessageRole, type AgentChatMessageStatus, type AgentChatPart, type AgentChatTurn, type AutomationApproval, type AutomationApprovalKind, type AutomationApprovalOperation, type AutomationApprovalPreview, type AutomationApprovalPreviewKind, type AutomationApprovalPreviewOperation, type AutomationApprovalPreviewRow, type AutomationApprovalStatus, type AutomationMutationPolicy, type AutomationNotifyRule, type AutomationProposalPlugin, type AutomationProposalPreview, type AutomationRun, type AutomationRunStatus, type AutomationToolAllowRule, type AutomationTriggerType, type AutomationVisibility, type CreatedAutomationResult, DATA_PART_TYPES, type DataPart, type DataPartMessageType, type DataPartType, type SchemaChangePreviewSummary, dataPartSchema, errorSchema, isDataPartType };
600
+ export { type ActivityItem, type ActivityItemKind, type ActivityItemResolution, type ActivityItemState, type ActivityItemsPage, type ActivitySummary, type AgentChat, type AgentChatAttachment, type AgentChatFollowUp, type AgentChatFollowUpDelivery, type AgentChatFollowUpResult, type AgentChatMessage, type AgentChatMessageKind, type AgentChatMessageRole, type AgentChatMessageStatus, type AgentChatMonitor, type AgentChatPart, type AgentChatTurn, type AgentMonitorSourceType, type AgentMonitorStatus, type AutomationApproval, type AutomationApprovalKind, type AutomationApprovalOperation, type AutomationApprovalPreview, type AutomationApprovalPreviewKind, type AutomationApprovalPreviewOperation, type AutomationApprovalPreviewRow, type AutomationApprovalStatus, type AutomationChangeField, type AutomationChangePreview, type AutomationMutationPolicy, type AutomationNotifyRule, type AutomationProposalPlugin, type AutomationProposalPreview, type AutomationRun, type AutomationRunStatus, type AutomationToolAllowRule, type AutomationTriggerType, type AutomationVisibility, type CreatedAutomationResult, DATA_PART_TYPES, type DataPart, type DataPartMessageType, type DataPartType, type SchemaChangePreviewSummary, dataPartSchema, errorSchema, isDataPartType };
package/dist/index.js CHANGED
@@ -3,6 +3,13 @@ import { z } from "zod";
3
3
  var errorSchema = z.object({
4
4
  message: z.string()
5
5
  });
6
+ var monitorEventSchema = z.object({
7
+ description: z.string(),
8
+ events: z.array(z.object({ createdAt: z.string(), id: z.string(), summary: z.string() })),
9
+ monitorId: z.string(),
10
+ /** Events this message carries, including any beyond the listed ones. */
11
+ total: z.number()
12
+ });
6
13
  var dataPartSchema = z.object({
7
14
  "plugin-connection": z.object({ pluginId: z.string(), connectionId: z.string().optional() }),
8
15
  /** Lifecycle of one plugin tool call, so the UI can name the in-flight call in its status line. */
@@ -161,15 +168,19 @@ var dataPartSchema = z.object({
161
168
  /**
162
169
  * A message the user sent while the turn was running, at the point in the
163
170
  * reply where the agent received it. The UI shows it there, in place of the
164
- * stored user message it refers to.
171
+ * stored user message it refers to. `monitorEvent` is set when a monitor,
172
+ * not the user, sent it.
165
173
  */
166
174
  "mid-turn-message": z.object({
167
175
  attachments: z.array(
168
176
  z.object({ filename: z.string(), mediaType: z.string(), sizeBytes: z.number(), url: z.string() })
169
177
  ),
170
178
  messageId: z.string(),
179
+ monitorEvent: monitorEventSchema.optional(),
171
180
  text: z.string()
172
- })
181
+ }),
182
+ /** Events a chat monitor delivered, on the `monitor_event` message that carries them. */
183
+ "monitor-event": monitorEventSchema
173
184
  });
174
185
  var DATA_PART_TYPES = Object.keys(dataPartSchema.shape);
175
186
  function isDataPartType(type) {
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/data-parts.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Custom `data-*` parts streamed by the Flexkit agent platform and rendered by\n * Studio. The server validates what it writes against these schemas and the\n * UI derives its part types from them, so the two can never drift.\n */\nexport const errorSchema = z.object({\n message: z.string(),\n});\n\nexport const dataPartSchema = z.object({\n 'plugin-connection': z.object({ pluginId: z.string(), connectionId: z.string().optional() }),\n /** Lifecycle of one plugin tool call, so the UI can name the in-flight call in its status line. */\n 'plugin-call': z.object({\n pluginId: z.string(),\n tool: z.string(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n /** Written when the chat history was summarized before or during a turn. */\n 'context-compaction': z.object({\n reason: z.enum(['threshold', 'context_length_error']),\n status: z.enum(['done']),\n summarizedMessageCount: z.number(),\n }),\n /** The agent's working plan; replaced in place as steps complete. */\n plan: z.object({\n explanation: z.string().optional(),\n steps: z.array(\n z.object({\n status: z.enum(['pending', 'in_progress', 'completed']),\n step: z.string(),\n })\n ),\n updatedAt: z.string(),\n }),\n /** A delegated subtask of an automation run. */\n subtask: z.object({\n error: errorSchema.optional(),\n resultPreview: z.string().optional(),\n status: z.enum(['running', 'done', 'error']),\n stepsUsed: z.number().optional(),\n subtaskId: z.string(),\n title: z.string(),\n }),\n /** json-render patch lines, extracted from the assistant text by the stream pipeline. */\n spec: z.union([\n z.object({\n type: z.literal('patch'),\n patch: z.unknown(),\n }),\n z.object({\n type: z.literal('flat'),\n spec: z.unknown(),\n }),\n z.object({\n type: z.literal('nested'),\n spec: z.unknown(),\n }),\n ]),\n 'create-sandbox': z.object({\n sandboxId: z.string().optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'generating-files': z.object({\n paths: z.array(z.string()),\n status: z.enum(['generating', 'uploading', 'uploaded', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'run-artifact': z.object({\n artifactId: z.string().optional(),\n contentType: z.string().optional(),\n error: errorSchema.optional(),\n filename: z.string(),\n kind: z.enum(['html', 'pdf']).optional(),\n sizeBytes: z.number().optional(),\n status: z.enum(['uploading', 'done', 'error']),\n /** Persistent public URL of the stored artifact. */\n url: z.string().optional(),\n }),\n 'run-command': z.object({\n sandboxId: z.string(),\n commandId: z.string().optional(),\n command: z.string(),\n args: z.array(z.string()),\n status: z.enum(['executing', 'running', 'waiting', 'done', 'error']),\n exitCode: z.number().optional(),\n error: errorSchema.optional(),\n }),\n 'search-schema': z.object({\n query: z.string().optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'web-search': z.object({\n query: z.string(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'tool-delivery': z.object({\n channelId: z.string(),\n channelName: z.string(),\n provider: z.enum(['slack', 'teams']),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'validate-graphql': z.object({\n status: z.enum(['loading', 'valid', 'invalid', 'error']),\n errorCount: z.number().optional(),\n error: errorSchema.optional(),\n }),\n 'execute-graphql': z.object({\n operationType: z.enum(['query', 'mutation']).optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n /** Emitted for proposals; the UI fetches the full proposal from the approvals API by id. */\n 'mutation-approval': z.object({\n approvalId: z.string(),\n affectedCount: z.number().nullable().optional(),\n decidedBy: z.string().optional(),\n operationsSummary: z.string(),\n reason: z.string().optional(),\n status: z.enum(['pending', 'approved', 'rejected', 'expired', 'cancelled', 'executed', 'error']),\n error: errorSchema.optional(),\n }),\n 'bulk-graphql-action': z.object({\n changedItems: z.number().optional(),\n failedItems: z.number().optional(),\n jobId: z.string().optional(),\n operationName: z.string(),\n processedItems: z.number().optional(),\n status: z.enum(['loading', 'running', 'done', 'error']),\n totalItems: z.number().optional(),\n error: errorSchema.optional(),\n }),\n 'update-memory': z.object({\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'load-skill': z.object({\n /** True for skills attached to the automation, injected at run start rather than loaded on demand. */\n attached: z.boolean().optional(),\n skillName: z.string().optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n /** Marker written by the run workflow for the trigger event so a run replays as a conversation. */\n 'user-message': z.object({\n parts: z.array(z.unknown()),\n }),\n /** Final report written by the run workflow when the agent finishes. */\n 'run-summary': z.object({\n status: z.enum(['success', 'skipped', 'failed']),\n summary: z.string(),\n }),\n /** A chat turn that ended with an error. */\n 'turn-error': z.object({\n message: z.string(),\n }),\n /** One follow-up instruction offered under a finished chat reply; clicking it fills the composer. */\n 'suggested-prompt': z.object({\n prompt: z.string(),\n }),\n /**\n * A message the user sent while the turn was running, at the point in the\n * reply where the agent received it. The UI shows it there, in place of the\n * stored user message it refers to.\n */\n 'mid-turn-message': z.object({\n attachments: z.array(\n z.object({ filename: z.string(), mediaType: z.string(), sizeBytes: z.number(), url: z.string() })\n ),\n messageId: z.string(),\n text: z.string(),\n }),\n});\n\nexport type DataPart = z.infer<typeof dataPartSchema>;\nexport type DataPartType = keyof DataPart;\n\nexport const DATA_PART_TYPES = Object.keys(dataPartSchema.shape) as DataPartType[];\n\nexport function isDataPartType(type: string): type is DataPartType {\n return (DATA_PART_TYPES as string[]).includes(type);\n}\n\n/** The `type` of a UI message part carrying this data part. */\nexport type DataPartMessageType = `data-${DataPartType}`;\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/data-parts.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Custom `data-*` parts streamed by the Flexkit agent platform and rendered by\n * Studio. The server validates what it writes against these schemas and the\n * UI derives its part types from them, so the two can never drift.\n */\nexport const errorSchema = z.object({\n message: z.string(),\n});\n\n/** A batch of one monitor's events as the chat card shows it; the model reads a text summary. */\nconst monitorEventSchema = z.object({\n description: z.string(),\n events: z.array(z.object({ createdAt: z.string(), id: z.string(), summary: z.string() })),\n monitorId: z.string(),\n /** Events this message carries, including any beyond the listed ones. */\n total: z.number(),\n});\n\nexport const dataPartSchema = z.object({\n 'plugin-connection': z.object({ pluginId: z.string(), connectionId: z.string().optional() }),\n /** Lifecycle of one plugin tool call, so the UI can name the in-flight call in its status line. */\n 'plugin-call': z.object({\n pluginId: z.string(),\n tool: z.string(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n /** Written when the chat history was summarized before or during a turn. */\n 'context-compaction': z.object({\n reason: z.enum(['threshold', 'context_length_error']),\n status: z.enum(['done']),\n summarizedMessageCount: z.number(),\n }),\n /** The agent's working plan; replaced in place as steps complete. */\n plan: z.object({\n explanation: z.string().optional(),\n steps: z.array(\n z.object({\n status: z.enum(['pending', 'in_progress', 'completed']),\n step: z.string(),\n })\n ),\n updatedAt: z.string(),\n }),\n /** A delegated subtask of an automation run. */\n subtask: z.object({\n error: errorSchema.optional(),\n resultPreview: z.string().optional(),\n status: z.enum(['running', 'done', 'error']),\n stepsUsed: z.number().optional(),\n subtaskId: z.string(),\n title: z.string(),\n }),\n /** json-render patch lines, extracted from the assistant text by the stream pipeline. */\n spec: z.union([\n z.object({\n type: z.literal('patch'),\n patch: z.unknown(),\n }),\n z.object({\n type: z.literal('flat'),\n spec: z.unknown(),\n }),\n z.object({\n type: z.literal('nested'),\n spec: z.unknown(),\n }),\n ]),\n 'create-sandbox': z.object({\n sandboxId: z.string().optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'generating-files': z.object({\n paths: z.array(z.string()),\n status: z.enum(['generating', 'uploading', 'uploaded', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'run-artifact': z.object({\n artifactId: z.string().optional(),\n contentType: z.string().optional(),\n error: errorSchema.optional(),\n filename: z.string(),\n kind: z.enum(['html', 'pdf']).optional(),\n sizeBytes: z.number().optional(),\n status: z.enum(['uploading', 'done', 'error']),\n /** Persistent public URL of the stored artifact. */\n url: z.string().optional(),\n }),\n 'run-command': z.object({\n sandboxId: z.string(),\n commandId: z.string().optional(),\n command: z.string(),\n args: z.array(z.string()),\n status: z.enum(['executing', 'running', 'waiting', 'done', 'error']),\n exitCode: z.number().optional(),\n error: errorSchema.optional(),\n }),\n 'search-schema': z.object({\n query: z.string().optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'web-search': z.object({\n query: z.string(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'tool-delivery': z.object({\n channelId: z.string(),\n channelName: z.string(),\n provider: z.enum(['slack', 'teams']),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'validate-graphql': z.object({\n status: z.enum(['loading', 'valid', 'invalid', 'error']),\n errorCount: z.number().optional(),\n error: errorSchema.optional(),\n }),\n 'execute-graphql': z.object({\n operationType: z.enum(['query', 'mutation']).optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n /** Emitted for proposals; the UI fetches the full proposal from the approvals API by id. */\n 'mutation-approval': z.object({\n approvalId: z.string(),\n affectedCount: z.number().nullable().optional(),\n decidedBy: z.string().optional(),\n operationsSummary: z.string(),\n reason: z.string().optional(),\n status: z.enum(['pending', 'approved', 'rejected', 'expired', 'cancelled', 'executed', 'error']),\n error: errorSchema.optional(),\n }),\n 'bulk-graphql-action': z.object({\n changedItems: z.number().optional(),\n failedItems: z.number().optional(),\n jobId: z.string().optional(),\n operationName: z.string(),\n processedItems: z.number().optional(),\n status: z.enum(['loading', 'running', 'done', 'error']),\n totalItems: z.number().optional(),\n error: errorSchema.optional(),\n }),\n 'update-memory': z.object({\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n 'load-skill': z.object({\n /** True for skills attached to the automation, injected at run start rather than loaded on demand. */\n attached: z.boolean().optional(),\n skillName: z.string().optional(),\n status: z.enum(['loading', 'done', 'error']),\n error: errorSchema.optional(),\n }),\n /** Marker written by the run workflow for the trigger event so a run replays as a conversation. */\n 'user-message': z.object({\n parts: z.array(z.unknown()),\n }),\n /** Final report written by the run workflow when the agent finishes. */\n 'run-summary': z.object({\n status: z.enum(['success', 'skipped', 'failed']),\n summary: z.string(),\n }),\n /** A chat turn that ended with an error. */\n 'turn-error': z.object({\n message: z.string(),\n }),\n /** One follow-up instruction offered under a finished chat reply; clicking it fills the composer. */\n 'suggested-prompt': z.object({\n prompt: z.string(),\n }),\n /**\n * A message the user sent while the turn was running, at the point in the\n * reply where the agent received it. The UI shows it there, in place of the\n * stored user message it refers to. `monitorEvent` is set when a monitor,\n * not the user, sent it.\n */\n 'mid-turn-message': z.object({\n attachments: z.array(\n z.object({ filename: z.string(), mediaType: z.string(), sizeBytes: z.number(), url: z.string() })\n ),\n messageId: z.string(),\n monitorEvent: monitorEventSchema.optional(),\n text: z.string(),\n }),\n /** Events a chat monitor delivered, on the `monitor_event` message that carries them. */\n 'monitor-event': monitorEventSchema,\n});\n\nexport type DataPart = z.infer<typeof dataPartSchema>;\nexport type DataPartType = keyof DataPart;\n\nexport const DATA_PART_TYPES = Object.keys(dataPartSchema.shape) as DataPartType[];\n\nexport function isDataPartType(type: string): type is DataPartType {\n return (DATA_PART_TYPES as string[]).includes(type);\n}\n\n/** The `type` of a UI message part carrying this data part. */\nexport type DataPartMessageType = `data-${DataPartType}`;\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@flexkit/agent-protocol",
3
- "version": "0.3.3",
3
+ "version": "0.3.5",
4
4
  "description": "Schemas and types shared between the Flexkit agent platform and its Studio UI: streamed data parts, run, approval and chat DTOs.",
5
5
  "keywords": [
6
6
  "flexkit",