Function callHandler

src/test-utils/test-helpers.ts:145–175

(
  handler:
    | ToolHandler
    | ((args: Record<string, unknown>, ctx?: ToolHandlerContext) => Promise<void>),
  args: Record<string, unknown>,
)

 * returning a ToolResponse-shaped result for backward-compatible assertions.
 */
export async function callHandler(
  handler:
    | ToolHandler
    | ((args: Record<string, unknown>, ctx?: ToolHandlerContext) => Promise<void>),
  args: Record<string, unknown>,
): Promise<CallHandlerResult> {
  const session = createRenderSession('text');
  const ctx: ToolHandlerContext = {
    emit: (fragment: AnyFragment) => {
      session.emit(fragment);
    },
    attach: (image) => session.attach(image),
  };
  await handler(args, ctx);
  if (ctx.structuredOutput) {
    session.setStructuredOutput?.(ctx.structuredOutput);
  }
  if (ctx.nextSteps && ctx.nextSteps.length > 0) {
    session.setNextSteps?.([...ctx.nextSteps], 'cli');
  }
  const text = renderCliTextTranscript({
    items: [],
    structuredOutput: ctx.structuredOutput,
    nextSteps: ctx.nextSteps,
  });
  return {
    content: text ? [{ type: 'text' as const, text }] : [],
    isError: session.isError() || undefined,
    nextStepParams: ctx.nextStepParams,
  };
}

function isMockToolHandlerResult(
  result: ToolResponse | MockToolHandlerResult,