@volter-ai-dev/supercode-ui 0.1.63 → 0.1.64

package/README.md

@@ -263,6 +263,9 @@ opaque-key callback and retains the reversible locator map. Its `isWritable` cap
 is fail-closed: unread badges remain neutral until the host proves a real send or terminal-control
 path. Runtime activity remains independent, so a read-only channel can still truthfully show that
 its external agent is working or needs input.
+`matchesSessionRef`, `projectAttachedSession`, and `formatWorkspacePath` complete that trusted-host
+adapter so products do not need local copies of active-session matching, fallback header identity,
+or home-relative path formatting.
 
 ## Modularity contract
 

package/controller.d.ts

@@ -72,6 +72,23 @@ export interface SessionInventoryProjectionOptions {
   isWritable?(descriptor: SessionDescriptor): boolean;
 }
 
+export interface ActiveSessionRef {
+  harness: string;
+  sessionId: string | null;
+}
+
+export function formatWorkspacePath(cwd: string | null | undefined, home?: string): string;
+export function matchesSessionRef(
+  descriptor: SessionDescriptor,
+  active: ActiveSessionRef | null | undefined,
+): boolean;
+export function projectAttachedSession(
+  active: ActiveSessionRef | null | undefined,
+  rows: readonly SessionRowModel[],
+  fallbackWorkspace: string,
+  home?: string,
+): AttachedSessionModel | null;
+
 export function sessionConversationUpdatedAt(descriptor: SessionDescriptor): number | null;
 export function sessionDescriptorRuntimeStatus(
   descriptor: SessionDescriptor,

package/controller.mjs

@@ -29,12 +29,42 @@ function workspaceName(cwd) {
   return cwd.replaceAll('\\', '/').split('/').filter(Boolean).at(-1) ?? cwd;
 }
 
-function shortWorkspacePath(cwd, home) {
+export function formatWorkspacePath(cwd, home) {
   if (typeof cwd !== 'string' || !cwd) return '';
   const root = typeof home === 'string' && home.endsWith('/') ? home.slice(0, -1) : home;
   return root && (cwd === root || cwd.startsWith(`${root}/`)) ? `~${cwd.slice(root.length)}` : cwd;
 }
 
+export function matchesSessionRef(descriptor, active) {
+  return Boolean(
+    active?.sessionId !== null &&
+      active?.sessionId !== undefined &&
+      descriptor?.locator?.harness === active.harness &&
+      descriptor?.locator?.session_id === active.sessionId,
+  );
+}
+
+export function projectAttachedSession(active, rows, fallbackWorkspace, home) {
+  if (!active?.harness) return null;
+  const row = rows.find((candidate) => candidate.active);
+  if (row) {
+    return {
+      key: row.key,
+      harness: row.harness,
+      name: row.name,
+      cwd: row.cwd,
+      title: row.title,
+    };
+  }
+  return {
+    key: '',
+    harness: active.harness,
+    name: workspaceName(fallbackWorkspace) || 'no workspace',
+    cwd: formatWorkspacePath(fallbackWorkspace, home),
+    title: workspaceName(fallbackWorkspace) || 'Untitled chat',
+  };
+}
+
 function compactTopic(value) {
   const text = typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
   if (text.length <= 72) return text;
@@ -115,7 +145,7 @@ export function projectSessionInventory(descriptors, options) {
       key,
       harness: descriptor.locator.harness,
       name: workspaceName(descriptor.cwd) || 'no workspace',
-      cwd: shortWorkspacePath(descriptor.cwd, options.home),
+      cwd: formatWorkspacePath(descriptor.cwd, options.home),
       title: descriptorTitle(descriptor),
       preview: preview?.text ?? '',
       age: relativeAge(preview?.updatedAt ?? updatedAt, now),

package/package.json

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