@epilot/sdk 2.18.8 → 2.18.10

package/definitions/ai-agents-runtime.json

@@ -1 +1 @@
-{"s":"https://ai-agents.sls.epilot.io","o":[["createAgent","post","/v1/agents",null,1],["listAgents","get","/v1/agents",[["source","q"],["availability","q"],["entity_schema","q"]]],["getAgentById","get","/v1/agents/{agent_id}",[["agent_id","p",true]]],["updateAgentById","put","/v1/agents/{agent_id}",[["agent_id","p",true]],1],["deleteAgentById","delete","/v1/agents/{agent_id}",[["agent_id","p",true]]],["executeAgent","post","/v1/agents/{agent_id}/execute",[["agent_id","p",true]],1],["executeAgentStream","post","/v1/agents/{agent_id}/execute/stream",[["agent_id","p",true]],1],["listExecutions","get","/v1/executions",[["agent_id","q"],["status","q"],["limit","q"]]],["getExecution","get","/v1/executions/{execution_id}",[["execution_id","p",true]]],["cancelExecution","delete","/v1/executions/{execution_id}",[["execution_id","p",true]]],["getExecutionTrace","get","/v1/executions/{execution_id}/trace",[["execution_id","p",true]]],["approveExecution","post","/v1/executions/{execution_id}/approve",[["execution_id","p",true]],1],["rejectExecution","post","/v1/executions/{execution_id}/reject",[["execution_id","p",true]],1],["streamExecution","get","/v1/executions/{execution_id}/stream",[["execution_id","p",true],["from_sequence","q"]]],["chat","post","/v1/chat",null,1],["listConversations","get","/v1/conversations",[["agent_id","q"],["limit","q"],["cursor","q"]]],["getConversation","get","/v1/conversations/{conversation_id}",[["conversation_id","p",true],["message_limit","q"]]],["deleteConversation","delete","/v1/conversations/{conversation_id}",[["conversation_id","p",true]]],["submitConversationFeedback","post","/v1/conversations/{conversation_id}/feedback",[["conversation_id","p",true]],1]],"v":"3.0.0"}
+{"s":"https://ai-agents.sls.epilot.io","o":[["createAgent","post","/v1/agents",null,1],["listAgents","get","/v1/agents",[["source","q"],["availability","q"],["entity_schema","q"]]],["getAgentById","get","/v1/agents/{agent_id}",[["agent_id","p",true]]],["updateAgentById","put","/v1/agents/{agent_id}",[["agent_id","p",true]],1],["deleteAgentById","delete","/v1/agents/{agent_id}",[["agent_id","p",true]]],["executeAgent","post","/v1/agents/{agent_id}/execute",[["agent_id","p",true]],1],["executeAgentStream","post","/v1/agents/{agent_id}/execute/stream",[["agent_id","p",true]],1],["listExecutions","get","/v1/executions",[["agent_id","q"],["status","q"],["limit","q"]]],["getExecution","get","/v1/executions/{execution_id}",[["execution_id","p",true]]],["cancelExecution","delete","/v1/executions/{execution_id}",[["execution_id","p",true]]],["getExecutionTrace","get","/v1/executions/{execution_id}/trace",[["execution_id","p",true]]],["getExecutionFeedback","get","/v1/executions/{execution_id}/feedback",[["execution_id","p",true]]],["putExecutionFeedback","put","/v1/executions/{execution_id}/feedback",[["execution_id","p",true]],1],["approveExecution","post","/v1/executions/{execution_id}/approve",[["execution_id","p",true]],1],["rejectExecution","post","/v1/executions/{execution_id}/reject",[["execution_id","p",true]],1],["streamExecution","get","/v1/executions/{execution_id}/stream",[["execution_id","p",true],["from_sequence","q"]]],["chat","post","/v1/chat",null,1],["listConversations","get","/v1/conversations",[["agent_id","q"],["limit","q"],["cursor","q"]]],["getConversation","get","/v1/conversations/{conversation_id}",[["conversation_id","p",true],["message_limit","q"]]],["deleteConversation","delete","/v1/conversations/{conversation_id}",[["conversation_id","p",true]]],["submitConversationFeedback","post","/v1/conversations/{conversation_id}/feedback",[["conversation_id","p",true]],1]],"v":"3.0.0"}

package/definitions/ai-agents.json

@@ -630,6 +630,130 @@
         }
       }
     },
+    "/v1/executions/{execution_id}/feedback": {
+      "get": {
+        "tags": [
+          "Agent Execution"
+        ],
+        "summary": "Get execution feedback",
+        "description": "Returns the authenticated user's feedback for an execution.",
+        "operationId": "getExecutionFeedback",
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "execution_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Feedback state",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ExecutionFeedbackResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Execution not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Agent Execution"
+        ],
+        "summary": "Submit execution feedback",
+        "description": "Upserts thumbs up/down feedback and mirrors it to the execution's Langfuse trace.",
+        "operationId": "putExecutionFeedback",
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "execution_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutExecutionFeedbackRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Feedback recorded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ExecutionFeedbackResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid feedback",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Execution not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Execution cannot be rated",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/executions/{execution_id}/approve": {
       "post": {
         "tags": [
@@ -1575,6 +1699,67 @@
           }
         }
       },
+      "ExecutionFeedback": {
+        "type": "object",
+        "required": [
+          "rating",
+          "user_id",
+          "submitted_at"
+        ],
+        "properties": {
+          "rating": {
+            "type": "string",
+            "enum": [
+              "up",
+              "down"
+            ]
+          },
+          "comment": {
+            "type": "string"
+          },
+          "user_id": {
+            "type": "string"
+          },
+          "submitted_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "ExecutionFeedbackResponse": {
+        "type": "object",
+        "required": [
+          "feedback"
+        ],
+        "properties": {
+          "feedback": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ExecutionFeedback"
+              }
+            ],
+            "nullable": true
+          }
+        }
+      },
+      "PutExecutionFeedbackRequest": {
+        "type": "object",
+        "required": [
+          "rating"
+        ],
+        "properties": {
+          "rating": {
+            "type": "string",
+            "enum": [
+              "up",
+              "down"
+            ]
+          },
+          "comment": {
+            "type": "string"
+          }
+        }
+      },
       "ExecutionTrace": {
         "type": "object",
         "properties": {

package/definitions/automation.json

@@ -1295,6 +1295,9 @@
           },
           {
             "$ref": "#/components/schemas/ReplyEmailAction"
+          },
+          {
+            "$ref": "#/components/schemas/AssignEntityAction"
           }
         ]
       },
@@ -1341,6 +1344,9 @@
           },
           {
             "$ref": "#/components/schemas/ReplyEmailActionConfig"
+          },
+          {
+            "$ref": "#/components/schemas/AssignEntityActionConfig"
           }
         ]
       },
@@ -1851,6 +1857,10 @@
             "type": "string",
             "description": "Schema of target entity"
           },
+          "use_uniqueness_criteria": {
+            "type": "boolean",
+            "description": "Resolve this action's target (contact/account) via the organization's global uniqueness criteria instead of per-action identifiers (target_unique / Unique switches). Forwarded to entity mapping by automation-workers.\n"
+          },
           "target_unique": {
             "type": "array",
             "description": "Unique key for target entity (see upsertEntity of Entity API)",
@@ -2243,6 +2253,11 @@
             "description": "Candidate condition for even_distribution: when true, skip users who\nare currently absent (out-of-office). Opt-in; defaults to false.\n",
             "default": false
           },
+          "hold_until_available": {
+            "type": "boolean",
+            "description": "Sub-option of only_available_users: when a day off (weekend / whole\nday off with a known return) is what empties the candidate pool, hold\nthe thread and retry when the soonest candidate is back — bounded to\n7 retries over 7 days — before applying the fallback. Defaults to\ntrue; set false to skip the hold and fall straight through to the\nfallback. Out-of-office / vacation and non-availability reasons never\nhold regardless.\n",
+            "default": true
+          },
           "match_user_skills": {
             "type": "boolean",
             "description": "Candidate condition for even_distribution: when true, only assign to\nusers whose skills (tags) match a label on the message. Opt-in;\ndefaults to false.\n",
@@ -2282,6 +2297,161 @@
           }
         }
       },
+      "EntityAssignee": {
+        "type": "object",
+        "description": "A single assignee as stored in a user-relation attribute. Written through\nverbatim by the assign-entity worker. Note this object encoding differs\ndeliberately from AssignThreadConfig, which stores bare id strings —\neach matches what its own target accepts.\n",
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "Which kind of principal this assignee is. Required: it selects which\nof the identifier properties below applies, and forms part of the\nappend-mode de-duplication key.\n",
+            "enum": [
+              "user",
+              "partner_user",
+              "partner_organization",
+              "group"
+            ]
+          },
+          "user_id": {
+            "type": "string",
+            "description": "Set for user and partner_user assignees."
+          },
+          "group_id": {
+            "type": "string",
+            "description": "Set for group assignees."
+          },
+          "org_id": {
+            "type": "string",
+            "description": "Organization the assignee belongs to."
+          },
+          "partner_id": {
+            "type": "string",
+            "description": "Set for partner_user and partner_organization assignees."
+          },
+          "display_name": {
+            "type": "string",
+            "description": "Label snapshotted at configuration time; may go stale after a rename."
+          },
+          "email": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "type"
+        ]
+      },
+      "AssignEntityConfig": {
+        "type": "object",
+        "properties": {
+          "attribute": {
+            "type": "string",
+            "description": "Slug of the user-relation attribute on the triggering entity to write to."
+          },
+          "assignees": {
+            "type": "array",
+            "description": "Assignees to write into `attribute`, in the order given.",
+            "items": {
+              "$ref": "#/components/schemas/EntityAssignee"
+            }
+          },
+          "write_mode": {
+            "type": "string",
+            "description": "How `assignees` combine with the attribute's current value.\n- replace: overwrite the attribute with `assignees` (default).\n- append: union with the existing assignees, de-duplicated, existing\n  entries first. Two assignees are duplicates when their `type` and\n  `org_id` both match and the identifier for that type matches:\n  `user_id` for user and partner_user, `group_id` for group,\n  `partner_id` for partner_organization. Scoping by `org_id` keeps\n  assignees from different organizations distinct even when their\n  identifiers coincide.\n",
+            "enum": [
+              "replace",
+              "append"
+            ],
+            "default": "replace"
+          },
+          "assignment_type": {
+            "type": "string",
+            "description": "How assignees are resolved.\n- direct: assign exactly the assignees listed (default, and the only\n  accepted value).\nReserved for a future routing strategy; widening this enum later is\nbackwards compatible and needs no migration of existing flows.\n",
+            "enum": [
+              "direct"
+            ],
+            "default": "direct"
+          },
+          "source": {
+            "type": "object",
+            "description": "Which entity to assign to. Omit for the triggering entity (the\ndefault, and the behaviour of every flow saved before this field\nexisted).\n- trigger: the entity that started the flow.\n- action: the entity produced by an earlier action, identified by\n  that action's `flow_action_id`.\n",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "The producing action's `flow_action_id` when origin is `action`, or the trigger id when origin is `trigger`. Note this is `flow_action_id` (stable across executions), not `id`.\n"
+              },
+              "origin": {
+                "type": "string",
+                "enum": [
+                  "trigger",
+                  "action"
+                ]
+              },
+              "schema": {
+                "type": "string",
+                "description": "Entity schema recorded when the source was chosen, for display. The worker uses the schema on the resolved entity itself, since this value goes stale if the producing action's target changes.\n"
+              }
+            }
+          }
+        }
+      },
+      "AssignEntityActionConfig": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/AutomationActionConfig"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "enum": [
+                  "assign-entity"
+                ]
+              },
+              "config": {
+                "$ref": "#/components/schemas/AssignEntityConfig"
+              }
+            }
+          }
+        ],
+        "example": {
+          "id": "25jga0-gkasl26-0asg-908sgaj2",
+          "name": "Assign Entity",
+          "type": "assign-entity",
+          "config": {
+            "attribute": "assigned_to",
+            "write_mode": "replace",
+            "assignment_type": "direct",
+            "assignees": [
+              {
+                "type": "user",
+                "user_id": "90503",
+                "org_id": "66",
+                "display_name": "Jane Doe",
+                "email": "jane.doe@example.com"
+              }
+            ]
+          }
+        }
+      },
+      "AssignEntityAction": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/AutomationAction"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "enum": [
+                  "assign-entity"
+                ]
+              },
+              "config": {
+                "$ref": "#/components/schemas/AssignEntityConfig"
+              }
+            }
+          }
+        ]
+      },
       "SendEmailActionConfig": {
         "allOf": [
           {
@@ -3690,6 +3860,13 @@
           "_execution_chain": {
             "$ref": "#/components/schemas/ExecutionChain"
           },
+          "_automation_chain": {
+            "type": "array",
+            "description": "[Internal] Ordered automation flow ids that led to the parent flow being started. The started execution appends its own flow id, so entity writes it performs carry the full chain and a loop running through a workflow can be detected. This is an internal property and should not be used by external consumers.\n",
+            "items": {
+              "type": "string"
+            }
+          },
           "entity_contexts": {
             "type": "array",
             "description": "Additional entity contexts from the parent flow execution. Used when an automation is triggered from a workflow task to carry all flow contexts into the automation, not just the primary entity.\n",

package/dist/ai-agents-3JK4UU2G.js

@@ -0,0 +1,7 @@
+import "./chunk-YPSWSI3M.js";
+
+// src/docs/ai-agents.json
+var ai_agents_default = '# AI Agents API\n\n- **Base URL:** `https://ai-agents.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/ai-agents](https://docs.epilot.io/api/ai-agents)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.aiAgents.createAgent(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/ai-agents\'\n\nconst aiAgentsClient = getClient()\nauthorize(aiAgentsClient, () => \'<token>\')\nconst { data } = await aiAgentsClient.createAgent(...)\n```\n\n## Operations\n\n**Agents Configuration**\n- [`createAgent`](#createagent)\n- [`listAgents`](#listagents)\n- [`getAgentById`](#getagentbyid)\n- [`updateAgentById`](#updateagentbyid)\n- [`deleteAgentById`](#deleteagentbyid)\n\n**Agent Execution**\n- [`executeAgent`](#executeagent)\n- [`executeAgentStream`](#executeagentstream)\n- [`listExecutions`](#listexecutions)\n- [`getExecution`](#getexecution)\n- [`cancelExecution`](#cancelexecution)\n- [`getExecutionTrace`](#getexecutiontrace)\n- [`getExecutionFeedback`](#getexecutionfeedback)\n- [`putExecutionFeedback`](#putexecutionfeedback)\n- [`approveExecution`](#approveexecution)\n- [`rejectExecution`](#rejectexecution)\n- [`streamExecution`](#streamexecution)\n\n**Chat**\n- [`chat`](#chat)\n\n**Conversations**\n- [`listConversations`](#listconversations)\n- [`getConversation`](#getconversation)\n- [`deleteConversation`](#deleteconversation)\n- [`submitConversationFeedback`](#submitconversationfeedback)\n\n**Schemas**\n- [`AgentId`](#agentid)\n- [`CreateAgentRequest`](#createagentrequest)\n- [`UpdateAgentRequest`](#updateagentrequest)\n- [`AgentDefinition`](#agentdefinition)\n- [`ListAgentsResponse`](#listagentsresponse)\n- [`ListExecutionsResponse`](#listexecutionsresponse)\n- [`ApproveExecutionRequest`](#approveexecutionrequest)\n- [`RejectExecutionRequest`](#rejectexecutionrequest)\n- [`ExecuteAgentRequest`](#executeagentrequest)\n- [`ExecutionResponse`](#executionresponse)\n- [`ExecutionIterationProjection`](#executioniterationprojection)\n- [`ExecutionFeedback`](#executionfeedback)\n- [`ExecutionFeedbackResponse`](#executionfeedbackresponse)\n- [`PutExecutionFeedbackRequest`](#putexecutionfeedbackrequest)\n- [`ExecutionTrace`](#executiontrace)\n- [`ExecutionIteration`](#executioniteration)\n- [`PendingAction`](#pendingaction)\n- [`ExecutionError`](#executionerror)\n- [`ExecutionMetrics`](#executionmetrics)\n- [`ToolPreview`](#toolpreview)\n- [`PreviewActionType`](#previewactiontype)\n- [`PreviewEntity`](#previewentity)\n- [`PreviewChange`](#previewchange)\n- [`PreviewValue`](#previewvalue)\n- [`ToolDefinition`](#tooldefinition)\n- [`SkillCategory`](#skillcategory)\n- [`AgentSource`](#agentsource)\n- [`SkillAvailability`](#skillavailability)\n- [`ExecutionContext`](#executioncontext)\n- [`ExecutionPattern`](#executionpattern)\n- [`ExecutionMode`](#executionmode)\n- [`ExecutionStatus`](#executionstatus)\n- [`ParameterType`](#parametertype)\n- [`InputParameterDefinition`](#inputparameterdefinition)\n- [`InputParametersSchema`](#inputparametersschema)\n- [`ModelConfig`](#modelconfig)\n- [`Error`](#error)\n- [`ChatRequest`](#chatrequest)\n- [`ChatMessage`](#chatmessage)\n- [`StreamingOptions`](#streamingoptions)\n- [`StreamEvent`](#streamevent)\n- [`ExecutionResult`](#executionresult)\n- [`ConversationItem`](#conversationitem)\n- [`MessageItem`](#messageitem)\n- [`MessageFeedback`](#messagefeedback)\n- [`SubmitFeedbackRequest`](#submitfeedbackrequest)\n- [`ListConversationsResponse`](#listconversationsresponse)\n- [`ConversationWithMessages`](#conversationwithmessages)\n\n### `createAgent`\n\nCreate Agent definition\n\n`POST /v1/agents`\n\n```ts\nconst { data } = await client.createAgent(\n  null,\n  {\n    name: \'Email Reply Generator\',\n    description: \'string\',\n    category: \'message\',\n    icon: \'mail-reply\',\n    system_prompt: \'string\',\n    tools: [\'entity.search\', \'message.draft\'],\n    model_config: {\n      model_id: \'anthropic.claude-3-5-sonnet-20241022-v2:0\',\n      temperature: 0.7,\n      max_tokens: 4096,\n      thinking: false,\n      thinking_budget: 10000\n    },\n    max_iterations: 10,\n    execution_pattern: \'direct\',\n    execution_mode: \'automatic\',\n    output_schema: {},\n    input_parameters_schema: {\n      type: \'object\',\n      parameters: [\n        {\n          name: \'target_schema\',\n          label: \'Target Schema\',\n          type: \'entity-schema\',\n          description: \'Entity type to create\'\n        },\n        {\n          name: \'confidence_threshold\',\n          label: \'Confidence Threshold\',\n          type: \'number\',\n          minimum: 0,\n          maximum: 1,\n          default: 0.8\n        },\n        /* ... 1 more */\n      ],\n      required: [\'target_schema\']\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "agent_id": "skill:email-categorizer",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "category": "message",\n  "icon": "string",\n  "source": "system",\n  "availability": ["flows", "copilot"],\n  "allowed_entity_schemas": ["message"],\n  "system_prompt": "string",\n  "tools": ["string"],\n  "model_config": {\n    "model_id": "anthropic.claude-3-5-sonnet-20241022-v2:0",\n    "temperature": 0.7,\n    "max_tokens": 4096,\n    "thinking": false,\n    "thinking_budget": 10000\n  },\n  "max_iterations": 0,\n  "execution_pattern": "direct",\n  "execution_mode": "automatic",\n  "output_schema": {},\n  "input_parameters_schema": {\n    "type": "object",\n    "parameters": [\n      {\n        "name": "target_schema",\n        "label": "Target Schema",\n        "type": "entity-schema",\n        "description": "Entity type to create"\n      },\n      {\n        "name": "confidence_threshold",\n        "label": "Confidence Threshold",\n        "type": "number",\n        "minimum": 0,\n        "maximum": 1,\n        "default": 0.8\n      }\n    ],\n    "required": ["target_schema"]\n  },\n  "version": 0,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `listAgents`\n\nList all agent configurations\n\n`GET /v1/agents`\n\n```ts\nconst { data } = await client.listAgents({\n  source: \'example\',\n  availability: \'example\',\n  entity_schema: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "agents": [\n    {\n      "agent_id": "skill:email-categorizer",\n      "org_id": "string",\n      "name": "string",\n      "description": "string",\n      "category": "message",\n      "icon": "string",\n      "source": "system",\n      "availability": ["flows", "copilot"],\n      "allowed_entity_schemas": ["message"],\n      "system_prompt": "string",\n      "tools": ["string"],\n      "model_config": {\n        "model_id": "anthropic.claude-3-5-sonnet-20241022-v2:0",\n        "temperature": 0.7,\n        "max_tokens": 4096,\n        "thinking": false,\n        "thinking_budget": 10000\n      },\n      "max_iterations": 0,\n      "execution_pattern": "direct",\n      "execution_mode": "automatic",\n      "output_schema": {},\n      "input_parameters_schema": {\n        "type": "object",\n        "parameters": [\n          {\n            "name": "target_schema",\n            "label": "Target Schema",\n            "type": "entity-schema",\n            "description": "Entity type to create"\n          },\n          {\n            "name": "confidence_threshold",\n            "label": "Confidence Threshold",\n            "type": "number",\n            "minimum": 0,\n            "maximum": 1,\n            "default": 0.8\n          }\n        ],\n        "required": ["target_schema"]\n      },\n      "version": 0,\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z",\n      "created_by": "string"\n    }\n  ],\n  "next_cursor": "string"\n}\n```\n\n</details>\n\n---\n\n### `getAgentById`\n\nGet the agent configuration by ID\n\n`GET /v1/agents/{agent_id}`\n\n```ts\nconst { data } = await client.getAgentById({\n  agent_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "agent_id": "skill:email-categorizer",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "category": "message",\n  "icon": "string",\n  "source": "system",\n  "availability": ["flows", "copilot"],\n  "allowed_entity_schemas": ["message"],\n  "system_prompt": "string",\n  "tools": ["string"],\n  "model_config": {\n    "model_id": "anthropic.claude-3-5-sonnet-20241022-v2:0",\n    "temperature": 0.7,\n    "max_tokens": 4096,\n    "thinking": false,\n    "thinking_budget": 10000\n  },\n  "max_iterations": 0,\n  "execution_pattern": "direct",\n  "execution_mode": "automatic",\n  "output_schema": {},\n  "input_parameters_schema": {\n    "type": "object",\n    "parameters": [\n      {\n        "name": "target_schema",\n        "label": "Target Schema",\n        "type": "entity-schema",\n        "description": "Entity type to create"\n      },\n      {\n        "name": "confidence_threshold",\n        "label": "Confidence Threshold",\n        "type": "number",\n        "minimum": 0,\n        "maximum": 1,\n        "default": 0.8\n      }\n    ],\n    "required": ["target_schema"]\n  },\n  "version": 0,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `updateAgentById`\n\nUpdate the agent configuration by ID\n\n`PUT /v1/agents/{agent_id}`\n\n```ts\nconst { data } = await client.updateAgentById(\n  {\n    agent_id: \'example\',\n  },\n  {\n    name: \'string\',\n    description: \'string\',\n    category: \'message\',\n    icon: \'string\',\n    system_prompt: \'string\',\n    tools: [\'string\'],\n    model_config: {\n      model_id: \'anthropic.claude-3-5-sonnet-20241022-v2:0\',\n      temperature: 0.7,\n      max_tokens: 4096,\n      thinking: false,\n      thinking_budget: 10000\n    },\n    max_iterations: 1,\n    execution_pattern: \'direct\',\n    execution_mode: \'automatic\',\n    output_schema: {},\n    input_parameters_schema: {\n      type: \'object\',\n      parameters: [\n        {\n          name: \'target_schema\',\n          label: \'Target Schema\',\n          type: \'entity-schema\',\n          description: \'Entity type to create\'\n        },\n        {\n          name: \'confidence_threshold\',\n          label: \'Confidence Threshold\',\n          type: \'number\',\n          minimum: 0,\n          maximum: 1,\n          default: 0.8\n        },\n        /* ... 1 more */\n      ],\n      required: [\'target_schema\']\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "agent_id": "skill:email-categorizer",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "category": "message",\n  "icon": "string",\n  "source": "system",\n  "availability": ["flows", "copilot"],\n  "allowed_entity_schemas": ["message"],\n  "system_prompt": "string",\n  "tools": ["string"],\n  "model_config": {\n    "model_id": "anthropic.claude-3-5-sonnet-20241022-v2:0",\n    "temperature": 0.7,\n    "max_tokens": 4096,\n    "thinking": false,\n    "thinking_budget": 10000\n  },\n  "max_iterations": 0,\n  "execution_pattern": "direct",\n  "execution_mode": "automatic",\n  "output_schema": {},\n  "input_parameters_schema": {\n    "type": "object",\n    "parameters": [\n      {\n        "name": "target_schema",\n        "label": "Target Schema",\n        "type": "entity-schema",\n        "description": "Entity type to create"\n      },\n      {\n        "name": "confidence_threshold",\n        "label": "Confidence Threshold",\n        "type": "number",\n        "minimum": 0,\n        "maximum": 1,\n        "default": 0.8\n      }\n    ],\n    "required": ["target_schema"]\n  },\n  "version": 0,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `deleteAgentById`\n\nDelete the agent configuration by ID\n\n`DELETE /v1/agents/{agent_id}`\n\n```ts\nconst { data } = await client.deleteAgentById({\n  agent_id: \'example\',\n})\n```\n\n---\n\n### `executeAgent`\n\nExecute an agent\n\n`POST /v1/agents/{agent_id}/execute`\n\n```ts\nconst { data } = await client.executeAgent(\n  {\n    agent_id: \'example\',\n  },\n  {\n    input: {\n      entity_id: \'string\',\n      entity_schema: \'string\',\n      workflow_id: \'string\',\n      workflow_execution_id: \'string\',\n      task_id: \'string\',\n      custom_data: {},\n      flow_context: [\n        {\n          entity_id: \'string\',\n          entity_schema: \'string\'\n        }\n      ]\n    },\n    parameters: {},\n    execution_mode_override: \'automatic\',\n    execution_context: \'flows\',\n    callback_url: \'https://example.com/path\',\n    timeout_ms: 30000\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "agent_id": "skill:email-categorizer",\n  "agent_source": "system",\n  "agent_name": "string",\n  "execution_context": "flows",\n  "org_id": "string",\n  "status": "pending",\n  "input": {},\n  "parameters": {},\n  "result": {\n    "response": "string",\n    "structured_output": {}\n  },\n  "error": {\n    "code": "TIMEOUT",\n    "message": "string",\n    "details": {}\n  },\n  "pending_action": {\n    "tool": "string",\n    "input": {},\n    "description": "string",\n    "preview": {\n      "action": {\n        "type": "move",\n        "verb": "Move Thread"\n      },\n      "source": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "target": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "changes": [\n        {\n          "field": "string",\n          "label": "string",\n          "from": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          },\n          "to": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          }\n        }\n      ],\n      "metadata": {},\n      "summary": "This email discusses solar panel installation and should be handled by the Service team."\n    }\n  },\n  "metrics": {\n    "total_tokens": 0,\n    "input_tokens": 0,\n    "output_tokens": 0,\n    "total_cost_usd": 0,\n    "duration_ms": 0,\n    "iteration_count": 0\n  },\n  "started_at": "1970-01-01T00:00:00.000Z",\n  "completed_at": "1970-01-01T00:00:00.000Z",\n  "iterations": [\n    {\n      "index": 0,\n      "tool": "string",\n      "status": "running",\n      "timestamp": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `executeAgentStream`\n\nExecute an agent with streaming response\n\n`POST /v1/agents/{agent_id}/execute/stream`\n\n```ts\nconst { data } = await client.executeAgentStream(\n  {\n    agent_id: \'example\',\n  },\n  {\n    input: {\n      entity_id: \'string\',\n      entity_schema: \'string\',\n      workflow_id: \'string\',\n      workflow_execution_id: \'string\',\n      task_id: \'string\',\n      custom_data: {},\n      flow_context: [\n        {\n          entity_id: \'string\',\n          entity_schema: \'string\'\n        }\n      ]\n    },\n    parameters: {},\n    execution_mode_override: \'automatic\',\n    execution_context: \'flows\',\n    callback_url: \'https://example.com/path\',\n    timeout_ms: 30000\n  },\n)\n```\n\n---\n\n### `listExecutions`\n\nList executions\n\n`GET /v1/executions`\n\n```ts\nconst { data } = await client.listExecutions({\n  agent_id: \'example\',\n  status: \'example\',\n  limit: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "executions": [\n    {\n      "execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "agent_id": "skill:email-categorizer",\n      "agent_source": "system",\n      "agent_name": "string",\n      "execution_context": "flows",\n      "org_id": "string",\n      "status": "pending",\n      "input": {},\n      "parameters": {},\n      "result": {\n        "response": "string",\n        "structured_output": {}\n      },\n      "error": {\n        "code": "TIMEOUT",\n        "message": "string",\n        "details": {}\n      },\n      "pending_action": {\n        "tool": "string",\n        "input": {},\n        "description": "string",\n        "preview": {\n          "action": {\n            "type": "move",\n            "verb": "Move Thread"\n          },\n          "source": {\n            "type": "inbox",\n            "id": "string",\n            "name": "Support Inbox",\n            "schema": "string",\n            "icon": "string",\n            "url": "string"\n          },\n          "target": {\n            "type": "inbox",\n            "id": "string",\n            "name": "Support Inbox",\n            "schema": "string",\n            "icon": "string",\n            "url": "string"\n          },\n          "changes": [\n            {\n              "field": "string",\n              "label": "string",\n              "from": {\n                "type": "text",\n                "value": {},\n                "values": ["string"],\n                "id": "string",\n                "name": "string",\n                "schema": "string",\n                "color": "success"\n              },\n              "to": {\n                "type": "text",\n                "value": {},\n                "values": ["string"],\n                "id": "string",\n                "name": "string",\n                "schema": "string",\n                "color": "success"\n              }\n            }\n          ],\n          "metadata": {},\n          "summary": "This email discusses solar panel installation and should be handled by the Service team."\n        }\n      },\n      "metrics": {\n        "total_tokens": 0,\n        "input_tokens": 0,\n        "output_tokens": 0,\n        "total_cost_usd": 0,\n        "duration_ms": 0,\n        "iteration_count": 0\n      },\n      "started_at": "1970-01-01T00:00:00.000Z",\n      "completed_at": "1970-01-01T00:00:00.000Z",\n      "iterations": [\n        {\n          "index": 0,\n          "tool": "string",\n          "status": "running",\n          "timestamp": "1970-01-01T00:00:00.000Z"\n        }\n      ]\n    }\n  ],\n  "next_cursor": "string"\n}\n```\n\n</details>\n\n---\n\n### `getExecution`\n\nGet execution by ID\n\n`GET /v1/executions/{execution_id}`\n\n```ts\nconst { data } = await client.getExecution({\n  execution_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "agent_id": "skill:email-categorizer",\n  "agent_source": "system",\n  "agent_name": "string",\n  "execution_context": "flows",\n  "org_id": "string",\n  "status": "pending",\n  "input": {},\n  "parameters": {},\n  "result": {\n    "response": "string",\n    "structured_output": {}\n  },\n  "error": {\n    "code": "TIMEOUT",\n    "message": "string",\n    "details": {}\n  },\n  "pending_action": {\n    "tool": "string",\n    "input": {},\n    "description": "string",\n    "preview": {\n      "action": {\n        "type": "move",\n        "verb": "Move Thread"\n      },\n      "source": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "target": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "changes": [\n        {\n          "field": "string",\n          "label": "string",\n          "from": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          },\n          "to": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          }\n        }\n      ],\n      "metadata": {},\n      "summary": "This email discusses solar panel installation and should be handled by the Service team."\n    }\n  },\n  "metrics": {\n    "total_tokens": 0,\n    "input_tokens": 0,\n    "output_tokens": 0,\n    "total_cost_usd": 0,\n    "duration_ms": 0,\n    "iteration_count": 0\n  },\n  "started_at": "1970-01-01T00:00:00.000Z",\n  "completed_at": "1970-01-01T00:00:00.000Z",\n  "iterations": [\n    {\n      "index": 0,\n      "tool": "string",\n      "status": "running",\n      "timestamp": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `cancelExecution`\n\nCancel execution\n\n`DELETE /v1/executions/{execution_id}`\n\n```ts\nconst { data } = await client.cancelExecution({\n  execution_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "agent_id": "skill:email-categorizer",\n  "agent_source": "system",\n  "agent_name": "string",\n  "execution_context": "flows",\n  "org_id": "string",\n  "status": "pending",\n  "input": {},\n  "parameters": {},\n  "result": {\n    "response": "string",\n    "structured_output": {}\n  },\n  "error": {\n    "code": "TIMEOUT",\n    "message": "string",\n    "details": {}\n  },\n  "pending_action": {\n    "tool": "string",\n    "input": {},\n    "description": "string",\n    "preview": {\n      "action": {\n        "type": "move",\n        "verb": "Move Thread"\n      },\n      "source": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "target": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "changes": [\n        {\n          "field": "string",\n          "label": "string",\n          "from": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          },\n          "to": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          }\n        }\n      ],\n      "metadata": {},\n      "summary": "This email discusses solar panel installation and should be handled by the Service team."\n    }\n  },\n  "metrics": {\n    "total_tokens": 0,\n    "input_tokens": 0,\n    "output_tokens": 0,\n    "total_cost_usd": 0,\n    "duration_ms": 0,\n    "iteration_count": 0\n  },\n  "started_at": "1970-01-01T00:00:00.000Z",\n  "completed_at": "1970-01-01T00:00:00.000Z",\n  "iterations": [\n    {\n      "index": 0,\n      "tool": "string",\n      "status": "running",\n      "timestamp": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getExecutionTrace`\n\nGet execution trace/iterations\n\n`GET /v1/executions/{execution_id}/trace`\n\n```ts\nconst { data } = await client.getExecutionTrace({\n  execution_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "iterations": [\n    {\n      "iteration_index": 0,\n      "thought": "string",\n      "action": {\n        "tool": "string",\n        "input": {}\n      },\n      "observation": {},\n      "timestamp": "1970-01-01T00:00:00.000Z",\n      "tokens_used": 0,\n      "latency_ms": 0\n    }\n  ],\n  "total_iterations": 0\n}\n```\n\n</details>\n\n---\n\n### `getExecutionFeedback`\n\nGet execution feedback\n\n`GET /v1/executions/{execution_id}/feedback`\n\n```ts\nconst { data } = await client.getExecutionFeedback({\n  execution_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "feedback": {\n    "rating": "up",\n    "comment": "string",\n    "user_id": "string",\n    "submitted_at": "1970-01-01T00:00:00.000Z"\n  }\n}\n```\n\n</details>\n\n---\n\n### `putExecutionFeedback`\n\nSubmit execution feedback\n\n`PUT /v1/executions/{execution_id}/feedback`\n\n```ts\nconst { data } = await client.putExecutionFeedback(\n  {\n    execution_id: \'example\',\n  },\n  {\n    rating: \'up\',\n    comment: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "feedback": {\n    "rating": "up",\n    "comment": "string",\n    "user_id": "string",\n    "submitted_at": "1970-01-01T00:00:00.000Z"\n  }\n}\n```\n\n</details>\n\n---\n\n### `approveExecution`\n\nApprove pending action\n\n`POST /v1/executions/{execution_id}/approve`\n\n```ts\nconst { data } = await client.approveExecution(\n  {\n    execution_id: \'example\',\n  },\n  {\n    reason: \'string\',\n    approved_action_ids: [\'string\'],\n    rejected_action_ids: [\'string\'],\n    share_scope: \'primary_only\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "agent_id": "skill:email-categorizer",\n  "agent_source": "system",\n  "agent_name": "string",\n  "execution_context": "flows",\n  "org_id": "string",\n  "status": "pending",\n  "input": {},\n  "parameters": {},\n  "result": {\n    "response": "string",\n    "structured_output": {}\n  },\n  "error": {\n    "code": "TIMEOUT",\n    "message": "string",\n    "details": {}\n  },\n  "pending_action": {\n    "tool": "string",\n    "input": {},\n    "description": "string",\n    "preview": {\n      "action": {\n        "type": "move",\n        "verb": "Move Thread"\n      },\n      "source": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "target": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "changes": [\n        {\n          "field": "string",\n          "label": "string",\n          "from": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          },\n          "to": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          }\n        }\n      ],\n      "metadata": {},\n      "summary": "This email discusses solar panel installation and should be handled by the Service team."\n    }\n  },\n  "metrics": {\n    "total_tokens": 0,\n    "input_tokens": 0,\n    "output_tokens": 0,\n    "total_cost_usd": 0,\n    "duration_ms": 0,\n    "iteration_count": 0\n  },\n  "started_at": "1970-01-01T00:00:00.000Z",\n  "completed_at": "1970-01-01T00:00:00.000Z",\n  "iterations": [\n    {\n      "index": 0,\n      "tool": "string",\n      "status": "running",\n      "timestamp": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `rejectExecution`\n\nReject pending action\n\n`POST /v1/executions/{execution_id}/reject`\n\n```ts\nconst { data } = await client.rejectExecution(\n  {\n    execution_id: \'example\',\n  },\n  {\n    reason: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n  "agent_id": "skill:email-categorizer",\n  "agent_source": "system",\n  "agent_name": "string",\n  "execution_context": "flows",\n  "org_id": "string",\n  "status": "pending",\n  "input": {},\n  "parameters": {},\n  "result": {\n    "response": "string",\n    "structured_output": {}\n  },\n  "error": {\n    "code": "TIMEOUT",\n    "message": "string",\n    "details": {}\n  },\n  "pending_action": {\n    "tool": "string",\n    "input": {},\n    "description": "string",\n    "preview": {\n      "action": {\n        "type": "move",\n        "verb": "Move Thread"\n      },\n      "source": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "target": {\n        "type": "inbox",\n        "id": "string",\n        "name": "Support Inbox",\n        "schema": "string",\n        "icon": "string",\n        "url": "string"\n      },\n      "changes": [\n        {\n          "field": "string",\n          "label": "string",\n          "from": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          },\n          "to": {\n            "type": "text",\n            "value": {},\n            "values": ["string"],\n            "id": "string",\n            "name": "string",\n            "schema": "string",\n            "color": "success"\n          }\n        }\n      ],\n      "metadata": {},\n      "summary": "This email discusses solar panel installation and should be handled by the Service team."\n    }\n  },\n  "metrics": {\n    "total_tokens": 0,\n    "input_tokens": 0,\n    "output_tokens": 0,\n    "total_cost_usd": 0,\n    "duration_ms": 0,\n    "iteration_count": 0\n  },\n  "started_at": "1970-01-01T00:00:00.000Z",\n  "completed_at": "1970-01-01T00:00:00.000Z",\n  "iterations": [\n    {\n      "index": 0,\n      "tool": "string",\n      "status": "running",\n      "timestamp": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `streamExecution`\n\nReconnect to execution stream\n\n`GET /v1/executions/{execution_id}/stream`\n\n```ts\nconst { data } = await client.streamExecution({\n  execution_id: \'example\',\n  from_sequence: 1,\n})\n```\n\n---\n\n### `chat`\n\nStreaming chat with AI agent\n\n`POST /v1/chat`\n\n```ts\nconst { data } = await client.chat(\n  null,\n  {\n    agentId: \'string\',\n    message: \'string\',\n    conversationId: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    clientHistory: [\n      {\n        role: \'user\',\n        content: \'string\',\n        tool_calls: [\n          {\n            id: \'string\',\n            name: \'string\',\n            input: {},\n            output: \'string\'\n          }\n        ]\n      }\n    ],\n    context: {\n      entityId: \'string\',\n      customData: {}\n    },\n    streaming: {\n      mode: \'updates\',\n      streamTokens: false,\n      includeMetadata: false\n    }\n  },\n)\n```\n\n---\n\n### `listConversations`\n\nList conversations\n\n`GET /v1/conversations`\n\n```ts\nconst { data } = await client.listConversations({\n  agent_id: \'example\',\n  limit: 1,\n  cursor: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "conversations": [\n    {\n      "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "user_id": "string",\n      "agent_id": "string",\n      "title": "string",\n      "message_count": 0,\n      "last_message": "string",\n      "last_message_at": "1970-01-01T00:00:00.000Z",\n      "context": {\n        "entityId": "string",\n        "customData": {}\n      },\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "next_cursor": "string"\n}\n```\n\n</details>\n\n---\n\n### `getConversation`\n\nGet conversation with messages\n\n`GET /v1/conversations/{conversation_id}`\n\n```ts\nconst { data } = await client.getConversation({\n  conversation_id: \'example\',\n  message_limit: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "conversation": {\n    "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n    "user_id": "string",\n    "agent_id": "string",\n    "title": "string",\n    "message_count": 0,\n    "last_message": "string",\n    "last_message_at": "1970-01-01T00:00:00.000Z",\n    "context": {\n      "entityId": "string",\n      "customData": {}\n    },\n    "created_at": "1970-01-01T00:00:00.000Z",\n    "updated_at": "1970-01-01T00:00:00.000Z"\n  },\n  "messages": [\n    {\n      "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "role": "user",\n      "content": "string",\n      "timestamp": "1970-01-01T00:00:00.000Z",\n      "tool_calls": [\n        {\n          "id": "string",\n          "name": "string",\n          "input": {},\n          "output": "string"\n        }\n      ],\n      "token_count": 0,\n      "trace_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "feedback": {\n        "rating": "up",\n        "comment": "string",\n        "user_id": "string",\n        "submitted_at": "1970-01-01T00:00:00.000Z"\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `deleteConversation`\n\nDelete conversation\n\n`DELETE /v1/conversations/{conversation_id}`\n\n```ts\nconst { data } = await client.deleteConversation({\n  conversation_id: \'example\',\n})\n```\n\n---\n\n### `submitConversationFeedback`\n\nSubmit feedback for an assistant turn\n\n`POST /v1/conversations/{conversation_id}/feedback`\n\n```ts\nconst { data } = await client.submitConversationFeedback(\n  {\n    conversation_id: \'example\',\n  },\n  {\n    trace_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n    rating: \'up\',\n    comment: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "feedback": {\n    "rating": "up",\n    "comment": "string",\n    "user_id": "string",\n    "submitted_at": "1970-01-01T00:00:00.000Z"\n  }\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `AgentId`\n\nAgent identifier. Can be either:\n- System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"\n- Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"\n\n\n```ts\ntype AgentId = string\n```\n\n### `CreateAgentRequest`\n\n```ts\ntype CreateAgentRequest = {\n  name: string\n  description?: string\n  category?: "message" | "entity" | "document" | "classification" | "custom"\n  icon?: string\n  system_prompt: string\n  tools?: string[]\n  model_config?: {\n    model_id?: string\n    temperature?: number\n    max_tokens?: number\n    thinking?: boolean\n    thinking_budget?: number\n  }\n  max_iterations?: number\n  execution_pattern: "direct" | "react"\n  execution_mode?: "automatic" | "approval" | "draft"\n  output_schema?: object\n  input_parameters_schema?: {\n    type: "object"\n    parameters: Array<{\n      name: { ... }\n      label: { ... }\n      type: { ... }\n      description?: { ... }\n      default?: { ... }\n      multi?: { ... }\n      dependsOn?: { ... }\n      visibleWhen?: { ... }\n      enum?: { ... }\n      minimum?: { ... }\n      maximum?: { ... }\n      step?: { ... }\n      minLength?: { ... }\n      maxLength?: { ... }\n      schemaFilter?: { ... }\n      attributeTypeFilter?: { ... }\n      hidden?: { ... }\n    }>\n    required?: string[]\n  }\n}\n```\n\n### `UpdateAgentRequest`\n\n```ts\ntype UpdateAgentRequest = {\n  name?: string\n  description?: string\n  category?: "message" | "entity" | "document" | "classification" | "custom"\n  icon?: string\n  system_prompt?: string\n  tools?: string[]\n  model_config?: {\n    model_id?: string\n    temperature?: number\n    max_tokens?: number\n    thinking?: boolean\n    thinking_budget?: number\n  }\n  max_iterations?: number\n  execution_pattern?: "direct" | "react"\n  execution_mode?: "automatic" | "approval" | "draft"\n  output_schema?: object\n  input_parameters_schema?: {\n    type: "object"\n    parameters: Array<{\n      name: { ... }\n      label: { ... }\n      type: { ... }\n      description?: { ... }\n      default?: { ... }\n      multi?: { ... }\n      dependsOn?: { ... }\n      visibleWhen?: { ... }\n      enum?: { ... }\n      minimum?: { ... }\n      maximum?: { ... }\n      step?: { ... }\n      minLength?: { ... }\n      maxLength?: { ... }\n      schemaFilter?: { ... }\n      attributeTypeFilter?: { ... }\n      hidden?: { ... }\n    }>\n    required?: string[]\n  }\n}\n```\n\n### `AgentDefinition`\n\n```ts\ntype AgentDefinition = {\n  agent_id?: string\n  org_id?: string\n  name?: string\n  description?: string\n  category?: "message" | "entity" | "document" | "classification" | "custom"\n  icon?: string\n  source?: "system" | "custom"\n  availability?: "flows" | "copilot" | "portals" | "all"[]\n  allowed_entity_schemas?: string[]\n  system_prompt?: string\n  tools?: string[]\n  model_config?: {\n    model_id?: string\n    temperature?: number\n    max_tokens?: number\n    thinking?: boolean\n    thinking_budget?: number\n  }\n  max_iterations?: number\n  execution_pattern?: "direct" | "react"\n  execution_mode?: "automatic" | "approval" | "draft"\n  output_schema?: object\n  input_parameters_schema?: {\n    type: "object"\n    parameters: Array<{\n      name: { ... }\n      label: { ... }\n      type: { ... }\n      description?: { ... }\n      default?: { ... }\n      multi?: { ... }\n      dependsOn?: { ... }\n      visibleWhen?: { ... }\n      enum?: { ... }\n      minimum?: { ... }\n      maximum?: { ... }\n      step?: { ... }\n      minLength?: { ... }\n      maxLength?: { ... }\n      schemaFilter?: { ... }\n      attributeTypeFilter?: { ... }\n      hidden?: { ... }\n    }>\n    required?: string[]\n  }\n  version?: number\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: string\n}\n```\n\n### `ListAgentsResponse`\n\n```ts\ntype ListAgentsResponse = {\n  agents?: Array<{\n    agent_id?: string\n    org_id?: string\n    name?: string\n    description?: string\n    category?: "message" | "entity" | "document" | "classification" | "custom"\n    icon?: string\n    source?: "system" | "custom"\n    availability?: "flows" | "copilot" | "portals" | "all"[]\n    allowed_entity_schemas?: string[]\n    system_prompt?: string\n    tools?: string[]\n    model_config?: {\n      model_id?: { ... }\n      temperature?: { ... }\n      max_tokens?: { ... }\n      thinking?: { ... }\n      thinking_budget?: { ... }\n    }\n    max_iterations?: number\n    execution_pattern?: "direct" | "react"\n    execution_mode?: "automatic" | "approval" | "draft"\n    output_schema?: object\n    input_parameters_schema?: {\n      type: { ... }\n      parameters: { ... }\n      required?: { ... }\n    }\n    version?: number\n    created_at?: string // date-time\n    updated_at?: string // date-time\n    created_by?: string\n  }>\n  next_cursor?: string\n}\n```\n\n### `ListExecutionsResponse`\n\n```ts\ntype ListExecutionsResponse = {\n  executions?: Array<{\n    execution_id?: string // uuid\n    agent_id?: string\n    agent_source?: "system" | "custom"\n    agent_name?: string\n    execution_context?: "flows" | "copilot" | "api"\n    org_id?: string\n    status?: "pending" | "running" | "waiting_approval" | "completed" | "failed" | "cancelled"\n    input?: object\n    parameters?: object\n    result?: {\n      response?: { ... }\n      structured_output?: { ... }\n    }\n    error?: {\n      code?: { ... }\n      message?: { ... }\n      details?: { ... }\n    }\n    pending_action?: {\n      tool?: { ... }\n      input?: { ... }\n      description?: { ... }\n      preview?: { ... }\n    }\n    metrics?: {\n      total_tokens?: { ... }\n      input_tokens?: { ... }\n      output_tokens?: { ... }\n      total_cost_usd?: { ... }\n      duration_ms?: { ... }\n      iteration_count?: { ... }\n    }\n    started_at?: string // date-time\n    completed_at?: string // date-time\n    iterations?: Array<{\n      index?: { ... }\n      tool?: { ... }\n      status?: { ... }\n      timestamp?: { ... }\n    }>\n  }>\n  next_cursor?: string\n}\n```\n\n### `ApproveExecutionRequest`\n\n```ts\ntype ApproveExecutionRequest = {\n  reason?: string\n  approved_action_ids?: string[]\n  rejected_action_ids?: string[]\n  share_scope?: "primary_only" | "primary_and_relations"\n}\n```\n\n### `RejectExecutionRequest`\n\n```ts\ntype RejectExecutionRequest = {\n  reason: string\n}\n```\n\n### `ExecuteAgentRequest`\n\n```ts\ntype ExecuteAgentRequest = {\n  input?: {\n    entity_id?: string\n    entity_schema?: string\n    workflow_id?: string\n    workflow_execution_id?: string\n    task_id?: string\n    custom_data?: Record<string, unknown>\n    flow_context?: Array<{\n      entity_id: { ... }\n      entity_schema: { ... }\n    }>\n  }\n  parameters?: Record<string, unknown>\n  execution_mode_override?: "automatic" | "approval" | "draft"\n  execution_context?: "flows" | "copilot" | "api"\n  callback_url?: string // uri\n  timeout_ms?: number\n}\n```\n\n### `ExecutionResponse`\n\n```ts\ntype ExecutionResponse = {\n  execution_id?: string // uuid\n  agent_id?: string\n  agent_source?: "system" | "custom"\n  agent_name?: string\n  execution_context?: "flows" | "copilot" | "api"\n  org_id?: string\n  status?: "pending" | "running" | "waiting_approval" | "completed" | "failed" | "cancelled"\n  input?: object\n  parameters?: object\n  result?: {\n    response?: string\n    structured_output?: object\n  }\n  error?: {\n    code?: "TIMEOUT" | "MAX_ITERATIONS_EXCEEDED" | "TOOL_EXECUTION_FAILED" | "LLM_ERROR" | "INVALID_OUTPUT" | "REJECTED" | "INTERNAL_ERROR"\n    message?: string\n    details?: object\n  }\n  pending_action?: {\n    tool?: string\n    input?: object\n    description?: string\n    preview?: {\n      action?: { ... }\n      source?: { ... }\n      target?: { ... }\n      changes?: { ... }\n      metadata?: { ... }\n      summary?: { ... }\n    }\n  }\n  metrics?: {\n    total_tokens?: number\n    input_tokens?: number\n    output_tokens?: number\n    total_cost_usd?: number\n    duration_ms?: number\n    iteration_count?: number\n  }\n  started_at?: string // date-time\n  completed_at?: string // date-time\n  iterations?: Array<{\n    index?: number\n    tool?: string\n    status?: "running" | "completed"\n    timestamp?: string // date-time\n  }>\n}\n```\n\n### `ExecutionIterationProjection`\n\n```ts\ntype ExecutionIterationProjection = {\n  index?: number\n  tool?: string\n  status?: "running" | "completed"\n  timestamp?: string // date-time\n}\n```\n\n### `ExecutionFeedback`\n\n```ts\ntype ExecutionFeedback = {\n  rating: "up" | "down"\n  comment?: string\n  user_id: string\n  submitted_at: string // date-time\n}\n```\n\n### `ExecutionFeedbackResponse`\n\n```ts\ntype ExecutionFeedbackResponse = {\n  feedback: {\n    rating: "up" | "down"\n    comment?: string\n    user_id: string\n    submitted_at: string // date-time\n  }\n}\n```\n\n### `PutExecutionFeedbackRequest`\n\n```ts\ntype PutExecutionFeedbackRequest = {\n  rating: "up" | "down"\n  comment?: string\n}\n```\n\n### `ExecutionTrace`\n\n```ts\ntype ExecutionTrace = {\n  execution_id?: string // uuid\n  iterations?: Array<{\n    iteration_index?: number\n    thought?: string\n    action?: {\n      tool?: { ... }\n      input?: { ... }\n    }\n    observation?: object\n    timestamp?: string // date-time\n    tokens_used?: number\n    latency_ms?: number\n  }>\n  total_iterations?: number\n}\n```\n\n### `ExecutionIteration`\n\n```ts\ntype ExecutionIteration = {\n  iteration_index?: number\n  thought?: string\n  action?: {\n    tool?: string\n    input?: object\n  }\n  observation?: object\n  timestamp?: string // date-time\n  tokens_used?: number\n  latency_ms?: number\n}\n```\n\n### `PendingAction`\n\nAction waiting for approval (when status=waiting_approval)\n\n```ts\ntype PendingAction = {\n  tool?: string\n  input?: object\n  description?: string\n  preview?: {\n    action?: {\n      type: { ... }\n      verb: { ... }\n    }\n    source?: {\n      type?: { ... }\n      id?: { ... }\n      name?: { ... }\n      schema?: { ... }\n      icon?: { ... }\n      url?: { ... }\n    }\n    target?: {\n      type?: { ... }\n      id?: { ... }\n      name?: { ... }\n      schema?: { ... }\n      icon?: { ... }\n      url?: { ... }\n    }\n    changes?: Array<{\n      field?: { ... }\n      label?: { ... }\n      from?: { ... }\n      to?: { ... }\n    }>\n    metadata?: Record<string, {\n      type: { ... }\n      value?: { ... }\n      values?: { ... }\n      id?: { ... }\n      name?: { ... }\n      schema?: { ... }\n      color?: { ... }\n    }>\n    summary?: string\n  }\n}\n```\n\n### `ExecutionError`\n\n```ts\ntype ExecutionError = {\n  code?: "TIMEOUT" | "MAX_ITERATIONS_EXCEEDED" | "TOOL_EXECUTION_FAILED" | "LLM_ERROR" | "INVALID_OUTPUT" | "REJECTED" | "INTERNAL_ERROR"\n  message?: string\n  details?: object\n}\n```\n\n### `ExecutionMetrics`\n\n```ts\ntype ExecutionMetrics = {\n  total_tokens?: number\n  input_tokens?: number\n  output_tokens?: number\n  total_cost_usd?: number\n  duration_ms?: number\n  iteration_count?: number\n}\n```\n\n### `ToolPreview`\n\nStructured preview data for approval UI. Provides a generic format that any tool can populate.\n\n```ts\ntype ToolPreview = {\n  action?: {\n    type: "move" | "create" | "update" | "delete" | "apply" | "send" | "link" | "unlink" | "batch_approval"\n    verb: string\n  }\n  source?: {\n    type?: string\n    id?: string\n    name?: string\n    schema?: string\n    icon?: string\n    url?: string\n  }\n  target?: {\n    type?: string\n    id?: string\n    name?: string\n    schema?: string\n    icon?: string\n    url?: string\n  }\n  changes?: Array<{\n    field?: string\n    label?: string\n    from?: {\n      type: { ... }\n      value?: { ... }\n      values?: { ... }\n      id?: { ... }\n      name?: { ... }\n      schema?: { ... }\n      color?: { ... }\n    }\n    to?: {\n      type: { ... }\n      value?: { ... }\n      values?: { ... }\n      id?: { ... }\n      name?: { ... }\n      schema?: { ... }\n      color?: { ... }\n    }\n  }>\n  metadata?: Record<string, {\n    type: "text" | "number" | "boolean" | "list" | "entity" | "badge"\n    value?: unknown\n    values?: string[]\n    id?: string\n    name?: string\n    schema?: string\n    color?: "success" | "warning" | "error" | "info"\n  }>\n  summary?: string\n}\n```\n\n### `PreviewActionType`\n\nType of action being previewed\n\n```ts\ntype PreviewActionType = "move" | "create" | "update" | "delete" | "apply" | "send" | "link" | "unlink" | "batch_approval"\n```\n\n### `PreviewEntity`\n\nEntity reference for preview display\n\n```ts\ntype PreviewEntity = {\n  type?: string\n  id?: string\n  name?: string\n  schema?: string\n  icon?: string\n  url?: string\n}\n```\n\n### `PreviewChange`\n\nA single field change in the preview\n\n```ts\ntype PreviewChange = {\n  field?: string\n  label?: string\n  from?: {\n    type: "text" | "number" | "boolean" | "list" | "entity" | "badge"\n    value?: unknown\n    values?: string[]\n    id?: string\n    name?: string\n    schema?: string\n    color?: "success" | "warning" | "error" | "info"\n  }\n  to?: {\n    type: "text" | "number" | "boolean" | "list" | "entity" | "badge"\n    value?: unknown\n    values?: string[]\n    id?: string\n    name?: string\n    schema?: string\n    color?: "success" | "warning" | "error" | "info"\n  }\n}\n```\n\n### `PreviewValue`\n\nTyped value for preview display\n\n```ts\ntype PreviewValue = {\n  type: "text" | "number" | "boolean" | "list" | "entity" | "badge"\n  value?: unknown\n  values?: string[]\n  id?: string\n  name?: string\n  schema?: string\n  color?: "success" | "warning" | "error" | "info"\n}\n```\n\n### `ToolDefinition`\n\n```ts\ntype ToolDefinition = {\n  tool_id?: string\n  name?: string\n  description?: string\n  category?: "entity" | "message" | "taxonomy" | "rag" | "workflow"\n  parameters?: object\n  returns?: object\n  requires_approval?: boolean\n  enabled?: boolean\n}\n```\n\n### `SkillCategory`\n\n```ts\ntype SkillCategory = "message" | "entity" | "document" | "classification" | "custom"\n```\n\n### `AgentSource`\n\n- system: Pre-built by epilot (system skills)\n- custom: Created by organization\n\n\n```ts\ntype AgentSource = "system" | "custom"\n```\n\n### `SkillAvailability`\n\nWhere the skill/agent is available:\n- flows: Available in workflow automations\n- copilot: Available as a sub-agent in copilot\n- portals: Available in end-user self-service portals\n- all: Available everywhere\n\n\n```ts\ntype SkillAvailability = "flows" | "copilot" | "portals" | "all"\n```\n\n### `ExecutionContext`\n\nWhere the execution was triggered from:\n- flows: Triggered from workflow automation\n- copilot: Triggered from copilot assistant\n- api: Direct API call\n\n\n```ts\ntype ExecutionContext = "flows" | "copilot" | "api"\n```\n\n### `ExecutionPattern`\n\n- direct: Single LLM call, no tools\n- react: Multi-step reasoning with tool use\n\n\n```ts\ntype ExecutionPattern = "direct" | "react"\n```\n\n### `ExecutionMode`\n\n- automatic: Execute without human intervention\n- approval: Pause for human approval before tool execution\n- draft: Execute but mark output as draft for review\n\n\n```ts\ntype ExecutionMode = "automatic" | "approval" | "draft"\n```\n\n### `ExecutionStatus`\n\n```ts\ntype ExecutionStatus = "pending" | "running" | "waiting_approval" | "completed" | "failed" | "cancelled"\n```\n\n### `ParameterType`\n\nBase types:\n- text: Text input field\n- textarea: Multi-line text input field\n- number: Numeric input field\n- boolean: Toggle switch\n- select: Dropdown selection (requires enum array)\n\nCustom types (domain-specific):\n- entity-schema: Entity schema selector (fetches from Entity API)\n- entity-attribute\n\n```ts\ntype ParameterType = "text" | "textarea" | "number" | "boolean" | "select" | "entity-schema" | "entity-attribute" | "entity-id" | "taxonomy" | "taxonomy-classification" | "shared-inbox" | "label" | "matching-criteria"\n```\n\n### `InputParameterDefinition`\n\n```ts\ntype InputParameterDefinition = {\n  name: string\n  label: string\n  type: "text" | "textarea" | "number" | "boolean" | "select" | "entity-schema" | "entity-attribute" | "entity-id" | "taxonomy" | "taxonomy-classification" | "shared-inbox" | "label" | "matching-criteria"\n  description?: string\n  default?: unknown\n  multi?: boolean\n  dependsOn?: string\n  visibleWhen?: Record<string, unknown[]>\n  enum?: string[]\n  minimum?: number\n  maximum?: number\n  step?: number\n  minLength?: number\n  maxLength?: number\n  schemaFilter?: string[]\n  attributeTypeFilter?: string[]\n  hidden?: boolean\n}\n```\n\n### `InputParametersSchema`\n\n```ts\ntype InputParametersSchema = {\n  type: "object"\n  parameters: Array<{\n    name: string\n    label: string\n    type: "text" | "textarea" | "number" | "boolean" | "select" | "entity-schema" | "entity-attribute" | "entity-id" | "taxonomy" | "taxonomy-classification" | "shared-inbox" | "label" | "matching-criteria"\n    description?: string\n    default?: unknown\n    multi?: boolean\n    dependsOn?: string\n    visibleWhen?: Record<string, unknown[]>\n    enum?: string[]\n    minimum?: number\n    maximum?: number\n    step?: number\n    minLength?: number\n    maxLength?: number\n    schemaFilter?: string[]\n    attributeTypeFilter?: string[]\n    hidden?: boolean\n  }>\n  required?: string[]\n}\n```\n\n### `ModelConfig`\n\n```ts\ntype ModelConfig = {\n  model_id?: string\n  temperature?: number\n  max_tokens?: number\n  thinking?: boolean\n  thinking_budget?: number\n}\n```\n\n### `Error`\n\n```ts\ntype Error = {\n  error?: string\n  message?: string\n  details?: object\n}\n```\n\n### `ChatRequest`\n\n```ts\ntype ChatRequest = {\n  agentId: string\n  message: string\n  conversationId?: string // uuid\n  clientHistory?: Array<{\n    role: "user" | "assistant" | "tool" | "system"\n    content: string\n    tool_calls?: Array<{\n      id?: { ... }\n      name?: { ... }\n      input?: { ... }\n      output?: { ... }\n    }>\n  }>\n  context?: {\n    entityId?: string\n    customData?: Record<string, unknown>\n  }\n  streaming?: {\n    mode?: "updates" | "messages"\n    streamTokens?: boolean\n    includeMetadata?: boolean\n  }\n}\n```\n\n### `ChatMessage`\n\n```ts\ntype ChatMessage = {\n  role: "user" | "assistant" | "tool" | "system"\n  content: string\n  tool_calls?: Array<{\n    id?: string\n    name?: string\n    input?: object\n    output?: string\n  }>\n}\n```\n\n### `StreamingOptions`\n\n```ts\ntype StreamingOptions = {\n  mode?: "updates" | "messages"\n  streamTokens?: boolean\n  includeMetadata?: boolean\n}\n```\n\n### `StreamEvent`\n\nServer-Sent Event for streaming responses\n\n```ts\ntype StreamEvent = {\n  type?: "token" | "agent_step" | "tool_call" | "tool_result" | "complete" | "error" | "metadata" | "needs_approval"\n  content?: string\n  index?: number\n  tool?: string\n  input?: object\n  output?: string\n  callId?: string\n  result?: {\n    response?: string\n    structured_output?: object\n    status?: "completed" | "failed" | "max_iterations" | "rejected"\n    metrics?: {\n      total_tokens?: { ... }\n      input_tokens?: { ... }\n      output_tokens?: { ... }\n      total_cost_usd?: { ... }\n      duration_ms?: { ... }\n      iteration_count?: { ... }\n    }\n  }\n  error?: {\n    code?: string\n    message?: string\n  }\n  conversationId?: string // uuid\n}\n```\n\n### `ExecutionResult`\n\n```ts\ntype ExecutionResult = {\n  response?: string\n  structured_output?: object\n  status?: "completed" | "failed" | "max_iterations" | "rejected"\n  metrics?: {\n    total_tokens?: number\n    input_tokens?: number\n    output_tokens?: number\n    total_cost_usd?: number\n    duration_ms?: number\n    iteration_count?: number\n  }\n}\n```\n\n### `ConversationItem`\n\n```ts\ntype ConversationItem = {\n  conversation_id?: string // uuid\n  user_id?: string\n  agent_id?: string\n  title?: string\n  message_count?: number\n  last_message?: string\n  last_message_at?: string // date-time\n  context?: {\n    entityId?: string\n    customData?: object\n  }\n  created_at?: string // date-time\n  updated_at?: string // date-time\n}\n```\n\n### `MessageItem`\n\n```ts\ntype MessageItem = {\n  conversation_id?: string // uuid\n  role?: "user" | "assistant" | "tool" | "system"\n  content?: string\n  timestamp?: string // date-time\n  tool_calls?: Array<{\n    id?: string\n    name?: string\n    input?: object\n    output?: string\n  }>\n  token_count?: number\n  trace_id?: string // uuid\n  feedback?: {\n    rating: "up" | "down"\n    comment?: string\n    user_id: string\n    submitted_at: string // date-time\n  }\n}\n```\n\n### `MessageFeedback`\n\n```ts\ntype MessageFeedback = {\n  rating: "up" | "down"\n  comment?: string\n  user_id: string\n  submitted_at: string // date-time\n}\n```\n\n### `SubmitFeedbackRequest`\n\n```ts\ntype SubmitFeedbackRequest = {\n  trace_id: string // uuid\n  rating: "up" | "down"\n  comment?: string\n}\n```\n\n### `ListConversationsResponse`\n\n```ts\ntype ListConversationsResponse = {\n  conversations?: Array<{\n    conversation_id?: string // uuid\n    user_id?: string\n    agent_id?: string\n    title?: string\n    message_count?: number\n    last_message?: string\n    last_message_at?: string // date-time\n    context?: {\n      entityId?: { ... }\n      customData?: { ... }\n    }\n    created_at?: string // date-time\n    updated_at?: string // date-time\n  }>\n  next_cursor?: string\n}\n```\n\n### `ConversationWithMessages`\n\n```ts\ntype ConversationWithMessages = {\n  conversation?: {\n    conversation_id?: string // uuid\n    user_id?: string\n    agent_id?: string\n    title?: string\n    message_count?: number\n    last_message?: string\n    last_message_at?: string // date-time\n    context?: {\n      entityId?: { ... }\n      customData?: { ... }\n    }\n    created_at?: string // date-time\n    updated_at?: string // date-time\n  }\n  messages?: Array<{\n    conversation_id?: string // uuid\n    role?: "user" | "assistant" | "tool" | "system"\n    content?: string\n    timestamp?: string // date-time\n    tool_calls?: Array<{\n      id?: { ... }\n      name?: { ... }\n      input?: { ... }\n      output?: { ... }\n    }>\n    token_count?: number\n    trace_id?: string // uuid\n    feedback?: {\n      rating: { ... }\n      comment?: { ... }\n      user_id: { ... }\n      submitted_at: { ... }\n    }\n  }>\n}\n```\n';
+export {
+  ai_agents_default as default
+};