Function maybeAttachHookSession

lib/transcript.js:148–194

(data, source)

}

function maybeAttachHookSession(data, source) {
  const target = resolveHookTranscript(data);
  if (!target) return;
  let hookSource = null;

  if (state.currentSessionId === target.sessionId && state.transcriptPath &&
      normalizeFsPath(state.transcriptPath) === normalizeFsPath(target.full)) {
    return;
  }

  const targetHasContent = fileLooksLikeTranscript(target.full);

  if (source === 'session-start') {
    hookSource = data.source;
    if (hookSource === 'clear' || hookSource === 'resume') {
      log(`Deterministic session-start (hookSource=${hookSource}): ${target.sessionId}`);
    } else {
      if (state.currentSessionId && !state.expectingSwitch) {
        const currentHasContent = state.transcriptPath && fileLooksLikeTranscript(state.transcriptPath);
        if (!targetHasContent || currentHasContent) {
          if (state.currentSessionId !== target.sessionId) {
            state.pendingSwitchTarget = { ...target, seenAt: Date.now(), source };
            log(`Queued pending session-start: ${target.sessionId} (current=${state.currentSessionId} currentHasContent=${currentHasContent} targetHasContent=${targetHasContent})`);
          }
          log(`Ignored session-start: ${target.sessionId} (current=${state.currentSessionId} currentHasContent=${currentHasContent} targetHasContent=${targetHasContent})`);
          return;
        }
      }
    }
  } else if (source === 'pre-tool-use') {
    if (state.currentSessionId && state.currentSessionId !== target.sessionId && !targetHasContent) {
      log(`Ignored pre-tool-use: ${target.sessionId} (no conversation content)`);
      return;
    }
  } else {
    if (state.currentSessionId && state.currentSessionId !== target.sessionId && !state.expectingSwitch) {
      log(`Ignored hook session from ${source}: ${target.sessionId} (current=${state.currentSessionId})`);
      return;
    }
  }

  log(`Hook session attached from ${source}: ${target.sessionId}`);
  attachTranscript({
    full: target.full,
    ignoreInitialClearCommand: source === 'session-start' && hookSource === 'clear',
  }, 0);
}

function maybeAttachPendingSwitchTarget(reason, requireReady = true) {
  if (!state.pendingSwitchTarget) return false;