improvement(search): search every folder, and document real API error bodies

[waleedlatif1]

Summary

• Search on Files, Tables, and Knowledge was ANDed with the open folder, so a query only ever matched that folder's direct children — you could not find a nested file from the root. A non-empty query now searches the whole workspace, at any depth.
• The query was not cleared when you entered a folder, so the folder you just opened stayed filtered to the previous search. Opening a folder now ends the search (Back restores the results).
• A Location column names each result's folder while searching, and is absent otherwise.
• A search or filter that matched nothing rendered a blank table with no explanation. There is now a real no-results state naming the query.
• GET /api/v2/files gains a recursive flag — defaults to true alongside a search, false otherwise, so listing a folder shows that folder while searching one looks through it. Surfaces as --recursive on sim files list.
• Every non-200 tab in the API reference showed the same BAD_REQUEST / "The request is invalid." body, because one shared example hung off the error schema. Each status now documents a real code and message, with details where the description promises it.

Type of Change

• Bug fix

Testing

Tested manually. bun run check:audits (29/29), bun run type-check, and bun run lint all pass. 61 new tests across the search scope, drag-move pruning, recursive folder scoping, recursive query parsing, error-code mapping, and the OpenAPI generator; each verified to fail against the pre-fix behavior. OpenAPI and CLI artifacts regenerated.

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Aug 19, 2026 8:38pm

[cursor]

PR Summary

Medium Risk
Touches list filtering, navigation, and drag-drop across three workspace surfaces plus v2 files listing and published API docs; behavior changes are user-visible but bounded to foldered lists and files list contract.

Overview
Workspace folder lists (Files, Tables, Knowledge) no longer treat search as “only the open folder.” A non-empty query searches the whole workspace; opening a folder clears search (via openFolder / navigateToFolder) so you see that folder’s contents instead of a stale filter. While searching, a Location column shows where each row lives; drag-and-drop ignores body drops during search and prunes rows already carried by dragged folders.

Empty vs no-results: resourceListState distinguishes a truly empty workspace from search/filter with zero matches; ResourceNoResults replaces a blank table. useSearchFilterValue clears the filter term immediately on clear (fixes stale results after folder navigation). Upload/create-folder paths clear search so new items appear in the open folder.

API: GET /api/v2/files adds recursive (string enum, not z.coerce.boolean); listsSubfolders defaults recursive to true when search is set. Cursor pagination keys on resolved recursive. V2 error-codes are centralized; OpenAPI error responses carry per-status examples via withErrorExamples, and generated JSON docs/CLI reference updated.

^{Reviewed by Cursor Bugbot for commit 16dd34b. Configure here.}

[greptile-apps]

Greptile Summary

The PR makes resource searches workspace-wide while preserving direct-child folder browsing, adds recursive file-listing support, and generates status-specific API error examples.

• Adds shared folder-search scoping, location labels, no-results states, and navigation/search coordination across Files, Knowledge, and Tables.
• Adds recursive folder filtering to the v2 Files API, cursor scope, generated CLI, and documentation.
• Centralizes v2 status/code mappings and emits response-specific OpenAPI error examples.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains.

No blocking failure remains.

Important Files Changed

Filename	Overview
apps/sim/app/workspace/[workspaceId]/components/folders/folder-search-scope.ts	Centralizes direct-child browsing, workspace-wide search matching, and folder-location derivation.
apps/sim/app/workspace/[workspaceId]/components/folders/use-folder-navigation.ts	Coordinates folder URL transitions with search clearing and browser-history behavior.
apps/sim/app/workspace/[workspaceId]/components/folders/use-folder-row-drag-drop.ts	Prunes resources carried by selected folders and prevents invalid subtree moves.
apps/sim/lib/workspace-files/application/list-workspace-files.ts	Resolves direct or recursive folder scopes before querying paginated workspace files.
apps/sim/app/api/v2/files/route.ts	Parses recursive listing behavior and includes its effective value in cursor scope.
apps/sim/lib/api/contracts/v2/openapi/shared.ts	Defines status-specific reusable v2 error examples for generated API documents.
scripts/openapi/generator.ts	Generates response-level error examples and retains referenced reusable response components.
apps/sim/hooks/use-search-filter-value.ts	Keeps displayed filtering synchronized with debounced query changes and immediate clearing.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Q[Resource query] --> S{Query non-empty?}
  S -->|No| F[Show direct children of open folder]
  S -->|Yes| W[Search entire workspace]
  W --> L[Show result location]
  W --> N{Any matches?}
  N -->|No| E[Show named no-results state]
  N -->|Yes| R[Render matching resources]
  R --> O[Open folder or resource]
  O --> C[Clear active search]
  C --> F

Loading

_{Reviews (2): Last reviewed commit: "fix(search): discard the search term on ..." | Re-trigger Greptile}

[waleedlatif1]

@greptile

[waleedlatif1]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 16dd34b. Configure here.}