@superpanel-sdk/runtime 0.0.1-internal.2 → 0.2.1

package/dist/builder/compile/compile-sequence.js

@@ -11,7 +11,6 @@ import { toCaseContextViewRegistry, toFunctionRegistry } from './registry.js';
 const FATAL_CODES = new Set([
     'unknown-table',
     'unknown-field',
-    'missing-session',
     'missing-compute-fn',
     'cyclic-dependency',
     'multi-derived-forbidden',

package/dist/builder/load.js

@@ -38,7 +38,7 @@ function isCompanySchema(value) {
     return entries.length > 0 && entries.every(looksLikeTable);
 }
 function isSequenceSlots(value) {
-    return isPlainObject(value) && looksLikeTable(value.session);
+    return isPlainObject(value) && Object.values(value).every(looksLikeTable);
 }
 /**
  * Resolve the config object from a dynamically imported module.

package/dist/cli/serve/index.js

@@ -75,6 +75,7 @@ async function handleExecute(loaded, message) {
         data: message.data,
         runToken: message.runToken,
         getRequestId: () => message.logRequestId,
+        getTags: () => message.logTags,
     });
     try {
         return await host.execute(message.name, message.args);

package/dist/compute-host/source-compute-host.d.ts

@@ -14,6 +14,8 @@ export type SourceComputeHostOptions = {
     runToken?: string;
     /** Forwarded on every `ctx.api` RPC as `x-request-id`. */
     getRequestId?: () => string | undefined;
+    /** Forwarded to script log RPC calls. */
+    getTags?: () => string[] | undefined;
 };
 export interface SourceComputeHost extends ComputeHost {
 }

package/dist/compute-host/source-compute-host.js

@@ -66,6 +66,7 @@ function resolveApiHost(options) {
             baseUrl: options.data.config.backendUrl,
             getToken: () => options.runToken,
             getRequestId: options.getRequestId,
+            getTags: options.getTags,
         });
     }
     return createFakeApiHost();

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

@@ -1,4 +1,5 @@
 import { ROW_ID_FIELD } from './schema.js';
+import { createPlatformSessionTable, PLATFORM_SESSION_FIELDS } from './platform-session-fields.js';
 import { isReservedTableName, isRowIdField } from './row.js';
 import { resolveFuncName } from '../functions/func-ref.js';
 import { buildDependencyGraph } from './deps.js';
@@ -91,14 +92,9 @@ function validateCompanyRefs(company, issues) {
  */
 export function compileSlotSchema(company, sequenceSlots, options = {}) {
     const issues = [];
-    const tables = {};
-    if (!sequenceSlots.session) {
-        issues.push({
-            code: 'missing-session',
-            message: 'Sequence slots must define a session table',
-            path: 'session',
-        });
-    }
+    const tables = {
+        session: createPlatformSessionTable(),
+    };
     for (const [tableName, companyTable] of Object.entries(company)) {
         if (tableName === 'session' || isReservedTableName(tableName)) {
             if (isReservedTableName(tableName)) {
@@ -123,6 +119,8 @@ export function compileSlotSchema(company, sequenceSlots, options = {}) {
         };
     }
     for (const [tableName, tableView] of Object.entries(sequenceSlots)) {
+        if (!tableView)
+            continue;
         if (isReservedTableName(tableName)) {
             issues.push({
                 code: 'reserved-table-name',
@@ -144,6 +142,7 @@ export function compileSlotSchema(company, sequenceSlots, options = {}) {
                 }
                 fields[fieldName] = toRuntimeField(fieldDef, options.functions);
             }
+            Object.assign(fields, PLATFORM_SESSION_FIELDS);
             requireRowIdField(fields, formatFieldPath('session', ROW_ID_FIELD), issues);
             tables.session = {
                 label: tableView.label,

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

@@ -0,0 +1,38 @@
+import type { RuntimeTableDef } from './types.js';
+export declare const PLATFORM_SESSION_FIELDS: {
+    readonly is_inbound_call: {
+        readonly derived: false;
+        readonly label: 'Inbound call';
+        readonly dataType: 'boolean';
+        readonly source: 'system';
+        readonly extraction: 'Set by the conversation entry pipeline';
+        readonly enum: null;
+        readonly nullable: false;
+        readonly identifier: null;
+        readonly ref: null;
+    };
+    readonly is_first_call: {
+        readonly derived: false;
+        readonly label: 'First call';
+        readonly dataType: 'boolean';
+        readonly source: 'system';
+        readonly extraction: 'No prior session for this case contact';
+        readonly enum: null;
+        readonly nullable: false;
+        readonly identifier: null;
+        readonly ref: null;
+    };
+    readonly is_new_user: {
+        readonly derived: false;
+        readonly label: 'New user';
+        readonly dataType: 'boolean';
+        readonly source: 'system';
+        readonly extraction: 'No existing contact for this party';
+        readonly enum: null;
+        readonly nullable: false;
+        readonly identifier: null;
+        readonly ref: null;
+    };
+};
+export declare function createPlatformSessionTable(): RuntimeTableDef;
+//# sourceMappingURL=platform-session-fields.d.ts.map

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

@@ -0,0 +1,48 @@
+import { idField } from './schema.js';
+export const PLATFORM_SESSION_FIELDS = {
+    is_inbound_call: {
+        derived: false,
+        label: 'Inbound call',
+        dataType: 'boolean',
+        source: 'system',
+        extraction: 'Set by the conversation entry pipeline',
+        enum: null,
+        nullable: false,
+        identifier: null,
+        ref: null,
+    },
+    is_first_call: {
+        derived: false,
+        label: 'First call',
+        dataType: 'boolean',
+        source: 'system',
+        extraction: 'No prior session for this case contact',
+        enum: null,
+        nullable: false,
+        identifier: null,
+        ref: null,
+    },
+    is_new_user: {
+        derived: false,
+        label: 'New user',
+        dataType: 'boolean',
+        source: 'system',
+        extraction: 'No existing contact for this party',
+        enum: null,
+        nullable: false,
+        identifier: null,
+        ref: null,
+    },
+};
+export function createPlatformSessionTable() {
+    return {
+        label: 'Session',
+        rows: 'single',
+        description: 'Per-conversation session fields',
+        fields: {
+            id: { ...idField, ref: null },
+            ...PLATFORM_SESSION_FIELDS,
+        },
+    };
+}
+//# sourceMappingURL=platform-session-fields.js.map

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

@@ -82,8 +82,8 @@ export type SessionTableDef = {
     fields: Record<string, NormalFieldCore>;
 };
 export type SequenceSlots = {
-    [table: string]: SequenceCompanyTableView | SessionTableDef;
-    session: SessionTableDef;
+    [table: string]: SequenceCompanyTableView | SessionTableDef | undefined;
+    session?: SessionTableDef;
 };
 /** Effective field shape used for Slots codegen. */
 export type EffectiveFieldDef = {

package/dist/dev-overlay/protocol.d.ts

@@ -33,6 +33,8 @@ export type OverlayExecuteMessage = {
     runToken?: string;
     /** Logger request id for `ctx.api` RPC; not the overlay execute correlation id. */
     logRequestId?: string;
+    /** Logger tags inherited from the backend execution context. */
+    logTags?: string[];
 };
 export type OverlayExecuteResultMessage = {
     type: 'execute.result';

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

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

package/dist/fn-context/index.js

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

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

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

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

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

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

@@ -8,11 +8,13 @@ export declare const logEmitInput: z.ZodObject<{
     }>;
     message: z.ZodString;
     extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type LogEmitHandler = (input: {
     level: 'info' | 'warn' | 'error';
     message: string;
     extra?: Record<string, unknown>;
+    tags?: string[];
     ctx: RpcContext;
 }) => Promise<void>;
 export declare function createLogRouter(emit: LogEmitHandler): import("@trpc/server").TRPCBuiltRouter<{
@@ -26,6 +28,7 @@ export declare function createLogRouter(emit: LogEmitHandler): import("@trpc/ser
             level: "error" | "info" | "warn";
             message: string;
             extra?: Record<string, unknown> | undefined;
+            tags?: string[] | undefined;
         };
         output: {
             ok: true;

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

@@ -4,11 +4,12 @@ export const logEmitInput = z.object({
     level: z.enum(['info', 'warn', 'error']),
     message: z.string(),
     extra: z.record(z.string(), z.unknown()).optional(),
+    tags: z.array(z.string()).optional(),
 });
 export function createLogRouter(emit) {
     return router({
         emit: publicProcedure.input(logEmitInput).mutation(async ({ ctx, input }) => {
-            await emit({ level: input.level, message: input.message, extra: input.extra, ctx });
+            await emit({ level: input.level, message: input.message, extra: input.extra, tags: input.tags, ctx });
             return { ok: true };
         }),
     });

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

@@ -1,5 +1,10 @@
 export declare const REQUEST_ID_HEADER = "x-request-id";
+export declare const LOG_TAGS_HEADER = "x-superpanel-log-tags";
 export declare function readRequestIdHeader(headers: {
     get(name: string): string | null;
 } | Record<string, string | string[] | undefined>): string | undefined;
+export declare function encodeLogTagsHeader(tags: string[]): string;
+export declare function readLogTagsHeader(headers: {
+    get(name: string): string | null;
+}): string[] | undefined;
 //# sourceMappingURL=request-id.d.ts.map

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

@@ -1,4 +1,5 @@
 export const REQUEST_ID_HEADER = 'x-request-id';
+export const LOG_TAGS_HEADER = 'x-superpanel-log-tags';
 function firstString(value) {
     const raw = Array.isArray(value) ? value[0] : value;
     return typeof raw === 'string' && raw.length > 0 ? raw : undefined;
@@ -10,4 +11,21 @@ export function readRequestIdHeader(headers) {
     const record = headers;
     return firstString(record[REQUEST_ID_HEADER]);
 }
+export function encodeLogTagsHeader(tags) {
+    return JSON.stringify(tags);
+}
+export function readLogTagsHeader(headers) {
+    const raw = headers.get(LOG_TAGS_HEADER);
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed) || !parsed.every((tag) => typeof tag === 'string'))
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
 //# sourceMappingURL=request-id.js.map

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

@@ -3,5 +3,7 @@ export declare function createRpcApiHost(options: {
     baseUrl: string;
     getToken: () => string | Promise<string>;
     getRequestId?: () => string | undefined;
+    getTags?: () => string[] | undefined;
+    waitUntil?: (promise: Promise<unknown>) => void;
 }): ApiHost;
 //# sourceMappingURL=trpc-client.d.ts.map

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

@@ -4,9 +4,15 @@ import { defaultHttpApi } from '../../core/context/http.js';
 import { integrationSurfaceKeys, } from '../../core/context/types.js';
 import { bindEnvService } from '../../core/context/env.js';
 import { REQUEST_ID_HEADER } from './request-id.js';
-function rpcLogger(c) {
+function rpcLogger(c, getTags, waitUntil) {
     const emit = (level, message, extra) => {
-        void c.log.emit.mutate({ level, message, extra }).catch(() => { });
+        const pending = c.log.emit.mutate({ level, message, extra, tags: getTags?.() }).catch(() => { });
+        if (waitUntil) {
+            waitUntil(pending);
+        }
+        else {
+            void pending;
+        }
     };
     return {
         info: (message, extra) => emit('info', message, extra),
@@ -100,7 +106,7 @@ export function createRpcApiHost(options) {
             return {
                 ...buildPlatformApis(c),
                 integration: buildSurfaces(c, metas),
-                log: rpcLogger(c),
+                log: rpcLogger(c, options.getTags, options.waitUntil),
                 http: defaultHttpApi(),
             };
         },

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

@@ -72,6 +72,7 @@ export declare function createAppRouter(modules: {
                 level: "error" | "info" | "warn";
                 message: string;
                 extra?: Record<string, unknown> | undefined;
+                tags?: string[] | undefined;
             };
             output: {
                 ok: true;

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export { loadSequenceCaseContextView, loadSequenceFunctions } from './builder/lo
 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, REQUEST_ID_HEADER, readRequestIdHeader, makeCtx, makeCtxAsync, noopLog, type ActionContext, type ActionDataSlice, type ApiHost, type FakeApiHostOptions, type RunScope, } from './fn-context/index.js';
+export { buildActionContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, 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';

package/dist/index.js

@@ -19,7 +19,7 @@ export { compileSequenceAgendas, fatalAgendaIssues } from './builder/compile/com
 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, REQUEST_ID_HEADER, readRequestIdHeader, makeCtx, makeCtxAsync, noopLog, } from './fn-context/index.js';
+export { buildActionContext, bindLogMeta, createFakeApiHost, defaultPlatformApis, emptyIntegration, createRpcApiHost, LOG_TAGS_HEADER, REQUEST_ID_HEADER, encodeLogTagsHeader, readLogTagsHeader, readRequestIdHeader, makeCtx, makeCtxAsync, noopLog, } from './fn-context/index.js';
 export { 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';

package/package.json

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