@burtson-labs/bandit-engine 2.1.1 → 2.1.2

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage } from './public-D8UsefSk.mjs';
-export { A as AIChatRequest, c as AIChatResponse, d as AIGenerateRequest, e as AIGenerateResponse, f as AIMessage, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-D8UsefSk.mjs';
+import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage, A as AIMessage } from './public-ByjnoHLe.mjs';
+export { c as AIChatRequest, d as AIChatResponse, e as AIGenerateRequest, f as AIGenerateResponse, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-ByjnoHLe.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { Theme } from '@mui/material/styles';
@@ -1589,4 +1589,294 @@ declare const useVectorStore: () => {
     initializeVectorService: () => Promise<void>;
 };
 
-export { AUTH_TOKEN_CHANGED_EVENT, type AuthSessionConfig, type AuthSessionHandlers, Chat, type CreateMemoryOptions, DebugLogger, FeatureEvaluation, FeatureFlagConfig, FeatureFlagContext, type FeatureFlagContextValue, FeatureFlagProvider, type FeatureFlagProviderProps, FeatureFlagService, FeatureKey, FeedbackButton, type FeedbackButtonProps, type FeedbackCategories, FeedbackModal, type FeedbackModalProps, type FeedbackPriorities, type FeedbackRequest, type FeedbackResponse, type FileUploadResult, type GatewayQueryOptions, InterestsEditor, type JwtClaims, type LogContext, MANAGEMENT_SECTIONS, Management, type ManagementAccess, type ManagementAccessInput, type ManagementLink, type ManagementProps, type ManagementRequest, type ManagementSectionDef, type ManagementSectionId, type MemorySearchFilters, type MigrationProgress, type MigrationStatus, type NotificationConfig, type NotificationContextType, NotificationProvider, type NotificationProviderProps, NotificationService, SYSTEM_FLAGS, type SearchOptions, type SearchResult, StreamingTTSClient, SubscriptionExpiredGuard, type SubscriptionExpiredGuardProps, SubscriptionExpiredModal, type SubscriptionExpiredModalProps, SubscriptionTier, TOKEN_KEY, type TTSOptions, type TTSProgress, TTSState, type TokenPersistence, type TokenStorageMode, TrialUsage, type UploadRequest, type UseTTSReturn, VectorDatabaseService, type VectorDocument, type VectorMemory, type VectorMemoryMetadata, VectorMigrationService, type VectorStoreStatus, type VoiceState, authenticationService, debugLogger, defineCustomElement, featureFlagService, getCriticalConfig, getFeatureMatrix, getStreamingTTSClient, getSystemConstants, getTTSState, handleHttpError, handleSubscriptionUpgrade, handleValidationError, initializeCoreSystem, isWorkspaceAdminRole, notificationService, pauseTTS, previewTierUpgrade, resolveManagementSections, resumeTTS, showInfoNotification, showSuccessNotification, speakStream as speakWithStreaming, stopTTS, syncSubscriptionWithAPI, updateSubscriptionTier, useFeatureFlag, useFeatureVisibility, useFeatures, useGatewayHealth, useGatewayMemory, useGatewayModels, useGlobalTTS, useManagementAccess, useNotification, useNotificationService, useTTS, useVectorStore, useVoiceStore, useVoices, validateEnvironment, validateSystemIntegrity, vectorDatabaseService, vectorMigrationService };
+/**
+ * Meeting transcripts as text: WebVTT (Teams, Zoom, Meet exports), SubRip
+ * (.srt), the plain "Speaker: words" layout most tools paste, and the Teams
+ * .docx layout (timing line, speaker line, text). Everything here is pure and
+ * runs on the main thread; a transcript of a two-hour meeting is a few hundred
+ * kilobytes at most.
+ */
+interface TranscriptSegment {
+    /** Seconds from the start of the recording, when the transcript says. */
+    start?: number;
+    end?: number;
+    speaker?: string;
+    text: string;
+}
+type TranscriptFormat = "vtt" | "srt" | "text";
+interface ParsedTranscript {
+    segments: TranscriptSegment[];
+    /** Distinct speaker labels, in order of first appearance. */
+    speakers: string[];
+    format: TranscriptFormat;
+}
+/** A subtitle/transcript file: only ever a meeting transcript. */
+declare const isTranscriptFileName: (name: string) => boolean;
+/** An audio or video file, by MIME type or by extension when the browser gives none. */
+declare const isRecordingFile: (file: {
+    name: string;
+    type?: string;
+}) => boolean;
+/** A file the composer hands to meeting notes rather than to the model as a document. */
+declare const isMeetingFile: (file: {
+    name: string;
+    type?: string;
+}) => boolean;
+/**
+ * Parse transcript text in whatever layout it arrived. Unparseable input
+ * still yields one segment per paragraph, so notes can be made from any text.
+ */
+declare const parseTranscript: (text: string, fileName?: string) => ParsedTranscript;
+/**
+ * The text the model reads: one line per speaker turn, `[mm:ss] Name: words`.
+ * Consecutive segments by the same speaker merge into a turn so the prompt
+ * carries the words, not one timestamp per subtitle cue.
+ */
+declare const transcriptToText: (segments: TranscriptSegment[]) => string;
+/**
+ * Whether pasted text reads like a meeting transcript: a WebVTT header, cue
+ * timings, or a run of `Name:` turns from at least two speakers.
+ */
+declare const looksLikeTranscript: (text: string) => boolean;
+
+/**
+ * Structured notes from a transcript, and their Markdown and HTML renderings.
+ *
+ * The model is asked for one JSON object. A transcript longer than one
+ * request's worth is split on line boundaries; each part yields partial notes
+ * and a second pass merges them (map-reduce), so an hour-long meeting fits a
+ * model with a modest context window. Nothing here knows which model answers:
+ * the caller passes a `chat` function, which the chat uses to route through
+ * the engine's normal provider.
+ */
+interface ActionItem {
+    task: string;
+    owner?: string;
+    due?: string;
+}
+interface MeetingNotes {
+    title: string;
+    /** The meeting's date as the transcript states it (ISO when possible). */
+    date?: string;
+    attendees: string[];
+    summary: string;
+    decisions: string[];
+    actionItems: ActionItem[];
+    openQuestions: string[];
+}
+interface NotesMeta {
+    /** The uploaded file or pasted source. */
+    sourceName?: string;
+    durationSeconds?: number;
+    wordCount?: number;
+    /** True when Bandit transcribed a recording (no speaker labels available). */
+    transcribed?: boolean;
+    /** When the notes were made. */
+    createdAt?: Date;
+}
+type ChatFn = (messages: AIMessage[], options: {
+    maxTokens: number;
+}) => Promise<string>;
+interface NotesHints {
+    fileName?: string;
+    speakers?: string[];
+    transcribed?: boolean;
+    /** What the person typed alongside the upload, if anything. */
+    note?: string;
+}
+/** Split on line boundaries so no speaker turn is cut in half. */
+declare const chunkTranscript: (text: string, maxChars?: number) => string[];
+/** Parse the model's answer into notes, tolerating fences, prose and trailing commas. */
+declare const parseNotesJson: (raw: string) => MeetingNotes | null;
+interface GenerateNotesOptions {
+    chat: ChatFn;
+    hints?: NotesHints;
+    onProgress?: (progress: {
+        done: number;
+        total: number;
+    }) => void;
+    chunkChars?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Notes for a whole transcript. Short transcripts take one request; long ones
+ * are summarized part by part and merged (in rounds, if there are many parts).
+ */
+declare const generateMeetingNotes: (transcript: string, options: GenerateNotesOptions) => Promise<MeetingNotes>;
+/** The notes as the chat shows them. */
+declare const notesToMarkdown: (notes: MeetingNotes, meta?: NotesMeta) => string;
+/**
+ * The notes as a self-contained page for Stash, so a share link opens a
+ * readable document rather than raw Markdown. No scripts, no remote assets.
+ */
+declare const notesToHtml: (notes: MeetingNotes, meta?: NotesMeta) => string;
+
+/** Nominal chunk length. Whisper on CPU transcribes about one second per second. */
+declare const CHUNK_SECONDS = 45;
+/** Upload cap for one recording. Compressed speech at 64 kbit/s is 28 MB an hour. */
+declare const MAX_RECORDING_BYTES: number;
+/**
+ * Decoded audio is held in memory as 32-bit floats (16 kHz mono is 3.84 MB a
+ * minute, plus the browser's own decode buffer at the file's native rate).
+ * Half an hour keeps that well inside what a desktop tab can allocate.
+ */
+declare const MAX_RECORDING_SECONDS: number;
+/** Decodes a container (mp3, m4a, mp4, webm, wav...) into per-channel PCM. */
+type AudioDecoder = (data: ArrayBuffer) => Promise<{
+    sampleRate: number;
+    channels: Float32Array[];
+}>;
+
+type TranscribeChunk = (blob: Blob, signal?: AbortSignal) => Promise<string>;
+interface TranscribeProgress {
+    done: number;
+    total: number;
+}
+interface TranscribeRecordingOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: TranscribeProgress) => void;
+    concurrency?: number;
+    /** Test seams: the speech-to-text call and the audio decoder. */
+    transcribeChunk?: TranscribeChunk;
+    decode?: AudioDecoder;
+}
+interface RecordingTranscript {
+    segments: TranscriptSegment[];
+    durationSeconds: number;
+    chunkCount: number;
+}
+declare class SpeechToTextError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/**
+ * Transcribe a recording: decode it in the browser, cut it into chunks, send
+ * each through speech-to-text, and stitch the text back together with the
+ * chunk's time offsets. Speaker labels are not produced (Whisper does not
+ * separate speakers); the notes say so.
+ */
+declare const transcribeRecording: (file: Blob, options?: TranscribeRecordingOptions) => Promise<RecordingTranscript>;
+
+/**
+ * The whole meeting-notes turn: read or transcribe the source, write the
+ * notes through the chat's model, render them, and file them in Stash with a
+ * share link. The chat calls this in place of a model turn and shows progress
+ * in the reply while it runs.
+ */
+type MeetingNotesInput = {
+    kind: "file";
+    file: File;
+    note?: string;
+} | {
+    kind: "text";
+    text: string;
+    sourceName?: string;
+    note?: string;
+};
+type MeetingNotesStage = "reading" | "transcribing" | "summarizing" | "saving";
+interface MeetingNotesProgress {
+    stage: MeetingNotesStage;
+    /** Short status for the chip under the reply, e.g. "Transcribing 3 of 12". */
+    label: string;
+    done?: number;
+    total?: number;
+}
+interface MeetingNotesSource {
+    name?: string;
+    durationSeconds?: number;
+    wordCount: number;
+    /** True when Bandit transcribed a recording. */
+    transcribed: boolean;
+    speakers: string[];
+}
+interface MeetingNotesResult {
+    notes: MeetingNotes;
+    /** The reply for the chat: the notes plus a Stash footer. */
+    markdown: string;
+    html: string;
+    transcriptText: string;
+    source: MeetingNotesSource;
+    stash?: {
+        key: string;
+        shareUrl?: string;
+        expiresAt?: string;
+    };
+    /** Why the notes could not be filed, when they couldn't; the notes still exist. */
+    stashError?: string;
+}
+interface RunMeetingNotesOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: MeetingNotesProgress) => void;
+    /** Whether to file the notes in Stash (default: when Stash is reachable). */
+    save?: boolean;
+    /** Test seams. */
+    chat?: ChatFn;
+    transcribeChunk?: TranscribeChunk;
+    decode?: AudioDecoder;
+    now?: () => Date;
+}
+/** A failure the person can act on, phrased for the chat. */
+declare class MeetingNotesError extends Error {
+    constructor(message: string);
+}
+/** The user-facing line for a failed run. */
+declare const meetingNotesErrorMessage: (error: unknown) => string;
+/** What the transcript shows as the person's message for this turn. */
+declare const describeMeetingInput: (input: MeetingNotesInput) => string;
+/**
+ * Make meeting notes from a recording, a transcript file or pasted text.
+ * Rejects with an `AbortError` when `signal` fires, a {@link MeetingNotesError}
+ * for anything the person can act on, and the underlying error otherwise.
+ */
+declare const runMeetingNotes: (input: MeetingNotesInput, options?: RunMeetingNotesOptions) => Promise<MeetingNotesResult>;
+
+/**
+ * Bandit Stash: the shareable documents a signed-in person keeps (S3Api's
+ * `/api/artifact` routes). The base URL is the host's `fileStorageApiUrl`
+ * package setting (the S3Api base including `/api`, the same one knowledge
+ * uploads use); a host without it has no Stash and callers stay quiet about it.
+ *
+ * Writes go under a per-owner prefix the server derives from the token, so a
+ * document is private to the person (or to their team with `scope: "team"`).
+ * A share link is a separate, expiring, revocable token minted on request.
+ */
+interface StashSaveResult {
+    key: string;
+    /** The owner's own URL for the object (needs the session token). */
+    url?: string;
+    size?: number;
+}
+interface StashShareLink {
+    url: string;
+    token?: string;
+    expiresAt?: string;
+}
+declare class StashError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/** True when there is a Stash to write to and a session to write as. */
+declare const stashAvailable: () => boolean;
+/**
+ * Save a document to Stash. The server names the object after `name` (a
+ * sanitized copy after an unguessable id), so the Stash page shows a real name.
+ */
+declare const saveToStash: (args: {
+    name: string;
+    content: string | Blob;
+    contentType: string;
+    scope?: "private" | "team";
+    signal?: AbortSignal;
+}) => Promise<StashSaveResult>;
+/**
+ * Mint a share link for one of the caller's Stash documents. Anyone with the
+ * link can read it until it expires (the server's default, seven days, unless
+ * `expiryMinutes` says otherwise) or the owner revokes it in Stash.
+ */
+declare const createStashShareLink: (args: {
+    key: string;
+    expiryMinutes?: number;
+    signal?: AbortSignal;
+}) => Promise<StashShareLink>;
+
+export { AIMessage, AUTH_TOKEN_CHANGED_EVENT, type ActionItem, type AuthSessionConfig, type AuthSessionHandlers, Chat, type CreateMemoryOptions, DebugLogger, FeatureEvaluation, FeatureFlagConfig, FeatureFlagContext, type FeatureFlagContextValue, FeatureFlagProvider, type FeatureFlagProviderProps, FeatureFlagService, FeatureKey, FeedbackButton, type FeedbackButtonProps, type FeedbackCategories, FeedbackModal, type FeedbackModalProps, type FeedbackPriorities, type FeedbackRequest, type FeedbackResponse, type FileUploadResult, type GatewayQueryOptions, InterestsEditor, type JwtClaims, type LogContext, MANAGEMENT_SECTIONS, MAX_RECORDING_BYTES, MAX_RECORDING_SECONDS, Management, type ManagementAccess, type ManagementAccessInput, type ManagementLink, type ManagementProps, type ManagementRequest, type ManagementSectionDef, type ManagementSectionId, type MeetingNotes, type ChatFn as MeetingNotesChatFn, MeetingNotesError, type MeetingNotesInput, type MeetingNotesProgress, type MeetingNotesResult, type MeetingNotesSource, type MeetingNotesStage, type MemorySearchFilters, type MigrationProgress, type MigrationStatus, type NotesMeta, type NotificationConfig, type NotificationContextType, NotificationProvider, type NotificationProviderProps, NotificationService, type ParsedTranscript, CHUNK_SECONDS as RECORDING_CHUNK_SECONDS, type RecordingTranscript, type RunMeetingNotesOptions, SYSTEM_FLAGS, type SearchOptions, type SearchResult, SpeechToTextError, StashError, type StashSaveResult, type StashShareLink, StreamingTTSClient, SubscriptionExpiredGuard, type SubscriptionExpiredGuardProps, SubscriptionExpiredModal, type SubscriptionExpiredModalProps, SubscriptionTier, TOKEN_KEY, type TTSOptions, type TTSProgress, TTSState, type TokenPersistence, type TokenStorageMode, type TranscriptFormat, type TranscriptSegment, TrialUsage, type UploadRequest, type UseTTSReturn, VectorDatabaseService, type VectorDocument, type VectorMemory, type VectorMemoryMetadata, VectorMigrationService, type VectorStoreStatus, type VoiceState, authenticationService, chunkTranscript, createStashShareLink, debugLogger, defineCustomElement, describeMeetingInput, featureFlagService, generateMeetingNotes, getCriticalConfig, getFeatureMatrix, getStreamingTTSClient, getSystemConstants, getTTSState, handleHttpError, handleSubscriptionUpgrade, handleValidationError, initializeCoreSystem, isMeetingFile, isRecordingFile, isTranscriptFileName, isWorkspaceAdminRole, looksLikeTranscript, meetingNotesErrorMessage, notesToHtml, notesToMarkdown, notificationService, parseNotesJson, parseTranscript, pauseTTS, previewTierUpgrade, resolveManagementSections, resumeTTS, runMeetingNotes, saveToStash, showInfoNotification, showSuccessNotification, speakStream as speakWithStreaming, stashAvailable, stopTTS, syncSubscriptionWithAPI, transcribeRecording, transcriptToText, updateSubscriptionTier, useFeatureFlag, useFeatureVisibility, useFeatures, useGatewayHealth, useGatewayMemory, useGatewayModels, useGlobalTTS, useManagementAccess, useNotification, useNotificationService, useTTS, useVectorStore, useVoiceStore, useVoices, validateEnvironment, validateSystemIntegrity, vectorDatabaseService, vectorMigrationService };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage } from './public-D8UsefSk.js';
-export { A as AIChatRequest, c as AIChatResponse, d as AIGenerateRequest, e as AIGenerateResponse, f as AIMessage, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-D8UsefSk.js';
+import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage, A as AIMessage } from './public-ByjnoHLe.js';
+export { c as AIChatRequest, d as AIChatResponse, e as AIGenerateRequest, f as AIGenerateResponse, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-ByjnoHLe.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { Theme } from '@mui/material/styles';
@@ -1589,4 +1589,294 @@ declare const useVectorStore: () => {
     initializeVectorService: () => Promise<void>;
 };
 
-export { AUTH_TOKEN_CHANGED_EVENT, type AuthSessionConfig, type AuthSessionHandlers, Chat, type CreateMemoryOptions, DebugLogger, FeatureEvaluation, FeatureFlagConfig, FeatureFlagContext, type FeatureFlagContextValue, FeatureFlagProvider, type FeatureFlagProviderProps, FeatureFlagService, FeatureKey, FeedbackButton, type FeedbackButtonProps, type FeedbackCategories, FeedbackModal, type FeedbackModalProps, type FeedbackPriorities, type FeedbackRequest, type FeedbackResponse, type FileUploadResult, type GatewayQueryOptions, InterestsEditor, type JwtClaims, type LogContext, MANAGEMENT_SECTIONS, Management, type ManagementAccess, type ManagementAccessInput, type ManagementLink, type ManagementProps, type ManagementRequest, type ManagementSectionDef, type ManagementSectionId, type MemorySearchFilters, type MigrationProgress, type MigrationStatus, type NotificationConfig, type NotificationContextType, NotificationProvider, type NotificationProviderProps, NotificationService, SYSTEM_FLAGS, type SearchOptions, type SearchResult, StreamingTTSClient, SubscriptionExpiredGuard, type SubscriptionExpiredGuardProps, SubscriptionExpiredModal, type SubscriptionExpiredModalProps, SubscriptionTier, TOKEN_KEY, type TTSOptions, type TTSProgress, TTSState, type TokenPersistence, type TokenStorageMode, TrialUsage, type UploadRequest, type UseTTSReturn, VectorDatabaseService, type VectorDocument, type VectorMemory, type VectorMemoryMetadata, VectorMigrationService, type VectorStoreStatus, type VoiceState, authenticationService, debugLogger, defineCustomElement, featureFlagService, getCriticalConfig, getFeatureMatrix, getStreamingTTSClient, getSystemConstants, getTTSState, handleHttpError, handleSubscriptionUpgrade, handleValidationError, initializeCoreSystem, isWorkspaceAdminRole, notificationService, pauseTTS, previewTierUpgrade, resolveManagementSections, resumeTTS, showInfoNotification, showSuccessNotification, speakStream as speakWithStreaming, stopTTS, syncSubscriptionWithAPI, updateSubscriptionTier, useFeatureFlag, useFeatureVisibility, useFeatures, useGatewayHealth, useGatewayMemory, useGatewayModels, useGlobalTTS, useManagementAccess, useNotification, useNotificationService, useTTS, useVectorStore, useVoiceStore, useVoices, validateEnvironment, validateSystemIntegrity, vectorDatabaseService, vectorMigrationService };
+/**
+ * Meeting transcripts as text: WebVTT (Teams, Zoom, Meet exports), SubRip
+ * (.srt), the plain "Speaker: words" layout most tools paste, and the Teams
+ * .docx layout (timing line, speaker line, text). Everything here is pure and
+ * runs on the main thread; a transcript of a two-hour meeting is a few hundred
+ * kilobytes at most.
+ */
+interface TranscriptSegment {
+    /** Seconds from the start of the recording, when the transcript says. */
+    start?: number;
+    end?: number;
+    speaker?: string;
+    text: string;
+}
+type TranscriptFormat = "vtt" | "srt" | "text";
+interface ParsedTranscript {
+    segments: TranscriptSegment[];
+    /** Distinct speaker labels, in order of first appearance. */
+    speakers: string[];
+    format: TranscriptFormat;
+}
+/** A subtitle/transcript file: only ever a meeting transcript. */
+declare const isTranscriptFileName: (name: string) => boolean;
+/** An audio or video file, by MIME type or by extension when the browser gives none. */
+declare const isRecordingFile: (file: {
+    name: string;
+    type?: string;
+}) => boolean;
+/** A file the composer hands to meeting notes rather than to the model as a document. */
+declare const isMeetingFile: (file: {
+    name: string;
+    type?: string;
+}) => boolean;
+/**
+ * Parse transcript text in whatever layout it arrived. Unparseable input
+ * still yields one segment per paragraph, so notes can be made from any text.
+ */
+declare const parseTranscript: (text: string, fileName?: string) => ParsedTranscript;
+/**
+ * The text the model reads: one line per speaker turn, `[mm:ss] Name: words`.
+ * Consecutive segments by the same speaker merge into a turn so the prompt
+ * carries the words, not one timestamp per subtitle cue.
+ */
+declare const transcriptToText: (segments: TranscriptSegment[]) => string;
+/**
+ * Whether pasted text reads like a meeting transcript: a WebVTT header, cue
+ * timings, or a run of `Name:` turns from at least two speakers.
+ */
+declare const looksLikeTranscript: (text: string) => boolean;
+
+/**
+ * Structured notes from a transcript, and their Markdown and HTML renderings.
+ *
+ * The model is asked for one JSON object. A transcript longer than one
+ * request's worth is split on line boundaries; each part yields partial notes
+ * and a second pass merges them (map-reduce), so an hour-long meeting fits a
+ * model with a modest context window. Nothing here knows which model answers:
+ * the caller passes a `chat` function, which the chat uses to route through
+ * the engine's normal provider.
+ */
+interface ActionItem {
+    task: string;
+    owner?: string;
+    due?: string;
+}
+interface MeetingNotes {
+    title: string;
+    /** The meeting's date as the transcript states it (ISO when possible). */
+    date?: string;
+    attendees: string[];
+    summary: string;
+    decisions: string[];
+    actionItems: ActionItem[];
+    openQuestions: string[];
+}
+interface NotesMeta {
+    /** The uploaded file or pasted source. */
+    sourceName?: string;
+    durationSeconds?: number;
+    wordCount?: number;
+    /** True when Bandit transcribed a recording (no speaker labels available). */
+    transcribed?: boolean;
+    /** When the notes were made. */
+    createdAt?: Date;
+}
+type ChatFn = (messages: AIMessage[], options: {
+    maxTokens: number;
+}) => Promise<string>;
+interface NotesHints {
+    fileName?: string;
+    speakers?: string[];
+    transcribed?: boolean;
+    /** What the person typed alongside the upload, if anything. */
+    note?: string;
+}
+/** Split on line boundaries so no speaker turn is cut in half. */
+declare const chunkTranscript: (text: string, maxChars?: number) => string[];
+/** Parse the model's answer into notes, tolerating fences, prose and trailing commas. */
+declare const parseNotesJson: (raw: string) => MeetingNotes | null;
+interface GenerateNotesOptions {
+    chat: ChatFn;
+    hints?: NotesHints;
+    onProgress?: (progress: {
+        done: number;
+        total: number;
+    }) => void;
+    chunkChars?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Notes for a whole transcript. Short transcripts take one request; long ones
+ * are summarized part by part and merged (in rounds, if there are many parts).
+ */
+declare const generateMeetingNotes: (transcript: string, options: GenerateNotesOptions) => Promise<MeetingNotes>;
+/** The notes as the chat shows them. */
+declare const notesToMarkdown: (notes: MeetingNotes, meta?: NotesMeta) => string;
+/**
+ * The notes as a self-contained page for Stash, so a share link opens a
+ * readable document rather than raw Markdown. No scripts, no remote assets.
+ */
+declare const notesToHtml: (notes: MeetingNotes, meta?: NotesMeta) => string;
+
+/** Nominal chunk length. Whisper on CPU transcribes about one second per second. */
+declare const CHUNK_SECONDS = 45;
+/** Upload cap for one recording. Compressed speech at 64 kbit/s is 28 MB an hour. */
+declare const MAX_RECORDING_BYTES: number;
+/**
+ * Decoded audio is held in memory as 32-bit floats (16 kHz mono is 3.84 MB a
+ * minute, plus the browser's own decode buffer at the file's native rate).
+ * Half an hour keeps that well inside what a desktop tab can allocate.
+ */
+declare const MAX_RECORDING_SECONDS: number;
+/** Decodes a container (mp3, m4a, mp4, webm, wav...) into per-channel PCM. */
+type AudioDecoder = (data: ArrayBuffer) => Promise<{
+    sampleRate: number;
+    channels: Float32Array[];
+}>;
+
+type TranscribeChunk = (blob: Blob, signal?: AbortSignal) => Promise<string>;
+interface TranscribeProgress {
+    done: number;
+    total: number;
+}
+interface TranscribeRecordingOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: TranscribeProgress) => void;
+    concurrency?: number;
+    /** Test seams: the speech-to-text call and the audio decoder. */
+    transcribeChunk?: TranscribeChunk;
+    decode?: AudioDecoder;
+}
+interface RecordingTranscript {
+    segments: TranscriptSegment[];
+    durationSeconds: number;
+    chunkCount: number;
+}
+declare class SpeechToTextError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/**
+ * Transcribe a recording: decode it in the browser, cut it into chunks, send
+ * each through speech-to-text, and stitch the text back together with the
+ * chunk's time offsets. Speaker labels are not produced (Whisper does not
+ * separate speakers); the notes say so.
+ */
+declare const transcribeRecording: (file: Blob, options?: TranscribeRecordingOptions) => Promise<RecordingTranscript>;
+
+/**
+ * The whole meeting-notes turn: read or transcribe the source, write the
+ * notes through the chat's model, render them, and file them in Stash with a
+ * share link. The chat calls this in place of a model turn and shows progress
+ * in the reply while it runs.
+ */
+type MeetingNotesInput = {
+    kind: "file";
+    file: File;
+    note?: string;
+} | {
+    kind: "text";
+    text: string;
+    sourceName?: string;
+    note?: string;
+};
+type MeetingNotesStage = "reading" | "transcribing" | "summarizing" | "saving";
+interface MeetingNotesProgress {
+    stage: MeetingNotesStage;
+    /** Short status for the chip under the reply, e.g. "Transcribing 3 of 12". */
+    label: string;
+    done?: number;
+    total?: number;
+}
+interface MeetingNotesSource {
+    name?: string;
+    durationSeconds?: number;
+    wordCount: number;
+    /** True when Bandit transcribed a recording. */
+    transcribed: boolean;
+    speakers: string[];
+}
+interface MeetingNotesResult {
+    notes: MeetingNotes;
+    /** The reply for the chat: the notes plus a Stash footer. */
+    markdown: string;
+    html: string;
+    transcriptText: string;
+    source: MeetingNotesSource;
+    stash?: {
+        key: string;
+        shareUrl?: string;
+        expiresAt?: string;
+    };
+    /** Why the notes could not be filed, when they couldn't; the notes still exist. */
+    stashError?: string;
+}
+interface RunMeetingNotesOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: MeetingNotesProgress) => void;
+    /** Whether to file the notes in Stash (default: when Stash is reachable). */
+    save?: boolean;
+    /** Test seams. */
+    chat?: ChatFn;
+    transcribeChunk?: TranscribeChunk;
+    decode?: AudioDecoder;
+    now?: () => Date;
+}
+/** A failure the person can act on, phrased for the chat. */
+declare class MeetingNotesError extends Error {
+    constructor(message: string);
+}
+/** The user-facing line for a failed run. */
+declare const meetingNotesErrorMessage: (error: unknown) => string;
+/** What the transcript shows as the person's message for this turn. */
+declare const describeMeetingInput: (input: MeetingNotesInput) => string;
+/**
+ * Make meeting notes from a recording, a transcript file or pasted text.
+ * Rejects with an `AbortError` when `signal` fires, a {@link MeetingNotesError}
+ * for anything the person can act on, and the underlying error otherwise.
+ */
+declare const runMeetingNotes: (input: MeetingNotesInput, options?: RunMeetingNotesOptions) => Promise<MeetingNotesResult>;
+
+/**
+ * Bandit Stash: the shareable documents a signed-in person keeps (S3Api's
+ * `/api/artifact` routes). The base URL is the host's `fileStorageApiUrl`
+ * package setting (the S3Api base including `/api`, the same one knowledge
+ * uploads use); a host without it has no Stash and callers stay quiet about it.
+ *
+ * Writes go under a per-owner prefix the server derives from the token, so a
+ * document is private to the person (or to their team with `scope: "team"`).
+ * A share link is a separate, expiring, revocable token minted on request.
+ */
+interface StashSaveResult {
+    key: string;
+    /** The owner's own URL for the object (needs the session token). */
+    url?: string;
+    size?: number;
+}
+interface StashShareLink {
+    url: string;
+    token?: string;
+    expiresAt?: string;
+}
+declare class StashError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/** True when there is a Stash to write to and a session to write as. */
+declare const stashAvailable: () => boolean;
+/**
+ * Save a document to Stash. The server names the object after `name` (a
+ * sanitized copy after an unguessable id), so the Stash page shows a real name.
+ */
+declare const saveToStash: (args: {
+    name: string;
+    content: string | Blob;
+    contentType: string;
+    scope?: "private" | "team";
+    signal?: AbortSignal;
+}) => Promise<StashSaveResult>;
+/**
+ * Mint a share link for one of the caller's Stash documents. Anyone with the
+ * link can read it until it expires (the server's default, seven days, unless
+ * `expiryMinutes` says otherwise) or the owner revokes it in Stash.
+ */
+declare const createStashShareLink: (args: {
+    key: string;
+    expiryMinutes?: number;
+    signal?: AbortSignal;
+}) => Promise<StashShareLink>;
+
+export { AIMessage, AUTH_TOKEN_CHANGED_EVENT, type ActionItem, type AuthSessionConfig, type AuthSessionHandlers, Chat, type CreateMemoryOptions, DebugLogger, FeatureEvaluation, FeatureFlagConfig, FeatureFlagContext, type FeatureFlagContextValue, FeatureFlagProvider, type FeatureFlagProviderProps, FeatureFlagService, FeatureKey, FeedbackButton, type FeedbackButtonProps, type FeedbackCategories, FeedbackModal, type FeedbackModalProps, type FeedbackPriorities, type FeedbackRequest, type FeedbackResponse, type FileUploadResult, type GatewayQueryOptions, InterestsEditor, type JwtClaims, type LogContext, MANAGEMENT_SECTIONS, MAX_RECORDING_BYTES, MAX_RECORDING_SECONDS, Management, type ManagementAccess, type ManagementAccessInput, type ManagementLink, type ManagementProps, type ManagementRequest, type ManagementSectionDef, type ManagementSectionId, type MeetingNotes, type ChatFn as MeetingNotesChatFn, MeetingNotesError, type MeetingNotesInput, type MeetingNotesProgress, type MeetingNotesResult, type MeetingNotesSource, type MeetingNotesStage, type MemorySearchFilters, type MigrationProgress, type MigrationStatus, type NotesMeta, type NotificationConfig, type NotificationContextType, NotificationProvider, type NotificationProviderProps, NotificationService, type ParsedTranscript, CHUNK_SECONDS as RECORDING_CHUNK_SECONDS, type RecordingTranscript, type RunMeetingNotesOptions, SYSTEM_FLAGS, type SearchOptions, type SearchResult, SpeechToTextError, StashError, type StashSaveResult, type StashShareLink, StreamingTTSClient, SubscriptionExpiredGuard, type SubscriptionExpiredGuardProps, SubscriptionExpiredModal, type SubscriptionExpiredModalProps, SubscriptionTier, TOKEN_KEY, type TTSOptions, type TTSProgress, TTSState, type TokenPersistence, type TokenStorageMode, type TranscriptFormat, type TranscriptSegment, TrialUsage, type UploadRequest, type UseTTSReturn, VectorDatabaseService, type VectorDocument, type VectorMemory, type VectorMemoryMetadata, VectorMigrationService, type VectorStoreStatus, type VoiceState, authenticationService, chunkTranscript, createStashShareLink, debugLogger, defineCustomElement, describeMeetingInput, featureFlagService, generateMeetingNotes, getCriticalConfig, getFeatureMatrix, getStreamingTTSClient, getSystemConstants, getTTSState, handleHttpError, handleSubscriptionUpgrade, handleValidationError, initializeCoreSystem, isMeetingFile, isRecordingFile, isTranscriptFileName, isWorkspaceAdminRole, looksLikeTranscript, meetingNotesErrorMessage, notesToHtml, notesToMarkdown, notificationService, parseNotesJson, parseTranscript, pauseTTS, previewTierUpgrade, resolveManagementSections, resumeTTS, runMeetingNotes, saveToStash, showInfoNotification, showSuccessNotification, speakStream as speakWithStreaming, stashAvailable, stopTTS, syncSubscriptionWithAPI, transcribeRecording, transcriptToText, updateSubscriptionTier, useFeatureFlag, useFeatureVisibility, useFeatures, useGatewayHealth, useGatewayMemory, useGatewayModels, useGlobalTTS, useManagementAccess, useNotification, useNotificationService, useTTS, useVectorStore, useVoiceStore, useVoices, validateEnvironment, validateSystemIntegrity, vectorDatabaseService, vectorMigrationService };