@superpanel-sdk/runtime 0.2.3 → 0.7.0

package/dist/fn-context/rpc/trpc-router-factory.d.ts

@@ -1,26 +1,50 @@
 import { createIntegrationRouter } from './integration/index.js';
 import { createLogRouter } from './log.js';
 import { createPlatformRouter } from './platform.js';
+import { createRecordsRouter } from './records.js';
+import { createCaseOrchestratorToolsRouter } from './case-orchestrator-tools.js';
 export declare function createAppRouter(modules: {
     integration: ReturnType<typeof createIntegrationRouter>;
     platform: ReturnType<typeof createPlatformRouter>;
     log: ReturnType<typeof createLogRouter>;
+    caseOrchestratorTools: ReturnType<typeof createCaseOrchestratorToolsRouter>;
+    records: ReturnType<typeof createRecordsRouter>;
 }): import("@trpc/server").TRPCBuiltRouter<{
     ctx: import("./trpc-init.js").RpcContext;
     meta: object;
-    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+    errorShape: import("@trpc/server").TRPCDefaultErrorShape | {
+        message: string;
+        code: import("@trpc/server").TRPC_ERROR_CODE_NUMBER;
+        data: {
+            code: import("@trpc/server").TRPC_ERROR_CODE_KEY;
+            httpStatus: number;
+            path?: string;
+            stack?: string;
+            reason: string;
+        };
+    };
     transformer: false;
 }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
     integration: import("@trpc/server").TRPCBuiltRouter<{
         ctx: import("./trpc-init.js").RpcContext;
         meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+        errorShape: import("@trpc/server").TRPCDefaultErrorShape | {
+            message: string;
+            code: import("@trpc/server").TRPC_ERROR_CODE_NUMBER;
+            data: {
+                code: import("@trpc/server").TRPC_ERROR_CODE_KEY;
+                httpStatus: number;
+                path?: string;
+                stack?: string;
+                reason: string;
+            };
+        };
         transformer: false;
     }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        listBindings: import("@trpc/server").TRPCQueryProcedure<{
+        listSurfaces: import("@trpc/server").TRPCQueryProcedure<{
             input: void;
             output: {
-                surfaceKey: "docusigns" | "envs" | "filevines" | "hubspots" | "twilios";
+                surfaceKey: "emails" | "envs";
                 target: {
                     kind: "account" | "resource";
                     id: string;
@@ -48,14 +72,24 @@ export declare function createAppRouter(modules: {
     platform: import("@trpc/server").TRPCBuiltRouter<{
         ctx: import("./trpc-init.js").RpcContext;
         meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+        errorShape: import("@trpc/server").TRPCDefaultErrorShape | {
+            message: string;
+            code: import("@trpc/server").TRPC_ERROR_CODE_NUMBER;
+            data: {
+                code: import("@trpc/server").TRPC_ERROR_CODE_KEY;
+                httpStatus: number;
+                path?: string;
+                stack?: string;
+                reason: string;
+            };
+        };
         transformer: false;
     }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
         invoke: import("@trpc/server").TRPCMutationProcedure<{
             input: {
                 surface: string;
                 method: string;
-                params?: Record<string, unknown> | undefined;
+                params?: unknown;
             };
             output: unknown;
             meta: object;
@@ -64,7 +98,17 @@ export declare function createAppRouter(modules: {
     log: import("@trpc/server").TRPCBuiltRouter<{
         ctx: import("./trpc-init.js").RpcContext;
         meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+        errorShape: import("@trpc/server").TRPCDefaultErrorShape | {
+            message: string;
+            code: import("@trpc/server").TRPC_ERROR_CODE_NUMBER;
+            data: {
+                code: import("@trpc/server").TRPC_ERROR_CODE_KEY;
+                httpStatus: number;
+                path?: string;
+                stack?: string;
+                reason: string;
+            };
+        };
         transformer: false;
     }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
         emit: import("@trpc/server").TRPCMutationProcedure<{
@@ -80,6 +124,66 @@ export declare function createAppRouter(modules: {
             meta: object;
         }>;
     }>>;
+    caseOrchestratorTools: import("@trpc/server").TRPCBuiltRouter<{
+        ctx: import("./trpc-init.js").RpcContext;
+        meta: object;
+        errorShape: import("@trpc/server").TRPCDefaultErrorShape | {
+            message: string;
+            code: import("@trpc/server").TRPC_ERROR_CODE_NUMBER;
+            data: {
+                code: import("@trpc/server").TRPC_ERROR_CODE_KEY;
+                httpStatus: number;
+                path?: string;
+                stack?: string;
+                reason: string;
+            };
+        };
+        transformer: false;
+    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+        invoke: import("@trpc/server").TRPCMutationProcedure<{
+            input: {
+                tool: string;
+                input: unknown;
+            };
+            output: unknown;
+            meta: object;
+        }>;
+    }>>;
+    records: import("@trpc/server").TRPCBuiltRouter<{
+        ctx: import("./trpc-init.js").RpcContext;
+        meta: object;
+        errorShape: import("@trpc/server").TRPCDefaultErrorShape | {
+            message: string;
+            code: import("@trpc/server").TRPC_ERROR_CODE_NUMBER;
+            data: {
+                code: import("@trpc/server").TRPC_ERROR_CODE_KEY;
+                httpStatus: number;
+                path?: string;
+                stack?: string;
+                reason: string;
+            };
+        };
+        transformer: false;
+    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+        read: import("@trpc/server").TRPCMutationProcedure<{
+            input: {
+                table: string;
+                method: "count" | "findFirst" | "findMany" | "findUnique";
+                args: unknown;
+            };
+            output: import("./records.js").RecordsResult;
+            meta: object;
+        }>;
+        write: import("@trpc/server").TRPCMutationProcedure<{
+            input: {
+                table: string;
+                method: "create" | "delete" | "update" | "upsert";
+                args: unknown;
+            };
+            output: import("./records.js").RecordsResult;
+            meta: object;
+        }>;
+    }>>;
 }>>;
 export type AppRouter = ReturnType<typeof createAppRouter>;
 //# sourceMappingURL=trpc-router-factory.d.ts.map

package/dist/fn-context/rpc/trpc-router-factory.js

@@ -4,6 +4,8 @@ export function createAppRouter(modules) {
         integration: modules.integration,
         platform: modules.platform,
         log: modules.log,
+        caseOrchestratorTools: modules.caseOrchestratorTools,
+        records: modules.records,
     });
 }
 //# sourceMappingURL=trpc-router-factory.js.map

package/dist/fn-context/run-scope.d.ts

@@ -0,0 +1,4 @@
+import type { CaseOrchestratorRunScope, RunClaims } from './types.js';
+/** The Case Orchestrator scope of a run, or null when it is not a complete Case Orchestrator run. */
+export declare function asCaseOrchestratorRun(run: RunClaims): CaseOrchestratorRunScope | null;
+//# sourceMappingURL=run-scope.d.ts.map

package/dist/fn-context/run-scope.js

@@ -0,0 +1,9 @@
+import { ORCHESTRATOR_ENTRY } from '../core/case-orchestrator/types.js';
+/** The Case Orchestrator scope of a run, or null when it is not a complete Case Orchestrator run. */
+export function asCaseOrchestratorRun(run) {
+    const scoped = run;
+    if (run.entry !== ORCHESTRATOR_ENTRY || !scoped.instanceId || !scoped.orchestratorTaskId)
+        return null;
+    return run;
+}
+//# sourceMappingURL=run-scope.js.map

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

@@ -1,17 +1,64 @@
-import type { SystemContext } from '../core/context/types.js';
+import type { ORCHESTRATOR_ENTRY, CaseOrchestratorApi, CaseOrchestratorContext } from '../core/case-orchestrator/types.js';
+import type { IntegrationSurfaceMeta, SystemContext } from '../core/context/types.js';
 /** Alias for {@link SystemContext} (08 ActionContext shape). */
 export type ActionContext = SystemContext;
-/** JSON-serializable data slice of ActionContext (no `api`). */
-export type ActionDataSlice = Pick<ActionContext, 'time' | 'meta' | 'config'>;
+/**
+ * JSON-serializable data slice of ActionContext (no `api`, no `time.format` / `time.day`: added where the
+ * function runs). Its ids are plain strings on the wire; the function's `ctx.meta` types them.
+ */
+export type ActionDataSlice = Pick<ActionContext, 'config'> & {
+    /** `ignore` absent (a platform before 68 §6.2): nothing is ignored. */
+    time: Omit<ActionContext['time'], 'format' | 'day' | 'at' | 'parts' | 'ignore'> & Partial<Pick<ActionContext['time'], 'ignore'>>;
+    meta: ActionContext['meta'];
+    /**
+     * What `ctx.api.integration` offers this run (its connections and mailboxes, with their credentials),
+     * listed by the platform as it calls the function: the host builds the api from it instead of asking
+     * the backend first. Not part of `ctx` itself.
+     */
+    surfaces?: IntegrationSurfaceMeta[];
+};
+/** What the call brought for the api ({@link ActionDataSlice.surfaces}): a host lists what is left out. */
+export type ApiGiven = {
+    surfaces?: IntegrationSurfaceMeta[];
+};
 /** Identity / scope for a single function invocation (ApiHost may key caches on this). */
 export type RunScope = {
     companyId: string;
     environmentId: string;
-    sequenceId: string;
     entry: string;
+    /** The instance a case-bound run works on; absent on nocase runs. */
+    instanceId?: string;
+    /**
+     * The AI run (`AgentRun`) that called the function, with `instanceId` the case it is on (21 §6.5): what
+     * the function writes back through the platform is that run's. Set by the platform only.
+     */
+    agentRunId?: string;
+    /**
+     * The published company build (`ReleaseBuildBatch`) the run started on: one run uses one build (22 §5),
+     * so `ctx.api` reads the schema from it, not from whatever release is live by then. Absent on the serve
+     * overlay, which is not pinned. Set by the platform only.
+     */
+    buildId?: string;
 };
 /** Who fulfills `ctx.api` (Fake local vs Rpc remote). */
 export type ApiHost = {
-    buildApi(run: RunScope): Promise<ActionContext['api']>;
+    buildApi(run: RunScope, given?: ApiGiven): Promise<ActionContext['api']>;
+};
+/** `ctx` of `orchestrator` before the host adds `params`. */
+export type CaseOrchestratorActionContext = Omit<CaseOrchestratorContext, 'params'>;
+/** Who fulfills the Case Orchestrator's `ctx.api` (Fake local vs Rpc remote). */
+export type CaseOrchestratorApiHost = {
+    buildCaseOrchestratorApi(run: RunScope, given?: ApiGiven): Promise<CaseOrchestratorApi>;
+};
+/**
+ * Run scope of an Orchestrator call: the instance it is limited to and the `OrchestratorTask` it runs
+ * for (40 §2.3: no `AgentRun`), refused once that task stops running.
+ */
+export type CaseOrchestratorRunScope = RunScope & {
+    entry: typeof ORCHESTRATOR_ENTRY;
+    instanceId: string;
+    orchestratorTaskId: string;
 };
+/** A verified run token's scope; narrow with {@link asCaseOrchestratorRun}. */
+export type RunClaims = RunScope | CaseOrchestratorRunScope;
 //# sourceMappingURL=types.d.ts.map

package/dist/index.d.ts

@@ -1,47 +1,37 @@
-export type { CompanyDerivedFieldDef, CompanyFieldDef, CompanyNormalFieldDef, CompanySchema, CompanyTableDef, DataType, EffectiveFieldDef, EffectiveSchema, EffectiveTableDef, FieldOverride, SequenceCompanyTableView, SequenceSlots, NormalFieldCore, SessionTableDef, } from './core/slot/schema.js';
-export { ROW_ID_FIELD, idField, idFieldCore } from './core/slot/schema.js';
-export { integrationSurfaceKeys } from './core/context/types.js';
-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, 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';
-export type { AnyPlatformSurface, PlatformApiShape, PlatformImpl, PlatformSurface } from './core/context/platform.js';
-export { platformSurfaces, type PlatformApis, type PlatformSurfaceKey } from './core/context/platform-registry.js';
-export { defaultHttpApi } from './core/context/http.js';
-export { hubspotAssociationListOutput, hubspotCreateContactInput, hubspotCreateContactOutput, hubspotCreateDealInput, hubspotCreateDealOutput, hubspotCreateNoteInput, hubspotCreateTaskInput, hubspotEngagementOutput, hubspotGetAssociatedContactsInput, hubspotGetAssociatedDealsInput, hubspotGetContactInput, hubspotGetContactOutput, hubspotGetCrmUrlInput, hubspotGetCrmUrlOutput, hubspotGetDealInput, hubspotGetDealOutput, hubspotGetOwnerInput, hubspotGetOwnerOutput, hubspotLogCallInput, hubspotLogEmailInput, hubspotLogSmsInput, hubspotMockService, hubspotSearchContactsInput, hubspotSearchContactsOutput, hubspotUpdateContactInput, hubspotUpdateContactOutput, hubspotUpdateDealInput, hubspotUpdateDealOutput, hubspotUpsertContactInput, hubspotUpsertContactOutput, } from './core/context/hubspot.js';
-export { docusignCreateEnvelopeFromTemplateInput, docusignCreateEnvelopeFromTemplateOutput, docusignCreateRecipientViewFromTemplateInput, docusignCreateRecipientViewFromTemplateOutput, docusignEnvelopeIdInput, docusignGetEnvelopeRecipientsOutput, docusignGetEnvelopeSigningStatusOutput, docusignGetEnvelopeStatusOutput, docusignListRecentEnvelopesInput, docusignListRecentEnvelopesOutput, docusignListTemplatesOutput, docusignMockService, docusignSearchEnvelopesByEmailInput, docusignSearchEnvelopesByEmailOutput, } from './core/context/docusign.js';
-export { filevineAddHashtagToProjectInput, filevineAddHashtagToProjectOutput, filevineCollectionItemInput, filevineCommentOutput, filevineCreateCommentInput, filevineCreateContactInput, filevineCreateContactOutput, filevineCreateNoteInput, filevineCreateNoteWithCommentInput, filevineCreateNoteWithCommentOutput, filevineCreateProjectCollectionItemInput, filevineCreateProjectCollectionItemOutput, filevineCreateProjectInput, filevineCreateProjectOutput, filevineDeleteProjectCollectionItemInput, filevineDeleteProjectCollectionItemOutput, filevineGetAssociatedProjectsInput, filevineGetAssociatedProjectsOutput, filevineGetContactInput, filevineGetContactOutput, filevineGetCrmUrlInput, filevineGetCrmUrlOutput, filevineGetProjectCollectionItemInput, filevineGetProjectCollectionItemOutput, filevineGetProjectCollectionItemsInput, filevineGetProjectCollectionItemsOutput, filevineGetProjectFoldersInput, filevineGetProjectFoldersOutput, filevineGetProjectInput, filevineGetProjectOutput, filevineLogCallInput, filevineLogEmailInput, filevineLogSmsInput, filevineMockService, filevineNoteOutput, filevineSearchContactsInput, filevineSearchContactsOutput, filevineUpdateContactInput, filevineUpdateContactOutput, filevineUpdateProjectCollectionItemInput, filevineUpdateProjectCollectionItemOutput, filevineUpdateProjectInput, filevineUpdateProjectOutput, filevineUploadDocumentInput, filevineUploadDocumentOutput, } from './core/context/filevine.js';
-export { twilioCreateCallInput, twilioCreateCallOutput, twilioIncomingNumber, twilioListIncomingNumbersOutput, twilioMockService, twilioSendSmsInput, twilioSendSmsOutput, } from './core/context/twilio.js';
-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 { 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, 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, 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';
-export { defineCaseContext, resolveCaseContextViewFn, type CaseContextOf, type CaseContextViewFn, type DefinedCaseContextView, } from './core/functions/define/case-context.js';
-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, 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, 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';
+/**
+ * The company API: everything company code may import from `@superpanel-sdk/runtime`, and nothing else
+ * (09-runtime-compat §6). Company code runs in three places: the compile's Node, the Worker, and the
+ * page's QuickJS sandbox. So what is here behaves the same in all three: it imports no package and no
+ * Node module, and no module it reaches does work at load. The compile bundles it into each code string
+ * as it is; there is no stand-in.
+ *
+ * Named exports only, from the module that defines each: an `export *` lets whatever a module adds
+ * reach company code. `company-api.test.ts` holds the list and checks the entry stays pure. The
+ * platform imports `./platform` (`platform.ts`), which this package resolves only under the
+ * `superpanel-platform` condition.
+ */
+export { defineSequence, defineVariables, json, type JsonVariableType, type SequenceDefinition, type VariableDecl, type VariableDecls, type VariablesOf, } from './core/sequence/define.js';
+export { defineSchedules, type Schedules } from './core/functions/schedules.js';
+export type { Ctx } from './core/functions/types.js';
+export type { EventHandlers, WebhookHandler } from './core/functions/events.js';
+export type { CodeErrorEvent, OnError } from './core/functions/errors.js';
+export { PlatformUnavailableError } from './core/functions/errors.js';
+export { choose, definePage, lastActionRun, tried, type PageChannel, type PageFaqEntry, type PageRuns, } from './core/page/define.js';
+/** A fixed line said to the customer, per language (66 §2). */
+export type { Spoken, SpokenTag } from './core/conversation/index.js';
+export { announce, backgroundTransfer, block, button, cancelFollowUp, coldTransfer, convertTime, createRow, data, deleteRow, doNow, end, field, functionHandles, actionHandles, keypad, list, page, pressKeypad, refField, run, scheduleFollowUp, text, toolbox, voicemail, warmTransfer, type Action, type BlockNode, type ButtonNode, type DataNode, type DoNode, type FieldNode, type FunctionHandle, type ListNode, type PageActionHandle, type PageContent, type PageItem, type PageNode, type TextNode, type Tool, type ToolboxNode, } from './core/page/fns.js';
+export type { Email, Id, IsoDate, IsoDateTime, Phone, TimeOfDay, RowOf, TypedActionContext, TypedDb, TypedPageContext, TypedPageModule, TypedPageFns, FunctionHandles, ActionHandles, PageResult, TypedReadDb, } from './core/page/typed.js';
+export { render } from './core/case-orchestrator/render.js';
+export type { CaseActivity, CaseOrchestrator, CaseOrchestratorArgs, ContactActionView, RunTrigger, ScheduledActionView, } from './core/case-orchestrator/types.js';
+export type { CompanyResolve, Resolve } from './core/party/types.js';
+export { contactScheduleHours, everyDay, nextContactTime, withinContactHours, type ContactHours, type ContactHoursIgnore, type ContactHoursRange, type ContactHoursWeekday, } from './core/case-orchestrator/contact-hours.js';
+export { randomTimeBetween } from './core/case-orchestrator/time.js';
+export { contactTimezone } from './core/slot/contact-timezone.js';
+export type { OfficeHours } from './core/office-hours/index.js';
+export { PLATFORM_CONTACT_FIELDS, PLATFORM_SESSION_FIELDS } from './core/slot/platform-fields.js';
+export { lookupRef, parentRef } from './core/slot/id-ref.js';
+export type { CompanySchema, ContactSchedule, SessionSchema } from './core/slot/schema.js';
+export type { CellBinding, RowRef } from './core/slot/binding.js';
+export type { FieldValue } from './core/slot/types.js';
+export type { EnvApi } from './core/context/env.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,34 +1,31 @@
-export { ROW_ID_FIELD, idField, idFieldCore } from './core/slot/schema.js';
-export { integrationSurfaceKeys } from './core/context/types.js';
-export { idRef } from './core/slot/id-ref.js';
-export { CONTACT_PAGE_LIMIT_MAX, contactListInput, contactListOutput, contactMockService, contactSummary, contactSurface, } from './core/context/contact.js';
-export { dbDelInput, dbDelOutput, dbGetInput, dbGetOutput, dbMockService, dbSetInput, dbSetOutput, dbSurface, KV_KEY_MAX, KV_TTL_SECONDS_MAX, KV_VALUE_MAX, } from './core/context/db.js';
-export { bindEnvService, envMockService, readEnvGet } from './core/context/env.js';
-export { platformSurfaces } from './core/context/platform-registry.js';
-export { defaultHttpApi } from './core/context/http.js';
-export { hubspotAssociationListOutput, hubspotCreateContactInput, hubspotCreateContactOutput, hubspotCreateDealInput, hubspotCreateDealOutput, hubspotCreateNoteInput, hubspotCreateTaskInput, hubspotEngagementOutput, hubspotGetAssociatedContactsInput, hubspotGetAssociatedDealsInput, hubspotGetContactInput, hubspotGetContactOutput, hubspotGetCrmUrlInput, hubspotGetCrmUrlOutput, hubspotGetDealInput, hubspotGetDealOutput, hubspotGetOwnerInput, hubspotGetOwnerOutput, hubspotLogCallInput, hubspotLogEmailInput, hubspotLogSmsInput, hubspotMockService, hubspotSearchContactsInput, hubspotSearchContactsOutput, hubspotUpdateContactInput, hubspotUpdateContactOutput, hubspotUpdateDealInput, hubspotUpdateDealOutput, hubspotUpsertContactInput, hubspotUpsertContactOutput, } from './core/context/hubspot.js';
-export { docusignCreateEnvelopeFromTemplateInput, docusignCreateEnvelopeFromTemplateOutput, docusignCreateRecipientViewFromTemplateInput, docusignCreateRecipientViewFromTemplateOutput, docusignEnvelopeIdInput, docusignGetEnvelopeRecipientsOutput, docusignGetEnvelopeSigningStatusOutput, docusignGetEnvelopeStatusOutput, docusignListRecentEnvelopesInput, docusignListRecentEnvelopesOutput, docusignListTemplatesOutput, docusignMockService, docusignSearchEnvelopesByEmailInput, docusignSearchEnvelopesByEmailOutput, } from './core/context/docusign.js';
-export { filevineAddHashtagToProjectInput, filevineAddHashtagToProjectOutput, filevineCollectionItemInput, filevineCommentOutput, filevineCreateCommentInput, filevineCreateContactInput, filevineCreateContactOutput, filevineCreateNoteInput, filevineCreateNoteWithCommentInput, filevineCreateNoteWithCommentOutput, filevineCreateProjectCollectionItemInput, filevineCreateProjectCollectionItemOutput, filevineCreateProjectInput, filevineCreateProjectOutput, filevineDeleteProjectCollectionItemInput, filevineDeleteProjectCollectionItemOutput, filevineGetAssociatedProjectsInput, filevineGetAssociatedProjectsOutput, filevineGetContactInput, filevineGetContactOutput, filevineGetCrmUrlInput, filevineGetCrmUrlOutput, filevineGetProjectCollectionItemInput, filevineGetProjectCollectionItemOutput, filevineGetProjectCollectionItemsInput, filevineGetProjectCollectionItemsOutput, filevineGetProjectFoldersInput, filevineGetProjectFoldersOutput, filevineGetProjectInput, filevineGetProjectOutput, filevineLogCallInput, filevineLogEmailInput, filevineLogSmsInput, filevineMockService, filevineNoteOutput, filevineSearchContactsInput, filevineSearchContactsOutput, filevineUpdateContactInput, filevineUpdateContactOutput, filevineUpdateProjectCollectionItemInput, filevineUpdateProjectCollectionItemOutput, filevineUpdateProjectInput, filevineUpdateProjectOutput, filevineUploadDocumentInput, filevineUploadDocumentOutput, } from './core/context/filevine.js';
-export { twilioCreateCallInput, twilioCreateCallOutput, twilioIncomingNumber, twilioListIncomingNumbersOutput, twilioMockService, twilioSendSmsInput, twilioSendSmsOutput, } from './core/context/twilio.js';
-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, 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, 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';
-export { defineCaseContext, resolveCaseContextViewFn, } from './core/functions/define/case-context.js';
-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, 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';
+/**
+ * The company API: everything company code may import from `@superpanel-sdk/runtime`, and nothing else
+ * (09-runtime-compat §6). Company code runs in three places: the compile's Node, the Worker, and the
+ * page's QuickJS sandbox. So what is here behaves the same in all three: it imports no package and no
+ * Node module, and no module it reaches does work at load. The compile bundles it into each code string
+ * as it is; there is no stand-in.
+ *
+ * Named exports only, from the module that defines each: an `export *` lets whatever a module adds
+ * reach company code. `company-api.test.ts` holds the list and checks the entry stays pure. The
+ * platform imports `./platform` (`platform.ts`), which this package resolves only under the
+ * `superpanel-platform` condition.
+ */
+// Sequence declarations: `index.ts`, `variables.ts`.
+export { defineSequence, defineVariables, json, } from './core/sequence/define.js';
+// Functions, events, the webhook and schedules (`__gen` binds them to the company's tables).
+export { defineSchedules } from './core/functions/schedules.js';
+export { PlatformUnavailableError } from './core/functions/errors.js';
+// The page (the sequence's `__gen` binds them to its tables).
+export { choose, definePage, lastActionRun, tried, } from './core/page/define.js';
+// The page in functions (76): nodes, actions, page actions, tools (`__gen` binds the table-bound ones).
+export { announce, backgroundTransfer, block, button, cancelFollowUp, coldTransfer, convertTime, createRow, data, deleteRow, doNow, end, field, functionHandles, actionHandles, keypad, list, page, pressKeypad, refField, run, scheduleFollowUp, text, toolbox, voicemail, warmTransfer, } from './core/page/fns.js';
+// The Orchestrator.
+export { render } from './core/case-orchestrator/render.js';
+// When a contact may be reached, and in which time zone.
+export { contactScheduleHours, everyDay, nextContactTime, withinContactHours, } from './core/case-orchestrator/contact-hours.js';
+export { randomTimeBetween } from './core/case-orchestrator/time.js';
+export { contactTimezone } from './core/slot/contact-timezone.js';
+// The company schema: `schema/`.
+export { PLATFORM_CONTACT_FIELDS, PLATFORM_SESSION_FIELDS } from './core/slot/platform-fields.js';
+export { lookupRef, parentRef } from './core/slot/id-ref.js';
 //# sourceMappingURL=index.js.map

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+type LogLevel = 'INFO' | 'WARN' | 'ERROR';
+/** The least level the runtime's own lines are written at: `exec` keeps the RPC's routine lines out of a snippet's output. */
+export declare function setRuntimeLogLevel(level: LogLevel): void;
+export declare function getLogger(tags?: readonly string[]): {
+    log(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.js

@@ -0,0 +1,49 @@
+function formatArgument(value) {
+    if (value instanceof Error)
+        return value.stack ?? value.message;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value !== 'object' || value === null)
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+const RANK = { INFO: 0, WARN: 1, ERROR: 2 };
+let least = 'INFO';
+/** The least level the runtime's own lines are written at: `exec` keeps the RPC's routine lines out of a snippet's output. */
+export function setRuntimeLogLevel(level) {
+    least = level;
+}
+function write(level, tags, args) {
+    if (RANK[level] < RANK[least])
+        return;
+    const label = tags.length > 0 ? `[${tags.join(',')}] ` : '';
+    const line = `${new Date().toISOString()} ${level.padEnd(5)} ${label}${args.map(formatArgument).join(' ')}`;
+    if (level === 'ERROR')
+        console.error(line);
+    else if (level === 'WARN')
+        console.warn(line);
+    else
+        console.info(line);
+}
+export function getLogger(tags = []) {
+    return {
+        log(...args) {
+            write('INFO', tags, args);
+        },
+        info(...args) {
+            write('INFO', tags, args);
+        },
+        warn(...args) {
+            write('WARN', tags, args);
+        },
+        error(...args) {
+            write('ERROR', tags, args);
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map