@gotcos/glasses-server 6.71.0 → 6.71.5

package/shared/meeting-ask.ts

@@ -11,6 +11,20 @@ export interface MeetingAskTurn {
     speaker: string;
     text: string;
 }
+/**
+ * GET /api/meeting-ask/transcript. A live meeting answers from memory. A meeting that has ended (6.71.1)
+ * answers from its saved record with ended: true, so it stays askable. 404 meeting_transcript_unavailable
+ * only when no source holds its words.
+ */
+export interface MeetingAskTranscript {
+    turns: MeetingAskTurn[];
+    elapsedMs: number;
+    notices: string[];
+    ended?: true;
+    /** When the recording stopped, if known. */
+    endedAt?: string;
+    source?: 'live' | 'active_file' | 'saved';
+}
 export interface MeetingAskFile {
     id: string;
     revision: string;
@@ -18,8 +32,12 @@ export interface MeetingAskFile {
     status: 'ready' | 'pending' | 'unsupported' | 'failed' | 'removed' | 'secret-held';
     text: string;
     notice?: string;
+    /** "phone" for a file the phone attached through POST files/media (6.71.1). Control's rows omit it. */
+    origin?: 'phone';
 }
 export interface MeetingAskSource {
+  /** Server-owned accepted post-stop quotation; no live turn target or precise word clock. */
+  finalizedTranscript?: boolean
     id: string;
     kind: 'transcript' | 'memory' | 'meeting' | 'file' | 'web';
     title: string;
@@ -145,6 +163,8 @@ export interface MeetingAskExchange {
     sections?: MeetingAskSection[];
     sources: MeetingAskSource[];
     notices: string[];
+    /** Audited public query actually admitted for this answer, if any. */
+    publicWebQuery?: string;
     throughMs: number;
     files: MeetingAskFile[];
     error?: string;
@@ -155,11 +175,27 @@ export interface MeetingAskCapabilities {
     durableHistory: true;
     attachmentContext: true;
     webRetrieval: boolean;
+    publicTopics?: true;
+    /** 6.71.1: POST /api/meeting-ask/files/media turns uploaded media into meeting files. */
+    phoneFiles?: true;
+    /** 6.71.1: config carries cosSearch and PUT config {cosSearch} changes it. */
+    cosSearchMode?: true;
+    meetingContext?: true;
 }
+/**
+ * How Meeting Ask searches COS memory and earlier meetings (6.71.1). 'meaning' (default) adds the embedding
+ * search, which sends the search phrase to the COS install's embedding provider; 'keyword' matches words
+ * locally only, with no embedding request and no tokens.
+ */
+export type MeetingAskCosSearch = 'meaning' | 'keyword';
 export interface MeetingAskConfig {
     protocolVersion: 2;
     serverInstanceId: string;
     selected: MeetingAskModel;
+    /** 6.71.1. Missing on older servers, which always used 'meaning'. */
+    cosSearch?: MeetingAskCosSearch;
+    /** Explicit opt-in to public-topic selection from recent transcript for fact checks. */
+    publicTopics?: boolean;
     models: Array<MeetingAskModel & {
         available: boolean;
         reason?: string;
@@ -171,12 +207,26 @@ export interface MeetingAskConfig {
     };
     capabilities: MeetingAskCapabilities;
 }
-/** All paths under /api/meeting-ask. GET config; PUT config {engine,model}.
+/** All paths under /api/meeting-ask. GET config; PUT config {engine,model} and/or {cosSearch} (6.71.1); either part may come alone.
  * POST requests MeetingAskSubmit -> 202 {exchange}; GET requests/:requestId -> {exchange}.
  * POST requests/:requestId/cancel {serverInstanceId} -> {exchange}.
  * GET history?sessionId=...&serverInstanceId=...&offset=0&limit=50&order=asc|desc -> {exchanges,nextOffset,files}.
  * PUT files {sessionId,serverInstanceId,files:MeetingAskFile[]} -> {files}. Upsert only; removed is explicit.
+ * POST files/media {sessionId,serverInstanceId,media:[{id,name?}]} -> {files} (6.71.1, capabilities.phoneFiles):
+ * media already uploaded through /api/media joins the meeting's file list as id "phone_<mediaId>", origin "phone".
  * GET export?sessionId=...&serverInstanceId=... -> {text}; composes persisted Ask/file context,
  * client prepends its current canonical transcript. All operations use X-Cos-Token.
  * GET config is the capability probe (404 means old server); health.capabilities.meetingAsk mirrors capabilities.
  */
+
+/** User-confirmed navigation context for one meeting, never canonical transcript evidence. */
+export type MeetingAskDomain = string;
+export interface MeetingAskCalendarMatch {
+    id: string; title: string; start: string; end: string; suggestedDomain?: MeetingAskDomain;
+}
+export interface MeetingAskOrientation {
+    revision: number; domain: MeetingAskDomain | null; calendar: MeetingAskCalendarMatch | null;
+}
+export interface MeetingAskContext {
+    orientation: MeetingAskOrientation; domains: Array<{id: string; label: string}>; candidates: MeetingAskCalendarMatch[]; notices: string[];
+}