@happyvertical/smrt-chat 0.51.32 → 0.51.33

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-chat",
-  "packageVersion": "0.51.32",
+  "packageVersion": "0.51.33",
   "objects": {
     "@happyvertical/smrt-chat:AgentSessionCollection": {
       "name": "agentsessioncollection",

package/dist/models/AgentSession.d.ts

@@ -1,5 +1,5 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { AgentSessionOptions, AgentSessionStatus } from '../types.js';
+import type { AgentSessionOptions, AgentSessionStatus } from '../types.js';
 /**
  * Agent conversation session. Internal model — sessions must be created via
  * {@link ChatService.createAgentSession} and their security-relevant config

package/dist/models/ChatMessage.d.ts

@@ -1,5 +1,5 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { ChatMessageOptions, ChatMessageRole, ChatMessageType } from '../types.js';
+import type { ChatMessageOptions, ChatMessageRole, ChatMessageType } from '../types.js';
 /**
  * Chat message. Internal model — all mutations must go through the
  * membership-checked {@link ChatService} (S5 #1392). The generated CRUD surface

package/dist/models/ChatParticipant.d.ts

@@ -1,5 +1,5 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { ChatParticipantOptions, ChatParticipantRole, ChatParticipantStatus, OnlineStatus } from '../types.js';
+import type { ChatParticipantOptions, ChatParticipantRole, ChatParticipantStatus, OnlineStatus } from '../types.js';
 /**
  * Room membership row. Internal model — membership must be established and
  * mutated only through the membership/owner-checked {@link ChatService}

package/dist/models/ChatReaction.d.ts

@@ -1,5 +1,5 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { ChatReactionOptions } from '../types.js';
+import type { ChatReactionOptions } from '../types.js';
 /**
  * Message reaction. Internal model — reactions must be added/removed only
  * through the membership-checked {@link ChatService} (S5 #1392). The generated

package/dist/models/ChatRoom.d.ts

@@ -1,5 +1,5 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { ChatRoomOptions, ChatRoomStatus, ChatRoomType } from '../types.js';
+import type { ChatRoomOptions, ChatRoomStatus, ChatRoomType } from '../types.js';
 type ChatRoomMetadata = Record<string, unknown>;
 /**
  * Chat room supporting public channels, private groups, DMs, and agent conversations.

package/dist/models/ChatThread.d.ts

@@ -1,5 +1,5 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { ChatThreadOptions } from '../types.js';
+import type { ChatThreadOptions } from '../types.js';
 /**
  * Conversation thread. Internal model — threads must be created/mutated only
  * through the membership-checked {@link ChatService} (S5 #1392). The generated

package/dist/models/VoiceGatewayTurn.d.ts

@@ -1,5 +1,5 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { VoiceGatewayTurnOptions, VoiceGatewayTurnStatus } from '../types.js';
+import type { VoiceGatewayTurnOptions, VoiceGatewayTurnStatus } from '../types.js';
 /**
  * Durable reservation for a gateway turn. The natural key makes `turn_id`
  * replay checks concurrency-safe before transcript messages are written.

package/dist/models/VoiceSession.d.ts

@@ -1,6 +1,6 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
-import { ConversationPersona } from '../persona-conversation.js';
-import { VoiceSessionOptions, VoiceSessionStatus } from '../types.js';
+import type { ConversationPersona } from '../persona-conversation.js';
+import type { VoiceSessionOptions, VoiceSessionStatus } from '../types.js';
 /**
  * Short-lived binding proving a voice gateway turn belongs to an authenticated
  * SMRT actor, persona, and chat session. Internal model: creation and turn

package/dist/persona-conversation.d.ts

@@ -1,9 +1,28 @@
-import { AIInterface, AIMessage } from '@happyvertical/ai';
-import { PrincipalAuditSink, PrincipalBinding, PrincipalTool } from '@happyvertical/smrt-agents';
-import { LearningMemoryRecord, LearningSemanticSearch, SmrtClassOptions } from '@happyvertical/smrt-core';
-import { AgentSession } from './models/AgentSession.js';
-import { ChatMessage } from './models/ChatMessage.js';
-import { ManifestTool, ToolLoopResult } from './tool-loop.js';
+/**
+ * Persona-bound conversation — the bridge from an {@link AgentSession} (a
+ * conversation) to an `AgentPersona`/`TenantAgent` (a tenant-scoped, principal-
+ * bound behavioural profile) (L3 of the learning-agents epic, #1891).
+ *
+ * This is the new, acyclic `chat → personas` edge. A conversation bound this way
+ * runs under the persona's **principal** (its `runAsUserId`, via
+ * {@link runToolLoop} → `executeAsPrincipal`), offers only the persona's
+ * **tools** (its `allowedTools`, narrowing the manifest operation surface),
+ * speaks with the persona's **instructions**, and draws on its **recalled
+ * learning memory** — so the assistant behaves like it knows the tenant's job.
+ *
+ * The persona's `allowedTools` is mirrored onto the `AgentSession` so the chat
+ * layer's own fail-closed tool gate (S5 #1392) agrees with the loop's — one
+ * allow-list, enforced at both the loop's side door and the message-authoring
+ * seam.
+ *
+ * @module
+ */
+import type { AIInterface, AIMessage } from '@happyvertical/ai';
+import type { PrincipalAuditSink, PrincipalBinding, PrincipalTool } from '@happyvertical/smrt-agents';
+import type { LearningMemoryRecord, LearningSemanticSearch, SmrtClassOptions } from '@happyvertical/smrt-core';
+import type { AgentSession } from './models/AgentSession.js';
+import type { ChatMessage } from './models/ChatMessage.js';
+import { type ManifestTool, type ToolLoopResult } from './tool-loop.js';
 /**
  * The structural persona shape the conversation binding needs. Both a
  * `ResolvedPersona` (from `PersonaResolver.resolve()`) and a raw `AgentPersona`

package/dist/services/ChatService.d.ts

@@ -1,8 +1,8 @@
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
-import { AgentSession } from '../models/AgentSession.js';
-import { ChatMessage } from '../models/ChatMessage.js';
-import { ChatThread } from '../models/ChatThread.js';
-import { ChatMessageType, ChatParticipantRole, ChatRoomStatus, ChatRoomType } from '../types.js';
+import { type SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { AgentSession } from '../models/AgentSession.js';
+import type { ChatMessage } from '../models/ChatMessage.js';
+import type { ChatThread } from '../models/ChatThread.js';
+import type { ChatMessageType, ChatParticipantRole, ChatRoomStatus, ChatRoomType } from '../types.js';
 /**
  * Parameters for emitting an agent-authored (assistant/tool) message. Used only
  * by the internal {@link sendAgentReply} bridge below — NOT a public surface.
@@ -65,7 +65,7 @@ export declare class ChatService {
         actorProfileId: string;
         description?: string;
         topic?: string;
-    }): Promise<import('../index.js').ChatRoom>;
+    }): Promise<import("../index.js").ChatRoom>;
     /**
      * Send a USER message to a room as the authenticated caller (S5 #1392).
      *
@@ -126,7 +126,7 @@ export declare class ChatService {
         actorProfileId: string;
         profileId: string;
         role?: ChatParticipantRole;
-    }): Promise<import('../index.js').ChatParticipant>;
+    }): Promise<import("../index.js").ChatParticipant>;
     /**
      * Remove (soft-leave) a participant from a room (S5 #1392).
      *
@@ -156,7 +156,7 @@ export declare class ChatService {
         topic?: string;
         avatarUrl?: string;
         status?: ChatRoomStatus;
-    }): Promise<import('../index.js').ChatRoom>;
+    }): Promise<import("../index.js").ChatRoom>;
     /**
      * Add a reaction to a message as the authenticated caller (S5 #1392).
      *
@@ -171,7 +171,7 @@ export declare class ChatService {
         messageId: string;
         actorProfileId: string;
         emoji: string;
-    }): Promise<import('../index.js').ChatReaction>;
+    }): Promise<import("../index.js").ChatReaction>;
     /**
      * Remove the caller's own reaction from a message (S5 #1392).
      *
@@ -198,7 +198,7 @@ export declare class ChatService {
         actorProfileId: string;
         profileId1: string;
         profileId2: string;
-    }): Promise<import('../index.js').ChatRoom>;
+    }): Promise<import("../index.js").ChatRoom>;
     /**
      * Create an agent conversation session with a linked chat room (S5 #1392).
      *
@@ -243,7 +243,7 @@ export declare class ChatService {
         agentProfileId?: string | null;
     }): Promise<{
         session: AgentSession;
-        room: import('../index.js').ChatRoom;
+        room: import("../index.js").ChatRoom;
     }>;
     /**
      * Send a USER message within an agent session (S5 #1392).
@@ -290,7 +290,7 @@ export declare class ChatService {
      * exist; throws when the actor is not an active participant. `tenantId` is
      * required so the lookup and the membership gate are always tenant-scoped.
      */
-    getRoomForMember(roomId: string, actorProfileId: string, tenantId: string): Promise<import('../index.js').ChatRoom | null>;
+    getRoomForMember(roomId: string, actorProfileId: string, tenantId: string): Promise<import("../index.js").ChatRoom | null>;
     /**
      * Tenant-bound read of a single agent session (S5 #1392).
      *

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-chat",
-  "packageVersion": "0.51.32",
+  "packageVersion": "0.51.33",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "df19b82e749e812f77fb166768cbd6e6cfea438b55ce83f99495a0378ce8c461",
-    "packageJson": "2a09a5e1938a9617b75a27315ca4893ec5527048e6d82f3108905ec86921057e",
+    "manifest": "526db14754ad4fa80617f0a61f2814950676f61731bb92faf8b41756f0c6fced",
+    "packageJson": "3884578ecff52a073a4e7bf8b9f01a9252565ed8f5b9682ff97479c136486319",
     "agents": "e76478900c3e8a013895d69d5a544b4a9280bcda18e3b69104da27938da2706e",
     "moduleDoc:agents/dev-workbench.md": "69b6f827d25c8aeb0e7516c90303af23948803213b5d34bc334c1e3376c83a16",
     "agentSurface:src/routes/chat-dev.intents.ts": "ff8f7c19c7eb6e841a08f03c97773c53092ed208004666bfed372bd1ad456b35"
@@ -48,7 +48,7 @@
     "fast-glob": "^3.3.3",
     "svelte": "^5.57.1",
     "svelte-check": "^4.7.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },

package/dist/tool-loop.d.ts

@@ -1,7 +1,45 @@
-import { AIInterface, AIMessage, AITool, ChatOptions } from '@happyvertical/ai';
-import { PrincipalAuditSink, PrincipalBinding, PrincipalRun, PrincipalTool } from '@happyvertical/smrt-agents';
-import { SmrtClassOptions } from '@happyvertical/smrt-core';
-import { PermissionDefinition } from '@happyvertical/smrt-users';
+/**
+ * ToolLoop — a bounded `tool_call → observe → respond` agentic loop over the
+ * SMRT manifest operation surface (L3 of the learning-agents epic, #1891).
+ *
+ * The universe of tools is **closed**: every tool is a manifest operation of an
+ * installed SMRT package — an object's CRUD or *public custom action*, each a
+ * `(collection, action)` in the manifest-derived permission catalog
+ * ({@link PermissionCatalogService}). The loop invokes them **in-process
+ * ("side door")** — no HTTP/MCP round-trip — inside the persona's
+ * session-permission context ({@link executeAsPrincipal}), so tenant isolation
+ * and per-operation authority (Postgres RLS, or the catalog assert when RLS is
+ * off) apply through any door.
+ *
+ * Two independent gates make the loop fail-closed:
+ *
+ *  1. **Offer gate** — the available tools are exactly the manifest operations
+ *     filtered by the persona's `allowedTools`. A tool outside the allow-list is
+ *     never offered to the model, and a hallucinated tool name is rejected
+ *     without execution.
+ *  2. **Execution gate** — every executed tool additionally re-asserts the
+ *     fail-closed allow-list ({@link PrincipalRun.assertToolAllowed}) and the
+ *     catalog permission for its `(collection, action)`
+ *     ({@link PrincipalRun.assertOperation}), so even a bug in the offer gate
+ *     cannot run an un-permitted operation.
+ *
+ * The loop is bounded by a max-steps ceiling: after `maxSteps` tool-executing
+ * rounds it disables tools for one final completion, guaranteeing termination
+ * with a text answer.
+ *
+ * Beyond manifest operations, the loop accepts a small set of **extra tools**
+ * ({@link ToolLoopOptions.extraTools}) — non-CRUD `PrincipalTool`s such as the
+ * agent-orchestration `invoke-agent` tool (#1892). Each is gated by the *same*
+ * fail-closed allow-list (the caller only passes an allow-listed tool, and the
+ * tool's `execute` re-asserts `assertToolAllowed`), so the closed-universe,
+ * fail-closed property holds for them too.
+ *
+ * @module
+ */
+import type { AIInterface, AIMessage, AITool, ChatOptions } from '@happyvertical/ai';
+import { type PrincipalAuditSink, type PrincipalBinding, type PrincipalRun, type PrincipalTool } from '@happyvertical/smrt-agents';
+import { type SmrtClassOptions } from '@happyvertical/smrt-core';
+import { type PermissionDefinition } from '@happyvertical/smrt-users';
 /** Default ceiling on tool-executing rounds before the loop force-terminates. */
 export declare const DEFAULT_MAX_STEPS = 8;
 /**

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
 export type ChatRoomType = 'public' | 'private' | 'dm' | 'agent';
 export type ChatRoomStatus = 'active' | 'archived' | 'deleted';
 export type ChatParticipantRole = 'owner' | 'admin' | 'member' | 'viewer';

package/dist/ui.d.ts

@@ -1,4 +1,4 @@
-import { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
+import type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
 export declare const CHAT_UI_SLOTS: Record<string, ModuleUISlot>;
 export declare const CHAT_MODULE_META: SmrtModuleMeta;
 //# sourceMappingURL=ui.d.ts.map

package/dist/voice.d.ts

@@ -1,9 +1,9 @@
-import { AIInterface } from '@happyvertical/ai';
-import { PrincipalAuditSink } from '@happyvertical/smrt-agents';
-import { SmrtClassOptions } from '@happyvertical/smrt-core';
-import { VoiceSession } from './models/VoiceSession.js';
-import { ConversationPersona, PersonaRecallOptions } from './persona-conversation.js';
-import { ChatService } from './services/index.js';
+import type { AIInterface } from '@happyvertical/ai';
+import type { PrincipalAuditSink } from '@happyvertical/smrt-agents';
+import { type SmrtClassOptions } from '@happyvertical/smrt-core';
+import type { VoiceSession } from './models/VoiceSession.js';
+import { type ConversationPersona, type PersonaRecallOptions } from './persona-conversation.js';
+import type { ChatService } from './services/index.js';
 export declare const SMRT_CHAT_VOICE_TARGET = "smrt:chat";
 export declare const MAX_VOICE_GATEWAY_TEXT_LENGTH = 12000;
 export interface VoiceGatewayTurnMetadata {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-chat",
-  "version": "0.51.32",
+  "version": "0.51.33",
   "smrtJsdoc": "strict",
   "description": "Chat rooms, DMs, threads, and agent conversations for the SMRT framework",
   "type": "module",
@@ -71,14 +71,14 @@
   },
   "dependencies": {
     "@happyvertical/ai": "^0.94.1",
-    "@happyvertical/smrt-agents": "0.51.32",
-    "@happyvertical/smrt-core": "0.51.32",
-    "@happyvertical/smrt-personas": "0.51.32",
-    "@happyvertical/smrt-profiles": "0.51.32",
-    "@happyvertical/smrt-tenancy": "0.51.32",
-    "@happyvertical/smrt-types": "0.51.32",
-    "@happyvertical/smrt-ui": "0.51.32",
-    "@happyvertical/smrt-users": "0.51.32",
+    "@happyvertical/smrt-agents": "0.51.33",
+    "@happyvertical/smrt-core": "0.51.33",
+    "@happyvertical/smrt-personas": "0.51.33",
+    "@happyvertical/smrt-profiles": "0.51.33",
+    "@happyvertical/smrt-tenancy": "0.51.33",
+    "@happyvertical/smrt-types": "0.51.33",
+    "@happyvertical/smrt-ui": "0.51.33",
+    "@happyvertical/smrt-users": "0.51.33",
     "@happyvertical/sql": "^0.94.1"
   },
   "peerDependencies": {
@@ -90,9 +90,9 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-playground": "0.51.32",
-    "@happyvertical/smrt-vitest": "0.51.32",
-    "@happyvertical/smrt-web": "0.51.32",
+    "@happyvertical/smrt-playground": "0.51.33",
+    "@happyvertical/smrt-vitest": "0.51.33",
+    "@happyvertical/smrt-web": "0.51.33",
     "@mlc-ai/web-llm": "^0.2.85",
     "bitgpu": "0.19.1",
     "@sveltejs/kit": "2.69.1",
@@ -102,7 +102,7 @@
     "fast-glob": "^3.3.3",
     "svelte": "^5.57.1",
     "svelte-check": "^4.7.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },