fix(v2): name the folder filter the same way on every list that has one

Three list surfaces describe the same filter, and one still named the
request field rather than the concept — the spelling a caller reading the
reference wants and the one a caller typing a command cannot use. The
workflows sibling was reworded already; tables and knowledge now match, and
a test pins the three together so they cannot drift apart again.

The two bulk knowledge surfaces are pinned against each other rather than
against a literal, since what matters is that they answer the same question
under the same names.

Author: waleedlatif1

apps/sim/lib/api/contracts/v2/knowledge-bulk-and-lifecycle.test.ts

@@ -0,0 +1,48 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it } from 'vitest'
+import {
+  v2BulkKnowledgeDocumentsDataSchema,
+  v2GetKnowledgeBaseContract,
+} from '@/lib/api/contracts/v2/knowledge'
+import { v2BulkKnowledgeChunksDataSchema } from '@/lib/api/contracts/v2/knowledge-chunks'
+
+/**
+ * The two bulk surfaces answer the same question — "which of the ids I named
+ * did nothing?" — so they are pinned against each other rather than against a
+ * literal, which is what stops one of them being renamed on its own again.
+ */
+describe('bulk knowledge outcomes', () => {
+  it('reports the matched count and the unmatched ids under the same names on both', () => {
+    const documents = Object.keys(v2BulkKnowledgeDocumentsDataSchema.shape)
+    const chunks = Object.keys(v2BulkKnowledgeChunksDataSchema.shape)
+
+    for (const field of ['operation', 'processed', 'errors']) {
+      expect(chunks).toContain(field)
+      expect(documents).toContain(field)
+    }
+    expect(documents).not.toContain('updatedCount')
+  })
+
+  it('accepts a zero-match document sweep as a success body rather than an error', () => {
+    const parsed = v2BulkKnowledgeDocumentsDataSchema.safeParse({
+      operation: 'disable',
+      processed: 0,
+      errors: ['No matching documents found to disable: document-missing'],
+      documentIds: [],
+    })
+
+    expect(parsed.success).toBe(true)
+  })
+})
+
+describe('knowledge base read lifecycle', () => {
+  it('says which lifecycle the read addresses on the identifier a caller types', () => {
+    const described = v2GetKnowledgeBaseContract.params?.shape.knowledgeBaseId.description
+
+    expect(described).toBeTypeOf('string')
+    expect(described).toContain('Active knowledge bases only')
+    expect(described).toContain('archived')
+  })
+})

apps/sim/lib/api/contracts/v2/tables.ts

@@ -436,7 +436,7 @@ export const v2ListTablesQuerySchema = z
     scope: v2TableScopeSchema
       .default('active')
       .describe(
-        'Which lifecycle set to list: `active` (default) for live tables, `archived` for tables a delete archived and a table restore can bring back. `folderPath` resolves against active folders only, so pairing it with `scope=archived` returns an empty page when the containing folder was archived too.'
+        'Which lifecycle set to list: `active` (default) for live tables, `archived` for tables a delete archived and a table restore can bring back. The folder filter resolves against active folders only, so pairing it with `archived` returns an empty page when the containing folder was archived too.'
       ),
     folderPath: v2FolderPathInputSchema
       .optional()