@volter-ai-dev/supercode-ui 0.1.35 → 0.1.37

package/core.mjs

@@ -30,6 +30,7 @@ export const EMPTY_UI_STATE = Object.freeze({
   mode: 'none',
   strategy: null,
   canSend: false,
+  canSteer: false,
   canResume: false,
   continuationModes: Object.freeze([]),
   canBranch: false,
@@ -771,6 +772,7 @@ export function normalizeUiState(value) {
     mode: MODES.has(raw.mode) ? raw.mode : 'none',
     strategy: STRATEGIES.has(raw.strategy) ? raw.strategy : null,
     canSend: raw.canSend === true,
+    canSteer: raw.canSteer === true,
     canResume,
     continuationModes,
     canBranch: raw.canBranch === true,
@@ -804,7 +806,29 @@ export function normalizeUiState(value) {
       const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode)
         ? item.preferredLaunchMode
         : launchModes[0] ?? null;
-      return [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable, reason: typeof item.reason === 'string' ? item.reason : null, launchModes, preferredLaunchMode }];
+      const capabilities = record(item.capabilities);
+      return [{
+        id: item.id,
+        label: string(item.label, harnessDisplayName(item.id)),
+        installed: item.installed === true,
+        startable,
+        reason: typeof item.reason === 'string' ? boundedString(item.reason) : null,
+        auth: ['ready', 'configured', 'required', 'unknown'].includes(item.auth) ? item.auth : 'unknown',
+        runtime: ['ready', 'degraded', 'unavailable'].includes(item.runtime) ? item.runtime : startable ? 'ready' : 'unavailable',
+        protocol: boundedString(item.protocol, 100),
+        repair: typeof item.repair === 'string' ? boundedString(item.repair, 4_000) : null,
+        capabilities: {
+          start: capabilities?.start === true,
+          resume: capabilities?.resume === true,
+          attach: capabilities?.attach === true,
+          send: capabilities?.send === true,
+          interrupt: capabilities?.interrupt === true,
+          steer: capabilities?.steer === true,
+          respond: capabilities?.respond === true,
+        },
+        launchModes,
+        preferredLaunchMode,
+      }];
     }) : [],
     history: { sessionLimit: number(history?.sessionLimit), hasMoreSessions: history?.hasMoreSessions === true, transcriptLimit: number(history?.transcriptLimit, 120), hasEarlier: history?.hasEarlier === true },
     savedDraft: string(raw.savedDraft),
@@ -843,6 +867,60 @@ export function sessionActivity(state, row) {
   return 'idle';
 }
 
+const ACTIVITY_PRIORITY = Object.freeze({
+  'needs-input': 70,
+  failed: 60,
+  working: 50,
+  unseen: 40,
+  finished: 30,
+  running: 20,
+  recent: 10,
+  idle: 0,
+});
+
+function activityDetail(activity, preview, pill) {
+  if (preview) return preview;
+  if (activity === 'needs-input') return 'Needs input';
+  if (activity === 'failed') return 'Run failed';
+  if (activity === 'working') return 'Working…';
+  if (activity === 'finished') return 'Finished';
+  if (activity === 'unseen') return 'New reply';
+  if (activity === 'running') return 'Session is running';
+  return pill || 'Agent chats';
+}
+
+/** A stable, host-agnostic projection for overlay launchers and compact activity trays. */
+export function projectAgentActivity(value) {
+  const state = normalizeUiState(value);
+  const attentionByKey = new Map(state.attention.map((item) => [item.key, item]));
+  const unreadCount = state.attention.reduce((total, item) => total + (item.unreadCount ?? 1), 0);
+  const ranked = state.sessions.map((row, index) => {
+    const activity = sessionActivity(state, row);
+    return {
+      row,
+      index,
+      activity,
+      priority: ACTIVITY_PRIORITY[activity] ?? 0,
+      active: row.active || row.key === state.attached?.key || row.key === state.owned?.key,
+      updatedAt: row.previewUpdatedAt ?? row.updatedAt ?? 0,
+    };
+  }).sort((left, right) => right.priority - left.priority || Number(right.active) - Number(left.active) || right.updatedAt - left.updatedAt || left.index - right.index);
+  const selected = ranked[0];
+  const fallback = state.attached ?? state.owned;
+  const harness = selected?.row.harness ?? fallback?.harness ?? state.harness;
+  const activity = selected?.activity ?? (state.needsInput ? 'needs-input' : state.busy ? 'working' : state.startup === 'ready' ? 'idle' : 'recent');
+  const attention = selected ? attentionByKey.get(selected.row.key) : null;
+  const preview = selected?.row.preview || attention?.preview || '';
+  return {
+    harness,
+    sessionKey: selected?.row.key ?? fallback?.key ?? null,
+    title: selected ? sessionDisplayName(selected.row) : fallback ? sessionDisplayName(fallback) : 'Agent chats',
+    detail: activityDetail(activity, preview, state.pill.label),
+    activity,
+    unreadCount,
+  };
+}
+
 export function filterSessions(rows, query) {
   const needle = query.trim().toLocaleLowerCase();
   if (!needle) return [...rows];
@@ -908,7 +986,7 @@ export function canContinueHere(state) {
 
 export function operationLabel(operation) {
   if (!operation) return '';
-  const labels = { discover: 'Refreshing chats…', observe: 'Loading recent messages…', attach: 'Opening chat…', start: 'Starting new chat…', resume: 'Continuing here…', join: 'Joining live session…', detach: 'Detaching to read-only…', branch: 'Starting continuation…', reduce: 'Reducing context and verifying reversibility…', terminal: 'Preparing terminal handoff…', export: 'Exporting losslessly…', interrupt: 'Stopping agent…', respond: 'Sending response…', configureHarness: 'Updating harness settings…', loadEarlier: 'Loading earlier messages…', loadSessions: 'Loading more chats…', refresh: 'Retrying…' };
+  const labels = { discover: 'Refreshing chats…', observe: 'Loading recent messages…', attach: 'Opening chat…', start: 'Starting new chat…', resume: 'Continuing here…', join: 'Joining live session…', detach: 'Detaching to read-only…', branch: 'Starting continuation…', reduce: 'Reducing context and verifying reversibility…', terminal: 'Preparing terminal handoff…', export: 'Exporting losslessly…', steer: 'Steering agent…', interrupt: 'Stopping agent…', respond: 'Sending response…', configureHarness: 'Updating harness settings…', loadEarlier: 'Loading earlier messages…', loadSessions: 'Loading more chats…', refresh: 'Retrying…' };
   return labels[operation] ?? `${operation.replaceAll('_', ' ')}…`;
 }
 
@@ -920,3 +998,145 @@ export function terminalCommand(handoff) {
 export function isSendKey(event) {
   return event.key === 'Enter' && !event.shiftKey && !event.isComposing;
 }
+
+function intentRecord(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+
+function intentKeys(value, allowed) {
+  return Object.keys(value).every((key) => allowed.includes(key));
+}
+
+function intentContext(value) {
+  if (value === undefined) return [];
+  if (!Array.isArray(value) || value.length > 32) return null;
+  const items = [];
+  for (const candidate of value) {
+    const item = intentRecord(candidate);
+    if (!item || !intentKeys(item, ['id', 'kind', 'label', 'detail'])) return null;
+    if (typeof item.label !== 'string' || !item.label.trim() || item.label.length > 200) return null;
+    if (typeof item.detail !== 'string' || item.detail.length > 20_000) return null;
+    if (item.id !== undefined && (typeof item.id !== 'string' || !item.id || item.id.length > 2_000)) return null;
+    if (item.kind !== undefined && (typeof item.kind !== 'string' || !item.kind || item.kind.length > 100)) return null;
+    items.push({
+      ...(typeof item.id === 'string' ? { id: item.id } : {}),
+      ...(typeof item.kind === 'string' ? { kind: item.kind } : {}),
+      label: item.label.trim(),
+      detail: item.detail,
+    });
+  }
+  return items;
+}
+
+function intentImages(value) {
+  if (value === undefined) return [];
+  if (!Array.isArray(value) || value.length > 4) return null;
+  let totalChars = 0;
+  const items = [];
+  for (const candidate of value) {
+    const item = intentRecord(candidate);
+    if (!item || !intentKeys(item, ['id', 'label', 'url'])) return null;
+    if (typeof item.label !== 'string' || !item.label.trim() || item.label.length > 200) return null;
+    if (typeof item.url !== 'string' || !/^(?:data:image\/|https?:\/\/)/.test(item.url)) return null;
+    if (item.url.length > 12 * 1024 * 1024) return null;
+    totalChars += item.url.length;
+    if (totalChars > 32 * 1024 * 1024) return null;
+    if (item.id !== undefined && (typeof item.id !== 'string' || !item.id || item.id.length > 2_000)) return null;
+    items.push({ ...(typeof item.id === 'string' ? { id: item.id } : {}), label: item.label.trim(), url: item.url });
+  }
+  return items;
+}
+
+function intentJson(value, seen = new Set()) {
+  if (value === null || typeof value === 'string' || typeof value === 'boolean') return true;
+  if (typeof value === 'number') return Number.isFinite(value);
+  if (typeof value !== 'object' || seen.has(value)) return false;
+  seen.add(value);
+  const valid = Array.isArray(value)
+    ? value.length <= 1_000 && value.every((item) => intentJson(item, seen))
+    : Object.keys(value).length <= 1_000 && Object.values(value).every((item) => intentJson(item, seen));
+  seen.delete(value);
+  return valid;
+}
+
+/** Runtime validation for the transport-safe intent union emitted by the default UI. */
+export function parseSupercodeUiIntent(value) {
+  const intent = intentRecord(value);
+  if (!intent || typeof intent.action !== 'string') return null;
+  const exact = (...keys) => intentKeys(intent, ['action', ...keys]);
+  const actionOnly = ['mounted', 'loadSessions', 'loadEarlier', 'join', 'detach', 'terminal', 'interrupt', 'refresh', 'release'];
+  if (actionOnly.includes(intent.action)) return exact() ? { action: intent.action } : null;
+  if (intent.action === 'attach' || intent.action === 'ack') {
+    return exact('key') && typeof intent.key === 'string' && intent.key.trim() && intent.key.length <= 4_000
+      ? { action: intent.action, key: intent.key.trim() }
+      : null;
+  }
+  if (intent.action === 'draft') {
+    return exact('text') && typeof intent.text === 'string' && intent.text.length <= 50_000
+      ? { action: 'draft', text: intent.text }
+      : null;
+  }
+  if (intent.action === 'steer') {
+    return exact('text') && typeof intent.text === 'string' && intent.text.trim() && intent.text.length <= 50_000
+      ? { action: 'steer', text: intent.text }
+      : null;
+  }
+  if (intent.action === 'send' || intent.action === 'new') {
+    const allowed = intent.action === 'new'
+      ? exact('harness', 'mode', 'text', 'context', 'images')
+      : exact('text', 'context', 'images');
+    const context = intentContext(intent.context);
+    const images = intentImages(intent.images);
+    if (!allowed || typeof intent.text !== 'string' || context === null || images === null) return null;
+    if (!intent.text.trim() && images.length === 0) return null;
+    const extras = {
+      ...(context.length ? { context } : {}),
+      ...(images.length ? { images } : {}),
+    };
+    if (intent.action === 'send') return { action: 'send', text: intent.text, ...extras };
+    if (typeof intent.harness !== 'string' || !intent.harness.trim() || intent.harness.length > 100) return null;
+    const mode = intent.mode === undefined ? undefined : intent.mode;
+    if (mode !== undefined && mode !== 'headless' && mode !== 'terminal') return null;
+    if (mode === 'terminal' && !intent.text.trim()) return null;
+    return { action: 'new', harness: intent.harness.trim(), ...(mode ? { mode } : {}), text: intent.text, ...extras };
+  }
+  if (intent.action === 'resume') {
+    return exact('mode') && (intent.mode === undefined || intent.mode === 'headless' || intent.mode === 'terminal')
+      ? { action: 'resume', ...(intent.mode ? { mode: intent.mode } : {}) }
+      : null;
+  }
+  if (intent.action === 'branch' || intent.action === 'reduce') {
+    if (!exact('targetHarness')) return null;
+    if (intent.targetHarness === undefined) return { action: intent.action };
+    return typeof intent.targetHarness === 'string' && intent.targetHarness.trim() && intent.targetHarness.length <= 100
+      ? { action: intent.action, targetHarness: intent.targetHarness.trim() }
+      : null;
+  }
+  if (intent.action === 'export') {
+    return exact('targetHarness') && typeof intent.targetHarness === 'string' && intent.targetHarness.trim() && intent.targetHarness.length <= 100
+      ? { action: 'export', targetHarness: intent.targetHarness.trim() }
+      : null;
+  }
+  if (intent.action === 'respond') {
+    if (!exact('requestId', 'optionId') || !intentJson(intent.requestId)) return null;
+    return intent.optionId === null || typeof intent.optionId === 'string'
+      ? { action: 'respond', requestId: intent.requestId, optionId: intent.optionId }
+      : null;
+  }
+  if (intent.action === 'configureHarness') {
+    if (!exact('harness', 'changes', 'expectedRevision')) return null;
+    if (typeof intent.harness !== 'string' || !intent.harness || intent.harness.length > 100) return null;
+    if (typeof intent.expectedRevision !== 'string' || !intent.expectedRevision || intent.expectedRevision.length > 500) return null;
+    if (!Array.isArray(intent.changes) || !intent.changes.length || intent.changes.length > 20) return null;
+    const changes = [];
+    for (const candidate of intent.changes) {
+      const change = intentRecord(candidate);
+      if (!change || !intentKeys(change, ['key', 'value'])) return null;
+      if (typeof change.key !== 'string' || !change.key || change.key.length > 200) return null;
+      if (change.value !== null && (typeof change.value !== 'string' || change.value.length > 500)) return null;
+      changes.push({ key: change.key, value: change.value });
+    }
+    return { action: 'configureHarness', harness: intent.harness, changes, expectedRevision: intent.expectedRevision };
+  }
+  return null;
+}