@volter-ai-dev/supercode-ui 0.1.29 → 0.1.31

package/index.d.ts

@@ -24,6 +24,8 @@ export interface SessionRowModel {
   /** Latest human-visible conversation message, separate from the stable title. */
   preview?: string;
   age: string;
+  /** Timestamp of the message rendered as `preview`; distinct from session-store recency. */
+  previewUpdatedAt?: number | null;
   updatedAt: number | null;
   messages: number | null;
   active: boolean;
@@ -158,6 +160,58 @@ export interface ReductionReceiptModel {
   targetHarness: HarnessId;
 }
 
+export interface HarnessSettingChoiceModel {
+  value: string;
+  label: string;
+  description: string;
+  risk?: string;
+}
+
+export interface HarnessInteropControlModel {
+  key: string;
+  nativeKey: string;
+  label: string;
+  description: string;
+  scope: 'user' | 'project' | 'managed' | 'command_line';
+  sourcePath: string;
+  configuredValue: string | null;
+  effectiveValue: string | null;
+  effectiveKnown: boolean;
+  effectiveNote: string;
+  choices: HarnessSettingChoiceModel[];
+  writable: boolean;
+  resettable: boolean;
+  requiresRestart: boolean;
+}
+
+export interface HarnessSettingChangeModel {
+  key: string;
+  value: string | null;
+}
+
+export interface HarnessInteropAdvisoryModel {
+  code: string;
+  severity: 'info' | 'warning' | 'error';
+  title: string;
+  message: string;
+  setting: string;
+  recommendation: {
+    label: string;
+    description: string;
+    consequence: string;
+    change: HarnessSettingChangeModel;
+    command: string;
+  };
+}
+
+export interface HarnessInteropSettingsModel {
+  schema: 'supercode.harness-interop-settings.v1';
+  harness: HarnessId;
+  revision: string;
+  controls: HarnessInteropControlModel[];
+  advisories: HarnessInteropAdvisoryModel[];
+}
+
 export interface SessionAttention {
   key: string;
   kind: 'unseen' | 'finished' | 'failed';
@@ -188,6 +242,7 @@ export interface SupercodeUiState {
   canReduce: boolean;
   canInterrupt: boolean;
   canRespond: boolean;
+  canConfigureSettings: boolean;
   messaging: 'live_peer' | null;
   workspace: string;
   taskPlan: TaskPlanModel;
@@ -202,6 +257,8 @@ export interface SupercodeUiState {
     residueCount: number;
   } | null;
   reductionReceipt: ReductionReceiptModel | null;
+  interopSettings: HarnessInteropSettingsModel | null;
+  interopSettingsError: string | null;
   error: string | null;
   recoverable: boolean;
   harnesses: HarnessOption[];
@@ -237,6 +294,7 @@ export type SupercodeUiIntent =
   | { action: 'export'; targetHarness: HarnessId }
   | { action: 'interrupt' }
   | { action: 'respond'; requestId: unknown; optionId: string | null }
+  | { action: 'configureHarness'; harness: HarnessId; changes: HarnessSettingChangeModel[]; expectedRevision: string }
   | { action: 'refresh' }
   | { action: 'release' };
 
@@ -282,6 +340,7 @@ export interface SessionRowProps {
   value?: SessionRowModel;
   state: SupercodeUiState;
   adapter: UiAdapter;
+  now?: number;
   onOpen(row: SessionRowModel): void;
 }
 
@@ -313,12 +372,29 @@ export interface TaskPlanProps {
   adapter: UiAdapter;
 }
 
+export interface HarnessAdvisoryProps {
+  state: SupercodeUiState;
+  adapter?: UiAdapter;
+  value?: HarnessInteropAdvisoryModel | null;
+  onReview(change: HarnessSettingChangeModel): void;
+}
+
+export interface HarnessSettingsPanelProps {
+  state: SupercodeUiState;
+  adapter: UiAdapter;
+  value?: HarnessInteropSettingsModel | null;
+  recommendedChange?: HarnessSettingChangeModel | null;
+  onClose(): void;
+}
+
 export interface MessengerComponents {
   SessionRow?: ComponentType<SessionRowProps>;
   TranscriptEntry?: ComponentType<TranscriptEntryProps>;
   ActivityGroup?: ComponentType<ActivityGroupProps>;
   TaskPlan?: ComponentType<TaskPlanProps>;
   HarnessLogo?: ComponentType<{ id: HarnessId; activity?: SessionActivity; size?: number }>;
+  HarnessAdvisory?: ComponentType<HarnessAdvisoryProps>;
+  HarnessSettingsPanel?: ComponentType<HarnessSettingsPanelProps>;
 }
 
 export interface MessengerSlots {
@@ -345,6 +421,7 @@ export const DEFAULT_LABELS: Readonly<MessengerLabels>;
 export function normalizeUiState(value: unknown): SupercodeUiState;
 export function harnessDisplayName(id: string): string;
 export function sessionDisplayName(session: Pick<SessionRowModel, 'name' | 'title'>): string;
+export function relativeAge(updatedAt: number | null | undefined, now?: number): string;
 export function sessionActivity(state: SupercodeUiState, row: SessionRowModel): SessionActivity;
 export function filterSessions(rows: readonly SessionRowModel[], query: string): SessionRowModel[];
 export function groupConversation(entries: readonly TranscriptEntryModel[]): Array<
@@ -374,9 +451,11 @@ export function TranscriptEntry(props: { entry: TranscriptEntryModel; state: Sup
 export function ActivityGroup(props: { entries: TranscriptEntryModel[]; state: SupercodeUiState; adapter: UiAdapter }): VNode;
 export function ToolRow(props: ToolRowProps): VNode;
 export function TaskPlan(props: { plan: TaskPlanModel }): VNode | null;
+export function HarnessAdvisory(props: HarnessAdvisoryProps): VNode | null;
+export function HarnessSettingsPanel(props: HarnessSettingsPanelProps): VNode;
 export function SessionDetails(props: { semantics: SessionSemanticsModel }): VNode | null;
 export function Conversation(props: { state: SupercodeUiState; adapter: UiAdapter; components?: MessengerComponents; slots?: MessengerSlots; memoryKey?: string; pending?: string | PendingMessageModel | null; unreadAfterMessages?: number | null }): VNode;
-export function SessionRow(props: { row: SessionRowModel; state: SupercodeUiState; adapter: UiAdapter; onOpen(row: SessionRowModel): void }): VNode;
+export function SessionRow(props: { row: SessionRowModel; state: SupercodeUiState; adapter: UiAdapter; now?: number; onOpen(row: SessionRowModel): void }): VNode;
 export function SessionList(props: { state: SupercodeUiState; adapter: UiAdapter; onOpen(row: SessionRowModel): void; onNew?(): void; onClose?(): void; components?: MessengerComponents; labels?: MessengerLabels; focusKey?: string | null; memoryKey?: string }): VNode;
 export function ContinuationBar(props: { state: SupercodeUiState; adapter: UiAdapter; labels?: MessengerLabels }): VNode | null;
 export function Composer(props: { state: SupercodeUiState; adapter: UiAdapter; labels?: MessengerLabels; memoryKey?: string; pendingStatus?: PendingMessageModel['status'] | 'editing' | null; restoreDraft?: { id: string | number; text: string; context?: TranscriptContext[]; images?: TranscriptImage[] } | null; onPending?(text: string, context?: TranscriptContext[], images?: TranscriptImage[]): void; onDraftRestored?(id: string | number): void }): VNode;