Function emitSyntheticToolResult

apps/sim/lib/copilot/request/handlers/types.ts:230–278

(
  toolCallId: string,
  toolName: string,
  completion: AsyncTerminalCompletionSnapshot | null,
  options: OrchestratorOptions
)

 * so the client would never learn the outcome without this.
 */
export async function emitSyntheticToolResult(
  toolCallId: string,
  toolName: string,
  completion: AsyncTerminalCompletionSnapshot | null,
  options: OrchestratorOptions
): Promise<void> {
  const isBackground = completion?.status === ASYNC_TOOL_CONFIRMATION_STATUS.background
  const success = isBackground || completion?.status === MothershipStreamV1ToolOutcome.success
  const isCancelled = completion?.status === MothershipStreamV1ToolOutcome.cancelled
  const completionData = completion?.data
  const syntheticStatus = isBackground
    ? MothershipStreamV1ToolOutcome.skipped
    : completion?.status === MothershipStreamV1ToolOutcome.success ||
        completion?.status === MothershipStreamV1ToolOutcome.error ||
        completion?.status === MothershipStreamV1ToolOutcome.cancelled
      ? completion.status
      : undefined

  const resultPayload = isCancelled
    ? isRecordLike(completionData)
      ? { ...completionData, reason: 'user_cancelled', cancelledByUser: true }
      : completionData !== undefined
        ? { output: completionData, reason: 'user_cancelled', cancelledByUser: true }
        : { reason: 'user_cancelled', cancelledByUser: true }
    : completionData

  try {
    await options.onEvent?.({
      type: MothershipStreamV1EventType.tool,
      payload: {
        toolCallId,
        toolName,
        executor: MothershipStreamV1ToolExecutor.client,
        mode: MothershipStreamV1ToolMode.async,
        phase: MothershipStreamV1ToolPhase.result,
        success,
        output: resultPayload,
        ...(syntheticStatus ? { status: syntheticStatus } : {}),
        ...(!success && completion?.message ? { error: completion.message } : {}),
      },
    })
  } catch (error) {
    logger.warn('Failed to emit synthetic tool_result', {
      toolCallId,
      toolName,
      error: toError(error).message,
    })
  }
}

export function getToolResultErrorMessage(
  data: MothershipStreamV1ToolResultPayload | undefined