sim/apps/sim/tools/slack/publish_view.ts

import type { SlackPublishViewParams, SlackPublishViewResponse } from '@/tools/slack/types'
import { VIEW_OUTPUT_PROPERTIES } from '@/tools/slack/types'
import type { ToolConfig } from '@/tools/types'

export const slackPublishViewTool: ToolConfig<SlackPublishViewParams, SlackPublishViewResponse> = {
  id: 'slack_publish_view',
  name: 'Slack Publish View',
  description:
    "Publish a static view to a user's Home tab in Slack. Used to create or update the app's Home tab experience.",
  version: '1.0.0',

  oauth: {
    required: true,
    provider: 'slack',
  },

  params: {
    authMethod: {
      type: 'string',
      required: false,
      visibility: 'user-only',
      description: 'Authentication method: oauth or bot_token',
    },
    botToken: {
      type: 'string',
      required: false,
      visibility: 'user-only',
      description: 'Bot token for Custom Bot',
    },
    accessToken: {
      type: 'string',
      required: false,
      visibility: 'hidden',
      description: 'OAuth access token or bot token for Slack API',
    },
    userId: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'The user ID to publish the Home tab view to (e.g., U0BPQUNTA)',
    },
    hash: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description:
        'View state hash to protect against race conditions. Obtained from a previous views response',
    },
    view: {
      type: 'json',
      required: true,
      visibility: 'user-or-llm',
      description:
        'A view payload object defining the Home tab. Must include type ("home") and blocks array',
    },
  },

  request: {
    url: 'https://slack.com/api/views.publish',
    method: 'POST',
    headers: (params: SlackPublishViewParams) => ({
      'Content-Type': 'application/json',
      Authorization: `Bearer ${params.accessToken || params.botToken}`,
    }),
    body: (params: SlackPublishViewParams) => {
      const body: Record<string, unknown> = {
        user_id: params.userId.trim(),
        view: typeof params.view === 'string' ? JSON.parse(params.view) : params.view,
      }

      if (params.hash) {
        body.hash = params.hash.trim()
      }

      return body
    },
  },

  transformResponse: async (response: Response) => {
    const data = await response.json()

    if (!data.ok) {
      if (data.error === 'not_found') {
        throw new Error('User not found. Please check the user ID and try again.')
      }
      if (data.error === 'not_enabled') {
        throw new Error(
          'The Home tab is not enabled for this app. Enable it in your app configuration.'
        )
      }
      if (data.error === 'hash_conflict') {
        throw new Error(
          'The view has been modified since the hash was generated. Retrieve the latest view and try again.'
        )
      }
      if (data.error === 'view_too_large') {
        throw new Error(
          'The view payload is too large (max 250kb). Reduce the number of blocks or content.'
        )
      }
      if (data.error === 'duplicate_external_id') {
        throw new Error(
          'A view with this external_id already exists. Use a unique external_id per workspace.'
        )
      }
      if (data.error === 'invalid_arguments') {
        const messages = data.response_metadata?.messages ?? []
        throw new Error(
          `Invalid view arguments: ${messages.length > 0 ? messages.join(', ') : data.error}`
        )
      }
      if (data.error === 'missing_scope') {
        throw new Error(
          'Missing required permissions. Please reconnect your Slack account with the necessary scopes.'
        )
      }
      if (
        data.error === 'invalid_auth' ||
        data.error === 'not_authed' ||
        data.error === 'token_expired'
      ) {
        throw new Error('Invalid authentication. Please check your Slack credentials.')
      }
      throw new Error(data.error || 'Failed to publish view in Slack')
    }

    const view = data.view

    return {
      success: true,
      output: {
        view: {
          id: view.id,
          team_id: view.team_id ?? null,
          type: view.type,
          title: view.title ?? null,
          submit: view.submit ?? null,
          close: view.close ?? null,
          blocks: view.blocks ?? [],
          private_metadata: view.private_metadata ?? null,
          callback_id: view.callback_id ?? null,
          external_id: view.external_id ?? null,
          state: view.state ?? null,
          hash: view.hash ?? null,
          clear_on_close: view.clear_on_close ?? false,
          notify_on_close: view.notify_on_close ?? false,
          root_view_id: view.root_view_id ?? null,
          previous_view_id: view.previous_view_id ?? null,
          app_id: view.app_id ?? null,
          bot_id: view.bot_id ?? null,
        },
      },
    }
  },

  outputs: {
    view: {
      type: 'object',
      description: 'The published Home tab view object',
      properties: VIEW_OUTPUT_PROPERTIES,
    },
  },
}