skedyul 1.4.0 → 1.4.2

package/dist/core/client.d.ts

@@ -970,6 +970,82 @@ export declare const ai: {
      */
     generateObject<S extends z.ZodTypeAny>(options: GenerateObjectOptions<S>): Promise<z.infer<S>>;
 };
+export interface CallStartParams {
+    /** Communication channel (the Twilio number) this call belongs to */
+    communicationChannelId: string;
+    /** Caller number in E.164 */
+    fromNumber: string;
+    /** The dialed number (our Twilio number) in E.164 */
+    toNumber: string;
+    /** Number the call is forwarded/dialed to (the human agent leg) */
+    forwardedToNumber?: string | null;
+    direction?: 'INBOUND' | 'OUTBOUND';
+    /** Provider call id (Twilio CallSid) */
+    externalId?: string | null;
+    /** Raw provider status string (e.g. Twilio "ringing") */
+    externalStatus?: string | null;
+    /** Transcription provider/engine name (e.g. "deepgram", "google") */
+    transcriptionEngine?: string | null;
+    callerName?: string | null;
+    callerContactId?: string | null;
+    agentName?: string | null;
+    agentMemberId?: string | null;
+}
+export interface CallStartResult {
+    callSessionId: string;
+    threadId: string;
+}
+export interface CallAppendTranscriptParams {
+    callSessionId: string;
+    /** Utterance text */
+    content: string;
+    track?: 'inbound_track' | 'outbound_track';
+    speakerLabel?: string;
+    confidence?: number;
+    stability?: number;
+    sequenceId?: number;
+    isFinal?: boolean;
+    externalId?: string | null;
+}
+export interface CallEndParams {
+    callSessionId: string;
+    status?: 'SCHEDULED' | 'RINGING' | 'IN_PROGRESS' | 'ON_HOLD' | 'ENDED' | 'MISSED' | 'DECLINED' | 'FAILED';
+    externalStatus?: string | null;
+    /** Call duration in seconds */
+    duration?: number | null;
+    endedAt?: string | null;
+    recordingUrl?: string | null;
+    recordingSid?: string | null;
+}
+export interface CallSummarizeResult {
+    callSessionId: string;
+    summary: string | null;
+}
+/**
+ * Call client - manage a voice call session and its real-time transcript.
+ *
+ * Designed for the phone integration's Twilio Real-Time Transcription webhooks:
+ * - `start` when the inbound call arrives (creates the CallSession + thread + CALL block)
+ * - `appendTranscript` for each `transcription-content` event (stored as a tagged ThreadMessage)
+ * - `end` on call completion / `transcription-stopped`
+ * - `summarize` to generate and persist an end-of-call summary
+ *
+ * **Requires sk_wkp_ or sk_app_ token.**
+ */
+export declare const call: {
+    start(params: CallStartParams): Promise<CallStartResult>;
+    appendTranscript(params: CallAppendTranscriptParams): Promise<{
+        messageId: string;
+        threadId: string;
+    }>;
+    end(params: CallEndParams): Promise<{
+        callSessionId: string;
+        threadId: string;
+    }>;
+    summarize(params: {
+        callSessionId: string;
+    }): Promise<CallSummarizeResult>;
+};
 /**
  * Parameters for report.generate().
  */

package/dist/esm/index.mjs

@@ -3128,6 +3128,34 @@ var ai = {
     return data;
   }
 };
+var call = {
+  async start(params) {
+    const { data } = await callCore("call.start", {
+      ...params
+    });
+    return data;
+  },
+  async appendTranscript(params) {
+    const { data } = await callCore(
+      "call.appendTranscript",
+      { ...params }
+    );
+    return data;
+  },
+  async end(params) {
+    const { data } = await callCore(
+      "call.end",
+      { ...params }
+    );
+    return data;
+  },
+  async summarize(params) {
+    const { data } = await callCore("call.summarize", {
+      ...params
+    });
+    return data;
+  }
+};
 var report = {
   /**
    * Generate a report from a template.
@@ -4740,24 +4768,24 @@ async function handleMcpBatchRoute(req, ctx) {
     };
   }
   const perCallTimeoutMs = deadline ? Math.min(deadline, 25e3) : 25e3;
-  const executeWithTimeout = async (call, timeoutMs) => {
+  const executeWithTimeout = async (call2, timeoutMs) => {
     return new Promise(async (resolve4) => {
       const timeoutHandle = setTimeout(() => {
         resolve4({
-          id: call.id,
+          id: call2.id,
           success: false,
           error: "Timeout",
           timedOut: true
         });
       }, timeoutMs);
       try {
-        const toolName = call.name;
-        const toolArgs = call.arguments ?? {};
+        const toolName = call2.name;
+        const toolArgs = call2.arguments ?? {};
         const found = findToolInRegistry(ctx.registry, toolName);
         if (!found) {
           clearTimeout(timeoutHandle);
           resolve4({
-            id: call.id,
+            id: call2.id,
             success: false,
             error: `Tool "${toolName}" not found`
           });
@@ -4775,13 +4803,13 @@ async function handleMcpBatchRoute(req, ctx) {
         const isFailure2 = "success" in toolResult && toolResult.success === false || "error" in toolResult && toolResult.error != null;
         if (isFailure2) {
           resolve4({
-            id: call.id,
+            id: call2.id,
             success: false,
             error: "error" in toolResult && toolResult.error ? typeof toolResult.error === "string" ? toolResult.error : JSON.stringify(toolResult.error) : "Tool execution failed"
           });
         } else {
           resolve4({
-            id: call.id,
+            id: call2.id,
             success: true,
             result: "output" in toolResult ? toolResult.output : toolResult
           });
@@ -4789,7 +4817,7 @@ async function handleMcpBatchRoute(req, ctx) {
       } catch (err) {
         clearTimeout(timeoutHandle);
         resolve4({
-          id: call.id,
+          id: call2.id,
           success: false,
           error: err instanceof Error ? err.message : String(err)
         });
@@ -4797,7 +4825,7 @@ async function handleMcpBatchRoute(req, ctx) {
     });
   };
   const results = await Promise.all(
-    calls.map((call) => executeWithTimeout(call, perCallTimeoutMs))
+    calls.map((call2) => executeWithTimeout(call2, perCallTimeoutMs))
   );
   return {
     status: 200,
@@ -7579,6 +7607,7 @@ export {
   ai,
   buildAgentContext,
   calculateWaitTime,
+  call,
   communicationChannel,
   compileAgent,
   compileWorkflow,

package/dist/index.d.ts

@@ -6,8 +6,8 @@ export { DEFAULT_DOCKERFILE } from './dockerfile';
 export { InstallError, MissingRequiredFieldError, AuthenticationError, InvalidConfigurationError, ConnectionError, AppAuthInvalidError, } from './errors';
 export type { InstallErrorCode } from './errors';
 export { z };
-export { workplace, communicationChannel, instance, token, file, webhook, cron, event, resource, ai, report, configure, getConfig, runWithConfig, createInstanceClient, } from './core/client';
-export type { InstanceClient, InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, EventCreateResult, EventCreateOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, } from './core/client';
+export { workplace, communicationChannel, instance, token, file, webhook, cron, event, resource, ai, call, report, configure, getConfig, runWithConfig, createInstanceClient, } from './core/client';
+export type { InstanceClient, InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileInfo, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, CallStartParams, CallStartResult, CallAppendTranscriptParams, CallEndParams, CallSummarizeResult, CronSubscribeParams, CronSubscribeResult, CronSubscriptionItem, CronListOptions, EventCreateResult, EventCreateOptions, ResourceLinkParams, ResourceLinkResult, AITextContent, AIFileContent, AIImageContent, AIMessageContent, AIMessage, GenerateObjectOptions, GenerateObjectResult, ReportGenerateParams, ReportGenerateResult, ReportDefineParams, ReportDefineResult, ReportListParams, ReportListItem, ReportListResult, ReportDefinition, } from './core/client';
 export { createContextLogger } from './server/logger';
 export type { ContextLogger } from './server/logger';
 declare const _default: {

package/dist/index.js

@@ -241,6 +241,7 @@ __export(index_exports, {
   ai: () => ai,
   buildAgentContext: () => buildAgentContext,
   calculateWaitTime: () => calculateWaitTime,
+  call: () => call,
   communicationChannel: () => communicationChannel,
   compileAgent: () => compileAgent,
   compileWorkflow: () => compileWorkflow,
@@ -3453,6 +3454,34 @@ var ai = {
     return data;
   }
 };
+var call = {
+  async start(params) {
+    const { data } = await callCore("call.start", {
+      ...params
+    });
+    return data;
+  },
+  async appendTranscript(params) {
+    const { data } = await callCore(
+      "call.appendTranscript",
+      { ...params }
+    );
+    return data;
+  },
+  async end(params) {
+    const { data } = await callCore(
+      "call.end",
+      { ...params }
+    );
+    return data;
+  },
+  async summarize(params) {
+    const { data } = await callCore("call.summarize", {
+      ...params
+    });
+    return data;
+  }
+};
 var report = {
   /**
    * Generate a report from a template.
@@ -5065,24 +5094,24 @@ async function handleMcpBatchRoute(req, ctx) {
     };
   }
   const perCallTimeoutMs = deadline ? Math.min(deadline, 25e3) : 25e3;
-  const executeWithTimeout = async (call, timeoutMs) => {
+  const executeWithTimeout = async (call2, timeoutMs) => {
     return new Promise(async (resolve4) => {
       const timeoutHandle = setTimeout(() => {
         resolve4({
-          id: call.id,
+          id: call2.id,
           success: false,
           error: "Timeout",
           timedOut: true
         });
       }, timeoutMs);
       try {
-        const toolName = call.name;
-        const toolArgs = call.arguments ?? {};
+        const toolName = call2.name;
+        const toolArgs = call2.arguments ?? {};
         const found = findToolInRegistry(ctx.registry, toolName);
         if (!found) {
           clearTimeout(timeoutHandle);
           resolve4({
-            id: call.id,
+            id: call2.id,
             success: false,
             error: `Tool "${toolName}" not found`
           });
@@ -5100,13 +5129,13 @@ async function handleMcpBatchRoute(req, ctx) {
         const isFailure2 = "success" in toolResult && toolResult.success === false || "error" in toolResult && toolResult.error != null;
         if (isFailure2) {
           resolve4({
-            id: call.id,
+            id: call2.id,
             success: false,
             error: "error" in toolResult && toolResult.error ? typeof toolResult.error === "string" ? toolResult.error : JSON.stringify(toolResult.error) : "Tool execution failed"
           });
         } else {
           resolve4({
-            id: call.id,
+            id: call2.id,
             success: true,
             result: "output" in toolResult ? toolResult.output : toolResult
           });
@@ -5114,7 +5143,7 @@ async function handleMcpBatchRoute(req, ctx) {
       } catch (err) {
         clearTimeout(timeoutHandle);
         resolve4({
-          id: call.id,
+          id: call2.id,
           success: false,
           error: err instanceof Error ? err.message : String(err)
         });
@@ -5122,7 +5151,7 @@ async function handleMcpBatchRoute(req, ctx) {
     });
   };
   const results = await Promise.all(
-    calls.map((call) => executeWithTimeout(call, perCallTimeoutMs))
+    calls.map((call2) => executeWithTimeout(call2, perCallTimeoutMs))
   );
   return {
     status: 200,
@@ -7905,6 +7934,7 @@ var index_default = { z: import_v413.z };
   ai,
   buildAgentContext,
   calculateWaitTime,
+  call,
   communicationChannel,
   compileAgent,
   compileWorkflow,

package/dist/workflows/types.d.ts

@@ -251,10 +251,10 @@ export type WorkflowMetadata = z.infer<typeof WorkflowMetadataSchema>;
  * Workflow execution status
  */
 export declare const WorkflowExecutionStatusSchema: z.ZodEnum<{
+    FAILED: "FAILED";
     PENDING: "PENDING";
     RUNNING: "RUNNING";
     COMPLETED: "COMPLETED";
-    FAILED: "FAILED";
     CANCELLED: "CANCELLED";
     WAITING: "WAITING";
 }>;
@@ -264,10 +264,10 @@ export type WorkflowExecutionStatus = z.infer<typeof WorkflowExecutionStatusSche
  */
 export declare const WorkflowExecutionResultSchema: z.ZodObject<{
     status: z.ZodEnum<{
+        FAILED: "FAILED";
         PENDING: "PENDING";
         RUNNING: "RUNNING";
         COMPLETED: "COMPLETED";
-        FAILED: "FAILED";
         CANCELLED: "CANCELLED";
         WAITING: "WAITING";
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",