@epilot/sdk 2.9.2 → 2.9.4

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 (147) hide show
  1. package/definitions/ai-agents-runtime.json +1 -1
  2. package/definitions/ai-agents.json +971 -98
  3. package/definitions/snapshot.json +3 -34
  4. package/definitions/workflow-runtime.json +1 -1
  5. package/definitions/workflow.json +445 -60
  6. package/dist/ai-agents-D6C5TXLD.cjs +7 -0
  7. package/dist/ai-agents-Y6PH53PH.js +7 -0
  8. package/dist/{ai-agents-runtime-25YRUJHI.js → ai-agents-runtime-EA23HCCP.js} +1 -1
  9. package/dist/{ai-agents-runtime-TILIO3UM.cjs → ai-agents-runtime-WZ3EI3NH.cjs} +2 -2
  10. package/dist/{ai-agents.d-CC5IjXrs.d.cts → ai-agents.d-D-7bTH-9.d.cts} +506 -5
  11. package/dist/{ai-agents.d-CC5IjXrs.d.ts → ai-agents.d-D-7bTH-9.d.ts} +506 -5
  12. package/dist/apis/access-token.cjs +6 -6
  13. package/dist/apis/access-token.js +1 -1
  14. package/dist/apis/address-suggestions.cjs +6 -6
  15. package/dist/apis/address-suggestions.js +1 -1
  16. package/dist/apis/address.cjs +6 -6
  17. package/dist/apis/address.js +1 -1
  18. package/dist/apis/ai-agents.cjs +8 -8
  19. package/dist/apis/ai-agents.d.cts +2 -2
  20. package/dist/apis/ai-agents.d.ts +2 -2
  21. package/dist/apis/ai-agents.js +2 -2
  22. package/dist/apis/app.cjs +6 -6
  23. package/dist/apis/app.js +1 -1
  24. package/dist/apis/audit-logs.cjs +6 -6
  25. package/dist/apis/audit-logs.js +1 -1
  26. package/dist/apis/automation.cjs +6 -6
  27. package/dist/apis/automation.js +1 -1
  28. package/dist/apis/billing.cjs +6 -6
  29. package/dist/apis/billing.js +1 -1
  30. package/dist/apis/blueprint-manifest.cjs +6 -6
  31. package/dist/apis/blueprint-manifest.js +1 -1
  32. package/dist/apis/calendar.cjs +6 -6
  33. package/dist/apis/calendar.js +1 -1
  34. package/dist/apis/configuration-hub.cjs +6 -6
  35. package/dist/apis/configuration-hub.js +1 -1
  36. package/dist/apis/consent.cjs +6 -6
  37. package/dist/apis/consent.js +1 -1
  38. package/dist/apis/customer-portal.cjs +6 -6
  39. package/dist/apis/customer-portal.js +1 -1
  40. package/dist/apis/dashboard.cjs +6 -6
  41. package/dist/apis/dashboard.js +1 -1
  42. package/dist/apis/data-governance.cjs +6 -6
  43. package/dist/apis/data-governance.js +1 -1
  44. package/dist/apis/deduplication.cjs +6 -6
  45. package/dist/apis/deduplication.js +1 -1
  46. package/dist/apis/design.cjs +6 -6
  47. package/dist/apis/design.js +1 -1
  48. package/dist/apis/document.cjs +6 -6
  49. package/dist/apis/document.js +1 -1
  50. package/dist/apis/email-settings.cjs +6 -6
  51. package/dist/apis/email-settings.js +1 -1
  52. package/dist/apis/email-template.cjs +6 -6
  53. package/dist/apis/email-template.js +1 -1
  54. package/dist/apis/entity-mapping.cjs +6 -6
  55. package/dist/apis/entity-mapping.js +1 -1
  56. package/dist/apis/entity.cjs +6 -6
  57. package/dist/apis/entity.js +1 -1
  58. package/dist/apis/environments.cjs +6 -6
  59. package/dist/apis/environments.js +1 -1
  60. package/dist/apis/event-catalog.cjs +6 -6
  61. package/dist/apis/event-catalog.js +1 -1
  62. package/dist/apis/file.cjs +6 -6
  63. package/dist/apis/file.js +1 -1
  64. package/dist/apis/iban.cjs +6 -6
  65. package/dist/apis/iban.js +1 -1
  66. package/dist/apis/integration-toolkit.cjs +6 -6
  67. package/dist/apis/integration-toolkit.js +1 -1
  68. package/dist/apis/journey.cjs +6 -6
  69. package/dist/apis/journey.js +1 -1
  70. package/dist/apis/kanban.cjs +6 -6
  71. package/dist/apis/kanban.js +1 -1
  72. package/dist/apis/message.cjs +6 -6
  73. package/dist/apis/message.js +1 -1
  74. package/dist/apis/metering.cjs +6 -6
  75. package/dist/apis/metering.js +1 -1
  76. package/dist/apis/notes.cjs +6 -6
  77. package/dist/apis/notes.js +1 -1
  78. package/dist/apis/notification.cjs +6 -6
  79. package/dist/apis/notification.js +1 -1
  80. package/dist/apis/organization.cjs +6 -6
  81. package/dist/apis/organization.js +1 -1
  82. package/dist/apis/partner-directory.cjs +6 -6
  83. package/dist/apis/partner-directory.js +1 -1
  84. package/dist/apis/permissions.cjs +6 -6
  85. package/dist/apis/permissions.js +1 -1
  86. package/dist/apis/pricing-tier.cjs +6 -6
  87. package/dist/apis/pricing-tier.js +1 -1
  88. package/dist/apis/pricing.cjs +6 -6
  89. package/dist/apis/pricing.js +1 -1
  90. package/dist/apis/purpose.cjs +6 -6
  91. package/dist/apis/purpose.js +1 -1
  92. package/dist/apis/query.cjs +6 -6
  93. package/dist/apis/query.js +1 -1
  94. package/dist/apis/sandbox.cjs +6 -6
  95. package/dist/apis/sandbox.js +1 -1
  96. package/dist/apis/sharing.cjs +6 -6
  97. package/dist/apis/sharing.js +1 -1
  98. package/dist/apis/snapshot.cjs +6 -6
  99. package/dist/apis/snapshot.js +1 -1
  100. package/dist/apis/submission.cjs +6 -6
  101. package/dist/apis/submission.js +1 -1
  102. package/dist/apis/target.cjs +6 -6
  103. package/dist/apis/target.js +1 -1
  104. package/dist/apis/targeting.cjs +6 -6
  105. package/dist/apis/targeting.js +1 -1
  106. package/dist/apis/template-variables.cjs +6 -6
  107. package/dist/apis/template-variables.js +1 -1
  108. package/dist/apis/user.cjs +6 -6
  109. package/dist/apis/user.js +1 -1
  110. package/dist/apis/validation-rules.cjs +6 -6
  111. package/dist/apis/validation-rules.js +1 -1
  112. package/dist/apis/webhooks.cjs +6 -6
  113. package/dist/apis/webhooks.js +1 -1
  114. package/dist/apis/workflow-definition.cjs +6 -6
  115. package/dist/apis/workflow-definition.js +1 -1
  116. package/dist/apis/workflow.cjs +8 -8
  117. package/dist/apis/workflow.d.cts +2 -2
  118. package/dist/apis/workflow.d.ts +2 -2
  119. package/dist/apis/workflow.js +2 -2
  120. package/dist/{chunk-KQKBSWGI.js → chunk-522LYPPW.js} +1 -1
  121. package/dist/chunk-BRWY3QHG.js +14 -0
  122. package/dist/{chunk-C3YPYVHI.js → chunk-J4ZE3ANW.js} +4 -4
  123. package/dist/{chunk-7EJWSCI2.cjs → chunk-LNVAFYGS.cjs} +4 -4
  124. package/dist/{chunk-QNZPOA54.cjs → chunk-PM25LLET.cjs} +1 -1
  125. package/dist/chunk-YEBEA6XU.cjs +14 -0
  126. package/dist/index.cjs +12 -12
  127. package/dist/index.d.cts +2 -2
  128. package/dist/index.d.ts +2 -2
  129. package/dist/index.js +3 -3
  130. package/dist/js-yaml-DLCVPJ7G.js +0 -0
  131. package/dist/workflow-7OU2YEEI.cjs +7 -0
  132. package/dist/workflow-IVKCWS44.js +7 -0
  133. package/dist/{workflow-runtime-DNTQDYPQ.js → workflow-runtime-L5HMFISV.js} +1 -1
  134. package/dist/{workflow-runtime-VKFESVFX.cjs → workflow-runtime-LMGACZP4.cjs} +2 -2
  135. package/dist/{workflow.d-CMSKt8oN.d.cts → workflow.d-eFv0ecBi.d.cts} +745 -81
  136. package/dist/{workflow.d-CMSKt8oN.d.ts → workflow.d-eFv0ecBi.d.ts} +745 -81
  137. package/docs/ai-agents.md +641 -23
  138. package/docs/workflow.md +247 -47
  139. package/package.json +11 -12
  140. package/definitions/focus-pocus-runtime.json +0 -1
  141. package/definitions/focus-pocus.json +0 -757
  142. package/dist/ai-agents-IZWFEUSH.js +0 -7
  143. package/dist/ai-agents-PWHKNRCX.cjs +0 -7
  144. package/dist/chunk-FARDEGPH.cjs +0 -14
  145. package/dist/chunk-JENQHXFI.js +0 -14
  146. package/dist/workflow-3WBD74WR.js +0 -7
  147. package/dist/workflow-WIUZ5TOX.cjs +0 -7
@@ -38,6 +38,7 @@ declare namespace Components {
38
38
  * Where the skill/agent is available:
39
39
  * - flows: Available in workflow automations
40
40
  * - copilot: Available as a sub-agent in copilot
41
+ * - portals: Available in end-user self-service portals
41
42
  * - all: Available everywhere
42
43
  *
43
44
  */
@@ -132,6 +133,80 @@ declare namespace Components {
132
133
  * Optional reason for approval
133
134
  */
134
135
  reason?: string;
136
+ /**
137
+ * For batch approval - list of action IDs to approve. If not provided, all actions are approved.
138
+ */
139
+ approved_action_ids?: string[];
140
+ /**
141
+ * For batch approval - list of action IDs to reject. Actions not in approved_action_ids are implicitly rejected.
142
+ */
143
+ rejected_action_ids?: string[];
144
+ /**
145
+ * For `partnering.proposeAssignment` approvals. `primary_only` (default) shares only the primary entity; `primary_and_relations` also shares every entity in the proposal's `related_entities` as a child of the primary. Ignored by other tools.
146
+ *
147
+ */
148
+ share_scope?: "primary_only" | "primary_and_relations";
149
+ }
150
+ export interface ChatMessage {
151
+ role: "user" | "assistant" | "tool" | "system";
152
+ content: string;
153
+ tool_calls?: {
154
+ id?: string;
155
+ name?: string;
156
+ input?: {
157
+ [key: string]: any;
158
+ };
159
+ output?: string;
160
+ }[];
161
+ }
162
+ export interface ChatRequest {
163
+ /**
164
+ * Agent ID to chat with
165
+ */
166
+ agentId: string;
167
+ /**
168
+ * User message
169
+ */
170
+ message: string;
171
+ /**
172
+ * Conversation ID for server-side memory. If provided, loads history from DynamoDB.
173
+ */
174
+ conversationId?: string; // uuid
175
+ /**
176
+ * Client-provided message history (overrides server-side memory)
177
+ */
178
+ clientHistory?: ChatMessage[];
179
+ context?: {
180
+ entityId?: string;
181
+ customData?: {
182
+ [name: string]: any;
183
+ };
184
+ };
185
+ streaming?: StreamingOptions;
186
+ }
187
+ export interface ConversationItem {
188
+ conversation_id?: string; // uuid
189
+ user_id?: string;
190
+ agent_id?: string;
191
+ title?: string;
192
+ message_count?: number;
193
+ /**
194
+ * Preview of the last message
195
+ */
196
+ last_message?: string;
197
+ last_message_at?: string; // date-time
198
+ context?: {
199
+ entityId?: string;
200
+ customData?: {
201
+ [key: string]: any;
202
+ };
203
+ };
204
+ created_at?: string; // date-time
205
+ updated_at?: string; // date-time
206
+ }
207
+ export interface ConversationWithMessages {
208
+ conversation?: ConversationItem;
209
+ messages?: MessageItem[];
135
210
  }
136
211
  export interface CreateAgentRequest {
137
212
  /**
@@ -319,6 +394,15 @@ declare namespace Components {
319
394
  tokens_used?: number;
320
395
  latency_ms?: number;
321
396
  }
397
+ export interface ExecutionIterationProjection {
398
+ index?: number;
399
+ /**
400
+ * Tool id the iteration invoked, or null for a non-tool step
401
+ */
402
+ tool?: string | null;
403
+ status?: "running" | "completed";
404
+ timestamp?: string; // date-time
405
+ }
322
406
  export interface ExecutionMetrics {
323
407
  total_tokens?: number;
324
408
  input_tokens?: number;
@@ -397,6 +481,18 @@ declare namespace Components {
397
481
  metrics?: ExecutionMetrics;
398
482
  started_at?: string; // date-time
399
483
  completed_at?: string | null; // date-time
484
+ /**
485
+ * Slim, labels-only step-progress projection of the ReAct iterations (empty for direct mode). Exposes only index, tool, status, and timestamp — raw thought, action input, and observation are intentionally excluded.
486
+ */
487
+ iterations?: ExecutionIterationProjection[];
488
+ }
489
+ export interface ExecutionResult {
490
+ response?: string;
491
+ structured_output?: {
492
+ [key: string]: any;
493
+ };
494
+ status?: "completed" | "failed" | "max_iterations" | "rejected";
495
+ metrics?: ExecutionMetrics;
400
496
  }
401
497
  export type ExecutionStatus = "pending" | "running" | "waiting_approval" | "completed" | "failed" | "cancelled";
402
498
  export interface ExecutionTrace {
@@ -432,6 +528,7 @@ declare namespace Components {
432
528
  * - taxonomy: Taxonomy selector (fetches from Taxonomy API)
433
529
  * - taxonomy-classification: Classification selector (requires dependsOn)
434
530
  * - shared-inbox: Shared inbox selector (fetches from Email Settings API)
531
+ * - matching-criteria: Criteria editor for mapping compared fields between two contexts or entities
435
532
  *
436
533
  */
437
534
  ParameterType;
@@ -489,6 +586,10 @@ declare namespace Components {
489
586
  * Filter to specific attribute types (for entity-attribute)
490
587
  */
491
588
  attributeTypeFilter?: string[];
589
+ /**
590
+ * Whether to hide the parameter from the UI
591
+ */
592
+ hidden?: boolean;
492
593
  }
493
594
  /**
494
595
  * example:
@@ -544,10 +645,40 @@ declare namespace Components {
544
645
  agents?: AgentDefinition[];
545
646
  next_cursor?: string | null;
546
647
  }
648
+ export interface ListConversationsResponse {
649
+ conversations?: ConversationItem[];
650
+ next_cursor?: string | null;
651
+ }
547
652
  export interface ListExecutionsResponse {
548
653
  executions?: ExecutionResponse[];
549
654
  next_cursor?: string | null;
550
655
  }
656
+ export interface MessageFeedback {
657
+ rating: "up" | "down";
658
+ comment?: string;
659
+ user_id: string;
660
+ submitted_at: string; // date-time
661
+ }
662
+ export interface MessageItem {
663
+ conversation_id?: string; // uuid
664
+ role?: "user" | "assistant" | "tool" | "system";
665
+ content?: string;
666
+ timestamp?: string; // date-time
667
+ tool_calls?: {
668
+ id?: string;
669
+ name?: string;
670
+ input?: {
671
+ [key: string]: any;
672
+ };
673
+ output?: string;
674
+ }[];
675
+ token_count?: number;
676
+ /**
677
+ * Langfuse trace id for the turn (assistant messages only)
678
+ */
679
+ trace_id?: string; // uuid
680
+ feedback?: MessageFeedback;
681
+ }
551
682
  export interface ModelConfig {
552
683
  /**
553
684
  * AWS Bedrock model ID
@@ -555,6 +686,14 @@ declare namespace Components {
555
686
  model_id?: string;
556
687
  temperature?: number;
557
688
  max_tokens?: number;
689
+ /**
690
+ * Enable extended thinking/reasoning for the model
691
+ */
692
+ thinking?: boolean;
693
+ /**
694
+ * Token budget for extended thinking (only used when thinking is enabled)
695
+ */
696
+ thinking_budget?: number;
558
697
  }
559
698
  /**
560
699
  * Base types:
@@ -571,9 +710,10 @@ declare namespace Components {
571
710
  * - taxonomy: Taxonomy selector (fetches from Taxonomy API)
572
711
  * - taxonomy-classification: Classification selector (requires dependsOn)
573
712
  * - shared-inbox: Shared inbox selector (fetches from Email Settings API)
713
+ * - matching-criteria: Criteria editor for mapping compared fields between two contexts or entities
574
714
  *
575
715
  */
576
- export type ParameterType = "text" | "textarea" | "number" | "boolean" | "select" | "entity-schema" | "entity-attribute" | "entity-id" | "taxonomy" | "taxonomy-classification" | "shared-inbox" | "label";
716
+ export type ParameterType = "text" | "textarea" | "number" | "boolean" | "select" | "entity-schema" | "entity-attribute" | "entity-id" | "taxonomy" | "taxonomy-classification" | "shared-inbox" | "label" | "matching-criteria";
577
717
  /**
578
718
  * Action waiting for approval (when status=waiting_approval)
579
719
  */
@@ -597,7 +737,7 @@ declare namespace Components {
597
737
  /**
598
738
  * Type of action being previewed
599
739
  */
600
- export type PreviewActionType = "move" | "create" | "update" | "delete" | "apply" | "send" | "link" | "unlink";
740
+ export type PreviewActionType = "move" | "create" | "update" | "delete" | "apply" | "send" | "link" | "unlink" | "batch_approval";
601
741
  /**
602
742
  * A single field change in the preview
603
743
  */
@@ -689,11 +829,78 @@ declare namespace Components {
689
829
  * Where the skill/agent is available:
690
830
  * - flows: Available in workflow automations
691
831
  * - copilot: Available as a sub-agent in copilot
832
+ * - portals: Available in end-user self-service portals
692
833
  * - all: Available everywhere
693
834
  *
694
835
  */
695
- export type SkillAvailability = "flows" | "copilot" | "all";
836
+ export type SkillAvailability = "flows" | "copilot" | "portals" | "all";
696
837
  export type SkillCategory = "message" | "entity" | "document" | "classification" | "custom";
838
+ /**
839
+ * Server-Sent Event for streaming responses
840
+ */
841
+ export interface StreamEvent {
842
+ type?: "token" | "agent_step" | "tool_call" | "tool_result" | "complete" | "error" | "metadata" | "needs_approval";
843
+ /**
844
+ * Token content (for token events)
845
+ */
846
+ content?: string;
847
+ /**
848
+ * Token index (for token events)
849
+ */
850
+ index?: number;
851
+ /**
852
+ * Tool name (for tool events)
853
+ */
854
+ tool?: string;
855
+ /**
856
+ * Tool input (for tool_call events)
857
+ */
858
+ input?: {
859
+ [key: string]: any;
860
+ };
861
+ /**
862
+ * Tool output (for tool_result events)
863
+ */
864
+ output?: string;
865
+ /**
866
+ * Tool call ID
867
+ */
868
+ callId?: string;
869
+ result?: ExecutionResult;
870
+ error?: {
871
+ code?: string;
872
+ message?: string;
873
+ };
874
+ /**
875
+ * Conversation ID (included in complete events)
876
+ */
877
+ conversationId?: string; // uuid
878
+ }
879
+ export interface StreamingOptions {
880
+ /**
881
+ * Stream mode - updates for step-based, messages for token-based
882
+ */
883
+ mode?: "updates" | "messages";
884
+ /**
885
+ * Enable token-level streaming
886
+ */
887
+ streamTokens?: boolean;
888
+ /**
889
+ * Include metadata events
890
+ */
891
+ includeMetadata?: boolean;
892
+ }
893
+ export interface SubmitFeedbackRequest {
894
+ /**
895
+ * Langfuse trace id of the assistant turn being rated
896
+ */
897
+ trace_id: string; // uuid
898
+ rating: "up" | "down";
899
+ /**
900
+ * Optional free-text feedback
901
+ */
902
+ comment?: string;
903
+ }
697
904
  export interface ToolDefinition {
698
905
  /**
699
906
  * example:
@@ -709,7 +916,7 @@ declare namespace Components {
709
916
  * Description for LLM to understand tool purpose
710
917
  */
711
918
  description?: string;
712
- category?: "entity" | "email" | "taxonomy" | "rag" | "workflow";
919
+ category?: "entity" | "message" | "taxonomy" | "rag" | "workflow";
713
920
  /**
714
921
  * JSON Schema for tool input
715
922
  */
@@ -853,6 +1060,14 @@ declare namespace Paths {
853
1060
  export type $404 = Components.Schemas.Error;
854
1061
  }
855
1062
  }
1063
+ namespace Chat {
1064
+ export type RequestBody = Components.Schemas.ChatRequest;
1065
+ namespace Responses {
1066
+ export type $200 = /* Server-Sent Event for streaming responses */ Components.Schemas.StreamEvent;
1067
+ export type $400 = Components.Schemas.Error;
1068
+ export type $404 = Components.Schemas.Error;
1069
+ }
1070
+ }
856
1071
  namespace CreateAgent {
857
1072
  export type RequestBody = Components.Schemas.CreateAgentRequest;
858
1073
  namespace Responses {
@@ -881,6 +1096,19 @@ declare namespace Paths {
881
1096
  export type $400 = Components.Schemas.Error;
882
1097
  }
883
1098
  }
1099
+ namespace DeleteConversation {
1100
+ namespace Parameters {
1101
+ export type ConversationId = string; // uuid
1102
+ }
1103
+ export interface PathParameters {
1104
+ conversation_id: Parameters.ConversationId /* uuid */;
1105
+ }
1106
+ namespace Responses {
1107
+ export interface $204 {
1108
+ }
1109
+ export type $404 = Components.Schemas.Error;
1110
+ }
1111
+ }
884
1112
  namespace ExecuteAgent {
885
1113
  namespace Parameters {
886
1114
  export type AgentId = /**
@@ -903,6 +1131,28 @@ declare namespace Paths {
903
1131
  export type $404 = Components.Schemas.Error;
904
1132
  }
905
1133
  }
1134
+ namespace ExecuteAgentStream {
1135
+ namespace Parameters {
1136
+ export type AgentId = /**
1137
+ * Agent identifier. Can be either:
1138
+ * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
1139
+ * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
1140
+ *
1141
+ * example:
1142
+ * skill:email-categorizer
1143
+ */
1144
+ Components.Schemas.AgentId;
1145
+ }
1146
+ export interface PathParameters {
1147
+ agent_id: Parameters.AgentId;
1148
+ }
1149
+ export type RequestBody = Components.Schemas.ExecuteAgentRequest;
1150
+ namespace Responses {
1151
+ export type $200 = /* Server-Sent Event for streaming responses */ Components.Schemas.StreamEvent;
1152
+ export type $400 = Components.Schemas.Error;
1153
+ export type $404 = Components.Schemas.Error;
1154
+ }
1155
+ }
906
1156
  namespace GetAgentById {
907
1157
  namespace Parameters {
908
1158
  export type AgentId = /**
@@ -923,6 +1173,22 @@ declare namespace Paths {
923
1173
  export type $400 = Components.Schemas.Error;
924
1174
  }
925
1175
  }
1176
+ namespace GetConversation {
1177
+ namespace Parameters {
1178
+ export type ConversationId = string; // uuid
1179
+ export type MessageLimit = number;
1180
+ }
1181
+ export interface PathParameters {
1182
+ conversation_id: Parameters.ConversationId /* uuid */;
1183
+ }
1184
+ export interface QueryParameters {
1185
+ message_limit?: Parameters.MessageLimit;
1186
+ }
1187
+ namespace Responses {
1188
+ export type $200 = Components.Schemas.ConversationWithMessages;
1189
+ export type $404 = Components.Schemas.Error;
1190
+ }
1191
+ }
926
1192
  namespace GetExecution {
927
1193
  namespace Parameters {
928
1194
  export type ExecutionId = string; // uuid
@@ -953,6 +1219,7 @@ declare namespace Paths {
953
1219
  * Where the skill/agent is available:
954
1220
  * - flows: Available in workflow automations
955
1221
  * - copilot: Available as a sub-agent in copilot
1222
+ * - portals: Available in end-user self-service portals
956
1223
  * - all: Available everywhere
957
1224
  *
958
1225
  */
@@ -975,6 +1242,22 @@ declare namespace Paths {
975
1242
  export type $400 = Components.Schemas.Error;
976
1243
  }
977
1244
  }
1245
+ namespace ListConversations {
1246
+ namespace Parameters {
1247
+ export type AgentId = string;
1248
+ export type Cursor = string;
1249
+ export type Limit = number;
1250
+ }
1251
+ export interface QueryParameters {
1252
+ agent_id?: Parameters.AgentId;
1253
+ limit?: Parameters.Limit;
1254
+ cursor?: Parameters.Cursor;
1255
+ }
1256
+ namespace Responses {
1257
+ export type $200 = Components.Schemas.ListConversationsResponse;
1258
+ export type $400 = Components.Schemas.Error;
1259
+ }
1260
+ }
978
1261
  namespace ListExecutions {
979
1262
  namespace Parameters {
980
1263
  export type AgentId = string;
@@ -1005,6 +1288,38 @@ declare namespace Paths {
1005
1288
  export type $404 = Components.Schemas.Error;
1006
1289
  }
1007
1290
  }
1291
+ namespace StreamExecution {
1292
+ namespace Parameters {
1293
+ export type ExecutionId = string; // uuid
1294
+ export type FromSequence = number;
1295
+ }
1296
+ export interface PathParameters {
1297
+ execution_id: Parameters.ExecutionId /* uuid */;
1298
+ }
1299
+ export interface QueryParameters {
1300
+ from_sequence?: Parameters.FromSequence;
1301
+ }
1302
+ namespace Responses {
1303
+ export type $200 = /* Server-Sent Event for streaming responses */ Components.Schemas.StreamEvent;
1304
+ export type $404 = Components.Schemas.Error;
1305
+ }
1306
+ }
1307
+ namespace SubmitConversationFeedback {
1308
+ namespace Parameters {
1309
+ export type ConversationId = string; // uuid
1310
+ }
1311
+ export interface PathParameters {
1312
+ conversation_id: Parameters.ConversationId /* uuid */;
1313
+ }
1314
+ export type RequestBody = Components.Schemas.SubmitFeedbackRequest;
1315
+ namespace Responses {
1316
+ export interface $200 {
1317
+ feedback?: Components.Schemas.MessageFeedback;
1318
+ }
1319
+ export type $400 = Components.Schemas.Error;
1320
+ export type $404 = Components.Schemas.Error;
1321
+ }
1322
+ }
1008
1323
  namespace UpdateAgentById {
1009
1324
  namespace Parameters {
1010
1325
  export type AgentId = /**
@@ -1099,6 +1414,26 @@ interface OperationMethods {
1099
1414
  data?: Paths.ExecuteAgent.RequestBody,
1100
1415
  config?: AxiosRequestConfig
1101
1416
  ): OperationResponse<Paths.ExecuteAgent.Responses.$200>
1417
+ /**
1418
+ * executeAgentStream - Execute an agent with streaming response
1419
+ *
1420
+ * Executes an agent with real-time streaming of tokens and tool events.
1421
+ * Returns Server-Sent Events (SSE) stream with token-by-token output,
1422
+ * tool call progress, and completion status.
1423
+ *
1424
+ * Unlike the async `/execute` endpoint which returns immediately with
1425
+ * an execution_id for polling, this endpoint streams all events in real-time.
1426
+ *
1427
+ * Supports both:
1428
+ * - System skill IDs (prefixed): "skill:email-categorizer"
1429
+ * - Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
1430
+ *
1431
+ */
1432
+ 'executeAgentStream'(
1433
+ parameters?: Parameters<Paths.ExecuteAgentStream.PathParameters> | null,
1434
+ data?: Paths.ExecuteAgentStream.RequestBody,
1435
+ config?: AxiosRequestConfig
1436
+ ): OperationResponse<Paths.ExecuteAgentStream.Responses.$200>
1102
1437
  /**
1103
1438
  * listExecutions - List executions
1104
1439
  */
@@ -1153,6 +1488,67 @@ interface OperationMethods {
1153
1488
  data?: Paths.RejectExecution.RequestBody,
1154
1489
  config?: AxiosRequestConfig
1155
1490
  ): OperationResponse<Paths.RejectExecution.Responses.$200>
1491
+ /**
1492
+ * streamExecution - Reconnect to execution stream
1493
+ *
1494
+ * Reconnects to an execution's event stream after approval. Replays missed events from event log and continues streaming if execution is still running.
1495
+ */
1496
+ 'streamExecution'(
1497
+ parameters?: Parameters<Paths.StreamExecution.QueryParameters & Paths.StreamExecution.PathParameters> | null,
1498
+ data?: any,
1499
+ config?: AxiosRequestConfig
1500
+ ): OperationResponse<Paths.StreamExecution.Responses.$200>
1501
+ /**
1502
+ * chat - Streaming chat with AI agent
1503
+ *
1504
+ * Initiates a streaming chat session with an AI agent. Supports server-side conversation memory via conversationId or client-provided history via clientHistory.
1505
+ */
1506
+ 'chat'(
1507
+ parameters?: Parameters<UnknownParamsObject> | null,
1508
+ data?: Paths.Chat.RequestBody,
1509
+ config?: AxiosRequestConfig
1510
+ ): OperationResponse<Paths.Chat.Responses.$200>
1511
+ /**
1512
+ * listConversations - List conversations
1513
+ *
1514
+ * Lists conversations for the authenticated user, sorted by most recent.
1515
+ */
1516
+ 'listConversations'(
1517
+ parameters?: Parameters<Paths.ListConversations.QueryParameters> | null,
1518
+ data?: any,
1519
+ config?: AxiosRequestConfig
1520
+ ): OperationResponse<Paths.ListConversations.Responses.$200>
1521
+ /**
1522
+ * getConversation - Get conversation with messages
1523
+ *
1524
+ * Retrieves a conversation and its message history.
1525
+ */
1526
+ 'getConversation'(
1527
+ parameters?: Parameters<Paths.GetConversation.QueryParameters & Paths.GetConversation.PathParameters> | null,
1528
+ data?: any,
1529
+ config?: AxiosRequestConfig
1530
+ ): OperationResponse<Paths.GetConversation.Responses.$200>
1531
+ /**
1532
+ * deleteConversation - Delete conversation
1533
+ *
1534
+ * Deletes a conversation and all its messages.
1535
+ */
1536
+ 'deleteConversation'(
1537
+ parameters?: Parameters<Paths.DeleteConversation.PathParameters> | null,
1538
+ data?: any,
1539
+ config?: AxiosRequestConfig
1540
+ ): OperationResponse<Paths.DeleteConversation.Responses.$204>
1541
+ /**
1542
+ * submitConversationFeedback - Submit feedback for an assistant turn
1543
+ *
1544
+ * Records a thumbs up/down (with optional comment) for the assistant turn identified by its Langfuse trace id. The rating is persisted on the message and mirrored to Langfuse as a trace score.
1545
+ *
1546
+ */
1547
+ 'submitConversationFeedback'(
1548
+ parameters?: Parameters<Paths.SubmitConversationFeedback.PathParameters> | null,
1549
+ data?: Paths.SubmitConversationFeedback.RequestBody,
1550
+ config?: AxiosRequestConfig
1551
+ ): OperationResponse<Paths.SubmitConversationFeedback.Responses.$200>
1156
1552
  }
1157
1553
 
1158
1554
  interface PathsDictionary {
@@ -1231,6 +1627,28 @@ interface PathsDictionary {
1231
1627
  config?: AxiosRequestConfig
1232
1628
  ): OperationResponse<Paths.ExecuteAgent.Responses.$200>
1233
1629
  }
1630
+ ['/v1/agents/{agent_id}/execute/stream']: {
1631
+ /**
1632
+ * executeAgentStream - Execute an agent with streaming response
1633
+ *
1634
+ * Executes an agent with real-time streaming of tokens and tool events.
1635
+ * Returns Server-Sent Events (SSE) stream with token-by-token output,
1636
+ * tool call progress, and completion status.
1637
+ *
1638
+ * Unlike the async `/execute` endpoint which returns immediately with
1639
+ * an execution_id for polling, this endpoint streams all events in real-time.
1640
+ *
1641
+ * Supports both:
1642
+ * - System skill IDs (prefixed): "skill:email-categorizer"
1643
+ * - Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
1644
+ *
1645
+ */
1646
+ 'post'(
1647
+ parameters?: Parameters<Paths.ExecuteAgentStream.PathParameters> | null,
1648
+ data?: Paths.ExecuteAgentStream.RequestBody,
1649
+ config?: AxiosRequestConfig
1650
+ ): OperationResponse<Paths.ExecuteAgentStream.Responses.$200>
1651
+ }
1234
1652
  ['/v1/executions']: {
1235
1653
  /**
1236
1654
  * listExecutions - List executions
@@ -1295,6 +1713,77 @@ interface PathsDictionary {
1295
1713
  config?: AxiosRequestConfig
1296
1714
  ): OperationResponse<Paths.RejectExecution.Responses.$200>
1297
1715
  }
1716
+ ['/v1/executions/{execution_id}/stream']: {
1717
+ /**
1718
+ * streamExecution - Reconnect to execution stream
1719
+ *
1720
+ * Reconnects to an execution's event stream after approval. Replays missed events from event log and continues streaming if execution is still running.
1721
+ */
1722
+ 'get'(
1723
+ parameters?: Parameters<Paths.StreamExecution.QueryParameters & Paths.StreamExecution.PathParameters> | null,
1724
+ data?: any,
1725
+ config?: AxiosRequestConfig
1726
+ ): OperationResponse<Paths.StreamExecution.Responses.$200>
1727
+ }
1728
+ ['/v1/chat']: {
1729
+ /**
1730
+ * chat - Streaming chat with AI agent
1731
+ *
1732
+ * Initiates a streaming chat session with an AI agent. Supports server-side conversation memory via conversationId or client-provided history via clientHistory.
1733
+ */
1734
+ 'post'(
1735
+ parameters?: Parameters<UnknownParamsObject> | null,
1736
+ data?: Paths.Chat.RequestBody,
1737
+ config?: AxiosRequestConfig
1738
+ ): OperationResponse<Paths.Chat.Responses.$200>
1739
+ }
1740
+ ['/v1/conversations']: {
1741
+ /**
1742
+ * listConversations - List conversations
1743
+ *
1744
+ * Lists conversations for the authenticated user, sorted by most recent.
1745
+ */
1746
+ 'get'(
1747
+ parameters?: Parameters<Paths.ListConversations.QueryParameters> | null,
1748
+ data?: any,
1749
+ config?: AxiosRequestConfig
1750
+ ): OperationResponse<Paths.ListConversations.Responses.$200>
1751
+ }
1752
+ ['/v1/conversations/{conversation_id}']: {
1753
+ /**
1754
+ * getConversation - Get conversation with messages
1755
+ *
1756
+ * Retrieves a conversation and its message history.
1757
+ */
1758
+ 'get'(
1759
+ parameters?: Parameters<Paths.GetConversation.QueryParameters & Paths.GetConversation.PathParameters> | null,
1760
+ data?: any,
1761
+ config?: AxiosRequestConfig
1762
+ ): OperationResponse<Paths.GetConversation.Responses.$200>
1763
+ /**
1764
+ * deleteConversation - Delete conversation
1765
+ *
1766
+ * Deletes a conversation and all its messages.
1767
+ */
1768
+ 'delete'(
1769
+ parameters?: Parameters<Paths.DeleteConversation.PathParameters> | null,
1770
+ data?: any,
1771
+ config?: AxiosRequestConfig
1772
+ ): OperationResponse<Paths.DeleteConversation.Responses.$204>
1773
+ }
1774
+ ['/v1/conversations/{conversation_id}/feedback']: {
1775
+ /**
1776
+ * submitConversationFeedback - Submit feedback for an assistant turn
1777
+ *
1778
+ * Records a thumbs up/down (with optional comment) for the assistant turn identified by its Langfuse trace id. The rating is persisted on the message and mirrored to Langfuse as a trace score.
1779
+ *
1780
+ */
1781
+ 'post'(
1782
+ parameters?: Parameters<Paths.SubmitConversationFeedback.PathParameters> | null,
1783
+ data?: Paths.SubmitConversationFeedback.RequestBody,
1784
+ config?: AxiosRequestConfig
1785
+ ): OperationResponse<Paths.SubmitConversationFeedback.Responses.$200>
1786
+ }
1298
1787
  }
1299
1788
 
1300
1789
  type Client = OpenAPIClient<OperationMethods, PathsDictionary>
@@ -1304,22 +1793,31 @@ type AgentDefinition = Components.Schemas.AgentDefinition;
1304
1793
  type AgentId = Components.Schemas.AgentId;
1305
1794
  type AgentSource = Components.Schemas.AgentSource;
1306
1795
  type ApproveExecutionRequest = Components.Schemas.ApproveExecutionRequest;
1796
+ type ChatMessage = Components.Schemas.ChatMessage;
1797
+ type ChatRequest = Components.Schemas.ChatRequest;
1798
+ type ConversationItem = Components.Schemas.ConversationItem;
1799
+ type ConversationWithMessages = Components.Schemas.ConversationWithMessages;
1307
1800
  type CreateAgentRequest = Components.Schemas.CreateAgentRequest;
1308
1801
  type Error = Components.Schemas.Error;
1309
1802
  type ExecuteAgentRequest = Components.Schemas.ExecuteAgentRequest;
1310
1803
  type ExecutionContext = Components.Schemas.ExecutionContext;
1311
1804
  type ExecutionError = Components.Schemas.ExecutionError;
1312
1805
  type ExecutionIteration = Components.Schemas.ExecutionIteration;
1806
+ type ExecutionIterationProjection = Components.Schemas.ExecutionIterationProjection;
1313
1807
  type ExecutionMetrics = Components.Schemas.ExecutionMetrics;
1314
1808
  type ExecutionMode = Components.Schemas.ExecutionMode;
1315
1809
  type ExecutionPattern = Components.Schemas.ExecutionPattern;
1316
1810
  type ExecutionResponse = Components.Schemas.ExecutionResponse;
1811
+ type ExecutionResult = Components.Schemas.ExecutionResult;
1317
1812
  type ExecutionStatus = Components.Schemas.ExecutionStatus;
1318
1813
  type ExecutionTrace = Components.Schemas.ExecutionTrace;
1319
1814
  type InputParameterDefinition = Components.Schemas.InputParameterDefinition;
1320
1815
  type InputParametersSchema = Components.Schemas.InputParametersSchema;
1321
1816
  type ListAgentsResponse = Components.Schemas.ListAgentsResponse;
1817
+ type ListConversationsResponse = Components.Schemas.ListConversationsResponse;
1322
1818
  type ListExecutionsResponse = Components.Schemas.ListExecutionsResponse;
1819
+ type MessageFeedback = Components.Schemas.MessageFeedback;
1820
+ type MessageItem = Components.Schemas.MessageItem;
1323
1821
  type ModelConfig = Components.Schemas.ModelConfig;
1324
1822
  type ParameterType = Components.Schemas.ParameterType;
1325
1823
  type PendingAction = Components.Schemas.PendingAction;
@@ -1330,8 +1828,11 @@ type PreviewValue = Components.Schemas.PreviewValue;
1330
1828
  type RejectExecutionRequest = Components.Schemas.RejectExecutionRequest;
1331
1829
  type SkillAvailability = Components.Schemas.SkillAvailability;
1332
1830
  type SkillCategory = Components.Schemas.SkillCategory;
1831
+ type StreamEvent = Components.Schemas.StreamEvent;
1832
+ type StreamingOptions = Components.Schemas.StreamingOptions;
1833
+ type SubmitFeedbackRequest = Components.Schemas.SubmitFeedbackRequest;
1333
1834
  type ToolDefinition = Components.Schemas.ToolDefinition;
1334
1835
  type ToolPreview = Components.Schemas.ToolPreview;
1335
1836
  type UpdateAgentRequest = Components.Schemas.UpdateAgentRequest;
1336
1837
 
1337
- export { type AgentDefinition as A, type Client as C, type Error as E, type InputParameterDefinition as I, type ListAgentsResponse as L, type ModelConfig as M, type OperationMethods as O, Paths as P, type RejectExecutionRequest as R, type SkillAvailability as S, type ToolDefinition as T, type UpdateAgentRequest as U, Components as a, type PathsDictionary as b, type AgentId as c, type AgentSource as d, type ApproveExecutionRequest as e, type CreateAgentRequest as f, type ExecuteAgentRequest as g, type ExecutionContext as h, type ExecutionError as i, type ExecutionIteration as j, type ExecutionMetrics as k, type ExecutionMode as l, type ExecutionPattern as m, type ExecutionResponse as n, type ExecutionStatus as o, type ExecutionTrace as p, type InputParametersSchema as q, type ListExecutionsResponse as r, type ParameterType as s, type PendingAction as t, type PreviewActionType as u, type PreviewChange as v, type PreviewEntity as w, type PreviewValue as x, type SkillCategory as y, type ToolPreview as z };
1838
+ export { type AgentDefinition as A, type ModelConfig as B, type Client as C, type ParameterType as D, type Error as E, type PendingAction as F, type PreviewActionType as G, type PreviewChange as H, type InputParameterDefinition as I, type PreviewEntity as J, type PreviewValue as K, type ListAgentsResponse as L, type MessageFeedback as M, type SkillCategory as N, type OperationMethods as O, Paths as P, type StreamEvent as Q, type RejectExecutionRequest as R, type SkillAvailability as S, type StreamingOptions as T, type SubmitFeedbackRequest as U, type ToolDefinition as V, type ToolPreview as W, type UpdateAgentRequest as X, Components as a, type PathsDictionary as b, type AgentId as c, type AgentSource as d, type ApproveExecutionRequest as e, type ChatMessage as f, type ChatRequest as g, type ConversationItem as h, type ConversationWithMessages as i, type CreateAgentRequest as j, type ExecuteAgentRequest as k, type ExecutionContext as l, type ExecutionError as m, type ExecutionIteration as n, type ExecutionIterationProjection as o, type ExecutionMetrics as p, type ExecutionMode as q, type ExecutionPattern as r, type ExecutionResponse as s, type ExecutionResult as t, type ExecutionStatus as u, type ExecutionTrace as v, type InputParametersSchema as w, type ListConversationsResponse as x, type ListExecutionsResponse as y, type MessageItem as z };