@superpanel-sdk/runtime 0.2.3 → 0.7.0

package/dist/platform.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The whole runtime, for the platform: every other entry (the company API `index.ts`, the Worker shell
+ * `worker.ts`, the compiler `compiler.ts`) and the slot and page engines and RPC routers behind them.
+ * Platform services, tests and scripts import from here; only the Worker shell takes `./worker` and the
+ * compile child `./compiler`, which stay small. Platform-only: the package resolves `./platform` under the
+ * `superpanel-platform` condition, so company code cannot import it.
+ */
+export type { CompanyFieldDef, CompanyNormalFieldDef, CompanySchema, CompanyTableDef, DataType, ContactSchedule, LocalTimeRange, ContactWeekday, ScalarDataType, NormalFieldCore, SessionDataType, SessionFieldDef, SessionSchema, TableRef, } from './core/slot/schema.js';
+export { ROW_ID_FIELD, ROW_SYSTEM_KEYS, ROW_TIME_KEYS, isRowTimeKey, type RowSystemKey, type RowTimeKey, idFieldCore, normalFieldCoreSchema, companyNormalFieldDefSchema, tableRefSchema, companyFieldDefSchema, companyTableDefSchema, companySchemaSchema, contactScheduleValueSchema, localTimeRangeSchema, isCompanySchema, EMPTY_SESSION_SCHEMA, sessionFieldDefSchema, sessionSchemaSchema, } from './core/slot/schema.js';
+export { CONTACT_OPT_OUT_FIELDS, CONTACT_TABLE, LIMITS, POLICY_IDS, PLATFORM_CONTACT_FIELDS, PLATFORM_SESSION_FIELDS, PLATFORM_SESSION_SCHEMA, SESSION_TABLE, validateCompanySchema, sessionSchemaIssues, isCustomTable, isParentField, isRecordTable, parentOf, subjectTableIssues, type ResponsePolicyId, type SlotFillingPolicyId, type VoiceProfileId, } from './core/slot/company-metadata.js';
+export { STATE_CODES, STATE_TIMEZONES, areaCodeTimezone, contactTimezone, knownTimezone, postalTimezone, stateCode, type StateCode, type TimezoneSource, } from './core/slot/contact-timezone.js';
+export { randomTimeBetween } from './core/case-orchestrator/time.js';
+export { contactHoursOn, contactScheduleHours, everyDay, nextContactTime, withinContactHours, type ContactHours, type ContactHoursIgnore, type ContactHoursRange, type ContactHoursWeekday, type ContactScheduleValue, } from './core/case-orchestrator/contact-hours.js';
+export { integrationSurfaceKeys } from './core/context/types.js';
+export { lookupRef, parentRef } from './core/slot/id-ref.js';
+export type { EmailApi, EmailAttachment, EmailGetAttachmentInput, EmailGetAttachmentOutput, EmailGetMessageInput, EmailGetMessageOutput, EmailListMessagesInput, EmailListMessagesOutput, EmailProvider, EmailProviderService, EmailSendEmailInput, EmailSendEmailOutput, EmailService, } from './core/context/email.js';
+export { EMAIL_PLATFORM_ONLY_METHODS, emailGetAttachmentInput, emailGetAttachmentOutput, emailGetMessageInput, emailGetMessageOutput, emailListMessagesInput, emailListMessagesOutput, emailMockService, emailProvider, emailSendEmailInput, emailSendEmailOutput, } from './core/context/email.js';
+export type { ContactApi, IntegrationSurfaceMeta, EnvApi, EnvService, FieldState, IntegrationAccountFields, IntegrationApi, IntegrationStub, IntegrationSurfaceKey, IntegrationTarget, Logger, MakeCtxOverrides, SystemContext, } from './core/context/types.js';
+export { CALL_PAGE_LIMIT_MAX, callDirection, callGetInput, callGetOutput, callListInput, callListOutput, callMockService, callParticipant, callRecord, callSurface, callTranscriptInput, callTranscriptLine, callTranscriptOutput, type CallApi, type CallDirection, type CallListParams, type CallListResult, type CallParticipant, type CallRecord, type CallTranscript, type CallTranscriptLine, } from './core/context/call.js';
+export { CONTACT_PAGE_LIMIT_MAX, contactCreateInput, contactFindInput, contactFindOutput, contactListInput, contactListOutput, contactMockService, contactSummary, contactSurface, slotFieldValue, type ContactCreateParams, type ContactFindParams, type ContactFindResult, type ContactListParams, type ContactListResult, type ContactSummary, type SlotFieldValue, } from './core/context/contact.js';
+export { instanceCloseInput, instanceCloseOutput, instanceFindForContactInput, instanceIdInput, instanceListOutput, instanceNotifyInput, instanceNotifyOutput, instanceSetVariablesInput, instanceStartInput, instanceStartOutput, instanceSummary, instancesMockService, instancesSurface, type InstanceCloseParams, type InstanceCloseResult, type InstanceFindForContactParams, type InstanceIdParams, type InstanceListResult, type InstanceNotifyParams, type InstanceNotifyResult, type InstanceSetVariablesParams, type InstanceStartParams, type InstanceStartResult, type InstanceSummary, type InstancesApi, } from './core/context/instances.js';
+export { channelMailbox, channelPhoneNumber, channelsListInput, channelsListOutput, channelsMockService, channelsSurface, type ChannelMailbox, type ChannelPhoneNumber, type ChannelsApi, type ChannelsListParams, type ChannelsListResult, } from './core/context/channels.js';
+export { exchangeEmailThreadInput, exchangeEmailThreadOutput, exchangeLastInput, exchangeLastOutput, exchangeRef, exchangeSummary, exchangesMockService, exchangesSurface, type ExchangeRef, type ExchangeEmailThreadParams, type ExchangeEmailThreadResult, type ExchangeLastParams, type ExchangeLastResult, type ExchangeSummary, type ExchangesApi, } from './core/context/exchanges.js';
+export { SYSTEM_VARIABLES, compileVariables, defineSequence, defineVariables, isSystemVariable, json, readVariables, startVariables, variableValueIssue, variablesSize, variablesWriteIssues, type CompiledExperiments, type CompiledVariable, type CompiledVariables, type ExperimentDecl, type JsonVariableType, type SequenceDefinition, type SystemVariableName, type VariableDecl, type VariableDecls, type VariablesOf, } from './core/sequence/index.js';
+export { EMAIL_PAGE_LIMIT_MAX, emailDirection, emailGetInput, emailGetOutput, emailHistoryMockService, emailHistorySurface, emailListInput, emailListOutput, emailRecord, emailSendInput, emailSendOutput, type EmailDirection, type EmailHistoryApi, type EmailListParams, type EmailListResult, type EmailRecord, type EmailSendParams, type EmailSendResult, } from './core/context/email-message.js';
+export { KV_KEY_MAX, KV_SCOPES, KV_TTL_SECONDS_MAX, KV_VALUE_MAX, kvDelInput, kvDelOutput, kvGetInput, kvGetOutput, kvMockService, kvScope, kvSetInput, kvSetOutput, kvSurface, type KvApi, type KvDelInput, type KvDelOutput, type KvGetInput, type KvGetOutput, type KvScope, type KvSetInput, type KvSetOutput, } from './core/context/kv.js';
+export { SMS_PAGE_LIMIT_MAX, smsDirection, smsGetInput, smsGetOutput, smsListInput, smsListOutput, smsMockService, smsRecord, smsSurface, type SmsApi, type SmsDirection, type SmsListParams, type SmsListResult, type SmsRecord, } from './core/context/sms.js';
+export { bindEnvService, envMockService, readEnvGet } from './core/context/env.js';
+export type { AnyPlatformSurface, PlatformApiShape, PlatformImpl, PlatformSurface } from './core/context/platform.js';
+export { platformSurfaces, type PlatformApis, type PlatformSurfaceKey } from './core/context/platform-registry.js';
+export type { CompiledSlotSchema, FieldValue, MultiRowRecord, MultiRowTableData, RuntimeFieldDef, RuntimeTableDef, SingleRowTableData, SlotValue, UpdatedBy, ValidationIssue, ValidationResult, WriteSource, } from './core/slot/types.js';
+export type { CompanyBuild, CompanyPart, FunctionSourceMap, RuntimePackageSource, SequenceBuild, SourceMaps } from './builder/types.js';
+export { COMPANY_SCOPE, CONTEXT_PAGE_FUNCTION, functionKey, functionScriptFile } from './builder/types.js';
+export { parseOfficeHours, resolveOfficeHours, type OfficeHours, type OfficeHoursSnapshot, type ParseOfficeHoursResult, type Weekday, type Window, } from './core/office-hours/index.js';
+export type { Ctx, FuncMap, FunctionRegistry, FunctionRegistryEntry, PlainFn } from './core/functions/types.js';
+export type { AnyEventHandlers, CallEndedEvent, CallEventBase, CallInboundEvent, CallOutboundEvent, EmailReceivedEvent, EmailEventBase, EmailSendRequestedEvent, EventHandler, EventHandlerArgs, EventHandlers, SmsReceivedEvent, SmsEventBase, SmsSendRequestedEvent, SystemEventMap, SystemEventName, SystemEventPayload, WebhookEvent, WebhookHandler, WebhookOutcome, WebhookRequest, } from './core/functions/events.js';
+export { isSystemEventName, SYSTEM_EVENT_NAMES, SYSTEM_EVENTS, WEBHOOK_RECEIVED_FUNCTION, webhookOutcome, } from './core/functions/events.js';
+export { defineSchedules, SCHEDULE_FUNCTION_PREFIX, SCHEDULES_MODULE, scheduleFunctionName, type ScheduleDefinition, type ScheduleManifest, type Schedules, type ScheduleTick, } from './core/functions/schedules.js';
+export { parseSchedules, scheduleTimingIssue } from './builder/schedules.js';
+export { ERROR_JSON_MAX_BYTES, ERRORS_MODULE, ON_ERROR_FUNCTION, PLATFORM_UNAVAILABLE_MESSAGE, PlatformUnavailableError, type CodeErrorEvent, type CodeErrorKind, type CodeErrorSourceType, type OnError, } from './core/functions/errors.js';
+export { toEventRegistry, toFunctionRegistry } from './builder/compile/registry.js';
+export { compileFunctionCode } from './builder/compile/function-code.js';
+export { COMPILE_CONCURRENCY, COMPILE_SEQUENCE_TIMEOUT_MS, compileAll, compileCompanyPart, compileRepo, compileSequence, compileSequenceBuild, runtimePackageSource, runtimePackageVersion, type CompileRepoEvent, type CompileRepoOptions, type CompileRepoSequenceResult, type CompileSequenceOptions, type CompileSequenceResult, } from './builder/compile/compile-sequence.js';
+export { loadSequenceEvents, loadSequenceFunctions } from './builder/load.js';
+export { findTsModule } from './builder/paths.js';
+export type { OverlayClientMessage, OverlayExecuteMessage, OverlayExecuteResultMessage, OverlayAuthErrorMessage, OverlayAuthMessage, OverlayAuthOkMessage, OverlayMessage, OverlayNoticeMessage, OverlayPushMessage, OverlayReplacedMessage, OverlayServerMessage, } from './dev-overlay/protocol.js';
+export { encodeOverlayMessage, OVERLAY_REPLACED_CLOSE_CODE, parseOverlayMessage } from './dev-overlay/protocol.js';
+export { asCaseOrchestratorRun, buildActionContext, buildCaseOrchestratorContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, makeCaseOrchestratorCtx, makeCtx, makeCtxAsync, noopLog, type ActionContext, type ActionDataSlice, type ApiGiven, type ApiHost, type CaseOrchestratorActionContext, type CaseOrchestratorApiHost, type CaseOrchestratorRunScope, type FakeApiHostOptions, type RunClaims, type RunScope, } from './fn-context/index.js';
+export { createAppRouter, createIntegrationRouter, createListSurfacesProcedure, createLogRouter, createPlatformRouter, createCaseOrchestratorToolsRouter, createRecordsRouter, isRpcCodedError, parseScriptInput, reasonError, RpcReasonError, ScriptInputError, type AppRouter, type RpcCodedError, type RpcErrorCode, type IntegrationInvokeHandler, type LogEmitHandler, type PlatformInvokeHandler, type CaseOrchestratorToolInvokeHandler, type RecordsReadInput, type RecordsHandlers, type RecordsResult, type RecordsWriteInput, type RpcContext, } from './fn-context/rpc/index.js';
+export * from './compute-host/index.js';
+export type { BoundRow, Cell, CellBinding, CellRef, RowRef } from './core/slot/binding.js';
+export { announceAction, createRowAction, definePage, deleteRowAction, emptyRuns, endAction, fieldCell, keypadAction, lastActionRun, pageEntry, transferTo, isSipUri, runFunction, voicemailAction, PAGE_TOOLS, type PageToolName, type ToolAction, type PageFarEnd, type PageHeard, type VoicemailAction, cancelFollowUpAction, followUpAction, choose, isChoose, refFieldCell, type RefFieldCell, type RefOption, type ChooseParam, type FunctionAction, type FollowUpAction, type CancelFollowUpAction, type PageTime, tried, type PageActionRun, type ActionRunScope, type AnnounceAction, type ChannelAction, type DefinedPage, type EndAction, type KeypadAction, type PageChannel, type PageDefinition, type PageFunction, type PagePersona, type PageNextStep, type PageFaq, type PageFaqEntry, type PageStart, checkPageStart, MAX_FAQ_ENTRIES, type PageRuns, type PageScheduledAction, type TransferAction, type ActionContext as PageActionContext, type ActionParam, type ActionParameters, type CreateRowAction, type CustomAction, type DeleteRowAction, type FieldCell, type FieldOptions, type FindArgs, type Placeable, type SchemaFieldParam, type PageAction as PageScriptAction, type PageContext, type PageContextOf, type PageBaseContext, type PageCallCaps, type PageCallPhase, type PagePreviousCall, type PageChannelCaps, type PageSmsMessage, type PageEmailMessage, PAGE_CHANNELS, type PageConversation, type PageHistory, type PageEntryArg, type PageRow as PageScriptRow, type Db, type ReadDb, type Slot, type SlotRef, type SlotState, type TableReader, type TableWriter, } from './core/page/define.js';
+export { actionKey, runKeyOf, fallbackPage, PageDocumentError, pressedButton, renderDocument, RowNames, type AutoAction, type BlockNode, type PageNode, type PageReads, type InputProperty, type InputSchema, type ReadSlot, type RenderDocumentInput, type RenderedAction, type RenderedCell, type RenderedPage as RenderedPageDocument, } from './core/page/render.js';
+export { announce, backgroundTransfer, block, button, cancelFollowUp, coldTransfer, convertTime, createRow, data, deleteRow, doNow, end, field, functionHandles, actionHandles, isNode, keypad, list, page, pressKeypad, refField, run, scheduleFollowUp, text, toFnPageResult, toolbox, voicemail, warmTransfer, type FunctionHandle, type PageActionHandle, type PageContent, type PageNode as PageFnNode, } from './core/page/fns.js';
+export { isEnvelope, type Envelope, type EnvelopeNode, type EnvelopePage } from './core/page/envelope.js';
+export { TIMELINE_KINDS, type TimelineEntry, type TimelineKind, type TimelineWhere } from './core/page/timeline.js';
+export { blockAt, nextStepReference, viewText, workspaceText, type WorkspaceNote, type WorkspaceTextOptions } from './core/page/workspace.js';
+export type { CreateData, FindManyArgs, FindUniqueArgs, Id, IncludeArg, PageFieldDesc, PageTablesDesc, RowOf, SelectArg, PageActionFn, TypedActionContext, TypedPageContext, TypedPageModule, TypedDb, TypedReadDb, TypedSlot, UpdateData, Where, } from './core/page/typed.js';
+export { resolvePageOps, type ActionOp, type DroppedOp, type OpenOp, type PageOp, type PageOpsAllowed, type ResolvedActionOp, type ResolvedOp, type ResolvedOpenOp, type ResolvedSlotOp, type SlotOp, } from './core/page/ops.js';
+export { emitSlotsSource } from './builder/codegen/emit.js';
+export { companySchemaCompatibilityIssues, compiledTableEntries, compileSlotSchema, emptyFieldValue, formatFieldPath, getCompiledTable, getTableField, relationsOf, type TableRelation, isFieldValue, isReservedTableName, isResolved, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, DATE_VALUE_FORMAT, DATE_VALUE_PATTERN, DATETIME_VALUE_FORMAT, DATETIME_VALUE_PATTERN, isValidDataTypeValue, companyFieldToRuntime, makeFieldValue, parseFieldPath, refKind, refValueIssues, requireFieldPath, slotFieldEntries, slotFieldNames, validateBareValue, validateFieldRefs, } from './core/slot/index.js';
+export type { RefKind } from './core/slot/index.js';
+export type { FieldPath, ParsedFieldPath, SlotRow, } from './core/slot/index.js';
+export { canonicalLanguage, CHANNELS, checkSpoken, CONTACT_LANGUAGES, fallbackSpoken, isContactLanguage, isSpokenLanguage, languageName, matchContactLanguage, matchSpokenLanguage, pickSpoken, SPOKEN_LANGUAGES, type Channel, type Direction, type ScheduledContactContext, type Spoken, type ContactLanguage, type SpokenLanguage, type SpokenTag, } from './core/conversation/index.js';
+export * from './core/case-orchestrator/index.js';
+export * from './core/party/index.js';
+export * from './voice-service/index.js';
+export { dayIn, formatTime, timeAt, timeParts, type FormatTimeOptions, type TimeParts, type TimeStyle } from './core/page/time-format.js';
+export { CONSOLE_LINE_MAX_CHARS, CONSOLE_LINES_PER_RUN, CONSOLE_METHODS, DEFAULT_SANDBOX_LIMITS, runInSandbox, SandboxError, type ConsoleLevel, type ConsoleMethod, type ConsoleSink, type HostCall, type HostResult, type SandboxErrorKind, type SandboxInput, type SandboxLimits, type SandboxOutput, type SandboxStats, } from './core/page/sandbox.js';
+export { asArray, checkListSizes, afterOf, COMBINATORS, findAnchors, indexConditions, indexedFieldsOf, indexOrder, indexValueOf, isPlainObject, isUuid, limitExceeded, matches, optionalCount, orderKeys, orderRows, pageRows, RECORDS_LIMITS, RecordsQueryError, refuseSearch, relatedKey, relationFilters, RELATION_INCLUDE_KEYS, selectFields, skipOf, startableConditions, tableIndexedFields, toSlot, unstartableWhy, WAY_BACK_FILTERS, wayBackFilters, type Anchor, type FindArgs as RecordsFindArgs, type IndexCondition, type IndexedField, type IndexOrder, type IndexValue, type MatchContext, type RecordsCall, type RecordsMethod, type RecordsQueryErrorCode, type RowOut, type SlotOut, type WhereInput, } from './core/page/records-query.js';
+export { atCall, dayCall, DEFAULT_PAGE_ZONE, partsCall, timeCall, timeOfCaller } from './core/page/page-host.js';
+export * from './index.js';
+export * from './worker.js';
+export * from './compiler.js';
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.js

@@ -0,0 +1,57 @@
+export { ROW_ID_FIELD, ROW_SYSTEM_KEYS, ROW_TIME_KEYS, isRowTimeKey, idFieldCore, normalFieldCoreSchema, companyNormalFieldDefSchema, tableRefSchema, companyFieldDefSchema, companyTableDefSchema, companySchemaSchema, contactScheduleValueSchema, localTimeRangeSchema, isCompanySchema, EMPTY_SESSION_SCHEMA, sessionFieldDefSchema, sessionSchemaSchema, } from './core/slot/schema.js';
+export { CONTACT_OPT_OUT_FIELDS, CONTACT_TABLE, LIMITS, POLICY_IDS, PLATFORM_CONTACT_FIELDS, PLATFORM_SESSION_FIELDS, PLATFORM_SESSION_SCHEMA, SESSION_TABLE, validateCompanySchema, sessionSchemaIssues, isCustomTable, isParentField, isRecordTable, parentOf, subjectTableIssues, } from './core/slot/company-metadata.js';
+export { STATE_CODES, STATE_TIMEZONES, areaCodeTimezone, contactTimezone, knownTimezone, postalTimezone, stateCode, } from './core/slot/contact-timezone.js';
+export { randomTimeBetween } from './core/case-orchestrator/time.js';
+export { contactHoursOn, contactScheduleHours, everyDay, nextContactTime, withinContactHours, } from './core/case-orchestrator/contact-hours.js';
+export { integrationSurfaceKeys } from './core/context/types.js';
+export { lookupRef, parentRef } from './core/slot/id-ref.js';
+export { EMAIL_PLATFORM_ONLY_METHODS, emailGetAttachmentInput, emailGetAttachmentOutput, emailGetMessageInput, emailGetMessageOutput, emailListMessagesInput, emailListMessagesOutput, emailMockService, emailProvider, emailSendEmailInput, emailSendEmailOutput, } from './core/context/email.js';
+export { CALL_PAGE_LIMIT_MAX, callDirection, callGetInput, callGetOutput, callListInput, callListOutput, callMockService, callParticipant, callRecord, callSurface, callTranscriptInput, callTranscriptLine, callTranscriptOutput, } from './core/context/call.js';
+export { CONTACT_PAGE_LIMIT_MAX, contactCreateInput, contactFindInput, contactFindOutput, contactListInput, contactListOutput, contactMockService, contactSummary, contactSurface, slotFieldValue, } from './core/context/contact.js';
+export { instanceCloseInput, instanceCloseOutput, instanceFindForContactInput, instanceIdInput, instanceListOutput, instanceNotifyInput, instanceNotifyOutput, instanceSetVariablesInput, instanceStartInput, instanceStartOutput, instanceSummary, instancesMockService, instancesSurface, } from './core/context/instances.js';
+export { channelMailbox, channelPhoneNumber, channelsListInput, channelsListOutput, channelsMockService, channelsSurface, } from './core/context/channels.js';
+export { exchangeEmailThreadInput, exchangeEmailThreadOutput, exchangeLastInput, exchangeLastOutput, exchangeRef, exchangeSummary, exchangesMockService, exchangesSurface, } from './core/context/exchanges.js';
+export { SYSTEM_VARIABLES, compileVariables, defineSequence, defineVariables, isSystemVariable, json, readVariables, startVariables, variableValueIssue, variablesSize, variablesWriteIssues, } from './core/sequence/index.js';
+export { EMAIL_PAGE_LIMIT_MAX, emailDirection, emailGetInput, emailGetOutput, emailHistoryMockService, emailHistorySurface, emailListInput, emailListOutput, emailRecord, emailSendInput, emailSendOutput, } from './core/context/email-message.js';
+export { KV_KEY_MAX, KV_SCOPES, KV_TTL_SECONDS_MAX, KV_VALUE_MAX, kvDelInput, kvDelOutput, kvGetInput, kvGetOutput, kvMockService, kvScope, kvSetInput, kvSetOutput, kvSurface, } from './core/context/kv.js';
+export { SMS_PAGE_LIMIT_MAX, smsDirection, smsGetInput, smsGetOutput, smsListInput, smsListOutput, smsMockService, smsRecord, smsSurface, } from './core/context/sms.js';
+export { bindEnvService, envMockService, readEnvGet } from './core/context/env.js';
+export { platformSurfaces } from './core/context/platform-registry.js';
+export { COMPANY_SCOPE, CONTEXT_PAGE_FUNCTION, functionKey, functionScriptFile } from './builder/types.js';
+export { parseOfficeHours, resolveOfficeHours, } from './core/office-hours/index.js';
+export { isSystemEventName, SYSTEM_EVENT_NAMES, SYSTEM_EVENTS, WEBHOOK_RECEIVED_FUNCTION, webhookOutcome, } from './core/functions/events.js';
+export { defineSchedules, SCHEDULE_FUNCTION_PREFIX, SCHEDULES_MODULE, scheduleFunctionName, } from './core/functions/schedules.js';
+export { parseSchedules, scheduleTimingIssue } from './builder/schedules.js';
+export { ERROR_JSON_MAX_BYTES, ERRORS_MODULE, ON_ERROR_FUNCTION, PLATFORM_UNAVAILABLE_MESSAGE, PlatformUnavailableError, } from './core/functions/errors.js';
+export { toEventRegistry, toFunctionRegistry } from './builder/compile/registry.js';
+export { compileFunctionCode } from './builder/compile/function-code.js';
+export { COMPILE_CONCURRENCY, COMPILE_SEQUENCE_TIMEOUT_MS, compileAll, compileCompanyPart, compileRepo, compileSequence, compileSequenceBuild, runtimePackageSource, runtimePackageVersion, } from './builder/compile/compile-sequence.js';
+export { loadSequenceEvents, loadSequenceFunctions } from './builder/load.js';
+export { findTsModule } from './builder/paths.js';
+export { encodeOverlayMessage, OVERLAY_REPLACED_CLOSE_CODE, parseOverlayMessage } from './dev-overlay/protocol.js';
+export { asCaseOrchestratorRun, buildActionContext, buildCaseOrchestratorContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, encodeLogTagsHeader, formatRuntimeVersion, readLogTagsHeader, readRequestIdHeader, readRuntimeVersionHeader, makeCaseOrchestratorCtx, makeCtx, makeCtxAsync, noopLog, } from './fn-context/index.js';
+export { createAppRouter, createIntegrationRouter, createListSurfacesProcedure, createLogRouter, createPlatformRouter, createCaseOrchestratorToolsRouter, createRecordsRouter, isRpcCodedError, parseScriptInput, reasonError, RpcReasonError, ScriptInputError, } from './fn-context/rpc/index.js';
+export * from './compute-host/index.js';
+export { announceAction, createRowAction, definePage, deleteRowAction, emptyRuns, endAction, fieldCell, keypadAction, lastActionRun, pageEntry, transferTo, isSipUri, runFunction, voicemailAction, PAGE_TOOLS, cancelFollowUpAction, followUpAction, choose, isChoose, refFieldCell, tried, checkPageStart, MAX_FAQ_ENTRIES, PAGE_CHANNELS, } from './core/page/define.js';
+export { actionKey, runKeyOf, fallbackPage, PageDocumentError, pressedButton, renderDocument, RowNames, } from './core/page/render.js';
+// The page in functions (76): the company API's, and what the platform and its tests read of them.
+export { announce, backgroundTransfer, block, button, cancelFollowUp, coldTransfer, convertTime, createRow, data, deleteRow, doNow, end, field, functionHandles, actionHandles, isNode, keypad, list, page, pressKeypad, refField, run, scheduleFollowUp, text, toFnPageResult, toolbox, voicemail, warmTransfer, } from './core/page/fns.js';
+export { isEnvelope } from './core/page/envelope.js';
+export { TIMELINE_KINDS } from './core/page/timeline.js';
+export { blockAt, nextStepReference, viewText, workspaceText } from './core/page/workspace.js';
+export { resolvePageOps, } from './core/page/ops.js';
+export { emitSlotsSource } from './builder/codegen/emit.js';
+export { companySchemaCompatibilityIssues, compiledTableEntries, compileSlotSchema, emptyFieldValue, formatFieldPath, getCompiledTable, getTableField, relationsOf, isFieldValue, isReservedTableName, isResolved, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, DATE_VALUE_FORMAT, DATE_VALUE_PATTERN, DATETIME_VALUE_FORMAT, DATETIME_VALUE_PATTERN, isValidDataTypeValue, companyFieldToRuntime, makeFieldValue, parseFieldPath, refKind, refValueIssues, requireFieldPath, slotFieldEntries, slotFieldNames, validateBareValue, validateFieldRefs, } from './core/slot/index.js';
+export { canonicalLanguage, CHANNELS, checkSpoken, CONTACT_LANGUAGES, fallbackSpoken, isContactLanguage, isSpokenLanguage, languageName, matchContactLanguage, matchSpokenLanguage, pickSpoken, SPOKEN_LANGUAGES, } from './core/conversation/index.js';
+export * from './core/case-orchestrator/index.js';
+export * from './core/party/index.js';
+export * from './voice-service/index.js';
+export { dayIn, formatTime, timeAt, timeParts } from './core/page/time-format.js';
+export { CONSOLE_LINE_MAX_CHARS, CONSOLE_LINES_PER_RUN, CONSOLE_METHODS, DEFAULT_SANDBOX_LIMITS, runInSandbox, SandboxError, } from './core/page/sandbox.js';
+export { asArray, checkListSizes, afterOf, COMBINATORS, findAnchors, indexConditions, indexedFieldsOf, indexOrder, indexValueOf, isPlainObject, isUuid, limitExceeded, matches, optionalCount, orderKeys, orderRows, pageRows, RECORDS_LIMITS, RecordsQueryError, refuseSearch, relatedKey, relationFilters, RELATION_INCLUDE_KEYS, selectFields, skipOf, startableConditions, tableIndexedFields, toSlot, unstartableWhy, WAY_BACK_FILTERS, wayBackFilters, } from './core/page/records-query.js';
+export { atCall, dayCall, DEFAULT_PAGE_ZONE, partsCall, timeCall, timeOfCaller } from './core/page/page-host.js';
+// The other entries in full, so this one holds them by construction (`package-entries.test.ts`).
+export * from './index.js';
+export * from './worker.js';
+export * from './compiler.js';
+//# sourceMappingURL=platform.js.map

package/dist/testing-compile-child.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=testing-compile-child.d.ts.map

package/dist/testing-compile-child.js

@@ -0,0 +1,20 @@
+/**
+ * Compiles one sequence for the testing entry (`testing.ts`) in a process of its own, and sends back its
+ * build and compiled schema. Out of the test's process: the compile loads the company's code through its
+ * own import hooks, which would otherwise count in the test run's coverage and stay installed there.
+ *
+ * Run as `node testing-compile-child.js <repoRoot> <sequence>`; answers one IPC message.
+ */
+import { compileSequence } from './builder/compile/compile-sequence.js';
+const [repoRoot, sequence] = process.argv.slice(2);
+async function main() {
+    try {
+        const { build, schema } = await compileSequence(repoRoot, sequence, { dryRun: true });
+        process.send({ ok: true, build, schema });
+    }
+    catch (error) {
+        process.send({ ok: false, error: error instanceof Error ? error.message : String(error) });
+    }
+}
+void main();
+//# sourceMappingURL=testing-compile-child.js.map

package/dist/testing.d.ts

@@ -0,0 +1,368 @@
+import { type SequenceBuild } from './builder/types.js';
+import { type LogLine, type LogsQuery } from './cli/logs/index.js';
+import type { ApiCall } from './cli/exec/trace.js';
+import { type TestCustomer, type TextCall } from './cli/calls/index.js';
+import { type TurnRead, type TurnsQuery, type TurnSummary } from './cli/turns/index.js';
+import type { CaseOrchestratorTools, ScheduledActionView } from './core/case-orchestrator/types.js';
+import { type PageChannel, type PageContext, type PageEntryArg, type PageNextStep, type PageScheduledAction, type PageStart } from './core/page/define.js';
+import { type MemoryRows } from './core/page/memory-reader.js';
+import type { RecordsCall } from './core/page/records-query.js';
+import { type RenderedPage } from './core/page/render.js';
+import { type ConsoleLevel, type HostResult } from './core/page/sandbox.js';
+import { type OfficeHours, type OfficeHoursSnapshot } from './core/office-hours/index.js';
+import type { SystemContext } from './core/context/types.js';
+import type { Db } from './core/page/define.js';
+import { makeCaseOrchestratorCtx as makePlatformCaseOrchestratorCtx } from './fn-context/make-ctx.js';
+import { type RunResult, type TurnInput } from './cli/turns/shadow.js';
+export { fakeTools, unfaked } from './fn-context/fake/index.js';
+/**
+ * What a test may set on the fake `ctx`. Each `api` surface takes only the methods the test fakes
+ * (`{ exchanges: { last: async () => ({ exchange: null }) } }`), the rest keep their stand-ins; `api.db`
+ * takes any object (`recordingDb`), so a test fakes only the tables it needs.
+ */
+export type TestCtxOverrides = {
+    today?: string;
+    timezone?: string;
+    now?: number;
+    meta?: Partial<SystemContext['meta']>;
+    config?: Partial<SystemContext['config']>;
+    api?: {
+        [K in keyof SystemContext['api']]?: K extends 'db' ? object : Partial<SystemContext['api'][K]>;
+    };
+};
+/**
+ * A fake `ctx`, typed as the caller asks: `makeCtx<Ctx>()` for a function, with `Ctx` from the
+ * sequence's `__gen`. Data slice defaults: `today` 1970-01-01, `timezone` UTC. Any `api` call the test
+ * did not fake rejects, naming the call.
+ */
+export declare function makeCtx<C = SystemContext>(overrides?: TestCtxOverrides): C;
+/** A fake Orchestrator `ctx`, typed as the caller asks; `tools` fakes `ctx.api.tools`, `db` fakes `ctx.api.db`. */
+export declare function makeCaseOrchestratorCtx<C = Awaited<ReturnType<typeof makePlatformCaseOrchestratorCtx>>>(overrides?: TestCtxOverrides & {
+    tools?: Partial<CaseOrchestratorTools>;
+    db?: object;
+}): Promise<C>;
+/** One call a function made on `db`. */
+export type DbCall = {
+    table: string;
+    method: string;
+    args: unknown;
+};
+/** Answers for `db` calls, by table then method; the return value is what the call resolves to. */
+export type DbHandlers = Record<string, Record<string, (args: any) => unknown>>;
+/**
+ * A `db` that records every call in `calls`, in order, and answers from `handlers`. A call with no
+ * handler rejects, naming it, so a test sees every read and write the function makes.
+ */
+export declare function recordingDb(handlers?: DbHandlers): {
+    db: Db;
+    calls: DbCall[];
+};
+/**
+ * A row as `ctx.api.db` hands it out, for a `recordingDb` handler to return: `id` as given, every other
+ * field a slot (`{ value, state, reason, updatedAt, ref }`), `filled` when it has a value, `empty` when
+ * null. A test that returns plain values instead (`{ crm_id: null }`) checks code against a shape the
+ * platform never gives: `if (row.crm_id)` is then false in the test and always true for real.
+ */
+export declare function row(table: string, values: {
+    id: string;
+} & Record<string, unknown>): any;
+/** One request `mockFetch` answered. */
+export type FetchCall = {
+    method: string;
+    url: string;
+    body: string | null;
+};
+/** A route: requests whose method (any, when left out) and URL (exact, or a pattern) match it. */
+export type FetchRoute = {
+    method?: string;
+    url: string | RegExp;
+    /** A `Response` is returned as is; any other value is sent as JSON with status 200. */
+    respond: (request: Request) => unknown;
+};
+/**
+ * Replaces the global `fetch` until `restore()`: each request goes to the first matching route; one
+ * that matches none rejects, so a test never reaches a real system (a CRM, a payment provider).
+ */
+export declare function mockFetch(routes: FetchRoute[]): {
+    calls: FetchCall[];
+    restore: () => void;
+};
+/** What the page function gets besides the data; each left out is what a conversation without it has. */
+export type RenderPageInput = {
+    /** The sequence: its directory under `sequences/`. */
+    sequence: string;
+    /** The repository's root; the working directory when left out (where `npm test` runs). */
+    repoRoot?: string;
+    /** The rows the page can read, by table: `{ contact: [{ id: 'c1', first_name: 'Ann' }] }`. A field left out or null is empty. */
+    data: MemoryRows;
+    /** The id of the row the sequence runs about (its `subject` table's). */
+    subject: string;
+    /** The conversation's contact (`ctx.caller`), one of `data.contact`; none outside a conversation. */
+    caller?: string | null;
+    /** The page function to run; the page's first one when left out. */
+    channel?: PageChannel | null;
+    /** The render's time (ISO 8601); 2026-01-01T15:00:00Z when left out. */
+    now?: string;
+    scheduledAction?: PageScheduledAction | null;
+    officeHours?: PageContext['officeHours'];
+    nextSteps?: PageNextStep[];
+    /** `ctx.env`: the environment's configuration the page reads (76 §2.19); none when left out. A turn's export does not carry it. */
+    env?: Record<string, unknown>;
+    sms?: {
+        inbound: NonNullable<Extract<PageEntryArg, {
+            mode: 'render' | 'start';
+        }>['sms']>['inbound'];
+    };
+    email?: NonNullable<Extract<PageEntryArg, {
+        mode: 'render' | 'start';
+    }>['email']>;
+    call?: NonNullable<Extract<PageEntryArg, {
+        mode: 'render' | 'start';
+    }>['call']>;
+    /**
+     * `ctx.history`: the counts and the timeline the page reads; 0 and none when left out. Or each call and
+     * its answer (`[{ method, where, result }]`, a turn's export): a call not among them fails the render.
+     */
+    history?: {
+        sessionCount?: number;
+        exchangeCount?: number;
+        timeline?: unknown[];
+    } | HistoryAnswer[];
+    /** `ctx.session`, as the page gets it (a call's session row); none when left out. */
+    session?: RenderArg['session'];
+    /** `ctx.runs`: what the conversation's actions did; none when left out. */
+    runs?: RenderArg['runs'];
+    /** `ctx.conversation`; none when left out. */
+    conversation?: RenderArg['conversation'];
+    /** The case's id (`ctx.instanceId`); `test-instance` when left out. */
+    instanceId?: string;
+};
+/** What a render or a start of the page function is given. */
+type RenderArg = Extract<PageEntryArg, {
+    mode: 'render' | 'start';
+}>;
+/** One `ctx.history` call a page made and its answer, as a turn's export keeps them. */
+export type HistoryAnswer = {
+    method: unknown;
+    where: unknown;
+    result: HostResult;
+};
+export type RenderedTestPage = {
+    /** The page as the platform builds it from what the page function returned: its blocks, fields, buttons. */
+    page: RenderedPage;
+    /** The page as the AI reads it. */
+    text: string;
+    /** Every `db` read the page made, in order. */
+    reads: RecordsCall[];
+    /** The page's `console` lines. */
+    console: Array<{
+        level: ConsoleLevel;
+        text: string;
+    }>;
+};
+/** A page script that failed: what the sandbox said, and where in the compiled page it threw. */
+export declare class PageTestError extends Error {
+    readonly scriptStack: string | null;
+    constructor(message: string, scriptStack: string | null);
+}
+/**
+ * Renders the sequence's page (`context.page.ts`) over `data`, as the platform renders it: the same
+ * compile, sandbox, `db` semantics and page building, with the rows read from `data` instead of the
+ * database. A read the platform refuses is refused here too.
+ */
+export declare function renderPage(input: RenderPageInput): Promise<RenderedTestPage>;
+/**
+ * A turn's export (`turns export <turnId>`, `exportTurn`) as `renderPage`'s input: the moment the turn
+ * began — its rows, its `ctx`, and each `ctx.history` answer — to render with this repository's code now.
+ */
+export declare function fromTurn(dir: string, options?: {
+    repoRoot?: string;
+}): RenderPageInput;
+/** What the page decides when the conversation starts (its `persona` and `faq`), over `data`. */
+export declare function startPage(input: RenderPageInput): Promise<PageStart>;
+/**
+ * The office hours (`office-hours.ts`) at `at` (ISO 8601 or epoch ms), as the platform reads them: open
+ * or not, and today's windows. Office hours the platform would refuse fail with what is wrong.
+ */
+export declare function officeHoursAt(officeHours: OfficeHours, at: string | number): OfficeHoursSnapshot;
+/**
+ * The sequence compiled as a release compiles it (`index.ts`, its variables, functions, events, office
+ * hours, Orchestrator and page), for a test that checks its configuration. A configuration the release
+ * would refuse rejects with the release's message. Compiled once per test run.
+ */
+export declare function compileForTest(input: {
+    sequence: string;
+    repoRoot?: string;
+}): Promise<SequenceBuild>;
+export type { ApiCall, LogLine, LogsQuery, OfficeHours, OfficeHoursSnapshot, SequenceBuild };
+export type { TurnRead, TurnRecord, TurnSnapshot, TurnsQuery, TurnSummary } from './cli/turns/index.js';
+export type { InboxItem, SentResult, TestCustomer, TextCall, TextCallEnd, TextCallEvent, TextCallStep } from './cli/calls/index.js';
+/** An open connection to an environment for an integration test (`connect`). */
+export type Connection<C = SystemContext> = {
+    /** The environment (never prod). */
+    environment: {
+        id: string;
+        name: string;
+    };
+    /** A real `ctx`: each `ctx.api` call reads and writes the environment's data, and is recorded in `calls`. */
+    ctx: C;
+    /**
+     * The last 200 `ctx.api` calls made through `ctx`, in order: `call`, `input`, `ok`, `output` or `error`,
+     * `ms`. Every call, however many, is in `callsFile` (one JSON per line).
+     */
+    calls: ApiCall[];
+    callsFile: string;
+    /**
+     * What the code wrote (`ctx.api.log`, the page's `console`, its functions' failures) in this environment,
+     * read from the platform's log store now: oldest first, since this connection opened unless `since` says
+     * otherwise, at most `limit` (200; 500 at most). Filter by `instance`, `run`, `contact`, `sequence`,
+     * `request`, `level` (`warn`: warn and error), `search`. Lines reach the store a few seconds after they
+     * are written.
+     */
+    logs(query?: Omit<LogsQuery, 'env'>): Promise<LogLine[]>;
+    /**
+     * A case's page as a conversation on it renders it now: this repository's page, the case's real data.
+     * `caller`: the conversation's contact; the case's subject when it is a contact and none is named.
+     * Returns `page` and `text` as the unit tests' `renderPage` does, so the same checks apply.
+     */
+    renderPage(input: {
+        instanceId: string;
+        channel: PageChannel;
+        caller?: string;
+    }): Promise<{
+        page: RenderedPage;
+        text: string;
+    }>;
+    /**
+     * The case's Orchestrator run now, as after an external event (`ctx.api.instances.notify`), with the
+     * inputs the platform builds for the case and this repository's code. Says how it ended and the
+     * follow-ups it scheduled and cancelled; they are real, and run when due.
+     */
+    runOrchestrator(input: {
+        instanceId: string;
+        reason?: string;
+    }): Promise<{
+        status: 'completed' | 'failed' | 'held' | 'idle' | 'no_orchestrator';
+        failureCode?: string;
+        scheduled: ScheduledActionView[];
+        cancelled: ScheduledActionView[];
+    }>;
+    /**
+     * One turn, always a shadow (68 §8): a text or email run, or a call's turn, as when the customer writes or
+     * says `say`, with this repository's page, the platform's model, and the case's data as it is now — or
+     * `from` a turn that ran (its id, or the directory it was exported to): its rows and conversation as they
+     * were then, its words heard again (`say` replaces them). It runs on a shadow of the environment's
+     * database: what it did comes back (`writes`, `actions`, `said`, `events`) and none of it is kept, sent,
+     * booked or woken. Company functions are not run: replayed from the turn's record (`from`), else
+     * `functions.results`, else answered as not run (`functions` says which). The model words things
+     * differently each time: check what it did, and with `repeat` how often (`rate(run => run.clicked('x'))`).
+     */
+    turn(input: TurnInput): Promise<RunResult>;
+    /**
+     * Runs `actions` on the case's page as the model's step would, with no model: `{ fill: '<field id>',
+     * value }`, `{ click: '<button id>', arguments }`, `{ note: '…' }`… (field and button ids as the page
+     * names them: `renderPage`'s `text`). Then the run ends without a reply. `stepResult` is what the
+     * platform told the model about each action.
+     */
+    act(input: TurnInput & {
+        actions: unknown[];
+    }): Promise<RunResult>;
+    /**
+     * The turns of a case, a run or a call in this environment, oldest first (68 §7.4): what the customer
+     * said, what the AI said, the buttons and functions it ran, the fields it wrote. Name one of them.
+     */
+    turns(query: TurnsQuery): Promise<TurnSummary[]>;
+    /** One turn, and what it began with (`snapshot`: null once it is no longer kept, after 30 days). */
+    readTurn(turnId: string): Promise<TurnRead>;
+    /** One turn written to `dir` (`.superpanel/turns/<turnId>/` when left out), as `turns export` writes it; the directory. */
+    exportTurn(turnId: string, dir?: string): Promise<string>;
+    /**
+     * Test lines and customers (68 §5.3): `line(name)` is the environment's simulated line of that name
+     * (`Main line` when left out), made when it has none, a number no provider carries; `phone()` a new test
+     * customer's number. A simulated line reaches test customers only, and a test customer only a simulated line.
+     */
+    sim: {
+        /**
+         * When a real line has that name, the simulated line stands in for it (`mirrors`): your `resolve` sees
+         * it by that name, and code's `from` that names the real line reaches a test customer through it.
+         */
+        line(name?: string): Promise<{
+            id: string;
+            number: string;
+            name: string;
+            mirrors: {
+                id: string;
+                number: string;
+            } | null;
+        }>;
+        /** The environment's simulated mailbox of that name (`Support` when left out), made when it has none: an address no provider has; standing in for a real one of that name, as `line` does. */
+        mailbox(name?: string): Promise<{
+            id: string;
+            address: string;
+            name: string;
+            mirrors: {
+                id: string;
+                address: string;
+            } | null;
+        }>;
+        phone(): string;
+        /**
+         * A test customer (68 §5.2), a new number and address unless given: they text and email the simulated
+         * lines and mailboxes, wait for what the environment sends them (`next('sms')`, `next('call')`), and
+         * answer or let ring its calls.
+         */
+        customer(input?: {
+            phone?: string;
+            email?: string;
+        }): TestCustomer;
+    };
+    /**
+     * A case's next scheduled step done now, as its job would when due (68 §6.4): for a step that waits for a
+     * day ("call on day 2"). Contact hours are the environment's to switch off (Environments page), not this.
+     */
+    runDue(input: {
+        instanceId: string;
+        scheduledActionId?: string;
+    }): Promise<{
+        action: {
+            id: string;
+            kind: string;
+            name: string | null;
+            reason: string | null;
+            scheduledFor: string;
+        } | null;
+        result: unknown;
+    }>;
+    /**
+     * A call in text (68 §4): a test customer (`from`, `sim.phone()`) calls a simulated line (`to`, its name or
+     * number, `Main line` when left out). This repository's code on the environment's real data, as a real
+     * call: the resolves, the opening, each turn, the wrap-up after the hang-up, `call.ended`, the Orchestrator.
+     * What the AI says comes back as text; a keypad, a transfer or a voicemail as an event to answer.
+     */
+    call: {
+        inbound(input: {
+            from: string;
+            to?: string;
+        }): Promise<TextCall>;
+    };
+    /** Stops serving this repository on the environment. Called by itself after the test file's tests. */
+    close(): Promise<void>;
+};
+export type { RunResult, ShadowRun, TurnInput } from './cli/turns/shadow.js';
+/**
+ * Connects a test file to an environment (`sandbox` when `env` is left out) as the CLI's login: this
+ * repository's code serves it (as `superpanel-sdk-runtime serve` does, its imports checked as a release
+ * checks them) until the file's tests are done, and `ctx` reads and writes the environment's real data.
+ * What a test writes is written.
+ */
+/**
+ * `debug`: when a test's debug package is written (68 §9, `.superpanel/tests/`): `failed` (the default),
+ * `always`, or `off`; `SUPERPANEL_TEST_DEBUG` overrides it.
+ */
+export declare function connect<C = SystemContext>(options?: {
+    env?: string;
+    repoRoot?: string;
+    url?: string;
+    debug?: 'failed' | 'always' | 'off';
+}): Promise<Connection<C>>;
+//# sourceMappingURL=testing.d.ts.map