@volter-ai-dev/supercode-ui 0.1.68 → 0.1.69

package/controller.d.ts

@@ -9,6 +9,7 @@ import type {
   SupercodeController,
 } from '@volter-ai-dev/supercode-client';
 import type {
+  TranscriptEntryModel,
   AttachedSessionModel,
   ContinuationMode,
   SessionAttention,
@@ -19,6 +20,9 @@ import type {
   UiAdapter,
 } from './index.js';
 
+/** `after`: a conversation entry id (row follows it), `'^'` (before everything), or null/absent (at the end). */
+export type HostTranscriptEntry = TranscriptEntryModel & { after?: string | null };
+
 export interface ClientProjectionOptions {
   now?: number;
   /** Maximum rendered conversation rows after hidden context is removed. Default 120. */
@@ -49,6 +53,9 @@ export interface ClientProjectionOptions {
   continuationModes?: ContinuationMode[];
   /** Trusted-host inventory and lifecycle overlays (for example a machine-wide session catalog). */
   sessions?: SessionRowModel[];
+  /** Host-owned rows placed inside the conversation: after the conversation entry `after` names,
+   * or at the end. The conversation's own order is never changed; ids already present are skipped. */
+  hostEntries?: readonly HostTranscriptEntry[];
   attached?: AttachedSessionModel | null;
   owned?: AttachedSessionModel | null;
   attachError?: SupercodeUiState['attachError'];

package/controller.mjs

@@ -509,6 +509,39 @@ function projectPill(snapshot) {
   return { tone: 'live', label: text(`${label(harness)} ready`) };
 }
 
+/** A host's own rows — display objects an app printed, notices the host raised —
+ * inside the conversation at the position the host names: after a conversation
+ * entry by id, or at the end. The conversation's own order is never changed. */
+function withHostEntries(transcript, hostEntries) {
+  if (!Array.isArray(hostEntries) || hostEntries.length === 0) return transcript;
+  const out = [...transcript];
+  const tail = [];
+  for (const raw of hostEntries) {
+    if (!raw || typeof raw !== 'object' || typeof raw.id !== 'string') continue;
+    const { after, ...entry } = raw;
+    if (out.some((item) => item.id === entry.id)) continue;
+    if (after === '^') {
+      // before everything, in the given order
+      let at = 0;
+      while (at < out.length && out[at].__hostAfter === '^') at += 1;
+      out.splice(at, 0, { ...entry, __hostAfter: '^' });
+      continue;
+    }
+    const index = typeof after === 'string' ? out.findIndex((item) => item.id === after) : -1;
+    if (index >= 0) {
+      // keep host rows that share an anchor in their given order
+      let at = index + 1;
+      while (at < out.length && out[at].__hostAfter === after) at += 1;
+      out.splice(at, 0, { ...entry, __hostAfter: after });
+    } else tail.push(entry);
+  }
+  return [...out, ...tail].map((item) => {
+    if (!('__hostAfter' in item)) return item;
+    const { __hostAfter: _anchor, ...clean } = item;
+    return clean;
+  });
+}
+
 function projectClientSnapshotInternal(snapshot, options, imageRegistry) {
   const now = Number.isFinite(options.now) ? options.now : Date.now();
   const busy = ['running', 'interrupting', 'reconciling'].includes(snapshot.turn?.state);
@@ -559,7 +592,10 @@ function projectClientSnapshotInternal(snapshot, options, imageRegistry) {
     ? snapshot.connection?.ownsRuntime ? active : null
     : options.owned;
   const maxEntries = positiveInteger(options.maxEntries, DEFAULT_MAX_ENTRIES);
-  const transcript = projectConversation(snapshot.conversation ?? [], options, imageRegistry);
+  const transcript = withHostEntries(
+    projectConversation(snapshot.conversation ?? [], options, imageRegistry),
+    options.hostEntries,
+  );
   const startup = snapshot.availability === 'loading'
     ? snapshot.operation === 'start' ? 'starting' : snapshot.operation === 'refresh' ? 'discovering' : 'connecting'
     : 'ready';

package/host.d.ts

@@ -24,7 +24,7 @@ export class RemoteControllerHost {
   dispatch(intent: unknown): Promise<RemoteUiFrame>;
   getFrame(): RemoteUiFrame;
   refreshProjection(): RemoteUiFrame;
-  restore(identity: string, connection: 'observe' | 'attach'): Promise<RemoteUiFrame>;
+  restore(identity: string, connection: 'observe' | 'attach' | 'resume'): Promise<RemoteUiFrame>;
   subscribe(listener: (frame: RemoteUiFrame) => void): () => void;
 }
 

package/host.mjs

@@ -119,8 +119,8 @@ export class RemoteControllerHost {
     if (typeof identity !== 'string' || !identity) {
       throw new TypeError('RemoteControllerHost restore identity must be a non-empty string.');
     }
-    if (connection !== 'observe' && connection !== 'attach') {
-      throw new TypeError('RemoteControllerHost restore connection must be observe or attach.');
+    if (connection !== 'observe' && connection !== 'attach' && connection !== 'resume') {
+      throw new TypeError('RemoteControllerHost restore connection must be observe, attach, or resume.');
     }
     const sequence = this.#sequence;
     await this.#controller.dispatch({ type: 'restore', identity, connection });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter-ai-dev/supercode-ui",
-  "version": "0.1.68",
+  "version": "0.1.69",
   "type": "module",
   "description": "Composable default UI kit for Supercode-powered coding-agent experiences",
   "exports": {