@flexkit/agent-protocol 0.2.0 → 0.3.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.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @flexkit/agent-protocol
2
2
 
3
- Schemas and types shared between the Flexkit agent platform and the Studio UI (`@flexkit/ai`):
3
+ Schemas and types shared between the Flexkit agent platform and the Studio UI (`@flexkit/studio`):
4
4
 
5
5
  - `dataPartSchema`: the custom `data-*` parts the platform streams while a chat turn or automation run executes, as zod schemas. The server validates what it writes against them; the UI derives its part types from them.
6
6
  - Run, approval and chat DTO types returned by the automations and agent chat APIs.
package/dist/index.d.ts CHANGED
@@ -282,7 +282,7 @@ type DataPartMessageType = `data-${DataPartType}`;
282
282
  type AutomationRunStatus = 'running' | 'awaiting_approval' | 'success' | 'skipped' | 'failed' | 'cancelled';
283
283
  type AutomationTriggerType = 'entity' | 'manual' | 'schedule' | 'webhook';
284
284
  type AutomationApprovalStatus = 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled';
285
- type AutomationApprovalKind = 'graphql' | 'bulk' | 'plugin' | 'exec';
285
+ type AutomationApprovalKind = 'graphql' | 'bulk' | 'plugin' | 'exec' | 'schema';
286
286
  type AutomationApprovalPreviewKind = 'create' | 'update' | 'delete' | 'unknown';
287
287
  type AutomationMutationPolicy = 'require_approval' | 'auto_approve';
288
288
  interface AutomationApprovalOperation {
@@ -310,8 +310,17 @@ interface AutomationApprovalPreviewOperation {
310
310
  rows: AutomationApprovalPreviewRow[];
311
311
  truncated: boolean;
312
312
  }
313
+ /** Extra context carried by `kind: 'schema'` approvals (agent-proposed schema deployments). */
314
+ interface SchemaChangePreviewSummary {
315
+ /** One line per change, e.g. "Add Review (3 attributes)". */
316
+ summaryLines: string[];
317
+ /** Changes that lose access to data; the deployment was proposed with them acknowledged. */
318
+ breakingChanges: string[];
319
+ warnings: string[];
320
+ }
313
321
  interface AutomationApprovalPreview {
314
322
  operations: AutomationApprovalPreviewOperation[];
323
+ schema?: SchemaChangePreviewSummary;
315
324
  }
316
325
  interface AutomationApproval {
317
326
  affectedCount: number | null;
@@ -414,4 +423,4 @@ interface AgentChatTurn {
414
423
  workflowRunId: string;
415
424
  }
416
425
 
417
- export { type AgentChat, type AgentChatAttachment, 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 AutomationRun, type AutomationRunStatus, type AutomationToolAllowRule, type AutomationTriggerType, DATA_PART_TYPES, type DataPart, type DataPartMessageType, type DataPartType, dataPartSchema, errorSchema, isDataPartType };
426
+ export { type AgentChat, type AgentChatAttachment, 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 AutomationRun, type AutomationRunStatus, type AutomationToolAllowRule, type AutomationTriggerType, DATA_PART_TYPES, type DataPart, type DataPartMessageType, type DataPartType, type SchemaChangePreviewSummary, dataPartSchema, errorSchema, isDataPartType };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@flexkit/agent-protocol",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
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",