@burtson-labs/bandit-engine 2.1.7 → 2.1.8

package/dist/chunk-Y272M3D5.mjs

@@ -0,0 +1,28 @@
+// src/services/ai-provider/context-sources.ts
+var MAX_LABEL = 120;
+var clean = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  return trimmed.length > MAX_LABEL ? `${trimmed.slice(0, MAX_LABEL - 1)}\u2026` : trimmed;
+};
+var readContextSourcesField = (chunk) => {
+  if (!chunk || typeof chunk !== "object") return void 0;
+  const record = chunk;
+  const raw = record.context_sources ?? record.contextSources;
+  if (!Array.isArray(raw)) return void 0;
+  const out = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object") continue;
+    const label = clean(entry.label);
+    if (!label) continue;
+    const detail = clean(entry.detail);
+    out.push(detail ? { label, detail } : { label });
+  }
+  return out.length ? out : void 0;
+};
+
+export {
+  readContextSourcesField
+};
+//# sourceMappingURL=chunk-Y272M3D5.mjs.map

package/dist/chunk-Y272M3D5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/ai-provider/context-sources.ts"],"mappings":";AAQA,IAAM,YAAY;AAElB,IAAM,QAAQ,CAAC,UAAuC;AACpD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,QAAQ,SAAS,YAAY,GAAG,QAAQ,MAAM,GAAG,YAAY,CAAC,CAAC,WAAM;AAC9E;AAMO,IAAM,0BAA0B,CACrC,UACkC;AAClC,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,SAAS;AACf,QAAM,MAAM,OAAO,mBAAmB,OAAO;AAC7C,MAAI,CAAC,MAAM,QAAQ,GAAG,EAAG,QAAO;AAChC,QAAM,MAAyB,CAAC;AAChC,aAAW,SAAS,KAAK;AACvB,QAAI,CAAC,SAAS,OAAO,UAAU,SAAU;AACzC,UAAM,QAAQ,MAAO,MAAkC,KAAK;AAC5D,QAAI,CAAC,MAAO;AACZ,UAAM,SAAS,MAAO,MAAkC,MAAM;AAC9D,QAAI,KAAK,SAAS,EAAE,OAAO,OAAO,IAAI,EAAE,MAAM,CAAC;AAAA,EACjD;AACA,SAAO,IAAI,SAAS,MAAM;AAC5B;","names":[]}

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, A as AIMessage } from './public-Tq2Pmw9m.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, E as EngineNavigation, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, m as SidebarLayout, n as SidebarSection, V as VoiceModelsResponse, o as VoiceService, v as voiceService } from './public-Tq2Pmw9m.mjs';
+import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage, A as AIMessage } from './public-_W_Zew3C.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, E as EngineNavigation, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, m as SidebarLayout, n as SidebarSection, V as VoiceModelsResponse, o as VoiceService, v as voiceService } from './public-_W_Zew3C.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { Theme } from '@mui/material/styles';
@@ -13,8 +13,8 @@ import { AlertColor } from '@mui/material';
 
 declare const Chat: () => react_jsx_runtime.JSX.Element | null;
 
-/** Every Management section that exists. Order is the sidebar order. */
-type ManagementSectionId = "overview" | "personalities" | "knowledge" | "tools" | "provider" | "storage" | "branding" | "schedules" | "preferences";
+/** Every Management section that exists, on either console. */
+type ManagementSectionId = "overview" | "personalization" | "personalities" | "instructions" | "knowledge" | "tools" | "crew" | "provider" | "advanced" | "storage" | "branding" | "schedules" | "preferences";
 type FeatureGate = "limitedAdminDashboard" | "advancedSearch";
 /**
  * Where a section sits in the rail: the overview on its own at the top, the
@@ -35,8 +35,9 @@ interface ManagementSectionDef {
     group: ManagementSectionGroup;
 }
 /**
- * The sections as the native shells still show them (labels and order). The
- * web console's wording and order are applied by presentManagementSections.
+ * Every section, in the native shells' order. Sections only one console has
+ * (see WEB_ONLY / NATIVE_ONLY) are filtered by presentManagementSections; the
+ * web's own wording and order are applied there too.
  */
 declare const MANAGEMENT_SECTIONS: readonly ManagementSectionDef[];
 interface ManagementAccessInput {
@@ -50,7 +51,7 @@ interface ManagementAccessInput {
  * per-tenant admin. AuthApi's TeamService grants tenant owners/admins a role of
  * the form "<slug>-admin", so any role ending in "-admin" is a tenant admin.
  * super-user is NOT an admin: it's the trial/power-user role, so trial and
- * consumer users see only Schedules and Preferences.
+ * consumer users see only their own pages (Preferences, Personalization, Schedules).
  */
 declare function isWorkspaceAdminRole(roles: string[]): boolean;
 /** Which sections this user can open: role first, then plan features. Pure, for tests and hosts. */
@@ -60,6 +61,8 @@ interface ManagementAccess {
     isWorkspaceAdmin: boolean;
     /** Admin-dashboard users limited to the lighter feature set. */
     isLimitedAdmin: boolean;
+    /** Pro/Team plan: the model provider page (inside Advanced on the web). */
+    hasAdvancedSearch: boolean;
 }
 /**
  * The signed-in user's Management access, presented for this console (web or
@@ -124,6 +127,116 @@ interface InterestsEditorProps {
  */
 declare const InterestsEditor: ({ title, description, }: InterestsEditorProps) => react_jsx_runtime.JSX.Element;
 
+interface MemoryManagerProps {
+    /**
+     * "sheet": the body of the Memories modal (chat surfaces, a close button, a
+     * fixed height). "page": the Settings page — searchable, and it grows with
+     * its list instead of scrolling inside a box.
+     */
+    variant: "sheet" | "page";
+    /** On screen; memories load when this becomes true. The sheet passes its `open`. */
+    active?: boolean;
+    /** The sheet's close button. */
+    onClose?: () => void;
+}
+/**
+ * What Bandit remembers: the memories you told it and the ones it noted
+ * itself, local to this browser or synced to your account. Add, edit, pin,
+ * delete, select several, clear by kind, and move local memories to the
+ * synced workspace. The Memories modal and the Personalization page both
+ * render this.
+ */
+declare const MemoryManager: React.FC<MemoryManagerProps>;
+
+interface BanditPersonality {
+    name: string;
+    tagline: string;
+    systemPrompt: string;
+    commands: string[];
+    avatarBase64?: string | null;
+    avatarPreset?: string;
+}
+
+interface CustomInstructions {
+    /** "What should Bandit know about you?" */
+    about: string;
+    /** "How would you like Bandit to respond?" */
+    responseStyle: string;
+}
+/** Character limits for new text. Migrated text longer than this is kept; it can only be shortened. */
+declare const CUSTOM_INSTRUCTIONS_LIMITS: {
+    readonly about: 1500;
+    readonly responseStyle: 1500;
+};
+declare const ASSISTANT_INSTRUCTIONS_LIMIT = 4000;
+/** Bandit's own voice: what answers when nobody has written instructions. */
+declare const DEFAULT_ASSISTANT_INSTRUCTIONS: string;
+declare const MIGRATIONS_RECORD_ID = "migrations";
+/** One-time data moves, by name, with when they ran. */
+interface MigrationsRecord {
+    id: typeof MIGRATIONS_RECORD_ID;
+    /** The customized active personality was copied into Custom instructions. */
+    customInstructionsFromPersonality?: {
+        at: number;
+        from: string | null;
+    };
+}
+interface PersonaPromptInput {
+    /** The workspace's Assistant instructions; empty when none were written. */
+    assistant: string;
+    custom: CustomInstructions;
+    /**
+     * The active personality's prompt (the pre-Phase-3 key), read for one more
+     * release so a workspace that has written nothing new keeps its voice.
+     */
+    legacyPersonalityPrompt?: string | null;
+}
+/**
+ * The PERSONA block's text. Assistant instructions come first; when the
+ * workspace wrote none, Bandit's default voice (or the legacy personality
+ * prompt) stands in — unless the person wrote Custom instructions, which then
+ * replace the default voice rather than compete with it. The person's two
+ * fields follow, labelled, so the model knows which is which.
+ */
+declare function composePersonaPrompt(input: PersonaPromptInput): string;
+interface PersonalityMigrationInput {
+    /** The personality that answers chats today, if the model store has one. */
+    active: Pick<BanditPersonality, "name" | "systemPrompt"> | null | undefined;
+    /** What the person has already written; never overwritten. */
+    existing: CustomInstructions;
+}
+/**
+ * Decides whether the active personality's prompt should seed Custom
+ * instructions: only when it was customized (differs from Bandit's default
+ * voice) and the person has not written a response style of their own.
+ * Returns the field to write, or null for nothing to do.
+ */
+declare function planPersonalityMigration(input: PersonalityMigrationInput): {
+    responseStyle: string;
+} | null;
+type InstructionsSaveState = "idle" | "saving" | "saved" | "error";
+type PersonalityMigrationOutcome = "migrated" | "nothing-to-migrate" | "already-done" | "not-ready";
+interface InstructionsStore {
+    custom: CustomInstructions;
+    assistant: string;
+    hydrated: boolean;
+    migration: MigrationsRecord["customInstructionsFromPersonality"] | null;
+    saveState: InstructionsSaveState;
+    lastSavedAt: number | null;
+    hydrate: () => Promise<void>;
+    saveCustomInstructions: (next: CustomInstructions) => Promise<boolean>;
+    saveAssistantInstructions: (text: string) => Promise<boolean>;
+    /**
+     * Copies a customized active personality into Custom instructions, once.
+     * `ready` says the model store has finished loading, so an empty list is a
+     * real answer and not a race; until then nothing is recorded.
+     */
+    migrateFromPersonality: (active: Pick<BanditPersonality, "name" | "systemPrompt"> | null | undefined, ready: boolean) => Promise<PersonalityMigrationOutcome>;
+    /** The PERSONA block for the next message, with the legacy personality prompt as the fallback. */
+    personaPrompt: (legacyPersonalityPrompt?: string | null) => string;
+}
+declare const useInstructionsStore: zustand.UseBoundStore<zustand.StoreApi<InstructionsStore>>;
+
 declare function defineCustomElement<Props extends Record<string, unknown>>(name: string, Component: React.ComponentType<Props>): void;
 
 /**
@@ -1894,4 +2007,4 @@ declare const createStashShareLink: (args: {
     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 };
+export { AIMessage, ASSISTANT_INSTRUCTIONS_LIMIT, AUTH_TOKEN_CHANGED_EVENT, type ActionItem, type AuthSessionConfig, type AuthSessionHandlers, CUSTOM_INSTRUCTIONS_LIMITS, Chat, type CreateMemoryOptions, type CustomInstructions, DEFAULT_ASSISTANT_INSTRUCTIONS, 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, MemoryManager, type MemoryManagerProps, type MemorySearchFilters, type MigrationProgress, type MigrationStatus, type NotesMeta, type NotificationConfig, type NotificationContextType, NotificationProvider, type NotificationProviderProps, NotificationService, type ParsedTranscript, type PersonaPromptInput, 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, composePersonaPrompt, 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, planPersonalityMigration, previewTierUpgrade, resolveManagementSections, resumeTTS, runMeetingNotes, saveToStash, showInfoNotification, showSuccessNotification, speakStream as speakWithStreaming, stashAvailable, stopTTS, syncSubscriptionWithAPI, transcribeRecording, transcriptToText, updateSubscriptionTier, useFeatureFlag, useFeatureVisibility, useFeatures, useGatewayHealth, useGatewayMemory, useGatewayModels, useGlobalTTS, useInstructionsStore, 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, A as AIMessage } from './public-Tq2Pmw9m.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, E as EngineNavigation, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, m as SidebarLayout, n as SidebarSection, V as VoiceModelsResponse, o as VoiceService, v as voiceService } from './public-Tq2Pmw9m.js';
+import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage, A as AIMessage } from './public-_W_Zew3C.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, E as EngineNavigation, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, m as SidebarLayout, n as SidebarSection, V as VoiceModelsResponse, o as VoiceService, v as voiceService } from './public-_W_Zew3C.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { Theme } from '@mui/material/styles';
@@ -13,8 +13,8 @@ import { AlertColor } from '@mui/material';
 
 declare const Chat: () => react_jsx_runtime.JSX.Element | null;
 
-/** Every Management section that exists. Order is the sidebar order. */
-type ManagementSectionId = "overview" | "personalities" | "knowledge" | "tools" | "provider" | "storage" | "branding" | "schedules" | "preferences";
+/** Every Management section that exists, on either console. */
+type ManagementSectionId = "overview" | "personalization" | "personalities" | "instructions" | "knowledge" | "tools" | "crew" | "provider" | "advanced" | "storage" | "branding" | "schedules" | "preferences";
 type FeatureGate = "limitedAdminDashboard" | "advancedSearch";
 /**
  * Where a section sits in the rail: the overview on its own at the top, the
@@ -35,8 +35,9 @@ interface ManagementSectionDef {
     group: ManagementSectionGroup;
 }
 /**
- * The sections as the native shells still show them (labels and order). The
- * web console's wording and order are applied by presentManagementSections.
+ * Every section, in the native shells' order. Sections only one console has
+ * (see WEB_ONLY / NATIVE_ONLY) are filtered by presentManagementSections; the
+ * web's own wording and order are applied there too.
  */
 declare const MANAGEMENT_SECTIONS: readonly ManagementSectionDef[];
 interface ManagementAccessInput {
@@ -50,7 +51,7 @@ interface ManagementAccessInput {
  * per-tenant admin. AuthApi's TeamService grants tenant owners/admins a role of
  * the form "<slug>-admin", so any role ending in "-admin" is a tenant admin.
  * super-user is NOT an admin: it's the trial/power-user role, so trial and
- * consumer users see only Schedules and Preferences.
+ * consumer users see only their own pages (Preferences, Personalization, Schedules).
  */
 declare function isWorkspaceAdminRole(roles: string[]): boolean;
 /** Which sections this user can open: role first, then plan features. Pure, for tests and hosts. */
@@ -60,6 +61,8 @@ interface ManagementAccess {
     isWorkspaceAdmin: boolean;
     /** Admin-dashboard users limited to the lighter feature set. */
     isLimitedAdmin: boolean;
+    /** Pro/Team plan: the model provider page (inside Advanced on the web). */
+    hasAdvancedSearch: boolean;
 }
 /**
  * The signed-in user's Management access, presented for this console (web or
@@ -124,6 +127,116 @@ interface InterestsEditorProps {
  */
 declare const InterestsEditor: ({ title, description, }: InterestsEditorProps) => react_jsx_runtime.JSX.Element;
 
+interface MemoryManagerProps {
+    /**
+     * "sheet": the body of the Memories modal (chat surfaces, a close button, a
+     * fixed height). "page": the Settings page — searchable, and it grows with
+     * its list instead of scrolling inside a box.
+     */
+    variant: "sheet" | "page";
+    /** On screen; memories load when this becomes true. The sheet passes its `open`. */
+    active?: boolean;
+    /** The sheet's close button. */
+    onClose?: () => void;
+}
+/**
+ * What Bandit remembers: the memories you told it and the ones it noted
+ * itself, local to this browser or synced to your account. Add, edit, pin,
+ * delete, select several, clear by kind, and move local memories to the
+ * synced workspace. The Memories modal and the Personalization page both
+ * render this.
+ */
+declare const MemoryManager: React.FC<MemoryManagerProps>;
+
+interface BanditPersonality {
+    name: string;
+    tagline: string;
+    systemPrompt: string;
+    commands: string[];
+    avatarBase64?: string | null;
+    avatarPreset?: string;
+}
+
+interface CustomInstructions {
+    /** "What should Bandit know about you?" */
+    about: string;
+    /** "How would you like Bandit to respond?" */
+    responseStyle: string;
+}
+/** Character limits for new text. Migrated text longer than this is kept; it can only be shortened. */
+declare const CUSTOM_INSTRUCTIONS_LIMITS: {
+    readonly about: 1500;
+    readonly responseStyle: 1500;
+};
+declare const ASSISTANT_INSTRUCTIONS_LIMIT = 4000;
+/** Bandit's own voice: what answers when nobody has written instructions. */
+declare const DEFAULT_ASSISTANT_INSTRUCTIONS: string;
+declare const MIGRATIONS_RECORD_ID = "migrations";
+/** One-time data moves, by name, with when they ran. */
+interface MigrationsRecord {
+    id: typeof MIGRATIONS_RECORD_ID;
+    /** The customized active personality was copied into Custom instructions. */
+    customInstructionsFromPersonality?: {
+        at: number;
+        from: string | null;
+    };
+}
+interface PersonaPromptInput {
+    /** The workspace's Assistant instructions; empty when none were written. */
+    assistant: string;
+    custom: CustomInstructions;
+    /**
+     * The active personality's prompt (the pre-Phase-3 key), read for one more
+     * release so a workspace that has written nothing new keeps its voice.
+     */
+    legacyPersonalityPrompt?: string | null;
+}
+/**
+ * The PERSONA block's text. Assistant instructions come first; when the
+ * workspace wrote none, Bandit's default voice (or the legacy personality
+ * prompt) stands in — unless the person wrote Custom instructions, which then
+ * replace the default voice rather than compete with it. The person's two
+ * fields follow, labelled, so the model knows which is which.
+ */
+declare function composePersonaPrompt(input: PersonaPromptInput): string;
+interface PersonalityMigrationInput {
+    /** The personality that answers chats today, if the model store has one. */
+    active: Pick<BanditPersonality, "name" | "systemPrompt"> | null | undefined;
+    /** What the person has already written; never overwritten. */
+    existing: CustomInstructions;
+}
+/**
+ * Decides whether the active personality's prompt should seed Custom
+ * instructions: only when it was customized (differs from Bandit's default
+ * voice) and the person has not written a response style of their own.
+ * Returns the field to write, or null for nothing to do.
+ */
+declare function planPersonalityMigration(input: PersonalityMigrationInput): {
+    responseStyle: string;
+} | null;
+type InstructionsSaveState = "idle" | "saving" | "saved" | "error";
+type PersonalityMigrationOutcome = "migrated" | "nothing-to-migrate" | "already-done" | "not-ready";
+interface InstructionsStore {
+    custom: CustomInstructions;
+    assistant: string;
+    hydrated: boolean;
+    migration: MigrationsRecord["customInstructionsFromPersonality"] | null;
+    saveState: InstructionsSaveState;
+    lastSavedAt: number | null;
+    hydrate: () => Promise<void>;
+    saveCustomInstructions: (next: CustomInstructions) => Promise<boolean>;
+    saveAssistantInstructions: (text: string) => Promise<boolean>;
+    /**
+     * Copies a customized active personality into Custom instructions, once.
+     * `ready` says the model store has finished loading, so an empty list is a
+     * real answer and not a race; until then nothing is recorded.
+     */
+    migrateFromPersonality: (active: Pick<BanditPersonality, "name" | "systemPrompt"> | null | undefined, ready: boolean) => Promise<PersonalityMigrationOutcome>;
+    /** The PERSONA block for the next message, with the legacy personality prompt as the fallback. */
+    personaPrompt: (legacyPersonalityPrompt?: string | null) => string;
+}
+declare const useInstructionsStore: zustand.UseBoundStore<zustand.StoreApi<InstructionsStore>>;
+
 declare function defineCustomElement<Props extends Record<string, unknown>>(name: string, Component: React.ComponentType<Props>): void;
 
 /**
@@ -1894,4 +2007,4 @@ declare const createStashShareLink: (args: {
     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 };
+export { AIMessage, ASSISTANT_INSTRUCTIONS_LIMIT, AUTH_TOKEN_CHANGED_EVENT, type ActionItem, type AuthSessionConfig, type AuthSessionHandlers, CUSTOM_INSTRUCTIONS_LIMITS, Chat, type CreateMemoryOptions, type CustomInstructions, DEFAULT_ASSISTANT_INSTRUCTIONS, 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, MemoryManager, type MemoryManagerProps, type MemorySearchFilters, type MigrationProgress, type MigrationStatus, type NotesMeta, type NotificationConfig, type NotificationContextType, NotificationProvider, type NotificationProviderProps, NotificationService, type ParsedTranscript, type PersonaPromptInput, 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, composePersonaPrompt, 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, planPersonalityMigration, previewTierUpgrade, resolveManagementSections, resumeTTS, runMeetingNotes, saveToStash, showInfoNotification, showSuccessNotification, speakStream as speakWithStreaming, stashAvailable, stopTTS, syncSubscriptionWithAPI, transcribeRecording, transcriptToText, updateSubscriptionTier, useFeatureFlag, useFeatureVisibility, useFeatures, useGatewayHealth, useGatewayMemory, useGatewayModels, useGlobalTTS, useInstructionsStore, useManagementAccess, useNotification, useNotificationService, useTTS, useVectorStore, useVoiceStore, useVoices, validateEnvironment, validateSystemIntegrity, vectorDatabaseService, vectorMigrationService };