@epilot/sdk 2.18.8 → 2.18.10

package/docs/ai-agents.md

@@ -38,6 +38,8 @@ const { data } = await aiAgentsClient.createAgent(...)
 - [`getExecution`](#getexecution)
 - [`cancelExecution`](#cancelexecution)
 - [`getExecutionTrace`](#getexecutiontrace)
+- [`getExecutionFeedback`](#getexecutionfeedback)
+- [`putExecutionFeedback`](#putexecutionfeedback)
 - [`approveExecution`](#approveexecution)
 - [`rejectExecution`](#rejectexecution)
 - [`streamExecution`](#streamexecution)
@@ -63,6 +65,9 @@ const { data } = await aiAgentsClient.createAgent(...)
 - [`ExecuteAgentRequest`](#executeagentrequest)
 - [`ExecutionResponse`](#executionresponse)
 - [`ExecutionIterationProjection`](#executioniterationprojection)
+- [`ExecutionFeedback`](#executionfeedback)
+- [`ExecutionFeedbackResponse`](#executionfeedbackresponse)
+- [`PutExecutionFeedbackRequest`](#putexecutionfeedbackrequest)
 - [`ExecutionTrace`](#executiontrace)
 - [`ExecutionIteration`](#executioniteration)
 - [`PendingAction`](#pendingaction)
@@ -1040,6 +1045,72 @@ const { data } = await client.getExecutionTrace({
 
 ---
 
+### `getExecutionFeedback`
+
+Get execution feedback
+
+`GET /v1/executions/{execution_id}/feedback`
+
+```ts
+const { data } = await client.getExecutionFeedback({
+  execution_id: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "feedback": {
+    "rating": "up",
+    "comment": "string",
+    "user_id": "string",
+    "submitted_at": "1970-01-01T00:00:00.000Z"
+  }
+}
+```
+
+</details>
+
+---
+
+### `putExecutionFeedback`
+
+Submit execution feedback
+
+`PUT /v1/executions/{execution_id}/feedback`
+
+```ts
+const { data } = await client.putExecutionFeedback(
+  {
+    execution_id: 'example',
+  },
+  {
+    rating: 'up',
+    comment: 'string'
+  },
+)
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "feedback": {
+    "rating": "up",
+    "comment": "string",
+    "user_id": "string",
+    "submitted_at": "1970-01-01T00:00:00.000Z"
+  }
+}
+```
+
+</details>
+
+---
+
 ### `approveExecution`
 
 Approve pending action
@@ -1857,6 +1928,39 @@ type ExecutionIterationProjection = {
 }
 ```
 
+### `ExecutionFeedback`
+
+```ts
+type ExecutionFeedback = {
+  rating: "up" | "down"
+  comment?: string
+  user_id: string
+  submitted_at: string // date-time
+}
+```
+
+### `ExecutionFeedbackResponse`
+
+```ts
+type ExecutionFeedbackResponse = {
+  feedback: {
+    rating: "up" | "down"
+    comment?: string
+    user_id: string
+    submitted_at: string // date-time
+  }
+}
+```
+
+### `PutExecutionFeedbackRequest`
+
+```ts
+type PutExecutionFeedbackRequest = {
+  rating: "up" | "down"
+  comment?: string
+}
+```
+
 ### `ExecutionTrace`
 
 ```ts

package/docs/automation.md

@@ -86,6 +86,10 @@ const { data } = await automationClient.searchFlows(...)
 - [`AssignThreadAction`](#assignthreadaction)
 - [`MoveThreadConfig`](#movethreadconfig)
 - [`AssignThreadConfig`](#assignthreadconfig)
+- [`EntityAssignee`](#entityassignee)
+- [`AssignEntityConfig`](#assignentityconfig)
+- [`AssignEntityActionConfig`](#assignentityactionconfig)
+- [`AssignEntityAction`](#assignentityaction)
 - [`SendEmailActionConfig`](#sendemailactionconfig)
 - [`SendEmailAction`](#sendemailaction)
 - [`ForwardEmailActionConfig`](#forwardemailactionconfig)
@@ -351,6 +355,7 @@ const { data } = await client.startExecution(
         parent_task_id: 'string',
         depth: 0
       },
+      _automation_chain: ['string'],
       entity_contexts: [
         {
           entity_id: 'string',
@@ -476,6 +481,7 @@ const { data } = await client.startExecution(
       "parent_task_id": "string",
       "depth": 0
     },
+    "_automation_chain": ["string"],
     "entity_contexts": [
       {}
     ]
@@ -841,6 +847,7 @@ const { data } = await client.getExecution({
       "parent_task_id": "string",
       "depth": 0
     },
+    "_automation_chain": ["string"],
     "entity_contexts": [
       {}
     ]
@@ -985,6 +992,7 @@ const { data } = await client.cancelExecution({
       "parent_task_id": "string",
       "depth": 0
     },
+    "_automation_chain": ["string"],
     "entity_contexts": [
       {}
     ]
@@ -1093,6 +1101,7 @@ const { data } = await client.resumeExecutionWithToken(
       "workflow_exec_task_id": "string",
       "workflow_role": "trigger_workflow",
       "_execution_chain": {},
+      "_automation_chain": ["string"],
       "entity_contexts": []
     },
     "loops": [
@@ -1109,6 +1118,7 @@ const { data } = await client.resumeExecutionWithToken(
     "config": {
       "mapping_config": {},
       "target_schema": "string",
+      "use_uniqueness_criteria": true,
       "target_unique": ["string"],
       "mapping_attributes": [],
       "relation_attributes": [],
@@ -1506,6 +1516,7 @@ type AnyAction = {
       version?: { ... }
     }
     target_schema: string
+    use_uniqueness_criteria?: boolean
     target_unique?: string[]
     mapping_attributes?: Array<{
       target?: { ... }
@@ -1596,7 +1607,6 @@ type AnyAction = {
     wait_for_confirmation?: boolean
     reply_to_sender?: boolean
     reply_mode?: "reply_in_thread" | "new_email"
-    mark_as_done?: boolean
   // ...
 }
 ```
@@ -1616,6 +1626,7 @@ type AnyActionConfig = {
       version?: { ... }
     }
     target_schema: string
+    use_uniqueness_criteria?: boolean
     target_unique?: string[]
     mapping_attributes?: Array<{
       target?: { ... }
@@ -1703,7 +1714,6 @@ type AnyActionConfig = {
     payload?: Record<string, unknown>
   }
   condition_id?: string
-  schedule_id?: string
   // ...
 }
 ```
@@ -2053,6 +2063,7 @@ type MapEntityActionConfig = {
       version?: { ... }
     }
     target_schema: string
+    use_uniqueness_criteria?: boolean
     target_unique?: string[]
     mapping_attributes?: Array<{
       target?: { ... }
@@ -2108,6 +2119,7 @@ type MapEntityAction = {
       version?: { ... }
     }
     target_schema: string
+    use_uniqueness_criteria?: boolean
     target_unique?: string[]
     mapping_attributes?: Array<{
       target?: { ... }
@@ -2151,6 +2163,7 @@ type MapEntityConfig = {
     version?: number
   }
   target_schema: string
+  use_uniqueness_criteria?: boolean
   target_unique?: string[]
   mapping_attributes?: Array<{
     target?: string
@@ -2350,6 +2363,7 @@ type AssignThreadAction = {
     add?: string[]
     assignment_type?: "direct" | "even_distribution" | "sequential"
     only_available_users?: boolean
+    hold_until_available?: boolean
     match_user_skills?: boolean
     required_skill_categories?: string[]
     skill_match_mode?: "require_all" | "prefer"
@@ -2375,6 +2389,7 @@ type AssignThreadConfig = {
   add?: string[]
   assignment_type?: "direct" | "even_distribution" | "sequential"
   only_available_users?: boolean
+  hold_until_available?: boolean
   match_user_skills?: boolean
   required_skill_categories?: string[]
   skill_match_mode?: "require_all" | "prefer"
@@ -2383,6 +2398,117 @@ type AssignThreadConfig = {
 }
 ```
 
+### `EntityAssignee`
+
+A single assignee as stored in a user-relation attribute. Written through
+verbatim by the assign-entity worker. Note this object encoding differs
+deliberately from AssignThreadConfig, which stores bare id strings —
+each matches what its own target accepts.
+
+
+```ts
+type EntityAssignee = {
+  type: "user" | "partner_user" | "partner_organization" | "group"
+  user_id?: string
+  group_id?: string
+  org_id?: string
+  partner_id?: string
+  display_name?: string
+  email?: string
+}
+```
+
+### `AssignEntityConfig`
+
+```ts
+type AssignEntityConfig = {
+  attribute?: string
+  assignees?: Array<{
+    type: "user" | "partner_user" | "partner_organization" | "group"
+    user_id?: string
+    group_id?: string
+    org_id?: string
+    partner_id?: string
+    display_name?: string
+    email?: string
+  }>
+  write_mode?: "replace" | "append"
+  assignment_type?: "direct"
+  source?: {
+    id?: string
+    origin?: "trigger" | "action"
+    schema?: string
+  }
+}
+```
+
+### `AssignEntityActionConfig`
+
+```ts
+type AssignEntityActionConfig = {
+  id?: string
+  flow_action_id?: string
+  name?: string
+  type?: "assign-entity"
+  config?: {
+    attribute?: string
+    assignees?: Array<{
+      type: { ... }
+      user_id?: { ... }
+      group_id?: { ... }
+      org_id?: { ... }
+      partner_id?: { ... }
+      display_name?: { ... }
+      email?: { ... }
+    }>
+    write_mode?: "replace" | "append"
+    assignment_type?: "direct"
+    source?: {
+      id?: { ... }
+      origin?: { ... }
+      schema?: { ... }
+    }
+  }
+  allow_failure?: boolean
+  created_automatically?: boolean
+  is_bulk_action?: boolean
+  reason?: {
+    message?: string
+    payload?: Record<string, unknown>
+  }
+  condition_id?: string
+  schedule_id?: string
+  loop_id?: string
+}
+```
+
+### `AssignEntityAction`
+
+```ts
+type AssignEntityAction = {
+  type?: "assign-entity"
+  config?: {
+    attribute?: string
+    assignees?: Array<{
+      type: { ... }
+      user_id?: { ... }
+      group_id?: { ... }
+      org_id?: { ... }
+      partner_id?: { ... }
+      display_name?: { ... }
+      email?: { ... }
+    }>
+    write_mode?: "replace" | "append"
+    assignment_type?: "direct"
+    source?: {
+      id?: { ... }
+      origin?: { ... }
+      schema?: { ... }
+    }
+  }
+}
+```
+
 ### `SendEmailActionConfig`
 
 ```ts
@@ -3185,6 +3311,7 @@ type AutomationExecution = {
     config?: {
       mapping_config?: { ... }
       target_schema: { ... }
+      use_uniqueness_criteria?: { ... }
       target_unique?: { ... }
       mapping_attributes?: { ... }
       relation_attributes?: { ... }
@@ -3228,7 +3355,6 @@ type AutomationExecution = {
     }
   } | {
     type?: "create-document"
-    config?: {
   // ...
 }
 ```
@@ -3254,6 +3380,7 @@ type WorkflowExecutionContext = {
     parent_task_id?: string
     depth?: number
   }
+  _automation_chain?: string[]
   entity_contexts?: Array<{
     entity_id?: string
     entity_schema?: string
@@ -3474,8 +3601,8 @@ type GetExecutionsResp = {
     } | {
       type?: { ... }
       config?: { ... }
-    }>
-    resume_token?: string
+    } | {
+      type?: { ... }
   // ...
 }
 ```
@@ -3592,8 +3719,8 @@ type SearchExecutionsResp = {
     } | {
       type?: { ... }
       config?: { ... }
-    }>
-    resume_token?: string
+    } | {
+      type?: { ... }
   // ...
 }
 ```
@@ -3613,6 +3740,7 @@ type StartExecutionRequest = {
       parent_task_id?: { ... }
       depth?: { ... }
     }
+    _automation_chain?: string[]
     entity_contexts?: Array<{
       entity_id?: { ... }
       entity_schema?: { ... }
@@ -4542,9 +4670,9 @@ type ResumeResp = {
     } | {
       type?: { ... }
       config?: { ... }
-    }>
-    resume_token?: string
-    trigger_context?: Record<string, string>
+    } | {
+      type?: { ... }
+      config?: { ... }
   // ...
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.18.8",
+  "version": "2.18.10",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/ai-agents-D6C5TXLD.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// 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- [`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- [`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### `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### `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';
-
-
-exports.default = ai_agents_default;