@superpanel-sdk/runtime 0.5.0 → 0.7.0

package/dist/core/party/schema.d.ts

@@ -35,8 +35,37 @@ export declare const sipArrival: z.ZodObject<{
 }, z.core.$strip>;
 export type SipArrival = z.infer<typeof sipArrival>;
 /**
- * `ctx.params` of the company `resolve` (§18.2): an inbound conversation, before its sequence is known.
- * `to.name` is our number's or mailbox's name in the environment (22 §7), the same in test and prod.
+ * What both resolves get (14-sequence-instance §18): the conversation as it arrives, no facts looked
+ * up. They look up what they need (`ctx.api.contact.find`, `ctx.api.instances.findForContact`,
+ * `ctx.api.exchanges`).
+ */
+/** A text of the batch the resolve decides for (64 §9), as the page gets it (`ctx.sms.inbound`), with the provider's id. */
+export declare const arrivalSmsMessage: z.ZodObject<{
+    id: z.ZodString;
+    body: z.ZodString;
+    at: z.ZodString;
+    externalId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ArrivalSmsMessage = z.infer<typeof arrivalSmsMessage>;
+/** An email of the batch the resolve decides for (64 §9), as the page gets it (`ctx.email.inbound`), with the provider's id. */
+export declare const arrivalEmailMessage: z.ZodObject<{
+    id: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodArray<z.ZodString>;
+    cc: z.ZodArray<z.ZodString>;
+    subject: z.ZodNullable<z.ZodString>;
+    body: z.ZodString;
+    at: z.ZodString;
+    attachments: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        contentType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    externalId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ArrivalEmailMessage = z.infer<typeof arrivalEmailMessage>;
+/**
+ * What the company `resolve` is called with (§18.2, its `args`): an inbound conversation, before its sequence is known.
+ * `to.name` is our number's, SIP address's or mailbox's name in the environment (22 §7), the same in test and prod.
  */
 export declare const companyResolveInput: z.ZodObject<{
     channel: z.ZodEnum<{
@@ -59,10 +88,31 @@ export declare const companyResolveInput: z.ZodObject<{
         domain: z.ZodNullable<z.ZodString>;
         headers: z.ZodRecord<z.ZodString, z.ZodString>;
     }, z.core.$strip>>;
+    externalId: z.ZodNullable<z.ZodString>;
+    messages: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        body: z.ZodString;
+        at: z.ZodString;
+        externalId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodArray<z.ZodString>;
+        cc: z.ZodArray<z.ZodString>;
+        subject: z.ZodNullable<z.ZodString>;
+        body: z.ZodString;
+        at: z.ZodString;
+        attachments: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            contentType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        externalId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>]>>;
     to: z.ZodObject<{
         kind: z.ZodEnum<{
             email: "email";
             phone: "phone";
+            sip: "sip";
         }>;
         value: z.ZodString;
         name: z.ZodNullable<z.ZodString>;
@@ -82,7 +132,7 @@ export declare const companyResolveResult: z.ZodUnion<readonly [z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>]>;
 export type CompanyResolveResult = z.infer<typeof companyResolveResult>;
-/** `ctx.params` of a sequence's `resolve` (§18.3): the conversation, on this sequence. */
+/** What a sequence's `resolve` is called with (§18.3, its `args`): the conversation, on this sequence. */
 export declare const resolveInput: z.ZodObject<{
     channel: z.ZodEnum<{
         call: "call";
@@ -101,6 +151,7 @@ export declare const resolveInput: z.ZodObject<{
         kind: z.ZodEnum<{
             email: "email";
             phone: "phone";
+            sip: "sip";
         }>;
         value: z.ZodString;
     }, z.core.$strip>;
@@ -111,6 +162,26 @@ export declare const resolveInput: z.ZodObject<{
         domain: z.ZodNullable<z.ZodString>;
         headers: z.ZodRecord<z.ZodString, z.ZodString>;
     }, z.core.$strip>>;
+    externalId: z.ZodNullable<z.ZodString>;
+    messages: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        body: z.ZodString;
+        at: z.ZodString;
+        externalId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodArray<z.ZodString>;
+        cc: z.ZodArray<z.ZodString>;
+        subject: z.ZodNullable<z.ZodString>;
+        body: z.ZodString;
+        at: z.ZodString;
+        attachments: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            contentType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        externalId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>]>>;
     direction: z.ZodEnum<{
         inbound: "inbound";
         outbound: "outbound";

package/dist/core/party/schema.js

@@ -29,23 +29,56 @@ export const sipArrival = z.object({
  * up. They look up what they need (`ctx.api.contact.find`, `ctx.api.instances.findForContact`,
  * `ctx.api.exchanges`).
  */
+/** A text of the batch the resolve decides for (64 §9), as the page gets it (`ctx.sms.inbound`), with the provider's id. */
+export const arrivalSmsMessage = z.object({
+    id: z.string(),
+    body: z.string(),
+    at: z.string(),
+    /** The provider's id of the text (Twilio's MessageSid). */
+    externalId: z.string().nullable(),
+});
+/** An email of the batch the resolve decides for (64 §9), as the page gets it (`ctx.email.inbound`), with the provider's id. */
+export const arrivalEmailMessage = z.object({
+    id: z.string(),
+    from: z.string(),
+    to: z.array(z.string()),
+    cc: z.array(z.string()),
+    subject: z.string().nullable(),
+    /** Quoted history and signature taken out. */
+    body: z.string(),
+    at: z.string(),
+    /** Listed only: their contents are not read here. */
+    attachments: z.array(z.object({ name: z.string(), contentType: z.string().optional() })),
+    /** The provider's id of the email. */
+    externalId: z.string().nullable(),
+});
 const conversationArrival = z.object({
     channel: z.enum(['call', 'sms', 'email']),
     /** The other side: the caller or sender on inbound, the one called on outbound. Normalized. */
     from: arrivalAddress,
-    /** Our side: the number or mailbox the conversation came in on (inbound) or goes out from. */
-    to: partyAddress,
+    /**
+     * Our side: the number or mailbox the conversation came in on (inbound) or goes out from; on a call
+     * through our SIP Domain to one of our SIP addresses, the SIP URI it dialed (`sip:sales@acme.sip.twilio.com`).
+     */
+    to: arrivalAddress,
     /** Email: the provider thread id, when the message belongs to one. */
     threadId: z.string().nullable(),
     /** A call through our SIP Domain; absent on any other conversation. */
     sip: sipArrival.optional(),
+    /** A call: the provider's id of the call (Twilio's CallSid, 62), what a record written here can name it by. Null on a text or an email. */
+    externalId: z.string().nullable(),
+    /**
+     * Texts and emails: the batch this resolve decides for (64 §9), oldest first; each carries its own
+     * `externalId`. Absent on a call, which has said nothing yet, and on an outbound conversation.
+     */
+    messages: z.union([z.array(arrivalSmsMessage), z.array(arrivalEmailMessage)]).optional(),
 });
 /**
- * `ctx.params` of the company `resolve` (§18.2): an inbound conversation, before its sequence is known.
- * `to.name` is our number's or mailbox's name in the environment (22 §7), the same in test and prod.
+ * What the company `resolve` is called with (§18.2, its `args`): an inbound conversation, before its sequence is known.
+ * `to.name` is our number's, SIP address's or mailbox's name in the environment (22 §7), the same in test and prod.
  */
 export const companyResolveInput = conversationArrival.extend({
-    to: partyAddress.extend({ name: z.string().nullable() }),
+    to: arrivalAddress.extend({ name: z.string().nullable() }),
 });
 /**
  * What the company `resolve` returns: the sequence (its name) the conversation goes to, or `decline`
@@ -56,7 +89,7 @@ export const companyResolveResult = z.union([
     z.strictObject({ sequence: z.string().min(1) }),
     z.strictObject({ decline: z.strictObject({ reply: z.string().min(1).optional() }) }),
 ]);
-/** `ctx.params` of a sequence's `resolve` (§18.3): the conversation, on this sequence. */
+/** What a sequence's `resolve` is called with (§18.3, its `args`): the conversation, on this sequence. */
 export const resolveInput = conversationArrival.extend({
     direction: z.enum(['inbound', 'outbound']),
     /** This sequence (its name): the only one whose instances `resolve` may return or start. */

package/dist/core/party/types.d.ts

@@ -1,4 +1,4 @@
-import type { FunctionCtx, NoCaseFn } from '../functions/types.js';
+import type { Ctx } from '../functions/types.js';
 import type { PageTablesDesc } from '../page/typed.js';
 import type { CompanyResolveInput, CompanyResolveResult, ResolveInput, ResolveResult } from './schema.js';
 /**
@@ -16,25 +16,20 @@ export declare const COMPANY_RESOLVE_FUNCTION = "companyResolve";
 /** `ctx.meta.entry` / RunScope entry of a company `resolve` call. */
 export declare const COMPANY_RESOLVE_ENTRY = "companyResolve";
 /**
- * The company `resolve.ts` (§18.2): `export const resolve: CompanyResolve = async (ctx) => …`. Runs for
+ * The company `resolve.ts` (§18.2): `export const resolve: CompanyResolve = async (ctx, conversation) => …`. Runs for
  * inbound calls, texts and emails only, before the sequence is known: returns `{ sequence }` (a name)
  * or `{ decline: { reply? } }`. It reads with `ctx.api` like any function; the repository root's
  * `__gen/` binds `D` to the company's tables, so `ctx.api.db` is typed.
  */
-export type CompanyResolve<D extends PageTablesDesc | undefined = undefined> = NoCaseFn<CompanyResolveInput, CompanyResolveResult, D>;
+export type CompanyResolve<D extends PageTablesDesc | undefined = undefined> = (ctx: Ctx<D>, conversation: CompanyResolveInput) => Promise<CompanyResolveResult>;
 /**
- * `ctx` of a sequence's `resolve`: the usual function ctx (it finds and creates through
- * `ctx.api.contact`, reads and writes records through `ctx.api.db`, finds instances through
- * `ctx.api.instances` and exchanges through `ctx.api.exchanges`) with the conversation as `params`.
- * `meta.instanceId` is null.
- */
-export type ResolveContext<D extends PageTablesDesc | undefined = undefined> = FunctionCtx<ResolveInput, D>;
-/**
- * `sequences/<id>/resolve.ts`: `export const resolve: Resolve = async (ctx) => …`, with `Resolve`
- * imported from the sequence's `__gen`. A `noCase` function: the conversation in, `{ contactId,
+ * `sequences/<id>/resolve.ts`: `export const resolve: Resolve = async (ctx, conversation) => …`, with
+ * `Resolve` imported from the sequence's `__gen`. It finds and creates through `ctx.api.contact`, reads
+ * and writes records through `ctx.api.db`, finds instances through `ctx.api.instances` and exchanges
+ * through `ctx.api.exchanges`. The conversation in, `{ contactId,
  * instanceId }` or `{ contactId, start }` out, on this sequence only. The platform gives it what is
  * left of the time limit, checks the ids (an active instance of this sequence, a contact, a row of
  * its subject table, all of this company and environment), and fails the conversation when not.
  */
-export type Resolve<D extends PageTablesDesc | undefined = undefined> = NoCaseFn<ResolveInput, ResolveResult, D>;
+export type Resolve<D extends PageTablesDesc | undefined = undefined> = (ctx: Ctx<D>, conversation: ResolveInput) => Promise<ResolveResult>;
 //# sourceMappingURL=types.d.ts.map

package/dist/core/sequence/define.d.ts

@@ -4,10 +4,9 @@
  */
 /** `sequences/<id>/index.ts` default export. */
 export type SequenceDefinition<S extends string = string> = {
+    /** `label`: the name people see; without it, the directory name, which is the sequence's name. */
     meta?: {
-        name?: string;
         label?: string;
-        description?: string;
     };
     /** The company table each run is about: one row of it is the instance's business root. */
     subject: S;

package/dist/core/slot/company-metadata.d.ts

@@ -1,4 +1,4 @@
-import type { CompanyFieldDef, CompanySchema, CompiledCompanyMetadata, SessionSchema, TableRef } from './schema.js';
+import type { CompanyFieldDef, CompanySchema, SessionSchema, TableRef } from './schema.js';
 import type { ValidationIssue, ValidationResult } from './types.js';
 export { PLATFORM_CONTACT_FIELDS, PLATFORM_SESSION_FIELDS } from './platform-fields.js';
 /** The one table every company has: the only thing the platform contacts (14-sequence-instance §5). */
@@ -10,12 +10,6 @@ export declare const CONTACT_OPT_OUT_FIELDS: readonly ['opted_out', 'call_opted_
 export declare const LIMITS: {
     /** Longest parent chain: a table's parent's parent … at most this many hops to a table without one. */
     readonly parentDepth: 5;
-    /** Rows one load step (one table) may read. */
-    readonly loadRowsPerStep: 500;
-    /** `follow` hops chained in one load expression. */
-    readonly followDepth: 3;
-    /** A load's time budget, ms. */
-    readonly loadTimeoutMs: 2000;
     /** An instance's `variables`, serialized, bytes. */
     readonly variablesBytes: number;
     /** Company tables per company and environment (18-record-search-index §4.7). */
@@ -26,9 +20,12 @@ export declare const LIMITS: {
     readonly options: 200;
     /** Characters of one option: a short code, not a sentence (its meaning goes in `extraction`). */
     readonly optionChars: 60;
-    /** A `string` value, characters. */
-    readonly stringChars: 255;
-    /** A `text` value, UTF-8 bytes. */
+    /**
+     * A `string` value, UTF-8 bytes, as written and lower-cased: its index entries keep it whole, and a
+     * B-tree entry holds at most 2688 bytes of it; the rest is room for the entry's other columns (34 §2).
+     */
+    readonly stringBytes: 2500;
+    /** A `text` value, UTF-8 bytes: the storage's bound, not a business one (34 §2). */
     readonly textBytes: number;
     /** One row's stored data, serialized, UTF-8 bytes. */
     readonly rowDataBytes: number;
@@ -76,25 +73,17 @@ export declare function parentOf(table: FieldsOf | undefined): {
  * in its data.
  */
 export declare function isParentField(table: FieldsOf | undefined, fieldName: string): boolean;
-export type CompileCompanyMetadataResult = {
-    metadata: CompiledCompanyMetadata | null;
-    validation: ValidationResult;
-};
-/**
- * The company schema as authored, without the reserved names (as `compileSlotSchema` leaves them
- * out). It is plain data.
- */
-export declare function compileCompanySchema(company: CompanySchema): CompanySchema;
 /**
  * Why `schema/session.ts` is not a session schema (11-remove-sequence-schema §3.1): its fields are
  * simple values, with no `ref` (the session is related to no other table).
  */
 export declare function sessionSchemaIssues(session: SessionSchema): ValidationIssue[];
 /**
- * The company's metadata: its tables (`schema/index.ts`) and its session fields (`schema/session.ts`,
- * none when the file is missing). `session` is reserved: no company table has the name.
+ * Whether the company schema is one: its tables (`schema/index.ts`) and its session fields
+ * (`schema/session.ts`, the platform's only when the file is missing). `session` is reserved: no
+ * company table has the name. What a build stores is `compileSlotSchema`'s output.
  */
-export declare function compileCompanyMetadata(company: CompanySchema, session?: SessionSchema): CompileCompanyMetadataResult;
+export declare function validateCompanySchema(company: CompanySchema, session?: SessionSchema): ValidationResult;
 /** The issue for a field that still names its `source` (19-page-writable-cells). */
 export declare function sourceRemovedIssue(path: string, prefix?: string): ValidationIssue;
 /** The issue for a field that still names `nullable`, which no write checked. */

package/dist/core/slot/company-metadata.js

@@ -13,12 +13,6 @@ export const CONTACT_OPT_OUT_FIELDS = ['opted_out', 'call_opted_out', 'sms_opted
 export const LIMITS = {
     /** Longest parent chain: a table's parent's parent … at most this many hops to a table without one. */
     parentDepth: 5,
-    /** Rows one load step (one table) may read. */
-    loadRowsPerStep: 500,
-    /** `follow` hops chained in one load expression. */
-    followDepth: 3,
-    /** A load's time budget, ms. */
-    loadTimeoutMs: 2000,
     /** An instance's `variables`, serialized, bytes. */
     variablesBytes: 64 * 1024,
     /** Company tables per company and environment (18-record-search-index §4.7). */
@@ -29,9 +23,12 @@ export const LIMITS = {
     options: 200,
     /** Characters of one option: a short code, not a sentence (its meaning goes in `extraction`). */
     optionChars: 60,
-    /** A `string` value, characters. */
-    stringChars: 255,
-    /** A `text` value, UTF-8 bytes. */
+    /**
+     * A `string` value, UTF-8 bytes, as written and lower-cased: its index entries keep it whole, and a
+     * B-tree entry holds at most 2688 bytes of it; the rest is room for the entry's other columns (34 §2).
+     */
+    stringBytes: 2500,
+    /** A `text` value, UTF-8 bytes: the storage's bound, not a business one (34 §2). */
     textBytes: 64 * 1024,
     /** One row's stored data, serialized, UTF-8 bytes. */
     rowDataBytes: 256 * 1024,
@@ -82,30 +79,6 @@ export function parentOf(table) {
 export function isParentField(table, fieldName) {
     return parentOf(table)?.field === fieldName;
 }
-/** A field as stored: a copy of it. */
-function storedField(field) {
-    return structuredClone(field);
-}
-/**
- * The company schema as authored, without the reserved names (as `compileSlotSchema` leaves them
- * out). It is plain data.
- */
-export function compileCompanySchema(company) {
-    const compiled = {};
-    for (const [tableName, table] of Object.entries(company)) {
-        if (tableName === SESSION_TABLE || isReservedTableName(tableName))
-            continue;
-        compiled[tableName] = {
-            ...structuredClone(table),
-            fields: Object.fromEntries(Object.entries(table.fields).map(([name, field]) => [name, storedField(field)])),
-        };
-    }
-    return compiled;
-}
-/** The session schema as stored. */
-function compileSessionSchema(session) {
-    return { fields: Object.fromEntries(Object.entries(session.fields).map(([name, field]) => [name, storedField(field)])) };
-}
 /**
  * Why `schema/session.ts` is not a session schema (11-remove-sequence-schema §3.1): its fields are
  * simple values, with no `ref` (the session is related to no other table).
@@ -242,10 +215,11 @@ function schemaNameIssues(company, session) {
     return issues;
 }
 /**
- * The company's metadata: its tables (`schema/index.ts`) and its session fields (`schema/session.ts`,
- * none when the file is missing). `session` is reserved: no company table has the name.
+ * Whether the company schema is one: its tables (`schema/index.ts`) and its session fields
+ * (`schema/session.ts`, the platform's only when the file is missing). `session` is reserved: no
+ * company table has the name. What a build stores is `compileSlotSchema`'s output.
  */
-export function compileCompanyMetadata(company, session = PLATFORM_SESSION_SCHEMA) {
+export function validateCompanySchema(company, session = PLATFORM_SESSION_SCHEMA) {
     const issues = [];
     if (Object.hasOwn(company, SESSION_TABLE)) {
         issues.push({
@@ -267,14 +241,13 @@ export function compileCompanyMetadata(company, session = PLATFORM_SESSION_SCHEM
             message: 'the company schema must define the contact table (spread PLATFORM_CONTACT_FIELDS into it)',
             path: CONTACT_TABLE,
         });
-        return { metadata: null, validation: { ok: false, issues } };
+        return { ok: false, issues };
     }
     validatePlatformFields(company, CONTACT_TABLE, issues);
     validatePlatformSessionFields(session, issues);
     validateRelationships(company, issues);
     issues.push(...fieldRuleIssues(company));
-    const metadata = issues.length === 0 ? { tables: compileCompanySchema(company), session: compileSessionSchema(session) } : null;
-    return { metadata, validation: issues.length === 0 ? { ok: true } : { ok: false, issues } };
+    return issues.length === 0 ? { ok: true } : { ok: false, issues };
 }
 /**
  * Relationship rules (14-sequence-instance §16.1): a table has at most one parent, a required system

package/dist/core/slot/compile-schema.js

@@ -1,6 +1,6 @@
 import { idFieldCore, ROW_ID_FIELD } from './schema.js';
 import { isReservedTableName } from './row.js';
-import { compileCompanyMetadata, PLATFORM_SESSION_SCHEMA, SESSION_TABLE } from './company-metadata.js';
+import { PLATFORM_SESSION_SCHEMA, SESSION_TABLE, validateCompanySchema } from './company-metadata.js';
 import { formatFieldPath, parseFieldPath } from './path.js';
 function toRuntimeField(field) {
     return {
@@ -49,15 +49,15 @@ function validateCompanyRefs(company, issues) {
 export function compileSlotSchema(company, options = {}) {
     const issues = [];
     const session = options.session ?? PLATFORM_SESSION_SCHEMA;
-    const companyCheck = compileCompanyMetadata(company, session);
-    if (!companyCheck.validation.ok)
-        issues.push(...companyCheck.validation.issues);
+    const companyCheck = validateCompanySchema(company, session);
+    if (!companyCheck.ok)
+        issues.push(...companyCheck.issues);
     const tables = {};
     for (const [tableName, companyTable] of Object.entries(company)) {
-        // Reserved table names are the company schema's to report (compileCompanyMetadata).
+        // Reserved table names are the company schema's to report (validateCompanySchema).
         if (tableName === SESSION_TABLE || isReservedTableName(tableName))
             continue;
-        // The row id is the platform's: a schema that writes one is refused (compileCompanyMetadata).
+        // The row id is the platform's: a schema that writes one is refused (validateCompanySchema).
         const fields = { [ROW_ID_FIELD]: { ...ROW_ID } };
         for (const [fieldName, field] of Object.entries(companyTable.fields)) {
             if (fieldName !== ROW_ID_FIELD)

package/dist/core/slot/field.d.ts

@@ -1,5 +1,5 @@
 import type { FieldState } from '../context/types.js';
-import type { FieldHistoryEntry, FieldValue, SlotValue, UpdatedBy } from './types.js';
+import type { FieldValue, SlotValue, UpdatedBy } from './types.js';
 /** Stage done checks use resolved, not "has a value". */
 export declare function isResolved(field: FieldValue | null | undefined): boolean;
 export declare function emptyFieldValue(now?: number): FieldValue;
@@ -9,6 +9,5 @@ export declare function makeFieldValue(partial: {
     reason?: string | null;
     updatedBy?: UpdatedBy;
     updatedAt?: number;
-    history?: FieldHistoryEntry[];
 }): FieldValue;
 //# sourceMappingURL=field.d.ts.map

package/dist/core/slot/field.js

@@ -12,7 +12,6 @@ export function emptyFieldValue(now = 0) {
         state: 'empty',
         updatedAt: now,
         updatedBy: 'platform',
-        history: [],
     };
 }
 export function makeFieldValue(partial) {
@@ -22,7 +21,6 @@ export function makeFieldValue(partial) {
         state: partial.state,
         updatedAt: partial.updatedAt ?? 0,
         updatedBy: partial.updatedBy ?? 'platform',
-        history: partial.history ?? [],
     };
 }
 //# sourceMappingURL=field.js.map

package/dist/core/slot/index.d.ts

@@ -1,11 +1,11 @@
-export { ROW_ID_FIELD, ROW_SYSTEM_KEYS, ROW_TIME_KEYS, isRowTimeKey, type RowSystemKey, type RowTimeKey, idFieldCore, normalFieldCoreSchema, companyNormalFieldDefSchema, compiledCompanyMetadataSchema, companyFieldDefSchema, companyTableDefSchema, companySchemaSchema, contactScheduleValueSchema, localTimeRangeSchema, isCompanySchema, } from './schema.js';
-export { CONTACT_OPT_OUT_FIELDS, CONTACT_TABLE, LIMITS, PLATFORM_CONTACT_FIELDS, POLICY_IDS, SESSION_TABLE, compileCompanyMetadata, isCustomTable, isParentField, isRecordTable, parentOf, subjectTableIssues, compileCompanySchema, type CompileCompanyMetadataResult, type ResponsePolicyId, type SlotFillingPolicyId, type VoiceProfileId, } from './company-metadata.js';
+export { ROW_ID_FIELD, ROW_SYSTEM_KEYS, ROW_TIME_KEYS, isRowTimeKey, type RowSystemKey, type RowTimeKey, idFieldCore, normalFieldCoreSchema, companyNormalFieldDefSchema, companyFieldDefSchema, companyTableDefSchema, companySchemaSchema, contactScheduleValueSchema, localTimeRangeSchema, isCompanySchema, } from './schema.js';
+export { CONTACT_OPT_OUT_FIELDS, CONTACT_TABLE, LIMITS, PLATFORM_CONTACT_FIELDS, POLICY_IDS, SESSION_TABLE, validateCompanySchema, isCustomTable, isParentField, isRecordTable, parentOf, subjectTableIssues, type ResponsePolicyId, type SlotFillingPolicyId, type VoiceProfileId, } from './company-metadata.js';
 export { lookupRef, parentRef } from './id-ref.js';
 export { isFieldValue, isReservedTableName, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, slotFieldEntries, slotFieldNames, type SlotRow, } from './row.js';
 export { parseFieldPath, requireFieldPath, formatFieldPath, type FieldPath, type ParsedFieldPath } from './path.js';
 export { isResolved, emptyFieldValue, makeFieldValue, } from './field.js';
 export { compileSlotSchema, compiledTableEntries, getCompiledTable, getTableField, relationsOf, type TableRelation, validateFieldRefs, companyFieldToRuntime, } from './compile-schema.js';
-export { companyMetadataCompatibilityIssues } from './schema-compat.js';
+export { companySchemaCompatibilityIssues } from './schema-compat.js';
 export { DATE_VALUE_FORMAT, DATE_VALUE_PATTERN, DATETIME_VALUE_FORMAT, DATETIME_VALUE_PATTERN, isValidDataTypeValue, validateBareValue, } from './value.js';
 export { refKind, refValueIssues, type RefKind } from './ref.js';
 export type { ComputeFnMap, ComputeHost, ComputeHostOrFns } from '../../compute-host/compute-host.js';

package/dist/core/slot/index.js

@@ -1,11 +1,11 @@
-export { ROW_ID_FIELD, ROW_SYSTEM_KEYS, ROW_TIME_KEYS, isRowTimeKey, idFieldCore, normalFieldCoreSchema, companyNormalFieldDefSchema, compiledCompanyMetadataSchema, companyFieldDefSchema, companyTableDefSchema, companySchemaSchema, contactScheduleValueSchema, localTimeRangeSchema, isCompanySchema, } from './schema.js';
-export { CONTACT_OPT_OUT_FIELDS, CONTACT_TABLE, LIMITS, PLATFORM_CONTACT_FIELDS, POLICY_IDS, SESSION_TABLE, compileCompanyMetadata, isCustomTable, isParentField, isRecordTable, parentOf, subjectTableIssues, compileCompanySchema, } from './company-metadata.js';
+export { ROW_ID_FIELD, ROW_SYSTEM_KEYS, ROW_TIME_KEYS, isRowTimeKey, idFieldCore, normalFieldCoreSchema, companyNormalFieldDefSchema, companyFieldDefSchema, companyTableDefSchema, companySchemaSchema, contactScheduleValueSchema, localTimeRangeSchema, isCompanySchema, } from './schema.js';
+export { CONTACT_OPT_OUT_FIELDS, CONTACT_TABLE, LIMITS, PLATFORM_CONTACT_FIELDS, POLICY_IDS, SESSION_TABLE, validateCompanySchema, isCustomTable, isParentField, isRecordTable, parentOf, subjectTableIssues, } from './company-metadata.js';
 export { lookupRef, parentRef } from './id-ref.js';
 export { isFieldValue, isReservedTableName, isRowIdField, mintRowId, SNAPSHOT_CURRENT_KEY, slotFieldEntries, slotFieldNames, } from './row.js';
 export { parseFieldPath, requireFieldPath, formatFieldPath } from './path.js';
 export { isResolved, emptyFieldValue, makeFieldValue, } from './field.js';
 export { compileSlotSchema, compiledTableEntries, getCompiledTable, getTableField, relationsOf, validateFieldRefs, companyFieldToRuntime, } from './compile-schema.js';
-export { companyMetadataCompatibilityIssues } from './schema-compat.js';
+export { companySchemaCompatibilityIssues } from './schema-compat.js';
 export { DATE_VALUE_FORMAT, DATE_VALUE_PATTERN, DATETIME_VALUE_FORMAT, DATETIME_VALUE_PATTERN, isValidDataTypeValue, validateBareValue, } from './value.js';
 export { refKind, refValueIssues } from './ref.js';
 export { createLocalComputeHost, resolveComputeHost } from '../../compute-host/compute-host.js';

package/dist/core/slot/naming.d.ts

@@ -1,7 +1,7 @@
 /**
  * Naming rules for the company schema (13-data-model-v1 §23.4 item 6): table names, field names
  * (session fields included) and relation names. A name ends up as a path segment (`table.field`,
- * `injury#1.severity`), an object key at runtime and a property in generated TypeScript, so it is
+ * `injury:3f9a2c1d7e04.severity`), an object key at runtime and a property in generated TypeScript, so it is
  * kept to what is safe in all three.
  */
 /** Postgres's identifier limit: a field can become a real column without a rename. */

package/dist/core/slot/naming.js

@@ -1,7 +1,7 @@
 /**
  * Naming rules for the company schema (13-data-model-v1 §23.4 item 6): table names, field names
  * (session fields included) and relation names. A name ends up as a path segment (`table.field`,
- * `injury#1.severity`), an object key at runtime and a property in generated TypeScript, so it is
+ * `injury:3f9a2c1d7e04.severity`), an object key at runtime and a property in generated TypeScript, so it is
  * kept to what is safe in all three.
  */
 /** Lowercase letters, digits and `_`, starting with a letter: never `.`, `-`, `#`, `*`, `$` or a space. */

package/dist/core/slot/platform-fields.d.ts

@@ -65,8 +65,8 @@ export declare const PLATFORM_CONTACT_FIELDS: {
     readonly language: {
         readonly label: 'Language';
         readonly dataType: 'select';
-        readonly extraction: 'The language they speak with us, when they speak or ask for one of these; the platform then speaks it.';
-        readonly options: ["english", "spanish"];
+        readonly extraction: 'The language they want us to use with them, one of these (BCP-47): when they ask for one. The platform also sets it once they clearly speak or write one of them with us.';
+        readonly options: ["en", "fr", "de", "es", "pt", "zh", "ja", "hi", "it", "ko", "nl", "pl", "ru", "sv", "tr", "tl", "bg", "ro", "ar", "cs", "el", "fi", "hr", "ms", "sk", "da", "ta", "uk", "hu", "no", "vi", "bn", "th", "he", "ka", "id", "te", "gu", "kn", "ml", "mr", "pa"];
     };
     readonly opted_out: {
         readonly label: 'Opted out';
@@ -106,8 +106,8 @@ export declare const PLATFORM_CONTACT_FIELDS: {
 };
 /**
  * The session's platform fields (24 §5.2): `schema/session.ts` spreads them into its fields, checked
- * like the contact's. `stuck`: the AI marked the call stuck (its `stuck` action); the page reads it,
- * decides what to do, and clears it.
+ * like the contact's. `language`: the language the call is in (48 §3). `stuck`: the AI marked the call
+ * stuck (its `stuck` action); the page reads it, decides what to do, and clears it.
  */
 export declare const PLATFORM_SESSION_FIELDS: {
     readonly stuck: {

package/dist/core/slot/platform-fields.js

@@ -1,4 +1,4 @@
-import { SPOKEN_LANGUAGES } from '../conversation/index.js';
+import { CONTACT_LANGUAGES } from '../conversation/index.js';
 import { STATE_CODES } from './contact-timezone.js';
 /**
  * The contact table's platform fields. The company schema spreads them into `contact` and the runtime
@@ -67,8 +67,8 @@ export const PLATFORM_CONTACT_FIELDS = {
     language: {
         label: 'Language',
         dataType: 'select',
-        extraction: 'The language they speak with us, when they speak or ask for one of these; the platform then speaks it.',
-        options: [...SPOKEN_LANGUAGES],
+        extraction: 'The language they want us to use with them, one of these (BCP-47): when they ask for one. The platform also sets it once they clearly speak or write one of them with us.',
+        options: [...CONTACT_LANGUAGES],
     },
     opted_out: {
         label: 'Opted out',
@@ -108,8 +108,8 @@ export const PLATFORM_CONTACT_FIELDS = {
 };
 /**
  * The session's platform fields (24 §5.2): `schema/session.ts` spreads them into its fields, checked
- * like the contact's. `stuck`: the AI marked the call stuck (its `stuck` action); the page reads it,
- * decides what to do, and clears it.
+ * like the contact's. `language`: the language the call is in (48 §3). `stuck`: the AI marked the call
+ * stuck (its `stuck` action); the page reads it, decides what to do, and clears it.
  */
 export const PLATFORM_SESSION_FIELDS = {
     stuck: {

package/dist/core/slot/schema-compat.d.ts

@@ -1,16 +1,17 @@
-import type { CompiledCompanyMetadata } from './schema.js';
+import type { CompiledSlotSchema } from './types.js';
 /**
  * Why `after`'s company schema cannot replace `before`'s without breaking slot data stored under
- * it; empty for an additive (01-slot-db §2.3) evolution. One pass covers the whole repo: sequence
- * overlays only change usage. The session fields (`schema/session.ts`) follow the same rules, since
- * `Session.data` keeps their values (11-remove-sequence-schema §3.1).
+ * it; empty for an additive (01-slot-db §2.3) evolution. Both are a build's compiled schema
+ * (`CompanyPart.schema`): one for the whole repo, sequences have none of their own. The session
+ * table (`schema/session.ts`) follows the same rules, since `Session.data` keeps its values
+ * (11-remove-sequence-schema §3.1); a session field has no ref, so the ref rules never apply to it.
  *
  * Compatible: new tables (with their parent), fields (lookups included), more options, a widened
- * type (`string` → `text`, `select` / `time` → `string`), and presentation changes (label,
+ * type (`select` / `time` → `string`), and presentation changes (label,
  * description, extraction, deprecated); a new field may be `unique`. Incompatible: removing a table or
- * field (mark it `deprecated` instead); any other change of a field's dataType, `unique` added to or
+ * field (mark it `deprecated` instead); any other change of a field's dataType (to `text` included), `unique` added to or
  * dropped from a field (18-record-search-index §4.5), any ref change (added, removed, retargeted, parent ↔ lookup), a parent added to a
  * table `before` has (its stored rows have no parent edge, 13-data-model-v1 §22.5), a removed option.
  */
-export declare function companyMetadataCompatibilityIssues(before: CompiledCompanyMetadata, after: CompiledCompanyMetadata): string[];
+export declare function companySchemaCompatibilityIssues(before: CompiledSlotSchema, after: CompiledSlotSchema): string[];
 //# sourceMappingURL=schema-compat.d.ts.map