@happyvertical/smrt-chat 0.51.31 → 0.51.33

package/dist/__tests__/chat-test-db.d.ts

@@ -0,0 +1,8 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import '../index.js';
+export declare function createChatTestDatabase(url: string): Promise<DatabaseInterface>;
+export declare function seedChatRoom(db: DatabaseInterface, id?: string): Promise<void>;
+export declare function seedChatMessage(db: DatabaseInterface, id?: string, roomId?: string): Promise<void>;
+export declare function seedChatThread(db: DatabaseInterface, id: string, rootMessageId?: string): Promise<void>;
+export declare function seedAgentSession(db: DatabaseInterface, id: string): Promise<void>;
+//# sourceMappingURL=chat-test-db.d.ts.map

package/dist/__tests__/chat-test-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-test-db.d.ts","sourceRoot":"","sources":["../../src/__tests__/chat-test-db.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,aAAa,CAAC;AAgBrB,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,EAAE,SAAW,GACZ,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,iBAAiB,EACrB,EAAE,SAAU,EACZ,MAAM,SAAW,GAChB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,iBAAiB,EACrB,EAAE,EAAE,MAAM,EACV,aAAa,SAA2B,GACvC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,iBAAiB,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/__tests__/raw-collections.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Test-only access to the raw chat collections (S5 #1392).
+ *
+ * The `ChatService` collections are `#private` and the package index no longer
+ * exports the collection classes, so production consumers can only mutate chat
+ * state through the authorized facade. Security regression tests, however, must
+ * sometimes forge a row that "slipped past" the facade or read a row directly to
+ * assert tenant binding. They obtain the collections from the `ObjectRegistry`
+ * — the same registry `ChatService.create()` registers into — rather than
+ * reaching into the service's private fields. This keeps the production surface
+ * closed while letting tests exercise the collection layer.
+ */
+import { type SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { AgentSessionCollection } from '../collections/AgentSessionCollection.js';
+import type { ChatMessageCollection } from '../collections/ChatMessageCollection.js';
+import type { ChatParticipantCollection } from '../collections/ChatParticipantCollection.js';
+import type { ChatReactionCollection } from '../collections/ChatReactionCollection.js';
+import type { ChatRoomCollection } from '../collections/ChatRoomCollection.js';
+import type { ChatThreadCollection } from '../collections/ChatThreadCollection.js';
+import type { VoiceSessionCollection } from '../collections/VoiceSessionCollection.js';
+export interface RawChatCollections {
+    rooms: ChatRoomCollection;
+    messages: ChatMessageCollection;
+    participants: ChatParticipantCollection;
+    threads: ChatThreadCollection;
+    agentSessions: AgentSessionCollection;
+    reactions: ChatReactionCollection;
+    voiceSessions: VoiceSessionCollection;
+}
+/**
+ * Resolve the raw chat collections from the registry for the given DB options.
+ * Must be called after `ChatService.create(options)` has registered them.
+ */
+export declare function getRawChatCollections(options: SmrtObjectOptions): Promise<RawChatCollections>;
+//# sourceMappingURL=raw-collections.d.ts.map

package/dist/__tests__/raw-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-collections.d.ts","sourceRoot":"","sources":["../../src/__tests__/raw-collections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,EAAE,yBAAyB,CAAC;IACxC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,aAAa,EAAE,sBAAsB,CAAC;IACtC,SAAS,EAAE,sBAAsB,CAAC;IAClC,aAAa,EAAE,sBAAsB,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAsC7B"}

package/dist/chat-feedback.d.ts

@@ -1,5 +1,24 @@
-import { LearningMemoryRecord, LearningSemanticSearch, SmrtClassOptions } from '@happyvertical/smrt-core';
-import { Feedback, FeedbackSignalType } from '@happyvertical/smrt-personas';
+/**
+ * Chat feedback capture — turn an in-conversation judgement into a first-class
+ * learning signal (L3 of the learning-agents epic, #1891).
+ *
+ * A tenant end-user accepting or rejecting an applied change, giving a
+ * thumbs-up/down, or typing an inline correction produces a {@link Feedback}
+ * row — carrying the conversation's **correlation-id** back to the turn it
+ * judges — and (by default) immediately reinforces the persona's learning
+ * memory. Because recall draws on that same memory next turn, captured feedback
+ * *influences subsequent behaviour*: a rejected strategy decays below the reuse
+ * floor and stops resurfacing; a correction supersedes it with the corrected
+ * value.
+ *
+ * This is the human-signal half of the loop the personas package already models
+ * ({@link reinforceFromFeedback}); the gated half — rewriting a persona's
+ * instructions — stays in the directive-proposal flow.
+ *
+ * @module
+ */
+import type { LearningMemoryRecord, LearningSemanticSearch, SmrtClassOptions } from '@happyvertical/smrt-core';
+import { type Feedback, type FeedbackSignalType } from '@happyvertical/smrt-personas';
 /** The minimal persona shape chat feedback needs to route the signal. */
 export interface ChatFeedbackPersona {
     /** Persona id — required (a signal always judges a specific persona). */

package/dist/chat-stream.d.ts

@@ -1,10 +1,38 @@
-import { AIInterface } from '@happyvertical/ai';
-import { PrincipalAuditSink, PrincipalTool } from '@happyvertical/smrt-agents';
-import { SmrtClassOptions } from '@happyvertical/smrt-core';
-import { AgentSession } from './models/AgentSession.js';
-import { ConversationPersona, PersonaRecallOptions } from './persona-conversation.js';
-import { ChatService } from './services/index.js';
-import { VoiceGatewayTurnMetadata } from './voice.js';
+/**
+ * Token-streaming conversation endpoint (SSE) for embeddable chat clients
+ * (issue #1936).
+ *
+ * The seam that joins the conversational harness to an embeddable widget: a
+ * client (first consumer: the Happy chat widget, `happyvertical/animation#5`)
+ * POSTs the conversation so far and receives a `text/event-stream` of
+ * `data: <json>` frames — token deltas as the model generates them, then a
+ * final `done` frame carrying the persisted message. A floating character can
+ * stream the reply into a bubble and lip-sync each sentence as it completes,
+ * instead of waiting for the whole JSON reply the way `POST /api/dev-chat` does.
+ *
+ * Two modes, dispatched by the resolved {@link ChatStreamContext}:
+ * - **persona-bound** (`context.binding` present): runs the full
+ *   {@link runPersonaConversationTurn} — persona principal, allow-listed tools,
+ *   recalled memory — with a token sink wired through the tool loop, then
+ *   persists via `ChatService` and emits the persisted message as `done`.
+ * - **plain / unbound** (`context.binding` absent): streams `ai.stream()`
+ *   directly and emits a synthesized (unpersisted) `done` message.
+ *
+ * Security posture (mirrors the voice gateway, #1910): this module NEVER
+ * authorizes from the request's `session` metadata. `createChatStreamHandler`
+ * takes an injected `authorize(request, body)` that the app implements to
+ * validate the caller (bearer session id / cookie) and resolve an already-
+ * authorized `ChatStreamContext`. The streaming engine enforces whatever that
+ * returns; no authorizer ⇒ the handler cannot run. The persona path reuses the
+ * harness's own fail-closed principal + allow-list gates unchanged.
+ */
+import type { AIInterface } from '@happyvertical/ai';
+import type { PrincipalAuditSink, PrincipalTool } from '@happyvertical/smrt-agents';
+import type { SmrtClassOptions } from '@happyvertical/smrt-core';
+import type { AgentSession } from './models/AgentSession.js';
+import { type ConversationPersona, type PersonaRecallOptions } from './persona-conversation.js';
+import type { ChatService } from './services/index.js';
+import type { VoiceGatewayTurnMetadata } from './voice.js';
 /** Max conversation messages accepted on one streaming request. */
 export declare const MAX_CHAT_STREAM_MESSAGES = 50;
 /** Max characters per message (matches the voice gateway text cap). */

package/dist/client.contract.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Compile-time contract locks between the browser client (`client.ts`) and
+ * the wire contract `chat-stream.ts` owns.
+ *
+ * This is deliberately a NON-TEST module: the typecheck tsconfig excludes
+ * `.test.ts` files and Vitest transpiles without typechecking, so locks inside
+ * a test file would enforce nothing (PR #2033 review). Here they sit in the
+ * `pnpm typecheck` program, so server-side drift in `ChatStreamEvent` /
+ * `ChatStreamSession` breaks the build instead of silently breaking clients.
+ *
+ * Nothing imports this module — it is type-only ballast and never reaches a
+ * runtime bundle (the vite entries don't reference it), keeping the `/client`
+ * subpath free of server imports.
+ */
+export {};
+//# sourceMappingURL=client.contract.d.ts.map

package/dist/client.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.contract.d.ts","sourceRoot":"","sources":["../src/client.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/collections/ChatMessageCollection.d.ts

@@ -1,6 +1,6 @@
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { ChatMessage } from '../models/ChatMessage.js';
-import { ChatMessageSearchFilters } from '../types.js';
+import type { ChatMessageSearchFilters } from '../types.js';
 export declare class ChatMessageCollection extends SmrtCollection<ChatMessage> {
     static readonly _itemClass: typeof ChatMessage;
     /**

package/dist/collections/ChatRoomCollection.d.ts

@@ -1,7 +1,7 @@
 import { SmrtCollection } from '@happyvertical/smrt-core';
-import { ChatParticipantCollection } from '../collections/ChatParticipantCollection.js';
+import type { ChatParticipantCollection } from '../collections/ChatParticipantCollection.js';
 import { ChatRoom } from '../models/ChatRoom.js';
-import { ChatRoomType } from '../types.js';
+import type { ChatRoomType } from '../types.js';
 /**
  * Deterministic, order-independent room id for a 1:1 DM between two profiles
  * within a tenant (S5 #1392, DM race hardening).

package/dist/collections/index.d.ts

@@ -0,0 +1,9 @@
+export { AgentSessionCollection } from './AgentSessionCollection.js';
+export { ChatMessageCollection } from './ChatMessageCollection.js';
+export { ChatParticipantCollection } from './ChatParticipantCollection.js';
+export { ChatReactionCollection } from './ChatReactionCollection.js';
+export { ChatRoomCollection } from './ChatRoomCollection.js';
+export { ChatThreadCollection } from './ChatThreadCollection.js';
+export { VoiceGatewayTurnCollection } from './VoiceGatewayTurnCollection.js';
+export { VoiceSessionCollection } from './VoiceSessionCollection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/collections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,45 @@
+/**
+ * @happyvertical/smrt-chat
+ *
+ * Chat rooms, DMs, threads, and agent conversations for the SMRT framework.
+ *
+ * Provides models and collections for real-time chat with support for:
+ * - Public/private rooms and channels
+ * - Direct messages between profiles
+ * - Threaded conversations (Slack-style)
+ * - Agent conversation sessions with tool access control
+ * - Message reactions and read receipts
+ *
+ * @example
+ * ```typescript
+ * import { ChatService } from '@happyvertical/smrt-chat';
+ *
+ * const chat = await ChatService.create({
+ *   persistence: { type: 'sql', url: 'chat.db' }
+ * });
+ *
+ * // actorProfileId is the authenticated principal injected by the route; the
+ * // acting actor becomes the room owner.
+ * const room = await chat.createRoom({
+ *   tenantId: 'tenant-1',
+ *   name: 'General',
+ *   roomType: 'public',
+ *   actorProfileId: 'profile-1',
+ * });
+ *
+ * // actorProfileId is the authenticated principal injected by the route;
+ * // the message is always authored as that actor with role 'user'.
+ * await chat.sendMessage({
+ *   tenantId: 'tenant-1',
+ *   roomId: room.id,
+ *   actorProfileId: 'profile-1',
+ *   content: 'Hello, world!',
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import './__smrt-register__.js';
 export { acceptAppliedChange, type CaptureChatFeedbackOptions, type ChatFeedbackBase, type ChatFeedbackPersona, type ChatFeedbackResult, captureChatFeedback, correctResponse, rateResponse, rejectAppliedChange, thumbsDown, thumbsUp, } from './chat-feedback.js';
 export { ChatStreamBadRequestError, type ChatStreamContext, type ChatStreamControlCommand, ChatStreamError, type ChatStreamEvent, type ChatStreamHandlerOptions, type ChatStreamMessage, type ChatStreamPersonaBinding, type ChatStreamRequestBody, type ChatStreamRole, type ChatStreamSession, ChatStreamUnauthorizedError, createChatStreamHandler, DEFAULT_CHAT_STREAM_HEARTBEAT_MS, encodeChatStreamEvent, MAX_CHAT_STREAM_CONTENT_LENGTH, MAX_CHAT_STREAM_MESSAGES, type RunChatConversationStreamOptions, runChatConversationStream, } from './chat-stream.js';
 export { createDataSurfaceBridge, createDataSurfaceCommandBridge, createServerDataSurfaceBridge, DATA_SURFACE_BRIDGE_VERSION, type DataSurfaceBridgeConnectionState, type DataSurfaceBridgeEvent, type DataSurfaceBridgeFailureReason, type DataSurfaceBridgeMessage, type DataSurfaceBridgeTransport, type DataSurfaceCommandAck, type DataSurfaceCommandBridge, type DataSurfaceCommandBridgeOptions, type DataSurfaceCommandRequest, DEFAULT_DATA_SURFACE_BRIDGE_TTL_MS, } from './data-surface-bridge.js';