@superpanel-sdk/runtime 0.2.3 → 0.5.0

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

@@ -1,9 +1,17 @@
-import { createTRPCClient, httpLink } from '@trpc/client';
+import { createTRPCClient, httpLink, retryLink } from '@trpc/client';
 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, RUNTIME_VERSION_HEADER, formatRuntimeVersion, } from './request-id.js';
+import { CASE_ORCHESTRATOR_TOOL_NAMES, } from '../../core/case-orchestrator/types.js';
+import { getLogger } from '../../logger.js';
+import { REQUEST_ID_HEADER, RUNTIME_VERSION_HEADER, formatRuntimeVersion } from './request-id.js';
+const logger = getLogger(['runtime', 'rpc']);
+/**
+ * A call the platform turned away before doing anything (its company over the rate, or no free slot:
+ * `TOO_MANY_REQUESTS`) is sent again after a growing pause, long enough together to outlast a rate window.
+ */
+const BUSY_RETRIES = 5;
+const busyDelayMs = (attempt) => Math.min(500 * 2 ** attempt, 5_000) + Math.floor(Math.random() * 250);
 function rpcLogger(c, getTags, waitUntil) {
     const emit = (level, message, extra) => {
         const pending = c.log.emit.mutate({ level, message, extra, tags: getTags?.() }).catch(() => { });
@@ -48,6 +56,13 @@ function stubSurface(c, meta) {
     if (meta.surfaceKey === 'envs') {
         return bindEnvService(stub);
     }
+    if (meta.surfaceKey === 'emails') {
+        return {
+            ...stub,
+            address: typeof meta.config.address === 'string' ? meta.config.address : meta.name,
+            provider: meta.config.provider === 'hotmail' ? 'hotmail' : 'gmail',
+        };
+    }
     return stub;
 }
 function buildSurfaces(c, metas) {
@@ -74,6 +89,56 @@ function buildPlatformApis(c) {
     // The registry is what guarantees the shape; TS cannot follow it through Object.fromEntries.
     return Object.fromEntries(surfaces);
 }
+/** Every Case Orchestrator tool routes through one procedure; the platform validates and executes it. */
+function buildCaseOrchestratorTools(c) {
+    const tools = CASE_ORCHESTRATOR_TOOL_NAMES.map((tool) => [
+        tool,
+        (input, callOptions) => rpcSafe(c.caseOrchestratorTools.invoke.mutate({ tool, input, callKey: callOptions.callKey })),
+    ]);
+    // The tool registry guarantees the shape; TS cannot follow it through Object.fromEntries.
+    return Object.fromEntries(tools);
+}
+/** A records answer: its value, or the error it was refused with (a write's with its code). */
+function unwrapRecords(result) {
+    if (result.ok)
+        return result.value;
+    const error = new Error(result.error.message);
+    error.code = result.error.code;
+    throw error;
+}
+/**
+ * `ctx.api.db` of every function and the Orchestrator (15 §10.15 task 4, §10.16): every table, as a
+ * page script and its actions see them, one request per call. Writes are numbered in the order this
+ * run makes them; for an Orchestrator Run the same request sent again (a retried request) carries the
+ * same key and is not made twice.
+ */
+function buildDbApi(c) {
+    let writes = 0;
+    const db = new Proxy({}, {
+        get(_, table) {
+            if (typeof table !== 'string')
+                return undefined;
+            const read = (method) => async (args) => unwrapRecords(await rpcSafe(c.records.read.mutate({ table, method, args: args ?? {} })));
+            const write = (method) => async (args) => {
+                writes += 1;
+                const callKey = `write:${writes}`;
+                return unwrapRecords(await rpcSafe(c.records.write.mutate({ table, method, args: args ?? {}, callKey })));
+            };
+            return {
+                $table: table,
+                findUnique: read('findUnique'),
+                findFirst: read('findFirst'),
+                findMany: read('findMany'),
+                count: read('count'),
+                create: write('create'),
+                update: write('update'),
+                upsert: write('upsert'),
+                delete: write('delete'),
+            };
+        },
+    });
+    return { db };
+}
 export function createRpcApiHost(options) {
     let client;
     let lastBaseUrl;
@@ -81,6 +146,10 @@ export function createRpcApiHost(options) {
         if (!client || lastBaseUrl !== baseUrl) {
             client = createTRPCClient({
                 links: [
+                    retryLink({
+                        retry: ({ error, attempts }) => error.data?.code === 'TOO_MANY_REQUESTS' && attempts <= BUSY_RETRIES,
+                        retryDelayMs: busyDelayMs,
+                    }),
                     httpLink({
                         url: baseUrl,
                         headers: async () => {
@@ -104,14 +173,26 @@ export function createRpcApiHost(options) {
         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}`);
+            logger.info('integration.listSurfaces start', { url: options.baseUrl });
+            const metas = await rpcSafe(c.integration.listSurfaces.query());
+            logger.info('integration.listSurfaces ok', { durationMs: Date.now() - started, count: metas.length });
+            return {
+                ...buildPlatformApis(c),
+                integration: buildSurfaces(c, metas),
+                log: rpcLogger(c, options.getTags, options.waitUntil),
+                ...buildDbApi(c),
+            };
+        },
+        async buildCaseOrchestratorApi(_run) {
+            const c = getClient(options.baseUrl);
+            // A function's api (25 §7), so a function called from the Orchestrator with its ctx works the same.
+            const metas = await rpcSafe(c.integration.listSurfaces.query());
             return {
                 ...buildPlatformApis(c),
                 integration: buildSurfaces(c, metas),
                 log: rpcLogger(c, options.getTags, options.waitUntil),
-                http: defaultHttpApi(),
+                tools: buildCaseOrchestratorTools(c),
+                ...buildDbApi(c),
             };
         },
     };

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

@@ -1,6 +1,6 @@
-import type { RunScope } from '../types.js';
+import type { RunClaims } from '../types.js';
 export type RpcContext = {
-    run: RunScope;
+    run: RunClaims;
     requestId?: string;
     runtimeVersion?: string;
 };

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

@@ -1,10 +1,14 @@
 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;
@@ -17,10 +21,10 @@ export declare function createAppRouter(modules: {
         errorShape: import("@trpc/server").TRPCDefaultErrorShape;
         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;
@@ -55,7 +59,7 @@ export declare function createAppRouter(modules: {
             input: {
                 surface: string;
                 method: string;
-                params?: Record<string, unknown> | undefined;
+                params?: unknown;
             };
             output: unknown;
             meta: object;
@@ -80,6 +84,48 @@ 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;
+        transformer: false;
+    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+        invoke: import("@trpc/server").TRPCMutationProcedure<{
+            input: {
+                tool: string;
+                input: unknown;
+                callKey: string;
+            };
+            output: unknown;
+            meta: object;
+        }>;
+    }>>;
+    records: import("@trpc/server").TRPCBuiltRouter<{
+        ctx: import("./trpc-init.js").RpcContext;
+        meta: object;
+        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+        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;
+                callKey: string;
+            };
+            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.agentRunId)
+        return null;
+    return run;
+}
+//# sourceMappingURL=run-scope.js.map

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

@@ -1,17 +1,50 @@
+import type { ORCHESTRATOR_ENTRY, CaseOrchestratorApi, CaseOrchestratorContext } from '../core/case-orchestrator/types.js';
 import type { 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'> & {
+    time: Omit<ActionContext['time'], 'format' | 'day'>;
+    meta: ActionContext['meta'];
+};
 /** 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']>;
 };
+/** `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): Promise<CaseOrchestratorApi>;
+};
+/** Run scope of an Orchestrator call: the instance it is limited to and its active run (`AgentRun`). */
+export type CaseOrchestratorRunScope = RunScope & {
+    entry: typeof ORCHESTRATOR_ENTRY;
+    instanceId: string;
+    agentRunId: 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,38 @@
-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 { defineCaseFunc } from './core/functions/define/case.js';
+export { defineNoCaseFunc } from './core/functions/define/no-case.js';
+export { bindDefines, type BoundDefines } from './core/functions/define/bind.js';
+export { defineEvents, defineWebhook } from './core/functions/define/events.js';
+export { defineSchedules, type Schedules } from './core/functions/schedules.js';
+export type { FunctionCtx } from './core/functions/types.js';
+export type { WebhookHandler } from './core/functions/events.js';
+export { choose, createRow, defineAction, definePage, deleteRow, end, field, refField, lastActionRun, perform, runFunction, schemaField, tried, type PageChannel, type PageFaqEntry, type PageRuns, } from './core/page/define.js';
+export type { Id, RowOf, TypedDb, TypedPageContext, TypedPageModule, TypedReadDb, } from './core/page/typed.js';
+export { followUps } from './core/case-orchestrator/follow-ups.js';
+export { render } from './core/case-orchestrator/render.js';
+export { tools } from './core/case-orchestrator/tools.js';
+export type { CaseActivity, CaseInput, CaseOrchestrator, CaseOrchestratorContacts, 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 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,34 @@
-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 (the sequence's `__gen` binds them to its tables).
+export { defineCaseFunc } from './core/functions/define/case.js';
+export { defineNoCaseFunc } from './core/functions/define/no-case.js';
+export { bindDefines } from './core/functions/define/bind.js';
+export { defineEvents, defineWebhook } from './core/functions/define/events.js';
+export { defineSchedules } from './core/functions/schedules.js';
+// The page (the sequence's `__gen` binds them to its tables).
+export { choose, createRow, defineAction, definePage, deleteRow, end, field, refField, lastActionRun, perform, runFunction, schemaField, tried, } from './core/page/define.js';
+// The Orchestrator.
+export { followUps } from './core/case-orchestrator/follow-ups.js';
+export { render } from './core/case-orchestrator/render.js';
+export { tools } from './core/case-orchestrator/tools.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,7 @@
+export declare function getLogger(tags?: readonly string[]): {
+    log(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.js

@@ -0,0 +1,41 @@
+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]';
+    }
+}
+function write(level, tags, args) {
+    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