@firststep-studio/sdk 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as ChatMessage } from './types-Bm98aHcd.mjs';
-export { A as AnalyticsContext, r as ChatbotInfo, s as ClassifierConfig, D as DeploymentInfo, F as FormData, z as FormFieldDefinition, B as FormFieldType, t as FormFieldValue, y as FormSchema, H as HandlerInfo, q as Helpline, p as HelplineResult, o as HelplineSearchOptions, I as IntegrationContext, n as IntegrationResult, w as InteractionEvent, x as InteractionEventType, K as KnowledgeContext, m as KnowledgeResult, L as LoggerContext, i as ProtocolCapabilities, j as ProtocolContext, g as ProtocolError, e as ProtocolFieldValidation, b as ProtocolForm, c as ProtocolFormField, d as ProtocolFormOption, h as ProtocolHandler, E as ProtocolRegistration, P as ProtocolRequest, a as ProtocolResponse, f as ProtocolStreamChunk, R as RoutingDecision, u as RoutingLog, k as SessionContext, v as SessionMetadata, l as SessionState, S as SessionStatus } from './types-Bm98aHcd.mjs';
+import { C as ChatMessage, S as SchemaDeclarationPayload, P as ProtocolStreamChunk, A as AgentTransitionPayload, R as RoutingClassificationPayload } from './types-B71xClvf.mjs';
+export { y as AnalyticsContext, t as ChatbotInfo, u as ClassifierConfig, D as DeploymentInfo, F as FormData, G as FormFieldDefinition, J as FormFieldType, v as FormFieldValue, E as FormSchema, H as HandlerInfo, r as Helpline, q as HelplineResult, p as HelplineSearchOptions, I as IntegrationContext, o as IntegrationResult, z as InteractionEvent, B as InteractionEventType, K as KnowledgeContext, n as KnowledgeResult, L as LoggerContext, j as ProtocolCapabilities, k as ProtocolContext, h as ProtocolError, g as ProtocolFieldValidation, d as ProtocolForm, e as ProtocolFormField, f as ProtocolFormOption, i as ProtocolHandler, M as ProtocolRegistration, a as ProtocolRequest, b as ProtocolResponse, s as RoutingDecision, w as RoutingLog, N as SchemaAgent, O as SchemaQuestion, l as SessionContext, x as SessionMetadata, m as SessionState, c as SessionStatus } from './types-B71xClvf.mjs';
 
 /**
  * UCP (Universal Classification Protocol) Types
@@ -235,12 +235,277 @@ declare function classifyWithUCP(endpoint: string, messages: ChatMessage[], opti
     timeout?: number;
 }): Promise<ClassificationResult>;
 
+/**
+ * Render Markers
+ *
+ * Utilities for building render markers that FirstStep Studio's frontend
+ * can parse and display as rich UI components (cards, alerts, forms, etc.).
+ *
+ * This module is the single source of truth for render marker specs.
+ * - Handlers (producers) use the builder functions to emit markers
+ * - Studio frontend (consumer) uses the types and MARKER_TYPES constants to parse them
+ *
+ * @example
+ * ```typescript
+ * import { renderMarkers } from '@firststep-studio/sdk';
+ *
+ * // In your handleStream():
+ * yield {
+ *   type: 'text',
+ *   content: renderMarkers.helplineCard({
+ *     helplines: [{ name: '988 Lifeline', phoneNumber: '988', categories: ['crisis'], status: 'open', statusLabel: 'Available' }],
+ *   }),
+ * };
+ * ```
+ */
+declare const MARKER_TYPES: {
+    readonly HELPLINE_CARD: "RENDER_HELPLINE_CARD";
+    readonly EMERGENCY: "RENDER_EMERGENCY";
+    readonly RESOURCE_CARD: "RENDER_RESOURCE_CARD";
+    readonly PROVIDER_CARD: "RENDER_PROVIDER_CARD";
+    readonly SAFETY_PLAN: "RENDER_SAFETY_PLAN";
+    readonly REPORT_CARD: "RENDER_REPORT_CARD";
+};
+type MarkerType = typeof MARKER_TYPES[keyof typeof MARKER_TYPES];
+/**
+ * Helpline card payload.
+ * Renders a carousel of helpline cards with contact buttons (call, text, chat, WhatsApp).
+ */
+interface HelplineCardPayload {
+    helplines: HelplineCardItem[];
+    type?: 'throughline' | 'throughline_fallback' | 'stage';
+    fallback?: {
+        message: string;
+        linkText?: string;
+        linkUrl?: string;
+        icon?: string;
+        topic?: string;
+        topics?: string[];
+    };
+}
+interface HelplineCardItem {
+    name: string;
+    description?: string;
+    categories: string[];
+    status: 'open' | 'closed';
+    statusLabel: string;
+    statusBadge?: string;
+    hoursText?: string;
+    supportTypes?: string;
+    smsNumber?: string;
+    phoneNumber?: string;
+    website?: string;
+    webchat?: string;
+    whatsapp?: string;
+    specialties?: string[];
+    highlightedTag?: string;
+    verified?: boolean;
+}
+/**
+ * Emergency number payload.
+ * Renders a prominent alert card with a large call button.
+ */
+interface EmergencyPayload {
+    number: string;
+    countryName?: string;
+    countryCode?: string;
+}
+/**
+ * Resource card payload.
+ * Renders a carousel of resource cards with video thumbnails, tags, and visit buttons.
+ */
+interface ResourceCardPayload {
+    resources: ResourceCardItem[];
+}
+interface ResourceCardItem {
+    name: string;
+    url?: string;
+    description?: string;
+    video_url?: string;
+    type?: string;
+    tags?: string[];
+    highlightedTag?: string;
+}
+/**
+ * Provider card payload.
+ * Renders a carousel of provider directory cards with specialty/language tags and contact info.
+ */
+interface ProviderCardPayload {
+    providers: ProviderCardItem[];
+}
+interface ProviderCardItem {
+    id: string;
+    name: string;
+    type?: string;
+    specialty: string[];
+    language: string[];
+    description?: string;
+    location?: string;
+    open_hours?: string;
+    contact_phone?: string;
+    contact_email?: string;
+    address?: string;
+}
+/**
+ * Safety plan payload.
+ * Renders a multi-section table with expandable sections and save/export actions.
+ */
+interface SafetyPlanPayload {
+    sections: SafetyPlanSection[];
+    helplines?: Array<{
+        name: string;
+        phone?: string;
+    }>;
+    actions?: {
+        savePng?: boolean;
+        saveTxt?: boolean;
+        copy?: boolean;
+    };
+}
+interface SafetyPlanSection {
+    id: string;
+    title: string;
+    items: Array<string | {
+        name: string;
+        phone?: string;
+        description?: string;
+    }>;
+}
+/**
+ * Report card payload.
+ * Renders a summary card of collected report data with a submit button.
+ */
+interface ReportCardPayload {
+    topic: string;
+    location?: string;
+    description?: string;
+    perpetrator_known?: boolean;
+    contact_mode?: string;
+    contact_value?: string;
+    submitEndpoint?: string;
+}
+/**
+ * Render marker builder functions.
+ *
+ * Each function takes a typed payload and returns a render marker string
+ * that can be yielded as a `text` chunk in handleStream().
+ *
+ * @example
+ * ```typescript
+ * // Emit helpline cards
+ * yield { type: 'text', content: renderMarkers.helplineCard({ helplines: [...] }) };
+ *
+ * // Emit emergency number
+ * yield { type: 'text', content: renderMarkers.emergency({ number: '911', countryName: 'United States' }) };
+ * ```
+ */
+declare const renderMarkers: {
+    /** Build a helpline card carousel marker */
+    helplineCard: (payload: HelplineCardPayload) => string;
+    /** Build an emergency number alert marker */
+    emergency: (payload: EmergencyPayload) => string;
+    /** Build a resource card carousel marker */
+    resourceCard: (payload: ResourceCardPayload) => string;
+    /** Build a provider card carousel marker */
+    providerCard: (payload: ProviderCardPayload) => string;
+    /** Build a safety plan artifact marker */
+    safetyPlan: (payload: SafetyPlanPayload) => string;
+    /** Build a report draft card marker */
+    reportCard: (payload: ReportCardPayload) => string;
+};
+
+/**
+ * Stream Metadata Builders
+ *
+ * Utilities for building typed metadata stream chunks that FirstStep Studio's
+ * proxy persists to MongoDB for Dashboard features (Form Insights, Session
+ * History, Routing Logs, Agent Transitions).
+ *
+ * Each function returns a ready-to-yield ProtocolStreamChunk. No need to
+ * construct the `{ type, content }` wrapper manually.
+ *
+ * @example
+ * ```typescript
+ * import { streamMetadata } from '@firststep-studio/sdk';
+ *
+ * // In your handleStream():
+ *
+ * // 1. Welcome path: declare your schema once
+ * yield streamMetadata.declareSchema({
+ *   agents: [{ id: 'intake', title: 'Intake', order: 0 }],
+ *   questions: [{ id: 'name', agentId: 'intake', title: 'Name', type: 'text' }],
+ * });
+ *
+ * // 2. After each turn: send collected field values
+ * yield streamMetadata.formDataUpdate({ name: 'Alice', age: '28' });
+ *
+ * // 3. On stage change: signal an agent transition
+ * yield streamMetadata.agentTransition({ id: 'support', title: 'Support' });
+ *
+ * // 4. On classification: send routing result
+ * yield streamMetadata.routingResult({
+ *   decision: 'classified',
+ *   reason: 'User mentioned self-harm',
+ *   category: 'crisis',
+ *   level: 'high',
+ *   score: 92,
+ * });
+ * ```
+ */
+
+declare const streamMetadata: {
+    /**
+     * Declare the form schema (agents + questions) for Dashboard Form Insights.
+     *
+     * Yield this once during session initialization (welcome message).
+     * The Studio proxy stores it in `chatbot.externalSchema` so that
+     * Dashboard Form Insights can display question-level analytics.
+     *
+     * @param schema - Agents and questions your handler uses
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    declareSchema(schema: SchemaDeclarationPayload): ProtocolStreamChunk;
+    /**
+     * Send collected form field values for Dashboard persistence.
+     *
+     * Call this after each turn when new fields are captured.
+     * Values are incrementally merged into `ChatSession.formData`.
+     *
+     * @param fields - Key-value pairs of field IDs to their collected values
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    formDataUpdate(fields: Record<string, string | number>): ProtocolStreamChunk;
+    /**
+     * Signal an agent/stage transition for routing logs.
+     *
+     * The Studio proxy records this in `ChatSession.routingLogs` so
+     * the Dashboard can show the conversation's agent flow.
+     *
+     * @param agent - The agent/stage being transitioned to
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    agentTransition(agent: AgentTransitionPayload): ProtocolStreamChunk;
+    /**
+     * Send a routing/classification result for routing logs.
+     *
+     * The Studio proxy records this in `ChatSession.routingLogs` as a
+     * classification event with category, level, and confidence score.
+     *
+     * @param result - Classification/routing decision details
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    routingResult(result: RoutingClassificationPayload): ProtocolStreamChunk;
+};
+
 /**
  * Verify an HMAC-SHA256 request signature.
  *
  * The handler server can use this to verify that incoming webhook
  * requests were signed by the FirstStep platform using the shared token.
  *
+ * The HMAC key is SHA-256(token), matching the backend which only stores
+ * the token hash and uses it directly as the HMAC key.
+ *
  * @param token - The API token (FIRSTSTEP_TOKEN)
  * @param payload - The raw request body string
  * @param signature - The signature from the X-FirstStep-Signature header
@@ -296,4 +561,4 @@ declare function createAuthHeader(token: string): string;
  */
 declare function isValidToken(token: string): boolean;
 
-export { ChatMessage, type ClassificationResult, type UCPClassifyRequest, type UCPClassifyResponse, UCPClient, type UCPClientConfig, type UCPEndpointConfig, UCPError, type UCPErrorResponse, type UCPInfoResponse, type UCPMessage, classifyWithUCP, createAuthHeader, createRequestSignature, createUCPClient, isValidToken, verifyRequestSignature };
+export { AgentTransitionPayload, ChatMessage, type ClassificationResult, type EmergencyPayload, type HelplineCardItem, type HelplineCardPayload, MARKER_TYPES, type MarkerType, ProtocolStreamChunk, type ProviderCardItem, type ProviderCardPayload, type ReportCardPayload, type ResourceCardItem, type ResourceCardPayload, RoutingClassificationPayload, type SafetyPlanPayload, type SafetyPlanSection, SchemaDeclarationPayload, type UCPClassifyRequest, type UCPClassifyResponse, UCPClient, type UCPClientConfig, type UCPEndpointConfig, UCPError, type UCPErrorResponse, type UCPInfoResponse, type UCPMessage, classifyWithUCP, createAuthHeader, createRequestSignature, createUCPClient, isValidToken, renderMarkers, streamMetadata, verifyRequestSignature };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ChatMessage } from './types-Bm98aHcd.js';
-export { A as AnalyticsContext, r as ChatbotInfo, s as ClassifierConfig, D as DeploymentInfo, F as FormData, z as FormFieldDefinition, B as FormFieldType, t as FormFieldValue, y as FormSchema, H as HandlerInfo, q as Helpline, p as HelplineResult, o as HelplineSearchOptions, I as IntegrationContext, n as IntegrationResult, w as InteractionEvent, x as InteractionEventType, K as KnowledgeContext, m as KnowledgeResult, L as LoggerContext, i as ProtocolCapabilities, j as ProtocolContext, g as ProtocolError, e as ProtocolFieldValidation, b as ProtocolForm, c as ProtocolFormField, d as ProtocolFormOption, h as ProtocolHandler, E as ProtocolRegistration, P as ProtocolRequest, a as ProtocolResponse, f as ProtocolStreamChunk, R as RoutingDecision, u as RoutingLog, k as SessionContext, v as SessionMetadata, l as SessionState, S as SessionStatus } from './types-Bm98aHcd.js';
+import { C as ChatMessage, S as SchemaDeclarationPayload, P as ProtocolStreamChunk, A as AgentTransitionPayload, R as RoutingClassificationPayload } from './types-B71xClvf.js';
+export { y as AnalyticsContext, t as ChatbotInfo, u as ClassifierConfig, D as DeploymentInfo, F as FormData, G as FormFieldDefinition, J as FormFieldType, v as FormFieldValue, E as FormSchema, H as HandlerInfo, r as Helpline, q as HelplineResult, p as HelplineSearchOptions, I as IntegrationContext, o as IntegrationResult, z as InteractionEvent, B as InteractionEventType, K as KnowledgeContext, n as KnowledgeResult, L as LoggerContext, j as ProtocolCapabilities, k as ProtocolContext, h as ProtocolError, g as ProtocolFieldValidation, d as ProtocolForm, e as ProtocolFormField, f as ProtocolFormOption, i as ProtocolHandler, M as ProtocolRegistration, a as ProtocolRequest, b as ProtocolResponse, s as RoutingDecision, w as RoutingLog, N as SchemaAgent, O as SchemaQuestion, l as SessionContext, x as SessionMetadata, m as SessionState, c as SessionStatus } from './types-B71xClvf.js';
 
 /**
  * UCP (Universal Classification Protocol) Types
@@ -235,12 +235,277 @@ declare function classifyWithUCP(endpoint: string, messages: ChatMessage[], opti
     timeout?: number;
 }): Promise<ClassificationResult>;
 
+/**
+ * Render Markers
+ *
+ * Utilities for building render markers that FirstStep Studio's frontend
+ * can parse and display as rich UI components (cards, alerts, forms, etc.).
+ *
+ * This module is the single source of truth for render marker specs.
+ * - Handlers (producers) use the builder functions to emit markers
+ * - Studio frontend (consumer) uses the types and MARKER_TYPES constants to parse them
+ *
+ * @example
+ * ```typescript
+ * import { renderMarkers } from '@firststep-studio/sdk';
+ *
+ * // In your handleStream():
+ * yield {
+ *   type: 'text',
+ *   content: renderMarkers.helplineCard({
+ *     helplines: [{ name: '988 Lifeline', phoneNumber: '988', categories: ['crisis'], status: 'open', statusLabel: 'Available' }],
+ *   }),
+ * };
+ * ```
+ */
+declare const MARKER_TYPES: {
+    readonly HELPLINE_CARD: "RENDER_HELPLINE_CARD";
+    readonly EMERGENCY: "RENDER_EMERGENCY";
+    readonly RESOURCE_CARD: "RENDER_RESOURCE_CARD";
+    readonly PROVIDER_CARD: "RENDER_PROVIDER_CARD";
+    readonly SAFETY_PLAN: "RENDER_SAFETY_PLAN";
+    readonly REPORT_CARD: "RENDER_REPORT_CARD";
+};
+type MarkerType = typeof MARKER_TYPES[keyof typeof MARKER_TYPES];
+/**
+ * Helpline card payload.
+ * Renders a carousel of helpline cards with contact buttons (call, text, chat, WhatsApp).
+ */
+interface HelplineCardPayload {
+    helplines: HelplineCardItem[];
+    type?: 'throughline' | 'throughline_fallback' | 'stage';
+    fallback?: {
+        message: string;
+        linkText?: string;
+        linkUrl?: string;
+        icon?: string;
+        topic?: string;
+        topics?: string[];
+    };
+}
+interface HelplineCardItem {
+    name: string;
+    description?: string;
+    categories: string[];
+    status: 'open' | 'closed';
+    statusLabel: string;
+    statusBadge?: string;
+    hoursText?: string;
+    supportTypes?: string;
+    smsNumber?: string;
+    phoneNumber?: string;
+    website?: string;
+    webchat?: string;
+    whatsapp?: string;
+    specialties?: string[];
+    highlightedTag?: string;
+    verified?: boolean;
+}
+/**
+ * Emergency number payload.
+ * Renders a prominent alert card with a large call button.
+ */
+interface EmergencyPayload {
+    number: string;
+    countryName?: string;
+    countryCode?: string;
+}
+/**
+ * Resource card payload.
+ * Renders a carousel of resource cards with video thumbnails, tags, and visit buttons.
+ */
+interface ResourceCardPayload {
+    resources: ResourceCardItem[];
+}
+interface ResourceCardItem {
+    name: string;
+    url?: string;
+    description?: string;
+    video_url?: string;
+    type?: string;
+    tags?: string[];
+    highlightedTag?: string;
+}
+/**
+ * Provider card payload.
+ * Renders a carousel of provider directory cards with specialty/language tags and contact info.
+ */
+interface ProviderCardPayload {
+    providers: ProviderCardItem[];
+}
+interface ProviderCardItem {
+    id: string;
+    name: string;
+    type?: string;
+    specialty: string[];
+    language: string[];
+    description?: string;
+    location?: string;
+    open_hours?: string;
+    contact_phone?: string;
+    contact_email?: string;
+    address?: string;
+}
+/**
+ * Safety plan payload.
+ * Renders a multi-section table with expandable sections and save/export actions.
+ */
+interface SafetyPlanPayload {
+    sections: SafetyPlanSection[];
+    helplines?: Array<{
+        name: string;
+        phone?: string;
+    }>;
+    actions?: {
+        savePng?: boolean;
+        saveTxt?: boolean;
+        copy?: boolean;
+    };
+}
+interface SafetyPlanSection {
+    id: string;
+    title: string;
+    items: Array<string | {
+        name: string;
+        phone?: string;
+        description?: string;
+    }>;
+}
+/**
+ * Report card payload.
+ * Renders a summary card of collected report data with a submit button.
+ */
+interface ReportCardPayload {
+    topic: string;
+    location?: string;
+    description?: string;
+    perpetrator_known?: boolean;
+    contact_mode?: string;
+    contact_value?: string;
+    submitEndpoint?: string;
+}
+/**
+ * Render marker builder functions.
+ *
+ * Each function takes a typed payload and returns a render marker string
+ * that can be yielded as a `text` chunk in handleStream().
+ *
+ * @example
+ * ```typescript
+ * // Emit helpline cards
+ * yield { type: 'text', content: renderMarkers.helplineCard({ helplines: [...] }) };
+ *
+ * // Emit emergency number
+ * yield { type: 'text', content: renderMarkers.emergency({ number: '911', countryName: 'United States' }) };
+ * ```
+ */
+declare const renderMarkers: {
+    /** Build a helpline card carousel marker */
+    helplineCard: (payload: HelplineCardPayload) => string;
+    /** Build an emergency number alert marker */
+    emergency: (payload: EmergencyPayload) => string;
+    /** Build a resource card carousel marker */
+    resourceCard: (payload: ResourceCardPayload) => string;
+    /** Build a provider card carousel marker */
+    providerCard: (payload: ProviderCardPayload) => string;
+    /** Build a safety plan artifact marker */
+    safetyPlan: (payload: SafetyPlanPayload) => string;
+    /** Build a report draft card marker */
+    reportCard: (payload: ReportCardPayload) => string;
+};
+
+/**
+ * Stream Metadata Builders
+ *
+ * Utilities for building typed metadata stream chunks that FirstStep Studio's
+ * proxy persists to MongoDB for Dashboard features (Form Insights, Session
+ * History, Routing Logs, Agent Transitions).
+ *
+ * Each function returns a ready-to-yield ProtocolStreamChunk. No need to
+ * construct the `{ type, content }` wrapper manually.
+ *
+ * @example
+ * ```typescript
+ * import { streamMetadata } from '@firststep-studio/sdk';
+ *
+ * // In your handleStream():
+ *
+ * // 1. Welcome path: declare your schema once
+ * yield streamMetadata.declareSchema({
+ *   agents: [{ id: 'intake', title: 'Intake', order: 0 }],
+ *   questions: [{ id: 'name', agentId: 'intake', title: 'Name', type: 'text' }],
+ * });
+ *
+ * // 2. After each turn: send collected field values
+ * yield streamMetadata.formDataUpdate({ name: 'Alice', age: '28' });
+ *
+ * // 3. On stage change: signal an agent transition
+ * yield streamMetadata.agentTransition({ id: 'support', title: 'Support' });
+ *
+ * // 4. On classification: send routing result
+ * yield streamMetadata.routingResult({
+ *   decision: 'classified',
+ *   reason: 'User mentioned self-harm',
+ *   category: 'crisis',
+ *   level: 'high',
+ *   score: 92,
+ * });
+ * ```
+ */
+
+declare const streamMetadata: {
+    /**
+     * Declare the form schema (agents + questions) for Dashboard Form Insights.
+     *
+     * Yield this once during session initialization (welcome message).
+     * The Studio proxy stores it in `chatbot.externalSchema` so that
+     * Dashboard Form Insights can display question-level analytics.
+     *
+     * @param schema - Agents and questions your handler uses
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    declareSchema(schema: SchemaDeclarationPayload): ProtocolStreamChunk;
+    /**
+     * Send collected form field values for Dashboard persistence.
+     *
+     * Call this after each turn when new fields are captured.
+     * Values are incrementally merged into `ChatSession.formData`.
+     *
+     * @param fields - Key-value pairs of field IDs to their collected values
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    formDataUpdate(fields: Record<string, string | number>): ProtocolStreamChunk;
+    /**
+     * Signal an agent/stage transition for routing logs.
+     *
+     * The Studio proxy records this in `ChatSession.routingLogs` so
+     * the Dashboard can show the conversation's agent flow.
+     *
+     * @param agent - The agent/stage being transitioned to
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    agentTransition(agent: AgentTransitionPayload): ProtocolStreamChunk;
+    /**
+     * Send a routing/classification result for routing logs.
+     *
+     * The Studio proxy records this in `ChatSession.routingLogs` as a
+     * classification event with category, level, and confidence score.
+     *
+     * @param result - Classification/routing decision details
+     * @returns A metadata stream chunk ready to yield or queue.push
+     */
+    routingResult(result: RoutingClassificationPayload): ProtocolStreamChunk;
+};
+
 /**
  * Verify an HMAC-SHA256 request signature.
  *
  * The handler server can use this to verify that incoming webhook
  * requests were signed by the FirstStep platform using the shared token.
  *
+ * The HMAC key is SHA-256(token), matching the backend which only stores
+ * the token hash and uses it directly as the HMAC key.
+ *
  * @param token - The API token (FIRSTSTEP_TOKEN)
  * @param payload - The raw request body string
  * @param signature - The signature from the X-FirstStep-Signature header
@@ -296,4 +561,4 @@ declare function createAuthHeader(token: string): string;
  */
 declare function isValidToken(token: string): boolean;
 
-export { ChatMessage, type ClassificationResult, type UCPClassifyRequest, type UCPClassifyResponse, UCPClient, type UCPClientConfig, type UCPEndpointConfig, UCPError, type UCPErrorResponse, type UCPInfoResponse, type UCPMessage, classifyWithUCP, createAuthHeader, createRequestSignature, createUCPClient, isValidToken, verifyRequestSignature };
+export { AgentTransitionPayload, ChatMessage, type ClassificationResult, type EmergencyPayload, type HelplineCardItem, type HelplineCardPayload, MARKER_TYPES, type MarkerType, ProtocolStreamChunk, type ProviderCardItem, type ProviderCardPayload, type ReportCardPayload, type ResourceCardItem, type ResourceCardPayload, RoutingClassificationPayload, type SafetyPlanPayload, type SafetyPlanSection, SchemaDeclarationPayload, type UCPClassifyRequest, type UCPClassifyResponse, UCPClient, type UCPClientConfig, type UCPEndpointConfig, UCPError, type UCPErrorResponse, type UCPInfoResponse, type UCPMessage, classifyWithUCP, createAuthHeader, createRequestSignature, createUCPClient, isValidToken, renderMarkers, streamMetadata, verifyRequestSignature };