skedyul 1.4.0 → 1.4.4

package/dist/cli/index.js

@@ -2776,7 +2776,13 @@ function getBakedExecutableEnv() {
 }
 function buildToolExecutionEnv(requestEnv = {}) {
   const bakedEnv = getBakedExecutableEnv();
-  const merged = { ...bakedEnv };
+  const merged = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  Object.assign(merged, bakedEnv);
   for (const [key, value] of Object.entries(requestEnv)) {
     if (value !== void 0) {
       merged[key] = value;

package/dist/config/types/navigation.d.ts

@@ -14,6 +14,8 @@ export interface NavigationItem {
     href: string;
     /** Optional Lucide icon name */
     icon?: string;
+    /** When true, item is omitted from rendered navigation (supports Liquid templates) */
+    hidden?: boolean | string;
 }
 /**
  * Navigation section with title and items.

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/dedicated/server.js

@@ -167,7 +167,13 @@ function getBakedExecutableEnv() {
 }
 function buildToolExecutionEnv(requestEnv = {}) {
   const bakedEnv = getBakedExecutableEnv();
-  const merged = { ...bakedEnv };
+  const merged = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  Object.assign(merged, bakedEnv);
   for (const [key, value] of Object.entries(requestEnv)) {
     if (value !== void 0) {
       merged[key] = value;

package/dist/esm/index.mjs

@@ -1630,7 +1630,9 @@ var NavigationItemSchema = z7.object({
   /** URL href (supports Liquid templates with path_params and context) */
   href: z7.string(),
   /** Optional icon name */
-  icon: z7.string().optional()
+  icon: z7.string().optional(),
+  /** When true, item is omitted from rendered navigation (supports Liquid templates) */
+  hidden: z7.union([z7.boolean(), z7.string()]).optional()
 });
 var NavigationSectionSchema = z7.object({
   /** Section title (supports Liquid templates) */
@@ -1984,7 +1986,13 @@ function getBakedExecutableEnv() {
 }
 function buildToolExecutionEnv(requestEnv = {}) {
   const bakedEnv = getBakedExecutableEnv();
-  const merged = { ...bakedEnv };
+  const merged = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  Object.assign(merged, bakedEnv);
   for (const [key, value] of Object.entries(requestEnv)) {
     if (value !== void 0) {
       merged[key] = value;
@@ -3128,6 +3136,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 +4776,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 +4811,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 +4825,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 +4833,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 +7615,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,
@@ -1955,7 +1956,9 @@ var NavigationItemSchema = import_v47.z.object({
   /** URL href (supports Liquid templates with path_params and context) */
   href: import_v47.z.string(),
   /** Optional icon name */
-  icon: import_v47.z.string().optional()
+  icon: import_v47.z.string().optional(),
+  /** When true, item is omitted from rendered navigation (supports Liquid templates) */
+  hidden: import_v47.z.union([import_v47.z.boolean(), import_v47.z.string()]).optional()
 });
 var NavigationSectionSchema = import_v47.z.object({
   /** Section title (supports Liquid templates) */
@@ -2309,7 +2312,13 @@ function getBakedExecutableEnv() {
 }
 function buildToolExecutionEnv(requestEnv = {}) {
   const bakedEnv = getBakedExecutableEnv();
-  const merged = { ...bakedEnv };
+  const merged = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  Object.assign(merged, bakedEnv);
   for (const [key, value] of Object.entries(requestEnv)) {
     if (value !== void 0) {
       merged[key] = value;
@@ -3453,6 +3462,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 +5102,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 +5137,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 +5151,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 +5159,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 +7942,7 @@ var index_default = { z: import_v413.z };
   ai,
   buildAgentContext,
   calculateWaitTime,
+  call,
   communicationChannel,
   compileAgent,
   compileWorkflow,

package/dist/schemas.d.ts

@@ -2429,6 +2429,7 @@ export declare const NavigationItemSchema: z.ZodObject<{
     label: z.ZodString;
     href: z.ZodString;
     icon: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
 }, z.core.$strip>;
 /** Navigation section with title and items */
 export declare const NavigationSectionSchema: z.ZodObject<{
@@ -2437,6 +2438,7 @@ export declare const NavigationSectionSchema: z.ZodObject<{
         label: z.ZodString;
         href: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
+        hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /** Sidebar navigation configuration */
@@ -2447,6 +2449,7 @@ export declare const NavigationSidebarSchema: z.ZodObject<{
             label: z.ZodString;
             href: z.ZodString;
             icon: z.ZodOptional<z.ZodString>;
+            hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -2471,6 +2474,7 @@ export declare const NavigationConfigSchema: z.ZodObject<{
                 label: z.ZodString;
                 href: z.ZodString;
                 icon: z.ZodOptional<z.ZodString>;
+                hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
@@ -2510,6 +2514,7 @@ export declare const PageDefinitionSchema: z.ZodObject<{
                     label: z.ZodString;
                     href: z.ZodString;
                     icon: z.ZodOptional<z.ZodString>;
+                    hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
@@ -3344,6 +3349,7 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                     label: z.ZodString;
                     href: z.ZodString;
                     icon: z.ZodOptional<z.ZodString>;
+                    hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
@@ -3377,6 +3383,7 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                         label: z.ZodString;
                         href: z.ZodString;
                         icon: z.ZodOptional<z.ZodString>;
+                        hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
@@ -4048,6 +4055,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                         label: z.ZodString;
                         href: z.ZodString;
                         icon: z.ZodOptional<z.ZodString>;
+                        hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
@@ -4081,6 +4089,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                             label: z.ZodString;
                             href: z.ZodString;
                             icon: z.ZodOptional<z.ZodString>;
+                            hidden: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
                         }, z.core.$strip>>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;

package/dist/server/utils/env.d.ts

@@ -11,8 +11,12 @@ export declare function parseNumberEnv(value?: string): number | null;
  */
 export declare function getBakedExecutableEnv(): Record<string, string>;
 /**
- * Env exposed to tool handlers: per-request values from the platform win over baked secrets.
- * Avoids leaking unrelated keys left in process.env during local `dev serve`.
+ * Env exposed to tool handlers.
+ *
+ * Layering (lowest → highest priority):
+ * 1. process.env — container-local values (`dev serve` loads provision secrets here)
+ * 2. MCP_ENV_JSON / MCP_ENV — baked secrets in deployed containers
+ * 3. requestEnv — per-request runtime values from the platform (token, API URL)
  */
 export declare function buildToolExecutionEnv(requestEnv?: Record<string, string | undefined>): Record<string, string | undefined>;
 /**

package/dist/server.js

@@ -167,7 +167,13 @@ function getBakedExecutableEnv() {
 }
 function buildToolExecutionEnv(requestEnv = {}) {
   const bakedEnv = getBakedExecutableEnv();
-  const merged = { ...bakedEnv };
+  const merged = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  Object.assign(merged, bakedEnv);
   for (const [key, value] of Object.entries(requestEnv)) {
     if (value !== void 0) {
       merged[key] = value;

package/dist/serverless/server.mjs

@@ -128,7 +128,13 @@ function getBakedExecutableEnv() {
 }
 function buildToolExecutionEnv(requestEnv = {}) {
   const bakedEnv = getBakedExecutableEnv();
-  const merged = { ...bakedEnv };
+  const merged = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  Object.assign(merged, bakedEnv);
   for (const [key, value] of Object.entries(requestEnv)) {
     if (value !== void 0) {
       merged[key] = value;

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.4",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",