@jmoyers/harness 0.1.10 → 0.1.20

package/src/control-plane/prompt/thread-title-namer.ts

@@ -35,7 +35,8 @@ const FALLBACK_STOP_WORDS = new Set([
   'up',
   'with',
 ]);
-const DEFAULT_HAIKU_MODEL_ID = 'claude-3-5-haiku-latest';
+const DEFAULT_HAIKU_MODEL_ID = 'claude-haiku-4-5-20251001';
+const FALLBACK_HAIKU_MODEL_IDS = ['claude-3-haiku-20240307'] as const;
 
 interface ThreadTitlePromptHistoryEntry {
   readonly text: string;
@@ -61,6 +62,22 @@ interface AnthropicThreadTitleNamerOptions {
   readonly fetch?: typeof fetch;
 }
 
+function resolveModelCandidateIds(modelId: string | undefined): readonly string[] {
+  const ordered = [modelId, DEFAULT_HAIKU_MODEL_ID, ...FALLBACK_HAIKU_MODEL_IDS];
+  const deduped: string[] = [];
+  for (const candidate of ordered) {
+    if (typeof candidate !== 'string') {
+      continue;
+    }
+    const trimmed = candidate.trim();
+    if (trimmed.length === 0 || deduped.includes(trimmed)) {
+      continue;
+    }
+    deduped.push(trimmed);
+  }
+  return deduped;
+}
+
 function asRecord(value: unknown): Record<string, unknown> | null {
   if (typeof value !== 'object' || value === null || Array.isArray(value)) {
     return null;
@@ -255,7 +272,7 @@ export function createAnthropicThreadTitleNamer(
     ...(options.baseUrl === undefined ? {} : { baseUrl: options.baseUrl }),
     ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
   });
-  const model = anthropic(options.modelId ?? DEFAULT_HAIKU_MODEL_ID);
+  const modelCandidateIds = resolveModelCandidateIds(options.modelId);
   return {
     async suggest(input: ThreadTitleNamerInput): Promise<string | null> {
       if (input.promptHistory.length === 0) {
@@ -264,27 +281,36 @@ export function createAnthropicThreadTitleNamer(
       const promptLines = input.promptHistory.map(
         (entry, index) => `${String(index + 1)}. ${entry.text}`,
       );
-      const response = await generateText({
-        model,
-        system: [
-          'You name active coding-agent threads.',
-          'Use the full user prompt history to keep titles relevant and fresh.',
-          'Stay high-level and avoid low-level implementation details.',
-          'Return exactly 2 words in lowercase with no punctuation and no extra text.',
-        ].join(' '),
-        prompt: [
-          `Agent: ${input.agentType}`,
-          `Current title: ${input.currentTitle}`,
-          `Conversation id: ${input.conversationId}`,
-          'Prompt history (oldest to newest):',
-          ...promptLines,
-          'Return a new title now.',
-        ].join('\n'),
-        maxOutputTokens: 16,
-        temperature: 0,
-      });
-      const normalized = normalizeThreadTitleCandidate(response.text);
-      return normalized ?? fallbackThreadTitleFromPromptHistory(input.promptHistory);
+      for (const modelId of modelCandidateIds) {
+        const model = anthropic(modelId);
+        const response = await generateText({
+          model,
+          system: [
+            'You name active coding-agent threads.',
+            'Use the full user prompt history to keep titles relevant and fresh.',
+            'Stay high-level and avoid low-level implementation details.',
+            'Return exactly 2 words in lowercase with no punctuation and no extra text.',
+          ].join(' '),
+          prompt: [
+            `Agent: ${input.agentType}`,
+            `Current title: ${input.currentTitle}`,
+            `Conversation id: ${input.conversationId}`,
+            'Prompt history (oldest to newest):',
+            ...promptLines,
+            'Return a new title now.',
+          ].join('\n'),
+          maxOutputTokens: 16,
+          temperature: 0,
+        });
+        const normalized = normalizeThreadTitleCandidate(response.text);
+        if (normalized !== null) {
+          return normalized;
+        }
+        if (response.finishReason !== 'error') {
+          break;
+        }
+      }
+      return fallbackThreadTitleFromPromptHistory(input.promptHistory);
     },
   };
 }

package/src/control-plane/session-summary.ts

@@ -1,10 +1,12 @@
 import type { PtyExit } from '../pty/pty_host.ts';
-import type {
-  StreamSessionController,
-  StreamSessionControllerType,
-  StreamSessionRuntimeStatus,
-  StreamSessionStatusModel,
-  StreamTelemetrySummary,
+import {
+  isStreamSessionRuntimeStatus,
+  parseStreamSessionStatusModel,
+  type StreamSessionController,
+  type StreamSessionControllerType,
+  type StreamSessionRuntimeStatus,
+  type StreamSessionStatusModel,
+  type StreamTelemetrySummary,
 } from './stream-protocol.ts';
 
 interface StreamSessionSummary {
@@ -187,79 +189,6 @@ function readSessionController(value: unknown): StreamSessionController | null |
   };
 }
 
-function readSessionStatusModel(value: unknown): StreamSessionStatusModel | null | undefined {
-  if (value === undefined) {
-    return undefined;
-  }
-  if (value === null) {
-    return null;
-  }
-  const record = asRecord(value);
-  if (record === null) {
-    return undefined;
-  }
-  const runtimeStatus = readString(record['runtimeStatus']);
-  const phase = readString(record['phase']);
-  const glyph = readString(record['glyph']);
-  const badge = readString(record['badge']);
-  const detailText = readString(record['detailText']);
-  const attentionReason = readNullableString(record['attentionReason']);
-  const lastKnownWork = readNullableString(record['lastKnownWork']);
-  const lastKnownWorkAt = readNullableString(record['lastKnownWorkAt']);
-  const phaseHintRaw = readNullableString(record['phaseHint']);
-  const observedAt = readString(record['observedAt']);
-  if (
-    runtimeStatus === null ||
-    !isRuntimeStatus(runtimeStatus) ||
-    phase === null ||
-    (phase !== 'needs-action' &&
-      phase !== 'starting' &&
-      phase !== 'working' &&
-      phase !== 'idle' &&
-      phase !== 'exited') ||
-    glyph === null ||
-    (glyph !== '▲' && glyph !== '◔' && glyph !== '◆' && glyph !== '○' && glyph !== '■') ||
-    badge === null ||
-    (badge !== 'NEED' && badge !== 'RUN ' && badge !== 'DONE' && badge !== 'EXIT') ||
-    detailText === null ||
-    attentionReason === undefined ||
-    lastKnownWork === undefined ||
-    lastKnownWorkAt === undefined ||
-    phaseHintRaw === undefined ||
-    observedAt === null
-  ) {
-    return undefined;
-  }
-  const phaseHint =
-    phaseHintRaw === null ||
-    phaseHintRaw === 'needs-action' ||
-    phaseHintRaw === 'working' ||
-    phaseHintRaw === 'idle'
-      ? phaseHintRaw
-      : undefined;
-  if (phaseHint === undefined) {
-    return undefined;
-  }
-  return {
-    runtimeStatus,
-    phase,
-    glyph,
-    badge,
-    detailText,
-    attentionReason,
-    lastKnownWork,
-    lastKnownWorkAt,
-    phaseHint,
-    observedAt,
-  };
-}
-
-function isRuntimeStatus(value: string): value is StreamSessionRuntimeStatus {
-  return (
-    value === 'running' || value === 'needs-input' || value === 'completed' || value === 'exited'
-  );
-}
-
 export function parseSessionSummaryRecord(value: unknown): StreamSessionSummary | null {
   const record = asRecord(value);
   if (record === null) {
@@ -280,12 +209,12 @@ export function parseSessionSummaryRecord(value: unknown): StreamSessionSummary
     workspaceId === null ||
     worktreeId === null ||
     status === null ||
-    !isRuntimeStatus(status)
+    !isStreamSessionRuntimeStatus(status)
   ) {
     return null;
   }
   const attentionReason = readNullableString(record['attentionReason']);
-  const statusModel = readSessionStatusModel(record['statusModel']);
+  const statusModel = parseStreamSessionStatusModel(record['statusModel']);
   const latestCursor = readNullableNumber(record['latestCursor']);
   const processId = readNullableNumber(record['processId']);
   const attachedClients = readNumber(record['attachedClients']);

package/src/control-plane/status/reducer-base.ts

@@ -8,7 +8,7 @@ import type { AgentStatusProjectionInput, AgentStatusReducer } from './agent-sta
 
 interface WorkProjection {
   readonly text: string | null;
-  readonly phaseHint: 'needs-action' | 'working' | 'idle' | null;
+  readonly activityHint: 'needs-action' | 'working' | 'idle' | null;
 }
 
 function normalizeText(value: string | null): string | null {
@@ -40,7 +40,7 @@ function eventIsNewer(observedAt: string, previousObservedAt: string | null): bo
 
 function phaseFromRuntimeStatus(
   runtimeStatus: StreamSessionRuntimeStatus,
-  phaseHint: WorkProjection['phaseHint'],
+  activityHint: WorkProjection['activityHint'],
 ): StreamSessionDisplayPhase {
   if (runtimeStatus === 'needs-input') {
     return 'needs-action';
@@ -48,13 +48,13 @@ function phaseFromRuntimeStatus(
   if (runtimeStatus === 'exited') {
     return 'exited';
   }
-  if (phaseHint === 'working') {
+  if (activityHint === 'working') {
     return 'working';
   }
-  if (phaseHint === 'needs-action') {
+  if (activityHint === 'needs-action') {
     return 'needs-action';
   }
-  if (phaseHint === 'idle') {
+  if (activityHint === 'idle') {
     return 'idle';
   }
   if (runtimeStatus === 'running') {
@@ -118,14 +118,14 @@ export abstract class BaseAgentStatusReducer implements AgentStatusReducer {
   project(input: AgentStatusProjectionInput): StreamSessionStatusModel | null {
     const previous = input.previous;
     let workText = previous?.lastKnownWork ?? null;
-    let workPhaseHint = previous?.phaseHint ?? null;
+    let workActivityHint = previous?.activityHint ?? null;
     let workObservedAt = previous?.lastKnownWorkAt ?? null;
 
     if (input.telemetry !== null && eventIsNewer(input.telemetry.observedAt, workObservedAt)) {
       const projected = this.projectFromTelemetry(input.telemetry);
       if (projected !== null) {
         workText = projected.text;
-        workPhaseHint = projected.phaseHint;
+        workActivityHint = projected.activityHint;
         workObservedAt = input.telemetry.observedAt;
       }
     }
@@ -133,19 +133,19 @@ export abstract class BaseAgentStatusReducer implements AgentStatusReducer {
     if (
       input.runtimeStatus === 'completed' &&
       eventIsNewer(input.observedAt, workObservedAt) &&
-      workPhaseHint !== 'needs-action'
+      workActivityHint !== 'needs-action'
     ) {
       workText = 'inactive';
-      workPhaseHint = 'idle';
+      workActivityHint = 'idle';
       workObservedAt = input.observedAt;
     }
     if (input.runtimeStatus === 'exited' && eventIsNewer(input.observedAt, workObservedAt)) {
       workText = 'exited';
-      workPhaseHint = 'idle';
+      workActivityHint = 'idle';
       workObservedAt = input.observedAt;
     }
 
-    const phase = phaseFromRuntimeStatus(input.runtimeStatus, workPhaseHint);
+    const phase = phaseFromRuntimeStatus(input.runtimeStatus, workActivityHint);
     const normalizedAttentionReason = normalizeText(input.attentionReason);
     const detailText =
       (input.runtimeStatus === 'needs-input' ? normalizedAttentionReason : null) ??
@@ -162,7 +162,7 @@ export abstract class BaseAgentStatusReducer implements AgentStatusReducer {
       attentionReason: normalizedAttentionReason,
       lastKnownWork: workText,
       lastKnownWorkAt: workObservedAt,
-      phaseHint: workPhaseHint,
+      activityHint: workActivityHint,
       observedAt: input.observedAt,
     };
   }

package/src/control-plane/status/reducers/claude-status-reducer.ts

@@ -14,12 +14,12 @@ export class ClaudeStatusReducer extends BaseAgentStatusReducer {
 
   protected override projectFromTelemetry(
     telemetry: StreamTelemetrySummary,
-  ): { text: string | null; phaseHint: 'needs-action' | 'working' | 'idle' | null } | null {
+  ): { text: string | null; activityHint: 'needs-action' | 'working' | 'idle' | null } | null {
     const eventName = normalize(telemetry.eventName);
     if (eventName === 'claude.userpromptsubmit' || eventName === 'claude.pretooluse') {
       return {
         text: 'active',
-        phaseHint: 'working',
+        activityHint: 'working',
       };
     }
     if (
@@ -29,7 +29,7 @@ export class ClaudeStatusReducer extends BaseAgentStatusReducer {
     ) {
       return {
         text: 'inactive',
-        phaseHint: 'idle',
+        activityHint: 'idle',
       };
     }
     return null;

package/src/control-plane/status/reducers/codex-status-reducer.ts

@@ -14,19 +14,19 @@ export class CodexStatusReducer extends BaseAgentStatusReducer {
 
   protected override projectFromTelemetry(
     telemetry: StreamTelemetrySummary,
-  ): { text: string | null; phaseHint: 'needs-action' | 'working' | 'idle' | null } | null {
+  ): { text: string | null; activityHint: 'needs-action' | 'working' | 'idle' | null } | null {
     const eventName = normalize(telemetry.eventName);
     const summary = normalize(telemetry.summary);
     if (eventName === 'codex.user_prompt') {
       return {
         text: 'active',
-        phaseHint: 'working',
+        activityHint: 'working',
       };
     }
     if (eventName === 'codex.turn.e2e_duration_ms') {
       return {
         text: 'inactive',
-        phaseHint: 'idle',
+        activityHint: 'idle',
       };
     }
     if (eventName === 'codex.sse_event') {
@@ -39,7 +39,7 @@ export class CodexStatusReducer extends BaseAgentStatusReducer {
       ) {
         return {
           text: 'active',
-          phaseHint: 'working',
+          activityHint: 'working',
         };
       }
     }

package/src/control-plane/status/reducers/cursor-status-reducer.ts

@@ -14,7 +14,7 @@ export class CursorStatusReducer extends BaseAgentStatusReducer {
 
   protected override projectFromTelemetry(
     telemetry: StreamTelemetrySummary,
-  ): { text: string | null; phaseHint: 'needs-action' | 'working' | 'idle' | null } | null {
+  ): { text: string | null; activityHint: 'needs-action' | 'working' | 'idle' | null } | null {
     const eventName = normalize(telemetry.eventName);
     if (
       eventName === 'cursor.beforesubmitprompt' ||
@@ -23,13 +23,13 @@ export class CursorStatusReducer extends BaseAgentStatusReducer {
     ) {
       return {
         text: 'active',
-        phaseHint: 'working',
+        activityHint: 'working',
       };
     }
     if (eventName === 'cursor.stop' || eventName === 'cursor.sessionend') {
       return {
         text: 'inactive',
-        phaseHint: 'idle',
+        activityHint: 'idle',
       };
     }
     return null;

package/src/control-plane/stream-client.ts

@@ -26,7 +26,17 @@ interface PendingCommand {
   reject: (error: Error) => void;
 }
 
-export class ControlPlaneStreamClient {
+export interface ControlPlaneStreamClient {
+  onEnvelope(listener: (envelope: StreamServerEnvelope) => void): () => void;
+  sendCommand(command: StreamCommand): Promise<Record<string, unknown>>;
+  authenticate(token: string): Promise<void>;
+  sendInput(sessionId: string, data: Buffer): void;
+  sendResize(sessionId: string, cols: number, rows: number): void;
+  sendSignal(sessionId: string, signal: StreamSignal): void;
+  close(): void;
+}
+
+class ControlPlaneStreamClientImpl implements ControlPlaneStreamClient {
   private readonly socket: Socket;
   private readonly listeners = new Set<(envelope: StreamServerEnvelope) => void>();
   private readonly pending = new Map<string, PendingCommand>();
@@ -380,7 +390,7 @@ export async function connectControlPlaneStreamClient(
     }
   }
 
-  const client = new ControlPlaneStreamClient(socket);
+  const client = new ControlPlaneStreamClientImpl(socket);
   if (typeof options.authToken === 'string') {
     await client.authenticate(options.authToken);
   }