@volter-ai-dev/supercode-ui 0.1.54 → 0.1.55

package/composer.mjs

@@ -65,6 +65,7 @@ var EMPTY_UI_STATE = Object.freeze({
   savedDraft: "",
   attention: Object.freeze([]),
   sessions: Object.freeze([]),
+  subagentInspector: null,
   attached: null,
   owned: null,
   attachError: null
@@ -102,6 +103,12 @@ function boundedSet(map, key, value) {
 // src/icon.jsx
 import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
 var ICONS = {
+  agents: () => /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("circle", { cx: "6", cy: "6.5", r: "2" }),
+    /* @__PURE__ */ jsx("path", { d: "M2.75 13c.45-2 1.55-3 3.25-3s2.8 1 3.25 3" }),
+    /* @__PURE__ */ jsx("circle", { cx: "12.25", cy: "7", r: "1.5" }),
+    /* @__PURE__ */ jsx("path", { d: "M10.5 10.75c1.95-.65 3.45.1 4 2.25" })
+  ] }),
   attach: () => /* @__PURE__ */ jsx("path", { d: "M6.25 9.75 10.6 5.4a2.1 2.1 0 0 1 2.97 2.97l-5.4 5.4a3.3 3.3 0 0 1-4.67-4.66l5.52-5.52" }),
   back: () => /* @__PURE__ */ jsx("path", { d: "m11.5 4.5-4.5 4.5 4.5 4.5" }),
   check: () => /* @__PURE__ */ jsx("path", { d: "m4 9 3.25 3.25L14 5.5" }),

package/controller.d.ts

@@ -81,6 +81,14 @@ export function projectSessionInventory(
   descriptors: readonly SessionDescriptor[],
   options: SessionInventoryProjectionOptions,
 ): ProjectedSessionRowModel[];
+export function projectSubagentInventory(
+  descriptors: readonly SessionDescriptor[],
+  options: SessionInventoryProjectionOptions,
+): ProjectedSessionRowModel[];
+export function projectSubagentTranscript(
+  session: import('@volter-ai-dev/supercode-harness-sdk').NormalizedSession,
+  options?: Pick<ClientProjectionOptions, 'maxEntries' | 'maxScanEntries' | 'maxEntryChars'> & { prefix?: string },
+): import('./index.js').TranscriptEntryModel[];
 
 export interface ResolvableTranscriptImage {
   id?: string;

package/controller.mjs

@@ -1,4 +1,4 @@
-import { conversationPreviewText } from '@volter-ai-dev/supercode-client';
+import { conversationPreviewText, projectConversation as projectNormalizedConversation } from '@volter-ai-dev/supercode-client';
 import { createToolPresentation, normalizeUiState, relativeAge } from './core.mjs';
 
 const HARNESS_LABELS = {
@@ -128,12 +128,59 @@ export function projectSessionInventory(descriptors, options) {
       writable: options.isWritable?.(descriptor) === true,
       live: updatedAt !== null && now - updatedAt <= liveWindowMs,
       runtimeStatus: sessionDescriptorRuntimeStatus(descriptor),
+      ...(Number.isSafeInteger(descriptor.child_session_count) && descriptor.child_session_count > 0
+        ? { subagentCount: descriptor.child_session_count }
+        : {}),
     });
     if (rows.length >= maxSessions) break;
   }
   return rows;
 }
 
+function descriptorSessionActivity(descriptor) {
+  if (descriptor?.activity?.turn === 'needs_input') return 'needs-input';
+  if (descriptor?.activity?.turn === 'working') return 'working';
+  if (descriptor?.activity?.presence === 'running' || descriptor?.activity?.presence === 'shutting_down') return 'running';
+  if (descriptor?.activity?.turn === 'idle') return 'recent';
+  if (descriptor?.live_status === 'busy') return 'working';
+  if (descriptor?.live_status === 'running') return 'running';
+  if (descriptor?.live_status === 'idle') return 'recent';
+  return 'idle';
+}
+
+const SUBAGENT_ACTIVITY_PRIORITY = Object.freeze({
+  'needs-input': 4,
+  failed: 3,
+  working: 2,
+  running: 1,
+  recent: 1,
+  idle: 0,
+});
+
+/** Project an explicitly requested native session family into read-only child rows. */
+export function projectSubagentInventory(descriptors, options) {
+  const rows = projectSessionInventory(
+    (descriptors ?? []).filter((descriptor) => descriptor?.parent_session_id),
+    { ...options, preserveOrder: true, isWritable: () => false },
+  ).map((row) => {
+    const descriptor = descriptors.find((candidate) => options.keyFor(candidate) === row.key);
+    return { ...row, activity: descriptorSessionActivity(descriptor) };
+  });
+  return rows.sort((left, right) =>
+    (SUBAGENT_ACTIVITY_PRIORITY[right.activity] ?? 0) - (SUBAGENT_ACTIVITY_PRIORITY[left.activity] ?? 0)
+    || (right.updatedAt ?? 0) - (left.updatedAt ?? 0)
+    || left.title.localeCompare(right.title));
+}
+
+/** Project one directly loaded child session without requiring a controller takeover. */
+export function projectSubagentTranscript(session, options = {}) {
+  return projectConversation(
+    projectNormalizedConversation(session, { prefix: options.prefix ?? session?.session_id ?? 'subagent' }),
+    options,
+    null,
+  );
+}
+
 function payloadText(payload) {
   if (typeof payload === 'string') return payload;
   try {

package/conversation.mjs

@@ -66,6 +66,7 @@ var EMPTY_UI_STATE = Object.freeze({
   savedDraft: "",
   attention: Object.freeze([]),
   sessions: Object.freeze([]),
+  subagentInspector: null,
   attached: null,
   owned: null,
   attachError: null
@@ -595,6 +596,12 @@ function boundedSet(map, key, value) {
 // src/icon.jsx
 import { Fragment, jsx as jsx2, jsxs } from "preact/jsx-runtime";
 var ICONS = {
+  agents: () => /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx2("circle", { cx: "6", cy: "6.5", r: "2" }),
+    /* @__PURE__ */ jsx2("path", { d: "M2.75 13c.45-2 1.55-3 3.25-3s2.8 1 3.25 3" }),
+    /* @__PURE__ */ jsx2("circle", { cx: "12.25", cy: "7", r: "1.5" }),
+    /* @__PURE__ */ jsx2("path", { d: "M10.5 10.75c1.95-.65 3.45.1 4 2.25" })
+  ] }),
   attach: () => /* @__PURE__ */ jsx2("path", { d: "M6.25 9.75 10.6 5.4a2.1 2.1 0 0 1 2.97 2.97l-5.4 5.4a3.3 3.3 0 0 1-4.67-4.66l5.52-5.52" }),
   back: () => /* @__PURE__ */ jsx2("path", { d: "m11.5 4.5-4.5 4.5 4.5 4.5" }),
   check: () => /* @__PURE__ */ jsx2("path", { d: "m4 9 3.25 3.25L14 5.5" }),

package/core.mjs

@@ -63,6 +63,7 @@ export const EMPTY_UI_STATE = Object.freeze({
   savedDraft: '',
   attention: Object.freeze([]),
   sessions: Object.freeze([]),
+  subagentInspector: null,
   attached: null,
   owned: null,
   attachError: null,
@@ -568,10 +569,26 @@ function readSessions(value) {
       writable: row.writable === true,
       live: row.live === true,
       runtimeStatus: row.runtimeStatus === 'running' || row.runtimeStatus === 'busy' || row.runtimeStatus === 'idle' ? row.runtimeStatus : null,
+      ...(Number.isSafeInteger(row.subagentCount) && row.subagentCount > 0 ? { subagentCount: row.subagentCount } : {}),
+      activity: ACTIVITY_PRIORITY[row.activity] !== undefined ? row.activity : undefined,
     }];
   });
 }
 
+function readSubagentInspector(value) {
+  const inspector = record(value);
+  if (!inspector || typeof inspector.parentKey !== 'string' || !inspector.parentKey) return null;
+  return {
+    parentKey: inspector.parentKey,
+    parentTitle: boundedString(string(inspector.parentTitle), 500),
+    status: ['loading', 'ready', 'error'].includes(inspector.status) ? inspector.status : 'loading',
+    items: readSessions(inspector.items).slice(0, 100),
+    selectedKey: typeof inspector.selectedKey === 'string' && inspector.selectedKey ? inspector.selectedKey : null,
+    transcript: readTranscript(inspector.transcript).slice(-120),
+    error: typeof inspector.error === 'string' ? boundedString(inspector.error) : null,
+  };
+}
+
 function readAttached(value) {
   const item = record(value);
   if (!item || typeof item.harness !== 'string') return null;
@@ -849,6 +866,7 @@ export function normalizeUiState(value) {
         : [];
     }) : [],
     sessions: readSessions(raw.sessions),
+    subagentInspector: readSubagentInspector(raw.subagentInspector),
     attached: readAttached(raw.attached),
     owned: readAttached(raw.owned),
     attachError: attachError && typeof attachError.key === 'string' && typeof attachError.message === 'string' ? { key: attachError.key, message: attachError.message } : null,
@@ -865,6 +883,7 @@ export function sessionDisplayName(session) {
 }
 
 export function sessionActivity(state, row) {
+  if (row.activity && ACTIVITY_PRIORITY[row.activity] !== undefined) return row.activity;
   if (state.needsInput && row.active) return 'needs-input';
   if (state.busy && row.active) return 'working';
   // Unread/finished attention has its own badge. It must not suppress the
@@ -1080,13 +1099,20 @@ 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'];
+  const actionOnly = ['mounted', 'loadSessions', 'loadEarlier', 'closeSubagents', 'join', 'detach', 'terminal', 'interrupt', 'refresh', 'release'];
   if (actionOnly.includes(intent.action)) return exact() ? { action: intent.action } : null;
-  if (intent.action === 'attach' || intent.action === 'ack') {
+  if (intent.action === 'attach' || intent.action === 'ack' || intent.action === 'openSubagents') {
     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 === 'openSubagent') {
+    return exact('parentKey', 'key')
+      && typeof intent.parentKey === 'string' && intent.parentKey.trim() && intent.parentKey.length <= 4_000
+      && typeof intent.key === 'string' && intent.key.trim() && intent.key.length <= 4_000
+      ? { action: 'openSubagent', parentKey: intent.parentKey.trim(), 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 }