@elevasis/core 0.51.1 → 0.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/core",
-  "version": "0.51.1",
+  "version": "0.52.0",
   "license": "MIT",
   "description": "Minimal shared constants across Elevasis monorepo",
   "sideEffects": false,

package/src/operations/public-agent-chat/__tests__/api-schemas.test.ts

@@ -1,9 +1,14 @@
 import { describe, expect, it } from 'vitest'
 import {
+  CaptureFieldSchema,
   PublicAgentChatAuthorizeSchema,
   PublicAgentChatBrandingSchema,
   PublicAgentChatCreateSessionSchema,
-  PublicAgentChatSlugParamSchema
+  PublicAgentChatGrantSchema,
+  PublicAgentChatInboundMessageSchema,
+  PublicAgentChatSlugParamSchema,
+  WebSocketSessionEndSchema,
+  WebSocketSessionEndedEventSchema
 } from '../api-schemas'
 
 describe('PublicAgentChatBrandingSchema', () => {
@@ -106,4 +111,153 @@ describe('PublicAgentChatCreateSessionSchema', () => {
   it('rejects unknown keys (.strict)', () => {
     expect(PublicAgentChatCreateSessionSchema.safeParse({ rogue: true }).success).toBe(false)
   })
+
+  it('accepts arbitrary metadata (z.record — not narrowed)', () => {
+    const result = PublicAgentChatCreateSessionSchema.safeParse({
+      capabilityToken: 'a'.repeat(32),
+      metadata: { name: 'Alice', company: 'Acme', nested: { foo: 1 } }
+    })
+    expect(result.success).toBe(true)
+  })
+})
+
+describe('CaptureFieldSchema', () => {
+  it('accepts a minimal field with only key and label', () => {
+    expect(CaptureFieldSchema.safeParse({ key: 'name', label: 'Your Name' }).success).toBe(true)
+  })
+
+  it('accepts all optional fields populated', () => {
+    const result = CaptureFieldSchema.safeParse({
+      key: 'email',
+      label: 'Email Address',
+      type: 'email',
+      required: true
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts type tel', () => {
+    expect(CaptureFieldSchema.safeParse({ key: 'phone', label: 'Phone', type: 'tel' }).success).toBe(true)
+  })
+
+  it('accepts type text', () => {
+    expect(CaptureFieldSchema.safeParse({ key: 'company', label: 'Company', type: 'text' }).success).toBe(true)
+  })
+
+  it('rejects an unknown type value', () => {
+    expect(CaptureFieldSchema.safeParse({ key: 'x', label: 'X', type: 'number' }).success).toBe(false)
+  })
+
+  it('rejects a missing key', () => {
+    expect(CaptureFieldSchema.safeParse({ label: 'Name' }).success).toBe(false)
+  })
+
+  it('rejects a missing label', () => {
+    expect(CaptureFieldSchema.safeParse({ key: 'name' }).success).toBe(false)
+  })
+
+  it('rejects unknown keys (.strict)', () => {
+    expect(CaptureFieldSchema.safeParse({ key: 'x', label: 'X', placeholder: 'hint' }).success).toBe(false)
+  })
+})
+
+describe('WebSocketSessionEndSchema', () => {
+  it('accepts { type: "session:end" }', () => {
+    expect(WebSocketSessionEndSchema.safeParse({ type: 'session:end' }).success).toBe(true)
+  })
+
+  it('rejects wrong type discriminant', () => {
+    expect(WebSocketSessionEndSchema.safeParse({ type: 'session:turn' }).success).toBe(false)
+  })
+
+  it('rejects unknown extra keys (.strict)', () => {
+    expect(WebSocketSessionEndSchema.safeParse({ type: 'session:end', extra: true }).success).toBe(false)
+  })
+})
+
+describe('PublicAgentChatInboundMessageSchema (discriminated union)', () => {
+  it('routes session:turn correctly', () => {
+    const result = PublicAgentChatInboundMessageSchema.safeParse({
+      type: 'session:turn',
+      input: 'Hello!'
+    })
+    expect(result.success).toBe(true)
+    if (result.success) expect(result.data.type).toBe('session:turn')
+  })
+
+  it('routes session:end correctly', () => {
+    const result = PublicAgentChatInboundMessageSchema.safeParse({ type: 'session:end' })
+    expect(result.success).toBe(true)
+    if (result.success) expect(result.data.type).toBe('session:end')
+  })
+
+  it('rejects an unknown message type', () => {
+    expect(PublicAgentChatInboundMessageSchema.safeParse({ type: 'session:delete' }).success).toBe(false)
+  })
+})
+
+describe('WebSocketSessionEndedEventSchema', () => {
+  it('accepts a valid session:ended event', () => {
+    const result = WebSocketSessionEndedEventSchema.safeParse({
+      type: 'session:ended',
+      sessionId: 'abc-123'
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('rejects missing sessionId', () => {
+    expect(WebSocketSessionEndedEventSchema.safeParse({ type: 'session:ended' }).success).toBe(false)
+  })
+
+  it('rejects wrong type discriminant', () => {
+    expect(WebSocketSessionEndedEventSchema.safeParse({ type: 'turn:complete', sessionId: 'x' }).success).toBe(false)
+  })
+})
+
+describe('PublicAgentChatGrantSchema', () => {
+  it('accepts a minimal grant (captureFields absent — treated as empty)', () => {
+    const result = PublicAgentChatGrantSchema.safeParse({
+      slug: 'voice-agent',
+      resourceId: 'resource-1',
+      mode: 'open',
+      requiresCode: false
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts captureFields as an empty array (DB default)', () => {
+    const result = PublicAgentChatGrantSchema.safeParse({
+      slug: 'voice-agent',
+      resourceId: 'resource-1',
+      mode: 'open',
+      requiresCode: false,
+      captureFields: []
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts captureFields with valid field definitions', () => {
+    const result = PublicAgentChatGrantSchema.safeParse({
+      slug: 'voice-agent',
+      resourceId: 'resource-1',
+      mode: 'open',
+      requiresCode: false,
+      captureFields: [
+        { key: 'name', label: 'Your Name', type: 'text', required: true },
+        { key: 'email', label: 'Email', type: 'email' }
+      ]
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('rejects captureFields containing an invalid field (unknown type)', () => {
+    const result = PublicAgentChatGrantSchema.safeParse({
+      slug: 'voice-agent',
+      resourceId: 'resource-1',
+      mode: 'open',
+      requiresCode: false,
+      captureFields: [{ key: 'age', label: 'Age', type: 'number' }]
+    })
+    expect(result.success).toBe(false)
+  })
 })

package/src/operations/public-agent-chat/api-schemas.ts

@@ -1,5 +1,84 @@
 import { z } from 'zod'
 import { UuidSchema } from '../../platform/utils/validation'
+import { WebSocketSessionTurnSchema } from '../sessions/api-schemas'
+
+// ============================================================================
+// Capture Fields
+// ============================================================================
+
+/**
+ * A single intake field definition stored in agent_access_grants.capture_fields.
+ *
+ * - key: machine identifier (e.g. "name", "company")
+ * - label: display label shown to the visitor
+ * - type: input type hint; defaults to "text" when absent
+ * - required: whether the visitor must fill this field; defaults to false
+ */
+export const CaptureFieldSchema = z
+  .object({
+    key: z.string().min(1).max(100),
+    label: z.string().min(1).max(200),
+    type: z.enum(['text', 'email', 'tel']).optional(),
+    required: z.boolean().optional()
+  })
+  .strict()
+
+export type CaptureField = z.infer<typeof CaptureFieldSchema>
+
+// ============================================================================
+// WebSocket Inbound Messages (public agent-chat)
+// ============================================================================
+
+/**
+ * Inbound WebSocket message: end the current session.
+ *
+ * Client sends: { type: "session:end" }
+ *
+ * The server validates the capability token, calls session.end(), and emits
+ * a "session:ended" outbound event confirming the transition.
+ */
+export const WebSocketSessionEndSchema = z
+  .object({
+    type: z.literal('session:end')
+  })
+  .strict()
+
+export type WebSocketSessionEndMessage = z.infer<typeof WebSocketSessionEndSchema>
+
+/**
+ * Discriminated union of all inbound WebSocket messages for the public
+ * agent-chat endpoint.  Add new inbound message schemas here.
+ *
+ * Note: WebSocketSessionTurnSchema is defined in the sessions domain and
+ * composed here so consumers have a single import point for the full union.
+ */
+export const PublicAgentChatInboundMessageSchema = z.discriminatedUnion('type', [
+  WebSocketSessionTurnSchema,
+  WebSocketSessionEndSchema
+])
+
+export type PublicAgentChatInboundMessage = z.infer<typeof PublicAgentChatInboundMessageSchema>
+
+// ============================================================================
+// Outbound event: session:ended
+// ============================================================================
+
+/**
+ * Outbound WebSocket event emitted by the server after a session:end request
+ * is processed and the session is successfully marked ended.
+ */
+export const WebSocketSessionEndedEventSchema = z
+  .object({
+    type: z.literal('session:ended'),
+    sessionId: z.string()
+  })
+  .strict()
+
+export type WebSocketSessionEndedEvent = z.infer<typeof WebSocketSessionEndedEventSchema>
+
+// ============================================================================
+// Path / Query Parameter Schemas
+// ============================================================================
 
 export const PublicAgentChatSlugParamSchema = z
   .object({
@@ -54,6 +133,31 @@ export const PublicAgentChatBrandingSchema = z
   })
   .strict()
 
+// ============================================================================
+// Grant response schema
+// ============================================================================
+
+/**
+ * The public-facing grant shape returned by /authorize and /metadata endpoints.
+ *
+ * captureFields defaults to [] on the DB (NOT NULL); the schema field is
+ * .optional() for forward-compat, but callers should treat absence as [].
+ */
+export const PublicAgentChatGrantSchema = z.object({
+  slug: z.string(),
+  resourceId: z.string(),
+  mode: z.string(),
+  requiresCode: z.boolean(),
+  branding: PublicAgentChatBrandingSchema.optional(),
+  captureFields: z.array(CaptureFieldSchema).optional()
+})
+
+export type PublicAgentChatGrant = z.infer<typeof PublicAgentChatGrantSchema>
+
+// ============================================================================
+// TypeScript Type Exports
+// ============================================================================
+
 export type PublicAgentChatSlugParams = z.infer<typeof PublicAgentChatSlugParamSchema>
 export type PublicAgentChatSessionParams = z.infer<typeof PublicAgentChatSessionParamSchema>
 export type PublicAgentChatAuthorizeInput = z.infer<typeof PublicAgentChatAuthorizeSchema>

package/src/operations/public-agent-chat/index.ts

@@ -1,10 +1,20 @@
 export {
+  CaptureFieldSchema,
+  type CaptureField,
+  WebSocketSessionEndSchema,
+  type WebSocketSessionEndMessage,
+  PublicAgentChatInboundMessageSchema,
+  type PublicAgentChatInboundMessage,
+  WebSocketSessionEndedEventSchema,
+  type WebSocketSessionEndedEvent,
   PublicAgentChatSlugParamSchema,
   PublicAgentChatSessionParamSchema,
   PublicAgentChatAuthorizeSchema,
   PublicAgentChatCreateSessionSchema,
   PublicAgentChatCapabilityQuerySchema,
   PublicAgentChatBrandingSchema,
+  PublicAgentChatGrantSchema,
+  type PublicAgentChatGrant,
   type PublicAgentChatSlugParams,
   type PublicAgentChatSessionParams,
   type PublicAgentChatAuthorizeInput,

package/src/platform/constants/versions.ts

@@ -1,3 +1,3 @@
 export const VERSION = {
-  CURRENT: '1.13.14'
+  CURRENT: '1.13.15'
 }