improvement(slack): rename commands to query and connect

Author: TheodoreSpeaks

apps/docs/content/docs/search/slack.mdx

@@ -17,8 +17,8 @@ Each member then opens **Integrations → Slack → Connect**, chooses what to i
 Slack uses the same indexing pipeline as other connected sources. Both the Sim web Assistant and Slack bot search the organization's knowledge base, applying the current person's access permissions. Newly connected content becomes searchable after indexing completes. Connection and sync status appear in Integrations.
 
 - DM **Sim Search**, or mention it in a channel it has joined.
-- Use **/sim-search [question]** to start a private DM thread. Channel invocations keep personalized answers and account details in DMs.
-- Use **/sim-connect [provider]**, or **Home → Connect sources**, to open your personal Integrations in Sim. OAuth begins only after you click Connect there.
+- Use **/query [question]** to start a private DM thread. Channel invocations keep personalized answers and account details in DMs.
+- Use **/connect [provider]**, or **Home → Connect sources**, to open your personal Integrations in Sim. OAuth begins only after you click Connect there.
 - Follow source links to the original messages. Use Slack's Stop control to cancel the active answer and queued follow-ups.
 
 Existing custom-app installations are not silently converted. To switch to the official app, remove the old Slack Search binding and source app configuration explicitly, install the official app, and have members authorize it afresh. Workflow integrations keep their existing app configuration.

apps/sim/lib/knowledge/application/slack-search/commands.test.ts

@@ -25,7 +25,7 @@ const input = {
   user_id: 'U1',
   channel_id: 'C1',
   trigger_id: 'trigger.1',
-  command: '/sim-search',
+  command: '/query',
   text: 'release notes',
 } as const
 const principal = {
@@ -51,7 +51,7 @@ describe('Slack commands', () => {
     expect(m.receive).toHaveBeenCalledWith({
       principal,
       input: expect.objectContaining({
-        command: '/sim-search',
+        command: '/query',
         messageTs: null,
         channelId: 'C1',
         userId: 'U1',
@@ -69,7 +69,7 @@ describe('Slack commands', () => {
   it('returns an environment-correct personal connection link without OAuth state', async () => {
     const result = await receiveSlackSearchCommand.execute({
       principal,
-      input: { ...input, command: '/sim-connect', text: 'slack' },
+      input: { ...input, command: '/connect', text: 'slack' },
     })
     expect(result.text).toBe(
       '<https://www.sim.ai/o/org/integrations?connectorType=slack|Connect your sources in Sim>'

apps/sim/lib/knowledge/application/slack-search/commands.ts

@@ -40,7 +40,7 @@ export const receiveSlackSearchCommand: OperationUseCase<
         response_type: 'ephemeral',
         text: 'An admin needs to enable Sim Search for this Slack workspace.',
       }
-    if (input.command === '/sim-connect') {
+    if (input.command === '/connect') {
       const url = new URL(
         organizationRoutes(context.installation.organizationId).integrations,
         getBaseUrl()
@@ -60,8 +60,7 @@ export const receiveSlackSearchCommand: OperationUseCase<
       return { response_type: 'ephemeral', text: `<${url.href}|Connect your sources in Sim>` }
     }
     const query = input.text.trim()
-    if (!query)
-      return { response_type: 'ephemeral', text: 'Use /sim-search followed by your question.' }
+    if (!query) return { response_type: 'ephemeral', text: 'Use /query followed by your question.' }
     const turnId = await receiveSlackSearchMessage.execute({
       principal,
       input: {
@@ -70,7 +69,7 @@ export const receiveSlackSearchCommand: OperationUseCase<
         eventId: principal.eventId,
         userId: input.user_id,
         channelId: input.channel_id,
-        command: '/sim-search',
+        command: '/query',
         messageTs: null,
         query: query.length > 2000 ? '' : query,
         queryTooLong: query.length > 2000,

apps/sim/lib/knowledge/application/slack-search/mention.test.ts

@@ -113,7 +113,7 @@ it('creates a real DM root for a slash command and never uses its trigger ID as
       channelId: 'C1',
       userId: 'U1',
       messageTs: null,
-      command: '/sim-search',
+      command: '/query',
       query: 'Find release notes',
       queryTooLong: false,
     },

apps/sim/lib/knowledge/application/slack-search/mention.ts

@@ -19,7 +19,7 @@ export async function routeSlackSearchMentionToDm(
   input: { job: SlackSearchJob; turnId: string; leaseId: string; signal: AbortSignal }
 ): Promise<SlackSearchJob> {
   const { job, turnId, leaseId, signal } = input
-  const command = job.message.command === '/sim-search' && job.message.messageTs === null
+  const command = job.message.command === '/query' && job.message.messageTs === null
   if (job.message.channelId.startsWith('D') && !command) return job
   if (
     (!command && (!job.message.origin || job.message.origin.channelId !== job.message.channelId)) ||

apps/sim/lib/slack-search/commands.ts

@@ -7,7 +7,7 @@ export const slackSearchCommandSchema = z.object({
   team_id: id,
   user_id: id,
   channel_id: z.string().regex(/^[CGD][A-Z0-9]+$/),
-  command: z.enum(['/sim-search', '/sim-connect']),
+  command: z.enum(['/query', '/connect']),
   text: z.string().max(40_000),
   trigger_id: z.string().min(1).max(200),
 })

apps/sim/lib/slack-search/manifest.test.ts

@@ -109,8 +109,8 @@ it('official app uses the existing personal indexing grants with bot commands',
   expect(manifest.oauth_config.scopes.bot).toContain('commands')
   expect(manifest.oauth_config.scopes.bot).not.toContain('groups:history')
   expect(manifest.features.slash_commands.map((command) => command.command)).toEqual([
-    '/sim-search',
-    '/sim-connect',
+    '/query',
+    '/connect',
   ])
   expect(
     manifest.features.slash_commands.every(

apps/sim/lib/slack-search/manifest.ts

@@ -76,14 +76,14 @@ export function createSharedSlackSearchManifest(origin: string) {
       ...manifest.features,
       slash_commands: [
         {
-          command: '/sim-search',
+          command: '/query',
           description: 'Ask Sim Search a question privately',
           usage_hint: '[question]',
           url: webhook,
           should_escape: false,
         },
         {
-          command: '/sim-connect',
+          command: '/connect',
           description: 'Connect your personal sources in Sim',
           usage_hint: '[provider]',
           url: webhook,

apps/sim/lib/slack-search/types.ts

@@ -19,7 +19,7 @@ export const slackSearchMessageSchema = z
       .string()
       .regex(/^\d+\.\d+$/)
       .nullable(),
-    command: z.literal('/sim-search').optional(),
+    command: z.literal('/query').optional(),
     threadTs: z
       .string()
       .regex(/^\d+\.\d+$/)
@@ -28,8 +28,7 @@ export const slackSearchMessageSchema = z
     queryTooLong: z.boolean(),
   })
   .refine(
-    (message) =>
-      message.messageTs !== null || (message.command === '/sim-search' && !message.threadTs),
+    (message) => message.messageTs !== null || (message.command === '/query' && !message.threadTs),
     'Only a queued slash command may lack a Slack message timestamp'
   )
 export type SlackSearchMessage = z.infer<typeof slackSearchMessageSchema>