@nauticana/sail 1.1.37 → 1.1.38

package/README.md

@@ -713,7 +713,7 @@ import { AgentStudioService, PromptLanguageEditorComponent, TurnStream } from '@
 | `TurnStream` | Per-turn stream state: `accept(frame)` accepts Scout's zero-based frames and drops frames already rendered, `cursor()` is the next sequence wanted for inclusive replay, a suspension frame (`approval_pending`, even when marked final) sets `awaiting_approval` without advancing the cursor so the resumed frame at the same sequence is accepted, `markReplayExpired()` + `acceptStoredResult(frame)` handle an expired replay window, `markCancelRequested()` holds `cancelling` until the final frame. |
 | `sail-turn-stream-view` | `TurnStream` + event list + status + cancel button (`cancelRequested`). |
 | `sail-decision-timeline` | Read-only decision chain of one request, grouped by category. |
-| `ConversationService` | Transport for Scout's conversation bridge: `submit`, `stream(requestId, turnStream)`, `cancel`. Mount point injected through `CONVERSATION_BASE_PATH`; the service is a root singleton, so provide the token at bootstrap, or both together on a component. |
+| `ConversationService` | Transport for Scout's conversation bridge: `submit`, `stream(requestId, turnStream)`, `cancel`, `turns(workRef, before, limit)`, and `agents(agentType)` — the `ConversationAgent`s (`agent_name`, `display_name`, `is_default`, `release`) of that type the person may address, default first, whose `agent_name` goes on a turn request. Mount point injected through `CONVERSATION_BASE_PATH`; the service is a root singleton, so provide the token at bootstrap, or both together on a component. |
 | `SseParser` | Incremental `text/event-stream` parser: `push(chunk)` returns whole events out of chunks that split anywhere, including between the CR and LF of a CRLF; `finish()` flushes what the closing body left pending. |
 
 `DecisionRecord` is Scout's `api.DecisionRecord` (outcome `A`, `D`, or `P`, captioned from `audit_decision_outcome`); the timeline takes the records of one request, the activity table pages the tenant's. Style the `.prompt-*`, `.release-*`, `.turn-*`, `.decision-*`, `.studio__*`, and `.approval-inbox__*` class hooks. Scout's short codes render through `sailCaption`, a pipe over the backend's constant captions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nauticana/sail",
-  "version": "1.1.37",
+  "version": "1.1.38",
   "description": "Metadata-driven Angular component library for CRUD admin frontends backed by the keel Go backend. Tables, forms, navigation, OTP/2FA/social auth, billing, payout onboarding.",
   "main": "src/index.ts",
   "exports": {

package/src/agent/model/conversation.ts

@@ -17,6 +17,14 @@ export interface ConversationTurnRequest {
   input: unknown;
 }
 
+/** One agent the person may address through an agent type (`agent_name` on a turn request). */
+export interface ConversationAgent {
+  agent_name: string;
+  display_name: string;
+  is_default: boolean;
+  release: string;
+}
+
 export interface ConversationTurnAccepted {
   request_id: string;
 }

package/src/agent/service/conversation.service.ts

@@ -4,6 +4,7 @@ import { BaseAuthService } from '../../service/auth.service';
 import { BaseRestService } from '../../service/base_rest.service';
 import {
   CONVERSATION_BASE_PATH,
+  ConversationAgent,
   ConversationStreamError,
   ConversationStreamFailure,
   ConversationTurnAccepted,
@@ -19,7 +20,7 @@ const REPLAY_EXPIRED = 410;
 
 /**
  * Transport for Scout's conversation bridge: `POST {base}turn`,
- * `GET {base}turn/stream` as SSE, `POST {base}turn/cancel`. Submit and cancel go through
+ * `GET {base}turn/stream` as SSE, `POST {base}turn/cancel`, `GET {base}turns`, `GET {base}agents`. Submit and cancel go through
  * `HttpClient` (and so through sail's interceptors); the stream cannot, because
  * `EventSource` sends no `Authorization` header — it is a `fetch` body reader that carries
  * the bearer itself and rotates it through `BaseAuthService.refreshSession()` once on a 401.
@@ -35,6 +36,11 @@ export class ConversationService extends BaseRestService {
     return this.http.post<ConversationTurnAccepted>(this.conversationUrl('turn'), request);
   }
 
+  /** The agents of `agentType` the person may address, the default first. */
+  agents(agentType: string): Observable<ConversationAgent[]> {
+    return this.http.get<ConversationAgent[]>(this.conversationUrl('agents'), { params: { agent_type: agentType } });
+  }
+
   /** The person's turns, newest first; `before` continues from a page's `next_before`. */
   turns(workRef = '', before = '', limit = 0): Observable<ConversationTurnPage> {
     const params: Record<string, string> = {};