Function readFile

apps/webuiapps/src/lib/fileApi.ts:186–215

(path: string)

 * This function wraps the result uniformly as ReadFileResult
 */
export const readFile = async (path: string): Promise<ReadFileResult> => {
  const manager = getClientComManager();
  const normalized = normalizePath(path);
  // file_path without leading slash, e.g. "posts/tweet_123.json"
  const filePath = normalized.replace(/^\//, '');
  const startTime = ts();
  const t0 = performance.now();
  const result = await manager.getFile<unknown>({ file_path: filePath });
  console.info(
    `[FileApi][${startTime}] readFile "${filePath}" — ${(performance.now() - t0).toFixed(1)}ms`,
  );

  if (result === null || result === undefined) {
    return { content: undefined, metadata: {} };
  }

  // Check if the return value is a ReadFileResult structure (has both content and metadata fields, and metadata is an object)
  if (
    typeof result === 'object' &&
    !Array.isArray(result) &&
    'content' in result &&
    'metadata' in result &&
    typeof (result as Record<string, unknown>).metadata === 'object'
  ) {
    return result as ReadFileResult;
  }

  // Server returned file content directly; wrap as ReadFileResult
  return { content: result, metadata: {} };
};

/**
 * Write file