@design.estate/dees-catalog 6.0.0 → 6.2.0

package/ts_web/elements/00group-harness/dees-harness-tool-card/renderers.ts

@@ -105,14 +105,15 @@ const renderTerminal = (call: IHarnessToolCall, helpers: IHarnessToolRenderHelpe
   const output = call.output;
   let stdout = '';
   let stderr = '';
-  let exitCode: number | undefined;
+  let nestedExitCode: number | undefined;
   if (harnessIsRecord(output)) {
     stdout = typeof output.stdout === 'string' ? output.stdout : harnessStringifyValue(output.stdout ?? '');
     stderr = typeof output.stderr === 'string' ? output.stderr : '';
-    exitCode = typeof output.exitCode === 'number' ? output.exitCode : undefined;
+    nestedExitCode = typeof output.exitCode === 'number' ? output.exitCode : undefined;
   } else {
     stdout = harnessStringifyValue(output);
   }
+  const exitCode = typeof call.exitCode === 'number' ? call.exitCode : nestedExitCode;
   const running = call.status === 'pending' || call.status === 'running';
   return html`
     <div class="harness-terminal">
@@ -125,8 +126,8 @@ const renderTerminal = (call: IHarnessToolCall, helpers: IHarnessToolRenderHelpe
       ${running && !stdout && !stderr
         ? html`<div class="harness-terminal-running"><span class="cursor"></span> running…</div>`
         : ''}
-      ${exitCode !== undefined && exitCode !== 0
-        ? html`<div class="harness-terminal-exit">exit ${exitCode}</div>`
+      ${exitCode !== undefined
+        ? html`<div class="harness-terminal-exit ${exitCode === 0 ? 'tone-success' : ''}">exit code ${exitCode}</div>`
         : ''}
     </div>
   `;
@@ -255,33 +256,36 @@ const renderSearch = (call: IHarnessToolCall, helpers: IHarnessToolRenderHelpers
   `;
 };
 
-const renderSubtask = (call: IHarnessToolCall, helpers: IHarnessToolRenderHelpers): TemplateResult => {
+const renderSubtask = (call: IHarnessToolCall): TemplateResult => {
   const input = inputRecord(call);
   const prompt = String(input.prompt ?? input.description ?? '');
+  const projectedResult = call.subtask?.previewState === 'ready'
+    && call.subtask.status.type !== 'busy'
+    ? [...call.subtask.messages].reverse().find(
+        (message) => message.role === 'assistant' && Boolean(message.text),
+      )?.text ?? ''
+    : '';
+  const result = outputText(call) || projectedResult;
+  const terminal = call.subtask
+    ? call.subtask.status.type !== 'busy'
+    : call.status === 'completed' || call.status === 'error';
   return html`
-    ${call.childSessionId
+    ${prompt
       ? html`
-          <button
-            class="harness-subtask-open"
-            type="button"
-            @click=${(event: Event) => {
-              (event.currentTarget as HTMLElement).dispatchEvent(
-                new CustomEvent('harness-subtask-open', {
-                  detail: { sessionId: call.childSessionId, call },
-                  bubbles: true,
-                  composed: true,
-                }),
-              );
-            }}
-          >
-            ${call.status === 'completed' || call.status === 'error'
-              ? 'Open subagent chat'
-              : 'Follow subagent live'}
-          </button>
+          <section class="harness-subtask-detail harness-subtask-detail-brief">
+            <div class="harness-subtask-detail-label">Agent Brief</div>
+            <div class="harness-subtask-detail-text">${prompt}</div>
+          </section>
+        `
+      : ''}
+    ${result || terminal
+      ? html`
+          <section class="harness-subtask-detail harness-subtask-detail-result">
+            <div class="harness-subtask-detail-label">Result</div>
+            <div class="harness-subtask-detail-text">${result || 'No result was returned.'}</div>
+          </section>
         `
       : ''}
-    ${prompt ? helpers.monoBlock(prompt) : ''}
-    ${outputText(call) ? helpers.monoBlock(outputText(call)) : ''}
   `;
 };
 

package/ts_web/elements/00group-harness/harness.helpers.ts

@@ -3,7 +3,13 @@
  * detection, attachment constraints, and defensive value summarization.
  * No DOM access; safe to import from anywhere including tests.
  */
-import type { IHarnessTodoItem } from './interfaces.js';
+import type {
+  IHarnessMessage,
+  IHarnessTodoItem,
+  IHarnessToolCall,
+  THarnessMessageStreamDelta,
+  THarnessToolStatus,
+} from './interfaces.js';
 
 export const harnessMaxAttachmentBytes = 10 * 1024 * 1024;
 export const harnessMaxTotalAttachmentBytes = 30 * 1024 * 1024;
@@ -89,6 +95,17 @@ export const harnessIsRecord = (value: unknown): value is Record<string, unknown
   return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 };
 
+/** Uses the child projection as the status authority for subagent calls. */
+export const harnessEffectiveToolStatus = (callArg: IHarnessToolCall): THarnessToolStatus => {
+  if (callArg.subtask) {
+    if (callArg.subtask.status.type === 'busy') return 'running';
+    if (callArg.subtask.status.type === 'error') return 'error';
+    return 'completed';
+  }
+  if (callArg.isError || callArg.status === 'error') return 'error';
+  return callArg.status;
+};
+
 export const harnessFormatBytes = (bytes: unknown): string => {
   const value = typeof bytes === 'number' && Number.isFinite(bytes) ? bytes : 0;
   if (value < 1024) return `${value} B`;
@@ -153,6 +170,56 @@ export const harnessAttachmentKindFor = (mediaType: string): 'image' | 'text' |
   return 'binary';
 };
 
+/** Mutates one normalized message when no rendered message element owns it. */
+export const harnessApplyMessageDelta = (
+  messages: IHarnessMessage[],
+  delta: THarnessMessageStreamDelta,
+): IHarnessMessage | undefined => {
+  const message = messages.find((candidate) => candidate.id === delta.messageId);
+  if (!message) return undefined;
+  switch (delta.type) {
+    case 'text':
+      message.text += delta.delta;
+      message.streaming = true;
+      break;
+    case 'reasoning-start':
+      message.reasoning ??= [];
+      if (!message.reasoning.some((part) => part.id === delta.partId)) {
+        message.reasoning.push({
+          id: delta.partId,
+          text: '',
+          startedAt: delta.startedAt ?? Date.now(),
+        });
+      }
+      break;
+    case 'reasoning': {
+      message.reasoning ??= [];
+      const part = message.reasoning.find((candidate) => candidate.id === delta.partId);
+      if (part) part.text += delta.delta;
+      else message.reasoning.push({ id: delta.partId, text: delta.delta, startedAt: Date.now() });
+      break;
+    }
+    case 'reasoning-end': {
+      const part = message.reasoning?.find((candidate) => candidate.id === delta.partId);
+      if (part && !part.endedAt) part.endedAt = delta.endedAt ?? Date.now();
+      break;
+    }
+    case 'tool-update':
+      message.toolCall = {
+        ...(message.toolCall ?? { id: delta.tool.id, name: '', status: 'pending' }),
+        ...delta.tool,
+      };
+      break;
+    case 'message-end':
+      message.streaming = false;
+      if (delta.usage) message.usage = delta.usage;
+      if (delta.error) message.error = delta.error;
+      message.updatedAt = Date.now();
+      break;
+  }
+  return message;
+};
+
 export const harnessFileToBase64 = (file: File): Promise<string> =>
   new Promise<string>((resolve, reject) => {
     const reader = new FileReader();

package/ts_web/elements/00group-harness/index.ts

@@ -7,6 +7,7 @@ export * from './harness.helpers.js';
 export { HarnessMarkdown, markdownStyles } from './harness.markdown.js';
 export { harnessCardStyles, harnessPillStyles, harnessMonoStyles } from './harness.styles.js';
 export * from './harness.demodata.js';
+export * from './dees-harness-overflow-text.js';
 
 export * from './dees-harness-chat/index.js';
 export * from './dees-harness-composer/index.js';

package/ts_web/elements/00group-harness/interfaces.ts

@@ -170,6 +170,8 @@ export interface IHarnessToolCall {
   status: THarnessToolStatus;
   input?: unknown;
   output?: unknown;
+  /** Process exit code when output is a combined stream rather than stdout/stderr fields. */
+  exitCode?: number;
   /** MCP CallToolResult.content, rendered structurally when present */
   contentBlocks?: THarnessContentBlock[];
   /** MCP CallToolResult.structuredContent */
@@ -180,6 +182,8 @@ export interface IHarnessToolCall {
   mcp?: IHarnessMcpMeta;
   /** Session spawned by this call (subagent/task tools); enables drill-in. */
   childSessionId?: string;
+  /** Bounded live preview of the spawned session. Consumers own hydration. */
+  subtask?: IHarnessSubtaskStream;
   /** model the spawned session runs on, e.g. "anthropic/claude-opus-5" */
   model?: string;
   /** epoch ms */
@@ -187,6 +191,29 @@ export interface IHarnessToolCall {
   finishedAt?: number;
 }
 
+interface IHarnessSubtaskStreamBase {
+  sessionId: string;
+  status: IHarnessStatus;
+}
+
+export type IHarnessSubtaskStream =
+  | (IHarnessSubtaskStreamBase & {
+      previewState: 'loading';
+      notice?: string;
+    })
+  | (IHarnessSubtaskStreamBase & {
+      previewState: 'ready';
+      messages: IHarnessMessage[];
+      permissions?: IHarnessPermissionRequest[];
+      questions?: IHarnessQuestionRequest[];
+      truncated?: boolean;
+      notice?: string;
+    })
+  | (IHarnessSubtaskStreamBase & {
+      previewState: 'unavailable';
+      notice: string;
+    });
+
 /** Detail of `harness-subtask-open`, fired when a subagent card is drilled into. */
 export interface IHarnessSubtaskOpenDetail {
   sessionId: string;
@@ -266,7 +293,7 @@ export interface IHarnessSessionMeta {
   icon?: string;
   /** Visual card state. Defaults to `normal`. */
   state?: THarnessSessionCardState;
-  /** Independent activity signal used for idle-to-working auto-expansion. */
+  /** Independent activity signal for hosts that track work separately from the visual state. */
   working?: boolean;
   /** Set false for pinned, non-sortable entries such as terminals. Defaults to true. */
   draggable?: boolean;
@@ -338,10 +365,19 @@ export interface IHarnessComposerSendDetail {
  * re-assignment is idempotent) and re-render only the affected message
  * element.
  */
-export type THarnessStreamDelta =
+export type THarnessMessageStreamDelta =
   | { type: 'text'; messageId: string; delta: string }
   | { type: 'reasoning-start'; messageId: string; partId: string; startedAt?: number }
   | { type: 'reasoning'; messageId: string; partId: string; delta: string }
   | { type: 'reasoning-end'; messageId: string; partId: string; endedAt?: number }
   | { type: 'tool-update'; messageId: string; tool: Partial<IHarnessToolCall> & { id: string } }
   | { type: 'message-end'; messageId: string; usage?: IHarnessUsage; error?: string };
+
+/**
+ * A delta without `parentMessageId` addresses the outer transcript. Setting
+ * it routes the same update into one subtask transcript; inline recursion is
+ * intentionally limited to one level.
+ */
+export type THarnessStreamDelta = THarnessMessageStreamDelta & {
+  parentMessageId?: string;
+};

package/ts_web/elements/00group-harness/toolregistry.ts

@@ -22,6 +22,8 @@ export interface IHarnessToolRenderHelpers {
   image(dataBase64: string, mimeType: string, alt?: string): TemplateResult;
 }
 
+export type THarnessToolLayout = 'compact' | 'full-row' | 'subtask';
+
 export interface IHarnessToolDescriptor {
   /** stable kind id, e.g. 'terminal', 'file-read', 'mcp', 'unknown' */
   kind: string;
@@ -40,6 +42,8 @@ export interface IHarnessToolDescriptor {
    */
   renderBody?: (call: IHarnessToolCall, helpers: IHarnessToolRenderHelpers) => TemplateResult;
   defaultExpanded?: boolean | ((call: IHarnessToolCall) => boolean);
+  /** Transcript grid packing; omitted descriptors use the compact layout. */
+  layout?: THarnessToolLayout;
   /** styles the card with a destructive accent regardless of status */
   destructive?: boolean;
 }
@@ -81,6 +85,7 @@ const defaultDescriptors: IHarnessToolDescriptor[] = [
       return command ? `${command}${cwd ? ` — in ${cwd}` : ''}` : harnessSummaryLine(call.input);
     },
     defaultExpanded: true,
+    layout: 'full-row',
   },
   {
     kind: 'file-read',
@@ -111,6 +116,7 @@ const defaultDescriptors: IHarnessToolDescriptor[] = [
       return harnessSummaryLine(call.input);
     },
     defaultExpanded: true,
+    layout: 'full-row',
   },
   {
     kind: 'file-delete',
@@ -179,6 +185,8 @@ const defaultDescriptors: IHarnessToolDescriptor[] = [
         || harnessSummaryLine(call.input);
       return call.model ? `${description} — ${call.model}` : description;
     },
+    defaultExpanded: (call) => call.subtask?.status.type === 'busy',
+    layout: 'subtask',
   },
   {
     kind: 'question',
@@ -282,6 +290,10 @@ export class DeesHarnessToolRegistry {
     return this.resolve({ id: '', name, status: 'completed' }).kind;
   }
 
+  public resolveLayout(call: IHarnessToolCall): THarnessToolLayout {
+    return this.resolve(call).layout ?? 'compact';
+  }
+
   /** Isolated copy for demos, tests, or per-pane toolsets. */
   public fork(): DeesHarnessToolRegistry {
     return new DeesHarnessToolRegistry(this.descriptors.map((descriptor) => ({ ...descriptor })));