Function writeJsonOutput

src/cli/register-tool-commands.ts:102–135

(
  handlerContext: ToolHandlerContext,
  session: ReturnType<typeof createRenderSession>,
  options: { outputStyle: OutputStyle; verbose?: boolean },
)

const UI_ACTION_RESULT_VERBOSE_SCHEMA_VERSION = '3';

function writeJsonOutput(
  handlerContext: ToolHandlerContext,
  session: ReturnType<typeof createRenderSession>,
  options: { outputStyle: OutputStyle; verbose?: boolean },
): boolean {
  const { structuredOutput } = handlerContext;
  const envelope = structuredOutput
    ? toStructuredEnvelope(
        structuredOutput.result,
        structuredOutput.schema,
        structuredOutput.schema === UI_ACTION_RESULT_SCHEMA && options.verbose === true
          ? UI_ACTION_RESULT_VERBOSE_SCHEMA_VERSION
          : structuredOutput.schemaVersion,
        {
          nextSteps: session.getNextSteps?.(),
          nextStepRuntime: session.getNextStepsRuntime?.(),
          outputStyle: options.outputStyle,
          runtimeSnapshot: options.verbose ? 'full' : 'compact',
        },
      )
    : toStructuredEnvelope(
        createStructuredErrorOutput({
          category: 'runtime',
          code: 'STRUCTURED_OUTPUT_MISSING',
          message: 'Tool did not produce structured output for --output json',
        }).result,
        STRUCTURED_ERROR_SCHEMA,
        STRUCTURED_ERROR_SCHEMA_VERSION,
        { outputStyle: options.outputStyle },
      );

  process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
  return envelope.didError;
}

/**
 * Register all tool commands from the catalog with yargs, grouped by workflow.