Function executeVfsRead

apps/sim/lib/copilot/tools/handlers/vfs.ts:201–360

(
  params: Record<string, unknown>,
  context: ExecutionContext
)

}

export async function executeVfsRead(
  params: Record<string, unknown>,
  context: ExecutionContext
): Promise<ToolCallResult> {
  const path = params.path as string | undefined
  if (!path) {
    return { success: false, error: "Missing required parameter 'path'" }
  }

  const workspaceId = context.workspaceId
  if (!workspaceId) {
    return { success: false, error: 'No workspace context available' }
  }

  try {
    const parseOptionalNumber = (value: unknown): number | undefined => {
      if (typeof value === 'number' && Number.isFinite(value)) return value
      if (typeof value === 'string' && value.trim() !== '') {
        const parsed = Number.parseInt(value, 10)
        return Number.isFinite(parsed) ? parsed : undefined
      }
      return undefined
    }
    const offset = parseOptionalNumber(params.offset)
    const limit = parseOptionalNumber(params.limit)
    const applyWindow = <T extends { content: string; totalLines: number }>(result: T): T => {
      if (offset === undefined && limit === undefined) return result
      const lines = result.content.split('\n')
      const start = Math.max(0, Math.min(result.totalLines, offset ?? 0))
      const endRaw = limit !== undefined ? start + Math.max(0, limit) : result.totalLines
      const end = Math.max(start, Math.min(result.totalLines, endRaw))
      return {
        ...result,
        content: lines.slice(start, end).join('\n'),
      }
    }

    // Handle chat-scoped uploads via the uploads/ virtual prefix.
    // Uploads are flat and have no metadata/content split like files/ — the upload
    // IS the first path segment after uploads/. Any trailing segment (e.g. a
    // /content suffix added out of habit) is ignored so the read resolves either way.
    if (path.startsWith('uploads/')) {
      if (!context.chatId) {
        return { success: false, error: 'No chat context available for uploads/' }
      }
      const filename = path.slice('uploads/'.length).split('/')[0]
      const uploadResult = await readChatUpload(filename, context.chatId)
      if (uploadResult) {
        const isAttachment = hasModelAttachment(uploadResult)
        if (
          !isAttachment &&
          (isOversizedReadPlaceholder(uploadResult.content) ||
            serializedResultSize(uploadResult) > TOOL_RESULT_MAX_INLINE_CHARS)
        ) {
          logger.warn('Upload read result too large', {
            path,
            hasAttachment: isAttachment,
            contentLength: uploadResult.content.length,