Function postProcessSession

src/runtime/tool-invoker.ts:213–264

(params: {
  tool: ToolDefinition;
  session: RenderSession;
  ctx: ToolHandlerContext;
  catalog: ToolCatalog;
  runtime: InvokeOptions['runtime'];
  applyTemplateNextSteps?: boolean;
})

}

export function postProcessSession(params: {
  tool: ToolDefinition;
  session: RenderSession;
  ctx: ToolHandlerContext;
  catalog: ToolCatalog;
  runtime: InvokeOptions['runtime'];
  applyTemplateNextSteps?: boolean;
}): void {
  const { tool, session, ctx, catalog, runtime, applyTemplateNextSteps = true } = params;

  const isError = session.isError();
  const nextStepParams = ctx.nextStepParams;
  const handlerNextSteps = ctx.nextSteps;
  const suppressNextStepsForStructuredFailure =
    isError && isStructuredXcodebuildFailureSession(session);

  if (suppressNextStepsForStructuredFailure) {
    return;
  }

  const suppressTemplateNextSteps = handlerNextSteps !== undefined && handlerNextSteps.length === 0;

  const effectiveNextStepParams = buildEffectiveNextStepParams(
    nextStepParams,
    handlerNextSteps,
    catalog,
  );

  const allTemplateSteps = buildTemplateNextSteps(tool, catalog);
  const templateSteps = allTemplateSteps.filter((t) => {
    const when = t.step.when ?? 'always';
    if (when === 'success') return !isError;
    if (when === 'failure') return isError;
    return true;
  });

  let finalSteps: NextStep[];

  if (applyTemplateNextSteps && !suppressTemplateNextSteps && templateSteps.length > 0) {
    finalSteps = mergeTemplateAndResponseNextSteps(templateSteps, effectiveNextStepParams);
  } else if (handlerNextSteps && handlerNextSteps.length > 0) {
    finalSteps = handlerNextSteps;
  } else {
    return;
  }

  const normalized = normalizeNextSteps(finalSteps, catalog, tool.workflow);

  if (normalized.length > 0) {
    session.setNextSteps?.(normalized, runtime);
  }
}

function buildDaemonEnvOverrides(opts: InvokeOptions): Record<string, string> | undefined {
  if (!opts.logLevel) {