@superpanel-sdk/runtime 0.2.1 → 0.2.3

package/dist/core/stage/validate.js

@@ -2,7 +2,9 @@ import { getCompiledTable } from '../slot/compile-schema.js';
 import { parseFieldPath } from '../slot/path.js';
 import { extractTemplateFields } from './condition.js';
 import { whenFields } from './finish-when.js';
+import { headerHasTransferInterrupt, validateInterrupts } from './interrupts.js';
 import { LAST_TRANSFER_RESULT_FIELD } from './transfer-fields.js';
+import { validateTransferDestinations } from './transfer-spec.js';
 function fieldExists(schema, path) {
     const parsed = parseFieldPath(path);
     if (!parsed)
@@ -28,6 +30,10 @@ function earlierCollected(items, index) {
             for (const field of item.fields)
                 collected.add(field);
         }
+        if (item.kind === 'ivr') {
+            for (const field of whenFields(item.finishWhen))
+                collected.add(field);
+        }
     }
     return collected;
 }
@@ -74,6 +80,13 @@ export function validateCompiledAgenda(compiled, options) {
     const seenPlacement = new Set();
     const transferByResult = transferIndexByResultField(items);
     const firstTransfer = firstTransferIndex(items);
+    const transferInterrupt = headerHasTransferInterrupt(compiled.header);
+    if (compiled.header) {
+        issues.push(...validateInterrupts(compiled.header.interrupts, {
+            schema,
+            agendaId: prefix,
+        }));
+    }
     if (compiled.header?.channel && compiled.header.channel !== 'call') {
         for (const item of items) {
             if (item.kind === 'transfer') {
@@ -83,6 +96,13 @@ export function validateCompiledAgenda(compiled, options) {
                     path: `${prefix}/${item.placementId}`,
                 });
             }
+            if (item.kind === 'ivr') {
+                issues.push({
+                    code: 'ivr-channel',
+                    message: `IVR ${item.id} is only valid on call agendas`,
+                    path: `${prefix}/${item.placementId}`,
+                });
+            }
         }
     }
     if (compiled.header?.firstMessage?.kind === 'template') {
@@ -128,7 +148,7 @@ export function validateCompiledAgenda(compiled, options) {
                 continue;
             }
             if (field === LAST_TRANSFER_RESULT_FIELD) {
-                if (firstTransfer < 0 || firstTransfer >= index) {
+                if (!transferInterrupt && (firstTransfer < 0 || firstTransfer >= index)) {
                     issues.push({
                         code: 'transfer-result-before-node',
                         message: `applyWhen reads ${LAST_TRANSFER_RESULT_FIELD} before any transfer`,
@@ -152,6 +172,56 @@ export function validateCompiledAgenda(compiled, options) {
             }
         }
         requireBoolWhen(item.applyWhen, functions, issues, `${path}/applyWhen`, 'applyWhen');
+        if (item.kind === 'ivr') {
+            requireBoolWhen(item.finishWhen, functions, issues, `${path}/finishWhen`, 'finishWhen');
+            if (item.finishWhen.kind === 'rules') {
+                requireFields(schema, whenFields(item.finishWhen), issues, `${path}/finishWhen`);
+            }
+            const run = functions?.[item.onDtmfResult];
+            if (functions && !run) {
+                issues.push({
+                    code: 'unknown-function',
+                    message: `IVR '${item.id}' onDtmfResult unknown function '${item.onDtmfResult}'. Custom functions: ${listedCustomFunctions(functions)}`,
+                    path: `${path}/onDtmfResult`,
+                });
+            }
+            else if (run && run.kind !== 'custom') {
+                issues.push({
+                    code: 'ivr-run-not-custom',
+                    message: `IVR '${item.id}' onDtmfResult '${item.onDtmfResult}' must be defineCustomFunc`,
+                    path: `${path}/onDtmfResult`,
+                });
+            }
+            if (!item.loopSay.trim()) {
+                issues.push({
+                    code: 'ivr-say-empty',
+                    message: 'ivr loopSay must not be empty',
+                    path: `${path}/loopSay`,
+                });
+            }
+            if (!(item.confirmTimeoutMs > 0) || !(item.pauseAfterSayMs >= 0)) {
+                issues.push({
+                    code: 'ivr-timing',
+                    message: 'ivr confirmTimeoutMs must be > 0 and pauseAfterSayMs must be >= 0',
+                    path: `${path}/timing`,
+                });
+            }
+            if (item.fallbackAction !== 'end-call' && item.fallbackAction !== 'restore-normal-call-state') {
+                issues.push({
+                    code: 'ivr-fallback',
+                    message: 'ivr fallbackAction must be end-call or restore-normal-call-state',
+                    path: `${path}/fallbackAction`,
+                });
+            }
+            const digits = (item.validateDigits ?? []).map((digit) => digit.trim()).filter(Boolean);
+            if (!item.finishOnKey && digits.length === 0) {
+                issues.push({
+                    code: 'ivr-digits-empty',
+                    message: 'ivr needs validateDigits when finishOnKey is not set',
+                    path: `${path}/validateDigits`,
+                });
+            }
+        }
         if (item.kind === 'topic') {
             requireFields(schema, item.fields, issues, `${path}/fields`);
             const referenced = whenFields(item.finishWhen);
@@ -194,6 +264,26 @@ export function validateCompiledAgenda(compiled, options) {
             for (const number of item.numbers) {
                 requireFields(schema, extractTemplateFields(number), issues, `${path}/numbers`);
             }
+            if (item.arguments) {
+                for (const key of ['sendDigits', 'sipUrl', 'sipUsername', 'sipPassword']) {
+                    const text = item.arguments[key];
+                    if (text) {
+                        requireFields(schema, extractTemplateFields(text), issues, `${path}/arguments/${key}`);
+                    }
+                }
+            }
+            if (typeof item.say === 'string') {
+                requireFields(schema, extractTemplateFields(item.say), issues, `${path}/say`);
+            }
+            else if (item.say) {
+                for (const text of Object.values(item.say)) {
+                    requireFields(schema, extractTemplateFields(text), issues, `${path}/say`);
+                }
+            }
+            issues.push(...validateTransferDestinations(item.numbers, {
+                path: `${path}/numbers`,
+                code: 'transfer-target',
+            }));
             requireFields(schema, [item.resultField, LAST_TRANSFER_RESULT_FIELD], issues, `${path}/result`);
         }
     }
@@ -215,10 +305,24 @@ const FATAL_AGENDA_CODES = new Set([
     'branch-no-explicit',
     'otherwise-unexpanded',
     'transfer-channel',
+    'ivr-channel',
+    'ivr-run-not-custom',
+    'ivr-fallback',
+    'ivr-timing',
+    'ivr-say-empty',
+    'ivr-digits-empty',
     'transfer-result-before-node',
     'action-run-not-custom',
     'duplicate-placement',
     'block-kind-mismatch',
+    'interrupt-tool-reserved',
+    'interrupt-tool-duplicate',
+    'interrupt-priority-tie',
+    'interrupt-languages-empty',
+    'interrupt-language-field',
+    'interrupt-transfer-number',
+    'interrupt-escalation-criteria',
+    'transfer-target',
 ]);
 export function fatalAgendaIssues(issues) {
     return issues.filter((issue) => FATAL_AGENDA_CODES.has(issue.code));

package/dist/core/stage/walk.d.ts

@@ -9,11 +9,16 @@ export type WalkSkip = {
     reason: WalkSkipReason;
 };
 export type WalkHitReason = 'sticky' | 'scan';
+export type WalkStats = {
+    durationMs: number;
+    evals: number;
+};
 export type WalkResult = {
     hit: FlatAgendaItem | null;
     reason: WalkHitReason | 'complete';
     skipped: WalkSkip[];
     decisions: WalkDecision[];
+    stats: WalkStats;
 };
 export type WalkDecision = {
     placementId: string;

package/dist/core/stage/walk.js

@@ -1,4 +1,5 @@
 import { evaluateWhen } from './finish-when.js';
+import { ivrAttempted } from './ivr-fields.js';
 function startsWithGroup(groupPath, prefix) {
     if (prefix.length === 0)
         return true;
@@ -6,7 +7,7 @@ function startsWithGroup(groupPath, prefix) {
         return false;
     return prefix.every((id, i) => groupPath[i] === id);
 }
-async function consider(item, snapshot, compute, skip, via, skipped, decisions) {
+async function consider(item, snapshot, compute, skip, via, skipped, decisions, stats) {
     if (skip.has(item.placementId)) {
         skipped.push({ placementId: item.placementId, blockId: item.id, reason: 'skipped' });
         decisions.push({
@@ -19,6 +20,7 @@ async function consider(item, snapshot, compute, skip, via, skipped, decisions)
         });
         return 'skip';
     }
+    stats.evals += 1;
     const applies = await evaluateWhen(item.applyWhen, snapshot, compute);
     if (!applies.pass) {
         skipped.push({ placementId: item.placementId, blockId: item.id, reason: 'folded' });
@@ -32,6 +34,19 @@ async function consider(item, snapshot, compute, skip, via, skipped, decisions)
         });
         return 'fold';
     }
+    if (item.kind === 'ivr' && ivrAttempted(item, snapshot)) {
+        skipped.push({ placementId: item.placementId, blockId: item.id, reason: 'done' });
+        decisions.push({
+            placementId: item.placementId,
+            blockId: item.id,
+            status: 'done',
+            via,
+            applyWhen: true,
+            finishWhen: true,
+        });
+        return 'done';
+    }
+    stats.evals += 1;
     const finished = await evaluateWhen(item.finishWhen, snapshot, compute);
     if (finished.done) {
         skipped.push({ placementId: item.placementId, blockId: item.id, reason: 'done' });
@@ -55,40 +70,48 @@ async function consider(item, snapshot, compute, skip, via, skipped, decisions)
     });
     return 'hit';
 }
-async function firstHit(items, snapshot, compute, skip, via, skipped, decisions, considered) {
+async function firstHit(items, snapshot, compute, skip, via, skipped, decisions, considered, stats) {
     for (const item of items) {
         if (considered.has(item.placementId))
             continue;
         considered.add(item.placementId);
-        if ((await consider(item, snapshot, compute, skip, via, skipped, decisions)) === 'hit') {
+        if ((await consider(item, snapshot, compute, skip, via, skipped, decisions, stats)) === 'hit') {
             return item;
         }
     }
     return null;
 }
 export async function walkAgenda(items, snapshot, options = {}) {
+    const started = Date.now();
     const skip = options.skipPlacementIds ?? new Set();
     const skipped = [];
     const decisions = [];
     const considered = new Set();
+    const stats = { evals: 0 };
     const currentId = options.currentPlacementId ?? null;
+    const finish = (hit, reason) => ({
+        hit,
+        reason,
+        skipped,
+        decisions,
+        stats: { durationMs: Date.now() - started, evals: stats.evals },
+    });
     if (currentId) {
         const current = items.find((item) => item.placementId === currentId);
         if (current && current.groupPath.length > 0) {
             for (let depth = current.groupPath.length; depth >= 1; depth--) {
                 const prefix = current.groupPath.slice(0, depth);
                 const groupItems = items.filter((item) => startsWithGroup(item.groupPath, prefix));
-                const hit = await firstHit(groupItems, snapshot, options.compute, skip, 'sticky', skipped, decisions, considered);
-                if (hit) {
-                    return { hit, reason: 'sticky', skipped, decisions };
-                }
+                const hit = await firstHit(groupItems, snapshot, options.compute, skip, 'sticky', skipped, decisions, considered, stats);
+                if (hit)
+                    return finish(hit, 'sticky');
             }
         }
     }
-    const hit = await firstHit(items, snapshot, options.compute, skip, 'scan', skipped, decisions, considered);
+    const hit = await firstHit(items, snapshot, options.compute, skip, 'scan', skipped, decisions, considered, stats);
     if (hit)
-        return { hit, reason: 'scan', skipped, decisions };
-    return { hit: null, reason: 'complete', skipped, decisions };
+        return finish(hit, 'scan');
+    return finish(null, 'complete');
 }
 export async function unresolvedFinishWhenFields(item, snapshot, compute) {
     return (await evaluateWhen(item.finishWhen, snapshot, compute)).failedFields;

package/dist/fn-context/index.d.ts

@@ -3,7 +3,7 @@ export { buildActionContext, type BuildActionContextOptions } from './build-cont
 export { resolveSystemFnParams } from './system-args.js';
 export { createFakeApiHost, type FakeApiHostOptions } from './fake/index.js';
 export { defaultPlatformApis, emptyIntegration, type PlatformApiOverrides } from './fake/empty-api.js';
-export { createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, } from './rpc/index.js';
+export { createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, } from './rpc/index.js';
 export { bindLogMeta, noopLog } from './log.js';
 export { makeCtx, makeCtxAsync } from './make-ctx.js';
 export { defaultHttpApi } from '../core/context/http.js';

package/dist/fn-context/index.js

@@ -2,7 +2,7 @@ export { buildActionContext } from './build-context.js';
 export { resolveSystemFnParams } from './system-args.js';
 export { createFakeApiHost } from './fake/index.js';
 export { defaultPlatformApis, emptyIntegration } from './fake/empty-api.js';
-export { createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, } from './rpc/index.js';
+export { createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, } from './rpc/index.js';
 export { bindLogMeta, noopLog } from './log.js';
 export { makeCtx, makeCtxAsync } from './make-ctx.js';
 export { defaultHttpApi } from '../core/context/http.js';

package/dist/fn-context/rpc/index.d.ts

@@ -6,5 +6,5 @@ export { createListBindingsProcedure } from './integration/list-bindings.js';
 export { createPlatformRouter, type PlatformInvokeHandler } from './platform.js';
 export { createLogRouter, type LogEmitHandler } from './log.js';
 export { createRpcApiHost } from './trpc-client.js';
-export { LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, } from './request-id.js';
+export { LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, } from './request-id.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/fn-context/rpc/index.js

@@ -5,5 +5,5 @@ export { createListBindingsProcedure } from './integration/list-bindings.js';
 export { createPlatformRouter } from './platform.js';
 export { createLogRouter } from './log.js';
 export { createRpcApiHost } from './trpc-client.js';
-export { LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, } from './request-id.js';
+export { LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, } from './request-id.js';
 //# sourceMappingURL=index.js.map

package/dist/fn-context/rpc/request-id.d.ts

@@ -1,8 +1,13 @@
 export declare const REQUEST_ID_HEADER = "x-request-id";
 export declare const LOG_TAGS_HEADER = "x-superpanel-log-tags";
+export declare const RUNTIME_VERSION_HEADER = "x-superpanel-runtime-version";
+export declare function formatRuntimeVersion(version: string, source: 'local-file' | 'npm'): string;
 export declare function readRequestIdHeader(headers: {
     get(name: string): string | null;
 } | Record<string, string | string[] | undefined>): string | undefined;
+export declare function readRuntimeVersionHeader(headers: {
+    get(name: string): string | null;
+} | Record<string, string | string[] | undefined>): string | undefined;
 export declare function encodeLogTagsHeader(tags: string[]): string;
 export declare function readLogTagsHeader(headers: {
     get(name: string): string | null;

package/dist/fn-context/rpc/request-id.js

@@ -1,5 +1,9 @@
 export const REQUEST_ID_HEADER = 'x-request-id';
 export const LOG_TAGS_HEADER = 'x-superpanel-log-tags';
+export const RUNTIME_VERSION_HEADER = 'x-superpanel-runtime-version';
+export function formatRuntimeVersion(version, source) {
+    return `${version}-${source}`;
+}
 function firstString(value) {
     const raw = Array.isArray(value) ? value[0] : value;
     return typeof raw === 'string' && raw.length > 0 ? raw : undefined;
@@ -11,6 +15,13 @@ export function readRequestIdHeader(headers) {
     const record = headers;
     return firstString(record[REQUEST_ID_HEADER]);
 }
+export function readRuntimeVersionHeader(headers) {
+    if (typeof headers.get === 'function') {
+        return firstString(headers.get(RUNTIME_VERSION_HEADER));
+    }
+    const record = headers;
+    return firstString(record[RUNTIME_VERSION_HEADER]);
+}
 export function encodeLogTagsHeader(tags) {
     return JSON.stringify(tags);
 }

package/dist/fn-context/rpc/trpc-client.d.ts

@@ -2,6 +2,8 @@ import type { ApiHost } from '../types.js';
 export declare function createRpcApiHost(options: {
     baseUrl: string;
     getToken: () => string | Promise<string>;
+    runtimeVersion: string;
+    runtimeSource: 'local-file' | 'npm';
     getRequestId?: () => string | undefined;
     getTags?: () => string[] | undefined;
     waitUntil?: (promise: Promise<unknown>) => void;

package/dist/fn-context/rpc/trpc-client.js

@@ -3,7 +3,7 @@ import { platformSurfaces } from '../../core/context/platform-registry.js';
 import { defaultHttpApi } from '../../core/context/http.js';
 import { integrationSurfaceKeys, } from '../../core/context/types.js';
 import { bindEnvService } from '../../core/context/env.js';
-import { REQUEST_ID_HEADER } from './request-id.js';
+import { REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, formatRuntimeVersion, } from './request-id.js';
 function rpcLogger(c, getTags, waitUntil) {
     const emit = (level, message, extra) => {
         const pending = c.log.emit.mutate({ level, message, extra, tags: getTags?.() }).catch(() => { });
@@ -86,6 +86,7 @@ export function createRpcApiHost(options) {
                         headers: async () => {
                             const headers = {
                                 authorization: `Bearer ${await options.getToken()}`,
+                                [RUNTIME_VERSION_HEADER]: formatRuntimeVersion(options.runtimeVersion, options.runtimeSource),
                             };
                             const requestId = options.getRequestId?.();
                             if (requestId)
@@ -102,7 +103,10 @@ export function createRpcApiHost(options) {
     return {
         async buildApi(_run) {
             const c = getClient(options.baseUrl);
+            const started = Date.now();
+            console.log(`[rpc timing] integration.listBindings start url=${options.baseUrl}`);
             const metas = await rpcSafe(c.integration.listBindings.query());
+            console.log(`[rpc timing] integration.listBindings ok ${Date.now() - started}ms count=${metas.length}`);
             return {
                 ...buildPlatformApis(c),
                 integration: buildSurfaces(c, metas),

package/dist/fn-context/rpc/trpc-init.d.ts

@@ -2,6 +2,7 @@ import type { RunScope } from '../types.js';
 export type RpcContext = {
     run: RunScope;
     requestId?: string;
+    runtimeVersion?: string;
 };
 export declare const router: import("@trpc/server").TRPCRouterBuilder<{
     ctx: RpcContext;

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { idRef } from './core/slot/id-ref.js';
 export type { HubspotApi, HubspotAssociationListOutput, HubspotCreateContactInput, HubspotCreateContactOutput, HubspotCreateDealInput, HubspotCreateDealOutput, HubspotCreateNoteInput, HubspotCreateTaskInput, HubspotEngagementOutput, HubspotGetAssociatedContactsInput, HubspotGetAssociatedDealsInput, HubspotGetContactInput, HubspotGetContactOutput, HubspotGetCrmUrlInput, HubspotGetCrmUrlOutput, HubspotGetDealInput, HubspotGetDealOutput, HubspotGetOwnerInput, HubspotGetOwnerOutput, HubspotLogCallInput, HubspotLogEmailInput, HubspotLogSmsInput, HubspotRecord, HubspotSearchContactsInput, HubspotSearchContactsOutput, HubspotService, HubspotUpdateContactInput, HubspotUpdateContactOutput, HubspotUpdateDealInput, HubspotUpdateDealOutput, HubspotUpsertContactInput, HubspotUpsertContactOutput, } from './core/context/hubspot.js';
 export type { DocusignApi, DocusignCreateEnvelopeFromTemplateInput, DocusignCreateEnvelopeFromTemplateOutput, DocusignCreateRecipientViewFromTemplateInput, DocusignCreateRecipientViewFromTemplateOutput, DocusignEnvelopeIdInput, DocusignGetEnvelopeRecipientsOutput, DocusignGetEnvelopeSigningStatusOutput, DocusignGetEnvelopeStatusOutput, DocusignListRecentEnvelopesInput, DocusignListRecentEnvelopesOutput, DocusignListTemplatesOutput, DocusignRecentEnvelope, DocusignRecipient, DocusignSearchEnvelopesByEmailInput, DocusignSearchEnvelopesByEmailOutput, DocusignService, } from './core/context/docusign.js';
 export type { FilevineAddHashtagToProjectInput, FilevineAddHashtagToProjectOutput, FilevineApi, FilevineCollectionItemInput, FilevineCommentOutput, FilevineCreateCommentInput, FilevineCreateContactInput, FilevineCreateContactOutput, FilevineCreateNoteInput, FilevineCreateNoteWithCommentInput, FilevineCreateNoteWithCommentOutput, FilevineCreateProjectCollectionItemInput, FilevineCreateProjectCollectionItemOutput, FilevineCreateProjectInput, FilevineCreateProjectOutput, FilevineDeleteProjectCollectionItemInput, FilevineDeleteProjectCollectionItemOutput, FilevineFolder, FilevineGetAssociatedProjectsInput, FilevineGetAssociatedProjectsOutput, FilevineGetContactInput, FilevineGetContactOutput, FilevineGetCrmUrlInput, FilevineGetCrmUrlOutput, FilevineGetProjectCollectionItemInput, FilevineGetProjectCollectionItemOutput, FilevineGetProjectCollectionItemsInput, FilevineGetProjectCollectionItemsOutput, FilevineGetProjectFoldersInput, FilevineGetProjectFoldersOutput, FilevineGetProjectInput, FilevineGetProjectOutput, FilevineLogCallInput, FilevineLogEmailInput, FilevineLogSmsInput, FilevineNoteOutput, FilevineProperties, FilevineRecord, FilevineSearchContactsInput, FilevineSearchContactsOutput, FilevineService, FilevineUpdateContactInput, FilevineUpdateContactOutput, FilevineUpdateProjectCollectionItemInput, FilevineUpdateProjectCollectionItemOutput, FilevineUpdateProjectInput, FilevineUpdateProjectOutput, FilevineUploadDocumentInput, FilevineUploadDocumentOutput, } from './core/context/filevine.js';
-export type { CaseContext, ContactApi, BoundIntegrationMeta, EnvApi, EnvService, FieldState, HttpApi, IntegrationAccountFields, IntegrationApi, IntegrationStub, IntegrationSurfaceKey, IntegrationTarget, TwilioApi, TwilioCreateCallInput, TwilioCreateCallOutput, TwilioIncomingNumber, TwilioListIncomingNumbersOutput, TwilioSendSmsInput, TwilioSendSmsOutput, TwilioService, Logger, MakeCtxOverrides, Slots, SystemContext, Writes, } from './core/context/types.js';
+export type { CaseContext, ContactApi, BoundIntegrationMeta, EnvApi, EnvService, FieldState, HttpApi, IntegrationAccountFields, IntegrationApi, IntegrationStub, IntegrationSurfaceKey, IntegrationTarget, TwilioApi, TwilioCreateCallInput, TwilioCreateCallOutput, TwilioIncomingNumber, TwilioListIncomingNumbersOutput, TwilioSendSmsInput, TwilioSendSmsOutput, TwilioService, Logger, MakeCtxOverrides, Slots, SystemContext, FieldWrites, RowWrite, StructuredWrites, Writes, } from './core/context/types.js';
 export { CONTACT_PAGE_LIMIT_MAX, contactListInput, contactListOutput, contactMockService, contactSummary, contactSurface, type ContactListParams, type ContactListResult, type ContactSummary, } from './core/context/contact.js';
 export { dbDelInput, dbDelOutput, dbGetInput, dbGetOutput, dbMockService, dbSetInput, dbSetOutput, dbSurface, KV_KEY_MAX, KV_TTL_SECONDS_MAX, KV_VALUE_MAX, type DbApi, type DbDelInput, type DbDelOutput, type DbGetInput, type DbGetOutput, type DbSetInput, type DbSetOutput, } from './core/context/db.js';
 export { bindEnvService, envMockService, readEnvGet } from './core/context/env.js';
@@ -19,18 +19,18 @@ export { twilioCreateCallInput, twilioCreateCallOutput, twilioIncomingNumber, tw
 export type { ApplyWritesOptions, ApplyWritesResult, CompiledSlotSchema, ExtractedField, FieldHistoryEntry, FieldValue, HistoryAppend, MultiRowProjection, MultiRowRecord, MultiRowTableData, RecomputeResult, RuntimeDerivedFieldDef, RuntimeFieldDef, RuntimeNormalFieldDef, RuntimeSlotsSnapshot, RuntimeTableDef, SingleRowProjection, SingleRowTableData, SlotCurrent, SlotFillingOutput, SlotFillingValidateResult, TableData, UpdatedBy, ValidationIssue, ValidationResult, WriteSource, } from './core/slot/types.js';
 export type { FuncRef } from './core/functions/func-ref.js';
 export { resolveFuncName } from './core/functions/func-ref.js';
-export type { SequenceBuild } from './builder/types.js';
+export type { RuntimePackageSource, SequenceBuild } from './builder/types.js';
 export type { CaseContextViewRegistryEntry, ComputeFn, CustomFn, DefinedFunc, FuncMap, FuncOptions, FuncRegistration, FunctionCall, FunctionCtx, FunctionRegistry, FunctionRegistryEntry, GetFirstMessageFunction, GetFirstMessageParams, SystemFuncMap, WebHookFunction, WebHookFunctionParams, } from './core/functions/types.js';
 export { toFuncRegistrations } from './core/functions/types.js';
 export { toCaseContextViewRegistry, toFunctionRegistry } from './builder/compile/registry.js';
 export { compileFunctionCode } from './builder/compile/function-code.js';
-export { compileAll, compileSequence, runtimePackageVersion, snapshotCompanySchema, type CompileSequenceOptions, type CompileSequenceResult, } from './builder/compile/compile-sequence.js';
+export { compileAll, compileSequence, runtimePackageSource, runtimePackageVersion, snapshotCompanySchema, type CompileSequenceOptions, type CompileSequenceResult, } from './builder/compile/compile-sequence.js';
 export { compileSequenceAgendas, fatalAgendaIssues } from './builder/compile/compile-agenda.js';
 export { loadSequenceCaseContextView, loadSequenceFunctions } from './builder/load.js';
 export { findTsModule } from './builder/paths.js';
 export type { OverlayClientMessage, OverlayExecuteMessage, OverlayExecuteResultMessage, OverlayAuthErrorMessage, OverlayAuthMessage, OverlayAuthOkMessage, OverlayMessage, OverlayPushMessage, OverlayReplacedMessage, OverlayServerMessage, } from './dev-overlay/protocol.js';
 export { encodeOverlayMessage, OVERLAY_REPLACED_CLOSE_CODE, parseOverlayMessage } from './dev-overlay/protocol.js';
-export { buildActionContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, makeCtx, makeCtxAsync, noopLog, type ActionContext, type ActionDataSlice, type ApiHost, type FakeApiHostOptions, type RunScope, } from './fn-context/index.js';
+export { buildActionContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, makeCtx, makeCtxAsync, noopLog, type ActionContext, type ActionDataSlice, type ApiHost, type FakeApiHostOptions, type RunScope, } from './fn-context/index.js';
 export { createAppRouter, createIntegrationRouter, createListBindingsProcedure, createLogRouter, createPlatformRouter, isRpcCodedError, parseScriptInput, ScriptInputError, type AppRouter, type RpcCodedError, type RpcErrorCode, type IntegrationInvokeHandler, type LogEmitHandler, type PlatformInvokeHandler, type RpcContext, } from './fn-context/rpc/index.js';
 export * from './compute-host/index.js';
 export { defineBoolComputeFunc, defineComputeFunc } from './core/functions/define/compute.js';
@@ -39,9 +39,9 @@ export { defineCustomFunc } from './core/functions/define/custom.js';
 export { defineSystemFunc } from './core/functions/define/system.js';
 export { mergeEffectiveSchema } from './builder/merge.js';
 export { emitCaseContextSource, emitSlotsSource } from './builder/codegen/emit.js';
-export { affectedDerivedFields, applyFieldPatch, applyFieldPatchAndRecompute, applySlotFilling, applySlotFillingAndRecompute, applyWrites, applyWritesAndRecompute, buildDependencyGraph, buildFieldCatalog, buildSlotFillingJsonSchema, cloneSnapshot, commitFieldWrite, compiledTableEntries, compileSlotSchema, emptyFieldValue, emptyMultiRow, emptySlotRow, fieldChanged, formatFieldPath, getCompiledTable, getFieldState, getFieldValue, getLastThreeValues, getRowField, getSingleField, getSnapshotTable, isFieldValue, isReservedTableName, isResolved, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, isSnapshotSingleRow, isValidDataTypeValue, listConversationFields, makeFieldValue, markAskedUnknown, parseFieldPath, recomputeDerived, requireFieldPath, rowValueEntries, slotFieldEntries, slotFieldNames, snapshotFrom, toEffectiveSchema, toHistoryEntry, validateBareValue, validateExtractedField, validateFieldRefs, validateSlotFillingOutput, } from './core/slot/index.js';
+export { affectedDerivedFields, applyFieldPatch, applyFieldPatchAndRecompute, applySlotFilling, applySlotFillingAndRecompute, applyWrites, applyWritesAndRecompute, buildDependencyGraph, buildFieldCatalog, buildSlotFillingJsonSchema, cloneSnapshot, commitFieldWrite, compiledTableEntries, compileSlotSchema, emptyFieldValue, emptyMultiRow, emptySlotRow, fieldChanged, formatFieldPath, getCompiledTable, getFieldState, getFieldValue, getLastThreeValues, getRowField, getSingleField, getSnapshotTable, isFieldValue, isReservedTableName, isResolved, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, isSnapshotSingleRow, isValidDataTypeValue, listConversationFields, makeFieldValue, markAskedUnknown, isRowWrite, isStructuredWrites, normalizeWrites, parseFieldPath, recomputeDerived, requireFieldPath, rowValueEntries, slotFieldEntries, slotFieldNames, snapshotFrom, toEffectiveSchema, toHistoryEntry, validateBareValue, validateExtractedField, validateFieldRefs, validateSlotFillingOutput, } from './core/slot/index.js';
 export type { ApplySlotFillingOptions, DependencyGraphResult, FieldPatchInput, FieldPath, ParsedFieldPath, RecomputeOptions, SfSchemaOptions, SlotRow, SnapshotSeed, ValidateSlotFillingOptions, } from './core/slot/index.js';
-export type { ActionBlock, ActionNode, AgendaBlock, AgendaConfig, AgendaHeader, AgendaTree, ApplyWhen, AuthoringNode, AuthoringWhen, BranchNode, Channel, CompiledActionBlock, CompiledAgenda, CompiledAgendaBlock, CompiledTopicBlock, CompiledTransferBlock, CompiledWhen, Condition, ConditionEval, FirstMessage, FinishWhen, FinishWhenEval, FlatActionItem, FlatAgendaItem, FlatNodePlacement, FlatTopicItem, FlatTransferItem, FlattenOptions, FlattenResult, Interrupt, SequenceAgendas, JsonRulesCondition, NodePlacement, OnNoProgress, OtherwiseSentinel, Placement, SectionNode, SectionPlacement, SimulateResult, SimulatedItem, SimulatedItemStatus, SwitchOnNode, TopicBlock, TopicNode, TransferBlock, TransferNode, ValidateAgendaOptions, WalkDecision, WalkHitReason, WalkOptions, WalkResult, WalkSkip, WalkSkipReason, When, WhenEval, AdvanceResult, StageDriveHooks, StageDriveResult, StageDriveState, } from './core/stage/index.js';
-export { DEFAULT_MAX_ACTIONS_PER_TURN, LAST_TRANSFER_RESULT_FIELD, action, advanceAgenda, agenda, andCompiledWhen, branch, collectJsonRulesFacts, collectTransferBlocks, compileAuthoringWhen, compileFinishWhen, compileWhen, driveAgenda, evaluateFinishWhen, evaluateJsonRules, evaluateWhen, extractBlocksFromTree, extractTemplateFields, finishWhenFields, flattenAgendaConfig, flattenAgendaPlacements, flattenAgendaTree, isAgendaTree, isSequenceAgendas, isOtherwise, jsonRules, looksLikeJsonRules, normalizeJsonRules, normalizeSequenceAgendas, notAnyWhen, otherwise, parseJsonRules, registerTransferSessionFields, section, simulateAgenda, switchOn, topic, transfer, transferFieldKey, transferResultField, transferWrites, treeToPlacements, unresolvedFinishWhenFields, validateCompiledAgenda, walkAgenda, watchdogHint, whenFields, } from './core/stage/index.js';
+export type { ActionBlock, ActionNode, AgendaBlock, AgendaConfig, AgendaHeader, AgendaTree, ApplyWhen, AuthoringNode, AuthoringWhen, BranchNode, Channel, CompiledActionBlock, CompiledAgenda, CompiledAgendaBlock, CompiledTopicBlock, CompiledIvrBlock, CompiledTransferBlock, CompiledWhen, Condition, ConditionEval, FirstMessage, FinishWhen, FinishWhenEval, FlatActionItem, FlatAgendaItem, FlatIvrItem, FlatNodePlacement, FlatTopicItem, FlatTransferItem, DtmfResult, IvrAttemptResult, IvrBlock, IvrDigit, IvrFallbackAction, IvrNode, FlattenOptions, FlattenResult, Interrupt, SpokenLanguage, SequenceAgendas, JsonRulesCondition, NodePlacement, OnNoProgress, OtherwiseSentinel, Placement, SectionNode, SectionPlacement, SimulateResult, SimulatedItem, SimulatedItemStatus, SwitchOnNode, TopicBlock, TopicNode, TransferArguments, TransferBlock, TransferCallerIdShown, TransferConfirmKey, TransferConfirmMethod, TransferDial, TransferFallbackAction, TransferInterruptAction, TransferMode, TransferNode, TransferSay, ValidateAgendaOptions, WalkDecision, WalkHitReason, WalkOptions, WalkResult, WalkSkip, WalkStats, WalkSkipReason, When, WhenEval, AdvanceResult, StageDriveHooks, StageDriveResult, StageDriveState, } from './core/stage/index.js';
+export { DEFAULT_MAX_ACTIONS_PER_TURN, CASE_LAST_TRANSFER_AT, CASE_LAST_TRANSFER_RESULT, CASE_TRANSFER_ATTEMPT_COUNT, E164_NUMBER, LAST_TRANSFER_RESULT_FIELD, CONTACT_LANGUAGE_FIELD, getContactLang, inboundIvrCollect, ivrAttempted, ivrOf, ivrResultField, languageFieldOf, RESERVED_INTERRUPT_TOOL_NAMES, SIP_URI, action, advanceAgenda, agenda, andCompiledWhen, branch, collectJsonRulesFacts, collectTransferBlocks, collectTransferInterruptHeaders, compileAuthoringWhen, compileFinishWhen, compileWhen, driveAgenda, evaluateFinishWhen, evaluateJsonRules, evaluateWhen, extractBlocksFromTree, extractTemplateFields, finishWhenFields, flattenAgendaConfig, flattenAgendaPlacements, flattenAgendaTree, headerHasTransferInterrupt, ivr, interpolateFromSnapshot, interpolateTemplate, isTransferDestinationLiteral, isAgendaTree, isSequenceAgendas, isOtherwise, isSpokenLanguage, jsonRules, looksLikeJsonRules, normalizeJsonRules, normalizeSequenceAgendas, notAnyWhen, otherwise, parseJsonRules, registerIvrSessionFields, collectIvrBlocks, registerTransferSessionFields, resolveTransferArguments, resolveTransferDestinations, resolveTransferSay, section, simulateAgenda, switchOn, topic, transfer, transferArgumentsJson, transferFieldKey, transferResultField, transferWrites, validateTransferDestinations, treeToPlacements, unresolvedFinishWhenFields, validateCompiledAgenda, validateInterrupts, walkAgenda, watchdogHint, whenFields, } from './core/stage/index.js';
 export * from './voice-service/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -14,12 +14,12 @@ export { resolveFuncName } from './core/functions/func-ref.js';
 export { toFuncRegistrations } from './core/functions/types.js';
 export { toCaseContextViewRegistry, toFunctionRegistry } from './builder/compile/registry.js';
 export { compileFunctionCode } from './builder/compile/function-code.js';
-export { compileAll, compileSequence, runtimePackageVersion, snapshotCompanySchema, } from './builder/compile/compile-sequence.js';
+export { compileAll, compileSequence, runtimePackageSource, runtimePackageVersion, snapshotCompanySchema, } from './builder/compile/compile-sequence.js';
 export { compileSequenceAgendas, fatalAgendaIssues } from './builder/compile/compile-agenda.js';
 export { loadSequenceCaseContextView, loadSequenceFunctions } from './builder/load.js';
 export { findTsModule } from './builder/paths.js';
 export { encodeOverlayMessage, OVERLAY_REPLACED_CLOSE_CODE, parseOverlayMessage } from './dev-overlay/protocol.js';
-export { buildActionContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, makeCtx, makeCtxAsync, noopLog, } from './fn-context/index.js';
+export { buildActionContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, makeCtx, makeCtxAsync, noopLog, } from './fn-context/index.js';
 export { createAppRouter, createIntegrationRouter, createListBindingsProcedure, createLogRouter, createPlatformRouter, isRpcCodedError, parseScriptInput, ScriptInputError, } from './fn-context/rpc/index.js';
 export * from './compute-host/index.js';
 export { defineBoolComputeFunc, defineComputeFunc } from './core/functions/define/compute.js';
@@ -28,7 +28,7 @@ export { defineCustomFunc } from './core/functions/define/custom.js';
 export { defineSystemFunc } from './core/functions/define/system.js';
 export { mergeEffectiveSchema } from './builder/merge.js';
 export { emitCaseContextSource, emitSlotsSource } from './builder/codegen/emit.js';
-export { affectedDerivedFields, applyFieldPatch, applyFieldPatchAndRecompute, applySlotFilling, applySlotFillingAndRecompute, applyWrites, applyWritesAndRecompute, buildDependencyGraph, buildFieldCatalog, buildSlotFillingJsonSchema, cloneSnapshot, commitFieldWrite, compiledTableEntries, compileSlotSchema, emptyFieldValue, emptyMultiRow, emptySlotRow, fieldChanged, formatFieldPath, getCompiledTable, getFieldState, getFieldValue, getLastThreeValues, getRowField, getSingleField, getSnapshotTable, isFieldValue, isReservedTableName, isResolved, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, isSnapshotSingleRow, isValidDataTypeValue, listConversationFields, makeFieldValue, markAskedUnknown, parseFieldPath, recomputeDerived, requireFieldPath, rowValueEntries, slotFieldEntries, slotFieldNames, snapshotFrom, toEffectiveSchema, toHistoryEntry, validateBareValue, validateExtractedField, validateFieldRefs, validateSlotFillingOutput, } from './core/slot/index.js';
-export { DEFAULT_MAX_ACTIONS_PER_TURN, LAST_TRANSFER_RESULT_FIELD, action, advanceAgenda, agenda, andCompiledWhen, branch, collectJsonRulesFacts, collectTransferBlocks, compileAuthoringWhen, compileFinishWhen, compileWhen, driveAgenda, evaluateFinishWhen, evaluateJsonRules, evaluateWhen, extractBlocksFromTree, extractTemplateFields, finishWhenFields, flattenAgendaConfig, flattenAgendaPlacements, flattenAgendaTree, isAgendaTree, isSequenceAgendas, isOtherwise, jsonRules, looksLikeJsonRules, normalizeJsonRules, normalizeSequenceAgendas, notAnyWhen, otherwise, parseJsonRules, registerTransferSessionFields, section, simulateAgenda, switchOn, topic, transfer, transferFieldKey, transferResultField, transferWrites, treeToPlacements, unresolvedFinishWhenFields, validateCompiledAgenda, walkAgenda, watchdogHint, whenFields, } from './core/stage/index.js';
+export { affectedDerivedFields, applyFieldPatch, applyFieldPatchAndRecompute, applySlotFilling, applySlotFillingAndRecompute, applyWrites, applyWritesAndRecompute, buildDependencyGraph, buildFieldCatalog, buildSlotFillingJsonSchema, cloneSnapshot, commitFieldWrite, compiledTableEntries, compileSlotSchema, emptyFieldValue, emptyMultiRow, emptySlotRow, fieldChanged, formatFieldPath, getCompiledTable, getFieldState, getFieldValue, getLastThreeValues, getRowField, getSingleField, getSnapshotTable, isFieldValue, isReservedTableName, isResolved, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, isSnapshotSingleRow, isValidDataTypeValue, listConversationFields, makeFieldValue, markAskedUnknown, isRowWrite, isStructuredWrites, normalizeWrites, parseFieldPath, recomputeDerived, requireFieldPath, rowValueEntries, slotFieldEntries, slotFieldNames, snapshotFrom, toEffectiveSchema, toHistoryEntry, validateBareValue, validateExtractedField, validateFieldRefs, validateSlotFillingOutput, } from './core/slot/index.js';
+export { DEFAULT_MAX_ACTIONS_PER_TURN, CASE_LAST_TRANSFER_AT, CASE_LAST_TRANSFER_RESULT, CASE_TRANSFER_ATTEMPT_COUNT, E164_NUMBER, LAST_TRANSFER_RESULT_FIELD, CONTACT_LANGUAGE_FIELD, getContactLang, inboundIvrCollect, ivrAttempted, ivrOf, ivrResultField, languageFieldOf, RESERVED_INTERRUPT_TOOL_NAMES, SIP_URI, action, advanceAgenda, agenda, andCompiledWhen, branch, collectJsonRulesFacts, collectTransferBlocks, collectTransferInterruptHeaders, compileAuthoringWhen, compileFinishWhen, compileWhen, driveAgenda, evaluateFinishWhen, evaluateJsonRules, evaluateWhen, extractBlocksFromTree, extractTemplateFields, finishWhenFields, flattenAgendaConfig, flattenAgendaPlacements, flattenAgendaTree, headerHasTransferInterrupt, ivr, interpolateFromSnapshot, interpolateTemplate, isTransferDestinationLiteral, isAgendaTree, isSequenceAgendas, isOtherwise, isSpokenLanguage, jsonRules, looksLikeJsonRules, normalizeJsonRules, normalizeSequenceAgendas, notAnyWhen, otherwise, parseJsonRules, registerIvrSessionFields, collectIvrBlocks, registerTransferSessionFields, resolveTransferArguments, resolveTransferDestinations, resolveTransferSay, section, simulateAgenda, switchOn, topic, transfer, transferArgumentsJson, transferFieldKey, transferResultField, transferWrites, validateTransferDestinations, treeToPlacements, unresolvedFinishWhenFields, validateCompiledAgenda, validateInterrupts, walkAgenda, watchdogHint, whenFields, } from './core/stage/index.js';
 export * from './voice-service/index.js';
 //# sourceMappingURL=index.js.map

package/dist/voice-service/types.d.ts

@@ -369,6 +369,9 @@ export interface FieldCollectConfig extends LoopConfirmConfig {
     unsuccessSayText: string | null;
     validateDigits: DtmfDigit[];
     digitsValueMap: Record<string, string>;
+    finishOnKey?: DtmfDigit;
+    minDigits?: number;
+    maxDigits?: number;
 }
 export interface WarmTransferSession {
     conferenceName: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superpanel-sdk/runtime",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Slot + Stage runtime: schema, writes, derived recompute, agenda compile/walk/simulate",
   "license": "UNLICENSED",
   "type": "module",