@epilot/sdk 2.18.21 → 2.18.22

package/dist/index.cjs

@@ -123,7 +123,7 @@ var _chunk2674L26Scjs = require('./chunk-2674L26S.cjs');
 var _chunkBM6NCHPLcjs = require('./chunk-BM6NCHPL.cjs');
 
 
-var _chunkLKV3RKOPcjs = require('./chunk-LKV3RKOP.cjs');
+var _chunkQKEPXYEFcjs = require('./chunk-QKEPXYEF.cjs');
 
 
 var _chunkVMCF5R6Rcjs = require('./chunk-VMCF5R6R.cjs');
@@ -158,7 +158,7 @@ var _chunkADSWGLIVcjs = require('./chunk-ADSWGLIV.cjs');
 
 
 
-var _chunkZCEIXRDJcjs = require('./chunk-ZCEIXRDJ.cjs');
+var _chunkQAEAAKLAcjs = require('./chunk-QAEAAKLA.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -225,7 +225,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunkZCEIXRDJcjs.createApiClient.call(void 0, {
+    entry.instance = _chunkQAEAAKLAcjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -258,7 +258,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunkZCEIXRDJcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkQAEAAKLAcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -323,7 +323,7 @@ var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
     name: "customerPortal",
-    loader: () => expandDef(_chunkLKV3RKOPcjs.require_customer_portal_runtime.call(void 0, ))
+    loader: () => expandDef(_chunkQKEPXYEFcjs.require_customer_portal_runtime.call(void 0, ))
   });
   registerApi({
     registry,
@@ -601,9 +601,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunkZCEIXRDJcjs.createApiHandle.call(void 0, {
+    return _chunkQAEAAKLAcjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunkZCEIXRDJcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkQAEAAKLAcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -651,9 +651,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunkZCEIXRDJcjs.help.call(void 0, apiName);
+          return (apiName) => _chunkQAEAAKLAcjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunkZCEIXRDJcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkQAEAAKLAcjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -683,4 +683,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkZCEIXRDJcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkZCEIXRDJcjs.help; exports.openapi = _chunkZCEIXRDJcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkQAEAAKLAcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkQAEAAKLAcjs.help; exports.openapi = _chunkQAEAAKLAcjs.openapi;

package/dist/index.d.cts

@@ -6,7 +6,7 @@ export { I as Interceptor, O as OverridesConfig, a as authorize } from './types-
 import { C as Client } from './access-token.d-BhRUc8I-.cjs';
 import { C as Client$1 } from './address.d-CwAPOVxa.cjs';
 import { C as Client$2 } from './address-suggestions.d-_YwTOR-9.cjs';
-import { C as Client$3 } from './ai-agents.d-BnR7CAeJ.cjs';
+import { C as Client$3 } from './ai-agents.d-B3TkP4mo.cjs';
 import { C as Client$4 } from './app.d-CZDjyxee.cjs';
 import { C as Client$5 } from './audit-logs.d-BRToFqeX.cjs';
 import { C as Client$6 } from './automation.d-DiWfPkLs.cjs';
@@ -15,7 +15,7 @@ import { C as Client$8 } from './blueprint-manifest.d-CjsI-JqR.cjs';
 import { C as Client$9 } from './calendar.d-mk-ltGpk.cjs';
 import { C as Client$a } from './configuration-hub.d-Dv41yC3b.cjs';
 import { C as Client$b } from './consent.d-C2PROHhX.cjs';
-import { C as Client$c } from './customer-portal.d-JVkJjm_e.cjs';
+import { C as Client$c } from './customer-portal.d-Ce8-UnSY.cjs';
 import { C as Client$d } from './dashboard.d-BSevFHjf.cjs';
 import { C as Client$e } from './data-governance.d-BbZ466j5.cjs';
 import { C as Client$f } from './deduplication.d-Cueh8bDD.cjs';

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { I as Interceptor, O as OverridesConfig, a as authorize } from './types-
 import { C as Client } from './access-token.d-BhRUc8I-.js';
 import { C as Client$1 } from './address.d-CwAPOVxa.js';
 import { C as Client$2 } from './address-suggestions.d-_YwTOR-9.js';
-import { C as Client$3 } from './ai-agents.d-BnR7CAeJ.js';
+import { C as Client$3 } from './ai-agents.d-B3TkP4mo.js';
 import { C as Client$4 } from './app.d-CZDjyxee.js';
 import { C as Client$5 } from './audit-logs.d-BRToFqeX.js';
 import { C as Client$6 } from './automation.d-DiWfPkLs.js';
@@ -15,7 +15,7 @@ import { C as Client$8 } from './blueprint-manifest.d-CjsI-JqR.js';
 import { C as Client$9 } from './calendar.d-mk-ltGpk.js';
 import { C as Client$a } from './configuration-hub.d-Dv41yC3b.js';
 import { C as Client$b } from './consent.d-C2PROHhX.js';
-import { C as Client$c } from './customer-portal.d-JVkJjm_e.js';
+import { C as Client$c } from './customer-portal.d-Ce8-UnSY.js';
 import { C as Client$d } from './dashboard.d-BSevFHjf.js';
 import { C as Client$e } from './data-governance.d-BbZ466j5.js';
 import { C as Client$f } from './deduplication.d-Cueh8bDD.js';

package/dist/index.js

@@ -123,7 +123,7 @@ import {
 } from "./chunk-2BPBDRRO.js";
 import {
   require_customer_portal_runtime
-} from "./chunk-EPDH37RS.js";
+} from "./chunk-AWKA7GZQ.js";
 import {
   require_dashboard_runtime
 } from "./chunk-TIRWWTDP.js";
@@ -158,7 +158,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-C2BFLFHE.js";
+} from "./chunk-S6BWLYUQ.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";

package/docs/ai-agents.md

@@ -73,6 +73,8 @@ const { data } = await aiAgentsClient.createAgent(...)
 - [`PendingAction`](#pendingaction)
 - [`ExecutionError`](#executionerror)
 - [`ExecutionMetrics`](#executionmetrics)
+- [`AgentExecutionEventStatus`](#agentexecutioneventstatus)
+- [`AgentExecutionEvent`](#agentexecutionevent)
 - [`ToolPreview`](#toolpreview)
 - [`PreviewActionType`](#previewactiontype)
 - [`PreviewEntity`](#previewentity)
@@ -105,7 +107,7 @@ const { data } = await aiAgentsClient.createAgent(...)
 
 ### `createAgent`
 
-Create Agent definition
+Creates a new custom agent. System skills cannot be created via this endpoint.
 
 `POST /v1/agents`
 
@@ -215,7 +217,8 @@ const { data } = await client.createAgent(
 
 ### `listAgents`
 
-List all agent configurations
+Lists agents from both system skills and custom agents.
+Use query parameters to filter by source, availability, or entity schema.
 
 `GET /v1/agents`
 
@@ -292,7 +295,9 @@ const { data } = await client.listAgents({
 
 ### `getAgentById`
 
-Get the agent configuration by ID
+Retrieves an agent by ID. Supports both:
+- System skill IDs (prefixed): "skill:email-categorizer"
+- Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
 
 `GET /v1/agents/{agent_id}`
 
@@ -362,7 +367,7 @@ const { data } = await client.getAgentById({
 
 ### `updateAgentById`
 
-Update the agent configuration by ID
+Updates a custom agent. System skills cannot be updated via this endpoint.
 
 `PUT /v1/agents/{agent_id}`
 
@@ -474,7 +479,7 @@ const { data } = await client.updateAgentById(
 
 ### `deleteAgentById`
 
-Delete the agent configuration by ID
+Deletes a custom agent. System skills cannot be deleted via this endpoint.
 
 `DELETE /v1/agents/{agent_id}`
 
@@ -488,7 +493,10 @@ const { data } = await client.deleteAgentById({
 
 ### `executeAgent`
 
-Execute an agent
+Executes an agent (system skill or custom agent).
+Supports both:
+- System skill IDs (prefixed): "skill:email-categorizer"
+- Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
 
 `POST /v1/agents/{agent_id}/execute`
 
@@ -624,7 +632,9 @@ const { data } = await client.executeAgent(
 
 ### `executeAgentStream`
 
-Execute an agent with streaming response
+Executes an agent with real-time streaming of tokens and tool events.
+Returns Server-Sent Events (SSE) stream with token-by-token output,
+tool call progress, and completion status.
 
 `POST /v1/agents/{agent_id}/execute/stream`
 
@@ -1007,7 +1017,7 @@ const { data } = await client.cancelExecution({
 
 ### `getExecutionTrace`
 
-Get execution trace/iterations
+Returns the step-by-step reasoning and tool calls for ReAct mode executions. Returns empty iterations array for direct mode executions.
 
 `GET /v1/executions/{execution_id}/trace`
 
@@ -1113,7 +1123,7 @@ const { data } = await client.putExecutionFeedback(
 
 ### `approveExecution`
 
-Approve pending action
+Approves a pending tool action when execution is in waiting_approval status
 
 `POST /v1/executions/{execution_id}/approve`
 
@@ -1125,8 +1135,7 @@ const { data } = await client.approveExecution(
   {
     reason: 'string',
     approved_action_ids: ['string'],
-    rejected_action_ids: ['string'],
-    share_scope: 'primary_only'
+    rejected_action_ids: ['string']
   },
 )
 ```
@@ -1234,7 +1243,7 @@ const { data } = await client.approveExecution(
 
 ### `rejectExecution`
 
-Reject pending action
+Rejects a pending tool action when execution is in waiting_approval status
 
 `POST /v1/executions/{execution_id}/reject`
 
@@ -1352,7 +1361,7 @@ const { data } = await client.rejectExecution(
 
 ### `streamExecution`
 
-Reconnect to execution stream
+Reconnects to an execution's event stream after approval. Replays missed events from event log and continues streaming if execution is still running.
 
 `GET /v1/executions/{execution_id}/stream`
 
@@ -1367,7 +1376,7 @@ const { data } = await client.streamExecution({
 
 ### `chat`
 
-Streaming chat with AI agent
+Initiates a streaming chat session with an AI agent. Supports server-side conversation memory via conversationId or client-provided history via clientHistory.
 
 `POST /v1/chat`
 
@@ -1409,7 +1418,7 @@ const { data } = await client.chat(
 
 ### `listConversations`
 
-List conversations
+Lists conversations for the authenticated user, sorted by most recent.
 
 `GET /v1/conversations`
 
@@ -1453,7 +1462,7 @@ const { data } = await client.listConversations({
 
 ### `getConversation`
 
-Get conversation with messages
+Retrieves a conversation and its message history.
 
 `GET /v1/conversations/{conversation_id}`
 
@@ -1517,7 +1526,7 @@ const { data } = await client.getConversation({
 
 ### `deleteConversation`
 
-Delete conversation
+Deletes a conversation and all its messages.
 
 `DELETE /v1/conversations/{conversation_id}`
 
@@ -1531,7 +1540,7 @@ const { data } = await client.deleteConversation({
 
 ### `submitConversationFeedback`
 
-Submit feedback for an assistant turn
+Records a thumbs up/down (with optional comment) for the assistant turn identified by its Langfuse trace id. The rating is persisted on the message and mirrored to Langfuse as a trace score.
 
 `POST /v1/conversations/{conversation_id}/feedback`
 
@@ -1827,7 +1836,6 @@ type ApproveExecutionRequest = {
   reason?: string
   approved_action_ids?: string[]
   rejected_action_ids?: string[]
-  share_scope?: "primary_only" | "primary_and_relations"
 }
 ```
 
@@ -2072,6 +2080,55 @@ type ExecutionMetrics = {
 }
 ```
 
+### `AgentExecutionEventStatus`
+
+Lifecycle status carried on an agent execution event.
+
+Deliberately narrower than `ExecutionStatus`, which is the stored status of
+the execution row: `pending` and `running` both surface as `started`, and
+`cancelled` surfaces as `failed`. Consumers must not assume the two
+vocabularies are interchang
+
+```ts
+type AgentExecutionEventStatus = "started" | "completed" | "failed" | "approval_required"
+```
+
+### `AgentExecutionEvent`
+
+Detail payload of the `agent-execution-status-update` event, published on
+the AI Agents event bus with source `ai-agents`.
+
+`execution_context` and `input` are present on every status, so a consumer
+can tell whether an execution is theirs, and what it belonged to, from the
+terminal event alone — wit
+
+```ts
+type AgentExecutionEvent = {
+  executionId: string
+  agentId: string
+  orgId: string
+  userId?: string
+  execution_status: "started" | "completed" | "failed" | "approval_required"
+  execution_context?: "flows" | "copilot" | "api"
+  input?: Record<string, unknown>
+  output?: Record<string, unknown>
+  error?: {
+    message?: string
+    code?: string
+    stack?: string
+  }
+  duration?: number
+  iterations?: number
+  iteration?: number
+  message?: string
+  toolCalls?: Array<{
+    name?: string
+    args?: Record<string, unknown>
+  }>
+  timestamp?: string // date-time
+}
+```
+
 ### `ToolPreview`
 
 Structured preview data for approval UI. Provides a generic format that any tool can populate.