import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/channel-core";

export const slackChannelConfigUiHints = {
  "": {
    label: "Slack",
    help: "Slack channel provider configuration for bot/app tokens, streaming behavior, and DM policy controls. Keep token handling and thread behavior explicit to avoid noisy workspace interactions.",
  },
  "dm.policy": {
    label: "Slack DM Policy",
    help: 'Direct message access control ("pairing" recommended). "open" requires channels.slack.allowFrom=["*"] (legacy: channels.slack.dm.allowFrom).',
  },
  dmPolicy: {
    label: "Slack DM Policy",
    help: 'Direct message access control ("pairing" recommended). "open" requires channels.slack.allowFrom=["*"].',
  },
  configWrites: {
    label: "Slack Config Writes",
    help: "Allow Slack to write config in response to channel events/commands (default: true).",
  },
  "commands.native": {
    label: "Slack Native Commands",
    help: 'Override native commands for Slack (bool or "auto").',
  },
  "commands.nativeSkills": {
    label: "Slack Native Skill Commands",
    help: 'Override native skill commands for Slack (bool or "auto").',
  },
  allowBots: {
    label: "Slack Allow Bot Messages",
    help: "Allow bot-authored messages to trigger Slack replies (default: false).",
  },
  botToken: {
    label: "Slack Bot Token",
    help: "Slack bot token used for standard chat actions in the configured workspace. Keep this credential scoped and rotate if workspace app permissions change.",
  },
  appToken: {
    label: "Slack App Token",
    help: "Slack app-level token used for Socket Mode connections and event transport when enabled. Use least-privilege app scopes and store this token as a secret.",
  },
  userToken: {
    label: "Slack User Token",
    help: "Optional Slack user token for workflows requiring user-context API access beyond bot permissions. Use sparingly and audit scopes because this token can carry broader authority.",
  },
  userTokenReadOnly: {
    label: "Slack User Token Read Only",
    help: "When true, treat configured Slack user token usage as read-only helper behavior where possible. Keep enabled if you only need supplemental reads without user-context writes.",
  },
  "capabilities.interactiveReplies": {
    label: "Slack Interactive Replies",
    help: "Enable agent-authored Slack interactive reply directives (`[[slack_buttons: ...]]`, `[[slack_select: ...]]`). Default: false.",
  },
  execApprovals: {
    label: "Slack Exec Approvals",
    help: "Slack-native exec approval routing and approver authorization. When unset, OpenClaw auto-enables DM-first native approvals if approvers can be resolved for this workspace account.",
  },
  "execApprovals.enabled": {
    label: "Slack Exec Approvals Enabled",
    help: 'Controls Slack native exec approvals for this account: unset or "auto" enables DM-first native approvals when approvers can be resolved, true forces native approvals on, and false disables them.',
  },
  "execApprovals.approvers": {
    label: "Slack Exec Approval Approvers",
    help: "Slack user IDs allowed to approve exec requests for this workspace account. Use Slack user IDs or user targets such as `U123`, `user:U123`, or `<@U123>`. If you leave this unset, OpenClaw falls back to commands.ownerAllowFrom when possible.",
  },
  "execApprovals.agentFilter": {
    label: "Slack Exec Approval Agent Filter",
    help: 'Optional allowlist of agent IDs eligible for Slack exec approvals, for example `["main", "ops-agent"]`. Use this to keep approval prompts scoped to the agents you actually operate from Slack.',
  },
  "execApprovals.sessionFilter": {
    label: "Slack Exec Approval Session Filter",
    help: "Optional session-key filters matched as substring or regex-style patterns before Slack approval routing is used. Use narrow patterns so Slack approvals only appear for intended sessions.",
  },
  "execApprovals.target": {
    label: "Slack Exec Approval Target",
    help: 'Controls where Slack approval prompts are sent: "dm" sends to approver DMs (default), "channel" sends to the originating Slack chat/thread, and "both" sends to both. Channel delivery exposes the command text to the chat, so only use it in trusted channels.',
  },
  streaming: {
    label: "Slack Streaming Mode",
    help: 'Unified Slack stream preview mode: "off" | "partial" | "block" | "progress". Legacy boolean/streamMode keys are auto-mapped.',
  },
  "streaming.mode": {
    label: "Slack Streaming Mode",
    help: 'Canonical Slack preview mode: "off" | "partial" | "block" | "progress".',
  },
  "streaming.chunkMode": {
    label: "Slack Chunk Mode",
    help: 'Chunking mode for outbound Slack text delivery: "length" (default) or "newline".',
  },
  "streaming.block.enabled": {
    label: "Slack Block Streaming Enabled",
    help: 'Enable chunked block-style Slack preview delivery when channels.slack.streaming.mode="block".',
  },
  "streaming.block.coalesce": {
    label: "Slack Block Streaming Coalesce",
    help: "Merge streamed Slack block replies before final delivery.",
  },
  "streaming.nativeTransport": {
    label: "Slack Native Streaming",
    help: "Enable native Slack text streaming (chat.startStream/chat.appendStream/chat.stopStream) when channels.slack.streaming.mode is partial (default: true). Requires a reply thread target; top-level DMs stay on the non-thread fallback path.",
  },
  "thread.historyScope": {
    label: "Slack Thread History Scope",
    help: 'Scope for Slack thread history context ("thread" isolates per thread; "channel" reuses channel history).',
  },
  "thread.inheritParent": {
    label: "Slack Thread Parent Inheritance",
    help: "If true, Slack thread sessions inherit the parent channel transcript (default: false).",
  },
  "thread.initialHistoryLimit": {
    label: "Slack Thread Initial History Limit",
    help: "Maximum number of existing Slack thread messages to fetch when starting a new thread session (default: 20, set to 0 to disable).",
  },
  "thread.requireExplicitMention": {
    label: "Slack Thread Require Explicit Mention",
    help: "If true, require an explicit @mention even inside threads where the bot has participated. Suppresses implicit thread mention behavior so the bot only responds to explicit @bot mentions in threads (default: false).",
  },
} satisfies Record<string, ChannelConfigUiHint>;
