refactor(v2-api)!: flatten the single-resource response envelope

BREAKING: 31 endpoints that returned `{ data: { <resource>: T } }` now return
`{ data: T }`.

This corrects drift, not a design decision. PR #5273 added skills, custom
tools, MCP servers, secrets, and knowledge nested while adding workflows,
files, and logs flat — and in the same commit wrote the `v2/shared.ts`
docblock declaring `single resource: { data: T }` is the standard. The nested
half appears to have been modelled on the v2 tables surface (#6067), which
landed twelve days earlier. Lists were already `{ data: T[], nextCursor }`, so
flat single-resource is what actually matches them; nesting made every client
destructure a layer that carries nothing.

Doing it now because the cost only grows: `v2-api` is still dark-launched, so
today this breaks no one. After GA it needs a deprecation window.

Payloads that carry real information were deliberately left alone — this was a
classification exercise, not a mechanical sweep. Unchanged: delete
acknowledgements (`{ id, deleted }`, `{ path, deleted, deletedItems }`), the
knowledge search envelope (which echoes query, knowledgeBaseIds, topK and
totalResults alongside hits), upload payloads carrying signed tokens and
transfer instructions, bulk-operation counts, `{ row, operation }` upserts,
named acknowledgement scalars (`{ dispatchId }`, `{ cancelled }`), and
`{ columns: [...] }` — a collection, where a bare `{ data: T[] }` would be
indistinguishable from the list envelope but without `nextCursor`.

Also flattened the two file-share responses, which were not in the original
survey: leaving them would have put one resource in two shapes on one path.
`GET /files/{id}/share` now returns `{ "data": null }` when a file has never
been shared.

No consumer is affected. Both SDKs touch exactly two v2 endpoints — execute
and run status — and both were already flat. No docs MDX, client hook, or
internal caller reads a changed response; Copilot table tools call the
application use cases directly rather than the HTTP surface.

The shared `v2FolderSchema` is untouched: every folder flatten was achievable
at the response site, which is itself evidence flat was the intended shape.

Author: waleedlatif1

apps/docs/openapi-v2-files-audit.json

@@ -3130,10 +3130,10 @@
         "title": "Move files request",
         "description": "Files and destination selected for a bulk move."
       },
-      "V2GetFileShareResult": {
+      "V2GetFileShareResponse": {
         "type": "object",
         "properties": {
-          "share": {
+          "data": {
             "anyOf": [
               {
                 "$ref": "#/components/schemas/V2FileShare"
@@ -3142,20 +3142,7 @@
                 "type": "null"
               }
             ],
-            "description": "Current public share, or null when the file has never been shared."
-          }
-        },
-        "required": ["share"],
-        "additionalProperties": false,
-        "title": "File share result",
-        "description": "The nullable public-share state for a file."
-      },
-      "V2GetFileShareResponse": {
-        "type": "object",
-        "properties": {
-          "data": {
-            "description": "Response data.",
-            "$ref": "#/components/schemas/V2GetFileShareResult"
+            "description": "Response data."
           }
         },
         "required": ["data"],
@@ -3165,45 +3152,28 @@
         "examples": [
           {
             "data": {
-              "share": {
-                "id": "shr_8Hf3kL9wQ2mNpXr6Tz1Vb",
-                "token": "share-token-example",
-                "url": "https://www.sim.ai/f/share-token-example",
-                "isActive": true,
-                "resourceType": "file",
-                "resourceId": "wf_V1StGXR8z5jdHi6BmyT91",
-                "authType": "public",
-                "hasPassword": false,
-                "allowedEmails": []
-              }
+              "id": "shr_8Hf3kL9wQ2mNpXr6Tz1Vb",
+              "token": "share-token-example",
+              "url": "https://www.sim.ai/f/share-token-example",
+              "isActive": true,
+              "resourceType": "file",
+              "resourceId": "wf_V1StGXR8z5jdHi6BmyT91",
+              "authType": "public",
+              "hasPassword": false,
+              "allowedEmails": []
             }
           },
           {
-            "data": {
-              "share": null
-            }
+            "data": null
           }
         ]
       },
-      "V2UpsertFileShareResult": {
-        "type": "object",
-        "properties": {
-          "share": {
-            "description": "Updated public share.",
-            "$ref": "#/components/schemas/V2FileShare"
-          }
-        },
-        "required": ["share"],
-        "additionalProperties": false,
-        "title": "Updated file share",
-        "description": "The updated public-share state for a file."
-      },
       "V2UpsertFileShareResponse": {
         "type": "object",
         "properties": {
           "data": {
             "description": "Response data.",
-            "$ref": "#/components/schemas/V2UpsertFileShareResult"
+            "$ref": "#/components/schemas/V2FileShare"
           }
         },
         "required": ["data"],
@@ -3213,17 +3183,15 @@
         "examples": [
           {
             "data": {
-              "share": {
-                "id": "shr_8Hf3kL9wQ2mNpXr6Tz1Vb",
-                "token": "share-token-example",
-                "url": "https://www.sim.ai/f/share-token-example",
-                "isActive": true,
-                "resourceType": "file",
-                "resourceId": "wf_V1StGXR8z5jdHi6BmyT91",
-                "authType": "public",
-                "hasPassword": false,
-                "allowedEmails": []
-              }
+              "id": "shr_8Hf3kL9wQ2mNpXr6Tz1Vb",
+              "token": "share-token-example",
+              "url": "https://www.sim.ai/f/share-token-example",
+              "isActive": true,
+              "resourceType": "file",
+              "resourceId": "wf_V1StGXR8z5jdHi6BmyT91",
+              "authType": "public",
+              "hasPassword": false,
+              "allowedEmails": []
             }
           }
         ]
@@ -3442,25 +3410,12 @@
         "title": "File folder list response",
         "description": "Workspace file folders in the current page."
       },
-      "V2FileFolderData": {
-        "type": "object",
-        "properties": {
-          "folder": {
-            "description": "Created or relocated folder.",
-            "$ref": "#/components/schemas/V2Folder"
-          }
-        },
-        "required": ["folder"],
-        "additionalProperties": false,
-        "title": "File folder data",
-        "description": "A created or relocated file folder."
-      },
       "FileFolderResponse": {
         "type": "object",
         "properties": {
           "data": {
             "description": "Response data.",
-            "$ref": "#/components/schemas/V2FileFolderData"
+            "$ref": "#/components/schemas/V2Folder"
           }
         },
         "required": ["data"],

apps/docs/openapi-v2-knowledge.json

@@ -2107,24 +2107,12 @@
         "title": "Knowledge base list response",
         "description": "A cursor-paginated page of knowledge bases."
       },
-      "V2KnowledgeBaseData": {
-        "type": "object",
-        "properties": {
-          "knowledgeBase": {
-            "$ref": "#/components/schemas/V2KnowledgeBase"
-          }
-        },
-        "required": ["knowledgeBase"],
-        "additionalProperties": false,
-        "title": "Knowledge base data",
-        "description": "A single knowledge base payload."
-      },
       "V2KnowledgeBaseResponse": {
         "type": "object",
         "properties": {
           "data": {
             "description": "Response data.",
-            "$ref": "#/components/schemas/V2KnowledgeBaseData"
+            "$ref": "#/components/schemas/V2KnowledgeBase"
           }
         },
         "required": ["data"],
@@ -2630,24 +2618,12 @@
         "title": "Knowledge document list response",
         "description": "A cursor-paginated page of knowledge documents."
       },
-      "V2KnowledgeDocumentSummaryData": {
-        "type": "object",
-        "properties": {
-          "document": {
-            "$ref": "#/components/schemas/V2KnowledgeDocumentSummary"
-          }
-        },
-        "required": ["document"],
-        "additionalProperties": false,
-        "title": "Knowledge document summary data",
-        "description": "A knowledge document upload acknowledgement."
-      },
       "V2KnowledgeDocumentSummaryResponse": {
         "type": "object",
         "properties": {
           "data": {
             "description": "Response data.",
-            "$ref": "#/components/schemas/V2KnowledgeDocumentSummaryData"
+            "$ref": "#/components/schemas/V2KnowledgeDocumentSummary"
           }
         },
         "required": ["data"],
@@ -3216,24 +3192,12 @@
         "title": "Knowledge document",
         "description": "Full document detail including processing state and connector provenance."
       },
-      "V2KnowledgeDocumentData": {
-        "type": "object",
-        "properties": {
-          "document": {
-            "$ref": "#/components/schemas/V2KnowledgeDocument"
-          }
-        },
-        "required": ["document"],
-        "additionalProperties": false,
-        "title": "Knowledge document data",
-        "description": "A single knowledge document payload."
-      },
       "V2KnowledgeDocumentResponse": {
         "type": "object",
         "properties": {
           "data": {
             "description": "Response data.",
-            "$ref": "#/components/schemas/V2KnowledgeDocumentData"
+            "$ref": "#/components/schemas/V2KnowledgeDocument"
           }
         },
         "required": ["data"],
@@ -3299,24 +3263,12 @@
         "title": "Knowledge folder list response",
         "description": "A cursor-paginated page of knowledge-base folders."
       },
-      "V2KnowledgeFolderData": {
-        "type": "object",
-        "properties": {
-          "folder": {
-            "$ref": "#/components/schemas/V2Folder"
-          }
-        },
-        "required": ["folder"],
-        "additionalProperties": false,
-        "title": "Knowledge folder data",
-        "description": "A single knowledge-base folder payload."
-      },
       "V2KnowledgeFolderResponse": {
         "type": "object",
         "properties": {
           "data": {
             "description": "Response data.",
-            "$ref": "#/components/schemas/V2KnowledgeFolderData"
+            "$ref": "#/components/schemas/V2Folder"
           }
         },
         "required": ["data"],