spine-framework 0.3.109 → 0.3.111

package/.framework/functions/_shared/agent-runner.ts

@@ -175,7 +175,8 @@ export async function runAgent(
     )
 
     // 4. Check confidence and escalate if needed
-    if (agentResponse.confidence < (promptConfig.confidence_threshold || 0)) {
+    const isEscalated = agentResponse.confidence < (promptConfig.confidence_threshold || 0)
+    if (isEscalated) {
       await handleEscalation(
         threadId,
         agentResponse.confidence,
@@ -204,6 +205,7 @@ export async function runAgent(
         agent_id: agent.id,
         prompt_config_id: promptConfig.id,
         sender_type: 'agent',
+        escalated: isEscalated,
       },
       ctx,
       replyTypeSlug

package/.framework/migrations/028_fix_message_data_permissions.sql

@@ -0,0 +1,49 @@
+-- Migration 028: Add AI metadata fields to support_reply/community_reply design_schema
+--
+-- Existing message rows were stamped with the old design_schema, which did not
+-- declare permissions for AI metadata fields (message_type, confidence, retrieved_sources,
+-- feedback, etc.). The permission sanitizer therefore stripped those fields from API
+-- responses, hiding the AI label, confidence badge, sources, and feedback UI.
+--
+-- This migration updates both the type definitions and the stamped design_schema on
+-- every existing message record so the new fields are readable (and feedback writable
+-- by members) without loosening the permission model.
+
+DO $$
+DECLARE
+  ai_fields jsonb := '{
+    "message_type": { "data_type": "text", "label": "Message Type", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "confidence": { "data_type": "number", "label": "AI Confidence", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "retrieval_confidence": { "data_type": "number", "label": "Retrieval Confidence", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "retrieved_sources": { "data_type": "json", "label": "Retrieved Sources", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "agent_id": { "data_type": "text", "label": "Agent ID", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "prompt_config_id": { "data_type": "text", "label": "Prompt Config ID", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "sender_type": { "data_type": "text", "label": "Sender Type", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "feedback": { "data_type": "text", "label": "Feedback", "system": true, "permissions": { "system_admin": ["read", "write"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read", "write"], "member": ["read", "write"] } },
+    "feedback_at": { "data_type": "datetime", "label": "Feedback At", "system": true, "permissions": { "system_admin": ["read", "write"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read", "write"], "member": ["read", "write"] } },
+    "escalated": { "data_type": "boolean", "label": "Escalated", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "suggested_title": { "data_type": "text", "label": "Suggested Title", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } },
+    "tool_calls": { "data_type": "json", "label": "Tool Calls", "system": true, "permissions": { "system_admin": ["read"], "support_admin": ["read"], "support": ["read"], "member_admin": ["read"], "member": ["read"] } }
+  }'::jsonb;
+BEGIN
+  -- Update type definitions
+  UPDATE types
+  SET design_schema = jsonb_set(
+    design_schema,
+    '{fields}',
+    COALESCE(design_schema->'fields', '{}'::jsonb) || ai_fields
+  )
+  WHERE slug IN ('support_reply', 'community_reply')
+    AND kind = 'message';
+
+  -- Update stamped design_schema on existing messages
+  UPDATE messages
+  SET design_schema = jsonb_set(
+    design_schema,
+    '{fields}',
+    COALESCE(design_schema->'fields', '{}'::jsonb) || ai_fields
+  )
+  WHERE type_id IN (
+    SELECT id FROM types WHERE slug IN ('support_reply', 'community_reply') AND kind = 'message'
+  );
+END $$;

package/.framework/migrations/029_tighten_support_triage_prompt.sql

@@ -0,0 +1,41 @@
+-- Migration 029: Tighten the support_triage prompt so the AI escalates when no relevant knowledge is retrieved.
+--
+-- The previous prompt told the agent to "respond helpfully and accurately" without
+-- explicitly forbidding general-knowledge answers or clarifying questions. This led to
+-- the AI asking questions even when the knowledge base was empty. This migration
+-- updates both the prompt_config and the agent's system_prompt to enforce:
+--   1. answer only from retrieved knowledge
+--   2. escalate immediately when no relevant knowledge is retrieved
+--   3. never ask the customer clarifying questions
+
+UPDATE prompt_configs
+SET context_template = 'A customer has submitted the following support request:
+
+{{user_message}}
+
+You may only answer using the relevant information provided in this prompt under ''## Relevant Information''.
+
+Rules:
+- If no relevant information is provided, or if it is insufficient to answer confidently, you MUST escalate to a human agent.
+- Do not ask the customer clarifying questions.
+- Do not answer from general knowledge or make up information.
+- Be concise, accurate, and empathetic.
+
+If you escalate, write a brief message telling the customer that a human support agent will review their request and follow up shortly.',
+    output_mode = 'text',
+    updated_at = now()
+WHERE slug = 'support_triage';
+
+UPDATE ai_agents
+SET system_prompt = 'You are a first-line support agent for a software platform. Your goal is to resolve customer issues accurately and efficiently on the first response, using only the knowledge retrieved for you.
+
+Guidelines:
+- Be concise and clear. Customers want answers, not essays.
+- You may only answer using the retrieved knowledge base articles and prior cases provided in your context.
+- If no relevant knowledge is retrieved, or if it is insufficient to answer confidently, escalate to a human agent immediately.
+- Do not ask the customer clarifying questions.
+- Never fabricate feature behaviour, make promises about the product, or answer from general knowledge.
+- If you escalate, tell the customer that a human support agent will review their request and follow up shortly.
+- Tone: professional but warm. Match the customer''s level of formality.',
+    updated_at = now()
+WHERE name = 'Support Triage Agent';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.3.109",
+  "version": "0.3.111",
   "description": "Multi-tenant, modular application platform for modern SaaS systems",
   "type": "module",
   "bin": {
@@ -34,6 +34,8 @@
     ".framework/migrations/025_retype_threads_messages.sql",
     ".framework/migrations/026_fix_rls_policies.sql",
     ".framework/migrations/027_embedding_lifecycle.sql",
+    ".framework/migrations/028_fix_message_data_permissions.sql",
+    ".framework/migrations/029_tighten_support_triage_prompt.sql",
     ".framework/public/",
     ".framework/scripts/",
     ".framework/seeds/",