import type { Block, KnownBlock } from '@slack/types'; import type { TokenOverridable } from './common'; export interface AgentsConversationsArchiveArguments extends TokenOverridable { /** @description ID of the code channel to archive. */ channel_id: string; /** * @description Timestamp of a message in the code channel to share back as a thread reply on the origin message. * Requires the channel to have an `origin_link` set. */ summary_message_ts?: string; } export interface AgentsConversationsCreateArguments extends TokenOverridable { /** * @description Encoded team ID to create the channel in. Required for org tokens when `origin_channel_id` is not * provided. When omitted, the workspace is derived from the origin channel. */ team_id?: string; /** * @description An opaque identifier for the agent session. When provided, the call is idempotent: if a channel already * exists for this `session_id`, it is returned instead of creating a new one. */ session_id?: string; /** * @description A friendly display name for the code channel. Optional when `origin_channel_id` and `origin_message_ts` * are provided — in that case the channel is named from the origin message and re-titled automatically. Required when no origin link is given. */ name: string; /** @description Create a private channel instead of a public one. */ is_private?: boolean; /** * @description The channel ID where the agent session was initiated from. Must be provided together with * `origin_message_ts`. The channel must be accessible to the calling user and must not be externally shared (Slack Connect). When `team_id` is omitted with an org token, the channel is created in the same workspace as this origin channel. */ origin_channel_id?: string; /** * @description The message timestamp in the origin channel that started the agent session. Must be provided together * with `origin_channel_id`. The author of this message is automatically invited to the newly created code channel. */ origin_message_ts?: string; } export interface AgentsConversationsGetCanvasArguments extends TokenOverridable { /** @description ID of the agent session channel the canvas belongs to. */ channel: string; /** @description Encoded ID of the canvas to fetch. */ canvas_id: string; /** @description Format to render the canvas content in. Defaults to `markdown`. */ content_format?: string; /** @description Whether to include resolved comment threads in the response. Defaults to `false`. */ include_resolved?: boolean; } export interface AgentsConversationsListViewsArguments extends TokenOverridable { /** @description ID of the code channel to list views for. */ channel_id: string; } export interface AgentsConversationsRemoveViewArguments extends TokenOverridable { /** @description ID of the code channel to remove the view from. */ channel_id: string; /** @description Agent-assigned key of the view to remove. Provide exactly one of `view_key` or `view_id`. */ view_key?: string; /** @description Encoded channel tab ID of the view to remove. Provide exactly one of `view_key` or `view_id`. */ view_id?: string; } export interface AgentsConversationsSetCanvasContentArguments extends TokenOverridable { /** @description ID of the agent session channel the canvas is attached to. */ channel: string; /** @description Encoded ID of the canvas whose content to replace. */ canvas_id: string; /** * @description The full new canvas content as markdown. The server diffs this against the current content and applies * only the changed sections. */ content: string; } export interface AgentsConversationsSetCommandsArguments extends TokenOverridable { /** @description ID of the code channel to register commands for. */ channel_id: string; /** * @description Full set of commands to register for the calling agent in this channel, replacing that agent's * previously registered set. Pass an empty array to clear the agent's commands. At most 10 commands may exist across all agents in the channel; names must be unique within the set and must not collide with builtin Slack commands. */ commands: { /** @description Command name, without a leading slash. 1-31 characters, unique within the set. */ name: string; /** @description Short description of what the command does. */ description?: string; /** @description Hint describing the command's arguments, shown in the typeahead. */ argument_hint?: string; /** * @description When true, channel, user, and link references in the command's text are escaped/parsed before * being sent to the agent app, matching the slash-command `should_escape` behavior. Absent is treated as false. */ should_escape?: boolean; }[]; } export interface AgentsConversationsSetPropertiesArguments extends TokenOverridable { /** @description ID of the code channel to update. */ channel_id: string; /** @description Code channel properties to set. Only provided fields are updated. */ code_channel?: { /** @description Items displayed in the channel context bar. Maximum 5 items. The array replaces the current set. */ context_bar_items?: { /** @description Unique identifier for the item within the channel. Maximum 64 characters. */ key: string; /** @description Display text. Maximum 128 characters. */ label: string; /** @description Icon shown beside the label: `branch`, `folder`, `hierarchy`, `life-ring`, `link`, `globe`, `terminal`, `code`, `search`, or `lock`. */ icon?: string; /** @description Makes the item a link to this URL. Maximum 2048 characters. */ url?: string; /** @description `info` (default, informational) or `action` (interactive; clicking delivers a `code_channel_action` event). */ item_type?: string; }[]; /** @description Records which message in the channel represents the current session summary. */ summary_message?: { /** @description Timestamp of the summary message in the code channel. */ message_ts: string; /** @description Thread timestamp if the summary message is a thread reply. Clients need this to fetch the message via conversations.replies. */ thread_ts?: string; }; }; /** @description Agent resource properties to set. Only provided fields are updated. */ agent_resource?: { /** @description URL of the external resource. Maximum 2048 characters. */ url?: string; /** @description Type of the external resource. Maximum 64 characters. */ resource_type?: string; /** @description Display title of the external resource. Maximum 255 characters. */ title?: string; /** @description Provider of the external resource. Maximum 64 characters. */ provider?: string; }; } export interface AgentsConversationsSetViewArguments extends TokenOverridable { /** @description ID of the code channel to render the view in. */ channel_id: string; /** * @description The kind of view to create or update. Defaults to `html`. Determines which other arguments are * required: `html` and `diff` require `content`, `block_kit` requires `blocks`, `canvas` requires `canvas_id`, * `pull_request` requires `pr_url`. */ type?: string; /** * @description Agent-assigned stable identity for the view (e.g. the source file path on the agent's machine). Used as * the upsert key: calls with the same `view_key` update the same view. Required for html, block_kit, and canvas views; ignored for diff (a diff view is a per-channel singleton). */ view_key?: string; /** * @description View content. For `html`, a full self-contained HTML document; for `diff`, raw unified diff text. * Capped at 1,000,000 bytes — larger content returns content_too_large. The cap is enforced by the handler (not schema maxLength) so the documented error code actually surfaces instead of a generic argument-validation failure. Required when type is html or diff. */ content?: string; /** @description Block Kit blocks to render in the view tab. Required when `type` is `block_kit`; ignored otherwise. */ blocks?: (KnownBlock | Block)[]; /** @description Encoded ID of the canvas to attach as the view. Required when `type` is `canvas`; ignored otherwise. */ canvas_id?: string; /** * @description For canvas views: access level granted to the channel for the canvas tab. Defaults to `write`. Use * `comment` to grant channel members comment access (read and comment, no editing) so the agent remains the sole author of the canvas text. */ access_level?: string; /** * @description For canvas views: hash of the canvas-derived markdown the agent last wrote, recorded so the agent can * later detect human edits to the canvas. Opaque to the server. */ agent_content_hash?: string; /** @description For pull_request views: the pull request's URL. Required when `type` is `pull_request`; ignored otherwise. */ pr_url?: string; /** @description For diff views: base branch name for display purposes. */ base_branch?: string; /** @description For diff views: head branch name for display purposes. */ head_branch?: string; /** * @description Display label for the view tab (`name` wins if both are * supplied). Defaults to the last path segment of `view_key`, stripped of any .html/.htm extension. */ name?: string; /** * @description Content-Security-Policy domain declarations for the view. Domains are validated server-side * (https-only, no private/internal hosts) and persisted. Only resource_domains is honored at render time today; connect_domains is accepted and stored for forward-compatibility but NOT honored yet. */ csp?: { /** @description Origins the view may fetch()/XHR/WebSocket to. Accepted and stored, but not honored at render time yet. */ connect_domains?: string[]; /** @description Origins the view may load scripts/styles/fonts/images/media from, merged into the curated CDN allowlist at render time. */ resource_domains?: string[]; }; } export interface AgentsSessionsRenameArguments extends TokenOverridable { /** @description ID of the channel containing the agent session. */ channel_id: string; /** @description New title for the agent session (1-200 characters). For a session channel, this also renames the channel. */ title: string; /** * @description Timestamp of the thread root message the session is scoped to. Required for thread-based sessions in * regular channels and DMs. Must be omitted for session channels. */ thread_ts?: string; } export interface AgentsSessionsSetStatusArguments extends TokenOverridable { /** @description ID of the channel containing the agent session. */ channel_id: string; /** @description The lifecycle status to set. Acceptable values: `active`, `processing`, `suspended`, `closed`. */ status: string; /** * @description Timestamp of the thread root message the session is scoped to. Required for thread-based sessions in * regular channels and DMs. Must be omitted for session channels. */ thread_ts?: string; /** * @description Title for the agent session (max 200 characters). Only used when creating a new session; ignored if * the session already exists. To rename an existing session, use `agents.sessions.rename`. */ title?: string; /** * @description The user who initiated the session. Only used when creating a new session; ignored if the session * already exists. Must be a member of the channel. */ initiator_user_id?: string; /** * @description Emoji to use as the agent's icon. Takes priority over `icon_url`. Remains in effect until you clear it * (pass `null`) or set a new value. Requires the `chat:write.customize` scope. * @example :chart_with_upwards_trend: */ icon_emoji?: string; /** * @description URL to an image to use as the agent's icon. Remains in effect until you clear it (pass `null`) or set * a new value. Requires the `chat:write.customize` scope. * @example http://lorempixel.com/48/48 */ icon_url?: string; /** * @description Display name override for the agent (max 200 characters). Remains in effect until you clear it (pass * `null`) or set a new value. Requires the `chat:write.customize` scope. * @example My Bot */ username?: string; } //# sourceMappingURL=agents.d.ts.map