skedyul 1.5.2 → 1.5.12

package/dist/ratelimit/context.d.ts

@@ -4,7 +4,9 @@ export declare function getRateLimitExecutionContext(): RateLimitExecutionContex
 export declare function runWithActiveQueuedOperation<T>(operation: ActiveQueuedOperation<T>, fn: () => Promise<T>): Promise<T>;
 export declare function getActiveQueuedOperation<T>(): ActiveQueuedOperation<T> | undefined;
 export declare function getActiveQueuedOperationStack(): ActiveQueuedOperation<unknown>[];
-/** True when petbooqz_calendar_booking holds a lease in an outer queuedFetch. */
-export declare function isInsidePetbooqzCalendarBookingMutex(): boolean;
+/** Active mutex queue names holding a lease in an outer queuedFetch. */
+export declare function getActiveMutexQueueNames(): string[];
+/** True when an active mutex queue suppresses acquire for the target queue name. */
+export declare function shouldSkipNestedAcquire(queueName: string): boolean;
 export declare function setActiveQueuedOperationLease(lease: ActiveQueuedOperation<unknown>['lease']): void;
 export declare function updateActiveQueuedOperationAttempt(attempt: number): void;

package/dist/schemas.d.ts

@@ -369,12 +369,21 @@ export declare const ChannelCapabilityTypeSchema: z.ZodEnum<{
     messaging: "messaging";
     video: "video";
 }>;
+/** Batch send + status poll capability (preferred over bare send_batch string) */
+export declare const ChannelBatchCapabilitySchema: z.ZodObject<{
+    send: z.ZodString;
+    get_status: z.ZodString;
+}, z.core.$strip>;
 /** Capability definition with display info and handler references */
 export declare const ChannelCapabilitySchema: z.ZodObject<{
     label: z.ZodString;
     icon: z.ZodOptional<z.ZodString>;
     receive: z.ZodOptional<z.ZodString>;
     send: z.ZodOptional<z.ZodString>;
+    send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        send: z.ZodString;
+        get_status: z.ZodString;
+    }, z.core.$strip>]>>;
 }, z.core.$strip>;
 /**
  * Field definition for channel field mappings.
@@ -455,18 +464,30 @@ export declare const ChannelDefinitionSchema: z.ZodObject<{
             icon: z.ZodOptional<z.ZodString>;
             receive: z.ZodOptional<z.ZodString>;
             send: z.ZodOptional<z.ZodString>;
+            send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                send: z.ZodString;
+                get_status: z.ZodString;
+            }, z.core.$strip>]>>;
         }, z.core.$strip>>;
         voice: z.ZodOptional<z.ZodObject<{
             label: z.ZodString;
             icon: z.ZodOptional<z.ZodString>;
             receive: z.ZodOptional<z.ZodString>;
             send: z.ZodOptional<z.ZodString>;
+            send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                send: z.ZodString;
+                get_status: z.ZodString;
+            }, z.core.$strip>]>>;
         }, z.core.$strip>>;
         video: z.ZodOptional<z.ZodObject<{
             label: z.ZodString;
             icon: z.ZodOptional<z.ZodString>;
             receive: z.ZodOptional<z.ZodString>;
             send: z.ZodOptional<z.ZodString>;
+            send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                send: z.ZodString;
+                get_status: z.ZodString;
+            }, z.core.$strip>]>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -3384,18 +3405,30 @@ export declare const ProvisionConfigSchema: z.ZodObject<{
                 icon: z.ZodOptional<z.ZodString>;
                 receive: z.ZodOptional<z.ZodString>;
                 send: z.ZodOptional<z.ZodString>;
+                send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    send: z.ZodString;
+                    get_status: z.ZodString;
+                }, z.core.$strip>]>>;
             }, z.core.$strip>>;
             voice: z.ZodOptional<z.ZodObject<{
                 label: z.ZodString;
                 icon: z.ZodOptional<z.ZodString>;
                 receive: z.ZodOptional<z.ZodString>;
                 send: z.ZodOptional<z.ZodString>;
+                send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    send: z.ZodString;
+                    get_status: z.ZodString;
+                }, z.core.$strip>]>>;
             }, z.core.$strip>>;
             video: z.ZodOptional<z.ZodObject<{
                 label: z.ZodString;
                 icon: z.ZodOptional<z.ZodString>;
                 receive: z.ZodOptional<z.ZodString>;
                 send: z.ZodOptional<z.ZodString>;
+                send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    send: z.ZodString;
+                    get_status: z.ZodString;
+                }, z.core.$strip>]>>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
     }, z.core.$strip>>>;
@@ -4107,18 +4140,30 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                     icon: z.ZodOptional<z.ZodString>;
                     receive: z.ZodOptional<z.ZodString>;
                     send: z.ZodOptional<z.ZodString>;
+                    send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                        send: z.ZodString;
+                        get_status: z.ZodString;
+                    }, z.core.$strip>]>>;
                 }, z.core.$strip>>;
                 voice: z.ZodOptional<z.ZodObject<{
                     label: z.ZodString;
                     icon: z.ZodOptional<z.ZodString>;
                     receive: z.ZodOptional<z.ZodString>;
                     send: z.ZodOptional<z.ZodString>;
+                    send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                        send: z.ZodString;
+                        get_status: z.ZodString;
+                    }, z.core.$strip>]>>;
                 }, z.core.$strip>>;
                 video: z.ZodOptional<z.ZodObject<{
                     label: z.ZodString;
                     icon: z.ZodOptional<z.ZodString>;
                     receive: z.ZodOptional<z.ZodString>;
                     send: z.ZodOptional<z.ZodString>;
+                    send_batch: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                        send: z.ZodString;
+                        get_status: z.ZodString;
+                    }, z.core.$strip>]>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>;
         }, z.core.$strip>>>;
@@ -4812,6 +4857,104 @@ export type MessageSendAttachment = z.infer<typeof MessageSendAttachmentSchema>;
 export type MessageSendMessage = z.infer<typeof MessageSendMessageSchema>;
 export type MessageSendInput = z.infer<typeof MessageSendInputSchema>;
 export type MessageSendOutput = z.infer<typeof MessageSendOutputSchema>;
+export declare const MessageBulkRecipientSchema: z.ZodObject<{
+    address: z.ZodString;
+    renderedBody: z.ZodString;
+    instanceId: z.ZodOptional<z.ZodString>;
+    threadId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    contactId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const MessageBulkSendInputSchema: z.ZodObject<{
+    channel: z.ZodObject<{
+        id: z.ZodString;
+        handle: z.ZodString;
+        identifierValue: z.ZodString;
+    }, z.core.$strip>;
+    recipients: z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        renderedBody: z.ZodString;
+        instanceId: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodString>;
+        messageId: z.ZodOptional<z.ZodString>;
+        contactId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    schedule: z.ZodOptional<z.ZodObject<{
+        at: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const MessageBulkSendOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        failed: "failed";
+        accepted: "accepted";
+    }>;
+    operationId: z.ZodOptional<z.ZodString>;
+    acceptedCount: z.ZodNumber;
+    rejectedCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type MessageBulkRecipient = z.infer<typeof MessageBulkRecipientSchema>;
+export type MessageBulkSendInput = z.infer<typeof MessageBulkSendInputSchema>;
+export type MessageBulkSendOutput = z.infer<typeof MessageBulkSendOutputSchema>;
+export declare const MessageBulkStatusMessageSchema: z.ZodObject<{
+    address: z.ZodString;
+    status: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const MessageBulkStatusStatsSchema: z.ZodObject<{
+    total: z.ZodOptional<z.ZodNumber>;
+    recipients: z.ZodOptional<z.ZodNumber>;
+    attempts: z.ZodOptional<z.ZodNumber>;
+    unaddressable: z.ZodOptional<z.ZodNumber>;
+    queued: z.ZodOptional<z.ZodNumber>;
+    sent: z.ZodOptional<z.ZodNumber>;
+    scheduled: z.ZodOptional<z.ZodNumber>;
+    delivered: z.ZodOptional<z.ZodNumber>;
+    read: z.ZodOptional<z.ZodNumber>;
+    undelivered: z.ZodOptional<z.ZodNumber>;
+    failed: z.ZodOptional<z.ZodNumber>;
+    canceled: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const MessageBulkStatusInputSchema: z.ZodObject<{
+    channel: z.ZodObject<{
+        id: z.ZodString;
+        handle: z.ZodString;
+        identifierValue: z.ZodString;
+    }, z.core.$strip>;
+    operationId: z.ZodString;
+}, z.core.$strip>;
+export declare const MessageBulkStatusOutputSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    status: z.ZodString;
+    complete: z.ZodBoolean;
+    mock: z.ZodOptional<z.ZodBoolean>;
+    stats: z.ZodOptional<z.ZodObject<{
+        total: z.ZodOptional<z.ZodNumber>;
+        recipients: z.ZodOptional<z.ZodNumber>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+        unaddressable: z.ZodOptional<z.ZodNumber>;
+        queued: z.ZodOptional<z.ZodNumber>;
+        sent: z.ZodOptional<z.ZodNumber>;
+        scheduled: z.ZodOptional<z.ZodNumber>;
+        delivered: z.ZodOptional<z.ZodNumber>;
+        read: z.ZodOptional<z.ZodNumber>;
+        undelivered: z.ZodOptional<z.ZodNumber>;
+        failed: z.ZodOptional<z.ZodNumber>;
+        canceled: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    messages: z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        status: z.ZodString;
+        messageId: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        errorMessage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MessageBulkStatusMessage = z.infer<typeof MessageBulkStatusMessageSchema>;
+export type MessageBulkStatusStats = z.infer<typeof MessageBulkStatusStatsSchema>;
+export type MessageBulkStatusInput = z.infer<typeof MessageBulkStatusInputSchema>;
+export type MessageBulkStatusOutput = z.infer<typeof MessageBulkStatusOutputSchema>;
 export declare function isModelDependency(dep: ResourceDependency): dep is ModelDependency;
 export declare function isChannelDependency(dep: ResourceDependency): dep is ChannelDependency;
 export declare function isWorkflowDependency(dep: ResourceDependency): dep is WorkflowDependency;

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

@@ -1,9 +1,9 @@
 import * as z from 'zod';
-import type { BillingInfo, ToolSchema, ToolSchemaWithJson } from '../../types';
+import type { BillingInfo, ToolBilling, ToolSchema, ToolSchemaWithJson } from '../../types';
 /**
- * Normalizes billing info to ensure credits field exists
+ * Normalizes billing info to ensure credits field exists while preserving estimate data.
  */
-export declare function normalizeBilling(billing?: BillingInfo): BillingInfo;
+export declare function normalizeBilling(billing?: BillingInfo | ToolBilling): ToolBilling;
 /**
  * Converts a Zod schema to JSON Schema format
  */

package/dist/server.js

@@ -100,9 +100,12 @@ function registerQueueConfig(config) {
 // src/server/utils/schema.ts
 var z = __toESM(require("zod"));
 function normalizeBilling(billing) {
-  if (!billing || typeof billing.credits !== "number") {
+  if (!billing || typeof billing !== "object") {
     return { credits: 0 };
   }
+  if (typeof billing.credits !== "number") {
+    return { ...billing, credits: 0 };
+  }
   return billing;
 }
 function toJsonSchema(schema) {
@@ -436,6 +439,7 @@ function buildToolMetadata(registry) {
     const timeout = typeof rawTimeout === "number" && rawTimeout > 0 ? rawTimeout : 1e4;
     const retries = typeof rawRetries === "number" && rawRetries >= 1 ? rawRetries : 1;
     const queueTouchPoints = tool.queueTouchPoints ?? toolConfig.queueTouchPoints;
+    const rateLimitHandoff = tool.rateLimitHandoff ?? toolConfig.rateLimitHandoff;
     return {
       name: tool.name,
       displayName: tool.label || tool.name,
@@ -446,11 +450,13 @@ function buildToolMetadata(registry) {
       timeout,
       retries,
       queueTouchPoints,
+      rateLimitHandoff,
       config: {
         timeout,
         retries,
         completionHints: toolConfig.completionHints,
-        queueTouchPoints
+        queueTouchPoints,
+        rateLimitHandoff
       }
     };
   });
@@ -492,7 +498,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
     }
     const fn = tool.handler;
     const args = toolArgsInput ?? {};
-    const estimateMode = args.estimate === true;
+    const rawContextForMode = args.context ?? {};
+    const estimateMode = args.estimate === true || rawContextForMode.mode === "estimate";
     if (!estimateMode) {
       state.incrementRequestCount();
       if (state.shouldShutdown()) {
@@ -979,7 +986,8 @@ function serializeConfig(config) {
       // Read timeout/retries from top-level first, then fallback to config
       timeout: tool.timeout ?? tool.config?.timeout,
       retries: tool.retries ?? tool.config?.retries,
-      queueTouchPoints: tool.queueTouchPoints ?? tool.config?.queueTouchPoints
+      queueTouchPoints: tool.queueTouchPoints ?? tool.config?.queueTouchPoints,
+      rateLimitHandoff: tool.rateLimitHandoff ?? tool.config?.rateLimitHandoff
     })) : [],
     webhooks: webhookRegistry ? Object.values(webhookRegistry).map((w) => ({
       name: w.name,
@@ -1674,11 +1682,12 @@ async function handleMcpRoute(req, ctx) {
 async function handleMcpToolsCall(params, id, ctx) {
   const toolName = params?.name;
   const rawArgs = params?.arguments ?? {};
-  const hasSkedyulFormat = "inputs" in rawArgs || "env" in rawArgs || "context" in rawArgs || "invocation" in rawArgs;
+  const hasSkedyulFormat = "inputs" in rawArgs || "env" in rawArgs || "context" in rawArgs || "invocation" in rawArgs || "estimate" in rawArgs;
   const toolInputs = hasSkedyulFormat ? rawArgs.inputs ?? {} : rawArgs;
   const toolContext = hasSkedyulFormat ? rawArgs.context : void 0;
   const toolEnv = hasSkedyulFormat ? rawArgs.env : void 0;
   const toolInvocation = hasSkedyulFormat ? rawArgs.invocation : void 0;
+  const estimate = hasSkedyulFormat && rawArgs.estimate === true;
   const found = findToolInRegistry(ctx.registry, toolName);
   if (!found) {
     return {
@@ -1703,7 +1712,8 @@ async function handleMcpToolsCall(params, id, ctx) {
       inputs: validatedInputs,
       context: toolContext,
       env: toolEnv,
-      invocation: toolInvocation
+      invocation: toolInvocation,
+      estimate
     });
     let result;
     const isFailure = isToolCallFailure(toolResult);

package/dist/serverless/server.mjs

@@ -61,9 +61,12 @@ function registerQueueConfig(config) {
 // src/server/utils/schema.ts
 import * as z from "zod";
 function normalizeBilling(billing) {
-  if (!billing || typeof billing.credits !== "number") {
+  if (!billing || typeof billing !== "object") {
     return { credits: 0 };
   }
+  if (typeof billing.credits !== "number") {
+    return { ...billing, credits: 0 };
+  }
   return billing;
 }
 function toJsonSchema(schema) {
@@ -397,6 +400,7 @@ function buildToolMetadata(registry) {
     const timeout = typeof rawTimeout === "number" && rawTimeout > 0 ? rawTimeout : 1e4;
     const retries = typeof rawRetries === "number" && rawRetries >= 1 ? rawRetries : 1;
     const queueTouchPoints = tool.queueTouchPoints ?? toolConfig.queueTouchPoints;
+    const rateLimitHandoff = tool.rateLimitHandoff ?? toolConfig.rateLimitHandoff;
     return {
       name: tool.name,
       displayName: tool.label || tool.name,
@@ -407,11 +411,13 @@ function buildToolMetadata(registry) {
       timeout,
       retries,
       queueTouchPoints,
+      rateLimitHandoff,
       config: {
         timeout,
         retries,
         completionHints: toolConfig.completionHints,
-        queueTouchPoints
+        queueTouchPoints,
+        rateLimitHandoff
       }
     };
   });
@@ -453,7 +459,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
     }
     const fn = tool.handler;
     const args = toolArgsInput ?? {};
-    const estimateMode = args.estimate === true;
+    const rawContextForMode = args.context ?? {};
+    const estimateMode = args.estimate === true || rawContextForMode.mode === "estimate";
     if (!estimateMode) {
       state.incrementRequestCount();
       if (state.shouldShutdown()) {
@@ -940,7 +947,8 @@ function serializeConfig(config) {
       // Read timeout/retries from top-level first, then fallback to config
       timeout: tool.timeout ?? tool.config?.timeout,
       retries: tool.retries ?? tool.config?.retries,
-      queueTouchPoints: tool.queueTouchPoints ?? tool.config?.queueTouchPoints
+      queueTouchPoints: tool.queueTouchPoints ?? tool.config?.queueTouchPoints,
+      rateLimitHandoff: tool.rateLimitHandoff ?? tool.config?.rateLimitHandoff
     })) : [],
     webhooks: webhookRegistry ? Object.values(webhookRegistry).map((w) => ({
       name: w.name,
@@ -1635,11 +1643,12 @@ async function handleMcpRoute(req, ctx) {
 async function handleMcpToolsCall(params, id, ctx) {
   const toolName = params?.name;
   const rawArgs = params?.arguments ?? {};
-  const hasSkedyulFormat = "inputs" in rawArgs || "env" in rawArgs || "context" in rawArgs || "invocation" in rawArgs;
+  const hasSkedyulFormat = "inputs" in rawArgs || "env" in rawArgs || "context" in rawArgs || "invocation" in rawArgs || "estimate" in rawArgs;
   const toolInputs = hasSkedyulFormat ? rawArgs.inputs ?? {} : rawArgs;
   const toolContext = hasSkedyulFormat ? rawArgs.context : void 0;
   const toolEnv = hasSkedyulFormat ? rawArgs.env : void 0;
   const toolInvocation = hasSkedyulFormat ? rawArgs.invocation : void 0;
+  const estimate = hasSkedyulFormat && rawArgs.estimate === true;
   const found = findToolInRegistry(ctx.registry, toolName);
   if (!found) {
     return {
@@ -1664,7 +1673,8 @@ async function handleMcpToolsCall(params, id, ctx) {
       inputs: validatedInputs,
       context: toolContext,
       env: toolEnv,
-      invocation: toolInvocation
+      invocation: toolInvocation,
+      estimate
     });
     let result;
     const isFailure = isToolCallFailure(toolResult);

package/dist/tools/sms/gsm7.d.ts

@@ -0,0 +1,11 @@
+export type SmsEncoding = 'GSM-7' | 'UCS-2';
+export type SmsSegmentEstimate = {
+    encoding: SmsEncoding;
+    characters: number;
+    septets?: number;
+    segments: number;
+};
+/** Strip characters that are not encodable in GSM-7. */
+export declare function toGsm7(value: unknown): string;
+/** Estimate SMS segment count for a message body. */
+export declare function estimateSmsSegments(text: string): SmsSegmentEstimate;

package/dist/types/estimation.d.ts

@@ -0,0 +1,95 @@
+import { z } from 'zod/v4';
+import type { ToolBilling } from './tool';
+/**
+ * Money expressed in a currency's minor unit (e.g. cents, pence).
+ * Use ISO 4217 codes so amounts format correctly across locales.
+ */
+export interface MoneyMinorUnits {
+    /** ISO 4217 currency code (USD, AUD, EUR, …) */
+    currency: string;
+    /** Amount in the currency's smallest unit */
+    minorUnits: number;
+}
+/** Inclusive range of estimated charges in minor currency units. */
+export interface MoneyMinorRange {
+    currency: string;
+    minorUnitsLow: number;
+    minorUnitsHigh: number;
+    /** Optional skewed expected charge for single-value display (~$X.XX). */
+    minorUnitsExpected?: number;
+}
+/** Why a cohort member was excluded from a bulk send estimate. */
+export interface EstimationSkippedBreakdown {
+    missingAddress: number;
+    optOut: number;
+    emptyMessage: number;
+    unavailable: number;
+}
+/**
+ * Standard estimate payload for tool estimate mode and platform estimate APIs.
+ * Channel-agnostic — integrations populate `cost` when pricing is known.
+ */
+export interface Estimation {
+    deliverableCount: number;
+    skippedCount?: number;
+    skippedBreakdown?: EstimationSkippedBreakdown;
+    cost?: MoneyMinorRange;
+}
+export declare const MoneyMinorRangeSchema: z.ZodObject<{
+    currency: z.ZodString;
+    minorUnitsLow: z.ZodNumber;
+    minorUnitsHigh: z.ZodNumber;
+    minorUnitsExpected: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const EstimationSkippedBreakdownSchema: z.ZodObject<{
+    missingAddress: z.ZodNumber;
+    optOut: z.ZodNumber;
+    emptyMessage: z.ZodNumber;
+    unavailable: z.ZodNumber;
+}, z.core.$strip>;
+export declare const EstimationSchema: z.ZodObject<{
+    deliverableCount: z.ZodNumber;
+    skippedCount: z.ZodOptional<z.ZodNumber>;
+    skippedBreakdown: z.ZodOptional<z.ZodObject<{
+        missingAddress: z.ZodNumber;
+        optOut: z.ZodNumber;
+        emptyMessage: z.ZodNumber;
+        unavailable: z.ZodNumber;
+    }, z.core.$strip>>;
+    cost: z.ZodOptional<z.ZodObject<{
+        currency: z.ZodString;
+        minorUnitsLow: z.ZodNumber;
+        minorUnitsHigh: z.ZodNumber;
+        minorUnitsExpected: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function createMoneyMinorRange(params: {
+    currency: string;
+    minorUnitsLow: number;
+    minorUnitsHigh: number;
+    minorUnitsExpected?: number;
+}): MoneyMinorRange;
+export declare function createEstimation(params: {
+    deliverableCount: number;
+    skippedCount?: number;
+    skippedBreakdown?: EstimationSkippedBreakdown;
+    cost?: MoneyMinorRange;
+}): Estimation;
+/** Skew expected cost toward the typical case when only a range is known. */
+export declare function computeSkewedExpectedMinorUnits(range: MoneyMinorRange): number;
+export type FormatMoneyMinorEstimateOptions = {
+    locale?: string;
+    /** When set, overrides computed skew for display. */
+    expectedMinorUnits?: number;
+    /** Show a range instead of ~estimate when high/low ratio exceeds this (default 4). */
+    maxSpreadRatio?: number;
+};
+/** Format a minor-unit cost range for display (single amount when low === high). */
+export declare function formatMoneyMinorRange(range: MoneyMinorRange, locale?: string): string;
+/**
+ * Format an estimated charge for UI: prefer a single ~$X.XX educated guess.
+ * Falls back to a low–high range when the spread is still too wide.
+ */
+export declare function formatMoneyMinorEstimate(range: MoneyMinorRange, options?: FormatMoneyMinorEstimateOptions): string;
+/** Read standardized estimation from tool billing (supports legacy flat cost fields). */
+export declare function parseEstimationFromBilling(billing?: ToolBilling | Record<string, unknown>): Estimation | undefined;

package/dist/types/index.d.ts

@@ -10,6 +10,9 @@ export { createToolCallContext, createServerHookContext, createWebhookContext, c
 export type { ToolTrigger, ProvisionToolContext, DeveloperPageActionToolContext, DeveloperFormSubmitToolContext, FieldChangeToolContext, PageActionToolContext, FormSubmitToolContext, AgentToolContext, WorkflowToolContext, CronToolContext, CronContext, ToolExecutionContext, } from './tool-context';
 export { isProvisionContext, isRuntimeContext, isCronContext, isDeveloperContext } from './tool-context';
 export type { ToolResult, ToolSuccess, ToolFailure, ErrorCode, ErrorCategory, ToolWarning, ToolPagination, ToolBilling, ToolRetry, ToolTiming, ToolCompletionHints, ToolConfig, QueueTouchPoint, BillingInfo, ToolResponseMeta, ToolEffect, ToolError, ToolExecutionResult, ToolSchemaWithJson, ToolSchema, ToolHandler, ToolDefinition, ToolRegistryEntry, ToolRegistry, ToolName, ToolMetadata, ToolCallResponse, ExecutionScope, } from './tool';
+export type { MoneyMinorUnits, MoneyMinorRange, Estimation, EstimationSkippedBreakdown } from './estimation';
+export { MoneyMinorRangeSchema, EstimationSchema, EstimationSkippedBreakdownSchema, createMoneyMinorRange, createEstimation, parseEstimationFromBilling, formatMoneyMinorRange, formatMoneyMinorEstimate, computeSkewedExpectedMinorUnits, } from './estimation';
+export type { FormatMoneyMinorEstimateOptions } from './estimation';
 export { ToolResponseMetaSchema } from './tool';
 export { createSuccessResponse, createListResponse, createErrorResponse, createValidationError, createNotFoundError, createAuthError, createRateLimitError, createExternalError, createTimeoutError, createPermissionError, createConflictError, isSuccess, isFailure, isRetryable, getRetryDelay, } from './tool-response';
 export type { HealthStatus, ComputeLayer, DedicatedServerInstance, ServerlessServerInstance, SkedyulServerInstance, } from './server';

package/dist/types/tool.d.ts

@@ -60,9 +60,23 @@ export interface ToolPagination {
  * Billing/usage information.
  */
 export interface ToolBilling {
-    credits: number;
+    credits?: number;
     tokens?: number;
     cost?: number;
+    /** Standard estimate payload (preferred for estimate-mode tool calls). */
+    estimation?: import('./estimation').Estimation;
+    /**
+     * @deprecated Use `estimation.cost` — legacy flat minor-unit bounds.
+     */
+    costCentsLow?: number;
+    /**
+     * @deprecated Use `estimation.cost` — legacy flat minor-unit bounds.
+     */
+    costCentsHigh?: number;
+    /**
+     * @deprecated Use `estimation.cost.currency` — legacy ISO 4217 code.
+     */
+    currency?: string;
 }
 /**
  * Client-side effects to execute after tool completion.
@@ -104,6 +118,11 @@ export interface QueueTouchPoint {
     /** True for correctness mutexes — excluded from rate-limit probe admission */
     mutexOnly?: boolean;
 }
+/** Workflow mutex handoff role for multi-step tool.call sequences. */
+export interface RateLimitHandoff {
+    role: 'mutex_reserve' | 'mutex_confirm' | 'mutex_book';
+    group?: string;
+}
 export interface ToolConfig {
     /** Timeout in milliseconds. Defaults to 10000 (10 seconds) if not specified. */
     timeout?: number;
@@ -113,6 +132,8 @@ export interface ToolConfig {
     completionHints?: ToolCompletionHints;
     /** Rate-limit queue touch points for orchestration admission probes */
     queueTouchPoints?: QueueTouchPoint[];
+    /** Mutex lease handoff between workflow tool.call steps */
+    rateLimitHandoff?: RateLimitHandoff;
 }
 /**
  * Successful tool execution result.
@@ -186,7 +207,7 @@ export interface ToolExecutionResult<Output = unknown> {
     /** Discriminator for new ToolResult shape (true=success, false=failure) */
     success?: boolean;
     output: Output | null;
-    billing: BillingInfo;
+    billing: ToolBilling;
     meta?: ToolResponseMeta;
     effect?: ToolEffect;
     error?: ToolError | null;
@@ -230,6 +251,8 @@ export interface ToolDefinition<Input = unknown, Output = unknown, InputSchema e
     config?: ToolConfig;
     /** Rate-limit queue touch points (also accepted at top level for ergonomics) */
     queueTouchPoints?: QueueTouchPoint[];
+    /** Mutex lease handoff between workflow tool.call steps */
+    rateLimitHandoff?: RateLimitHandoff;
     /**
      * Execution scope for this tool.
      * - `installation` (default): Requires appInstallationId, receives sk_wkp_ token.
@@ -270,6 +293,8 @@ export interface ToolMetadata {
     config?: ToolConfig;
     /** Rate-limit queue touch points for orchestration admission probes */
     queueTouchPoints?: QueueTouchPoint[];
+    /** Mutex lease handoff between workflow tool.call steps */
+    rateLimitHandoff?: RateLimitHandoff;
     /** Execution scope for this tool */
     executionScope?: ExecutionScope;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.5.2",
+  "version": "1.5.12",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -61,16 +61,22 @@
       "import": "./dist/scheduling/index.mjs",
       "require": "./dist/scheduling/index.js",
       "default": "./dist/scheduling/index.js"
+    },
+    "./estimation": {
+      "types": "./dist/types/estimation.d.ts",
+      "import": "./dist/estimation/index.mjs",
+      "require": "./dist/estimation/index.js",
+      "default": "./dist/estimation/index.js"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --emitDeclarationOnly && tsup",
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --emitDeclarationOnly && pnpm exec tsup-node",
     "db:generate": "echo 'No database generation needed for this package'",
     "dev": "npx nodemon --watch src --ext js,ts --exec \"pnpm run build\"",
-    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js dist-tests/tests/agent-schema-v3.test.js dist-tests/tests/ratelimit.test.js dist-tests/tests/config-loader.test.js"
+    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js dist-tests/tests/agent-schema-v3.test.js dist-tests/tests/ratelimit.test.js dist-tests/tests/config-loader.test.js dist-tests/tests/gsm7.test.js"
   },
   "keywords": [
     "mcp",