@jmoyers/harness 0.1.0

package/src/adapters/agent-session-state.ts

@@ -0,0 +1,390 @@
+import type { StreamSessionEvent } from '../control-plane/stream-protocol.ts';
+
+const CODEX_EXPLICIT_SUBCOMMANDS = new Set([
+  'exec',
+  'review',
+  'login',
+  'logout',
+  'mcp',
+  'mcp-server',
+  'app-server',
+  'app',
+  'completion',
+  'sandbox',
+  'debug',
+  'apply',
+  'resume',
+  'fork',
+  'cloud',
+  'features',
+  'help',
+]);
+
+const CLAUDE_EXPLICIT_SUBCOMMANDS = new Set([
+  'doctor',
+  'install',
+  'mcp',
+  'plugin',
+  'setup-token',
+  'update',
+  'help',
+]);
+
+type CodexLaunchMode = 'yolo' | 'standard';
+type ClaudeLaunchMode = 'yolo' | 'standard';
+type CursorLaunchMode = 'yolo' | 'standard';
+
+interface BuildAgentSessionStartArgsOptions {
+  readonly directoryPath?: string | null;
+  readonly codexLaunchDefaultMode?: CodexLaunchMode;
+  readonly codexLaunchModeByDirectoryPath?: Readonly<Record<string, CodexLaunchMode>>;
+  readonly claudeLaunchDefaultMode?: ClaudeLaunchMode;
+  readonly claudeLaunchModeByDirectoryPath?: Readonly<Record<string, ClaudeLaunchMode>>;
+  readonly cursorLaunchDefaultMode?: CursorLaunchMode;
+  readonly cursorLaunchModeByDirectoryPath?: Readonly<Record<string, CursorLaunchMode>>;
+}
+
+function asRecord(value: unknown): Record<string, unknown> | null {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    return null;
+  }
+  return value as Record<string, unknown>;
+}
+
+function readString(value: unknown): string | null {
+  return typeof value === 'string' ? value : null;
+}
+
+function readNonEmptyString(value: unknown): string | null {
+  const raw = readString(value);
+  if (raw === null) {
+    return null;
+  }
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
+function firstNonOptionArg(args: readonly string[]): string | null {
+  for (const arg of args) {
+    if (arg === '--') {
+      return null;
+    }
+    if (arg.startsWith('-')) {
+      continue;
+    }
+    return arg;
+  }
+  return null;
+}
+
+export function normalizeAdapterState(value: unknown): Record<string, unknown> {
+  const normalized = asRecord(value);
+  if (normalized === null) {
+    return {};
+  }
+  return {
+    ...normalized,
+  };
+}
+
+export function codexResumeSessionIdFromAdapterState(
+  adapterState: Record<string, unknown>,
+): string | null {
+  const codex = asRecord(adapterState['codex']);
+  if (codex === null) {
+    return null;
+  }
+  const resumeSessionId = readNonEmptyString(codex['resumeSessionId']);
+  if (resumeSessionId !== null) {
+    return resumeSessionId;
+  }
+  const legacyThreadId = readNonEmptyString(codex['threadId']);
+  if (legacyThreadId !== null) {
+    return legacyThreadId;
+  }
+  return null;
+}
+
+export function claudeResumeSessionIdFromAdapterState(
+  adapterState: Record<string, unknown>,
+): string | null {
+  const claude = asRecord(adapterState['claude']);
+  if (claude === null) {
+    return null;
+  }
+  const resumeSessionId = readNonEmptyString(claude['resumeSessionId']);
+  if (resumeSessionId !== null) {
+    return resumeSessionId;
+  }
+  return readNonEmptyString(claude['sessionId']);
+}
+
+export function cursorResumeSessionIdFromAdapterState(
+  adapterState: Record<string, unknown>,
+): string | null {
+  const cursor = asRecord(adapterState['cursor']);
+  if (cursor === null) {
+    return null;
+  }
+  const resumeSessionId = readNonEmptyString(cursor['resumeSessionId']);
+  if (resumeSessionId !== null) {
+    return resumeSessionId;
+  }
+  const conversationId = readNonEmptyString(cursor['conversationId']);
+  if (conversationId !== null) {
+    return conversationId;
+  }
+  return readNonEmptyString(cursor['sessionId']);
+}
+
+export function mergeAdapterStateFromSessionEvent(
+  agentType: string,
+  _currentState?: Record<string, unknown>,
+  _event?: StreamSessionEvent,
+  _observedAt?: string,
+): Record<string, unknown> | null {
+  if (_event?.type !== 'notify') {
+    return null;
+  }
+  const payload = asRecord(_event.record.payload);
+  if (agentType === 'claude') {
+    const sessionId =
+      readNonEmptyString(payload?.['session_id']) ?? readNonEmptyString(payload?.['sessionId']);
+    if (sessionId === null) {
+      return null;
+    }
+
+    const currentState = normalizeAdapterState(_currentState ?? {});
+    const claude = asRecord(currentState['claude']) ?? {};
+    const currentResumeSessionId = readNonEmptyString(claude['resumeSessionId']);
+    const lastObservedAt = readNonEmptyString(claude['lastObservedAt']);
+    const nextObservedAt = readNonEmptyString(_observedAt) ?? lastObservedAt ?? null;
+    if (currentResumeSessionId === sessionId && nextObservedAt === lastObservedAt) {
+      return null;
+    }
+
+    return {
+      ...currentState,
+      claude: {
+        ...claude,
+        resumeSessionId: sessionId,
+        ...(nextObservedAt === null ? {} : { lastObservedAt: nextObservedAt }),
+      },
+    };
+  }
+  if (agentType !== 'cursor') {
+    return null;
+  }
+  const conversationId =
+    readNonEmptyString(payload?.['conversation_id']) ??
+    readNonEmptyString(payload?.['conversationId']);
+  const rawSessionId =
+    readNonEmptyString(payload?.['session_id']) ?? readNonEmptyString(payload?.['sessionId']);
+  const harnessSessionId =
+    readNonEmptyString(payload?.['harness_session_id']) ??
+    readNonEmptyString(payload?.['harnessSessionId']);
+  const sessionId =
+    conversationId ??
+    (rawSessionId !== null && rawSessionId !== harnessSessionId ? rawSessionId : null);
+  if (sessionId === null) {
+    return null;
+  }
+  const currentState = normalizeAdapterState(_currentState ?? {});
+  const cursor = asRecord(currentState['cursor']) ?? {};
+  const currentResumeSessionId = readNonEmptyString(cursor['resumeSessionId']);
+  const lastObservedAt = readNonEmptyString(cursor['lastObservedAt']);
+  const nextObservedAt = readNonEmptyString(_observedAt) ?? lastObservedAt ?? null;
+  if (currentResumeSessionId === sessionId && nextObservedAt === lastObservedAt) {
+    return null;
+  }
+  return {
+    ...currentState,
+    cursor: {
+      ...cursor,
+      resumeSessionId: sessionId,
+      ...(nextObservedAt === null ? {} : { lastObservedAt: nextObservedAt }),
+    },
+  };
+}
+
+function hasCursorResumeArg(args: readonly string[]): boolean {
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === '--resume' || arg === '-r') {
+      return true;
+    }
+  }
+  return false;
+}
+
+function hasCursorPrintOrHeadlessArg(args: readonly string[]): boolean {
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === '--print' || arg === '--headless') {
+      return true;
+    }
+    if (arg === '--mode') {
+      const next = args[index + 1];
+      if (next === 'headless') {
+        return true;
+      }
+      continue;
+    }
+    if (arg?.startsWith('--mode=')) {
+      const mode = arg.slice('--mode='.length);
+      if (mode === 'headless') {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+
+function hasClaudeResumeArg(args: readonly string[]): boolean {
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (
+      arg === '--resume' ||
+      arg === '-r' ||
+      arg === '--continue' ||
+      arg === '-c' ||
+      arg === '--session-id'
+    ) {
+      return true;
+    }
+  }
+  return false;
+}
+
+export function buildAgentStartArgs(
+  agentType: string,
+  baseArgs: readonly string[],
+  adapterState: Record<string, unknown>,
+  options?: {
+    codexLaunchMode?: CodexLaunchMode;
+    claudeLaunchMode?: ClaudeLaunchMode;
+    cursorLaunchMode?: CursorLaunchMode;
+  },
+): string[] {
+  if (agentType === 'codex') {
+    const firstArg = firstNonOptionArg(baseArgs);
+    if (firstArg !== null && CODEX_EXPLICIT_SUBCOMMANDS.has(firstArg)) {
+      return [...baseArgs];
+    }
+
+    const codexLaunchMode = options?.codexLaunchMode ?? 'standard';
+    const argsWithLaunchMode =
+      codexLaunchMode === 'yolo' && !baseArgs.includes('--yolo')
+        ? [...baseArgs, '--yolo']
+        : [...baseArgs];
+
+    const resumeSessionId = codexResumeSessionIdFromAdapterState(adapterState);
+    if (resumeSessionId === null) {
+      return argsWithLaunchMode;
+    }
+
+    return ['resume', resumeSessionId, ...argsWithLaunchMode];
+  }
+
+  if (agentType === 'claude') {
+    const firstArg = firstNonOptionArg(baseArgs);
+    if (firstArg !== null && CLAUDE_EXPLICIT_SUBCOMMANDS.has(firstArg)) {
+      return [...baseArgs];
+    }
+
+    const claudeLaunchMode = options?.claudeLaunchMode ?? 'standard';
+    const argsWithLaunchMode =
+      claudeLaunchMode === 'yolo' && !baseArgs.includes('--dangerously-skip-permissions')
+        ? [...baseArgs, '--dangerously-skip-permissions']
+        : [...baseArgs];
+
+    if (hasClaudeResumeArg(baseArgs)) {
+      return argsWithLaunchMode;
+    }
+    const resumeSessionId = claudeResumeSessionIdFromAdapterState(adapterState);
+    if (resumeSessionId === null) {
+      return argsWithLaunchMode;
+    }
+    return ['--resume', resumeSessionId, ...argsWithLaunchMode];
+  }
+
+  if (agentType === 'cursor') {
+    const cursorLaunchMode = options?.cursorLaunchMode ?? 'standard';
+    const argsWithLaunchMode = [...baseArgs];
+    if (
+      cursorLaunchMode === 'yolo' &&
+      !argsWithLaunchMode.includes('--yolo') &&
+      !argsWithLaunchMode.includes('--force')
+    ) {
+      argsWithLaunchMode.push('--yolo');
+    }
+    if (
+      cursorLaunchMode === 'yolo' &&
+      hasCursorPrintOrHeadlessArg(argsWithLaunchMode) &&
+      !argsWithLaunchMode.includes('--trust')
+    ) {
+      argsWithLaunchMode.push('--trust');
+    }
+
+    if (hasCursorResumeArg(baseArgs)) {
+      return argsWithLaunchMode;
+    }
+    const resumeSessionId = cursorResumeSessionIdFromAdapterState(adapterState);
+    if (resumeSessionId === null) {
+      return argsWithLaunchMode;
+    }
+    return ['--resume', resumeSessionId, ...argsWithLaunchMode];
+  }
+
+  return [...baseArgs];
+}
+
+export function buildAgentSessionStartArgs(
+  agentType: string,
+  baseArgs: readonly string[],
+  adapterState: Record<string, unknown>,
+  options: BuildAgentSessionStartArgsOptions = {},
+): string[] {
+  const normalizedDirectoryPath = options.directoryPath?.trim() ?? '';
+
+  if (agentType === 'codex') {
+    const defaultMode = options.codexLaunchDefaultMode ?? 'standard';
+    const directoryModes = options.codexLaunchModeByDirectoryPath ?? {};
+    const codexLaunchMode =
+      normalizedDirectoryPath.length > 0
+        ? (directoryModes[normalizedDirectoryPath] ?? defaultMode)
+        : defaultMode;
+
+    return buildAgentStartArgs(agentType, baseArgs, adapterState, {
+      codexLaunchMode,
+    });
+  }
+
+  if (agentType === 'claude') {
+    const defaultMode = options.claudeLaunchDefaultMode ?? 'standard';
+    const directoryModes = options.claudeLaunchModeByDirectoryPath ?? {};
+    const claudeLaunchMode =
+      normalizedDirectoryPath.length > 0
+        ? (directoryModes[normalizedDirectoryPath] ?? defaultMode)
+        : defaultMode;
+
+    return buildAgentStartArgs(agentType, baseArgs, adapterState, {
+      claudeLaunchMode,
+    });
+  }
+
+  if (agentType === 'cursor') {
+    const defaultMode = options.cursorLaunchDefaultMode ?? 'standard';
+    const directoryModes = options.cursorLaunchModeByDirectoryPath ?? {};
+    const cursorLaunchMode =
+      normalizedDirectoryPath.length > 0
+        ? (directoryModes[normalizedDirectoryPath] ?? defaultMode)
+        : defaultMode;
+
+    return buildAgentStartArgs(agentType, baseArgs, adapterState, {
+      cursorLaunchMode,
+    });
+  }
+
+  return buildAgentStartArgs(agentType, baseArgs, adapterState);
+}

package/src/cli/gateway-record.ts

@@ -0,0 +1,173 @@
+import { resolve } from 'node:path';
+
+export const GATEWAY_RECORD_VERSION = 1;
+export const DEFAULT_GATEWAY_HOST = '127.0.0.1';
+export const DEFAULT_GATEWAY_PORT = 7777;
+export const DEFAULT_GATEWAY_DB_PATH = '.harness/control-plane.sqlite';
+export const DEFAULT_GATEWAY_RECORD_PATH = '.harness/gateway.json';
+export const DEFAULT_GATEWAY_LOG_PATH = '.harness/gateway.log';
+
+export interface GatewayRecord {
+  readonly version: number;
+  readonly pid: number;
+  readonly host: string;
+  readonly port: number;
+  readonly authToken: string | null;
+  readonly stateDbPath: string;
+  readonly startedAt: string;
+  readonly workspaceRoot: string;
+}
+
+function asRecord(value: unknown): Record<string, unknown> | null {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    return null;
+  }
+  return value as Record<string, unknown>;
+}
+
+function readNonEmptyString(value: unknown): string | null {
+  if (typeof value !== 'string') {
+    return null;
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return null;
+  }
+  return trimmed;
+}
+
+function readPort(value: unknown): number | null {
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    return null;
+  }
+  if (!Number.isInteger(value) || value <= 0 || value > 65535) {
+    return null;
+  }
+  return value;
+}
+
+function readPid(value: unknown): number | null {
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    return null;
+  }
+  if (!Number.isInteger(value) || value <= 0) {
+    return null;
+  }
+  return value;
+}
+
+export function resolveInvocationDirectory(env: NodeJS.ProcessEnv, cwd: string): string {
+  return env.HARNESS_INVOKE_CWD ?? env.INIT_CWD ?? cwd;
+}
+
+export function resolveGatewayRecordPath(workspaceRoot: string): string {
+  return resolve(workspaceRoot, DEFAULT_GATEWAY_RECORD_PATH);
+}
+
+export function resolveGatewayLogPath(workspaceRoot: string): string {
+  return resolve(workspaceRoot, DEFAULT_GATEWAY_LOG_PATH);
+}
+
+export function normalizeGatewayHost(
+  input: string | null | undefined,
+  fallback = DEFAULT_GATEWAY_HOST,
+): string {
+  if (typeof input !== 'string') {
+    return fallback;
+  }
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return fallback;
+  }
+  return trimmed;
+}
+
+export function normalizeGatewayPort(
+  input: number | string | null | undefined,
+  fallback = DEFAULT_GATEWAY_PORT,
+): number {
+  if (typeof input === 'number') {
+    return readPort(input) ?? fallback;
+  }
+  if (typeof input !== 'string') {
+    return fallback;
+  }
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return fallback;
+  }
+  const parsed = Number.parseInt(trimmed, 10);
+  return readPort(parsed) ?? fallback;
+}
+
+export function normalizeGatewayStateDbPath(
+  input: string | null | undefined,
+  fallback = DEFAULT_GATEWAY_DB_PATH,
+): string {
+  if (typeof input !== 'string') {
+    return fallback;
+  }
+  const trimmed = input.trim();
+  if (trimmed.length === 0) {
+    return fallback;
+  }
+  return trimmed;
+}
+
+export function isLoopbackHost(host: string): boolean {
+  const normalized = host.trim().toLowerCase();
+  return normalized === '127.0.0.1' || normalized === 'localhost' || normalized === '::1';
+}
+
+export function parseGatewayRecordText(text: string): GatewayRecord | null {
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  const record = asRecord(parsed);
+  if (record === null) {
+    return null;
+  }
+
+  const version = record['version'];
+  if (version !== GATEWAY_RECORD_VERSION) {
+    return null;
+  }
+  const pid = readPid(record['pid']);
+  const host = readNonEmptyString(record['host']);
+  const port = readPort(record['port']);
+  const stateDbPath = readNonEmptyString(record['stateDbPath']);
+  const startedAt = readNonEmptyString(record['startedAt']);
+  const workspaceRoot = readNonEmptyString(record['workspaceRoot']);
+  const authTokenRaw = record['authToken'];
+  const authToken = authTokenRaw === null ? null : readNonEmptyString(authTokenRaw);
+
+  if (
+    pid === null ||
+    host === null ||
+    port === null ||
+    stateDbPath === null ||
+    startedAt === null ||
+    workspaceRoot === null ||
+    (authToken === null && authTokenRaw !== null)
+  ) {
+    return null;
+  }
+
+  return {
+    version,
+    pid,
+    host,
+    port,
+    authToken,
+    stateDbPath,
+    startedAt,
+    workspaceRoot,
+  };
+}
+
+export function serializeGatewayRecord(record: GatewayRecord): string {
+  return `${JSON.stringify(record, null, 2)}\n`;
+}