spine-framework-cortex 0.1.17 → 0.1.19

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [0.1.19] — 2026-06-10
+- Added `session_signals` link type + link creation in `upsertAnonymousSession()`
+- Fixed scoring data path — flattened `scoring_components` to match `funnel_signal` schema (raw_score_rating, engagement_type, recency_window, etc.)
+
+## [0.1.18] — 2026-06-10
+- Fixed `custom_funnel-signal.ts` — added required `account_id` to anonymous_session insert (links to unidentified-visitors account)
+
 ## [0.1.17] — 2026-06-10
 - Fixed `custom_funnel-signal.ts` — moved `anonymous_id` from nested `data.identity.anonymous_id` to root `data.anonymous_id` to match `anonymous_session` type schema (required field)
 

package/functions/custom_funnel-signal.ts

@@ -47,13 +47,14 @@ export async function processSignal(
   const payload = validation.data
 
   // 2. RESOLVE IDs (read-only type/account lookups)
-  const [signalTypeId, sessionTypeId, queueTypeId, signalLinkTypeId, opportunityLinkTypeId, unidentifiedAccountId] =
+  const [signalTypeId, sessionTypeId, queueTypeId, signalLinkTypeId, opportunityLinkTypeId, sessionLinkTypeId, unidentifiedAccountId] =
     await Promise.all([
       resolveTypeId('funnel_signal'),
       resolveTypeId('anonymous_session'),
       resolveTypeId('opportunity_queue'),
       resolveLinkTypeId('account_signals'),
       resolveLinkTypeId('account_opportunities'),
+      resolveLinkTypeId('session_signals'),
       resolveUnidentifiedAccountId(),
     ])
 
@@ -94,11 +95,17 @@ export async function processSignal(
       action_description: payload.action_description || null,
       url: payload.url || null,
     },
-    scoring_components: {
-      engagement: { type: engagement.type, context: engagement.context, session_depth: engagement.session_depth, prior_session_count: engagement.prior_session_count || 0 },
-      recency: { divisor: recency.divisor, age_days: recency.age_days, window: recency.window },
-      raw_score: { calculated: scoring.calculated, max_possible: scoring.max_possible, rating: scoring.rating },
-    },
+    // Scoring - flattened to match schema field names
+    raw_score_calculated: scoring.calculated,
+    raw_score_max_possible: scoring.max_possible,
+    raw_score_rating: scoring.rating,
+    engagement_type: engagement.type,
+    engagement_context: engagement.context,
+    engagement_session_depth: engagement.session_depth,
+    engagement_prior_session_count: engagement.prior_session_count || 0,
+    recency_divisor: recency.divisor,
+    recency_age_days: recency.age_days,
+    recency_window: recency.window,
     attribution: {
       immediate_referrer: payload.referrer || null,
       first_touch_referrer_domain: referrerDomain,
@@ -143,8 +150,8 @@ export async function processSignal(
     if (signalLinkTypeId) {
       await createLink(signalLinkTypeId, 'account', payload.account_id, 'item', signalId)
     }
-  } else if (payload.anonymous_id && sessionTypeId) {
-    await upsertAnonymousSession(payload, sessionTypeId, signalId, scoring, engagement, referrerDomain, referrerCategory, scoredAt)
+  } else if (payload.anonymous_id && sessionTypeId && unidentifiedAccountId) {
+    await upsertAnonymousSession(payload, sessionTypeId, unidentifiedAccountId, signalId, scoring, engagement, referrerDomain, referrerCategory, scoredAt, sessionLinkTypeId)
   }
 
   // 7. EVALUATE QUEUE — if rating >= 4
@@ -285,15 +292,16 @@ async function updateAccountFunnel(
 // ============================================
 
 async function upsertAnonymousSession(
-  payload: SignalPayload, sessionTypeId: string, signalId: string,
+  payload: SignalPayload, sessionTypeId: string, accountId: string, signalId: string,
   scoring: { calculated: number; max_possible: number; rating: number },
-  engagement: any, referrerDomain: string, referrerCategory: string, now: string
+  engagement: any, referrerDomain: string, referrerCategory: string, now: string,
+  sessionLinkTypeId: string | null
 ): Promise<void> {
   const { data: existing } = await adminDb
     .from('items')
     .select('id, data')
     .eq('type_id', sessionTypeId)
-    .eq('data->identity->>anonymous_id' as any, payload.anonymous_id!)
+    .eq('data->>anonymous_id' as any, payload.anonymous_id!)
     .order('created_at', { ascending: false })
     .limit(1)
     .maybeSingle()
@@ -318,9 +326,14 @@ async function upsertAnonymousSession(
         } : {}),
       },
     }).eq('id', existing.id)
+    // Link existing session to new signal
+    if (sessionLinkTypeId) {
+      await createLink(sessionLinkTypeId, 'item', existing.id, 'item', signalId)
+    }
   } else {
-    await adminDb.from('items').insert({
+    const { data: newSession } = await adminDb.from('items').insert({
       type_id: sessionTypeId,
+      account_id: accountId,
       title: `Anonymous: ${payload.anonymous_id!.slice(0, 8)}`,
       data: {
         anonymous_id: payload.anonymous_id,
@@ -347,7 +360,11 @@ async function upsertAnonymousSession(
         retention_retention_days: 90,
         retention_purge_after: new Date(Date.now() + 90 * 24 * 60 * 60 * 1000).toISOString(),
       },
-    })
+    }).select('id').single()
+    // Link new session to signal
+    if (sessionLinkTypeId && newSession) {
+      await createLink(sessionLinkTypeId, 'item', newSession.id, 'item', signalId)
+    }
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework-cortex",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Cortex — AI-powered support, CRM, and knowledge base app for Spine Framework",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",