From bacd1655a471fccd06f637dec525d943ead4ab10 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Wed, 21 Oct 2026 16:59:18 -0700 Subject: [PATCH 01/38] =?UTF-8?q?=F0=9F=93=98=20docs:=20Document=20Backgro?= =?UTF-8?q?und=20Responses=20and=20Agent=20Channels?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../object_structure/agents.mdx | 34 ++++++ content/docs/features/agent_channels.mdx | 92 ++++++++++++++++ content/docs/features/agents_api.mdx | 2 + .../docs/features/background_responses.mdx | 100 ++++++++++++++++++ content/docs/features/meta.json | 2 + 5 files changed, 230 insertions(+) create mode 100644 content/docs/features/agent_channels.mdx create mode 100644 content/docs/features/background_responses.mdx diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 4dc7e1fd0..8af813528 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1497,10 +1497,44 @@ Tokens must be unexpired and present a single, non-conflicting client identifier Unknown management-auth fields, duplicate client IDs, malformed user or tenant IDs, and enabled authentication without a client binding fail configuration validation. See [Agents API - Agent Management](/docs/features/agents_api#agent-management-api) for routes and examples. +## channels + +Configures the opt-in [Agent Channels integration](/docs/features/agent_channels). A compatible external gateway and enabled background Responses are required; this setting does not deploy a gateway or enable execution permissions. + +| Option | Default | Accepted values / purpose | +| --- | --- | --- | +| `enabled` | `false` | Enable channel setup and service routes | +| `transport` | `socket_mode` | `socket_mode` or `webhook`; integration metadata, not a receiver deployment | +| `gatewayUrl` | Omitted | Optional gateway URL advertised in setup metadata | +| `ticketLifetimeMs` | `600000` | Link ticket lifetime, `60000`–`3600000` ms | +| `linkLifetimeMs` | `2592000000` | Accepted link lifetime, `60000`–`7776000000` ms | +| `leaseMs` | `60000` | Run lease, `10000`–`300000` ms | +| `responseCredentialLifetimeMs` | `86400000` | Bound execution credential lifetime, `60000`–`604800000` ms | +| `artifactMaxBytes` | `10485760` | Per-artifact limit, `1`–`52428800` bytes | +| `artifactMaxFiles` | `5` | Artifacts per run, `1`–`20` | +| `artifactReadTimeoutMs` | `30000` | Read timeout, `1000`–`60000` ms | + +`cleanup` accepts `batchSize` (`25`, range `1`–`100`), `intervalMs` (`1000`, range `1000`–`60000`), and `maxIdleIntervalMs` (`30000`, range `1000`–`300000`). + +`feedback` accepts `maxConflictRetries` (`5`, range `1`–`20`), `exportTimeoutMs` (`10000`, range `1000`–`60000`), `exportLeaseMs` (`60000`, range `60000`–`300000`), `exportRetryMs` (`5000`, range `1000`–`300000`), and the same `batchSize`, `intervalMs`, and `maxIdleIntervalMs` defaults/ranges as `cleanup`. + +The gateway service boundary requires the server-side `CHANNEL_SERVICE_TOKEN`. Do not expose it to browsers or use it as a general Agent execution credential. Channel credential mode (`shared` or `per_user`) belongs to the channel record, not this deployment block. Both modes require explicit current actor linking; `shared` restricts linking to the channel creator's account rather than granting all external participants that account's privileges. + ## remoteApi Configuration for Remote Agent API authentication. Controls how external services authenticate when calling the Agents API endpoints. +### remoteApi.background + +Enables the opt-in [background Responses lifecycle](/docs/features/background_responses). It does not enable Remote Agents permissions or human approval by itself. + +| Option | Type | Default | Meaning | +| --- | --- | --- | --- | +| `enabled` | Boolean | `false` | Accept durable background Responses requests | +| `acknowledgementTimeoutMs` | Integer | `10000` | Worker admission acknowledgement timeout, from `100` through `60000` ms; not the model run timeout | + +Background requests require an Agent API key, stored responses, and non-streaming submission. Human-action resume requires durable MongoDB checkpoints and the corresponding existing approval/question policy. Set `DOMAIN_CLIENT` to the trusted public owner-review URL origin. + ### remoteApi.auth +Agent Channels require the matching channel runtime, feedback, HTTP, setup UI, and background Responses changes. They are disabled by default. A compatible Slack gateway is also required; this guide does not provide an installable gateway package or container. + + +Agent Channels connect external messaging events to [background Agent Responses](/docs/features/background_responses). Channel routes manage identity, admission, leases, delivery receipts, artifacts, and feedback. They are **not an alternative model-execution endpoint**: a compatible gateway submits execution through `/api/agents/v1/responses` using a server-provisioned, bound credential. + +## Configuration and prerequisites + +```yaml filename="endpoints / agents" +endpoints: + agents: + remoteApi: + background: + enabled: true + channels: + enabled: true + transport: socket_mode +``` + +Both enablement settings default to `false`. Existing Remote Agents permissions must also permit the relevant users to use the Agent API, and channel setup requires Agent sharing permission. Configure `DOMAIN_CLIENT` for trusted owner-review and account-link URLs. Configure a strong `CHANNEL_SERVICE_TOKEN` for the gateway-to-LibreChat service boundary; keep it server-side and distribute it only to a trusted integration process over a secure channel. It is not a browser token or a general Agent API key. + +The `transport` option accepts `socket_mode` (default) or `webhook`. This selects integration metadata; it does not deploy a receiver or create a public webhook automatically. `gatewayUrl` is an optional URL advertised by setup metadata. Deploy and secure a compatible gateway separately, with its own Slack transport configuration, event authenticity validation, and bot/app credentials. + +See the [channel configuration reference](/docs/configuration/librechat_yaml/object_structure/agents#channels) for limits and defaults. + +## Set up a channel + +1. Open the Agent's channel setup surface with an authorized LibreChat account. +2. Create a Slack channel configuration and explicitly choose `shared` or `per_user` credential mode. +3. Use the generated Slack manifest with your Slack app. Configure the gateway's chosen Slack transport separately; a manifest alone is not a running integration. +4. Activate the configuration with the matching Slack app ID and bot token. Supply the Slack signing secret when the chosen integration requires signature verification. LibreChat verifies the bot identity and stores credentials encrypted; normal setup responses do not return those secrets. +5. Complete account linking for the external actor. Send a test event only after the channel is active, the actor is linked, and the gateway is configured. + +Browser setup routes live under `/api/agents/{agentId}/channels`: list/create, read `/{channelId}/manifest`, update `/{channelId}`, and delete `/{channelId}`. These use authenticated Agent authorization, not the management API machine-token contract. The create body is `{ "type": "slack", "credentialMode": "per_user" }` (or `shared`). Activation updates use a `slack` object with `appId`, `botToken`, and optional `signingSecret`. To disable a channel, update its status to `disabled`. + +### Shared versus per-user credentials + +`per_user` binds each linked Slack actor to that actor's existing LibreChat account. Current tenant membership, account state, role capabilities, Agent permissions, and tool/provider credentials are evaluated for that user. + +`shared` does **not** make the Agent public to every Slack participant. Linking is restricted to the channel creator's LibreChat account; execution uses that explicitly linked principal's authority. Do not treat the activator's API key, a Slack display name, an email assertion, or another participant's thread history as consent for a new actor. + +Each actor/link revision has its own execution lane. Sharing a Slack thread does not share a LibreChat conversation or expose another actor's files, OAuth state, approvals, usage, or trace session. A different actor cannot inherit the first participant's pending question or approve its tool call. Mode/revision changes, unlinking, account removal, Agent access revocation, and key revocation invalidate old authority rather than silently remapping it. + +### Account linking + +The gateway can request an actor-bound, short-lived linking ticket. The user opens the trusted LibreChat URL, signs in, previews the request, and explicitly accepts it. A gateway then confirms the same ticket/actor binding; it must not infer linkage from a returned browser URL alone. + +Browser endpoints under `/api/channels/links` support preview, acceptance, listing, and revocation. Mutations require the normal authenticated browser and same-origin checks. Ticket lifetime defaults to 10 minutes; accepted links default to 30 days. Never post a bearer credential or provider OAuth URL into Slack. + +## Gateway protocol boundary + +Service requests use `Authorization: Bearer ` and the exact tenant/channel context. For routes without a tenant path parameter, send the channel's exact tenant in `x-tenant-id`; do not choose a tenant from untrusted message text. The service token permits this integration boundary, not arbitrary user impersonation. Never put it in client-side code, Slack messages, tracing payloads, or public logs. The credential bundle endpoint returns secrets to the trusted gateway and must not be exposed as a public discovery API. + +| Stage | Route under `/api/channels` | Responsibility | +| --- | --- | --- | +| Configuration | `GET /service/slack/{tenantId}/{channelId}` | Read the active channel and encrypted-at-rest credentials through an authenticated service boundary | +| Identity | `/service/{channelId}/identity/{externalUserId}` and its ticket/confirm operations | Resolve explicit actor linking; never infer a principal from thread history | +| Admission | `POST /service/{channelId}/runs` | Admit an idempotent event with verified team/app/actor identity | +| Ownership | `POST /service/{channelId}/runs/claim`, then `/{runId}/renew` | Claim and renew the exact run lease | +| Execution preparation | `POST /service/{channelId}/runs/{runId}/response/prepare` | Obtain the bound execution credential, request, and stable request key | +| Response binding | `POST /service/{channelId}/runs/{runId}/response/bind` | Bind the returned Responses identity to the admitted run | +| Progress and result | `/{runId}/advance`, `/{runId}/progress/*`, `/{runId}/plan`, `/{runId}/delivery/*`, `/{runId}/commit` | Project canonical state and record fenced delivery effects | +| Review projection | `POST /service/{channelId}/runs/{runId}/review` | Obtain the safe owner-review projection, not private approval/OAuth payloads | +| Artifacts | `POST /service/{channelId}/runs/{runId}/artifacts/{artifactId}` | Read only an artifact bound to the authorized run | +| Stop | `POST /service/{channelId}/runs/stop-thread` or `/{runId}/cancel` | Cancel only the authorized actor lane/run | +| Feedback | `POST /service/{channelId}/reactions` | Apply authenticated, deduplicated reaction events to confirmed delivered replies | + +Run-relative paths in the table are beneath `/service/{channelId}/runs`. Lease mutations carry the exact server-issued `{ runId, owner, epoch }` fence. Treat stale leases, changed authority, and ambiguous delivery outcomes as protocol states to reconcile, not permission to mint a new run or blindly resend a Slack message. + +Execution preparation returns an `apiKey`, `requestKey`, optional retained `responseId`, and a Responses `request` with the Agent ID, admitted input, `background: true`, `store: true`, and any authorized continuation. Submit that request to `/api/agents/v1/responses` using the bound key and `Idempotency-Key: `, then bind the returned response ID. Do not substitute a creator's unrestricted key, change the actor/Agent, or send the input to a channel bookkeeping route to execute it. + +The gateway owns Slack event verification, retry/deduplication, native message formatting, rate-limit handling, and delivery receipt reconciliation. Preserve exact event identifiers and timestamps. For feedback events, `eventTimestampUs` is an integer timestamp in microseconds; do not round it to milliseconds. Report confirmed, failed, or ambiguous side effects accurately before advancing delivery state. + +## Review, files, feedback, and privacy + +Only the owner-review link is projected for human actions. Private tool arguments, question payloads, and provider OAuth authorization URLs stay in the authenticated browser review view. The owner completes approval, question, or OAuth actions through the [background Responses lifecycle](/docs/features/background_responses#review-a-required-action). + +Artifacts are scoped to the authorized run and actor. Limits default to five files and 10 MiB per file, with a 30-second read timeout. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. + +Reaction feedback maps only to confirmed delivered assistant messages. It does not overwrite the browser's feedback field. Export is constrained by recorded sampling/destination provenance and current export policy. Temporary-chat provenance is retained; an old mapping without that provenance is not treated as a permanent chat. A policy change can suppress export even when the original trace was sampled. + +## Operational limits + +Disabling a channel or changing its credential mode retires old authority; it does not undo external tool effects. Stop can remain pending until the exact provider is drained and canonical cancellation/cleanup completes. A gateway must poll/reconcile canonical state rather than interpreting an acknowledgement as terminal completion. + +This contract does not promise a public gateway distribution, arbitrary chat-platform support, automatic migration of legacy thread-wide identity, or restart-survival of an in-memory OAuth waiter. Legacy thread read/write bookkeeping is not a substitute for actor-scoped runs. diff --git a/content/docs/features/agents_api.mdx b/content/docs/features/agents_api.mdx index 5289b5cfc..e666f0fee 100644 --- a/content/docs/features/agents_api.mdx +++ b/content/docs/features/agents_api.mdx @@ -16,6 +16,8 @@ There are three parts: Endpoints, request formats, and responses may still change between releases. +For opt-in asynchronous execution, retained human actions, owner review, and Stop, see [Background Agent Responses](/docs/features/background_responses). [Agent Channels](/docs/features/agent_channels) use that same Responses execution path while managing external identity and delivery separately. + ## Get an API key Open **Settings**, go to **Data & Privacy**, and find **Agent API Keys** under **API keys**. Click **Manage**, then **Create API Key**, give it a name, pick an expiration (7 days up to 1 year, or never), and copy the key right away: it is shown only once. diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx new file mode 100644 index 000000000..1de1e920e --- /dev/null +++ b/content/docs/features/background_responses.mdx @@ -0,0 +1,100 @@ +--- +title: Background Agent Responses +description: Run durable Agent Responses, review pending actions, and stop an owned execution +icon: Workflow +--- + + +These interfaces require a LibreChat version that includes the background Responses runtime and HTTP lifecycle routes. Background execution is disabled by default. Deploy all prerequisite runtime, storage, and route changes before enabling it. + + +Background Responses use the existing [Agents API](/docs/features/agents_api), not a separate model execution engine. A request returns a stored response identity while a worker executes the Agent. Clients poll that identity for output, required actions, and the canonical terminal result. + +## Enable background execution + +Merge this block into your existing configuration: + +```yaml filename="endpoints / agents" +endpoints: + agents: + remoteApi: + background: + enabled: true + acknowledgementTimeoutMs: 10000 +``` + +`enabled` defaults to `false`. `acknowledgementTimeoutMs` defaults to `10000` and accepts integers from `100` through `60000`; it bounds the worker admission acknowledgement, not total model execution time. Existing Remote Agents permissions, Agent access, terms acceptance, content checks, and provider/tool policies still apply. + +Background submission requires an **Agent API key**, including when ordinary inference also accepts OIDC. A management API machine token is not an execution credential. Configure [Remote Agents permissions](/docs/features/agents_api#enabling-the-agents-api) separately. + +Human tool approval and Ask User pauses require durable MongoDB checkpoint storage. Use the existing [`toolApproval`](/docs/configuration/librechat_yaml/object_structure/agents#toolapproval), Ask User, and [`checkpointer`](/docs/configuration/librechat_yaml/object_structure/agents#checkpointer) settings; background execution does not automatically enable approval or bypass a deny rule. A memory checkpointer does not provide durable background human-action resume. Ordinary requests without a human pause retain their normal execution path. + +Set `DOMAIN_CLIENT` to the trusted public browser URL so generated review links point to your deployment. Do not construct review destinations from incoming Host headers. + +## Submit and poll + +```bash +curl https://chat.example.com/api/agents/v1/responses \ + -H 'Authorization: Bearer YOUR_AGENT_API_KEY' \ + -H 'Content-Type: application/json' \ + -H 'Idempotency-Key: report-request-001' \ + -d '{"model":"AGENT_ID","input":"Summarize the latest report.","background":true,"store":true}' +``` + +Accepted background requests return HTTP `202` with a response object. `background: true` requires storage: omit `store` or set it to `true`. `store: false` and `stream: true` are rejected for background requests. Ordinary synchronous and streaming Responses remain separate supported modes when `background` is omitted or false. + +Use a stable `Idempotency-Key` for retries of the same logical submission. The optional key must be nonblank and at most 256 characters; do not reuse it for a different request. If omitted, the server creates a new request identity, so an ambiguous network retry can create another request. + +```bash +curl https://chat.example.com/api/agents/v1/responses/RESPONSE_ID \ + -H 'Authorization: Bearer YOUR_AGENT_API_KEY' +``` + +Poll the same response until its public status is `completed`, `failed`, `incomplete`, or `cancelled`. `queued` and `in_progress` are not terminal. The server rechecks the original source key and current authority; possession of a response ID is not permission to read or resume it. Use the returned response ID as `previous_response_id` for a subsequent supported continuation rather than resending the original user input. + +## Review a required action + +A public response can include: + +```json +{ + "status": "in_progress", + "required_action": { + "type": "librechat_review", + "kind": "tool_approval", + "action_id": "ACTION_ID", + "expires_at": 1800000000, + "review_url": "https://chat.example.com/responses/RESPONSE_ID/review" + } +} +``` + +`kind` is `tool_approval`, `question`, or `oauth`. `expires_at` is Unix time in seconds. Treat the action as actionable only while it is present and unexpired. The public projection intentionally omits private approval payloads and provider OAuth URLs. Do not infer that public `in_progress` means a provider is currently running: it also covers a retained action waiting for its owner. + +Open `review_url` in a browser and sign in as the response owner in the correct tenant. The owner can inspect the exact pending tool call, answer a question, or continue an MCP OAuth flow. An unrelated account cannot approve a request just because it can access the same Agent. + +The browser lifecycle uses session authentication, not an Agent API key or a management token: + +| Method | Route | Purpose | +| --- | --- | --- | +| `GET` | `/api/agents/responses/{id}/review` | Read the owner-only review view | +| `POST` | `/api/agents/responses/{id}/review` | Submit the current action decision | +| `POST` | `/api/agents/responses/{id}/cancel` | Request Stop for an owned response | + +Decision submissions include the exact current `actionId` and the payload appropriate to that action. Question submissions use `answer`, or `answers` keyed by the presented question identities. Tool approval submissions use `decisions` containing the exact `tool_call_id` and an allowed `decision` (`approve`, `reject`, `edit`, or `respond`), with the corresponding edited arguments or response text when needed. Use the supplied review UI to respect action-specific validation and offered scopes; an enum value in a transport schema is not a grant to choose an unavailable approval scope. + +A successful decision returns HTTP `202` with `responseId`, `actionId`, `intentId`, and `status` (`queued` or `settled`). This is an acknowledgement, not proof that execution completed. Refresh the canonical review/response state. Do not automatically resubmit an ambiguous decision with a different intent or replay a stale action after a conflict. Resume revalidates current Agent/model/tool/project/file authority and retained execution provenance before privileged work. + +## OAuth recovery limits + +MCP OAuth prompts are retained for owner-only replay until their deadline. Complete authorization through the supplied provider flow; do not submit an approval decision to replace an OAuth callback. A successful callback can continue the same waiting execution while its waiter is still active. + +Durable prompt visibility is not a guarantee that an in-memory OAuth waiter survives a server restart. Durable human question/tool-approval checkpoints and OAuth authorization waiters are different mechanisms. If the OAuth attempt expired or its waiting execution was lost, use the current failure/retry state; do not keep replaying an old authorization URL or assume authorization alone restarted the model. See [MCP authentication](/docs/features/mcp#oauth-authentication). + +## Stop and recovery + +API-key clients can request cancellation with `POST /api/agents/v1/responses/{id}/cancel`. Owners can use **Stop** in the review UI. Both paths operate on the same durable response; neither starts a replacement execution. + +A cancellation acknowledgement may still report a nonterminal status while provider drain, checkpoint cleanup, or terminal publication is pending. Continue polling until canonical `cancelled` (or another terminal result already won the race). Stop is not rollback: tools may already have performed external effects. Do not repeat an external operation merely because its answer was cancelled. + +Revoked source keys, changed channel/account bindings, missing authority, stale checkpoint identities, and changed privileged code targets fail closed. Temporary storage outages can delay terminal publication and cleanup; do not force-delete execution proof or manually replay tools to make the status change. diff --git a/content/docs/features/meta.json b/content/docs/features/meta.json index 184105df9..d13ce9856 100644 --- a/content/docs/features/meta.json +++ b/content/docs/features/meta.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", From 3b76ab53cf20aca1864c2f5985e659da37513545 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Wed, 28 Oct 2026 23:59:10 +0100 Subject: [PATCH 02/38] =?UTF-8?q?=F0=9F=93=98=20docs:=20Describe=20Native?= =?UTF-8?q?=20Channel=20Review=20and=20Safe=20Recovery?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/docs/features/agent_channels.mdx | 7 +++++-- content/docs/features/background_responses.mdx | 2 +- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index e55946296..8b7ccbe7b 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -66,7 +66,8 @@ Service requests use `Authorization: Bearer ` and the exa | Execution preparation | `POST /service/{channelId}/runs/{runId}/response/prepare` | Obtain the bound execution credential, request, and stable request key | | Response binding | `POST /service/{channelId}/runs/{runId}/response/bind` | Bind the returned Responses identity to the admitted run | | Progress and result | `/{runId}/advance`, `/{runId}/progress/*`, `/{runId}/plan`, `/{runId}/delivery/*`, `/{runId}/commit` | Project canonical state and record fenced delivery effects | -| Review projection | `POST /service/{channelId}/runs/{runId}/review` | Obtain the safe owner-review projection, not private approval/OAuth payloads | +| Review projection | `POST /service/{channelId}/runs/{runId}/review` | Reauthorize the original actor; obtain the browser fallback and, for the exact external channel, the current private question/tool-review payload | +| Review decision | `POST /service/{channelId}/runs/{runId}/review/decision` | Submit the current actor's decision to the same canonical Response, using its immutable decision receipt and resume preflight | | Artifacts | `POST /service/{channelId}/runs/{runId}/artifacts/{artifactId}` | Read only an artifact bound to the authorized run | | Stop | `POST /service/{channelId}/runs/stop-thread` or `/{runId}/cancel` | Cancel only the authorized actor lane/run | | Feedback | `POST /service/{channelId}/reactions` | Apply authenticated, deduplicated reaction events to confirmed delivered replies | @@ -79,7 +80,9 @@ The gateway owns Slack event verification, retry/deduplication, native message f ## Review, files, feedback, and privacy -Only the owner-review link is projected for human actions. Private tool arguments, question payloads, and provider OAuth authorization URLs stay in the authenticated browser review view. The owner completes approval, question, or OAuth actions through the [background Responses lifecycle](/docs/features/background_responses#review-a-required-action). +The public run snapshot contains only an opaque action descriptor. A review request with the original verified actor, current channel revision, and exact `externalChannelId` can obtain minimal private question/tool-approval details. The backend derives the owner and Response from the run and checks the current actor link and source grant; it does not accept an arbitrary user ID. The gateway must show these details only to that actor, not publicly in a shared thread. Slack can use ephemeral choice buttons and private modals. Native tool approval is for the individual call only; unsupported/richer forms retain the browser fallback. + +Decision requests include that same actor, revision, external channel, and the existing Responses `decision` body. Backend decision receipts, expiry/conflict checks, full authorization preflight, and same-Response resume remain authoritative. A Slack click alone is not permission to resume work. Provider OAuth URLs remain exclusively in the authenticated browser review flow. See the [background Responses lifecycle](/docs/features/background_responses#review-a-required-action). Artifacts are scoped to the authorized run and actor. Limits default to five files and 10 MiB per file, with a 30-second read timeout. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index 1de1e920e..97c7dcebb 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -89,7 +89,7 @@ A successful decision returns HTTP `202` with `responseId`, `actionId`, `intentI MCP OAuth prompts are retained for owner-only replay until their deadline. Complete authorization through the supplied provider flow; do not submit an approval decision to replace an OAuth callback. A successful callback can continue the same waiting execution while its waiter is still active. -Durable prompt visibility is not a guarantee that an in-memory OAuth waiter survives a server restart. Durable human question/tool-approval checkpoints and OAuth authorization waiters are different mechanisms. If the OAuth attempt expired or its waiting execution was lost, use the current failure/retry state; do not keep replaying an old authorization URL or assume authorization alone restarted the model. See [MCP authentication](/docs/features/mcp#oauth-authentication). +Durable prompt visibility is not a guarantee that an in-memory OAuth waiter survives a server restart. Durable human question/tool-approval checkpoints and OAuth authorization waiters are different mechanisms. If exact execution state is missing or mismatched, the response reports nonterminal `recovery: "execution_state_unavailable"` and removes stale actionable prompts. This is not proof of completion or cancellation and does not replay work. Sign-in credentials may have been saved even though the original run did not continue. Check external results before retrying; an administrator must reconcile a persistently unknown execution before the held run can safely be cleared. Do not replay an old authorization URL or infer that sign-in restarted the model. See [MCP authentication](/docs/features/mcp#oauth-authentication). ## Stop and recovery From 8c1f3cab575babcd8f1c8cd2f70e6824552c64be Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 29 Oct 2026 02:59:37 +0100 Subject: [PATCH 03/38] docs: Explain Fenced Polling Yield and Private Decision Receipts --- content/docs/features/agent_channels.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 8b7ccbe7b..6f1de3c47 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -62,7 +62,7 @@ Service requests use `Authorization: Bearer ` and the exa | Configuration | `GET /service/slack/{tenantId}/{channelId}` | Read the active channel and encrypted-at-rest credentials through an authenticated service boundary | | Identity | `/service/{channelId}/identity/{externalUserId}` and its ticket/confirm operations | Resolve explicit actor linking; never infer a principal from thread history | | Admission | `POST /service/{channelId}/runs` | Admit an idempotent event with verified team/app/actor identity | -| Ownership | `POST /service/{channelId}/runs/claim`, then `/{runId}/renew` | Claim and renew the exact run lease | +| Ownership | `POST /service/{channelId}/runs/claim`, then `/{runId}/renew` or `/{runId}/yield` | Claim, renew, or safely yield the exact polling lease | | Execution preparation | `POST /service/{channelId}/runs/{runId}/response/prepare` | Obtain the bound execution credential, request, and stable request key | | Response binding | `POST /service/{channelId}/runs/{runId}/response/bind` | Bind the returned Responses identity to the admitted run | | Progress and result | `/{runId}/advance`, `/{runId}/progress/*`, `/{runId}/plan`, `/{runId}/delivery/*`, `/{runId}/commit` | Project canonical state and record fenced delivery effects | @@ -74,6 +74,8 @@ Service requests use `Authorization: Bearer ` and the exa Run-relative paths in the table are beneath `/service/{channelId}/runs`. Lease mutations carry the exact server-issued `{ runId, owner, epoch }` fence. Treat stale leases, changed authority, and ambiguous delivery outcomes as protocol states to reconcile, not permission to mint a new run or blindly resend a Slack message. +A gateway can yield a Responses-bound polling turn only after its progress writes and renewal loop have drained. The backend invalidates that polling fence and enforces a one-second reclaim cooldown; the next claim increments the epoch. This does not release the actor lane, cancel the provider, change the Response, or erase delivery evidence. Inflight or unknown remote writes cannot yield. If a host does not support yield or the request is uncertain, retain ordinary lease-expiry recovery instead of starting a new execution. + Execution preparation returns an `apiKey`, `requestKey`, optional retained `responseId`, and a Responses `request` with the Agent ID, admitted input, `background: true`, `store: true`, and any authorized continuation. Submit that request to `/api/agents/v1/responses` using the bound key and `Idempotency-Key: `, then bind the returned response ID. Do not substitute a creator's unrestricted key, change the actor/Agent, or send the input to a channel bookkeeping route to execute it. The gateway owns Slack event verification, retry/deduplication, native message formatting, rate-limit handling, and delivery receipt reconciliation. Preserve exact event identifiers and timestamps. For feedback events, `eventTimestampUs` is an integer timestamp in microseconds; do not round it to milliseconds. Report confirmed, failed, or ambiguous side effects accurately before advancing delivery state. @@ -84,6 +86,8 @@ The public run snapshot contains only an opaque action descriptor. A review requ Decision requests include that same actor, revision, external channel, and the existing Responses `decision` body. Backend decision receipts, expiry/conflict checks, full authorization preflight, and same-Response resume remain authoritative. A Slack click alone is not permission to resume work. Provider OAuth URLs remain exclusively in the authenticated browser review flow. See the [background Responses lifecycle](/docs/features/background_responses#review-a-required-action). +An actor-private receipt can confirm that a question answer or per-call tool approval/decline was accepted without disclosing tool arguments or claiming completion. A saved decision whose queue publication failed must remain retryable with the exact immutable decision; it cannot be replaced by a different answer. Keep Stop available while work remains active and update public progress only through the fenced delivery protocol. + Artifacts are scoped to the authorized run and actor. Limits default to five files and 10 MiB per file, with a 30-second read timeout. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. Reaction feedback maps only to confirmed delivered assistant messages. It does not overwrite the browser's feedback field. Export is constrained by recorded sampling/destination provenance and current export policy. Temporary-chat provenance is retained; an old mapping without that provenance is not treated as a permanent chat. A policy change can suppress export even when the original trace was sampled. From 3d362b8cb0f901c15cd06ff3c5b304994d6ffa06 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 29 Oct 2026 03:45:52 +0100 Subject: [PATCH 04/38] docs: describe feature requirements without implementation history --- content/docs/features/agent_channels.mdx | 2 +- content/docs/features/background_responses.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 6f1de3c47..d53150391 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -5,7 +5,7 @@ icon: MessagesSquare --- -Agent Channels require the matching channel runtime, feedback, HTTP, setup UI, and background Responses changes. They are disabled by default. A compatible Slack gateway is also required; this guide does not provide an installable gateway package or container. +Agent Channels are a beta integration and are disabled by default. A compatible Slack gateway is also required; this guide does not provide an installable gateway package or container. Agent Channels connect external messaging events to [background Agent Responses](/docs/features/background_responses). Channel routes manage identity, admission, leases, delivery receipts, artifacts, and feedback. They are **not an alternative model-execution endpoint**: a compatible gateway submits execution through `/api/agents/v1/responses` using a server-provisioned, bound credential. diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index 97c7dcebb..512585f6a 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -5,7 +5,7 @@ icon: Workflow --- -These interfaces require a LibreChat version that includes the background Responses runtime and HTTP lifecycle routes. Background execution is disabled by default. Deploy all prerequisite runtime, storage, and route changes before enabling it. +Background execution is a beta feature and is disabled by default. Use a LibreChat version that supports background Responses before enabling it. Background Responses use the existing [Agents API](/docs/features/agents_api), not a separate model execution engine. A request returns a stored response identity while a worker executes the Agent. Clients poll that identity for output, required actions, and the canonical terminal result. From f5e48963ac8db26e7a2984c6db42f5b8404adc05 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 29 Oct 2026 11:28:17 +0100 Subject: [PATCH 05/38] docs: Explain Standalone TypeScript Gateway Setup --- .../object_structure/agents.mdx | 6 +- content/docs/features/agent_channels.mdx | 114 ++++++++++++++++-- 2 files changed, 108 insertions(+), 12 deletions(-) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 8af813528..b3f035f46 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1499,13 +1499,13 @@ Unknown management-auth fields, duplicate client IDs, malformed user or tenant I ## channels -Configures the opt-in [Agent Channels integration](/docs/features/agent_channels). A compatible external gateway and enabled background Responses are required; this setting does not deploy a gateway or enable execution permissions. +Configures the opt-in [Agent Channels integration](/docs/features/agent_channels). Enabled background Responses and a separately running gateway are required. The LibreChat source includes the standalone TypeScript Slack gateway in `packages/channel-gateway`; this setting does not start it or enable execution permissions. | Option | Default | Accepted values / purpose | | --- | --- | --- | | `enabled` | `false` | Enable channel setup and service routes | | `transport` | `socket_mode` | `socket_mode` or `webhook`; integration metadata, not a receiver deployment | -| `gatewayUrl` | Omitted | Optional gateway URL advertised in setup metadata | +| `gatewayUrl` | Omitted | Required HTTPS base URL for generating webhook callback URLs; not needed for Socket Mode | | `ticketLifetimeMs` | `600000` | Link ticket lifetime, `60000`–`3600000` ms | | `linkLifetimeMs` | `2592000000` | Accepted link lifetime, `60000`–`7776000000` ms | | `leaseMs` | `60000` | Run lease, `10000`–`300000` ms | @@ -1520,6 +1520,8 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels The gateway service boundary requires the server-side `CHANNEL_SERVICE_TOKEN`. Do not expose it to browsers or use it as a general Agent execution credential. Channel credential mode (`shared` or `per_user`) belongs to the channel record, not this deployment block. Both modes require explicit current actor linking; `shared` restricts linking to the channel creator's account rather than granting all external participants that account's privileges. +Set the gateway process's `SLACK_TRANSPORT` explicitly to match `transport`. The gateway environment defaults to `webhook`, while this manifest setting defaults to `socket_mode`. Gateway runtime settings, including its tenant/connection IDs, app-level Socket Mode token, native Slack session option, and optional `APP_TITLE` label, are documented in [Run the Slack gateway](/docs/features/agent_channels#run-the-slack-gateway). + ## remoteApi Configuration for Remote Agent API authentication. Controls how external services authenticate when calling the Agents API endpoints. diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index d53150391..991070fd1 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -5,7 +5,7 @@ icon: MessagesSquare --- -Agent Channels are a beta integration and are disabled by default. A compatible Slack gateway is also required; this guide does not provide an installable gateway package or container. +Agent Channels are a beta integration and are disabled by default. The standalone TypeScript Slack gateway lives in `packages/channel-gateway` in the LibreChat repository. Enabling Channels does not start that process or install a Slack app. Agent Channels connect external messaging events to [background Agent Responses](/docs/features/background_responses). Channel routes manage identity, admission, leases, delivery receipts, artifacts, and feedback. They are **not an alternative model-execution endpoint**: a compatible gateway submits execution through `/api/agents/v1/responses` using a server-provisioned, bound credential. @@ -25,20 +25,112 @@ endpoints: Both enablement settings default to `false`. Existing Remote Agents permissions must also permit the relevant users to use the Agent API, and channel setup requires Agent sharing permission. Configure `DOMAIN_CLIENT` for trusted owner-review and account-link URLs. Configure a strong `CHANNEL_SERVICE_TOKEN` for the gateway-to-LibreChat service boundary; keep it server-side and distribute it only to a trusted integration process over a secure channel. It is not a browser token or a general Agent API key. -The `transport` option accepts `socket_mode` (default) or `webhook`. This selects integration metadata; it does not deploy a receiver or create a public webhook automatically. `gatewayUrl` is an optional URL advertised by setup metadata. Deploy and secure a compatible gateway separately, with its own Slack transport configuration, event authenticity validation, and bot/app credentials. +The `transport` option accepts `socket_mode` (default) or `webhook`. This selects the generated Slack manifest; it does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. Set the gateway's `SLACK_TRANSPORT` explicitly to match this setting: the gateway process defaults to `webhook`, not `socket_mode`. See the [channel configuration reference](/docs/configuration/librechat_yaml/object_structure/agents#channels) for limits and defaults. ## Set up a channel -1. Open the Agent's channel setup surface with an authorized LibreChat account. -2. Create a Slack channel configuration and explicitly choose `shared` or `per_user` credential mode. -3. Use the generated Slack manifest with your Slack app. Configure the gateway's chosen Slack transport separately; a manifest alone is not a running integration. -4. Activate the configuration with the matching Slack app ID and bot token. Supply the Slack signing secret when the chosen integration requires signature verification. LibreChat verifies the bot identity and stores credentials encrypted; normal setup responses do not return those secrets. -5. Complete account linking for the external actor. Send a test event only after the channel is active, the actor is linked, and the gateway is configured. +1. Save the Agent, then select **Channels → Add** in the Agent builder. Choose per-user or owner-only mode and continue. You need permission to share the Agent. +2. Create a Slack app from the generated manifest and install it into your workspace. The manifest editor changes only the draft you download; it does not update an installed Slack app. +3. Under **Add Credentials**, enter the matching Slack app ID and bot token. For webhooks, also enter its signing secret. Activate the connection. LibreChat verifies the bot identity and stores credentials encrypted; normal setup responses do not return those secrets. +4. Copy the connection ID from the connection details. Configure and start the gateway as described below. It must be able to reach the active connection before startup can complete. +5. Invite the bot to a Slack channel and mention it. Each sender completes their own account-link flow before their request can run. Browser setup routes live under `/api/agents/{agentId}/channels`: list/create, read `/{channelId}/manifest`, update `/{channelId}`, and delete `/{channelId}`. These use authenticated Agent authorization, not the management API machine-token contract. The create body is `{ "type": "slack", "credentialMode": "per_user" }` (or `shared`). Activation updates use a `slack` object with `appId`, `botToken`, and optional `signingSecret`. To disable a channel, update its status to `disabled`. +## Run the Slack gateway + +The gateway is a separate Node.js 24+ process, not an in-process LibreChat plugin. It uses Slack's official Node SDKs and calls LibreChat over HTTP; it does not connect directly to MongoDB or require a general-purpose Agent API key. One gateway configuration binds to one tenant and connection. Run another configured process for another connection. + +From a LibreChat source checkout containing `packages/channel-gateway`: + +```sh +npm ci +npm run build --workspace @librechat/channel-gateway +node --env-file=/secure/channel-gateway.env packages/channel-gateway/dist/main.cjs +``` + +Supply the environment file through your normal secret-management process. Do not commit it. A Socket Mode configuration is: + +```dotenv filename="channel-gateway.env" +LIBRECHAT_INTERNAL_URL=http://127.0.0.1:3080 +CHANNEL_SERVICE_TOKEN= +CHANNEL_TENANT_ID= +CHANNEL_ID= +SLACK_TRANSPORT=socket_mode +SLACK_APP_TOKEN= +``` + +`LIBRECHAT_INTERNAL_URL` must be reachable from the gateway process. For example, `127.0.0.1` refers to the gateway's own container when running inside a container. Use the exact tenant ID for a multi-tenant deployment; use `_` only for a single-tenant deployment without a tenant ID. The gateway obtains the bot token and signing secret from LibreChat's authenticated connection bundle, so those values do not need separate gateway environment variables. + +For Socket Mode, enable Socket Mode for the same Slack app and create an app-level token with `connections:write`. Keep that token only in the gateway's secret configuration. No public callback URL is needed, but the gateway needs outbound access to Slack and LibreChat. + +For webhooks, set `SLACK_TRANSPORT=webhook` instead and omit `SLACK_APP_TOKEN`. Put the gateway behind HTTPS and set these Slack request URLs, replacing the placeholders with the configured, URL-encoded IDs: + +```text +Events: https://gateway.example.com/slack/events// +Interactivity: https://gateway.example.com/slack/interactions// +``` + +The webhook receiver verifies Slack signatures using the connection's signing secret. Keep LibreChat's channel service routes private to trusted integrations. Expose only the required Slack callback paths publicly; keep health and metrics endpoints on an internal network. + +### Docker Compose + +The source also includes an optional `docker-compose.channels.yml` overlay. It builds the standalone gateway from the repository root using `packages/channel-gateway/Dockerfile`; it does not pull a published gateway image or add the gateway to the default stack. + +With a compatible LibreChat `api` service already running in the same Compose project, run this from the LibreChat repository root: + +```sh +docker compose --env-file .env --env-file /secure/channel-gateway.env \ + -f docker-compose.yml -f docker-compose.channels.yml \ + --profile channels up -d --build channel-gateway +``` + +The second environment file supplies the connection and Socket Mode values from the example above. Keep the same `CHANNEL_SERVICE_TOKEN` in LibreChat's own `.env`; Compose variable substitution does not update the `.env` mounted into the API container. Use the same Compose project name and any existing deployment overrides as your running stack. + +The overlay defaults to Socket Mode and points `LIBRECHAT_INTERNAL_URL` at `http://api:${PORT:-3080}` on the Compose network. It does not use the example's host-loopback URL. The gateway itself listens on container port `8080`, with no published host ports. Socket Mode needs no inbound port; for webhooks, configure your HTTPS reverse proxy to reach `channel-gateway:8080` on that network and forward only the Slack callback paths. + +The Compose service runs as a non-root user with a read-only filesystem, dropped capabilities, and a health check. To build just the image, the build context must still be the repository root: + +```sh +docker build -f packages/channel-gateway/Dockerfile \ + -t librechat-channel-gateway:local . +``` + +### Gateway settings + +| Environment variable | Default | Purpose | +| --- | --- | --- | +| `PORT` | `8080` | Gateway HTTP port | +| `LISTEN_HOST` | `0.0.0.0` | Listen address; use loopback for a host-only local process | +| `LIBRECHAT_INTERNAL_URL` | `http://localhost:3080` | LibreChat service origin | +| `CHANNEL_SERVICE_TOKEN` | Required | Shared server-side service-boundary token | +| `CHANNEL_TENANT_ID` | Required | Exact connection tenant; `_` for single-tenant deployments | +| `CHANNEL_ID` | Required | Connection ID, not the Slack channel ID or Agent ID | +| `SLACK_TRANSPORT` | `webhook` | `webhook` or `socket_mode`; match LibreChat's manifest setting | +| `SLACK_APP_TOKEN` | Required for Socket Mode | App-level token for the same Slack app | +| `SLACK_NATIVE_SESSIONS` | `false` | Use Slack's native Agent loading, status, and Stop UI after app setup below | +| `SLACK_LIFECYCLE_REACTIONS` | `false` | Add processing/completion reactions to the sender's message | +| `APP_TITLE` | `LibreChat` | Application name in browser-review button labels, such as “Open in LibreChat” | +| `API_CALL_TIMEOUT_MS` | `10000` | Timeout for individual service and Slack API calls | +| `AGENT_INVOKE_TIMEOUT_MS` | `120000` | Timeout for initial background Response submission, not the full Agent run | +| `SLACK_SIGNATURE_TOLERANCE_SECS` | `300` | Maximum webhook signature timestamp age/skew | + +`SLACK_API_BASE_URL` defaults to `https://slack.com/api/`; leave it unchanged outside controlled tests. Existing `SLACK_SOCKET_TENANT_ID` and `SLACK_SOCKET_CHANNEL_ID` aliases remain accepted, but conflicting old and new values are rejected. Actor-bound durable execution cannot be disabled. + +The process exposes `/readyz` for liveness, `/healthz` for startup/Socket Mode readiness, and `/metrics` for Prometheus metrics. A successful connection activation confirms Slack credentials, not that a gateway is running or connected. Check gateway health and perform a real mention before treating setup as complete. + +### Native Agent UI and final replies + +By default, a stable working message provides Stop and, when needed, Review controls. Answers are posted after generation, rather than repeatedly replacing a growing reply. Formatting includes code, tables, links, file attachments, and qualified cost/time details; unavailable costs are not estimated. + +To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope and `agent_session_stopped` event subscription, and reinstall the app. These are additional to the basic generated manifest. Then set `SLACK_NATIVE_SESSIONS=true` and restart the gateway. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. + +Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions are separate from native sessions and require the reaction permissions already present in the basic manifest. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. + +## Identity and permissions + ### Shared versus per-user credentials `per_user` binds each linked Slack actor to that actor's existing LibreChat account. Current tenant membership, account state, role capabilities, Agent permissions, and tool/provider credentials are evaluated for that user. @@ -49,7 +141,7 @@ Each actor/link revision has its own execution lane. Sharing a Slack thread does ### Account linking -The gateway can request an actor-bound, short-lived linking ticket. The user opens the trusted LibreChat URL, signs in, previews the request, and explicitly accepts it. A gateway then confirms the same ticket/actor binding; it must not infer linkage from a returned browser URL alone. +On the first mention, the gateway sends the actor a private linking prompt. Open its trusted LibreChat URL, sign in, preview the request, and accept it. Return to Slack and mention the bot again to receive the exact-account confirmation, then confirm it there. The next mention can run. The gateway does not replay the original request after linking, and browser acceptance alone does not activate the link. Browser endpoints under `/api/channels/links` support preview, acceptance, listing, and revocation. Mutations require the normal authenticated browser and same-origin checks. Ticket lifetime defaults to 10 minutes; accepted links default to 30 days. Never post a bearer credential or provider OAuth URL into Slack. @@ -86,7 +178,9 @@ The public run snapshot contains only an opaque action descriptor. A review requ Decision requests include that same actor, revision, external channel, and the existing Responses `decision` body. Backend decision receipts, expiry/conflict checks, full authorization preflight, and same-Response resume remain authoritative. A Slack click alone is not permission to resume work. Provider OAuth URLs remain exclusively in the authenticated browser review flow. See the [background Responses lifecycle](/docs/features/background_responses#review-a-required-action). -An actor-private receipt can confirm that a question answer or per-call tool approval/decline was accepted without disclosing tool arguments or claiming completion. A saved decision whose queue publication failed must remain retryable with the exact immutable decision; it cannot be replaced by a different answer. Keep Stop available while work remains active and update public progress only through the fenced delivery protocol. +The gateway uses private Slack controls for supported questions and individual tool approvals/declines. Tool names and argument previews, when supplied by the authorized review projection, remain private to that actor. Successful submission closes the modal and sends a private acknowledgement; it does not force a separate browser receipt page or claim the tool finished. Provider sign-in and unsupported review forms still open the authenticated browser flow. The Agent's existing approval policy determines whether a tool needs approval; connecting Slack does not make every tool manual or bypass that policy. + +A saved decision whose queue publication failed remains retryable with the exact immutable decision; it cannot be replaced by a different answer. Keep Stop available while work remains active and update public progress only through the fenced delivery protocol. Artifacts are scoped to the authorized run and actor. Limits default to five files and 10 MiB per file, with a 30-second read timeout. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. @@ -96,4 +190,4 @@ Reaction feedback maps only to confirmed delivered assistant messages. It does n Disabling a channel or changing its credential mode retires old authority; it does not undo external tool effects. Stop can remain pending until the exact provider is drained and canonical cancellation/cleanup completes. A gateway must poll/reconcile canonical state rather than interpreting an acknowledgement as terminal completion. -This contract does not promise a public gateway distribution, arbitrary chat-platform support, automatic migration of legacy thread-wide identity, or restart-survival of an in-memory OAuth waiter. Legacy thread read/write bookkeeping is not a substitute for actor-scoped runs. +The gateway package is built from the LibreChat source tree; it is not published as an npm package. This integration does not promise arbitrary chat-platform support, automatic migration of legacy thread-wide identity, or restart-survival of an in-memory OAuth waiter. A restart can require a new browser sign-in; uncertain continuation must not be reported as completed or retried as new work. Legacy thread read/write bookkeeping is not a substitute for actor-scoped runs. From bf9a12d77a68a4cd81930d27721e02c8f7b2929c Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 29 Oct 2026 13:07:49 +0100 Subject: [PATCH 06/38] docs: align channel setup with the read-only manifest --- content/docs/features/agent_channels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 991070fd1..77ba28dcb 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -32,7 +32,7 @@ See the [channel configuration reference](/docs/configuration/librechat_yaml/obj ## Set up a channel 1. Save the Agent, then select **Channels → Add** in the Agent builder. Choose per-user or owner-only mode and continue. You need permission to share the Agent. -2. Create a Slack app from the generated manifest and install it into your workspace. The manifest editor changes only the draft you download; it does not update an installed Slack app. +2. Copy the read-only Slack app manifest into Slack's app setup and install the app into your workspace. Make any app changes in Slack's app settings. 3. Under **Add Credentials**, enter the matching Slack app ID and bot token. For webhooks, also enter its signing secret. Activate the connection. LibreChat verifies the bot identity and stores credentials encrypted; normal setup responses do not return those secrets. 4. Copy the connection ID from the connection details. Configure and start the gateway as described below. It must be able to reach the active connection before startup can complete. 5. Invite the bot to a Slack channel and mention it. Each sender completes their own account-link flow before their request can run. From 7c1fc9eead6426d36d54e4cd46c3488b074bd7f2 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Sat, 31 Oct 2026 00:11:33 +0100 Subject: [PATCH 07/38] =?UTF-8?q?=F0=9F=93=9A=20docs:=20Clarify=20Response?= =?UTF-8?q?=20Storage=20and=20Channel=20Consent?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/docs/features/agent_channels.mdx | 4 +++- content/docs/features/background_responses.mdx | 8 ++++++-- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 77ba28dcb..6d4bd87c8 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -23,7 +23,7 @@ endpoints: transport: socket_mode ``` -Both enablement settings default to `false`. Existing Remote Agents permissions must also permit the relevant users to use the Agent API, and channel setup requires Agent sharing permission. Configure `DOMAIN_CLIENT` for trusted owner-review and account-link URLs. Configure a strong `CHANNEL_SERVICE_TOKEN` for the gateway-to-LibreChat service boundary; keep it server-side and distribute it only to a trusted integration process over a secure channel. It is not a browser token or a general Agent API key. +Both enablement settings default to `false`. Users need both Agent use and Remote Agents use permissions. Channel setup also requires Agent sharing permission or existing administrator management access; sharing access does not require permission to edit the Agent. Configure `DOMAIN_CLIENT` for trusted owner-review and account-link URLs. Configure a strong `CHANNEL_SERVICE_TOKEN` for the gateway-to-LibreChat service boundary; keep it server-side and distribute it only to a trusted integration process over a secure channel. It is not a browser token or a general Agent API key. The `transport` option accepts `socket_mode` (default) or `webhook`. This selects the generated Slack manifest; it does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. Set the gateway's `SLACK_TRANSPORT` explicitly to match this setting: the gateway process defaults to `webhook`, not `socket_mode`. @@ -143,6 +143,8 @@ Each actor/link revision has its own execution lane. Sharing a Slack thread does On the first mention, the gateway sends the actor a private linking prompt. Open its trusted LibreChat URL, sign in, preview the request, and accept it. Return to Slack and mention the bot again to receive the exact-account confirmation, then confirm it there. The next mention can run. The gateway does not replay the original request after linking, and browser acceptance alone does not activate the link. +Manage and revoke your links in Account settings. A link can become unavailable when the channel or account is no longer eligible; you can still withdraw that consent. Restoring eligibility does not reactivate a link you explicitly revoked. + Browser endpoints under `/api/channels/links` support preview, acceptance, listing, and revocation. Mutations require the normal authenticated browser and same-origin checks. Ticket lifetime defaults to 10 minutes; accepted links default to 30 days. Never post a bearer credential or provider OAuth URL into Slack. ## Gateway protocol boundary diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index 512585f6a..ddfa59b1b 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -25,7 +25,7 @@ endpoints: `enabled` defaults to `false`. `acknowledgementTimeoutMs` defaults to `10000` and accepts integers from `100` through `60000`; it bounds the worker admission acknowledgement, not total model execution time. Existing Remote Agents permissions, Agent access, terms acceptance, content checks, and provider/tool policies still apply. -Background submission requires an **Agent API key**, including when ordinary inference also accepts OIDC. A management API machine token is not an execution credential. Configure [Remote Agents permissions](/docs/features/agents_api#enabling-the-agents-api) separately. +Background submission requires an **Agent API key**, including when ordinary inference also accepts OIDC. A management API machine token is not an execution credential. Configure [Remote Agents permissions](/docs/features/agents_api#setup) separately. Human tool approval and Ask User pauses require durable MongoDB checkpoint storage. Use the existing [`toolApproval`](/docs/configuration/librechat_yaml/object_structure/agents#toolapproval), Ask User, and [`checkpointer`](/docs/configuration/librechat_yaml/object_structure/agents#checkpointer) settings; background execution does not automatically enable approval or bypass a deny rule. A memory checkpointer does not provide durable background human-action resume. Ordinary requests without a human pause retain their normal execution path. @@ -52,6 +52,10 @@ curl https://chat.example.com/api/agents/v1/responses/RESPONSE_ID \ Poll the same response until its public status is `completed`, `failed`, `incomplete`, or `cancelled`. `queued` and `in_progress` are not terminal. The server rechecks the original source key and current authority; possession of a response ID is not permission to read or resume it. Use the returned response ID as `previous_response_id` for a subsequent supported continuation rather than resending the original user input. +A background answer becomes terminal only after the provider has drained and its conversation history is committed with the response. A temporary storage outage keeps the selected outcome pending for recovery without running the provider again. During a rolling upgrade or rollback, keep a compatible worker available to finish pending results; an older worker cannot complete the newer history-bearing receipt format. + +Ordinary synchronous and streaming requests have a different storage contract: if optional saving fails, the generated answer can still succeed with `store: false`. Check that returned value before relying on retrieval or continuation. + ## Review a required action A public response can include: @@ -89,7 +93,7 @@ A successful decision returns HTTP `202` with `responseId`, `actionId`, `intentI MCP OAuth prompts are retained for owner-only replay until their deadline. Complete authorization through the supplied provider flow; do not submit an approval decision to replace an OAuth callback. A successful callback can continue the same waiting execution while its waiter is still active. -Durable prompt visibility is not a guarantee that an in-memory OAuth waiter survives a server restart. Durable human question/tool-approval checkpoints and OAuth authorization waiters are different mechanisms. If exact execution state is missing or mismatched, the response reports nonterminal `recovery: "execution_state_unavailable"` and removes stale actionable prompts. This is not proof of completion or cancellation and does not replay work. Sign-in credentials may have been saved even though the original run did not continue. Check external results before retrying; an administrator must reconcile a persistently unknown execution before the held run can safely be cleared. Do not replay an old authorization URL or infer that sign-in restarted the model. See [MCP authentication](/docs/features/mcp#oauth-authentication). +Durable prompt visibility is not a guarantee that an in-memory OAuth waiter survives a server restart. Durable human question/tool-approval checkpoints and OAuth authorization waiters are different mechanisms. If exact execution state is missing or mismatched, the response reports nonterminal `recovery: "execution_state_unavailable"` and removes stale actionable prompts. This is not proof of completion or cancellation and does not replay work. Sign-in credentials may have been saved even though the original run did not continue. Check external results before retrying; an administrator must reconcile a persistently unknown execution before the held run can safely be cleared. Do not replay an old authorization URL or infer that sign-in restarted the model. See [MCP authentication](/docs/features/mcp#sign-in-with-oauth). ## Stop and recovery From dfca2c008d367c8046429419c54b3256674317ba Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Sat, 31 Oct 2026 00:19:10 +0100 Subject: [PATCH 08/38] =?UTF-8?q?=F0=9F=93=9A=20docs:=20Include=20Channel?= =?UTF-8?q?=20Guides=20in=20Localized=20Navigation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/docs/features/meta.de.json | 2 ++ content/docs/features/meta.es.json | 2 ++ content/docs/features/meta.fr.json | 2 ++ content/docs/features/meta.id.json | 2 ++ content/docs/features/meta.it.json | 2 ++ content/docs/features/meta.ja.json | 2 ++ content/docs/features/meta.ko.json | 2 ++ content/docs/features/meta.nl.json | 2 ++ content/docs/features/meta.pl.json | 2 ++ content/docs/features/meta.pt-BR.json | 2 ++ content/docs/features/meta.tr.json | 2 ++ content/docs/features/meta.vi.json | 2 ++ content/docs/features/meta.zh.json | 2 ++ 13 files changed, 26 insertions(+) diff --git a/content/docs/features/meta.de.json b/content/docs/features/meta.de.json index f5ae5b04c..c721c1cbc 100644 --- a/content/docs/features/meta.de.json +++ b/content/docs/features/meta.de.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.es.json b/content/docs/features/meta.es.json index 0eeed4a73..3e7c2bc54 100644 --- a/content/docs/features/meta.es.json +++ b/content/docs/features/meta.es.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.fr.json b/content/docs/features/meta.fr.json index a5293817a..f9c55539a 100644 --- a/content/docs/features/meta.fr.json +++ b/content/docs/features/meta.fr.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.id.json b/content/docs/features/meta.id.json index b06ad51a7..0feb398a9 100644 --- a/content/docs/features/meta.id.json +++ b/content/docs/features/meta.id.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.it.json b/content/docs/features/meta.it.json index 1e6ccf7ac..d1b66fec1 100644 --- a/content/docs/features/meta.it.json +++ b/content/docs/features/meta.it.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.ja.json b/content/docs/features/meta.ja.json index d029e41fb..140509deb 100644 --- a/content/docs/features/meta.ja.json +++ b/content/docs/features/meta.ja.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.ko.json b/content/docs/features/meta.ko.json index c22242753..b1966d1dc 100644 --- a/content/docs/features/meta.ko.json +++ b/content/docs/features/meta.ko.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.nl.json b/content/docs/features/meta.nl.json index 5f9343787..a520d382a 100644 --- a/content/docs/features/meta.nl.json +++ b/content/docs/features/meta.nl.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.pl.json b/content/docs/features/meta.pl.json index d4c62d1a6..bcc344623 100644 --- a/content/docs/features/meta.pl.json +++ b/content/docs/features/meta.pl.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.pt-BR.json b/content/docs/features/meta.pt-BR.json index 3655d7896..766869701 100644 --- a/content/docs/features/meta.pt-BR.json +++ b/content/docs/features/meta.pt-BR.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.tr.json b/content/docs/features/meta.tr.json index a671ba18e..4ec97414b 100644 --- a/content/docs/features/meta.tr.json +++ b/content/docs/features/meta.tr.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.vi.json b/content/docs/features/meta.vi.json index 134efb300..9c704be71 100644 --- a/content/docs/features/meta.vi.json +++ b/content/docs/features/meta.vi.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", diff --git a/content/docs/features/meta.zh.json b/content/docs/features/meta.zh.json index df6d457e9..8814dee95 100644 --- a/content/docs/features/meta.zh.json +++ b/content/docs/features/meta.zh.json @@ -10,6 +10,8 @@ "agent_plugins", "subagents", "agents_api", + "background_responses", + "agent_channels", "artifacts", "code_interpreter", "pull_requests", From af5448ed35563f8af2f69f1318738c4961673d83 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Sat, 31 Oct 2026 03:04:55 +0100 Subject: [PATCH 09/38] =?UTF-8?q?=F0=9F=93=9A=20docs:=20Clarify=20Channel?= =?UTF-8?q?=20Artifact=20Budgets=20And=20Provenance?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../configuration/librechat_yaml/object_structure/agents.mdx | 5 ++++- content/docs/features/agent_channels.mdx | 4 +++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index b3f035f46..0940b73eb 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1512,7 +1512,10 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels | `responseCredentialLifetimeMs` | `86400000` | Bound execution credential lifetime, `60000`–`604800000` ms | | `artifactMaxBytes` | `10485760` | Per-artifact limit, `1`–`52428800` bytes | | `artifactMaxFiles` | `5` | Artifacts per run, `1`–`20` | -| `artifactReadTimeoutMs` | `30000` | Read timeout, `1000`–`60000` ms | +| `artifactReadTimeoutMs` | `30000` | Shared artifact-operation budget, `1000`–`60000` ms; not a separate timeout for each file | +| `artifactAnswerFileThresholdBytes` | `6000` | Create new plain-text answer files only above this UTF-8 byte length, `0`–`52428800`; fenced answers also qualify | + +The artifact budget covers catalog queries, storage acquisition/consumption and final authorization. Limits resolution is capped at the schema maximum of 60 seconds; once resolved, its elapsed time counts toward the configured budget. Expiry omits artifacts rather than returning files without current authorization. The threshold applies to new answer-file projections; existing saved descriptors remain bound to their bytes and require current owner, tenant, retention and maximum-size checks. `cleanup` accepts `batchSize` (`25`, range `1`–`100`), `intervalMs` (`1000`, range `1000`–`60000`), and `maxIdleIntervalMs` (`30000`, range `1000`–`300000`). diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 6d4bd87c8..a68def448 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -184,7 +184,9 @@ The gateway uses private Slack controls for supported questions and individual t A saved decision whose queue publication failed remains retryable with the exact immutable decision; it cannot be replaced by a different answer. Keep Stop available while work remains active and update public progress only through the fenced delivery protocol. -Artifacts are scoped to the authorized run and actor. Limits default to five files and 10 MiB per file, with a 30-second read timeout. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. +Artifacts are scoped to the authorized run and actor. User-submitted rows do not count as server-generated provenance for artifacts or trace links. Limits default to five files and 10 MiB per file. One `artifactReadTimeoutMs` budget (30 seconds by default) covers catalog queries, storage reads and final authorization rather than restarting for every file. Limits resolution is separately capped at 60 seconds, and its elapsed time counts against the selected budget once available. An expired budget omits artifacts while retaining the answer for authorized text delivery. + +New plain-text answer files require more than `artifactAnswerFileThresholdBytes` UTF-8 bytes (6,000 by default); fenced answers also qualify. This threshold controls new projections, while saved descriptors retain their content identity and still require current authorization, retention and maximum-size checks. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. Reaction feedback maps only to confirmed delivered assistant messages. It does not overwrite the browser's feedback field. Export is constrained by recorded sampling/destination provenance and current export policy. Temporary-chat provenance is retained; an old mapping without that provenance is not treated as a permanent chat. A policy change can suppress export even when the original trace was sampled. From 9966a92cef144aff5fec7e1397026345c98cca6c Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 3 Nov 2026 14:08:30 -0800 Subject: [PATCH 10/38] docs: consolidate transactional channel gateway setup --- .../object_structure/agents.mdx | 8 +- content/docs/features/agent_channels.mdx | 166 +++++++++++++++--- .../docs/features/background_responses.mdx | 2 + 3 files changed, 154 insertions(+), 22 deletions(-) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 0940b73eb..6c8c4a5db 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1504,8 +1504,12 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels | Option | Default | Accepted values / purpose | | --- | --- | --- | | `enabled` | `false` | Enable channel setup and service routes | -| `transport` | `socket_mode` | `socket_mode` or `webhook`; integration metadata, not a receiver deployment | +| `transport` | `socket_mode` | Select `socket_mode` or `webhook` ingress and the generated manifest; the gateway runs separately | | `gatewayUrl` | Omitted | Required HTTPS base URL for generating webhook callback URLs; not needed for Socket Mode | +| `nativeSessions` | `false` | Enable optional Slack native Agent status emission after app setup | +| `lifecycleReactions` | `false` | Add optional processing/completion reactions | +| `signatureToleranceSeconds` | `300` | Webhook signature timestamp window; integer from 1 to 300 seconds | +| `socketReconnectDelayMs` | `5000` | Socket reconnect delay; integer from 100 to 60000 milliseconds | | `ticketLifetimeMs` | `600000` | Link ticket lifetime, `60000`–`3600000` ms | | `linkLifetimeMs` | `2592000000` | Accepted link lifetime, `60000`–`7776000000` ms | | `leaseMs` | `60000` | Run lease, `10000`–`300000` ms | @@ -1523,7 +1527,7 @@ The artifact budget covers catalog queries, storage acquisition/consumption and The gateway service boundary requires the server-side `CHANNEL_SERVICE_TOKEN`. Do not expose it to browsers or use it as a general Agent execution credential. Channel credential mode (`shared` or `per_user`) belongs to the channel record, not this deployment block. Both modes require explicit current actor linking; `shared` restricts linking to the channel creator's account rather than granting all external participants that account's privileges. -Set the gateway process's `SLACK_TRANSPORT` explicitly to match `transport`. The gateway environment defaults to `webhook`, while this manifest setting defaults to `socket_mode`. Gateway runtime settings, including its tenant/connection IDs, app-level Socket Mode token, native Slack session option, and optional `APP_TITLE` label, are documented in [Run the Slack gateway](/docs/features/agent_channels#run-the-slack-gateway). +The gateway reads this versioned policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is optional and asserts the selected mode; a mismatch or unsupported policy prevents startup. Native sessions, lifecycle reactions and signature policy are configured here rather than through gateway process flags. Gateway runtime settings, including its tenant/connection IDs, app-level Socket Mode token and optional `APP_TITLE` label, are documented in [Run the Slack gateway](/docs/features/agent_channels#run-the-slack-gateway). ## remoteApi diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index a68def448..6ce24fd11 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -21,11 +21,21 @@ endpoints: channels: enabled: true transport: socket_mode + nativeSessions: false + lifecycleReactions: false + signatureToleranceSeconds: 300 + socketReconnectDelayMs: 5000 ``` Both enablement settings default to `false`. Users need both Agent use and Remote Agents use permissions. Channel setup also requires Agent sharing permission or existing administrator management access; sharing access does not require permission to edit the Agent. Configure `DOMAIN_CLIENT` for trusted owner-review and account-link URLs. Configure a strong `CHANNEL_SERVICE_TOKEN` for the gateway-to-LibreChat service boundary; keep it server-side and distribute it only to a trusted integration process over a secure channel. It is not a browser token or a general Agent API key. -The `transport` option accepts `socket_mode` (default) or `webhook`. This selects the generated Slack manifest; it does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. Set the gateway's `SLACK_TRANSPORT` explicitly to match this setting: the gateway process defaults to `webhook`, not `socket_mode`. +The `transport` option accepts `socket_mode` (default) or `webhook`. This selects the generated Slack manifest; it does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. The gateway loads this policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is an optional deployment assertion; if supplied, it must match the server-selected mode. Missing or unsupported gateway policy prevents startup. + +### Database requirement + +Durable Channels and stored background Responses require MongoDB transactions. Use a MongoDB replica set or another verified transaction-capable deployment. Standalone MongoDB and FerretDB 2.7 can run ordinary LibreChat, but cannot enable this durable feature. Unsupported channel writes return `transactions_unavailable`; the Agent builder explains the setup requirement. Transactional reads use the primary even when the connection normally prefers secondary reads. + +API-key authentication must remain enabled for the gateway's bound execution credential. Linking does not grant Remote Agents permissions, Agent access, new tools or offline access to connected services. See the [channel configuration reference](/docs/configuration/librechat_yaml/object_structure/agents#channels) for limits and defaults. @@ -47,16 +57,19 @@ From a LibreChat source checkout containing `packages/channel-gateway`: ```sh npm ci +npm run build:packages npm run build --workspace @librechat/channel-gateway node --env-file=/secure/channel-gateway.env packages/channel-gateway/dist/main.cjs ``` +`npm run backend:dev` starts only LibreChat; it does not start the gateway. Build the application using LibreChat's normal development setup and run the gateway separately. If you reuse the application's `.env`, set the gateway port explicitly: `PORT=8080 node --env-file=.env packages/channel-gateway/dist/main.cjs`. This avoids binding the gateway to the application's port. + Supply the environment file through your normal secret-management process. Do not commit it. A Socket Mode configuration is: ```dotenv filename="channel-gateway.env" LIBRECHAT_INTERNAL_URL=http://127.0.0.1:3080 CHANNEL_SERVICE_TOKEN= -CHANNEL_TENANT_ID= +CHANNEL_TENANT_ID=_ CHANNEL_ID= SLACK_TRANSPORT=socket_mode SLACK_APP_TOKEN= @@ -77,27 +90,56 @@ The webhook receiver verifies Slack signatures using the connection's signing se ### Docker Compose -The source also includes an optional `docker-compose.channels.yml` overlay. It builds the standalone gateway from the repository root using `packages/channel-gateway/Dockerfile`; it does not pull a published gateway image or add the gateway to the default stack. +The optional `docker-compose.channels.yml` overlay builds both LibreChat and the standalone gateway from the source checkout. The separate `docker-compose.mongo-replica.yml` overlay initializes a single local MongoDB replica member and waits for a writable primary before the application starts. The gateway waits for application health, then authenticates its channel binding and selected Slack transport. Neither service is added to the default stack automatically. -With a compatible LibreChat `api` service already running in the same Compose project, run this from the LibreChat repository root: +For a **fresh local database**, run these commands from the LibreChat repository root: -```sh -docker compose --env-file .env --env-file /secure/channel-gateway.env \ - -f docker-compose.yml -f docker-compose.channels.yml \ - --profile channels up -d --build channel-gateway -``` +1. Prepare `.env` and `librechat.yaml` using the normal LibreChat setup and the channel policy above. Generate a private service token with `openssl rand -hex 32` and set `CHANNEL_SERVICE_TOKEN` in `.env`. Keep the same Compose files and project name on subsequent commands. +2. Start the source-built application and its dependencies: + + ```sh + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml up -d --build api meilisearch + ``` + +3. Sign in, save an Agent, and [set up its Slack channel](#set-up-a-channel). Enter the bot token in the Agent builder. Set `CHANNEL_ID` in `.env` to the resulting connection ID. `CHANNEL_TENANT_ID` defaults to `_` for an ordinary OSS installation; supply the actual tenant ID for a tenant-scoped installation. For Socket Mode, also set `SLACK_APP_TOKEN` to the matching app-level token with `connections:write`. +4. Start the gateway: + + ```sh + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml --profile channels up -d --build channel-gateway + ``` + +5. Check readiness and startup errors: + + ```sh + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml --profile channels ps -a + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml --profile channels logs --tail=100 api mongodb-init channel-gateway + ``` -The second environment file supplies the connection and Socket Mode values from the example above. Keep the same `CHANNEL_SERVICE_TOKEN` in LibreChat's own `.env`; Compose variable substitution does not update the `.env` mounted into the API container. Use the same Compose project name and any existing deployment overrides as your running stack. +`mongodb-init` exiting with status 0 is expected. The application and gateway should be running and healthy. A successful Slack credential activation does not prove the gateway is connected: check health and perform a real mention. Missing service/app bindings prevent gateway startup. -The overlay defaults to Socket Mode and points `LIBRECHAT_INTERNAL_URL` at `http://api:${PORT:-3080}` on the Compose network. It does not use the example's host-loopback URL. The gateway itself listens on container port `8080`, with no published host ports. Socket Mode needs no inbound port; for webhooks, configure your HTTPS reverse proxy to reach `channel-gateway:8080` on that network and forward only the Slack callback paths. +The overlay points `LIBRECHAT_INTERNAL_URL` at `http://api:${PORT:-3080}` on the Compose network. The gateway listens on container port `8080`, with no published host ports. Socket Mode needs no inbound port; webhooks need an HTTPS reverse proxy forwarding the required callback paths to `channel-gateway:8080`. The gateway runs as a non-root user with a read-only filesystem and dropped capabilities. -The Compose service runs as a non-root user with a read-only filesystem, dropped capabilities, and a health check. To build just the image, the build context must still be the repository root: +For an existing external transaction-capable database, omit the local MongoDB replica overlay and provide the application connection through your normal Compose override. The base Compose file sets the API service's `MONGO_URI`, so changing only `.env` does not replace that service environment entry. Never run the local initializer against an external database. + +A separate gateway environment file can be supplied through `--env-file .env --env-file /secure/channel-gateway.env`. Keep `CHANNEL_SERVICE_TOKEN` identical in LibreChat's own `.env`; Compose substitution does not update the file mounted into the application. + +To build only the gateway image, use the repository root as its build context: ```sh docker build -f packages/channel-gateway/Dockerfile \ -t librechat-channel-gateway:local . ``` +#### Existing local data + +Back up the database, stop LibreChat and every gateway/worker that writes to it, then stop the database before applying the replica overlay. Retain the existing `data-node` directory; do not delete it or remove its volume. Start with that same data directory and the overlays above. Initialization preserves existing documents and only initializes an unconfigured local `rs0` member at `mongodb:27017`. It refuses a different replica configuration rather than silently reconfiguring it. Verify existing users/history before enabling the gateway, and retain the overlay on future restarts. + +A single local replica member enables transactions but does not provide high availability. The overlay follows the base development Compose authentication/network settings; it is not a production replica-set recipe. For authenticated, multi-member or production deployments, use the [MongoDB conversion procedure](https://www.mongodb.com/docs/manual/tutorial/convert-standalone-to-replica-set/) and your deployment's backup/security practices. + ### Gateway settings | Environment variable | Default | Purpose | @@ -108,26 +150,75 @@ docker build -f packages/channel-gateway/Dockerfile \ | `CHANNEL_SERVICE_TOKEN` | Required | Shared server-side service-boundary token | | `CHANNEL_TENANT_ID` | Required | Exact connection tenant; `_` for single-tenant deployments | | `CHANNEL_ID` | Required | Connection ID, not the Slack channel ID or Agent ID | -| `SLACK_TRANSPORT` | `webhook` | `webhook` or `socket_mode`; match LibreChat's manifest setting | +| `SLACK_TRANSPORT` | Server policy | Optional assertion: `webhook` or `socket_mode`; must match the server policy | | `SLACK_APP_TOKEN` | Required for Socket Mode | App-level token for the same Slack app | -| `SLACK_NATIVE_SESSIONS` | `false` | Use Slack's native Agent loading, status, and Stop UI after app setup below | -| `SLACK_LIFECYCLE_REACTIONS` | `false` | Add processing/completion reactions to the sender's message | | `APP_TITLE` | `LibreChat` | Application name in browser-review button labels, such as “Open in LibreChat” | | `API_CALL_TIMEOUT_MS` | `10000` | Timeout for individual service and Slack API calls | | `AGENT_INVOKE_TIMEOUT_MS` | `120000` | Timeout for initial background Response submission, not the full Agent run | -| `SLACK_SIGNATURE_TOLERANCE_SECS` | `300` | Maximum webhook signature timestamp age/skew | -`SLACK_API_BASE_URL` defaults to `https://slack.com/api/`; leave it unchanged outside controlled tests. Existing `SLACK_SOCKET_TENANT_ID` and `SLACK_SOCKET_CHANNEL_ID` aliases remain accepted, but conflicting old and new values are rejected. Actor-bound durable execution cannot be disabled. +`SLACK_API_BASE_URL` defaults to `https://slack.com/api/`; leave it unchanged outside controlled tests. Ingress mode, native sessions, lifecycle reactions, signature tolerance and reconnect pacing come from `endpoints.agents.channels` in `librechat.yaml`, not process feature flags. Actor-bound durable execution cannot be disabled. -The process exposes `/readyz` for liveness, `/healthz` for startup/Socket Mode readiness, and `/metrics` for Prometheus metrics. A successful connection activation confirms Slack credentials, not that a gateway is running or connected. Check gateway health and perform a real mention before treating setup as complete. +The process exposes `/livez` for HTTP-process liveness, `/readyz` and `/healthz` for actual startup/transport readiness, and `/metrics` for Prometheus metrics. An observed ingress-mode or Socket app-binding mismatch makes the gateway unready. Restart gateway replicas after changing ingress mode or Socket app identity. A successful connection activation confirms Slack credentials, not that a gateway is running or connected. Check gateway health and perform a real mention before treating setup as complete. ### Native Agent UI and final replies By default, a stable working message provides Stop and, when needed, Review controls. Answers are posted after generation, rather than repeatedly replacing a growing reply. Formatting includes code, tables, links, file attachments, and qualified cost/time details; unavailable costs are not estimated. -To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope and `agent_session_stopped` event subscription, and reinstall the app. These are additional to the basic generated manifest. Then set `SLACK_NATIVE_SESSIONS=true` and restart the gateway. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. +To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope and `agent_session_stopped` event subscription, and reinstall the app. These are additional to the basic generated manifest. Then set `endpoints.agents.channels.nativeSessions: true` in `librechat.yaml`. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. + +Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already present in the basic manifest. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. + +## Rich Agent messages + +An Agent can return semantic presentation data in its final answer. The gateway validates the document and converts it deterministically to Slack Block Kit; it does not accept arbitrary Slack JSON, callback IDs, approval controls, file identifiers or modal definitions. Ordinary Markdown remains unchanged. This works in both ordinary threads and native Agent sessions, without a new OAuth scope or a configuration migration. + +To enable this behavior for an Agent, add the following to its instructions using the existing Agent editor (or include it in a request when testing): + +> When a chart, table, image or card would help, write a short readable answer followed by exactly one final, top-level fenced code block named `librechat-presentation`. Its JSON must be `{ "version": 1, "blocks": [...] }`. Use only the semantic components described below; never emit raw Slack blocks or interactive callback IDs. Use ordinary Markdown for other answers. Use public HTTPS URLs for images and links. The gateway generates complete text fallbacks from the data, so do not repeat every value in the introductory answer. -Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions are separate from native sessions and require the reaction permissions already present in the basic manifest. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. +For example, ask the Agent to compare the following measured results and show both a chart and a table. Its final answer can be: + +````text +Latency fell from 20 ms to 17 ms. + +```librechat-presentation +{ + "version": 1, + "blocks": [ + { + "type": "chart", + "title": "Latency", + "chart": { + "type": "line", + "axis_config": { "categories": ["Mon", "Tue"], "y_label": "ms" }, + "series": [{ "name": "p95", "data": [{ "label": "Mon", "value": 20 }, { "label": "Tue", "value": 17 }] }] + } + }, + { "type": "table", "title": "Measurements", "columns": ["Day", "p95 (ms)"], "rows": [["Mon", 20], ["Tue", 17]] } + ] +} +``` +```` + +| Semantic component | Fields and constraints | +| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `text`, `header`, `context`, `code` | `text` string; maximum 3000, 150, 2000 and 3000 Unicode characters respectively. Text components use literal text, so mentions cannot grant interaction authority. Use ordinary Markdown outside the document for formatted prose. | +| `divider` | No additional fields. | +| `image` | `url`, `alt`, optional `title` (150 characters). HTTPS URLs only; alt text is required (2000 characters). The gateway never fetches remote media. | +| `card` | Required `title` (150), optional `subtitle` (150), `body` (200), `image: {url, alt}`, and up to three `links: [{label, url}]`. Labels are at most 75 characters. Links navigate only; they cannot run an Agent action. | +| `carousel` | `cards`: 1–10 cards. | +| `table` | `title` (150), `columns`: 1–20 labels (150 each), `rows`: 1–200 rectangular rows of strings or finite numbers. Maximum 20,000 characters across cells including headers. Numeric cells retain numeric sorting. | +| `chart` | `title` (50), `chart` as described below. | +| `container` | `title` (150), `blocks`: 1–10 text, header, context, code, divider or image components. | +| `layout` | `title` (150), `rows`: 1–5 arrays of 1–3 components, including containers. Charts, tables and carousels each occupy their own row. Layouts cannot nest. The gateway makes the title visible and generates explicit compatibility fallback blocks. | + +Charts support `line`, `bar` and `area` with `axis_config: {categories, x_label?, y_label?}` and `series: [{name, data: [{label, value}]}]`. Categories have 1–20 distinct labels; each series must have exactly one point per category. Series names are distinct; at most 12 series are allowed. Names and labels are at most 20 characters, axis titles 50. Values must be finite; negative values are supported. Pie charts instead use `chart: {type: "pie", segments: [{label, value}]}` with 1–12 distinct labels and positive finite values. + +A document has at most 40 components and the final answer must fit the 128,000-byte presentation parsing boundary. Malformed, incomplete, quoted, ambiguous or unrecognized documents stay on the ordinary text path. The gateway isolates components into messages, counts nested blocks, enforces two charts and 20,000 table characters per message, and preserves every value and link in generated text. Components which exceed Slack's nested block or serialized payload limits become text. The server's existing `maxDeliveryParts` policy still applies, with an explicit shortening notice when needed. + +The gateway freezes versioned blocks and text together before posting. Retries replay that plan. A definitive Slack `invalid_blocks` or `invalid_attachments` rejection permits a text-only retry; ambiguous network outcomes retain the existing reconciliation behavior. Clients that cannot render layouts receive the generated stable fallback blocks. + +This is rich **message** support. Existing app-owned Stop, approval, question and feedback workflows remain responsible for interactions. New input forms, App Home, modals, Work Objects, plan/task execution controls and embedded video are not exposed to Agent output. Authorized file attachments continue through the existing artifact delivery path. Slack may limit newer blocks by client or app availability; automated tests cover SDK payloads and rejection fallback, while live rendering requires a configured Slack workspace. ## Identity and permissions @@ -147,6 +238,39 @@ Manage and revoke your links in Account settings. A link can become unavailable Browser endpoints under `/api/channels/links` support preview, acceptance, listing, and revocation. Mutations require the normal authenticated browser and same-origin checks. Ticket lifetime defaults to 10 minutes; accepted links default to 30 days. Never post a bearer credential or provider OAuth URL into Slack. +## Delivery recovery + +The gateway preserves each frozen delivery operation and its receipt. A required operation whose provider result is unknown holds its actor lane: retrying blindly could post the same answer twice. Stopping a worker or requesting cancellation does not prove whether Slack accepted an earlier request. + +### Reconcile a verified provider result + +1. Pause gateway processing for the affected channel while investigating. Keep the channel enabled and preserve its actor link and source authority; disabling these is not a recovery bypass. +2. Inspect the frozen run plan and retained receipt. Verify in the provider that the exact operation reached the intended channel or thread. Record its message key or file ID, matching the retained attempt and any upload checkpoint. If the result cannot be verified, leave the receipt unknown and the lane held. +3. After the old lease expires, use `POST /api/channels/service/:channelId/runs/claim` with `{ "owner": "" }`, normal private service authentication and tenant binding. Verify that the returned run ID is the run being investigated; claims select eligible work and do not take a target run ID. Use the returned current fence, renewing it through `POST /renew` as needed. An expired or replaced worker's fence cannot reconcile the run. +4. Submit the confirmed receipt through the private channel API. These endpoints confirm existing attempts; they do not send messages, replace the frozen plan, reset attempts or accept a retryable outcome. + +All paths below are relative to `/api/channels/service/:channelId/runs/:runId`. Send the channel service bearer token and the configured tenant header, using the same internal service URL as the gateway. Preserve the complete fence returned by the claim. + +For a delivery operation, `POST /delivery/reconcile`: + +```json +{ + "fence": { "runId": "", "owner": "", "epoch": 1 }, + "receipt": { + "operationId": "", + "outcome": "confirmed", + "attempts": 1, + "externalMessageKey": ":" + } +} +``` + +Replace every illustrative value with the actual current fence and retained attempt count; do not assume the example epoch is current. Supply `externalFileId` for a verified file operation as required by its frozen operation and checkpoint. Existing provider identities are immutable; reconciliation cannot replace them with a different message or file. + +For a progress update, `POST /progress/reconcile` with the current `fence`, the retained progress `revision`, and a `receipt` containing `outcome: "confirmed"`, the retained `attempts` and verified `externalMessageKey`. The message identity remains fixed across progress revisions. + +Once every required delivery operation is confirmed, `POST /commit` with the current `fence` to complete delivery and release the actor lane. Resume normal gateway processing afterward. If any required result remains uncertain, keep the run held rather than resending or recreating it. Optional exhausted effects follow the gateway's bounded recovery policy and do not justify replaying a required answer. + ## Gateway protocol boundary Service requests use `Authorization: Bearer ` and the exact tenant/channel context. For routes without a tenant path parameter, send the channel's exact tenant in `x-tenant-id`; do not choose a tenant from untrusted message text. The service token permits this integration boundary, not arbitrary user impersonation. Never put it in client-side code, Slack messages, tracing payloads, or public logs. The credential bundle endpoint returns secrets to the trusted gateway and must not be exposed as a public discovery API. @@ -194,4 +318,6 @@ Reaction feedback maps only to confirmed delivered assistant messages. It does n Disabling a channel or changing its credential mode retires old authority; it does not undo external tool effects. Stop can remain pending until the exact provider is drained and canonical cancellation/cleanup completes. A gateway must poll/reconcile canonical state rather than interpreting an acknowledgement as terminal completion. +With the process-local job store, restarting the API while a tool approval is pending makes the review unavailable. The request stays held for reconciliation and a stale approval does not execute the tool. Durable checkpoint storage alone does not recreate the missing live execution state. Completed history and subsequent thread continuation survive restart. + The gateway package is built from the LibreChat source tree; it is not published as an npm package. This integration does not promise arbitrary chat-platform support, automatic migration of legacy thread-wide identity, or restart-survival of an in-memory OAuth waiter. A restart can require a new browser sign-in; uncertain continuation must not be reported as completed or retried as new work. Legacy thread read/write bookkeeping is not a substitute for actor-scoped runs. diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index ddfa59b1b..f7306615c 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -25,6 +25,8 @@ endpoints: `enabled` defaults to `false`. `acknowledgementTimeoutMs` defaults to `10000` and accepts integers from `100` through `60000`; it bounds the worker admission acknowledgement, not total model execution time. Existing Remote Agents permissions, Agent access, terms acceptance, content checks, and provider/tool policies still apply. +Stored background Responses require a MongoDB replica set or another verified transaction-capable database. Standalone MongoDB and FerretDB 2.7 do not support this durable feature; ordinary LibreChat remains available. See the [local replica setup](/docs/features/agent_channels#docker-compose). + Background submission requires an **Agent API key**, including when ordinary inference also accepts OIDC. A management API machine token is not an execution credential. Configure [Remote Agents permissions](/docs/features/agents_api#setup) separately. Human tool approval and Ask User pauses require durable MongoDB checkpoint storage. Use the existing [`toolApproval`](/docs/configuration/librechat_yaml/object_structure/agents#toolapproval), Ask User, and [`checkpointer`](/docs/configuration/librechat_yaml/object_structure/agents#checkpointer) settings; background execution does not automatically enable approval or bypass a deny rule. A memory checkpointer does not provide durable background human-action resume. Ordinary requests without a human pause retain their normal execution path. From 76c622c0107030b98097127a9d3e0337695a96e7 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 3 Nov 2026 15:06:06 -0800 Subject: [PATCH 11/38] docs: explain release images and optional gateway Helm setup --- content/docs/features/agent_channels.mdx | 41 +++++++++++++++++++++--- 1 file changed, 36 insertions(+), 5 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 6ce24fd11..5d79e13ff 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -90,16 +90,16 @@ The webhook receiver verifies Slack signatures using the connection's signing se ### Docker Compose -The optional `docker-compose.channels.yml` overlay builds both LibreChat and the standalone gateway from the source checkout. The separate `docker-compose.mongo-replica.yml` overlay initializes a single local MongoDB replica member and waits for a writable primary before the application starts. The gateway waits for application health, then authenticates its channel binding and selected Slack transport. Neither service is added to the default stack automatically. +The optional `docker-compose.channels.yml` overlay pulls release-matched LibreChat and gateway images. Set `LIBRECHAT_IMAGE_TAG` in `.env` to the release tag you are installing (including `-rcN` for a release candidate); both images use that same tag. If omitted, both use the latest stable release. Images are published for Linux AMD64 and ARM64 when the corresponding LibreChat release is published. A tag predating Agent Channels does not contain a gateway image. The separate `docker-compose.mongo-replica.yml` overlay initializes a single local MongoDB replica member and waits for a writable primary before the application starts. The gateway waits for application health, then authenticates its channel binding and selected Slack transport. Neither service is added to the default stack automatically. For a **fresh local database**, run these commands from the LibreChat repository root: -1. Prepare `.env` and `librechat.yaml` using the normal LibreChat setup and the channel policy above. Generate a private service token with `openssl rand -hex 32` and set `CHANNEL_SERVICE_TOKEN` in `.env`. Keep the same Compose files and project name on subsequent commands. -2. Start the source-built application and its dependencies: +1. Prepare `.env` and `librechat.yaml` using the normal LibreChat setup and the channel policy above. Set `LIBRECHAT_IMAGE_TAG` to the published LibreChat release containing Channels. Generate a private service token with `openssl rand -hex 32` and set `CHANNEL_SERVICE_TOKEN` in `.env`. Keep the same Compose files and project name on subsequent commands. +2. Pull and start the application and its dependencies: ```sh docker compose -f docker-compose.yml -f docker-compose.channels.yml \ - -f docker-compose.mongo-replica.yml up -d --build api meilisearch + -f docker-compose.mongo-replica.yml up -d --pull always api meilisearch ``` 3. Sign in, save an Agent, and [set up its Slack channel](#set-up-a-channel). Enter the bot token in the Agent builder. Set `CHANNEL_ID` in `.env` to the resulting connection ID. `CHANNEL_TENANT_ID` defaults to `_` for an ordinary OSS installation; supply the actual tenant ID for a tenant-scoped installation. For Socket Mode, also set `SLACK_APP_TOKEN` to the matching app-level token with `connections:write`. @@ -107,7 +107,7 @@ For a **fresh local database**, run these commands from the LibreChat repository ```sh docker compose -f docker-compose.yml -f docker-compose.channels.yml \ - -f docker-compose.mongo-replica.yml --profile channels up -d --build channel-gateway + -f docker-compose.mongo-replica.yml --profile channels up -d --pull always channel-gateway ``` 5. Check readiness and startup errors: @@ -127,6 +127,8 @@ For an existing external transaction-capable database, omit the local MongoDB re A separate gateway environment file can be supplied through `--env-file .env --env-file /secure/channel-gateway.env`. Keep `CHANNEL_SERVICE_TOKEN` identical in LibreChat's own `.env`; Compose substitution does not update the file mounted into the application. +For development or an unreleased checkout, add `-f docker-compose.channels-build.yml` immediately after `-f docker-compose.channels.yml` on **every** Compose command. This explicitly builds both services from the checkout instead of using release images. Use `up -d --build` instead of `up -d --pull always` on that path. The normal release path needs no local Node.js installation or image build. + To build only the gateway image, use the repository root as its build context: ```sh @@ -168,6 +170,35 @@ To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, a Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already present in the basic manifest. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. +## Kubernetes and Helm + +The LibreChat Helm chart can run one optional gateway for a configured connection. Start with the gateway disabled, configure the channel/background policy above in your existing `librechat.yaml`, then create and activate the connection in the Agent builder. Enable the gateway after obtaining its connection ID. + +Pin `image.tag` to a published LibreChat release containing Channels. The gateway image tag defaults to that same value (or the chart's application version when no image override is supplied). Earlier releases have no gateway image. A custom `channelGateway.image.tag` is available for deliberate image overrides. + +```yaml filename="channel-values.yaml" +image: + tag: +channelGateway: + enabled: true + channelId: + tenantId: "_" + # Defaults to global.librechat.existingSecretName. + existingSecretName: librechat-credentials-env +``` + +The existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching Socket Mode app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. + +The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure resources, node selectors, tolerations, affinity, image pull secrets and pod annotations through the chart values. This installs a single gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. + +For webhook transport, set the server policy to `webhook`, configure its public HTTPS gateway URL and set `channelGateway.slackAppTokenKey: ""`. Route the required Slack callback paths through your existing HTTPS ingress to `-librechat-channel-gateway:8080` (use the rendered Service name when overriding chart names). The chart creates a ClusterIP Service, not a public Ingress. Keep readiness, liveness and metrics private. Socket Mode needs no public ingress. + +The gateway runs without Kubernetes API credentials, as a non-root user with a read-only filesystem and dropped capabilities. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating its active connection and transport. + +**The chart does not configure or convert MongoDB topology.** Supply a transaction-capable database before enabling Channels. The default standalone database cannot run this feature. See the [Helm database configuration](/docs/local/helm_chart) for external database credentials. Normal LibreChat remains usable without enabling Channels. + +After applying the values through your normal Helm upgrade, check the gateway Deployment, pod events, logs and readiness. Missing Secret keys block pod startup; incorrect credentials or channel bindings prevent readiness. Finish with a real Slack mention and account linking rather than treating a successful Helm release as proof of integration. + ## Rich Agent messages An Agent can return semantic presentation data in its final answer. The gateway validates the document and converts it deterministically to Slack Block Kit; it does not accept arbitrary Slack JSON, callback IDs, approval controls, file identifiers or modal definitions. Ordinary Markdown remains unchanged. This works in both ordinary threads and native Agent sessions, without a new OAuth scope or a configuration migration. From c2674c2aee8e373b0398d30999df8d32b825bd4d Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 3 Nov 2026 15:42:47 -0800 Subject: [PATCH 12/38] docs: clarify gateway release selection and branding --- content/docs/features/agent_channels.mdx | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 5d79e13ff..a9ee6086e 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -172,9 +172,9 @@ Native sessions show processing or waiting-for-input status and return to active ## Kubernetes and Helm -The LibreChat Helm chart can run one optional gateway for a configured connection. Start with the gateway disabled, configure the channel/background policy above in your existing `librechat.yaml`, then create and activate the connection in the Agent builder. Enable the gateway after obtaining its connection ID. +The LibreChat Helm chart can run one optional gateway for a configured connection. First select a published LibreChat release containing Channels through `image.tag` and upgrade the application with the gateway disabled. Configure the channel/background policy above in your existing `librechat.yaml`, then create and activate the connection in the Agent builder. Enable the gateway after obtaining its connection ID. -Pin `image.tag` to a published LibreChat release containing Channels. The gateway image tag defaults to that same value (or the chart's application version when no image override is supplied). Earlier releases have no gateway image. A custom `channelGateway.image.tag` is available for deliberate image overrides. +Enabling the gateway requires an explicit `image.tag` selecting a published LibreChat release containing Channels; the chart refuses to silently use its older application-version default. The gateway image tag defaults to that same selected release. Earlier releases have no gateway image. A custom `channelGateway.image.tag` is available for deliberate image overrides. ```yaml filename="channel-values.yaml" image: @@ -187,6 +187,8 @@ channelGateway: existingSecretName: librechat-credentials-env ``` +For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly to the same application title when the API obtains `APP_TITLE` through a Secret or `global.librechat.env`. + The existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching Socket Mode app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure resources, node selectors, tolerations, affinity, image pull secrets and pod annotations through the chart values. This installs a single gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. From 684484c52c46bf87791d10a89c117a46540b99c2 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 3 Nov 2026 15:57:15 -0800 Subject: [PATCH 13/38] docs: describe shared gateway platform settings --- content/docs/features/agent_channels.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index a9ee6086e..72821e8ff 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -191,11 +191,11 @@ For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TIT The existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching Socket Mode app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. -The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure resources, node selectors, tolerations, affinity, image pull secrets and pod annotations through the chart values. This installs a single gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. +The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure gateway resources and annotations through `channelGateway`. Pod identity, `enableServiceLinks`, DNS, host aliases, image pull secrets, node selectors, tolerations and affinity follow the chart's shared platform settings. The configured ServiceAccount is reused while the gateway keeps its Kubernetes API token automount disabled. This installs a single gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. For webhook transport, set the server policy to `webhook`, configure its public HTTPS gateway URL and set `channelGateway.slackAppTokenKey: ""`. Route the required Slack callback paths through your existing HTTPS ingress to `-librechat-channel-gateway:8080` (use the rendered Service name when overriding chart names). The chart creates a ClusterIP Service, not a public Ingress. Keep readiness, liveness and metrics private. Socket Mode needs no public ingress. -The gateway runs without Kubernetes API credentials, as a non-root user with a read-only filesystem and dropped capabilities. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating its active connection and transport. +By default, the gateway runs without an automatically mounted Kubernetes API token, as a non-root user with a read-only filesystem and dropped capabilities. The chart's global pod/container security contexts are honored for platform-specific overrides. Gateway version labels follow its selected image tag. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating its active connection and transport. **The chart does not configure or convert MongoDB topology.** Supply a transaction-capable database before enabling Channels. The default standalone database cannot run this feature. See the [Helm database configuration](/docs/local/helm_chart) for external database credentials. Normal LibreChat remains usable without enabling Channels. From 3aed01f9ba84710b831e5a3a54114f266b1a06ac Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 3 Nov 2026 16:13:25 -0800 Subject: [PATCH 14/38] docs: explain gateway title validation and webhook ingress --- content/docs/features/agent_channels.mdx | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 72821e8ff..9ba71a4f1 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -187,13 +187,31 @@ channelGateway: existingSecretName: librechat-credentials-env ``` -For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly to the same application title when the API obtains `APP_TITLE` through a Secret or `global.librechat.env`. +For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly when the API obtains `APP_TITLE` through a Secret or `global.librechat.env`, or choose a shorter gateway title if the application name is not compatible. Gateway titles must be nonempty after trimming, at most 40 UTF-16 characters, and contain no `<`, `>`, `|` or control characters. Helm rejects incompatible inherited titles before deployment; the application can keep its existing longer name. The existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching Socket Mode app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure gateway resources and annotations through `channelGateway`. Pod identity, `enableServiceLinks`, DNS, host aliases, image pull secrets, node selectors, tolerations and affinity follow the chart's shared platform settings. The configured ServiceAccount is reused while the gateway keeps its Kubernetes API token automount disabled. This installs a single gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. -For webhook transport, set the server policy to `webhook`, configure its public HTTPS gateway URL and set `channelGateway.slackAppTokenKey: ""`. Route the required Slack callback paths through your existing HTTPS ingress to `-librechat-channel-gateway:8080` (use the rendered Service name when overriding chart names). The chart creates a ClusterIP Service, not a public Ingress. Keep readiness, liveness and metrics private. Socket Mode needs no public ingress. +For webhook transport, set the server policy to `webhook`, configure its public HTTPS gateway URL and clear `channelGateway.slackAppTokenKey`. Enable the dedicated gateway Ingress using your installed ingress controller and a trusted TLS certificate: + +```yaml filename="channel-values.yaml" +channelGateway: + slackAppTokenKey: "" + ingress: + enabled: true + host: gateway.example.com + # Empty inherits ingress.className; set this for a different controller. + className: nginx + annotations: {} + tls: + - hosts: [gateway.example.com] + secretName: gateway-tls +``` + +Combine these settings with the enabled gateway and explicit application release above. Set the server's `gatewayUrl` to `https://gateway.example.com`, with no path prefix. The new Ingress routes only `/slack/events` and `/slack/interactions` to the gateway Service on port 8080; its health and metrics routes remain private. It can share the application's hostname: the more specific Slack paths route to the gateway while the existing application Ingress keeps its own backend. Gateway annotations are separate so application rewrite rules cannot silently change callback paths. The gateway Ingress requires Kubernetes 1.19+. + +The chart does not install an ingress controller or issue a TLS certificate. Configure TLS through the example Secret, your normal certificate controller/annotations, or an existing HTTPS termination layer. Slack needs a publicly trusted HTTPS endpoint. If you manage a separate external Ingress or need a custom base-path rewrite, leave `channelGateway.ingress.enabled: false` and route the callback paths to the rendered gateway Service yourself; do not add them as paths on the main application Ingress, whose backend is LibreChat. Socket Mode needs no public ingress. By default, the gateway runs without an automatically mounted Kubernetes API token, as a non-root user with a read-only filesystem and dropped capabilities. The chart's global pod/container security contexts are honored for platform-specific overrides. Gateway version labels follow its selected image tag. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating its active connection and transport. From 8f18cad39985cf5df17825dee6495bd6ee6784e5 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Wed, 4 Nov 2026 14:00:45 -0800 Subject: [PATCH 15/38] docs: Explain Shared Slack Workspace Setup and Management --- .../object_structure/agents.mdx | 16 +++ content/docs/features/agent_channels.mdx | 103 ++++++++++++++++-- 2 files changed, 112 insertions(+), 7 deletions(-) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 6c8c4a5db..36af1fd5b 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1519,6 +1519,22 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels | `artifactReadTimeoutMs` | `30000` | Shared artifact-operation budget, `1000`–`60000` ms; not a separate timeout for each file | | `artifactAnswerFileThresholdBytes` | `6000` | Create new plain-text answer files only above this UTF-8 byte length, `0`–`52428800`; fenced answers also qualify | +`slackApp` configures the operator-owned app for organization workspace installations. Set `channels.enabled: true`, `transport: webhook` and `slackApp.enabled: true`; supply `appId`, `clientId`, `clientSecret` and `signingSecret`. Keep credentials server-side. The deployment opt-in `SLACK_WORKSPACES_ENABLED=true` supplies these settings from `SLACK_APP_ID`, `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET` and `SLACK_SIGNING_SECRET`, enables background Responses, and preserves other YAML settings. Nonempty environment app values take precedence; without the opt-in, YAML remains authoritative. `SLACK_GATEWAY_URL` supplies the public gateway URL. See [Organization workspaces](/docs/features/agent_channels#organization-workspaces) for deployment and UI steps. + +| `slackApp` option | Default | Purpose | +| --- | --- | --- | +| `enabled` | `false` | Enable browser-based workspace installation for the configured app | +| `appId`, `clientId`, `clientSecret`, `signingSecret` | Omitted | Required operator app identity and credentials | +| `flowLifetimeMs` | `600000` | Browser install lifetime, `60000`–`3600000` ms | +| `requestTimeoutMs` | `10000` | Slack installation/verification request deadline, `1000`–`30000` ms | +| `maxResponseBytes` | `65536` | Maximum Slack response bytes, `1024`–`262144` | +| `gateway.ingressConcurrency` | `32` | Concurrent shared ingress requests, `1`–`128` | +| `gateway.workerConcurrency` | `4` | Concurrent durable worker turns per process, `1`–`32` | +| `gateway.discoveryBatchSize` | `32` | Shared discovery page, `1`–`100`, also capped by `maxMetadataPageSize` | +| `gateway.pollIntervalMs` | `1000` | Discovery polling interval, `100`–`60000` ms | + +Workspace-bound Agent connections require personal identities. Shared gateway mode does not mean the manual owner-only `shared` credential mode; it shares transport and workers across installations, while every member retains their own execution identity. + The artifact budget covers catalog queries, storage acquisition/consumption and final authorization. Limits resolution is capped at the schema maximum of 60 seconds; once resolved, its elapsed time counts toward the configured budget. Expiry omits artifacts rather than returning files without current authorization. The threshold applies to new answer-file projections; existing saved descriptors remain bound to their bytes and require current owner, tenant, retention and maximum-size checks. `cleanup` accepts `batchSize` (`25`, range `1`–`100`), `intervalMs` (`1000`, range `1000`–`60000`), and `maxIdleIntervalMs` (`30000`, range `1000`–`300000`). diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 9ba71a4f1..076b3a3e9 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -12,6 +12,8 @@ Agent Channels connect external messaging events to [background Agent Responses] ## Configuration and prerequisites +Choose organization workspaces for one centrally configured Slack app and UI-managed workspace installations. The YAML example below is the manual single-connection setup; the shared-workspace deployment options also enable Channels and background Responses automatically. + ```yaml filename="endpoints / agents" endpoints: agents: @@ -39,7 +41,69 @@ API-key authentication must remain enabled for the gateway's bound execution cre See the [channel configuration reference](/docs/configuration/librechat_yaml/object_structure/agents#channels) for limits and defaults. -## Set up a channel +## Organization workspaces + +A deployment operator configures one Slack app once. Organization administrators then connect workspaces in LibreChat; members link their personal accounts in Slack. Installing an app does not give members access to an Agent or its tools. In a tenant-aware deployment, installations and routing belong to the active tenant. One app/workspace installation has one tenant owner; another tenant cannot claim an active installation. + +### One-time operator setup + +1. Create a Slack app, or use your deployment's existing app. Enable HTTP Events API delivery and interactivity, rather than Socket Mode. Configure these public HTTPS URLs: + + | Setting | URL | + | --- | --- | + | OAuth redirect | `https://chat.example.com/api/channels/workspaces/oauth/callback` | + | Events API | `https://slack.example.com/slack/events` | + | Interactivity | `https://slack.example.com/slack/interactions` | + + Use your configured `DOMAIN_SERVER`, including its application base path, for the OAuth URL. `DOMAIN_CLIENT` is the browser landing origin. The gateway callback URLs have no tenant or connection suffix. Expose only its Slack callback paths; keep gateway health and metrics private. +2. Request bot scopes `app_mentions:read`, `chat:write`, `reactions:read`, `reactions:write`, `files:write`, `im:write` and `im:history`. Subscribe to `app_mention`, `message.im`, `reaction_added`, `reaction_removed` and `agent_session_stopped`. Enable the app's messages tab. Keep token rotation and organization-wide installation disabled: this implementation accepts workspace bot grants, including individual workspaces in Enterprise Grid, and rejects rotating or organization-wide grants. +3. To install into other workspaces, complete Slack's [distribution setup](https://docs.slack.dev/app-management/distribution/). Slack workspace approval policies still apply. Store the app's ID, client ID, client secret and signing secret in the deployment's secret manager. Organization administrators never need these values or access to deployment environment variables. +4. Configure a transaction-capable database and a private `CHANNEL_SERVICE_TOKEN` shared by the API and gateway. Keep API-key authentication enabled for bound execution; retain normal Agent and Remote Agents permission controls. + +For Docker Compose, put the four app settings in the normal uncommitted `.env`: + +```dotenv +SLACK_APP_ID= +SLACK_CLIENT_ID= +SLACK_CLIENT_SECRET= +SLACK_SIGNING_SECRET= +SLACK_GATEWAY_URL=https://slack.example.com +CHANNEL_SERVICE_TOKEN= +DOMAIN_SERVER=https://chat.example.com +DOMAIN_CLIENT=https://chat.example.com +LIBRECHAT_IMAGE_TAG= +``` + +From a fresh LibreChat setup with `.env` and `librechat.yaml` prepared, start the release-matched application and shared gateway: + +```sh +docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.slack-workspaces.yml -f docker-compose.mongo-replica.yml \ + --profile channels up -d api meilisearch channel-gateway +``` + +The replica overlay is for a **fresh local database**; read [Existing local data](#existing-local-data) before converting an existing installation. Omit that overlay when you already use a verified transaction-capable external database and supply its normal connection configuration. Use the same Compose project and files for subsequent commands. This does not configure a public reverse proxy or a trusted certificate; route the two Slack paths to the gateway on port 8080 through your normal ingress. + +The shared overlay supplies `SLACK_WORKSPACES_ENABLED=true`, which enables webhook Channels, shared app installation and stored background Responses while retaining unrelated YAML policy, limits and explicit API authentication settings. Supplied nonempty app environment values override the corresponding app fields in YAML. With the flag unset or false, YAML continues to control the feature. Choosing shared setup changes the deployment's channel transport to webhook; existing bound connections must use matching webhook configuration. Manual Socket Mode remains available when using the manual setup instead. + +No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in shared mode. The gateway receives its service token and private runtime policy; app client credentials stay in LibreChat, and installed bot tokens are encrypted in the database. For an unreleased source checkout, add `docker-compose.channels-build.yml` and use `up -d --build` rather than expecting an unpublished release image. `npm run backend:dev` still starts only the application; for a source gateway process, omit the bound IDs and app-level token and provide the internal API URL and service token. + +### Connect and use a workspace + +1. As an organization administrator, open **Settings → Account → Organization Slack workspaces → Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. +2. Save the Agent, then open **Channels → Add → Organization workspace** and choose the connected workspace. Routing changes require organization administration and permission to share the Agent. +3. Choose **Workspace default** for new direct messages and mentions without a channel-specific assignment, or enter a **Specific Slack channel** ID. If another Agent is already assigned, confirm **Use this agent instead**. Existing conversations keep their original Agent. +4. Activate the connection, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. + +### Disconnect and remove + +- **Agent Builder → Channels → Manage connection → Remove** removes an assignment for new conversations. Deleting the connection also removes its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. +- **Settings → Account → Your channel account links** lets a member revoke their own identity link. +- **Settings → Account → Organization Slack workspaces → Disconnect workspace** retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. +- Removing the configuring person does not delete the organization's installation. Their personal links and credentials are cleaned up, and their Agent connections are retired through the normal channel cleanup. +- To stop the optional service, run the same Compose file list and project with `stop channel-gateway`, or set `channelGateway.enabled: false` and remove the shared opt-in from Helm/API configuration. Ordinary LibreChat can continue. Database topology is independent: do not remove an external replica configuration or convert existing data merely to stop the gateway. + +## Set up a manual Slack app connection 1. Save the Agent, then select **Channels → Add** in the Agent builder. Choose per-user or owner-only mode and continue. You need permission to share the Agent. 2. Copy the read-only Slack app manifest into Slack's app setup and install the app into your workspace. Make any app changes in Slack's app settings. @@ -51,7 +115,7 @@ Browser setup routes live under `/api/agents/{agentId}/channels`: list/create, r ## Run the Slack gateway -The gateway is a separate Node.js 24+ process, not an in-process LibreChat plugin. It uses Slack's official Node SDKs and calls LibreChat over HTTP; it does not connect directly to MongoDB or require a general-purpose Agent API key. One gateway configuration binds to one tenant and connection. Run another configured process for another connection. +The gateway is a separate Node.js 24+ process, not an in-process LibreChat plugin. It uses Slack's official Node SDKs and calls LibreChat over HTTP; it does not connect directly to MongoDB or require a general-purpose Agent API key. Manual single-connection mode binds one process to one tenant and connection. Shared mode omits those IDs and serves all installed workspaces with a bounded worker pool. From a LibreChat source checkout containing `packages/channel-gateway`: @@ -102,7 +166,7 @@ For a **fresh local database**, run these commands from the LibreChat repository -f docker-compose.mongo-replica.yml up -d --pull always api meilisearch ``` -3. Sign in, save an Agent, and [set up its Slack channel](#set-up-a-channel). Enter the bot token in the Agent builder. Set `CHANNEL_ID` in `.env` to the resulting connection ID. `CHANNEL_TENANT_ID` defaults to `_` for an ordinary OSS installation; supply the actual tenant ID for a tenant-scoped installation. For Socket Mode, also set `SLACK_APP_TOKEN` to the matching app-level token with `connections:write`. +3. Sign in, save an Agent, and [set up its Slack channel](#set-up-a-manual-slack-app-connection). Enter the bot token in the Agent builder. Set `CHANNEL_ID` in `.env` to the resulting connection ID. `CHANNEL_TENANT_ID` defaults to `_` for an ordinary OSS installation; supply the actual tenant ID for a tenant-scoped installation. For Socket Mode, also set `SLACK_APP_TOKEN` to the matching app-level token with `connections:write`. 4. Start the gateway: ```sh @@ -172,10 +236,35 @@ Native sessions show processing or waiting-for-input status and return to active ## Kubernetes and Helm -The LibreChat Helm chart can run one optional gateway for a configured connection. First select a published LibreChat release containing Channels through `image.tag` and upgrade the application with the gateway disabled. Configure the channel/background policy above in your existing `librechat.yaml`, then create and activate the connection in the Agent builder. Enable the gateway after obtaining its connection ID. +The LibreChat Helm chart supports a shared workspace gateway or a manually bound gateway. For manual single-connection setup, first select a published LibreChat release containing Channels through `image.tag` and upgrade the application with the gateway disabled. Configure the channel/background policy above in your existing `librechat.yaml`, then create and activate the connection in the Agent builder. Enable the gateway after obtaining its connection ID. Enabling the gateway requires an explicit `image.tag` selecting a published LibreChat release containing Channels; the chart refuses to silently use its older application-version default. The gateway image tag defaults to that same selected release. Earlier releases have no gateway image. A custom `channelGateway.image.tag` is available for deliberate image overrides. +### Shared workspace deployment + +Select a release containing organization workspaces and provide an existing Secret with `CHANNEL_SERVICE_TOKEN`, `SLACK_APP_ID`, `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET` and `SLACK_SIGNING_SECRET`. The service token is shared with LibreChat; the four app settings are referenced only by its API pod. You may use separate gateway-service and app Secrets. Existing explicit API environment entries take precedence over generated Secret references. + +```yaml filename="shared-workspace-values.yaml" +image: + tag: +channelGateway: + enabled: true + mode: shared + replicaCount: 2 + existingSecretName: gateway-service-credentials + slackAppSecretName: slack-app-credentials + ingress: + enabled: true + host: slack.example.com + tls: + - hosts: [slack.example.com] + secretName: slack-gateway-tls +``` + +Set `DOMAIN_SERVER` and `DOMAIN_CLIENT` through the application's normal environment settings. Use a transaction-capable database; the chart does not convert MongoDB topology. Shared mode supplies the app enablement flag and derives `SLACK_GATEWAY_URL` from its ingress host unless explicitly configured in `librechat.configEnv`. It omits connection IDs, tenant IDs and the Socket Mode token. Shared replicas use rolling updates and the existing durable claims; `mode: single` requires one replica and uses replacement updates. Configure the Slack app's public URLs as above, then use Account settings and Agent Builder; no per-workspace Helm values or pods are required. + +### Manual connection deployment + ```yaml filename="channel-values.yaml" image: tag: @@ -189,9 +278,9 @@ channelGateway: For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly when the API obtains `APP_TITLE` through a Secret or `global.librechat.env`, or choose a shorter gateway title if the application name is not compatible. Gateway titles must be nonempty after trimming, at most 40 UTF-16 characters, and contain no `<`, `>`, `|` or control characters. Helm rejects incompatible inherited titles before deployment; the application can keep its existing longer name. -The existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching Socket Mode app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. +For manual Socket Mode, the existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. -The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure gateway resources and annotations through `channelGateway`. Pod identity, `enableServiceLinks`, DNS, host aliases, image pull secrets, node selectors, tolerations and affinity follow the chart's shared platform settings. The configured ServiceAccount is reused while the gateway keeps its Kubernetes API token automount disabled. This installs a single gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. +The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure gateway resources and annotations through `channelGateway`. Pod identity, `enableServiceLinks`, DNS, host aliases, image pull secrets, node selectors, tolerations and affinity follow the chart's shared platform settings. The configured ServiceAccount is reused while the gateway keeps its Kubernetes API token automount disabled. Manual single mode installs one gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. For webhook transport, set the server policy to `webhook`, configure its public HTTPS gateway URL and clear `channelGateway.slackAppTokenKey`. Enable the dedicated gateway Ingress using your installed ingress controller and a trusted TLS certificate: @@ -213,7 +302,7 @@ Combine these settings with the enabled gateway and explicit application release The chart does not install an ingress controller or issue a TLS certificate. Configure TLS through the example Secret, your normal certificate controller/annotations, or an existing HTTPS termination layer. Slack needs a publicly trusted HTTPS endpoint. If you manage a separate external Ingress or need a custom base-path rewrite, leave `channelGateway.ingress.enabled: false` and route the callback paths to the rendered gateway Service yourself; do not add them as paths on the main application Ingress, whose backend is LibreChat. Socket Mode needs no public ingress. -By default, the gateway runs without an automatically mounted Kubernetes API token, as a non-root user with a read-only filesystem and dropped capabilities. The chart's global pod/container security contexts are honored for platform-specific overrides. Gateway version labels follow its selected image tag. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating its active connection and transport. +By default, the gateway runs without an automatically mounted Kubernetes API token, as a non-root user with a read-only filesystem and dropped capabilities. The chart's global pod/container security contexts are honored for platform-specific overrides. Gateway version labels follow its selected image tag. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating the shared app policy or its bound active connection and transport. **The chart does not configure or convert MongoDB topology.** Supply a transaction-capable database before enabling Channels. The default standalone database cannot run this feature. See the [Helm database configuration](/docs/local/helm_chart) for external database credentials. Normal LibreChat remains usable without enabling Channels. From 541e965d5797c43efd9776c85c6b8182dfa915d2 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Wed, 4 Nov 2026 14:19:25 -0800 Subject: [PATCH 16/38] docs: Clarify the Explicit Slack OAuth Public URL --- content/docs/features/agent_channels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 076b3a3e9..09a58882b 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -55,7 +55,7 @@ A deployment operator configures one Slack app once. Organization administrators | Events API | `https://slack.example.com/slack/events` | | Interactivity | `https://slack.example.com/slack/interactions` | - Use your configured `DOMAIN_SERVER`, including its application base path, for the OAuth URL. `DOMAIN_CLIENT` is the browser landing origin. The gateway callback URLs have no tenant or connection suffix. Expose only its Slack callback paths; keep gateway health and metrics private. + Use your configured `DOMAIN_SERVER`, including its application base path, for the OAuth URL. The shared deployment opt-in requires this value explicitly; it is not inferred from the gateway hostname. `DOMAIN_CLIENT` is the browser landing origin. The gateway callback URLs have no tenant or connection suffix. Expose only its Slack callback paths; keep gateway health and metrics private. 2. Request bot scopes `app_mentions:read`, `chat:write`, `reactions:read`, `reactions:write`, `files:write`, `im:write` and `im:history`. Subscribe to `app_mention`, `message.im`, `reaction_added`, `reaction_removed` and `agent_session_stopped`. Enable the app's messages tab. Keep token rotation and organization-wide installation disabled: this implementation accepts workspace bot grants, including individual workspaces in Enterprise Grid, and rejects rotating or organization-wide grants. 3. To install into other workspaces, complete Slack's [distribution setup](https://docs.slack.dev/app-management/distribution/). Slack workspace approval policies still apply. Store the app's ID, client ID, client secret and signing secret in the deployment's secret manager. Organization administrators never need these values or access to deployment environment variables. 4. Configure a transaction-capable database and a private `CHANNEL_SERVICE_TOKEN` shared by the API and gateway. Keep API-key authentication enabled for bound execution; retain normal Agent and Remote Agents permission controls. From 376ef311ba9ed7482d3eab1aff5775aee2477ea7 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Wed, 4 Nov 2026 14:31:19 -0800 Subject: [PATCH 17/38] docs: Require Public HTTPS for Shared Slack Deployment --- content/docs/features/agent_channels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 09a58882b..241007fb5 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -55,7 +55,7 @@ A deployment operator configures one Slack app once. Organization administrators | Events API | `https://slack.example.com/slack/events` | | Interactivity | `https://slack.example.com/slack/interactions` | - Use your configured `DOMAIN_SERVER`, including its application base path, for the OAuth URL. The shared deployment opt-in requires this value explicitly; it is not inferred from the gateway hostname. `DOMAIN_CLIENT` is the browser landing origin. The gateway callback URLs have no tenant or connection suffix. Expose only its Slack callback paths; keep gateway health and metrics private. + Use your configured `DOMAIN_SERVER`, including its application base path, for the OAuth URL. `DOMAIN_CLIENT` is the browser landing origin. Replace the localhost defaults in `.env` with public HTTPS addresses for both; the shared deployment opt-in rejects local addresses and does not infer the API URL from the gateway hostname. Any configured `SLACK_GATEWAY_URL` must also be public HTTPS. The gateway callback URLs have no tenant or connection suffix. Expose only its Slack callback paths; keep gateway health and metrics private. 2. Request bot scopes `app_mentions:read`, `chat:write`, `reactions:read`, `reactions:write`, `files:write`, `im:write` and `im:history`. Subscribe to `app_mention`, `message.im`, `reaction_added`, `reaction_removed` and `agent_session_stopped`. Enable the app's messages tab. Keep token rotation and organization-wide installation disabled: this implementation accepts workspace bot grants, including individual workspaces in Enterprise Grid, and rejects rotating or organization-wide grants. 3. To install into other workspaces, complete Slack's [distribution setup](https://docs.slack.dev/app-management/distribution/). Slack workspace approval policies still apply. Store the app's ID, client ID, client secret and signing secret in the deployment's secret manager. Organization administrators never need these values or access to deployment environment variables. 4. Configure a transaction-capable database and a private `CHANNEL_SERVICE_TOKEN` shared by the API and gateway. Keep API-key authentication enabled for bound execution; retain normal Agent and Remote Agents permission controls. From a2b429c6e19806f5b4a91d1ac25a945b6a98bdc2 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Wed, 4 Nov 2026 21:23:20 -0800 Subject: [PATCH 18/38] docs: Explain Organization-Owned Slack App Setup --- .../object_structure/agents.mdx | 5 +-- content/docs/features/agent_channels.mdx | 42 ++++++++----------- 2 files changed, 20 insertions(+), 27 deletions(-) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 36af1fd5b..a3f794019 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1519,12 +1519,11 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels | `artifactReadTimeoutMs` | `30000` | Shared artifact-operation budget, `1000`–`60000` ms; not a separate timeout for each file | | `artifactAnswerFileThresholdBytes` | `6000` | Create new plain-text answer files only above this UTF-8 byte length, `0`–`52428800`; fenced answers also qualify | -`slackApp` configures the operator-owned app for organization workspace installations. Set `channels.enabled: true`, `transport: webhook` and `slackApp.enabled: true`; supply `appId`, `clientId`, `clientSecret` and `signingSecret`. Keep credentials server-side. The deployment opt-in `SLACK_WORKSPACES_ENABLED=true` supplies these settings from `SLACK_APP_ID`, `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET` and `SLACK_SIGNING_SECRET`, enables background Responses, and preserves other YAML settings. Nonempty environment app values take precedence; without the opt-in, YAML remains authoritative. `SLACK_GATEWAY_URL` supplies the public gateway URL. See [Organization workspaces](/docs/features/agent_channels#organization-workspaces) for deployment and UI steps. +`slackApp` enables organization-owned apps and sets installation/runtime policy. Set `channels.enabled: true`, `transport: webhook` and `slackApp.enabled: true`. Organization admins register app credentials through LibreChat’s workspace UI; credentials are encrypted in the database and are not YAML or environment settings. The deployment opt-in `SLACK_WORKSPACES_ENABLED=true` enables these policies and background Responses while preserving other YAML settings. Without the opt-in, YAML remains authoritative. `SLACK_GATEWAY_URL` supplies the public gateway URL. See [Organization workspaces](/docs/features/agent_channels#organization-workspaces) for deployment and UI steps. | `slackApp` option | Default | Purpose | | --- | --- | --- | -| `enabled` | `false` | Enable browser-based workspace installation for the configured app | -| `appId`, `clientId`, `clientSecret`, `signingSecret` | Omitted | Required operator app identity and credentials | +| `enabled` | `false` | Enable organization app registration and workspace installation | | `flowLifetimeMs` | `600000` | Browser install lifetime, `60000`–`3600000` ms | | `requestTimeoutMs` | `10000` | Slack installation/verification request deadline, `1000`–`30000` ms | | `maxResponseBytes` | `65536` | Maximum Slack response bytes, `1024`–`262144` | diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 241007fb5..77862054e 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -12,7 +12,7 @@ Agent Channels connect external messaging events to [background Agent Responses] ## Configuration and prerequisites -Choose organization workspaces for one centrally configured Slack app and UI-managed workspace installations. The YAML example below is the manual single-connection setup; the shared-workspace deployment options also enable Channels and background Responses automatically. +Choose organization workspaces for UI-managed, organization-owned Slack apps and workspace installations. The YAML example below is the manual single-connection setup; the shared-workspace deployment options also enable Channels and background Responses automatically. ```yaml filename="endpoints / agents" endpoints: @@ -43,30 +43,17 @@ See the [channel configuration reference](/docs/configuration/librechat_yaml/obj ## Organization workspaces -A deployment operator configures one Slack app once. Organization administrators then connect workspaces in LibreChat; members link their personal accounts in Slack. Installing an app does not give members access to an Agent or its tools. In a tenant-aware deployment, installations and routing belong to the active tenant. One app/workspace installation has one tenant owner; another tenant cannot claim an active installation. +A deployment operator enables the shared gateway once, without creating Slack apps or handling customer credentials. Organization administrators register their own Slack apps and connect workspaces in LibreChat; members link their personal accounts in Slack. Installing an app does not give members access to an Agent or its tools. In a tenant-aware deployment, installations and routing belong to the active tenant. One app/workspace installation has one tenant owner; another tenant cannot claim an active installation. ### One-time operator setup -1. Create a Slack app, or use your deployment's existing app. Enable HTTP Events API delivery and interactivity, rather than Socket Mode. Configure these public HTTPS URLs: +1. Configure transaction-capable MongoDB and a private `CHANNEL_SERVICE_TOKEN` shared by the API and gateway. Keep API-key authentication enabled for bound execution and retain normal Agent and Remote Agents permission controls. +2. Configure public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT`, replacing the localhost defaults in `.env`. Include the application base path when present. Set `SLACK_GATEWAY_URL` to the public gateway origin; it must also use public HTTPS. The shared deployment opt-in rejects local addresses. +3. Route `/slack/events/` and `/slack/interactions/`, including their organization/app suffixes, to the gateway on port 8080. Route the application and OAuth callback to LibreChat. Keep gateway health and metrics private. No Slack dashboard access, app credentials or per-organization infrastructure settings are required. - | Setting | URL | - | --- | --- | - | OAuth redirect | `https://chat.example.com/api/channels/workspaces/oauth/callback` | - | Events API | `https://slack.example.com/slack/events` | - | Interactivity | `https://slack.example.com/slack/interactions` | - - Use your configured `DOMAIN_SERVER`, including its application base path, for the OAuth URL. `DOMAIN_CLIENT` is the browser landing origin. Replace the localhost defaults in `.env` with public HTTPS addresses for both; the shared deployment opt-in rejects local addresses and does not infer the API URL from the gateway hostname. Any configured `SLACK_GATEWAY_URL` must also be public HTTPS. The gateway callback URLs have no tenant or connection suffix. Expose only its Slack callback paths; keep gateway health and metrics private. -2. Request bot scopes `app_mentions:read`, `chat:write`, `reactions:read`, `reactions:write`, `files:write`, `im:write` and `im:history`. Subscribe to `app_mention`, `message.im`, `reaction_added`, `reaction_removed` and `agent_session_stopped`. Enable the app's messages tab. Keep token rotation and organization-wide installation disabled: this implementation accepts workspace bot grants, including individual workspaces in Enterprise Grid, and rejects rotating or organization-wide grants. -3. To install into other workspaces, complete Slack's [distribution setup](https://docs.slack.dev/app-management/distribution/). Slack workspace approval policies still apply. Store the app's ID, client ID, client secret and signing secret in the deployment's secret manager. Organization administrators never need these values or access to deployment environment variables. -4. Configure a transaction-capable database and a private `CHANNEL_SERVICE_TOKEN` shared by the API and gateway. Keep API-key authentication enabled for bound execution; retain normal Agent and Remote Agents permission controls. - -For Docker Compose, put the four app settings in the normal uncommitted `.env`: +For Docker Compose, use the normal uncommitted `.env`: ```dotenv -SLACK_APP_ID= -SLACK_CLIENT_ID= -SLACK_CLIENT_SECRET= -SLACK_SIGNING_SECRET= SLACK_GATEWAY_URL=https://slack.example.com CHANNEL_SERVICE_TOKEN= DOMAIN_SERVER=https://chat.example.com @@ -84,13 +71,20 @@ docker compose -f docker-compose.yml -f docker-compose.channels.yml \ The replica overlay is for a **fresh local database**; read [Existing local data](#existing-local-data) before converting an existing installation. Omit that overlay when you already use a verified transaction-capable external database and supply its normal connection configuration. Use the same Compose project and files for subsequent commands. This does not configure a public reverse proxy or a trusted certificate; route the two Slack paths to the gateway on port 8080 through your normal ingress. -The shared overlay supplies `SLACK_WORKSPACES_ENABLED=true`, which enables webhook Channels, shared app installation and stored background Responses while retaining unrelated YAML policy, limits and explicit API authentication settings. Supplied nonempty app environment values override the corresponding app fields in YAML. With the flag unset or false, YAML continues to control the feature. Choosing shared setup changes the deployment's channel transport to webhook; existing bound connections must use matching webhook configuration. Manual Socket Mode remains available when using the manual setup instead. +The shared overlay supplies `SLACK_WORKSPACES_ENABLED=true`, which enables webhook Channels, shared app installation and stored background Responses while retaining unrelated YAML policy, limits and explicit API authentication settings. Slack app credentials are entered by organization admins through the UI and stored encrypted; they are not deployment environment variables or YAML fields. With the flag unset or false, YAML continues to control the feature. Choosing shared setup changes the deployment's channel transport to webhook; existing bound connections must use matching webhook configuration. Manual Socket Mode remains available when using the manual setup instead. No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in shared mode. The gateway receives its service token and private runtime policy; app client credentials stay in LibreChat, and installed bot tokens are encrypted in the database. For an unreleased source checkout, add `docker-compose.channels-build.yml` and use `up -d --build` rather than expecting an unpublished release image. `npm run backend:dev` still starts only the application; for a source gateway process, omit the bound IDs and app-level token and provide the internal API URL and service token. +### Register an organization’s Slack app + +1. As an organization administrator, open **Settings → Account → Organization Slack workspaces → Add Slack app**. Create an app from scratch in Slack, or open an existing app your organization controls. Copy its app ID, client ID, client secret and signing secret from **Basic Information → App Credentials**, then save them in LibreChat. Credentials are write-only and encrypted; other members cannot read them back. +2. Expand **Configure these URLs in your Slack app**. Apply the displayed manifest under Slack’s **App Manifest**, including its scopes and event subscriptions. Turn Socket Mode off and configure the displayed OAuth redirect, Events API and Interactivity URLs. Copy the exact URLs: event and interaction callbacks contain your organization and app IDs. Saving the app first lets Slack verify the event URL before workspace installation. +3. Keep token rotation and organization-wide installation disabled. Workspace bot grants, including individual workspaces in Enterprise Grid, are supported. To install into other workspaces, complete Slack’s [distribution setup](https://docs.slack.dev/app-management/distribution/). Slack workspace approval policies still apply. +4. Each organization may register multiple apps and install each app into multiple workspaces. Use **Replace credentials** after a Slack credential rotation. A stale edit or pending authorization cannot overwrite a newer registration; refresh before retrying a conflicted edit. + ### Connect and use a workspace -1. As an organization administrator, open **Settings → Account → Organization Slack workspaces → Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. +1. Under the registered app, select **Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. 2. Save the Agent, then open **Channels → Add → Organization workspace** and choose the connected workspace. Routing changes require organization administration and permission to share the Agent. 3. Choose **Workspace default** for new direct messages and mentions without a channel-specific assignment, or enter a **Specific Slack channel** ID. If another Agent is already assigned, confirm **Use this agent instead**. Existing conversations keep their original Agent. 4. Activate the connection, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. @@ -100,6 +94,7 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in - **Agent Builder → Channels → Manage connection → Remove** removes an assignment for new conversations. Deleting the connection also removes its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. - **Settings → Account → Your channel account links** lets a member revoke their own identity link. - **Settings → Account → Organization Slack workspaces → Disconnect workspace** retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. +- After disconnecting an app’s active workspaces, select **Remove app** and confirm to delete its saved app credentials. This does not delete the Slack app itself. - Removing the configuring person does not delete the organization's installation. Their personal links and credentials are cleaned up, and their Agent connections are retired through the normal channel cleanup. - To stop the optional service, run the same Compose file list and project with `stop channel-gateway`, or set `channelGateway.enabled: false` and remove the shared opt-in from Helm/API configuration. Ordinary LibreChat can continue. Database topology is independent: do not remove an external replica configuration or convert existing data merely to stop the gateway. @@ -242,7 +237,7 @@ Enabling the gateway requires an explicit `image.tag` selecting a published Libr ### Shared workspace deployment -Select a release containing organization workspaces and provide an existing Secret with `CHANNEL_SERVICE_TOKEN`, `SLACK_APP_ID`, `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET` and `SLACK_SIGNING_SECRET`. The service token is shared with LibreChat; the four app settings are referenced only by its API pod. You may use separate gateway-service and app Secrets. Existing explicit API environment entries take precedence over generated Secret references. +Select a release containing organization workspaces and provide an existing Secret with `CHANNEL_SERVICE_TOKEN`. The service token is shared with LibreChat. No Slack app credentials belong in this Secret: organization admins register their apps in the UI after deployment. Existing explicit API environment entries take precedence over the generated service-token reference. ```yaml filename="shared-workspace-values.yaml" image: @@ -252,7 +247,6 @@ channelGateway: mode: shared replicaCount: 2 existingSecretName: gateway-service-credentials - slackAppSecretName: slack-app-credentials ingress: enabled: true host: slack.example.com @@ -261,7 +255,7 @@ channelGateway: secretName: slack-gateway-tls ``` -Set `DOMAIN_SERVER` and `DOMAIN_CLIENT` through the application's normal environment settings. Use a transaction-capable database; the chart does not convert MongoDB topology. Shared mode supplies the app enablement flag and derives `SLACK_GATEWAY_URL` from its ingress host unless explicitly configured in `librechat.configEnv`. It omits connection IDs, tenant IDs and the Socket Mode token. Shared replicas use rolling updates and the existing durable claims; `mode: single` requires one replica and uses replacement updates. Configure the Slack app's public URLs as above, then use Account settings and Agent Builder; no per-workspace Helm values or pods are required. +Set `DOMAIN_SERVER` and `DOMAIN_CLIENT` through the application's normal environment settings. Use a transaction-capable database; the chart does not convert MongoDB topology. Shared mode supplies the app enablement flag and derives `SLACK_GATEWAY_URL` from its ingress host unless explicitly configured in `librechat.configEnv`. It omits connection IDs, tenant IDs and the Socket Mode token. Shared replicas use rolling updates and the existing durable claims; `mode: single` requires one replica and uses replacement updates. After deployment, organization admins register their apps and configure the displayed Slack URLs through Account settings, then use Agent Builder; no per-workspace Helm values or pods are required. ### Manual connection deployment From bb468c8047c52316e14aeb6d929fdbb3d2955a03 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Wed, 4 Nov 2026 21:35:48 -0800 Subject: [PATCH 19/38] docs: Clarify Slack Manifest URL Verification --- content/docs/features/agent_channels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 77862054e..a5bbd2212 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -78,7 +78,7 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in ### Register an organization’s Slack app 1. As an organization administrator, open **Settings → Account → Organization Slack workspaces → Add Slack app**. Create an app from scratch in Slack, or open an existing app your organization controls. Copy its app ID, client ID, client secret and signing secret from **Basic Information → App Credentials**, then save them in LibreChat. Credentials are write-only and encrypted; other members cannot read them back. -2. Expand **Configure these URLs in your Slack app**. Apply the displayed manifest under Slack’s **App Manifest**, including its scopes and event subscriptions. Turn Socket Mode off and configure the displayed OAuth redirect, Events API and Interactivity URLs. Copy the exact URLs: event and interaction callbacks contain your organization and app IDs. Saving the app first lets Slack verify the event URL before workspace installation. +2. Expand **Configure these URLs in your Slack app**. Apply the displayed manifest under Slack’s **App Manifest**, including its scopes and event subscriptions. Turn Socket Mode off and configure the displayed OAuth redirect, Events API and Interactivity URLs. Copy the exact URLs: event and interaction callbacks contain your organization and app IDs. Saving the app first lets Slack verify the event URL before workspace installation. If Slack reports that the manifest’s event URL is not verified, choose **Click here to verify**, wait for verification to succeed, and finish saving the Slack settings. 3. Keep token rotation and organization-wide installation disabled. Workspace bot grants, including individual workspaces in Enterprise Grid, are supported. To install into other workspaces, complete Slack’s [distribution setup](https://docs.slack.dev/app-management/distribution/). Slack workspace approval policies still apply. 4. Each organization may register multiple apps and install each app into multiple workspaces. Use **Replace credentials** after a Slack credential rotation. A stale edit or pending authorization cannot overwrite a newer registration; refresh before retrying a conflicted edit. From ca10dee5445a087c9776de40decd1a962106609b Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 5 Nov 2026 00:01:26 -0800 Subject: [PATCH 20/38] docs: Clarify Shared Gateway Proxy and MongoDB Prerequisites --- content/docs/features/agent_channels.mdx | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index a5bbd2212..fe5070834 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -48,8 +48,8 @@ A deployment operator enables the shared gateway once, without creating Slack ap ### One-time operator setup 1. Configure transaction-capable MongoDB and a private `CHANNEL_SERVICE_TOKEN` shared by the API and gateway. Keep API-key authentication enabled for bound execution and retain normal Agent and Remote Agents permission controls. -2. Configure public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT`, replacing the localhost defaults in `.env`. Include the application base path when present. Set `SLACK_GATEWAY_URL` to the public gateway origin; it must also use public HTTPS. The shared deployment opt-in rejects local addresses. -3. Route `/slack/events/` and `/slack/interactions/`, including their organization/app suffixes, to the gateway on port 8080. Route the application and OAuth callback to LibreChat. Keep gateway health and metrics private. No Slack dashboard access, app credentials or per-organization infrastructure settings are required. +2. Configure public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT`, replacing the localhost defaults in `.env`. Both are required and must have no surrounding whitespace. Include the application base path when present. Set `SLACK_GATEWAY_URL` to the public gateway origin; it must also use public HTTPS. The shared deployment opt-in rejects local addresses. +3. Route `/slack/events/` and `/slack/interactions/`, including their organization/app suffixes, to the gateway. Its container listens on port 8080; the shared Compose overlay publishes it at `127.0.0.1:3081` for a host-level HTTPS proxy. Route the application and OAuth callback to LibreChat. Keep gateway health and metrics private. No Slack dashboard access, app credentials or per-organization infrastructure settings are required. For Docker Compose, use the normal uncommitted `.env`: @@ -69,7 +69,7 @@ docker compose -f docker-compose.yml -f docker-compose.channels.yml \ --profile channels up -d api meilisearch channel-gateway ``` -The replica overlay is for a **fresh local database**; read [Existing local data](#existing-local-data) before converting an existing installation. Omit that overlay when you already use a verified transaction-capable external database and supply its normal connection configuration. Use the same Compose project and files for subsequent commands. This does not configure a public reverse proxy or a trusted certificate; route the two Slack paths to the gateway on port 8080 through your normal ingress. +The replica overlay is for a **fresh local database**; read [Existing local data](#existing-local-data) before converting an existing installation. Omit that overlay when you already use a verified transaction-capable external database and supply its normal connection configuration. Use the same Compose project and files for subsequent commands. This does not configure a public reverse proxy or a trusted certificate. A host-level proxy forwards the two Slack paths to `http://127.0.0.1:3081`, preserving the organization/app suffixes. Set `CHANNEL_GATEWAY_PORT` in `.env` to change that loopback port. A proxy in the same Compose network can instead forward to `http://channel-gateway:8080`. The shared overlay supplies `SLACK_WORKSPACES_ENABLED=true`, which enables webhook Channels, shared app installation and stored background Responses while retaining unrelated YAML policy, limits and explicit API authentication settings. Slack app credentials are entered by organization admins through the UI and stored encrypted; they are not deployment environment variables or YAML fields. With the flag unset or false, YAML continues to control the feature. Choosing shared setup changes the deployment's channel transport to webhook; existing bound connections must use matching webhook configuration. Manual Socket Mode remains available when using the manual setup instead. @@ -239,9 +239,13 @@ Enabling the gateway requires an explicit `image.tag` selecting a published Libr Select a release containing organization workspaces and provide an existing Secret with `CHANNEL_SERVICE_TOKEN`. The service token is shared with LibreChat. No Slack app credentials belong in this Secret: organization admins register their apps in the UI after deployment. Existing explicit API environment entries take precedence over the generated service-token reference. +The example below selects a replica set for a **fresh bundled MongoDB**. For an existing standalone database, plan and complete its data migration before changing topology; a Helm value does not migrate existing data. To use an external transaction-capable database, set `mongodb.enabled: false` and supply its connection through your normal application configuration. Shared mode refuses to render with a bundled standalone MongoDB. + ```yaml filename="shared-workspace-values.yaml" image: tag: +mongodb: + architecture: replicaset channelGateway: enabled: true mode: shared From 29f03bb481fc837647ee0ce238e80835d7c7f081 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 5 Nov 2026 00:04:47 -0800 Subject: [PATCH 21/38] docs: Clarify External MongoDB Overrides for Shared Workspaces --- content/docs/features/agent_channels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index fe5070834..3459eb97e 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -239,7 +239,7 @@ Enabling the gateway requires an explicit `image.tag` selecting a published Libr Select a release containing organization workspaces and provide an existing Secret with `CHANNEL_SERVICE_TOKEN`. The service token is shared with LibreChat. No Slack app credentials belong in this Secret: organization admins register their apps in the UI after deployment. Existing explicit API environment entries take precedence over the generated service-token reference. -The example below selects a replica set for a **fresh bundled MongoDB**. For an existing standalone database, plan and complete its data migration before changing topology; a Helm value does not migrate existing data. To use an external transaction-capable database, set `mongodb.enabled: false` and supply its connection through your normal application configuration. Shared mode refuses to render with a bundled standalone MongoDB. +The example below selects a replica set for a **fresh bundled MongoDB**. For an existing standalone database, plan and complete its data migration before changing topology; a Helm value does not migrate existing data. For an external transaction-capable database, supply its connection through your normal application configuration and disable the unused bundled database with `mongodb.enabled: false`. Shared mode refuses to render when LibreChat would use a bundled standalone MongoDB; existing external connection overrides remain supported. ```yaml filename="shared-workspace-values.yaml" image: From 88a9921da56072b878be3164467053ac01cd14c0 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 5 Nov 2026 06:33:28 -0800 Subject: [PATCH 22/38] docs: clarify member-owned Slack agent connections --- content/docs/features/agent_channels.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 3459eb97e..848442359 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -85,8 +85,8 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in ### Connect and use a workspace 1. Under the registered app, select **Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. -2. Save the Agent, then open **Channels → Add → Organization workspace** and choose the connected workspace. Routing changes require organization administration and permission to share the Agent. -3. Choose **Workspace default** for new direct messages and mentions without a channel-specific assignment, or enter a **Specific Slack channel** ID. If another Agent is already assigned, confirm **Use this agent instead**. Existing conversations keep their original Agent. +2. As an Agent owner or member with permission to share it, save the Agent, then open **Channels → Add → Organization workspace** and choose the connected workspace. Members with permission to use Remote Agents and share the Agent can create and manage their own connections to installed workspaces. App registration, workspace installation, disconnect and removal remain organization-admin actions. +3. Choose **Workspace default** for new direct messages and mentions without a channel-specific assignment, or enter a **Specific Slack channel** ID. If another connection you own is already assigned, confirm **Use this agent instead**. Replacing another member's assignment requires an organization administrator; members can instead choose an unassigned Slack channel. Existing conversations keep their original Agent. 4. Activate the connection, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. ### Disconnect and remove From 5df77a0c1432483ccb7b385014bcf3d08267554e Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 5 Nov 2026 06:58:31 -0800 Subject: [PATCH 23/38] docs: explain bot-scoped Slack agent assignments --- content/docs/features/agent_channels.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 848442359..2d9f343e2 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -86,8 +86,8 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in 1. Under the registered app, select **Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. 2. As an Agent owner or member with permission to share it, save the Agent, then open **Channels → Add → Organization workspace** and choose the connected workspace. Members with permission to use Remote Agents and share the Agent can create and manage their own connections to installed workspaces. App registration, workspace installation, disconnect and removal remain organization-admin actions. -3. Choose **Workspace default** for new direct messages and mentions without a channel-specific assignment, or enter a **Specific Slack channel** ID. If another connection you own is already assigned, confirm **Use this agent instead**. Replacing another member's assignment requires an organization administrator; members can instead choose an unassigned Slack channel. Existing conversations keep their original Agent. -4. Activate the connection, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. +3. Choose **Default for this bot** for that bot’s new direct messages and mentions without a channel-specific assignment, or select **For a specific channel** and enter its Slack channel ID. These choices affect the selected Slack bot, not other bots in the workspace. If another connection you own is already assigned, confirm **Replace this bot’s current default agent** or **Replace this bot’s agent in this channel**, then select **Replace default agent** or **Replace channel agent**. Replacing another member's assignment requires an organization administrator; members can instead choose an unassigned Slack channel. Existing conversations keep their original Agent. +4. Select **Assign agent** for an unassigned destination, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. ### Disconnect and remove From 63dbe66557be7078229899cc686764069cafbdde Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 5 Nov 2026 07:10:22 -0800 Subject: [PATCH 24/38] docs: describe separate Slack assignment management and confirmations --- content/docs/features/agent_channels.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 2d9f343e2..1460cdc7c 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -86,12 +86,12 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in 1. Under the registered app, select **Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. 2. As an Agent owner or member with permission to share it, save the Agent, then open **Channels → Add → Organization workspace** and choose the connected workspace. Members with permission to use Remote Agents and share the Agent can create and manage their own connections to installed workspaces. App registration, workspace installation, disconnect and removal remain organization-admin actions. -3. Choose **Default for this bot** for that bot’s new direct messages and mentions without a channel-specific assignment, or select **For a specific channel** and enter its Slack channel ID. These choices affect the selected Slack bot, not other bots in the workspace. If another connection you own is already assigned, confirm **Replace this bot’s current default agent** or **Replace this bot’s agent in this channel**, then select **Replace default agent** or **Replace channel agent**. Replacing another member's assignment requires an organization administrator; members can instead choose an unassigned Slack channel. Existing conversations keep their original Agent. +3. Choose **Default for this bot** for that bot’s new direct messages and mentions without a channel-specific assignment, or select **For a specific channel** and enter its Slack channel ID. These choices affect the selected Slack bot, not other bots in the workspace. If another connection you own is already assigned, select **Replace default agent** or **Replace channel agent**, review the focused confirmation dialog, then confirm the replacement. Replacing another member's assignment requires an organization administrator; members can instead choose an unassigned Slack channel. Existing conversations keep their original Agent. 4. Select **Assign agent** for an unassigned destination, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. ### Disconnect and remove -- **Agent Builder → Channels → Manage connection → Remove** removes an assignment for new conversations. Deleting the connection also removes its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. +- **Agent Builder → Channels → Manage connection** lists current assignments. Select **Add assignment** to configure another destination, or **Remove** beside an assignment and confirm **Remove assignment** to stop using it for new conversations. Select **Delete connection** and confirm to remove the connection and all its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. - **Settings → Account → Your channel account links** lets a member revoke their own identity link. - **Settings → Account → Organization Slack workspaces → Disconnect workspace** retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. - After disconnecting an app’s active workspaces, select **Remove app** and confirm to delete its saved app credentials. This does not delete the Slack app itself. From beef625b9f2dc7cdc6bb9d667e3d559d4232e31c Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Thu, 5 Nov 2026 08:00:07 -0800 Subject: [PATCH 25/38] docs: explain administrator-assigned Slack bot managers --- .../librechat_yaml/object_structure/agents.mdx | 2 ++ content/docs/features/agent_channels.mdx | 9 ++++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index a3f794019..43ca93338 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1499,6 +1499,8 @@ Unknown management-auth fields, duplicate client IDs, malformed user or tenant I ## channels +For organization workspaces, `channels.maxBotManagers` limits the number of explicitly granted bot managers per app/workspace installation (default `50`, range `1`–`1000`). Administrators grant these users through **Manage bot access**; bot management does not grant Agent sharing or installation-administration permissions. + Configures the opt-in [Agent Channels integration](/docs/features/agent_channels). Enabled background Responses and a separately running gateway are required. The LibreChat source includes the standalone TypeScript Slack gateway in `packages/channel-gateway`; this setting does not start it or enable execution permissions. | Option | Default | Accepted values / purpose | diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 1460cdc7c..dec068c47 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -85,12 +85,15 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in ### Connect and use a workspace 1. Under the registered app, select **Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. -2. As an Agent owner or member with permission to share it, save the Agent, then open **Channels → Add → Organization workspace** and choose the connected workspace. Members with permission to use Remote Agents and share the Agent can create and manage their own connections to installed workspaces. App registration, workspace installation, disconnect and removal remain organization-admin actions. -3. Choose **Default for this bot** for that bot’s new direct messages and mentions without a channel-specific assignment, or select **For a specific channel** and enter its Slack channel ID. These choices affect the selected Slack bot, not other bots in the workspace. If another connection you own is already assigned, select **Replace default agent** or **Replace channel agent**, review the focused confirmation dialog, then confirm the replacement. Replacing another member's assignment requires an organization administrator; members can instead choose an unassigned Slack channel. Existing conversations keep their original Agent. -4. Select **Assign agent** for an unassigned destination, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. +2. In **Organization Slack workspaces**, an administrator selects **Manage bot access** on the connected workspace and adds the LibreChat users who may manage that bot. Grants apply to this app/workspace installation; they do not grant Agent access, Slack credentials or installation-administration rights. Only administrators can change the manager list. +3. As a bot manager, save an Agent you have permission to share, then open **Channels → Add → Organization workspace** and choose an available workspace. You still need permission to use Remote Agents. Only bots you can manage are offered; installation administrators can also assign agents. +4. Choose **Default for this bot** for that bot’s new direct messages and mentions without a channel-specific assignment, or select **For a specific channel** and enter its Slack channel ID. These choices affect the selected Slack bot, not other bots in the workspace. If another connection is already assigned, a bot manager or administrator can select **Replace default agent** or **Replace channel agent**, review the confirmation dialog, then confirm. The dialog names the current Agent only when you can view it. Existing conversations keep their original Agent. +5. Select **Assign agent** for an unassigned destination, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. ### Disconnect and remove +- Administrators revoke bot management under **Manage bot access**. Removed managers cannot create or change assignments, but can still remove assignments or delete their own Agent connection. Existing assignments and conversations keep running; management access is separate from permission to talk to the bot. Disconnecting a workspace clears its manager grants; a fresh installation requires new grants. Reauthorizing an active installation preserves managers. + - **Agent Builder → Channels → Manage connection** lists current assignments. Select **Add assignment** to configure another destination, or **Remove** beside an assignment and confirm **Remove assignment** to stop using it for new conversations. Select **Delete connection** and confirm to remove the connection and all its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. - **Settings → Account → Your channel account links** lets a member revoke their own identity link. - **Settings → Account → Organization Slack workspaces → Disconnect workspace** retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. From 4d7db5a7456a75ad0251cb798355d5c41b2ea5d1 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Mon, 9 Nov 2026 23:52:12 -0800 Subject: [PATCH 26/38] =?UTF-8?q?=F0=9F=93=9A=20docs:=20Align=20Slack=20Se?= =?UTF-8?q?tup=20With=20App=20Onboarding?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../object_structure/agents.mdx | 6 +- content/docs/features/agent_channels.mdx | 85 ++++++++++++++----- content/docs/features/agents_api.mdx | 6 -- 3 files changed, 68 insertions(+), 29 deletions(-) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 43ca93338..0bcfbfcb6 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1499,14 +1499,14 @@ Unknown management-auth fields, duplicate client IDs, malformed user or tenant I ## channels -For organization workspaces, `channels.maxBotManagers` limits the number of explicitly granted bot managers per app/workspace installation (default `50`, range `1`–`1000`). Administrators grant these users through **Manage bot access**; bot management does not grant Agent sharing or installation-administration permissions. +For organization workspaces, `channels.maxBotManagers` limits the number of explicitly granted bot managers per app/workspace installation (default `50`, range `1`–`1000`). Administrators grant these users through the workspace’s **Manage access** button (**Manage bot access** dialog); bot management does not grant Agent sharing or installation-administration permissions. Configures the opt-in [Agent Channels integration](/docs/features/agent_channels). Enabled background Responses and a separately running gateway are required. The LibreChat source includes the standalone TypeScript Slack gateway in `packages/channel-gateway`; this setting does not start it or enable execution permissions. | Option | Default | Accepted values / purpose | | --- | --- | --- | | `enabled` | `false` | Enable channel setup and service routes | -| `transport` | `socket_mode` | Select `socket_mode` or `webhook` ingress and the generated manifest; the gateway runs separately | +| `transport` | `socket_mode` | Select `socket_mode` or `webhook` ingress; manual connections generate a matching manifest and the gateway runs separately | | `gatewayUrl` | Omitted | Required HTTPS base URL for generating webhook callback URLs; not needed for Socket Mode | | `nativeSessions` | `false` | Enable optional Slack native Agent status emission after app setup | | `lifecycleReactions` | `false` | Add optional processing/completion reactions | @@ -1521,7 +1521,7 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels | `artifactReadTimeoutMs` | `30000` | Shared artifact-operation budget, `1000`–`60000` ms; not a separate timeout for each file | | `artifactAnswerFileThresholdBytes` | `6000` | Create new plain-text answer files only above this UTF-8 byte length, `0`–`52428800`; fenced answers also qualify | -`slackApp` enables organization-owned apps and sets installation/runtime policy. Set `channels.enabled: true`, `transport: webhook` and `slackApp.enabled: true`. Organization admins register app credentials through LibreChat’s workspace UI; credentials are encrypted in the database and are not YAML or environment settings. The deployment opt-in `SLACK_WORKSPACES_ENABLED=true` enables these policies and background Responses while preserving other YAML settings. Without the opt-in, YAML remains authoritative. `SLACK_GATEWAY_URL` supplies the public gateway URL. See [Organization workspaces](/docs/features/agent_channels#organization-workspaces) for deployment and UI steps. +`slackApp` enables organization-owned apps and sets installation/runtime policy. Set `channels.enabled: true`, `transport: webhook` and `slackApp.enabled: true`. Each registered app supports one active workspace. Organization admins register an existing Slack app through **Settings → Account → Slack → Set up/Manage → Add Slack app**, with an optional friendly name and app/client credentials; credentials are encrypted in the database and are not YAML or environment settings. The deployment opt-in `SLACK_WORKSPACES_ENABLED=true` enables these policies and background Responses while preserving other YAML settings. Without the opt-in, YAML remains authoritative. `SLACK_GATEWAY_URL` supplies the public gateway URL. See [Organization workspaces](/docs/features/agent_channels#organization-workspaces) for deployment and UI steps. | `slackApp` option | Default | Purpose | | --- | --- | --- | diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index dec068c47..96d7742da 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -31,11 +31,11 @@ endpoints: Both enablement settings default to `false`. Users need both Agent use and Remote Agents use permissions. Channel setup also requires Agent sharing permission or existing administrator management access; sharing access does not require permission to edit the Agent. Configure `DOMAIN_CLIENT` for trusted owner-review and account-link URLs. Configure a strong `CHANNEL_SERVICE_TOKEN` for the gateway-to-LibreChat service boundary; keep it server-side and distribute it only to a trusted integration process over a secure channel. It is not a browser token or a general Agent API key. -The `transport` option accepts `socket_mode` (default) or `webhook`. This selects the generated Slack manifest; it does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. The gateway loads this policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is an optional deployment assertion; if supplied, it must match the server-selected mode. Missing or unsupported gateway policy prevents startup. +The `transport` option accepts `socket_mode` (default) or `webhook`. Manual connections generate a matching Slack manifest; organization workspaces use the webhook setup below. Selecting a transport does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. The gateway loads this policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is an optional deployment assertion; if supplied, it must match the server-selected mode. Missing or unsupported gateway policy prevents startup. ### Database requirement -Durable Channels and stored background Responses require MongoDB transactions. Use a MongoDB replica set or another verified transaction-capable deployment. Standalone MongoDB and FerretDB 2.7 can run ordinary LibreChat, but cannot enable this durable feature. Unsupported channel writes return `transactions_unavailable`; the Agent builder explains the setup requirement. Transactional reads use the primary even when the connection normally prefers secondary reads. +Durable Channels and stored background Responses require MongoDB transactions. Use a MongoDB replica set or another verified transaction-capable deployment. Standalone MongoDB and FerretDB 2.7 can run ordinary LibreChat, but cannot enable this durable feature. Unsupported channel writes return `transactions_unavailable`; the Agent builder explains the setup requirement. Transactional reads use the primary even when the connection normally prefers secondary reads. The database must also support the required indexes, including partial indexes; transaction support by itself is not sufficient. [Amazon DocumentDB 4.0 lacks partial-index support](https://docs.aws.amazon.com/documentdb/latest/devguide/indexes-single-field.html) and cannot run this gateway. Other MongoDB-compatible engines need their own compatibility validation. API-key authentication must remain enabled for the gateway's bound execution credential. Linking does not grant Remote Agents permissions, Agent access, new tools or offline access to connected services. @@ -77,33 +77,78 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in ### Register an organization’s Slack app -1. As an organization administrator, open **Settings → Account → Organization Slack workspaces → Add Slack app**. Create an app from scratch in Slack, or open an existing app your organization controls. Copy its app ID, client ID, client secret and signing secret from **Basic Information → App Credentials**, then save them in LibreChat. Credentials are write-only and encrypted; other members cannot read them back. -2. Expand **Configure these URLs in your Slack app**. Apply the displayed manifest under Slack’s **App Manifest**, including its scopes and event subscriptions. Turn Socket Mode off and configure the displayed OAuth redirect, Events API and Interactivity URLs. Copy the exact URLs: event and interaction callbacks contain your organization and app IDs. Saving the app first lets Slack verify the event URL before workspace installation. If Slack reports that the manifest’s event URL is not verified, choose **Click here to verify**, wait for verification to succeed, and finish saving the Slack settings. -3. Keep token rotation and organization-wide installation disabled. Workspace bot grants, including individual workspaces in Enterprise Grid, are supported. To install into other workspaces, complete Slack’s [distribution setup](https://docs.slack.dev/app-management/distribution/). Slack workspace approval policies still apply. -4. Each organization may register multiple apps and install each app into multiple workspaces. Use **Replace credentials** after a Slack credential rotation. A stale edit or pending authorization cannot overwrite a newer registration; refresh before retrying a conflicted edit. +Complete [operator setup](#one-time-operator-setup) first. The gateway must be running and reachable over public HTTPS before Slack can verify its callback. A Slack app is the bot's identity and credentials; its workspace installation is the grant that lets it operate in a particular Slack workspace. LibreChat supports **one active workspace per registered app**. Use separate Slack apps for additional workspaces. + +1. Open [Your Apps](https://api.slack.com/apps) in Slack and create an app from scratch (**Pick features** in the current dashboard, or **Blank app** in Slack’s quickstart). Give it a name and select the workspace where you will manage it. You can instead use an existing app your organization controls. Do not install it yet; finish its settings below first. +2. In LibreChat, open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. Copy **App ID**, **Client ID**, **Client Secret**, and **Signing Secret** from that app's **Basic Information → App Credentials**. The optional **Name** identifies the app in LibreChat; it does not rename the bot in Slack. Save the registration. Secrets are encrypted and cannot be read back. +3. Turn **Socket Mode off** in that Slack app before configuring HTTP callbacks. Expand the saved app in LibreChat and open the gear button, **Connection settings**. Configure all three copied URLs in that same Slack app: + + | LibreChat value | Slack setting | + | --- | --- | + | OAuth redirect URL | **OAuth & Permissions → Redirect URLs**; add the URL and save | + | Events URL | **Event Subscriptions → Enable Events** on; paste into **Request URL** and wait for **Verified** | + | Interactivity URL | **Interactivity & Shortcuts → Interactivity** on; paste into **Request URL** and save | + + Copy the exact URLs, including application base paths and organization/app suffixes. Saving the credentials first lets the gateway authenticate Slack's verification request before installation. If verification fails, check the matching signing secret, public gateway address, and running gateway before continuing. +4. Under **OAuth & Permissions → Bot Token Scopes**, add all seven scopes below. No user-token scopes are required: + + ```text + app_mentions:read + chat:write + reactions:read + reactions:write + files:write + im:write + im:history + ``` + +5. Under **Event Subscriptions → Subscribe to bot events**, add `app_mention`, `message.im`, `reaction_added`, `reaction_removed`, `app_uninstalled`, and `tokens_revoked`, then save. The last two require no additional OAuth scopes. The optional [native Agent sessions](#native-agent-ui-and-final-replies) setup additionally uses `agent_session_stopped`. +6. Under **App Home**, enable the **Messages tab** and allow users to send messages from it so direct messages can reach the bot. Leave token rotation and organization-wide installation disabled. Workspace approval policies still apply. + +These are manual Slack settings; LibreChat's organization app screen does not generate a manifest or create the Slack app for you. See Slack's [app setup](https://docs.slack.dev/app-management/quickstart-app-settings/) and [interactive request setup](https://docs.slack.dev/interactivity/handling-user-interaction/) for its dashboard controls. + +Use the pencil button, **Edit App**, to change its friendly name or credentials later. Leaving a secret blank preserves its saved value; clearing **Name** removes the custom LibreChat name. Changing the client ID requires entering the corresponding client secret again. The saved app ID cannot be edited: register another app for a different ID. After adding Slack scopes to an installed app, reconnect it through LibreChat and approve the updated grant; changing app settings alone does not upgrade existing tokens. A conflicted edit requires refreshing the registration before retrying. + +The organization flow does **not** ask you to paste a bot token or an app-level token. A bot token beginning `xoxb-` is used only by [manual connection activation](#set-up-a-manual-slack-app-connection); an app-level token beginning `xapp-` is used only by the manual Socket Mode gateway. Neither is the client secret, signing secret, or `CHANNEL_SERVICE_TOKEN`. ### Connect and use a workspace -1. Under the registered app, select **Connect a Slack workspace**. Approve installation in Slack. Cancel from LibreChat if you do not want to finish; closing Account settings retires an unfinished attempt. -2. In **Organization Slack workspaces**, an administrator selects **Manage bot access** on the connected workspace and adds the LibreChat users who may manage that bot. Grants apply to this app/workspace installation; they do not grant Agent access, Slack credentials or installation-administration rights. Only administrators can change the manager list. -3. As a bot manager, save an Agent you have permission to share, then open **Channels → Add → Organization workspace** and choose an available workspace. You still need permission to use Remote Agents. Only bots you can manage are offered; installation administrators can also assign agents. -4. Choose **Default for this bot** for that bot’s new direct messages and mentions without a channel-specific assignment, or select **For a specific channel** and enter its Slack channel ID. These choices affect the selected Slack bot, not other bots in the workspace. If another connection is already assigned, a bot manager or administrator can select **Replace default agent** or **Replace channel agent**, review the confirmation dialog, then confirm. The dialog names the current Agent only when you can view it. Existing conversations keep their original Agent. -5. Select **Assign agent** for an unassigned destination, invite the bot to the Slack channel and mention it, or send it a direct message. Each member follows **Link your account**, signs into LibreChat, accepts there, then confirms from the same Slack account. Requests use that member's current Agent and tool permissions; installation does not authorize tools or grant offline access to connected services. +1. Under the registered app, select **Add to workspace** and approve installation in Slack. LibreChat shows a **Connecting to Slack…** dialog while this is pending. Use **Cancel** there to abandon the attempt, or **Retry** after a failure. On success, the dialog closes and the workspace appears as **Connected** below the app. Each app can have only one active workspace; reconnect that workspace to refresh its grant, or disconnect it before installing the app elsewhere. +2. An administrator opens the workspace's users button, **Manage access**, and adds the LibreChat users allowed to assign agents through that bot. The dialog is titled **Manage bot access**. Without explicit managers, administrators can still assign agents. These grants do not grant Agent sharing permission, Slack credentials, or installation-administration rights, and are not required just to talk to the bot. +3. Save an Agent you have permission to share. In the Agent builder's **Channels** section, select **Add Slack channel**, choose the **Slack bot**, then **Continue**. You need Remote Agents permission as well as permission to share the Agent. The picker offers only bots you can manage; installation administrators can also assign agents. +4. Choose **Default** for new direct messages and mentions without a channel-specific assignment, or choose **Channel Specific** and enter the **Slack channel ID**. Find the ID in Slack's channel details; it is not the channel name. Select **Assign agent**. If already assigned, **Replace default agent** or **Replace channel agent** opens a confirmation. The current Agent is named only when you can view it. Existing conversations keep their original Agent. +5. In Slack, invite the bot to your test channel, for example `/invite @YourBot`, then mention it with `@YourBot hello`. Installing the app alone does not add it to every channel. You can also send a direct message when the Messages tab is enabled. +6. Follow the private **Link your account** prompt. Sign into the intended LibreChat account, inspect the request, and accept it in the browser. Return to Slack and mention the bot again if no confirmation prompt is present. Confirm the account from that **same Slack account**, then send a **fresh request** to the bot. The original request is not replayed automatically. + +A successful first response completes setup. Each person repeats the personal linking step and runs with their own current Agent permissions, tool credentials, and approvals. Sharing a Slack thread does not lend another participant's MCP connection or authority. To verify tool access, ask for a task using a tool that the linked account is permitted to use, and complete any required approval as that account. + +#### If the bot does not respond + +| Symptom | Check | +| --- | --- | +| Events URL will not verify, or Slack callbacks return `401` | Gateway is running and publicly reachable over HTTPS; URL matches the saved organization/app; **Signing Secret** belongs to that same Slack app. Check clock synchronization against the signature window. Do not disable signature checks. | +| Gateway calls to LibreChat return `401` | API and gateway use the same private `CHANNEL_SERVICE_TOKEN`, and `LIBRECHAT_INTERNAL_URL` reaches the intended LibreChat instance. This is separate from Slack signature verification. | +| Mention produces no response | Check gateway readiness and logs, **Socket Mode off**, **Events on** with the subscriptions above, bot invited to the channel, and an Agent assigned to this bot/destination. Confirm the sender's personal link is active. | +| Confirmation, approval, or Stop buttons do nothing | **Interactivity** is on, its exact Request URL is saved, and the gateway is reachable. The Events URL does not substitute for the Interactivity URL. | +| Link says **Awaiting confirmation** | Browser acceptance is incomplete until that same Slack account confirms in Slack. Mention again to obtain the prompt, confirm, then send a new request. | +| Installation reports missing permissions after scopes changed | Add all required bot scopes, then reconnect through LibreChat and approve the updated grant. Existing installations do not receive new scopes automatically. | + +Use the same Compose project and overlays from operator setup when checking `ps` and `logs --tail=100 api channel-gateway`. A healthy application alone does not prove the separate gateway is ready. See [gateway readiness checks](#docker-compose). ### Disconnect and remove -- Administrators revoke bot management under **Manage bot access**. Removed managers cannot create or change assignments, but can still remove assignments or delete their own Agent connection. Existing assignments and conversations keep running; management access is separate from permission to talk to the bot. Disconnecting a workspace clears its manager grants; a fresh installation requires new grants. Reauthorizing an active installation preserves managers. +- Administrators revoke bot management through the workspace’s **Manage access** users button. Removed managers cannot create or change assignments, but can still remove assignments or delete their own Agent connection. Existing assignments and conversations keep running; management access is separate from permission to talk to the bot. Disconnecting a workspace clears its manager grants; a fresh installation requires new grants. Reauthorizing an active installation preserves managers. -- **Agent Builder → Channels → Manage connection** lists current assignments. Select **Add assignment** to configure another destination, or **Remove** beside an assignment and confirm **Remove assignment** to stop using it for new conversations. Select **Delete connection** and confirm to remove the connection and all its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. -- **Settings → Account → Your channel account links** lets a member revoke their own identity link. -- **Settings → Account → Organization Slack workspaces → Disconnect workspace** retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. -- After disconnecting an app’s active workspaces, select **Remove app** and confirm to delete its saved app credentials. This does not delete the Slack app itself. +- **Agent Builder → Channels → Manage connection** lists current assignments. When another destination is available, select **Add assignment** to configure it, or **Remove** beside an assignment and confirm **Remove assignment** to stop using it for new conversations. Select **Delete connection** and confirm to remove the connection and all its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. +- **Settings → Account → Your channel account links** shows personal links once any exist. Status pills distinguish **In progress**, **Awaiting confirmation**, **Active**, **Revoked**, **Expired**, and **Unavailable**. Select **Revoke link** and confirm to withdraw your own consent, including an unavailable link. Completed actions are not undone. +- **Settings → Account → Slack → Manage**, then the workspace’s **Disconnect workspace** icon retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. +- After disconnecting an app’s active workspace, use the app’s trash button, **Remove app**, and confirm to delete its saved app credentials. This does not delete the Slack app itself. - Removing the configuring person does not delete the organization's installation. Their personal links and credentials are cleaned up, and their Agent connections are retired through the normal channel cleanup. - To stop the optional service, run the same Compose file list and project with `stop channel-gateway`, or set `channelGateway.enabled: false` and remove the shared opt-in from Helm/API configuration. Ordinary LibreChat can continue. Database topology is independent: do not remove an external replica configuration or convert existing data merely to stop the gateway. ## Set up a manual Slack app connection -1. Save the Agent, then select **Channels → Add** in the Agent builder. Choose per-user or owner-only mode and continue. You need permission to share the Agent. +1. Save the Agent, then select **Channels → Add Slack channel** in the Agent builder. Choose per-user or owner-only mode and continue. You need permission to share the Agent. 2. Copy the read-only Slack app manifest into Slack's app setup and install the app into your workspace. Make any app changes in Slack's app settings. 3. Under **Add Credentials**, enter the matching Slack app ID and bot token. For webhooks, also enter its signing secret. Activate the connection. LibreChat verifies the bot identity and stores credentials encrypted; normal setup responses do not return those secrets. 4. Copy the connection ID from the connection details. Configure and start the gateway as described below. It must be able to reach the active connection before startup can complete. @@ -228,9 +273,9 @@ The process exposes `/livez` for HTTP-process liveness, `/readyz` and `/healthz` By default, a stable working message provides Stop and, when needed, Review controls. Answers are posted after generation, rather than repeatedly replacing a growing reply. Formatting includes code, tables, links, file attachments, and qualified cost/time details; unavailable costs are not estimated. -To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope and `agent_session_stopped` event subscription, and reinstall the app. These are additional to the basic generated manifest. Then set `endpoints.agents.channels.nativeSessions: true` in `librechat.yaml`. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. +To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope and `agent_session_stopped` event subscription, and reinstall the app. These are additional to the basic bot configuration above. Then set `endpoints.agents.channels.nativeSessions: true` in `librechat.yaml`. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. -Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already present in the basic manifest. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. +Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already listed in the basic bot scopes. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. ## Kubernetes and Helm @@ -461,4 +506,4 @@ Disabling a channel or changing its credential mode retires old authority; it do With the process-local job store, restarting the API while a tool approval is pending makes the review unavailable. The request stays held for reconciliation and a stale approval does not execute the tool. Durable checkpoint storage alone does not recreate the missing live execution state. Completed history and subsequent thread continuation survive restart. -The gateway package is built from the LibreChat source tree; it is not published as an npm package. This integration does not promise arbitrary chat-platform support, automatic migration of legacy thread-wide identity, or restart-survival of an in-memory OAuth waiter. A restart can require a new browser sign-in; uncertain continuation must not be reported as completed or retried as new work. Legacy thread read/write bookkeeping is not a substitute for actor-scoped runs. +The gateway package is built from the LibreChat source tree; it is not published as an npm package. This integration does not promise arbitrary chat-platform support or restart-survival of an in-memory OAuth waiter. A restart can require a new browser sign-in; uncertain continuation must not be reported as completed or retried as new work. diff --git a/content/docs/features/agents_api.mdx b/content/docs/features/agents_api.mdx index e666f0fee..3eaef7297 100644 --- a/content/docs/features/agents_api.mdx +++ b/content/docs/features/agents_api.mdx @@ -22,12 +22,6 @@ For opt-in asynchronous execution, retained human actions, owner review, and Sto Open **Settings**, go to **Data & Privacy**, and find **Agent API Keys** under **API keys**. Click **Manage**, then **Create API Key**, give it a name, pick an expiration (7 days up to 1 year, or never), and copy the key right away: it is shown only once. - - A key acts as you. Anything you can reach through the API, anyone holding the key can reach too, so delete keys you no longer use. Deleting a key cuts off applications using it immediately. If you do not see the section, your role has not been given access to the Agents API. From 5fb6f50275a85cac40f417974adb66176bc77baa Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 10 Nov 2026 01:20:19 -0800 Subject: [PATCH 27/38] =?UTF-8?q?=F0=9F=93=9A=20docs:=20Clarify=20Slack=20?= =?UTF-8?q?Connection=20Reactivation=20Consent?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/docs/features/agent_channels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 96d7742da..eba2ab3d7 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -139,7 +139,7 @@ Use the same Compose project and overlays from operator setup when checking `ps` - Administrators revoke bot management through the workspace’s **Manage access** users button. Removed managers cannot create or change assignments, but can still remove assignments or delete their own Agent connection. Existing assignments and conversations keep running; management access is separate from permission to talk to the bot. Disconnecting a workspace clears its manager grants; a fresh installation requires new grants. Reauthorizing an active installation preserves managers. -- **Agent Builder → Channels → Manage connection** lists current assignments. When another destination is available, select **Add assignment** to configure it, or **Remove** beside an assignment and confirm **Remove assignment** to stop using it for new conversations. Select **Delete connection** and confirm to remove the connection and all its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. +- **Agent Builder → Channels → Manage connection** lists current assignments. When another destination is available, select **Add assignment** to configure it, or **Remove** beside an assignment and confirm **Remove assignment** to stop using it for new conversations. Select **Delete connection** and confirm to remove the connection and all its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. To resume, select **Activate channel** and confirm the retained assignment. Each sender must link and confirm their account again after reactivation. - **Settings → Account → Your channel account links** shows personal links once any exist. Status pills distinguish **In progress**, **Awaiting confirmation**, **Active**, **Revoked**, **Expired**, and **Unavailable**. Select **Revoke link** and confirm to withdraw your own consent, including an unavailable link. Completed actions are not undone. - **Settings → Account → Slack → Manage**, then the workspace’s **Disconnect workspace** icon retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. - After disconnecting an app’s active workspace, use the app’s trash button, **Remove app**, and confirm to delete its saved app credentials. This does not delete the Slack app itself. From fac552521d05e791a2351c68a3d17f3169fb7209 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 10 Nov 2026 01:47:18 -0800 Subject: [PATCH 28/38] =?UTF-8?q?=F0=9F=9B=A0=EF=B8=8F=20ci:=20Pin=20Brows?= =?UTF-8?q?er=20Jobs=20to=20Supported=20Ubuntu?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/ci.yml | 3 ++- .github/workflows/update-screenshots.yml | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 401cf08e1..f3274c8b5 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -59,7 +59,8 @@ jobs: e2e: name: End-to-end tests - runs-on: ubuntu-latest + # Match the Ubuntu version supported by the locked Playwright browsers. + runs-on: ubuntu-24.04 steps: - uses: actions/checkout@v4 diff --git a/.github/workflows/update-screenshots.yml b/.github/workflows/update-screenshots.yml index d14b945c6..8e91d7391 100644 --- a/.github/workflows/update-screenshots.yml +++ b/.github/workflows/update-screenshots.yml @@ -16,7 +16,8 @@ permissions: jobs: screenshots: name: Capture and open PR - runs-on: ubuntu-latest + # Match the Ubuntu version supported by the locked Playwright browsers. + runs-on: ubuntu-24.04 environment: Production steps: - uses: actions/checkout@v4 From b261cbcab1d99b065cd54b94b04062238294e897 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 10 Nov 2026 13:59:40 -0800 Subject: [PATCH 29/38] docs: Align Slack Setup With the Tested Linking Flow --- content/docs/features/agent_channels.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index eba2ab3d7..24b1d6fa9 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -79,7 +79,7 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in Complete [operator setup](#one-time-operator-setup) first. The gateway must be running and reachable over public HTTPS before Slack can verify its callback. A Slack app is the bot's identity and credentials; its workspace installation is the grant that lets it operate in a particular Slack workspace. LibreChat supports **one active workspace per registered app**. Use separate Slack apps for additional workspaces. -1. Open [Your Apps](https://api.slack.com/apps) in Slack and create an app from scratch (**Pick features** in the current dashboard, or **Blank app** in Slack’s quickstart). Give it a name and select the workspace where you will manage it. You can instead use an existing app your organization controls. Do not install it yet; finish its settings below first. +1. Open [Your Apps](https://api.slack.com/apps) in Slack and create an app from scratch (**Pick features** in the current dashboard, or **Blank app** in Slack’s quickstart). Give it a name and select the workspace where you will manage it. In the **Pick features** wizard, continue without adding scopes or events, then select **Create → Create Anyway**. Configure those features after registering the app in LibreChat below. You can instead use an existing app your organization controls. Do not install it yet. 2. In LibreChat, open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. Copy **App ID**, **Client ID**, **Client Secret**, and **Signing Secret** from that app's **Basic Information → App Credentials**. The optional **Name** identifies the app in LibreChat; it does not rename the bot in Slack. Save the registration. Secrets are encrypted and cannot be read back. 3. Turn **Socket Mode off** in that Slack app before configuring HTTP callbacks. Expand the saved app in LibreChat and open the gear button, **Connection settings**. Configure all three copied URLs in that same Slack app: @@ -113,12 +113,12 @@ The organization flow does **not** ask you to paste a bot token or an app-level ### Connect and use a workspace -1. Under the registered app, select **Add to workspace** and approve installation in Slack. LibreChat shows a **Connecting to Slack…** dialog while this is pending. Use **Cancel** there to abandon the attempt, or **Retry** after a failure. On success, the dialog closes and the workspace appears as **Connected** below the app. Each app can have only one active workspace; reconnect that workspace to refresh its grant, or disconnect it before installing the app elsewhere. +1. Under the registered app, select **Add to workspace**. If Slack asks where to install, choose **A workspace** and the intended workspace, then approve installation. LibreChat shows a **Connecting to Slack…** dialog while this is pending. Use **Cancel** there to abandon the attempt, or **Retry** after a failure. On success, the dialog closes and the workspace appears as **Connected** below the app. Each app can have only one active workspace; reconnect that workspace to refresh its grant, or disconnect it before installing the app elsewhere. 2. An administrator opens the workspace's users button, **Manage access**, and adds the LibreChat users allowed to assign agents through that bot. The dialog is titled **Manage bot access**. Without explicit managers, administrators can still assign agents. These grants do not grant Agent sharing permission, Slack credentials, or installation-administration rights, and are not required just to talk to the bot. 3. Save an Agent you have permission to share. In the Agent builder's **Channels** section, select **Add Slack channel**, choose the **Slack bot**, then **Continue**. You need Remote Agents permission as well as permission to share the Agent. The picker offers only bots you can manage; installation administrators can also assign agents. 4. Choose **Default** for new direct messages and mentions without a channel-specific assignment, or choose **Channel Specific** and enter the **Slack channel ID**. Find the ID in Slack's channel details; it is not the channel name. Select **Assign agent**. If already assigned, **Replace default agent** or **Replace channel agent** opens a confirmation. The current Agent is named only when you can view it. Existing conversations keep their original Agent. 5. In Slack, invite the bot to your test channel, for example `/invite @YourBot`, then mention it with `@YourBot hello`. Installing the app alone does not add it to every channel. You can also send a direct message when the Messages tab is enabled. -6. Follow the private **Link your account** prompt. Sign into the intended LibreChat account, inspect the request, and accept it in the browser. Return to Slack and mention the bot again if no confirmation prompt is present. Confirm the account from that **same Slack account**, then send a **fresh request** to the bot. The original request is not replayed automatically. +6. Select **Link account** in the bot's private message. Sign into the intended LibreChat account, inspect the request, and accept it in the browser. The original Slack message changes to show the account name and **Confirm account**. Return to that message and confirm from the **same Slack account**. Once it shows **Account connected**, send a **fresh request** to the bot; the original request is not replayed automatically. If the confirmation does not appear, mention the bot again to recover the prompt. A successful first response completes setup. Each person repeats the personal linking step and runs with their own current Agent permissions, tool credentials, and approvals. Sharing a Slack thread does not lend another participant's MCP connection or authority. To verify tool access, ask for a task using a tool that the linked account is permitted to use, and complete any required approval as that account. @@ -130,7 +130,7 @@ A successful first response completes setup. Each person repeats the personal li | Gateway calls to LibreChat return `401` | API and gateway use the same private `CHANNEL_SERVICE_TOKEN`, and `LIBRECHAT_INTERNAL_URL` reaches the intended LibreChat instance. This is separate from Slack signature verification. | | Mention produces no response | Check gateway readiness and logs, **Socket Mode off**, **Events on** with the subscriptions above, bot invited to the channel, and an Agent assigned to this bot/destination. Confirm the sender's personal link is active. | | Confirmation, approval, or Stop buttons do nothing | **Interactivity** is on, its exact Request URL is saved, and the gateway is reachable. The Events URL does not substitute for the Interactivity URL. | -| Link says **Awaiting confirmation** | Browser acceptance is incomplete until that same Slack account confirms in Slack. Mention again to obtain the prompt, confirm, then send a new request. | +| Link says **Awaiting confirmation** | Return to the bot's private message and select **Confirm account** from the same Slack account. If the message did not update, mention the bot again to recover the prompt. After confirmation, send a new request. | | Installation reports missing permissions after scopes changed | Add all required bot scopes, then reconnect through LibreChat and approve the updated grant. Existing installations do not receive new scopes automatically. | Use the same Compose project and overlays from operator setup when checking `ps` and `logs --tail=100 api channel-gateway`. A healthy application alone does not prove the separate gateway is ready. See [gateway readiness checks](#docker-compose). From 0b55e9567fdf4cc976da06d217fcd09999a7d3b0 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 10 Nov 2026 19:06:46 -0800 Subject: [PATCH 30/38] docs: Clarify Slack Secret Copying And Account Confirmation --- content/docs/features/agent_channels.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 24b1d6fa9..20278498e 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -80,7 +80,7 @@ No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in Complete [operator setup](#one-time-operator-setup) first. The gateway must be running and reachable over public HTTPS before Slack can verify its callback. A Slack app is the bot's identity and credentials; its workspace installation is the grant that lets it operate in a particular Slack workspace. LibreChat supports **one active workspace per registered app**. Use separate Slack apps for additional workspaces. 1. Open [Your Apps](https://api.slack.com/apps) in Slack and create an app from scratch (**Pick features** in the current dashboard, or **Blank app** in Slack’s quickstart). Give it a name and select the workspace where you will manage it. In the **Pick features** wizard, continue without adding scopes or events, then select **Create → Create Anyway**. Configure those features after registering the app in LibreChat below. You can instead use an existing app your organization controls. Do not install it yet. -2. In LibreChat, open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. Copy **App ID**, **Client ID**, **Client Secret**, and **Signing Secret** from that app's **Basic Information → App Credentials**. The optional **Name** identifies the app in LibreChat; it does not rename the bot in Slack. Save the registration. Secrets are encrypted and cannot be read back. +2. In LibreChat, open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. Copy **App ID**, **Client ID**, **Client Secret**, and **Signing Secret** from that app's **Basic Information → App Credentials**. Select **Show** beside each secret before copying; the masked dots are not the secret. The optional **Name** identifies the app in LibreChat; it does not rename the bot in Slack. Save the registration. Secrets are encrypted and cannot be read back. 3. Turn **Socket Mode off** in that Slack app before configuring HTTP callbacks. Expand the saved app in LibreChat and open the gear button, **Connection settings**. Configure all three copied URLs in that same Slack app: | LibreChat value | Slack setting | @@ -418,7 +418,7 @@ Each actor/link revision has its own execution lane. Sharing a Slack thread does ### Account linking -On the first mention, the gateway sends the actor a private linking prompt. Open its trusted LibreChat URL, sign in, preview the request, and accept it. Return to Slack and mention the bot again to receive the exact-account confirmation, then confirm it there. The next mention can run. The gateway does not replay the original request after linking, and browser acceptance alone does not activate the link. +On the first mention, the gateway sends the actor a private linking prompt. Open its trusted LibreChat URL, sign in, preview the request, and accept it. The same private Slack message updates to show the account name and **Confirm account**. Confirm it from the same Slack account, then send a fresh request once it shows **Account connected**. If the prompt has expired or does not update, mention the bot again to recover it. The gateway does not replay the original request after linking, and browser acceptance alone does not activate the link. Manage and revoke your links in Account settings. A link can become unavailable when the channel or account is no longer eligible; you can still withdraw that consent. Restoring eligibility does not reactivate a link you explicitly revoked. From 9c4723bf411de58f0c732f496023577712eb1df5 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 12:14:51 -0800 Subject: [PATCH 31/38] docs: align Slack Channels with current setup and site conventions --- .../docs/configuration/channel_gateway.mdx | 294 +++++++++ .../channel_gateway_reference.mdx | 155 +++++ .../object_structure/agents.mdx | 4 +- content/docs/configuration/meta.de.json | 2 + content/docs/configuration/meta.es.json | 2 + content/docs/configuration/meta.fr.json | 2 + content/docs/configuration/meta.id.json | 2 + content/docs/configuration/meta.it.json | 2 + content/docs/configuration/meta.ja.json | 2 + content/docs/configuration/meta.json | 2 + content/docs/configuration/meta.ko.json | 2 + content/docs/configuration/meta.nl.json | 2 + content/docs/configuration/meta.pl.json | 2 + content/docs/configuration/meta.pt-BR.json | 2 + content/docs/configuration/meta.tr.json | 2 + content/docs/configuration/meta.vi.json | 2 + content/docs/configuration/meta.zh.json | 2 + content/docs/features/agent_channels.mdx | 563 +++++------------- .../docs/features/background_responses.mdx | 2 +- .../agent_channels/account-accepted-dark.jpg | Bin 0 -> 37276 bytes .../agent_channels/account-accepted-light.jpg | Bin 0 -> 39699 bytes .../agent_channels/manual-create-dark.png | Bin 0 -> 47794 bytes .../agent_channels/manual-create-light.png | Bin 0 -> 48459 bytes .../org-app-registration-dark.jpg | Bin 0 -> 13489 bytes .../org-app-registration-light.jpg | Bin 0 -> 14725 bytes .../agent_channels/org-assignment-dark.jpg | Bin 0 -> 15776 bytes .../agent_channels/org-assignment-light.jpg | Bin 0 -> 15838 bytes 27 files changed, 617 insertions(+), 429 deletions(-) create mode 100644 content/docs/configuration/channel_gateway.mdx create mode 100644 content/docs/configuration/channel_gateway_reference.mdx create mode 100644 public/images/features/agent_channels/account-accepted-dark.jpg create mode 100644 public/images/features/agent_channels/account-accepted-light.jpg create mode 100644 public/images/features/agent_channels/manual-create-dark.png create mode 100644 public/images/features/agent_channels/manual-create-light.png create mode 100644 public/images/features/agent_channels/org-app-registration-dark.jpg create mode 100644 public/images/features/agent_channels/org-app-registration-light.jpg create mode 100644 public/images/features/agent_channels/org-assignment-dark.jpg create mode 100644 public/images/features/agent_channels/org-assignment-light.jpg diff --git a/content/docs/configuration/channel_gateway.mdx b/content/docs/configuration/channel_gateway.mdx new file mode 100644 index 000000000..8c8a780ff --- /dev/null +++ b/content/docs/configuration/channel_gateway.mdx @@ -0,0 +1,294 @@ +--- +title: Slack Channel Gateway +description: Deploy the Slack gateway for organization workspaces or a manually configured connection. +icon: MessagesSquare +--- + +The Slack gateway connects LibreChat to Slack. It runs separately from the application. This page covers deployment; [Agent Channels](/docs/features/agent_channels) covers connecting apps, assigning agents, and using them in Slack. + + +Use matching LibreChat and gateway releases that include Channels. Ordinary LibreChat does not need the gateway; enabling Channels requires a transaction-capable database and the indexes described below. + + +## Configuration and prerequisites + +Choose [organization workspaces](#organization-workspaces) for Slack apps managed in LibreChat. Use a [manual connection](#run-the-slack-gateway) when you need a gateway bound to one app and connection. Shared mode serves multiple installations; it does not share users' accounts or tool credentials. + +Both modes need: + +- A verified transaction-capable database with the indexes below. +- Role permissions to use Agents and query them through Remote Agents (API) for participants, plus Agent sharing or administrator management access for setup. Sharing does not require permission to edit the Agent. +- API-key authentication enabled for the gateway's bound execution credential. +- A private `CHANNEL_SERVICE_TOKEN`, identical in the API and gateway. Keep it server-side; it is neither a browser token nor a general Agent API key. +- A trusted `DOMAIN_CLIENT` for account-link and owner-review URLs. Organization workspaces also require the public HTTPS addresses described below. + +Linking an account does not grant Agent access, new tools or offline access to connected services. See the [channel configuration reference](/docs/configuration/librechat_yaml/object_structure/agents#channels) for policy limits and defaults. + +### Database requirement + +Durable Channels and stored background Responses require MongoDB transactions. Use a MongoDB replica set or another verified transaction-capable deployment. Standalone MongoDB and FerretDB 2.7 can run ordinary LibreChat, but cannot enable this durable feature. Unsupported channel writes return `transactions_unavailable`; the Agent builder explains the setup requirement. Transactional reads use the primary even when the connection normally prefers secondary reads. The database must also support the required indexes, including partial indexes; transaction support by itself is not sufficient. [Amazon DocumentDB 4.0 lacks partial-index support](https://docs.aws.amazon.com/documentdb/latest/devguide/indexes-single-field.html) and cannot run this gateway. Other MongoDB-compatible engines need their own compatibility validation. + +## Organization workspaces + +Use this mode for organization-owned Slack apps managed in LibreChat. An operator deploys one shared gateway; organization administrators then register apps and install workspaces through [Account settings](/docs/features/agent_channels#organization-workspaces). Each app supports one active workspace. No per-workspace gateway process or deployment secret is needed. + +### One-time operator setup + +1. Meet the [prerequisites](#configuration-and-prerequisites), including transaction-capable MongoDB and a private service token. Generate a token with `openssl rand -hex 32`. +2. Configure public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT`, replacing the localhost defaults in `.env`. Both are required and must have no surrounding whitespace. Include the application base path when present. If callbacks use a separate public origin, set `SLACK_GATEWAY_URL` to it. Otherwise callbacks use `DOMAIN_SERVER`; route the Slack paths on that origin to the gateway. The shared deployment opt-in rejects local addresses. +3. Route `/slack/events/` and `/slack/interactions/`, including their organization/app suffixes, to the gateway. Its container listens on port 8080; the shared Compose overlay publishes it at `127.0.0.1:3081` for a host-level HTTPS proxy. Route the application and OAuth callback to LibreChat. Keep gateway health and metrics private. The deployment operator does not need Slack dashboard access or app credentials. + +For Docker Compose with a separate gateway origin, use the normal uncommitted `.env`: + +```dotenv filename=".env" +SLACK_GATEWAY_URL=https://slack.example.com +CHANNEL_SERVICE_TOKEN= +DOMAIN_SERVER=https://chat.example.com +DOMAIN_CLIENT=https://chat.example.com +LIBRECHAT_IMAGE_TAG= +``` + +From a fresh LibreChat setup with `.env` and `librechat.yaml` prepared, start the release-matched application and shared gateway: + +```sh +docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.slack-workspaces.yml -f docker-compose.mongo-replica.yml \ + --profile channels up -d api meilisearch channel-gateway +``` + +The replica overlay is for a **fresh local database**; read [Existing local data](#existing-local-data) before converting an existing installation. Omit that overlay when you already use a verified transaction-capable external database and supply its normal connection configuration. Use the same Compose project and files for subsequent commands. This does not configure a public reverse proxy or a trusted certificate. A host-level proxy forwards the two Slack paths to `http://127.0.0.1:3081`, preserving the organization/app suffixes. Set `CHANNEL_GATEWAY_PORT` in `.env` to change that loopback port. A proxy in the same Compose network can instead forward to `http://channel-gateway:8080`. + +The shared overlay supplies `SLACK_WORKSPACES_ENABLED=true`, which enables webhook Channels, shared app installation and stored background Responses while retaining unrelated YAML policy, limits and explicit API authentication settings. Slack app credentials are entered by organization admins through the UI and stored encrypted; they are not deployment environment variables or YAML fields. With the flag unset or false, YAML continues to control the feature. Choosing shared setup changes the deployment's channel transport to webhook; existing bound connections must use matching webhook configuration. Manual Socket Mode remains available when using the manual setup instead. + +No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in shared mode. The gateway receives its service token and private runtime policy; app client credentials stay in LibreChat, and installed bot tokens are encrypted in the database. For an unreleased source checkout, add `docker-compose.channels-build.yml` after `docker-compose.channels.yml` on every command and use `up -d --build` instead of expecting an unpublished release image. + +After startup, [verify the gateway](#verify-the-gateway), then return to [app registration](/docs/features/agent_channels#organization-workspaces). + +## Run the Slack gateway + +Use this manual setup for one tenant and connection. First enable Channels and background Responses in `librechat.yaml`; both default to `false`: + +```yaml filename="endpoints / agents" +endpoints: + agents: + remoteApi: + background: + enabled: true + channels: + enabled: true + transport: socket_mode +``` + +The `transport` option accepts `socket_mode` (default) or `webhook`. Manual connections generate a matching Slack manifest; organization workspaces use the [webhook setup above](#organization-workspaces). Selecting a transport does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. The gateway loads this policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is an optional deployment assertion; if supplied, it must match the server-selected mode. Missing or unsupported gateway policy prevents startup. + +Create and activate the [manual Slack connection](/docs/features/agent_channels#set-up-a-manual-slack-app-connection) before starting its gateway. The connection ID is needed below. For a container deployment, skip to [Docker Compose](#docker-compose); a source process requires Node.js 24+. + +### From source + +The gateway uses Slack's official Node SDKs and calls LibreChat over HTTP. It does not connect directly to MongoDB. In shared mode, the same source entry point works without the bound tenant/connection IDs or app-level token; supply the internal API URL and service token instead. + +From a LibreChat source checkout containing `packages/channel-gateway`: + +```sh +npm ci +npm run build:packages +npm run build --workspace @librechat/channel-gateway +node --env-file=/secure/channel-gateway.env packages/channel-gateway/dist/main.cjs +``` + +`npm run backend:dev` starts only LibreChat; it does not start the gateway. Build the application using LibreChat's normal development setup and run the gateway separately. If you reuse the application's `.env`, set the gateway port explicitly: `PORT=8080 node --env-file=.env packages/channel-gateway/dist/main.cjs`. This avoids binding the gateway to the application's port. + +Supply the environment file through your normal secret-management process. Do not commit it. A Socket Mode configuration is: + +```dotenv filename="channel-gateway.env" +LIBRECHAT_INTERNAL_URL=http://127.0.0.1:3080 +CHANNEL_SERVICE_TOKEN= +CHANNEL_TENANT_ID=_ +CHANNEL_ID= +SLACK_TRANSPORT=socket_mode +SLACK_APP_TOKEN= +``` + +`LIBRECHAT_INTERNAL_URL` must be reachable from the gateway process. For example, `127.0.0.1` refers to the gateway's own container when running inside a container. Use the exact tenant ID for a multi-tenant deployment; use `_` only for a single-tenant deployment without a tenant ID. The gateway obtains the bot token and signing secret from LibreChat's authenticated connection bundle, so those values do not need separate gateway environment variables. + +For Socket Mode, enable Socket Mode for the same Slack app and create an app-level token with `connections:write`. Keep that token only in the gateway's secret configuration. No public callback URL is needed, but the gateway needs outbound access to Slack and LibreChat. + +For webhooks, set `SLACK_TRANSPORT=webhook` instead and omit `SLACK_APP_TOKEN`. Put the gateway behind HTTPS and set these Slack request URLs, replacing the placeholders with the configured, URL-encoded IDs: + +```text +Events: https://gateway.example.com/slack/events// +Interactivity: https://gateway.example.com/slack/interactions// +``` + +The webhook receiver verifies Slack signatures using the connection's signing secret. Keep LibreChat's channel service routes private to trusted integrations. Expose only the required Slack callback paths publicly; keep health and metrics endpoints on an internal network. + +### Docker Compose + +The optional `docker-compose.channels.yml` overlay pulls release-matched LibreChat and gateway images. Set `LIBRECHAT_IMAGE_TAG` in `.env` to the release tag you are installing (including `-rcN` for a release candidate); both images use that same tag. If omitted, both use the latest stable release. Images are published for Linux AMD64 and ARM64 when the corresponding LibreChat release is published. A tag predating Agent Channels does not contain a gateway image. The separate `docker-compose.mongo-replica.yml` overlay initializes a single local MongoDB replica member and waits for a writable primary before the application starts. The gateway waits for application health, then authenticates its channel binding and selected Slack transport. Neither service is added to the default stack automatically. + +For a **fresh local database**, run these commands from the LibreChat repository root: + +1. Prepare `.env` and `librechat.yaml` using the normal LibreChat setup and the channel policy above. Set `LIBRECHAT_IMAGE_TAG` to the published LibreChat release containing Channels. Generate a private service token with `openssl rand -hex 32` and set `CHANNEL_SERVICE_TOKEN` in `.env`. Keep the same Compose files and project name on subsequent commands. +2. Pull and start the application and its dependencies: + + ```sh + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml up -d --pull always api meilisearch + ``` + +3. Sign in, save an Agent, and [set up its Slack channel](/docs/features/agent_channels#set-up-a-manual-slack-app-connection). Enter the bot token in the Agent builder. Set `CHANNEL_ID` in `.env` to the resulting connection ID. `CHANNEL_TENANT_ID` defaults to `_` for an ordinary OSS installation; supply the actual tenant ID for a tenant-scoped installation. For Socket Mode, also set `SLACK_APP_TOKEN` to the matching app-level token with `connections:write`. +4. Start the gateway: + + ```sh + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml --profile channels up -d --pull always channel-gateway + ``` + +5. Check readiness and startup errors: + + ```sh + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml --profile channels ps -a + docker compose -f docker-compose.yml -f docker-compose.channels.yml \ + -f docker-compose.mongo-replica.yml --profile channels logs --tail=100 api mongodb-init channel-gateway + ``` + +`mongodb-init` exiting with status 0 is expected. The application and gateway should be running and healthy. A successful Slack credential activation does not prove the gateway is connected: check health and perform a real mention. Missing service/app bindings prevent gateway startup. + +The overlay points `LIBRECHAT_INTERNAL_URL` at `http://api:${PORT:-3080}` on the Compose network. The gateway listens on container port `8080`, with no published host ports. Socket Mode needs no inbound port; webhooks need an HTTPS reverse proxy forwarding the required callback paths to `channel-gateway:8080`. The gateway runs as a non-root user with a read-only filesystem and dropped capabilities. + +For an existing external transaction-capable database, omit the local MongoDB replica overlay and provide the application connection through your normal Compose override. The base Compose file sets the API service's `MONGO_URI`, so changing only `.env` does not replace that service environment entry. Never run the local initializer against an external database. + +A separate gateway environment file can be supplied through `--env-file .env --env-file /secure/channel-gateway.env`. Keep `CHANNEL_SERVICE_TOKEN` identical in LibreChat's own `.env`; Compose substitution does not update the file mounted into the application. + +For development or an unreleased checkout, add `-f docker-compose.channels-build.yml` immediately after `-f docker-compose.channels.yml` on **every** Compose command. This explicitly builds both services from the checkout instead of using release images. Use `up -d --build` instead of `up -d --pull always` on that path. The normal release path needs no local Node.js installation or image build. + +To build only the gateway image, use the repository root as its build context: + +```sh +docker build -f packages/channel-gateway/Dockerfile \ + -t librechat-channel-gateway:local . +``` + +#### Existing local data + +Back up the database, stop LibreChat and every gateway/worker that writes to it, then stop the database before applying the replica overlay. Retain the existing `data-node` directory; do not delete it or remove its volume. Start with that same data directory and the overlays above. Initialization preserves existing documents and only initializes an unconfigured local `rs0` member at `mongodb:27017`. It refuses a different replica configuration rather than silently reconfiguring it. Verify existing users/history before enabling the gateway, and retain the overlay on future restarts. + +A single local replica member enables transactions but does not provide high availability. The overlay follows the base development Compose authentication/network settings; it is not a production replica-set recipe. For authenticated, multi-member or production deployments, use the [MongoDB conversion procedure](https://www.mongodb.com/docs/manual/tutorial/convert-standalone-to-replica-set/) and your deployment's backup/security practices. + +### Gateway settings + +| Environment variable | Default | Purpose | +| --- | --- | --- | +| `PORT` | `8080` | Gateway HTTP port | +| `LISTEN_HOST` | `0.0.0.0` | Listen address; use loopback for a host-only local process | +| `LIBRECHAT_INTERNAL_URL` | `http://localhost:3080` | LibreChat service origin | +| `CHANNEL_SERVICE_TOKEN` | Required | Shared server-side service-boundary token | +| `CHANNEL_TENANT_ID` | Required in manual mode | Exact connection tenant; `_` for single-tenant deployments | +| `CHANNEL_ID` | Required in manual mode | Connection ID, not the Slack channel ID or Agent ID | +| `SLACK_TRANSPORT` | Server policy | Optional assertion: `webhook` or `socket_mode`; must match the server policy | +| `SLACK_APP_TOKEN` | Required for Socket Mode | App-level token for the same Slack app | +| `APP_TITLE` | `LibreChat` | Application name in browser-review button labels, such as “Open in LibreChat” | +| `API_CALL_TIMEOUT_MS` | `10000` | Timeout for individual service and Slack API calls | +| `AGENT_INVOKE_TIMEOUT_MS` | `120000` | Timeout for initial background Response submission, not the full Agent run | + +`SLACK_API_BASE_URL` defaults to `https://slack.com/api/`; leave it unchanged outside controlled tests. Ingress mode, native sessions, lifecycle reactions, signature tolerance and reconnect pacing come from `endpoints.agents.channels` in `librechat.yaml`, not process feature flags. Actor-bound durable execution cannot be disabled. + +## Verify the gateway + +The process exposes `/livez` for HTTP-process liveness, `/readyz` and `/healthz` for startup/transport readiness, and `/metrics` for Prometheus metrics. Keep these routes private. Inspect the gateway's readiness and logs using the same deployment configuration you started it with. For shared Compose, include `docker-compose.slack-workspaces.yml` and any database/build overlays on those commands too. + +An ingress-mode or Socket app-binding mismatch makes the gateway unready. Restart gateway replicas after changing ingress mode or Socket app identity. Credential activation confirms Slack credentials; it does not prove the gateway is connected. Finish with [account linking and a fresh Slack request](/docs/features/agent_channels#account-linking). + +If gateway requests to LibreChat return `401`, check that both processes use the same `CHANNEL_SERVICE_TOKEN` and that `LIBRECHAT_INTERNAL_URL` reaches the intended instance. This is separate from Slack callback signature verification. + +To stop the optional gateway, use the same Compose project and file list with `stop channel-gateway`, or disable `channelGateway.enabled` in Helm and remove the shared API opt-in. Keep the database configuration: stopping the gateway does not require converting or removing its data. + +### Native Agent UI and final replies + +By default, a stable working message provides Stop and, when needed, Review controls. Answers are posted after generation, rather than repeatedly replacing a growing reply. Formatting includes code, tables, links, file attachments, and qualified cost/time details; unavailable costs are not estimated. + +To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope, and verify that `agent_session_stopped` is subscribed. Add that event if missing; the generated manual manifest already includes it, while the [basic organization setup](/docs/features/agent_channels#register-an-organizations-slack-app) does not. Reinstall the app, then set `endpoints.agents.channels.nativeSessions: true` in `librechat.yaml`. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. + +Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already listed in the basic bot scopes. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. + +## Kubernetes and Helm + +The LibreChat Helm chart supports shared workspaces and manual connections. Both require a transaction-capable database; the default standalone database cannot run Channels. See [Helm configuration](/docs/local/helm_chart) for the application's environment, credentials and database setup. + +Enabling the gateway requires an explicit `image.tag` selecting a published LibreChat release containing Channels; the chart refuses to silently use its older application-version default. The gateway image tag defaults to that same selected release. Earlier releases have no gateway image. A custom `channelGateway.image.tag` is available for deliberate image overrides. + +### Shared workspace deployment + +Select a release containing organization workspaces and provide an existing Secret with `CHANNEL_SERVICE_TOKEN`. The service token is shared with LibreChat. No Slack app credentials belong in this Secret: organization admins register their apps in the UI after deployment. Existing explicit API environment entries take precedence over the generated service-token reference. + +The example below selects a replica set for a **fresh bundled MongoDB**. For an existing standalone database, plan and complete its data migration before changing topology; a Helm value does not migrate existing data. For an external transaction-capable database, supply its connection through your normal application configuration and disable the unused bundled database with `mongodb.enabled: false`. Shared mode refuses to render when LibreChat would use a bundled standalone MongoDB; existing external connection overrides remain supported. + +```yaml filename="shared-workspace-values.yaml" +image: + tag: +mongodb: + architecture: replicaset +channelGateway: + enabled: true + mode: shared + replicaCount: 2 + existingSecretName: gateway-service-credentials + ingress: + enabled: true + host: slack.example.com + tls: + - hosts: [slack.example.com] + secretName: slack-gateway-tls +``` + +Set public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT` through the application's normal environment settings. Shared mode supplies the app enablement flag and derives `SLACK_GATEWAY_URL` from its ingress host unless explicitly configured in `librechat.configEnv`. It omits connection IDs, tenant IDs and the Socket Mode token. Shared replicas use rolling updates and the existing durable claims; `mode: single` requires one replica and uses replacement updates. After deployment, organization admins register their apps and configure the displayed Slack URLs through Account settings, then use Agent Builder; no per-workspace Helm values or pods are required. + +### Manual connection deployment + +First upgrade the application to a published release containing Channels with the gateway disabled. Configure the [manual channel policy](#run-the-slack-gateway), then create and activate the connection in the Agent builder. Enable the gateway after obtaining its connection ID: + +```yaml filename="channel-values.yaml" +image: + tag: +channelGateway: + enabled: true + channelId: + tenantId: "_" + # Defaults to global.librechat.existingSecretName. + existingSecretName: librechat-credentials-env +``` + +For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly when the API obtains `APP_TITLE` through a Secret or `global.librechat.env`, or choose a shorter gateway title if the application name is not compatible. Gateway titles must be nonempty after trimming, at most 40 UTF-16 characters, and contain no `<`, `>`, `|` or control characters. Helm rejects incompatible inherited titles before deployment; the application can keep its existing longer name. + +For manual Socket Mode, the existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. + +The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure gateway resources and annotations through `channelGateway`. Pod identity, `enableServiceLinks`, DNS, host aliases, image pull secrets, node selectors, tolerations and affinity follow the chart's shared platform settings. The configured ServiceAccount is reused while the gateway keeps its Kubernetes API token automount disabled. Manual single mode installs one gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. + +For webhook transport, set the server policy to `webhook`, configure its public HTTPS gateway URL and clear `channelGateway.slackAppTokenKey`. Enable the dedicated gateway Ingress using your installed ingress controller and a trusted TLS certificate: + +```yaml filename="channel-values.yaml" +channelGateway: + slackAppTokenKey: "" + ingress: + enabled: true + host: gateway.example.com + # Empty inherits ingress.className; set this for a different controller. + className: nginx + annotations: {} + tls: + - hosts: [gateway.example.com] + secretName: gateway-tls +``` + +Combine these settings with the enabled gateway and explicit application release above. Set the server's `gatewayUrl` to `https://gateway.example.com`, with no path prefix. The new Ingress routes only `/slack/events` and `/slack/interactions` to the gateway Service on port 8080; its health and metrics routes remain private. It can share the application's hostname: the more specific Slack paths route to the gateway while the existing application Ingress keeps its own backend. Gateway annotations are separate so application rewrite rules cannot silently change callback paths. The gateway Ingress requires Kubernetes 1.19+. + +The chart does not install an ingress controller or issue a TLS certificate. Configure TLS through the example Secret, your normal certificate controller/annotations, or an existing HTTPS termination layer. Slack needs a publicly trusted HTTPS endpoint. If you manage a separate external Ingress or need a custom base-path rewrite, leave `channelGateway.ingress.enabled: false` and route the callback paths to the rendered gateway Service yourself; do not add them as paths on the main application Ingress, whose backend is LibreChat. Socket Mode needs no public ingress. + +By default, the gateway runs without an automatically mounted Kubernetes API token, as a non-root user with a read-only filesystem and dropped capabilities. The chart's global pod/container security contexts are honored for platform-specific overrides. Gateway version labels follow its selected image tag. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating the shared app policy or its bound active connection and transport. + +After applying the values through your normal Helm upgrade, check the gateway Deployment, pod events, logs and readiness. Missing Secret keys block pod startup; incorrect credentials or channel bindings prevent readiness. Finish with a real Slack mention and account linking rather than treating a successful Helm release as proof of integration. + +## Next steps + +[Connect a Slack app and assign an agent](/docs/features/agent_channels#organization-workspaces), then finish setup with a real Slack message. See the [gateway reference](/docs/configuration/channel_gateway_reference) for rich-message formatting, service routes and delivery recovery. diff --git a/content/docs/configuration/channel_gateway_reference.mdx b/content/docs/configuration/channel_gateway_reference.mdx new file mode 100644 index 000000000..6a90fb1c0 --- /dev/null +++ b/content/docs/configuration/channel_gateway_reference.mdx @@ -0,0 +1,155 @@ +--- +title: Channel Gateway Reference +description: Rich-message formatting, service routes, and delivery recovery for gateway operators and integrators. +icon: Network +--- + +This reference describes rich-message formatting and the private API used by the [Slack channel gateway](/docs/configuration/channel_gateway). For app setup and everyday use, see [Agent Channels](/docs/features/agent_channels). + +## Rich Agent messages + +An Agent can return semantic presentation data in its final answer. The gateway validates the document and converts it deterministically to Slack Block Kit; it does not accept arbitrary Slack JSON, callback IDs, approval controls, file identifiers or modal definitions. Ordinary Markdown remains unchanged. This works in both ordinary threads and native Agent sessions, without a new OAuth scope or a configuration migration. + +To enable this behavior for an Agent, add the following to its instructions using the existing Agent editor (or include it in a request when testing): + +> When a chart, table, image or card would help, write a short readable answer followed by exactly one final, top-level fenced code block named `librechat-presentation`. Its JSON must be `{ "version": 1, "blocks": [...] }`. Use only the semantic components described below; never emit raw Slack blocks or interactive callback IDs. Use ordinary Markdown for other answers. Use public HTTPS URLs for images and links. The gateway generates complete text fallbacks from the data, so do not repeat every value in the introductory answer. + +For example, ask the Agent to compare the following measured results and show both a chart and a table. Its final answer can be: + +````text +Latency fell from 20 ms to 17 ms. + +```librechat-presentation +{ + "version": 1, + "blocks": [ + { + "type": "chart", + "title": "Latency", + "chart": { + "type": "line", + "axis_config": { "categories": ["Mon", "Tue"], "y_label": "ms" }, + "series": [{ "name": "p95", "data": [{ "label": "Mon", "value": 20 }, { "label": "Tue", "value": 17 }] }] + } + }, + { "type": "table", "title": "Measurements", "columns": ["Day", "p95 (ms)"], "rows": [["Mon", 20], ["Tue", 17]] } + ] +} +``` +```` + +| Semantic component | Fields and constraints | +| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `text`, `header`, `context`, `code` | `text` string; maximum 3000, 150, 2000 and 3000 Unicode characters respectively. Text components use literal text, so mentions cannot grant interaction authority. Use ordinary Markdown outside the document for formatted prose. | +| `divider` | No additional fields. | +| `image` | `url`, `alt`, optional `title` (150 characters). HTTPS URLs only; alt text is required (2000 characters). The gateway never fetches remote media. | +| `card` | Required `title` (150), optional `subtitle` (150), `body` (200), `image: {url, alt}`, and up to three `links: [{label, url}]`. Labels are at most 75 characters. Links navigate only; they cannot run an Agent action. | +| `carousel` | `cards`: 1–10 cards. | +| `table` | `title` (150), `columns`: 1–20 labels (150 each), `rows`: 1–200 rectangular rows of strings or finite numbers. Maximum 20,000 characters across cells including headers. Numeric cells retain numeric sorting. | +| `chart` | `title` (50), `chart` as described below. | +| `container` | `title` (150), `blocks`: 1–10 text, header, context, code, divider or image components. | +| `layout` | `title` (150), `rows`: 1–5 arrays of 1–3 components, including containers. Charts, tables and carousels each occupy their own row. Layouts cannot nest. The gateway makes the title visible and generates explicit compatibility fallback blocks. | + +Charts support `line`, `bar` and `area` with `axis_config: {categories, x_label?, y_label?}` and `series: [{name, data: [{label, value}]}]`. Categories have 1–20 distinct labels; each series must have exactly one point per category. Series names are distinct; at most 12 series are allowed. Names and labels are at most 20 characters, axis titles 50. Values must be finite; negative values are supported. Pie charts instead use `chart: {type: "pie", segments: [{label, value}]}` with 1–12 distinct labels and positive finite values. + +A document has at most 40 components and the final answer must fit the 128,000-byte presentation parsing boundary. Malformed, incomplete, quoted, ambiguous or unrecognized documents stay on the ordinary text path. The gateway isolates components into messages, counts nested blocks, enforces two charts and 20,000 table characters per message, and preserves every value and link in generated text. Components which exceed Slack's nested block or serialized payload limits become text. The server's existing `maxDeliveryParts` policy still applies, with an explicit shortening notice when needed. + +The gateway freezes versioned blocks and text together before posting. Retries replay that plan. A definitive Slack `invalid_blocks` or `invalid_attachments` rejection permits a text-only retry; ambiguous network outcomes retain the existing reconciliation behavior. Clients that cannot render layouts receive the generated stable fallback blocks. + +This is rich **message** support. Existing app-owned Stop, approval, question and feedback workflows remain responsible for interactions. New input forms, App Home, modals, Work Objects, plan/task execution controls and embedded video are not exposed to Agent output. Authorized file attachments continue through the existing artifact delivery path. Slack may limit newer blocks by client or app availability; automated tests cover SDK payloads and rejection fallback, while live rendering requires a configured Slack workspace. + +## Identity and account links + +Organization workspace connections use personal identities. Manual connections can use `per_user` (each linked participant uses their own account) or `shared` (only the connection creator can link). Shared gateway deployment is unrelated to the manual `shared` identity mode. + +Each actor/link revision has its own execution lane. Sharing a Slack thread does not share a LibreChat conversation, files, OAuth state, approvals, usage, or trace session. Mode changes, unlinking, account removal and access/key revocation invalidate old authority rather than remapping it to another user. + +Browser routes under `/api/channels/links` preview, accept, list and revoke links using authenticated sessions and same-origin checks. Ticket lifetime defaults to 10 minutes and accepted links to 30 days; see the [channel policy](/docs/configuration/librechat_yaml/object_structure/agents#channels) to change them. Browser acceptance still requires confirmation by the same Slack actor before execution is permitted. + +## Gateway protocol boundary + +Service requests use `Authorization: Bearer ` and the exact tenant/channel context. For routes without a tenant path parameter, send the channel's exact tenant in `x-tenant-id`; do not choose a tenant from untrusted message text. The service token permits this integration boundary, not arbitrary user impersonation. Never put it in client-side code, Slack messages, tracing payloads, or public logs. The credential bundle endpoint returns secrets to the trusted gateway and must not be exposed as a public discovery API. + +| Stage | Route under `/api/channels` | Responsibility | +| --- | --- | --- | +| Configuration | `GET /service/slack/{tenantId}/{channelId}` | Read the active channel and encrypted-at-rest credentials through an authenticated service boundary | +| Identity | `/service/{channelId}/identity/{externalUserId}` and its ticket/confirm operations | Resolve explicit actor linking; never infer a principal from thread history | +| Admission | `POST /service/{channelId}/runs` | Admit an idempotent event with verified team/app/actor identity | +| Ownership | `POST /service/{channelId}/runs/claim`, then `/{runId}/renew` or `/{runId}/yield` | Claim, renew, or safely yield the exact polling lease | +| Execution preparation | `POST /service/{channelId}/runs/{runId}/response/prepare` | Obtain the bound execution credential, request, and stable request key | +| Response binding | `POST /service/{channelId}/runs/{runId}/response/bind` | Bind the returned Responses identity to the admitted run | +| Progress and result | `/{runId}/advance`, `/{runId}/progress/*`, `/{runId}/plan`, `/{runId}/delivery/*`, `/{runId}/commit` | Project canonical state and record fenced delivery effects | +| Review projection | `POST /service/{channelId}/runs/{runId}/review` | Reauthorize the original actor; obtain the browser fallback and, for the exact external channel, the current private question/tool-review payload | +| Review decision | `POST /service/{channelId}/runs/{runId}/review/decision` | Submit the current actor's decision to the same canonical Response, using its immutable decision receipt and resume preflight | +| Artifacts | `POST /service/{channelId}/runs/{runId}/artifacts/{artifactId}` | Read only an artifact bound to the authorized run | +| Stop | `POST /service/{channelId}/runs/stop-thread` or `/{runId}/cancel` | Cancel only the authorized actor lane/run | +| Feedback | `POST /service/{channelId}/reactions` | Apply authenticated, deduplicated reaction events to confirmed delivered replies | + +Run-relative paths in the table are beneath `/service/{channelId}/runs`. Lease mutations carry the exact server-issued `{ runId, owner, epoch }` fence. Treat stale leases, changed authority, and ambiguous delivery outcomes as protocol states to reconcile, not permission to mint a new run or blindly resend a Slack message. + +A gateway can yield a Responses-bound polling turn only after its progress writes and renewal loop have drained. The backend invalidates that polling fence and enforces a one-second reclaim cooldown; the next claim increments the epoch. This does not release the actor lane, cancel the provider, change the Response, or erase delivery evidence. Inflight or unknown remote writes cannot yield. If a host does not support yield or the request is uncertain, retain ordinary lease-expiry recovery instead of starting a new execution. + +Execution preparation returns an `apiKey`, `requestKey`, optional retained `responseId`, and a Responses `request` with the Agent ID, admitted input, `background: true`, `store: true`, and any authorized continuation. Submit that request to `/api/agents/v1/responses` using the bound key and `Idempotency-Key: `, then bind the returned response ID. Do not substitute a creator's unrestricted key, change the actor/Agent, or send the input to a channel bookkeeping route to execute it. + +The gateway owns Slack event verification, retry/deduplication, native message formatting, rate-limit handling, and delivery receipt reconciliation. Preserve exact event identifiers and timestamps. For feedback events, `eventTimestampUs` is an integer timestamp in microseconds; do not round it to milliseconds. Report confirmed, failed, or ambiguous side effects accurately before advancing delivery state. + +## Delivery recovery + +The gateway preserves each frozen delivery operation and its receipt. A required operation whose provider result is unknown holds its actor lane: retrying blindly could post the same answer twice. Stopping a worker or requesting cancellation does not prove whether Slack accepted an earlier request. + +### Reconcile a verified provider result + +1. Pause gateway processing for the affected channel while investigating. Keep the channel enabled and preserve its actor link and source authority; disabling these is not a recovery bypass. +2. Inspect the frozen run plan and retained receipt. Verify in the provider that the exact operation reached the intended channel or thread. Record its message key or file ID, matching the retained attempt and any upload checkpoint. If the result cannot be verified, leave the receipt unknown and the lane held. +3. After the old lease expires, use `POST /api/channels/service/:channelId/runs/claim` with `{ "owner": "" }`, normal private service authentication and tenant binding. Verify that the returned run ID is the run being investigated; claims select eligible work and do not take a target run ID. Use the returned current fence, renewing it through `POST /renew` as needed. An expired or replaced worker's fence cannot reconcile the run. +4. Submit the confirmed receipt through the private channel API. These endpoints confirm existing attempts; they do not send messages, replace the frozen plan, reset attempts or accept a retryable outcome. + +All paths below are relative to `/api/channels/service/:channelId/runs/:runId`. Send the channel service bearer token and the configured tenant header, using the same internal service URL as the gateway. Preserve the complete fence returned by the claim. + +For a delivery operation, `POST /delivery/reconcile`: + +```json +{ + "fence": { "runId": "", "owner": "", "epoch": 1 }, + "receipt": { + "operationId": "", + "outcome": "confirmed", + "attempts": 1, + "externalMessageKey": ":" + } +} +``` + +Replace every illustrative value with the actual current fence and retained attempt count; do not assume the example epoch is current. Supply `externalFileId` for a verified file operation as required by its frozen operation and checkpoint. Existing provider identities are immutable; reconciliation cannot replace them with a different message or file. + +For a progress update, `POST /progress/reconcile` with the current `fence`, the retained progress `revision`, and a `receipt` containing `outcome: "confirmed"`, the retained `attempts` and verified `externalMessageKey`. The message identity remains fixed across progress revisions. + +Once every required delivery operation is confirmed, `POST /commit` with the current `fence` to complete delivery and release the actor lane. Resume normal gateway processing afterward. If any required result remains uncertain, keep the run held rather than resending or recreating it. Optional exhausted effects follow the gateway's bounded recovery policy and do not justify replaying a required answer. + +## Review and privacy + +The public run snapshot contains only an opaque action descriptor. A review request with the original verified actor, current channel revision, and exact `externalChannelId` can obtain minimal private question/tool-approval details. The backend derives the owner and Response from the run and checks the current actor link and source grant; it does not accept an arbitrary user ID. The gateway must show these details only to that actor, not publicly in a shared thread. Slack can use ephemeral choice buttons and private modals. Native tool approval is for the individual call only; unsupported/richer forms retain the browser fallback. + +Decision requests include that same actor, revision, external channel, and the existing Responses `decision` body. Backend decision receipts, expiry/conflict checks, full authorization preflight, and same-Response resume remain authoritative. A Slack click alone is not permission to resume work. Provider OAuth URLs remain exclusively in the authenticated browser review flow. See the [background Responses lifecycle](/docs/features/background_responses#review-a-required-action). + +Successful submission closes the private modal and sends a private acknowledgement; it does not claim the tool finished. Provider sign-in and unsupported forms open the authenticated browser flow. The Agent's existing approval policy determines whether a tool needs approval; connecting Slack does not make every tool manual or bypass that policy. + +A saved decision whose queue publication failed remains retryable with the exact immutable decision; it cannot be replaced by a different answer. Keep Stop available while work remains active and update public progress only through the fenced delivery protocol. + +### Files + +Artifacts are scoped to the authorized run and actor. User-submitted rows do not count as server-generated provenance for artifacts or trace links. Limits default to five files and 10 MiB per file. One `artifactReadTimeoutMs` budget (30 seconds by default) covers catalog queries, storage reads and final authorization rather than restarting for every file. Limits resolution is separately capped at 60 seconds, and its elapsed time counts against the selected budget once available. An expired budget omits artifacts while retaining the answer for authorized text delivery. + +New plain-text answer files require more than `artifactAnswerFileThresholdBytes` UTF-8 bytes (6,000 by default); fenced answers also qualify. This threshold controls new projections, while saved descriptors retain their content identity and still require current authorization, retention and maximum-size checks. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. + +### Feedback + +Reaction feedback maps only to confirmed delivered assistant messages. It does not overwrite the browser's feedback field. Export is constrained by recorded sampling/destination provenance and current export policy. Temporary-chat provenance is retained; an old mapping without that provenance is not treated as a permanent chat. A policy change can suppress export even when the original trace was sampled. + +## Operational limits + +Disabling a channel or changing its credential mode retires old authority; it does not undo external tool effects. Stop can remain pending until the exact provider is drained and canonical cancellation/cleanup completes. A gateway must poll/reconcile canonical state rather than interpreting an acknowledgement as terminal completion. + +With the process-local job store, restarting the API while a tool approval is pending makes the review unavailable. The request stays held for reconciliation and a stale approval does not execute the tool. Durable checkpoint storage alone does not recreate the missing live execution state. Completed history and subsequent thread continuation survive restart. + +The gateway package is built from the LibreChat source tree; it is not published as an npm package. This integration does not promise arbitrary chat-platform support or restart-survival of an in-memory OAuth waiter. A restart can require a new browser sign-in; uncertain continuation must not be reported as completed or retried as new work. diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 0bcfbfcb6..6e9ee765e 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1521,7 +1521,7 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels | `artifactReadTimeoutMs` | `30000` | Shared artifact-operation budget, `1000`–`60000` ms; not a separate timeout for each file | | `artifactAnswerFileThresholdBytes` | `6000` | Create new plain-text answer files only above this UTF-8 byte length, `0`–`52428800`; fenced answers also qualify | -`slackApp` enables organization-owned apps and sets installation/runtime policy. Set `channels.enabled: true`, `transport: webhook` and `slackApp.enabled: true`. Each registered app supports one active workspace. Organization admins register an existing Slack app through **Settings → Account → Slack → Set up/Manage → Add Slack app**, with an optional friendly name and app/client credentials; credentials are encrypted in the database and are not YAML or environment settings. The deployment opt-in `SLACK_WORKSPACES_ENABLED=true` enables these policies and background Responses while preserving other YAML settings. Without the opt-in, YAML remains authoritative. `SLACK_GATEWAY_URL` supplies the public gateway URL. See [Organization workspaces](/docs/features/agent_channels#organization-workspaces) for deployment and UI steps. +`slackApp` enables organization-owned apps and sets installation/runtime policy. Set `channels.enabled: true`, `transport: webhook` and `slackApp.enabled: true`. Each registered app supports one active workspace. Organization admins register an existing Slack app through **Settings → Account → Slack → Set up/Manage → Add Slack app**, with an optional friendly name and app/client credentials; credentials are encrypted in the database and are not YAML or environment settings. The deployment opt-in `SLACK_WORKSPACES_ENABLED=true` enables these policies and background Responses while preserving other YAML settings. Without the opt-in, YAML remains authoritative. `SLACK_GATEWAY_URL` supplies the public gateway URL. See [gateway deployment](/docs/configuration/channel_gateway#organization-workspaces) and [organization workspace setup](/docs/features/agent_channels#organization-workspaces). | `slackApp` option | Default | Purpose | | --- | --- | --- | @@ -1544,7 +1544,7 @@ The artifact budget covers catalog queries, storage acquisition/consumption and The gateway service boundary requires the server-side `CHANNEL_SERVICE_TOKEN`. Do not expose it to browsers or use it as a general Agent execution credential. Channel credential mode (`shared` or `per_user`) belongs to the channel record, not this deployment block. Both modes require explicit current actor linking; `shared` restricts linking to the channel creator's account rather than granting all external participants that account's privileges. -The gateway reads this versioned policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is optional and asserts the selected mode; a mismatch or unsupported policy prevents startup. Native sessions, lifecycle reactions and signature policy are configured here rather than through gateway process flags. Gateway runtime settings, including its tenant/connection IDs, app-level Socket Mode token and optional `APP_TITLE` label, are documented in [Run the Slack gateway](/docs/features/agent_channels#run-the-slack-gateway). +The gateway reads this versioned policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is optional and asserts the selected mode; a mismatch or unsupported policy prevents startup. Native sessions, lifecycle reactions and signature policy are configured here rather than through gateway process flags. Gateway runtime settings, including its tenant/connection IDs, app-level Socket Mode token and optional `APP_TITLE` label, are documented in [Run the Slack gateway](/docs/configuration/channel_gateway#run-the-slack-gateway). ## remoteApi diff --git a/content/docs/configuration/meta.de.json b/content/docs/configuration/meta.de.json index f65240eab..4db690002 100644 --- a/content/docs/configuration/meta.de.json +++ b/content/docs/configuration/meta.de.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.es.json b/content/docs/configuration/meta.es.json index 5e396f107..6321cd56a 100644 --- a/content/docs/configuration/meta.es.json +++ b/content/docs/configuration/meta.es.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.fr.json b/content/docs/configuration/meta.fr.json index 21e20cff0..5b3a15182 100644 --- a/content/docs/configuration/meta.fr.json +++ b/content/docs/configuration/meta.fr.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.id.json b/content/docs/configuration/meta.id.json index 8937c8c47..53b7dbe36 100644 --- a/content/docs/configuration/meta.id.json +++ b/content/docs/configuration/meta.id.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.it.json b/content/docs/configuration/meta.it.json index 8e40e07ac..2406d6c64 100644 --- a/content/docs/configuration/meta.it.json +++ b/content/docs/configuration/meta.it.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.ja.json b/content/docs/configuration/meta.ja.json index 91a6a64ed..5731db34a 100644 --- a/content/docs/configuration/meta.ja.json +++ b/content/docs/configuration/meta.ja.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.json b/content/docs/configuration/meta.json index c26baa222..4f9082475 100644 --- a/content/docs/configuration/meta.json +++ b/content/docs/configuration/meta.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.ko.json b/content/docs/configuration/meta.ko.json index f5d55f261..8cebe7af2 100644 --- a/content/docs/configuration/meta.ko.json +++ b/content/docs/configuration/meta.ko.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.nl.json b/content/docs/configuration/meta.nl.json index a2003cf6a..a633465e9 100644 --- a/content/docs/configuration/meta.nl.json +++ b/content/docs/configuration/meta.nl.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.pl.json b/content/docs/configuration/meta.pl.json index 42d45afa8..96b928fc9 100644 --- a/content/docs/configuration/meta.pl.json +++ b/content/docs/configuration/meta.pl.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.pt-BR.json b/content/docs/configuration/meta.pt-BR.json index c3f28f758..c7ff6ac7a 100644 --- a/content/docs/configuration/meta.pt-BR.json +++ b/content/docs/configuration/meta.pt-BR.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.tr.json b/content/docs/configuration/meta.tr.json index aed87e77c..e27cae5a9 100644 --- a/content/docs/configuration/meta.tr.json +++ b/content/docs/configuration/meta.tr.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.vi.json b/content/docs/configuration/meta.vi.json index 8e790bafc..bffb1f637 100644 --- a/content/docs/configuration/meta.vi.json +++ b/content/docs/configuration/meta.vi.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/configuration/meta.zh.json b/content/docs/configuration/meta.zh.json index 0a212459d..c6f3aad2c 100644 --- a/content/docs/configuration/meta.zh.json +++ b/content/docs/configuration/meta.zh.json @@ -17,6 +17,8 @@ "artifacts", "pull_requests", "scheduled_chats", + "channel_gateway", + "channel_gateway_reference", "agent_plugins", "data_retention", "stt_tts", diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 20278498e..043418e36 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -1,509 +1,220 @@ --- title: Agent Channels -description: Connect a Slack integration to durable Agent Responses with explicit identity and delivery boundaries +description: Connect an agent to Slack, link your account, and use your tools from a channel or direct message. icon: MessagesSquare --- - -Agent Channels are a beta integration and are disabled by default. The standalone TypeScript Slack gateway lives in `packages/channel-gateway` in the LibreChat repository. Enabling Channels does not start that process or install a Slack app. - - -Agent Channels connect external messaging events to [background Agent Responses](/docs/features/background_responses). Channel routes manage identity, admission, leases, delivery receipts, artifacts, and feedback. They are **not an alternative model-execution endpoint**: a compatible gateway submits execution through `/api/agents/v1/responses` using a server-provisioned, bound credential. - -## Configuration and prerequisites - -Choose organization workspaces for UI-managed, organization-owned Slack apps and workspace installations. The YAML example below is the manual single-connection setup; the shared-workspace deployment options also enable Channels and background Responses automatically. - -```yaml filename="endpoints / agents" -endpoints: - agents: - remoteApi: - background: - enabled: true - channels: - enabled: true - transport: socket_mode - nativeSessions: false - lifecycleReactions: false - signatureToleranceSeconds: 300 - socketReconnectDelayMs: 5000 -``` +Agent Channels let you talk to a LibreChat [agent](/docs/features/agents) from Slack, in a channel or direct message. Each person links their own LibreChat account and uses their own permissions, tool connections, and approvals. -Both enablement settings default to `false`. Users need both Agent use and Remote Agents use permissions. Channel setup also requires Agent sharing permission or existing administrator management access; sharing access does not require permission to edit the Agent. Configure `DOMAIN_CLIENT` for trusted owner-review and account-link URLs. Configure a strong `CHANNEL_SERVICE_TOKEN` for the gateway-to-LibreChat service boundary; keep it server-side and distribute it only to a trusted integration process over a secure channel. It is not a browser token or a general Agent API key. + +An operator must [deploy the Slack gateway](/docs/configuration/channel_gateway) and its database prerequisites first. Installing a Slack app alone does not make an agent available. + -The `transport` option accepts `socket_mode` (default) or `webhook`. Manual connections generate a matching Slack manifest; organization workspaces use the webhook setup below. Selecting a transport does not deploy a receiver. Webhook manifests require an HTTPS `gatewayUrl` without credentials, a query, or a fragment. The gateway loads this policy from LibreChat before selecting ingress. `SLACK_TRANSPORT` is an optional deployment assertion; if supplied, it must match the server-selected mode. Missing or unsupported gateway policy prevents startup. +## Before you start -### Database requirement +Follow the steps for your role: -Durable Channels and stored background Responses require MongoDB transactions. Use a MongoDB replica set or another verified transaction-capable deployment. Standalone MongoDB and FerretDB 2.7 can run ordinary LibreChat, but cannot enable this durable feature. Unsupported channel writes return `transactions_unavailable`; the Agent builder explains the setup requirement. Transactional reads use the primary even when the connection normally prefers secondary reads. The database must also support the required indexes, including partial indexes; transaction support by itself is not sufficient. [Amazon DocumentDB 4.0 lacks partial-index support](https://docs.aws.amazon.com/documentdb/latest/devguide/indexes-single-field.html) and cannot run this gateway. Other MongoDB-compatible engines need their own compatibility validation. +| Who | What to do | +| --- | --- | +| Deployment operator | [Run the gateway](/docs/configuration/channel_gateway#organization-workspaces) and configure the public HTTPS callback URLs. | +| Organization administrator | [Register a Slack app and connect a workspace](#organization-workspaces), then grant bot management access if needed. | +| Agent manager | [Assign an agent](#assign-an-agent) to the bot or a channel. | +| Each Slack participant | [Link your account](#account-linking), confirm it in Slack, and send a new request. | -API-key authentication must remain enabled for the gateway's bound execution credential. Linking does not grant Remote Agents permissions, Agent access, new tools or offline access to connected services. +Participants need access to the agent and a role that allows using Agents and querying them through Remote Agents (API). Assigning an agent also requires permission to share it and bot management access; installation administrators do not need a separate bot-manager grant. Installing the app or linking an account does not grant these permissions. -See the [channel configuration reference](/docs/configuration/librechat_yaml/object_structure/agents#channels) for limits and defaults. +If your deployment uses a manually configured Slack app instead of organization workspaces, follow [manual connection setup](#set-up-a-manual-slack-app-connection). ## Organization workspaces -A deployment operator enables the shared gateway once, without creating Slack apps or handling customer credentials. Organization administrators register their own Slack apps and connect workspaces in LibreChat; members link their personal accounts in Slack. Installing an app does not give members access to an Agent or its tools. In a tenant-aware deployment, installations and routing belong to the active tenant. One app/workspace installation has one tenant owner; another tenant cannot claim an active installation. - -### One-time operator setup - -1. Configure transaction-capable MongoDB and a private `CHANNEL_SERVICE_TOKEN` shared by the API and gateway. Keep API-key authentication enabled for bound execution and retain normal Agent and Remote Agents permission controls. -2. Configure public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT`, replacing the localhost defaults in `.env`. Both are required and must have no surrounding whitespace. Include the application base path when present. Set `SLACK_GATEWAY_URL` to the public gateway origin; it must also use public HTTPS. The shared deployment opt-in rejects local addresses. -3. Route `/slack/events/` and `/slack/interactions/`, including their organization/app suffixes, to the gateway. Its container listens on port 8080; the shared Compose overlay publishes it at `127.0.0.1:3081` for a host-level HTTPS proxy. Route the application and OAuth callback to LibreChat. Keep gateway health and metrics private. No Slack dashboard access, app credentials or per-organization infrastructure settings are required. - -For Docker Compose, use the normal uncommitted `.env`: - -```dotenv -SLACK_GATEWAY_URL=https://slack.example.com -CHANNEL_SERVICE_TOKEN= -DOMAIN_SERVER=https://chat.example.com -DOMAIN_CLIENT=https://chat.example.com -LIBRECHAT_IMAGE_TAG= -``` - -From a fresh LibreChat setup with `.env` and `librechat.yaml` prepared, start the release-matched application and shared gateway: - -```sh -docker compose -f docker-compose.yml -f docker-compose.channels.yml \ - -f docker-compose.slack-workspaces.yml -f docker-compose.mongo-replica.yml \ - --profile channels up -d api meilisearch channel-gateway -``` - -The replica overlay is for a **fresh local database**; read [Existing local data](#existing-local-data) before converting an existing installation. Omit that overlay when you already use a verified transaction-capable external database and supply its normal connection configuration. Use the same Compose project and files for subsequent commands. This does not configure a public reverse proxy or a trusted certificate. A host-level proxy forwards the two Slack paths to `http://127.0.0.1:3081`, preserving the organization/app suffixes. Set `CHANNEL_GATEWAY_PORT` in `.env` to change that loopback port. A proxy in the same Compose network can instead forward to `http://channel-gateway:8080`. - -The shared overlay supplies `SLACK_WORKSPACES_ENABLED=true`, which enables webhook Channels, shared app installation and stored background Responses while retaining unrelated YAML policy, limits and explicit API authentication settings. Slack app credentials are entered by organization admins through the UI and stored encrypted; they are not deployment environment variables or YAML fields. With the flag unset or false, YAML continues to control the feature. Choosing shared setup changes the deployment's channel transport to webhook; existing bound connections must use matching webhook configuration. Manual Socket Mode remains available when using the manual setup instead. - -No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in shared mode. The gateway receives its service token and private runtime policy; app client credentials stay in LibreChat, and installed bot tokens are encrypted in the database. For an unreleased source checkout, add `docker-compose.channels-build.yml` and use `up -d --build` rather than expecting an unpublished release image. `npm run backend:dev` still starts only the application; for a source gateway process, omit the bound IDs and app-level token and provide the internal API URL and service token. +A Slack app provides the bot's identity; installing it grants access to a workspace. Each registered app supports **one active workspace**. Use separate apps for additional workspaces. ### Register an organization’s Slack app -Complete [operator setup](#one-time-operator-setup) first. The gateway must be running and reachable over public HTTPS before Slack can verify its callback. A Slack app is the bot's identity and credentials; its workspace installation is the grant that lets it operate in a particular Slack workspace. LibreChat supports **one active workspace per registered app**. Use separate Slack apps for additional workspaces. - -1. Open [Your Apps](https://api.slack.com/apps) in Slack and create an app from scratch (**Pick features** in the current dashboard, or **Blank app** in Slack’s quickstart). Give it a name and select the workspace where you will manage it. In the **Pick features** wizard, continue without adding scopes or events, then select **Create → Create Anyway**. Configure those features after registering the app in LibreChat below. You can instead use an existing app your organization controls. Do not install it yet. -2. In LibreChat, open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. Copy **App ID**, **Client ID**, **Client Secret**, and **Signing Secret** from that app's **Basic Information → App Credentials**. Select **Show** beside each secret before copying; the masked dots are not the secret. The optional **Name** identifies the app in LibreChat; it does not rename the bot in Slack. Save the registration. Secrets are encrypted and cannot be read back. -3. Turn **Socket Mode off** in that Slack app before configuring HTTP callbacks. Expand the saved app in LibreChat and open the gear button, **Connection settings**. Configure all three copied URLs in that same Slack app: - - | LibreChat value | Slack setting | - | --- | --- | - | OAuth redirect URL | **OAuth & Permissions → Redirect URLs**; add the URL and save | - | Events URL | **Event Subscriptions → Enable Events** on; paste into **Request URL** and wait for **Verified** | - | Interactivity URL | **Interactivity & Shortcuts → Interactivity** on; paste into **Request URL** and save | + + - Copy the exact URLs, including application base paths and organization/app suffixes. Saving the credentials first lets the gateway authenticate Slack's verification request before installation. If verification fails, check the matching signing secret, public gateway address, and running gateway before continuing. -4. Under **OAuth & Permissions → Bot Token Scopes**, add all seven scopes below. No user-token scopes are required: +**Create the app in Slack.** Open [Your Apps](https://api.slack.com/apps) and create an app from scratch, or use one your organization controls. In **Pick features**, continue without scopes or events, then select **Create → Create Anyway**. Do not install it yet. - ```text - app_mentions:read - chat:write - reactions:read - reactions:write - files:write - im:write - im:history - ``` + + -5. Under **Event Subscriptions → Subscribe to bot events**, add `app_mention`, `message.im`, `reaction_added`, `reaction_removed`, `app_uninstalled`, and `tokens_revoked`, then save. The last two require no additional OAuth scopes. The optional [native Agent sessions](#native-agent-ui-and-final-replies) setup additionally uses `agent_session_stopped`. -6. Under **App Home**, enable the **Messages tab** and allow users to send messages from it so direct messages can reach the bot. Leave token rotation and organization-wide installation disabled. Workspace approval policies still apply. +**Register it in LibreChat.** Open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. Copy **App ID**, **Client ID**, **Client Secret**, and **Signing Secret** from Slack's **Basic Information → App Credentials**. Select **Show** before copying secrets. The optional **Name** labels the app in LibreChat without renaming the Slack bot. Save the registration. -These are manual Slack settings; LibreChat's organization app screen does not generate a manifest or create the Slack app for you. See Slack's [app setup](https://docs.slack.dev/app-management/quickstart-app-settings/) and [interactive request setup](https://docs.slack.dev/interactivity/handling-user-interaction/) for its dashboard controls. + -Use the pencil button, **Edit App**, to change its friendly name or credentials later. Leaving a secret blank preserves its saved value; clearing **Name** removes the custom LibreChat name. Changing the client ID requires entering the corresponding client secret again. The saved app ID cannot be edited: register another app for a different ID. After adding Slack scopes to an installed app, reconnect it through LibreChat and approve the updated grant; changing app settings alone does not upgrade existing tokens. A conflicted edit requires refreshing the registration before retrying. + + -The organization flow does **not** ask you to paste a bot token or an app-level token. A bot token beginning `xoxb-` is used only by [manual connection activation](#set-up-a-manual-slack-app-connection); an app-level token beginning `xapp-` is used only by the manual Socket Mode gateway. Neither is the client secret, signing secret, or `CHANNEL_SERVICE_TOKEN`. +**Configure its callbacks.** Turn **Socket Mode off** in Slack. Expand the saved app in LibreChat and open the gear button, **Connection settings**. Copy all three URLs into that same Slack app: -### Connect and use a workspace - -1. Under the registered app, select **Add to workspace**. If Slack asks where to install, choose **A workspace** and the intended workspace, then approve installation. LibreChat shows a **Connecting to Slack…** dialog while this is pending. Use **Cancel** there to abandon the attempt, or **Retry** after a failure. On success, the dialog closes and the workspace appears as **Connected** below the app. Each app can have only one active workspace; reconnect that workspace to refresh its grant, or disconnect it before installing the app elsewhere. -2. An administrator opens the workspace's users button, **Manage access**, and adds the LibreChat users allowed to assign agents through that bot. The dialog is titled **Manage bot access**. Without explicit managers, administrators can still assign agents. These grants do not grant Agent sharing permission, Slack credentials, or installation-administration rights, and are not required just to talk to the bot. -3. Save an Agent you have permission to share. In the Agent builder's **Channels** section, select **Add Slack channel**, choose the **Slack bot**, then **Continue**. You need Remote Agents permission as well as permission to share the Agent. The picker offers only bots you can manage; installation administrators can also assign agents. -4. Choose **Default** for new direct messages and mentions without a channel-specific assignment, or choose **Channel Specific** and enter the **Slack channel ID**. Find the ID in Slack's channel details; it is not the channel name. Select **Assign agent**. If already assigned, **Replace default agent** or **Replace channel agent** opens a confirmation. The current Agent is named only when you can view it. Existing conversations keep their original Agent. -5. In Slack, invite the bot to your test channel, for example `/invite @YourBot`, then mention it with `@YourBot hello`. Installing the app alone does not add it to every channel. You can also send a direct message when the Messages tab is enabled. -6. Select **Link account** in the bot's private message. Sign into the intended LibreChat account, inspect the request, and accept it in the browser. The original Slack message changes to show the account name and **Confirm account**. Return to that message and confirm from the **same Slack account**. Once it shows **Account connected**, send a **fresh request** to the bot; the original request is not replayed automatically. If the confirmation does not appear, mention the bot again to recover the prompt. - -A successful first response completes setup. Each person repeats the personal linking step and runs with their own current Agent permissions, tool credentials, and approvals. Sharing a Slack thread does not lend another participant's MCP connection or authority. To verify tool access, ask for a task using a tool that the linked account is permitted to use, and complete any required approval as that account. - -#### If the bot does not respond - -| Symptom | Check | +| LibreChat value | Slack setting | | --- | --- | -| Events URL will not verify, or Slack callbacks return `401` | Gateway is running and publicly reachable over HTTPS; URL matches the saved organization/app; **Signing Secret** belongs to that same Slack app. Check clock synchronization against the signature window. Do not disable signature checks. | -| Gateway calls to LibreChat return `401` | API and gateway use the same private `CHANNEL_SERVICE_TOKEN`, and `LIBRECHAT_INTERNAL_URL` reaches the intended LibreChat instance. This is separate from Slack signature verification. | -| Mention produces no response | Check gateway readiness and logs, **Socket Mode off**, **Events on** with the subscriptions above, bot invited to the channel, and an Agent assigned to this bot/destination. Confirm the sender's personal link is active. | -| Confirmation, approval, or Stop buttons do nothing | **Interactivity** is on, its exact Request URL is saved, and the gateway is reachable. The Events URL does not substitute for the Interactivity URL. | -| Link says **Awaiting confirmation** | Return to the bot's private message and select **Confirm account** from the same Slack account. If the message did not update, mention the bot again to recover the prompt. After confirmation, send a new request. | -| Installation reports missing permissions after scopes changed | Add all required bot scopes, then reconnect through LibreChat and approve the updated grant. Existing installations do not receive new scopes automatically. | - -Use the same Compose project and overlays from operator setup when checking `ps` and `logs --tail=100 api channel-gateway`. A healthy application alone does not prove the separate gateway is ready. See [gateway readiness checks](#docker-compose). +| OAuth redirect URL | **OAuth & Permissions → Redirect URLs**; add and save | +| Events URL | **Event Subscriptions → Enable Events → Request URL**; wait for **Verified** | +| Interactivity URL | **Interactivity & Shortcuts → Interactivity → Request URL**; save | -### Disconnect and remove +Keep the complete URLs, including any base path and organization/app suffixes. The gateway must be running and publicly reachable before Slack can verify the Events URL. -- Administrators revoke bot management through the workspace’s **Manage access** users button. Removed managers cannot create or change assignments, but can still remove assignments or delete their own Agent connection. Existing assignments and conversations keep running; management access is separate from permission to talk to the bot. Disconnecting a workspace clears its manager grants; a fresh installation requires new grants. Reauthorizing an active installation preserves managers. + + -- **Agent Builder → Channels → Manage connection** lists current assignments. When another destination is available, select **Add assignment** to configure it, or **Remove** beside an assignment and confirm **Remove assignment** to stop using it for new conversations. Select **Delete connection** and confirm to remove the connection and all its assignments atomically; existing threads retain their original identity and cannot silently move to another Agent. Disabling a connection stops execution without replacing its routing choices. To resume, select **Activate channel** and confirm the retained assignment. Each sender must link and confirm their account again after reactivation. -- **Settings → Account → Your channel account links** shows personal links once any exist. Status pills distinguish **In progress**, **Awaiting confirmation**, **Active**, **Revoked**, **Expired**, and **Unavailable**. Select **Revoke link** and confirm to withdraw your own consent, including an unavailable link. Completed actions are not undone. -- **Settings → Account → Slack → Manage**, then the workspace’s **Disconnect workspace** icon retires the installation's access in LibreChat. It does not uninstall the app in Slack. A later installation gets a fresh identity, so old connections do not resume automatically. Reconnect an active installation to update its grant; disconnect it first if you want to retire existing connections. -- After disconnecting an app’s active workspace, use the app’s trash button, **Remove app**, and confirm to delete its saved app credentials. This does not delete the Slack app itself. -- Removing the configuring person does not delete the organization's installation. Their personal links and credentials are cleaned up, and their Agent connections are retired through the normal channel cleanup. -- To stop the optional service, run the same Compose file list and project with `stop channel-gateway`, or set `channelGateway.enabled: false` and remove the shared opt-in from Helm/API configuration. Ordinary LibreChat can continue. Database topology is independent: do not remove an external replica configuration or convert existing data merely to stop the gateway. - -## Set up a manual Slack app connection - -1. Save the Agent, then select **Channels → Add Slack channel** in the Agent builder. Choose per-user or owner-only mode and continue. You need permission to share the Agent. -2. Copy the read-only Slack app manifest into Slack's app setup and install the app into your workspace. Make any app changes in Slack's app settings. -3. Under **Add Credentials**, enter the matching Slack app ID and bot token. For webhooks, also enter its signing secret. Activate the connection. LibreChat verifies the bot identity and stores credentials encrypted; normal setup responses do not return those secrets. -4. Copy the connection ID from the connection details. Configure and start the gateway as described below. It must be able to reach the active connection before startup can complete. -5. Invite the bot to a Slack channel and mention it. Each sender completes their own account-link flow before their request can run. - -Browser setup routes live under `/api/agents/{agentId}/channels`: list/create, read `/{channelId}/manifest`, update `/{channelId}`, and delete `/{channelId}`. These use authenticated Agent authorization, not the management API machine-token contract. The create body is `{ "type": "slack", "credentialMode": "per_user" }` (or `shared`). Activation updates use a `slack` object with `appId`, `botToken`, and optional `signingSecret`. To disable a channel, update its status to `disabled`. - -## Run the Slack gateway - -The gateway is a separate Node.js 24+ process, not an in-process LibreChat plugin. It uses Slack's official Node SDKs and calls LibreChat over HTTP; it does not connect directly to MongoDB or require a general-purpose Agent API key. Manual single-connection mode binds one process to one tenant and connection. Shared mode omits those IDs and serves all installed workspaces with a bounded worker pool. - -From a LibreChat source checkout containing `packages/channel-gateway`: - -```sh -npm ci -npm run build:packages -npm run build --workspace @librechat/channel-gateway -node --env-file=/secure/channel-gateway.env packages/channel-gateway/dist/main.cjs -``` - -`npm run backend:dev` starts only LibreChat; it does not start the gateway. Build the application using LibreChat's normal development setup and run the gateway separately. If you reuse the application's `.env`, set the gateway port explicitly: `PORT=8080 node --env-file=.env packages/channel-gateway/dist/main.cjs`. This avoids binding the gateway to the application's port. - -Supply the environment file through your normal secret-management process. Do not commit it. A Socket Mode configuration is: - -```dotenv filename="channel-gateway.env" -LIBRECHAT_INTERNAL_URL=http://127.0.0.1:3080 -CHANNEL_SERVICE_TOKEN= -CHANNEL_TENANT_ID=_ -CHANNEL_ID= -SLACK_TRANSPORT=socket_mode -SLACK_APP_TOKEN= -``` - -`LIBRECHAT_INTERNAL_URL` must be reachable from the gateway process. For example, `127.0.0.1` refers to the gateway's own container when running inside a container. Use the exact tenant ID for a multi-tenant deployment; use `_` only for a single-tenant deployment without a tenant ID. The gateway obtains the bot token and signing secret from LibreChat's authenticated connection bundle, so those values do not need separate gateway environment variables. - -For Socket Mode, enable Socket Mode for the same Slack app and create an app-level token with `connections:write`. Keep that token only in the gateway's secret configuration. No public callback URL is needed, but the gateway needs outbound access to Slack and LibreChat. - -For webhooks, set `SLACK_TRANSPORT=webhook` instead and omit `SLACK_APP_TOKEN`. Put the gateway behind HTTPS and set these Slack request URLs, replacing the placeholders with the configured, URL-encoded IDs: +**Add scopes and events in Slack.** Under **OAuth & Permissions → Bot Token Scopes**, add: ```text -Events: https://gateway.example.com/slack/events// -Interactivity: https://gateway.example.com/slack/interactions// +app_mentions:read +chat:write +reactions:read +reactions:write +files:write +im:write +im:history ``` -The webhook receiver verifies Slack signatures using the connection's signing secret. Keep LibreChat's channel service routes private to trusted integrations. Expose only the required Slack callback paths publicly; keep health and metrics endpoints on an internal network. +No user-token scopes are needed. Under **Event Subscriptions → Subscribe to bot events**, add `app_mention`, `message.im`, `reaction_added`, `reaction_removed`, `app_uninstalled`, and `tokens_revoked`, then save. -### Docker Compose +Under **App Home**, enable the **Messages tab** and allow users to send messages from it. Leave token rotation and organization-wide installation disabled. Optional [native Agent sessions](/docs/configuration/channel_gateway#native-agent-ui-and-final-replies) need additional setup. -The optional `docker-compose.channels.yml` overlay pulls release-matched LibreChat and gateway images. Set `LIBRECHAT_IMAGE_TAG` in `.env` to the release tag you are installing (including `-rcN` for a release candidate); both images use that same tag. If omitted, both use the latest stable release. Images are published for Linux AMD64 and ARM64 when the corresponding LibreChat release is published. A tag predating Agent Channels does not contain a gateway image. The separate `docker-compose.mongo-replica.yml` overlay initializes a single local MongoDB replica member and waits for a writable primary before the application starts. The gateway waits for application health, then authenticates its channel binding and selected Slack transport. Neither service is added to the default stack automatically. + + -For a **fresh local database**, run these commands from the LibreChat repository root: +**Install the app.** In LibreChat, select **Add to workspace**, choose the intended Slack workspace, and approve installation. Wait for **Connecting to Slack…** to close and **Connected** to appear. **Cancel** abandons a pending installation; **Retry** tries again after failure. Workspace approval policies still apply. -1. Prepare `.env` and `librechat.yaml` using the normal LibreChat setup and the channel policy above. Set `LIBRECHAT_IMAGE_TAG` to the published LibreChat release containing Channels. Generate a private service token with `openssl rand -hex 32` and set `CHANNEL_SERVICE_TOKEN` in `.env`. Keep the same Compose files and project name on subsequent commands. -2. Pull and start the application and its dependencies: + + - ```sh - docker compose -f docker-compose.yml -f docker-compose.channels.yml \ - -f docker-compose.mongo-replica.yml up -d --pull always api meilisearch - ``` +LibreChat stores app credentials encrypted; organization setup does not ask for a bot token or app-level token. Use the pencil button, **Edit App**, to update credentials later. Blank secrets keep their saved values; a new client ID requires its matching secret. To change the App ID, register another app. -3. Sign in, save an Agent, and [set up its Slack channel](#set-up-a-manual-slack-app-connection). Enter the bot token in the Agent builder. Set `CHANNEL_ID` in `.env` to the resulting connection ID. `CHANNEL_TENANT_ID` defaults to `_` for an ordinary OSS installation; supply the actual tenant ID for a tenant-scoped installation. For Socket Mode, also set `SLACK_APP_TOKEN` to the matching app-level token with `connections:write`. -4. Start the gateway: +After changing scopes, reconnect the installed app through LibreChat and approve the new grant; Slack settings alone do not update existing tokens. - ```sh - docker compose -f docker-compose.yml -f docker-compose.channels.yml \ - -f docker-compose.mongo-replica.yml --profile channels up -d --pull always channel-gateway - ``` +## Assign an agent -5. Check readiness and startup errors: +An administrator grants bot management through the workspace's users button, **Manage access** (**Manage bot access** dialog). This lets someone assign agents through the bot; it does not grant Agent sharing permission and is not needed just to talk to the bot. - ```sh - docker compose -f docker-compose.yml -f docker-compose.channels.yml \ - -f docker-compose.mongo-replica.yml --profile channels ps -a - docker compose -f docker-compose.yml -f docker-compose.channels.yml \ - -f docker-compose.mongo-replica.yml --profile channels logs --tail=100 api mongodb-init channel-gateway - ``` + + -`mongodb-init` exiting with status 0 is expected. The application and gateway should be running and healthy. A successful Slack credential activation does not prove the gateway is connected: check health and perform a real mention. Missing service/app bindings prevent gateway startup. +Save an agent you have permission to share. In the Agent Builder's **Channels** section, select **Add**, then the **Slack** card in the Channel Library. -The overlay points `LIBRECHAT_INTERNAL_URL` at `http://api:${PORT:-3080}` on the Compose network. The gateway listens on container port `8080`, with no published host ports. Socket Mode needs no inbound port; webhooks need an HTTPS reverse proxy forwarding the required callback paths to `channel-gateway:8080`. The gateway runs as a non-root user with a read-only filesystem and dropped capabilities. + + -For an existing external transaction-capable database, omit the local MongoDB replica overlay and provide the application connection through your normal Compose override. The base Compose file sets the API service's `MONGO_URI`, so changing only `.env` does not replace that service environment entry. Never run the local initializer against an external database. +Choose a **Slack bot**, then **Continue**. If none appear, ask an administrator to connect a workspace and grant you bot management access. -A separate gateway environment file can be supplied through `--env-file .env --env-file /secure/channel-gateway.env`. Keep `CHANNEL_SERVICE_TOKEN` identical in LibreChat's own `.env`; Compose substitution does not update the file mounted into the application. + + -For development or an unreleased checkout, add `-f docker-compose.channels-build.yml` immediately after `-f docker-compose.channels.yml` on **every** Compose command. This explicitly builds both services from the checkout instead of using release images. Use `up -d --build` instead of `up -d --pull always` on that path. The normal release path needs no local Node.js installation or image build. - -To build only the gateway image, use the repository root as its build context: - -```sh -docker build -f packages/channel-gateway/Dockerfile \ - -t librechat-channel-gateway:local . -``` +Choose **Default** for new direct messages and mentions without a channel-specific assignment. Or choose **Channel Specific** and enter the **Slack channel ID** from Slack's channel details, rather than its name. Select **Assign agent**. -#### Existing local data +If another agent already owns that destination, **Replace default agent** or **Replace channel agent** asks for confirmation. Existing conversations keep their original agent. -Back up the database, stop LibreChat and every gateway/worker that writes to it, then stop the database before applying the replica overlay. Retain the existing `data-node` directory; do not delete it or remove its volume. Start with that same data directory and the overlays above. Initialization preserves existing documents and only initializes an unconfigured local `rs0` member at `mongodb:27017`. It refuses a different replica configuration rather than silently reconfiguring it. Verify existing users/history before enabling the gateway, and retain the overlay on future restarts. + + -A single local replica member enables transactions but does not provide high availability. The overlay follows the base development Compose authentication/network settings; it is not a production replica-set recipe. For authenticated, multi-member or production deployments, use the [MongoDB conversion procedure](https://www.mongodb.com/docs/manual/tutorial/convert-standalone-to-replica-set/) and your deployment's backup/security practices. + -### Gateway settings +## Account linking -| Environment variable | Default | Purpose | -| --- | --- | --- | -| `PORT` | `8080` | Gateway HTTP port | -| `LISTEN_HOST` | `0.0.0.0` | Listen address; use loopback for a host-only local process | -| `LIBRECHAT_INTERNAL_URL` | `http://localhost:3080` | LibreChat service origin | -| `CHANNEL_SERVICE_TOKEN` | Required | Shared server-side service-boundary token | -| `CHANNEL_TENANT_ID` | Required | Exact connection tenant; `_` for single-tenant deployments | -| `CHANNEL_ID` | Required | Connection ID, not the Slack channel ID or Agent ID | -| `SLACK_TRANSPORT` | Server policy | Optional assertion: `webhook` or `socket_mode`; must match the server policy | -| `SLACK_APP_TOKEN` | Required for Socket Mode | App-level token for the same Slack app | -| `APP_TITLE` | `LibreChat` | Application name in browser-review button labels, such as “Open in LibreChat” | -| `API_CALL_TIMEOUT_MS` | `10000` | Timeout for individual service and Slack API calls | -| `AGENT_INVOKE_TIMEOUT_MS` | `120000` | Timeout for initial background Response submission, not the full Agent run | +Each participant links their own account on first use and may need to link again after expiry, disconnect, or reactivation. -`SLACK_API_BASE_URL` defaults to `https://slack.com/api/`; leave it unchanged outside controlled tests. Ingress mode, native sessions, lifecycle reactions, signature tolerance and reconnect pacing come from `endpoints.agents.channels` in `librechat.yaml`, not process feature flags. Actor-bound durable execution cannot be disabled. + + -The process exposes `/livez` for HTTP-process liveness, `/readyz` and `/healthz` for actual startup/transport readiness, and `/metrics` for Prometheus metrics. An observed ingress-mode or Socket app-binding mismatch makes the gateway unready. Restart gateway replicas after changing ingress mode or Socket app identity. A successful connection activation confirms Slack credentials, not that a gateway is running or connected. Check gateway health and perform a real mention before treating setup as complete. +Invite the bot to a Slack channel with `/invite @YourBot`, then mention it: `@YourBot hello`. Installation does not invite it to every channel. Or send a direct message when the Messages tab is enabled. -### Native Agent UI and final replies + + -By default, a stable working message provides Stop and, when needed, Review controls. Answers are posted after generation, rather than repeatedly replacing a growing reply. Formatting includes code, tables, links, file attachments, and qualified cost/time details; unavailable costs are not estimated. +Select **Link account** in the bot's private message. Sign in to the intended LibreChat account, check the request, and accept it in the browser. -To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope and `agent_session_stopped` event subscription, and reinstall the app. These are additional to the basic bot configuration above. Then set `endpoints.agents.channels.nativeSessions: true` in `librechat.yaml`. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. + -Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already listed in the basic bot scopes. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. + + -## Kubernetes and Helm +Return to the same Slack message. It updates to show your account name and **Confirm account**. Confirm from the **same Slack account**. If the message has expired or does not update, mention the bot again to recover the prompt. -The LibreChat Helm chart supports a shared workspace gateway or a manually bound gateway. For manual single-connection setup, first select a published LibreChat release containing Channels through `image.tag` and upgrade the application with the gateway disabled. Configure the channel/background policy above in your existing `librechat.yaml`, then create and activate the connection in the Agent builder. Enable the gateway after obtaining its connection ID. + + -Enabling the gateway requires an explicit `image.tag` selecting a published LibreChat release containing Channels; the chart refuses to silently use its older application-version default. The gateway image tag defaults to that same selected release. Earlier releases have no gateway image. A custom `channelGateway.image.tag` is available for deliberate image overrides. +When it shows **Account connected**, send a **new request**; the original is not replayed. A successful answer completes setup. Try a permitted tool to verify tool access too. -### Shared workspace deployment + + -Select a release containing organization workspaces and provide an existing Secret with `CHANNEL_SERVICE_TOKEN`. The service token is shared with LibreChat. No Slack app credentials belong in this Secret: organization admins register their apps in the UI after deployment. Existing explicit API environment entries take precedence over the generated service-token reference. +## Use the agent -The example below selects a replica set for a **fresh bundled MongoDB**. For an existing standalone database, plan and complete its data migration before changing topology; a Helm value does not migrate existing data. For an external transaction-capable database, supply its connection through your normal application configuration and disable the unused bundled database with `mongodb.enabled: false`. Shared mode refuses to render when LibreChat would use a bundled standalone MongoDB; existing external connection overrides remain supported. +Continue in the same Slack thread for follow-up questions. A working message provides **Stop** and, when needed, **Review**. Supported questions and individual tool approvals use private Slack controls; provider sign-in and unsupported forms open the authenticated browser flow. The agent's approval policy still applies. -```yaml filename="shared-workspace-values.yaml" -image: - tag: -mongodb: - architecture: replicaset -channelGateway: - enabled: true - mode: shared - replicaCount: 2 - existingSecretName: gateway-service-credentials - ingress: - enabled: true - host: slack.example.com - tls: - - hosts: [slack.example.com] - secretName: slack-gateway-tls -``` - -Set `DOMAIN_SERVER` and `DOMAIN_CLIENT` through the application's normal environment settings. Use a transaction-capable database; the chart does not convert MongoDB topology. Shared mode supplies the app enablement flag and derives `SLACK_GATEWAY_URL` from its ingress host unless explicitly configured in `librechat.configEnv`. It omits connection IDs, tenant IDs and the Socket Mode token. Shared replicas use rolling updates and the existing durable claims; `mode: single` requires one replica and uses replacement updates. After deployment, organization admins register their apps and configure the displayed Slack URLs through Account settings, then use Agent Builder; no per-workspace Helm values or pods are required. - -### Manual connection deployment - -```yaml filename="channel-values.yaml" -image: - tag: -channelGateway: - enabled: true - channelId: - tenantId: "_" - # Defaults to global.librechat.existingSecretName. - existingSecretName: librechat-credentials-env -``` +Answers can contain code, tables, links, files, and charts. Agent authors can opt into richer layouts using the [rich-message format](/docs/configuration/channel_gateway_reference#rich-agent-messages). Optional native Agent status and lifecycle reactions are configured by the deployment operator. -For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly when the API obtains `APP_TITLE` through a Secret or `global.librechat.env`, or choose a shorter gateway title if the application name is not compatible. Gateway titles must be nonempty after trimming, at most 40 UTF-16 characters, and contain no `<`, `>`, `|` or control characters. Helm rejects incompatible inherited titles before deployment; the application can keep its existing longer name. +Sharing a Slack thread does not share another person's files, account, pending question, or approval authority. **Stop** cancels your authorized work without undoing effects a tool already performed. Wait for the final status; an acknowledgement alone does not mean work has finished. -For manual Socket Mode, the existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. +## Manage connections -The gateway derives the API URL from the chart's internal Service and port. Override `channelGateway.internalUrl` for a deliberately different service boundary. Configure gateway resources and annotations through `channelGateway`. Pod identity, `enableServiceLinks`, DNS, host aliases, image pull secrets, node selectors, tolerations and affinity follow the chart's shared platform settings. The configured ServiceAccount is reused while the gateway keeps its Kubernetes API token automount disabled. Manual single mode installs one gateway with replacement updates, so an upgrade may briefly interrupt Slack connectivity; it does not create another channel or Slack app. +- **Agent assignments:** hover over or focus a connection row and open its gear button, **Manage connection**. Use **Add assignment** for another destination, or **Remove** beside an assignment and confirm. **Delete connection** removes all its assignments after confirmation. Existing threads do not silently move to another agent. +- **Workspace connection:** disabling stops execution while retaining assignments. **Activate channel** confirms the retained assignment; each participant must link and confirm again after reactivation. Removing a manager's access alone does not stop existing assignments or conversations. +- **Your account:** in **Settings → Account → Your channel account links**, rows show the agent name and Slack user/workspace IDs. Hover over the Slack icon to read the link status. Hover over or focus a row, select **Disconnect**, and confirm to withdraw your consent. You can disconnect an unavailable link too; completed actions are not undone. +- **Workspace installation:** in **Settings → Account → Slack → Manage**, use **Disconnect workspace** to retire the installation in LibreChat. This does not uninstall the Slack app. A new installation has a fresh identity and needs new assignments and manager grants. Reconnecting an active installation updates its grant and preserves managers. +- **App registration:** disconnect its workspace first, then use **Remove app** to delete its saved credentials. The app itself remains in Slack. Removing the person who configured it does not delete the organization's installation. -For webhook transport, set the server policy to `webhook`, configure its public HTTPS gateway URL and clear `channelGateway.slackAppTokenKey`. Enable the dedicated gateway Ingress using your installed ingress controller and a trusted TLS certificate: - -```yaml filename="channel-values.yaml" -channelGateway: - slackAppTokenKey: "" - ingress: - enabled: true - host: gateway.example.com - # Empty inherits ingress.className; set this for a different controller. - className: nginx - annotations: {} - tls: - - hosts: [gateway.example.com] - secretName: gateway-tls -``` - -Combine these settings with the enabled gateway and explicit application release above. Set the server's `gatewayUrl` to `https://gateway.example.com`, with no path prefix. The new Ingress routes only `/slack/events` and `/slack/interactions` to the gateway Service on port 8080; its health and metrics routes remain private. It can share the application's hostname: the more specific Slack paths route to the gateway while the existing application Ingress keeps its own backend. Gateway annotations are separate so application rewrite rules cannot silently change callback paths. The gateway Ingress requires Kubernetes 1.19+. - -The chart does not install an ingress controller or issue a TLS certificate. Configure TLS through the example Secret, your normal certificate controller/annotations, or an existing HTTPS termination layer. Slack needs a publicly trusted HTTPS endpoint. If you manage a separate external Ingress or need a custom base-path rewrite, leave `channelGateway.ingress.enabled: false` and route the callback paths to the rendered gateway Service yourself; do not add them as paths on the main application Ingress, whose backend is LibreChat. Socket Mode needs no public ingress. - -By default, the gateway runs without an automatically mounted Kubernetes API token, as a non-root user with a read-only filesystem and dropped capabilities. The chart's global pod/container security contexts are honored for platform-specific overrides. Gateway version labels follow its selected image tag. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating the shared app policy or its bound active connection and transport. - -**The chart does not configure or convert MongoDB topology.** Supply a transaction-capable database before enabling Channels. The default standalone database cannot run this feature. See the [Helm database configuration](/docs/local/helm_chart) for external database credentials. Normal LibreChat remains usable without enabling Channels. - -After applying the values through your normal Helm upgrade, check the gateway Deployment, pod events, logs and readiness. Missing Secret keys block pod startup; incorrect credentials or channel bindings prevent readiness. Finish with a real Slack mention and account linking rather than treating a successful Helm release as proof of integration. - -## Rich Agent messages - -An Agent can return semantic presentation data in its final answer. The gateway validates the document and converts it deterministically to Slack Block Kit; it does not accept arbitrary Slack JSON, callback IDs, approval controls, file identifiers or modal definitions. Ordinary Markdown remains unchanged. This works in both ordinary threads and native Agent sessions, without a new OAuth scope or a configuration migration. - -To enable this behavior for an Agent, add the following to its instructions using the existing Agent editor (or include it in a request when testing): - -> When a chart, table, image or card would help, write a short readable answer followed by exactly one final, top-level fenced code block named `librechat-presentation`. Its JSON must be `{ "version": 1, "blocks": [...] }`. Use only the semantic components described below; never emit raw Slack blocks or interactive callback IDs. Use ordinary Markdown for other answers. Use public HTTPS URLs for images and links. The gateway generates complete text fallbacks from the data, so do not repeat every value in the introductory answer. - -For example, ask the Agent to compare the following measured results and show both a chart and a table. Its final answer can be: - -````text -Latency fell from 20 ms to 17 ms. - -```librechat-presentation -{ - "version": 1, - "blocks": [ - { - "type": "chart", - "title": "Latency", - "chart": { - "type": "line", - "axis_config": { "categories": ["Mon", "Tue"], "y_label": "ms" }, - "series": [{ "name": "p95", "data": [{ "label": "Mon", "value": 20 }, { "label": "Tue", "value": 17 }] }] - } - }, - { "type": "table", "title": "Measurements", "columns": ["Day", "p95 (ms)"], "rows": [["Mon", 20], ["Tue", 17]] } - ] -} -``` -```` - -| Semantic component | Fields and constraints | -| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `text`, `header`, `context`, `code` | `text` string; maximum 3000, 150, 2000 and 3000 Unicode characters respectively. Text components use literal text, so mentions cannot grant interaction authority. Use ordinary Markdown outside the document for formatted prose. | -| `divider` | No additional fields. | -| `image` | `url`, `alt`, optional `title` (150 characters). HTTPS URLs only; alt text is required (2000 characters). The gateway never fetches remote media. | -| `card` | Required `title` (150), optional `subtitle` (150), `body` (200), `image: {url, alt}`, and up to three `links: [{label, url}]`. Labels are at most 75 characters. Links navigate only; they cannot run an Agent action. | -| `carousel` | `cards`: 1–10 cards. | -| `table` | `title` (150), `columns`: 1–20 labels (150 each), `rows`: 1–200 rectangular rows of strings or finite numbers. Maximum 20,000 characters across cells including headers. Numeric cells retain numeric sorting. | -| `chart` | `title` (50), `chart` as described below. | -| `container` | `title` (150), `blocks`: 1–10 text, header, context, code, divider or image components. | -| `layout` | `title` (150), `rows`: 1–5 arrays of 1–3 components, including containers. Charts, tables and carousels each occupy their own row. Layouts cannot nest. The gateway makes the title visible and generates explicit compatibility fallback blocks. | - -Charts support `line`, `bar` and `area` with `axis_config: {categories, x_label?, y_label?}` and `series: [{name, data: [{label, value}]}]`. Categories have 1–20 distinct labels; each series must have exactly one point per category. Series names are distinct; at most 12 series are allowed. Names and labels are at most 20 characters, axis titles 50. Values must be finite; negative values are supported. Pie charts instead use `chart: {type: "pie", segments: [{label, value}]}` with 1–12 distinct labels and positive finite values. - -A document has at most 40 components and the final answer must fit the 128,000-byte presentation parsing boundary. Malformed, incomplete, quoted, ambiguous or unrecognized documents stay on the ordinary text path. The gateway isolates components into messages, counts nested blocks, enforces two charts and 20,000 table characters per message, and preserves every value and link in generated text. Components which exceed Slack's nested block or serialized payload limits become text. The server's existing `maxDeliveryParts` policy still applies, with an explicit shortening notice when needed. - -The gateway freezes versioned blocks and text together before posting. Retries replay that plan. A definitive Slack `invalid_blocks` or `invalid_attachments` rejection permits a text-only retry; ambiguous network outcomes retain the existing reconciliation behavior. Clients that cannot render layouts receive the generated stable fallback blocks. - -This is rich **message** support. Existing app-owned Stop, approval, question and feedback workflows remain responsible for interactions. New input forms, App Home, modals, Work Objects, plan/task execution controls and embedded video are not exposed to Agent output. Authorized file attachments continue through the existing artifact delivery path. Slack may limit newer blocks by client or app availability; automated tests cover SDK payloads and rejection fallback, while live rendering requires a configured Slack workspace. - -## Identity and permissions - -### Shared versus per-user credentials - -`per_user` binds each linked Slack actor to that actor's existing LibreChat account. Current tenant membership, account state, role capabilities, Agent permissions, and tool/provider credentials are evaluated for that user. - -`shared` does **not** make the Agent public to every Slack participant. Linking is restricted to the channel creator's LibreChat account; execution uses that explicitly linked principal's authority. Do not treat the activator's API key, a Slack display name, an email assertion, or another participant's thread history as consent for a new actor. - -Each actor/link revision has its own execution lane. Sharing a Slack thread does not share a LibreChat conversation or expose another actor's files, OAuth state, approvals, usage, or trace session. A different actor cannot inherit the first participant's pending question or approve its tool call. Mode/revision changes, unlinking, account removal, Agent access revocation, and key revocation invalidate old authority rather than silently remapping it. - -### Account linking - -On the first mention, the gateway sends the actor a private linking prompt. Open its trusted LibreChat URL, sign in, preview the request, and accept it. The same private Slack message updates to show the account name and **Confirm account**. Confirm it from the same Slack account, then send a fresh request once it shows **Account connected**. If the prompt has expired or does not update, mention the bot again to recover it. The gateway does not replay the original request after linking, and browser acceptance alone does not activate the link. - -Manage and revoke your links in Account settings. A link can become unavailable when the channel or account is no longer eligible; you can still withdraw that consent. Restoring eligibility does not reactivate a link you explicitly revoked. - -Browser endpoints under `/api/channels/links` support preview, acceptance, listing, and revocation. Mutations require the normal authenticated browser and same-origin checks. Ticket lifetime defaults to 10 minutes; accepted links default to 30 days. Never post a bearer credential or provider OAuth URL into Slack. - -## Delivery recovery - -The gateway preserves each frozen delivery operation and its receipt. A required operation whose provider result is unknown holds its actor lane: retrying blindly could post the same answer twice. Stopping a worker or requesting cancellation does not prove whether Slack accepted an earlier request. - -### Reconcile a verified provider result - -1. Pause gateway processing for the affected channel while investigating. Keep the channel enabled and preserve its actor link and source authority; disabling these is not a recovery bypass. -2. Inspect the frozen run plan and retained receipt. Verify in the provider that the exact operation reached the intended channel or thread. Record its message key or file ID, matching the retained attempt and any upload checkpoint. If the result cannot be verified, leave the receipt unknown and the lane held. -3. After the old lease expires, use `POST /api/channels/service/:channelId/runs/claim` with `{ "owner": "" }`, normal private service authentication and tenant binding. Verify that the returned run ID is the run being investigated; claims select eligible work and do not take a target run ID. Use the returned current fence, renewing it through `POST /renew` as needed. An expired or replaced worker's fence cannot reconcile the run. -4. Submit the confirmed receipt through the private channel API. These endpoints confirm existing attempts; they do not send messages, replace the frozen plan, reset attempts or accept a retryable outcome. - -All paths below are relative to `/api/channels/service/:channelId/runs/:runId`. Send the channel service bearer token and the configured tenant header, using the same internal service URL as the gateway. Preserve the complete fence returned by the claim. - -For a delivery operation, `POST /delivery/reconcile`: - -```json -{ - "fence": { "runId": "", "owner": "", "epoch": 1 }, - "receipt": { - "operationId": "", - "outcome": "confirmed", - "attempts": 1, - "externalMessageKey": ":" - } -} -``` - -Replace every illustrative value with the actual current fence and retained attempt count; do not assume the example epoch is current. Supply `externalFileId` for a verified file operation as required by its frozen operation and checkpoint. Existing provider identities are immutable; reconciliation cannot replace them with a different message or file. - -For a progress update, `POST /progress/reconcile` with the current `fence`, the retained progress `revision`, and a `receipt` containing `outcome: "confirmed"`, the retained `attempts` and verified `externalMessageKey`. The message identity remains fixed across progress revisions. - -Once every required delivery operation is confirmed, `POST /commit` with the current `fence` to complete delivery and release the actor lane. Resume normal gateway processing afterward. If any required result remains uncertain, keep the run held rather than resending or recreating it. Optional exhausted effects follow the gateway's bounded recovery policy and do not justify replaying a required answer. - -## Gateway protocol boundary - -Service requests use `Authorization: Bearer ` and the exact tenant/channel context. For routes without a tenant path parameter, send the channel's exact tenant in `x-tenant-id`; do not choose a tenant from untrusted message text. The service token permits this integration boundary, not arbitrary user impersonation. Never put it in client-side code, Slack messages, tracing payloads, or public logs. The credential bundle endpoint returns secrets to the trusted gateway and must not be exposed as a public discovery API. - -| Stage | Route under `/api/channels` | Responsibility | -| --- | --- | --- | -| Configuration | `GET /service/slack/{tenantId}/{channelId}` | Read the active channel and encrypted-at-rest credentials through an authenticated service boundary | -| Identity | `/service/{channelId}/identity/{externalUserId}` and its ticket/confirm operations | Resolve explicit actor linking; never infer a principal from thread history | -| Admission | `POST /service/{channelId}/runs` | Admit an idempotent event with verified team/app/actor identity | -| Ownership | `POST /service/{channelId}/runs/claim`, then `/{runId}/renew` or `/{runId}/yield` | Claim, renew, or safely yield the exact polling lease | -| Execution preparation | `POST /service/{channelId}/runs/{runId}/response/prepare` | Obtain the bound execution credential, request, and stable request key | -| Response binding | `POST /service/{channelId}/runs/{runId}/response/bind` | Bind the returned Responses identity to the admitted run | -| Progress and result | `/{runId}/advance`, `/{runId}/progress/*`, `/{runId}/plan`, `/{runId}/delivery/*`, `/{runId}/commit` | Project canonical state and record fenced delivery effects | -| Review projection | `POST /service/{channelId}/runs/{runId}/review` | Reauthorize the original actor; obtain the browser fallback and, for the exact external channel, the current private question/tool-review payload | -| Review decision | `POST /service/{channelId}/runs/{runId}/review/decision` | Submit the current actor's decision to the same canonical Response, using its immutable decision receipt and resume preflight | -| Artifacts | `POST /service/{channelId}/runs/{runId}/artifacts/{artifactId}` | Read only an artifact bound to the authorized run | -| Stop | `POST /service/{channelId}/runs/stop-thread` or `/{runId}/cancel` | Cancel only the authorized actor lane/run | -| Feedback | `POST /service/{channelId}/reactions` | Apply authenticated, deduplicated reaction events to confirmed delivered replies | - -Run-relative paths in the table are beneath `/service/{channelId}/runs`. Lease mutations carry the exact server-issued `{ runId, owner, epoch }` fence. Treat stale leases, changed authority, and ambiguous delivery outcomes as protocol states to reconcile, not permission to mint a new run or blindly resend a Slack message. +## Set up a manual Slack app connection -A gateway can yield a Responses-bound polling turn only after its progress writes and renewal loop have drained. The backend invalidates that polling fence and enforces a one-second reclaim cooldown; the next claim increments the epoch. This does not release the actor lane, cancel the provider, change the Response, or erase delivery evidence. Inflight or unknown remote writes cannot yield. If a host does not support yield or the request is uncertain, retain ordinary lease-expiry recovery instead of starting a new execution. +Use this path when organization workspaces are not enabled. Your operator must enable manual Channels and [prepare the gateway](/docs/configuration/channel_gateway#configuration-and-prerequisites). -Execution preparation returns an `apiKey`, `requestKey`, optional retained `responseId`, and a Responses `request` with the Agent ID, admitted input, `background: true`, `store: true`, and any authorized continuation. Submit that request to `/api/agents/v1/responses` using the bound key and `Idempotency-Key: `, then bind the returned response ID. Do not substitute a creator's unrestricted key, change the actor/Agent, or send the input to a channel bookkeeping route to execute it. + + -The gateway owns Slack event verification, retry/deduplication, native message formatting, rate-limit handling, and delivery receipt reconciliation. Preserve exact event identifiers and timestamps. For feedback events, `eventTimestampUs` is an integer timestamp in microseconds; do not round it to milliseconds. Report confirmed, failed, or ambiguous side effects accurately before advancing delivery state. +Save the agent, then choose **Channels → Add → Slack**. Choose **Per-user accounts** for each participant's own account, or **Channel owner only** to restrict use to the creator. Select **Continue**. Owner-only mode does not lend your account to others. -## Review, files, feedback, and privacy + + -The public run snapshot contains only an opaque action descriptor. A review request with the original verified actor, current channel revision, and exact `externalChannelId` can obtain minimal private question/tool-approval details. The backend derives the owner and Response from the run and checks the current actor link and source grant; it does not accept an arbitrary user ID. The gateway must show these details only to that actor, not publicly in a shared thread. Slack can use ephemeral choice buttons and private modals. Native tool approval is for the individual call only; unsupported/richer forms retain the browser fallback. +In **Create**, select **Create in Slack** to open Slack with the generated manifest. Choose the workspace, create the app, then **Install to Workspace → Allow**. If the link fails, expand **Link not working? Paste the manifest manually**. Make later app changes in Slack's app settings. -Decision requests include that same actor, revision, external channel, and the existing Responses `decision` body. Backend decision receipts, expiry/conflict checks, full authorization preflight, and same-Response resume remain authoritative. A Slack click alone is not permission to resume work. Provider OAuth URLs remain exclusively in the authenticated browser review flow. See the [background Responses lifecycle](/docs/features/background_responses#review-a-required-action). + -The gateway uses private Slack controls for supported questions and individual tool approvals/declines. Tool names and argument previews, when supplied by the authorized review projection, remain private to that actor. Successful submission closes the modal and sends a private acknowledgement; it does not force a separate browser receipt page or claim the tool finished. Provider sign-in and unsupported review forms still open the authenticated browser flow. The Agent's existing approval policy determines whether a tool needs approval; connecting Slack does not make every tool manual or bypass that policy. + + -A saved decision whose queue publication failed remains retryable with the exact immutable decision; it cannot be replaced by a different answer. Keep Stop available while work remains active and update public progress only through the fenced delivery protocol. +In **Credentials**, enter the matching **Slack app ID** and **Bot token**. Webhook mode also requires the **Signing secret**. Select **Continue**, review the values in **Activate**, then select **Activate channel**. LibreChat verifies the bot identity and stores the credentials encrypted. -Artifacts are scoped to the authorized run and actor. User-submitted rows do not count as server-generated provenance for artifacts or trace links. Limits default to five files and 10 MiB per file. One `artifactReadTimeoutMs` budget (30 seconds by default) covers catalog queries, storage reads and final authorization rather than restarting for every file. Limits resolution is separately capped at 60 seconds, and its elapsed time counts against the selected budget once available. An expired budget omits artifacts while retaining the answer for authorized text delivery. + + -New plain-text answer files require more than `artifactAnswerFileThresholdBytes` UTF-8 bytes (6,000 by default); fenced answers also qualify. This threshold controls new projections, while saved descriptors retain their content identity and still require current authorization, retention and maximum-size checks. Do not replace an unavailable artifact with another actor's file or an unauthenticated internal download URL. Usage and cost summaries identify incomplete or unavailable coverage instead of presenting a partial subtotal as the complete thread total. +Hover over or focus the Slack/status icon in the connection dialog to find the **Connection ID**. Give it to the operator to [start the bound gateway](/docs/configuration/channel_gateway#run-the-slack-gateway). Invite and mention the bot, then complete [account linking](#account-linking). -Reaction feedback maps only to confirmed delivered assistant messages. It does not overwrite the browser's feedback field. Export is constrained by recorded sampling/destination provenance and current export policy. Temporary-chat provenance is retained; an old mapping without that provenance is not treated as a permanent chat. A policy change can suppress export even when the original trace was sampled. + + -## Operational limits -Disabling a channel or changing its credential mode retires old authority; it does not undo external tool effects. Stop can remain pending until the exact provider is drained and canonical cancellation/cleanup completes. A gateway must poll/reconcile canonical state rather than interpreting an acknowledgement as terminal completion. +In **Manage connection**, the pencil beside the identity mode changes who can use the connection. An active connection must be disabled first; confirm **Disable and change**, choose the mode, and **Save**. Existing links and pending requests stop working. After saving, reopen **Manage connection → Setup**. Use the existing Slack app, re-enter its bot token (and signing secret for webhooks), then finish the wizard and select **Activate channel**. Each participant must link and confirm again. -With the process-local job store, restarting the API while a tool approval is pending makes the review unavailable. The request stays held for reconciliation and a stale approval does not execute the tool. Durable checkpoint storage alone does not recreate the missing live execution state. Completed history and subsequent thread continuation survive restart. +## Troubleshooting -The gateway package is built from the LibreChat source tree; it is not published as an npm package. This integration does not promise arbitrary chat-platform support or restart-survival of an in-memory OAuth waiter. A restart can require a new browser sign-in; uncertain continuation must not be reported as completed or retried as new work. +| Problem | What to check | +| --- | --- | +| Channels or a Slack bot is missing | Save the agent first. Check gateway setup, Agent and Remote Agents permissions, sharing access, and bot management access. | +| Events URL will not verify, or Slack callbacks return `401` | Gateway is running on public HTTPS; the URL and **Signing Secret** belong to the same saved app. Check clock synchronization; do not disable signature checks. | +| The bot does not respond | Invite it to the channel, assign an agent, and check the personal link. For organization workspaces, turn **Socket Mode off** and enable Events with the subscriptions above. Ask the operator to check [gateway readiness](/docs/configuration/channel_gateway#verify-the-gateway). | +| Confirmation, approval, or Stop does nothing | Enable **Interactivity** and save its exact Request URL. The Events URL is a separate callback. | +| Link is awaiting confirmation | Select **Confirm account** in the private Slack message, then send a new request. Mention the bot again to recover the prompt if needed. | +| Permissions are missing after scopes changed | Reconnect through LibreChat and approve the updated grant. Existing tokens do not gain scopes automatically. | + +If an approval becomes unavailable after a server restart, ask an administrator to check the [recovery limits](/docs/configuration/channel_gateway_reference#operational-limits). A stale approval does not execute the tool; check the original run before starting the work again. diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index f7306615c..535cff71c 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -25,7 +25,7 @@ endpoints: `enabled` defaults to `false`. `acknowledgementTimeoutMs` defaults to `10000` and accepts integers from `100` through `60000`; it bounds the worker admission acknowledgement, not total model execution time. Existing Remote Agents permissions, Agent access, terms acceptance, content checks, and provider/tool policies still apply. -Stored background Responses require a MongoDB replica set or another verified transaction-capable database. Standalone MongoDB and FerretDB 2.7 do not support this durable feature; ordinary LibreChat remains available. See the [local replica setup](/docs/features/agent_channels#docker-compose). +Stored background Responses require a MongoDB replica set or another verified transaction-capable database. Standalone MongoDB and FerretDB 2.7 do not support this durable feature; ordinary LibreChat remains available. See the [local replica setup](/docs/configuration/channel_gateway#docker-compose). Background submission requires an **Agent API key**, including when ordinary inference also accepts OIDC. A management API machine token is not an execution credential. Configure [Remote Agents permissions](/docs/features/agents_api#setup) separately. diff --git a/public/images/features/agent_channels/account-accepted-dark.jpg b/public/images/features/agent_channels/account-accepted-dark.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3bf887a622db8d83aa506528b3901c03379e4b6f GIT binary patch literal 37276 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

v~M-$p?6*_ia*#yZydd;vbmWz|zP;vW@-RKt? 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 ^pf#Brv& zMNo;b`So=VDjmH#?|&rlgM`@>zBZ5=he1h4>jjGsUzX;R;v=oXmp^YScWQF){7BTp zCg09w_5r~VM97*<#$H~nTuX=F-+hG{UJQD;p$jOYz7Ecags8vfs6AMe?=;SRHJRz@ zTs2HMm0c;jQNQy;lHa}NUQ0!3%=d0YbJt(pQrsVkyoYNU6fo_~kapc=AtVfA^Gr{Y z&V1V^sFKp_#fukEiX~}HHgOnSK9Z*r<6#n!%a{N7DpzLyH1$O}U+*T?RLpkkyX7~3 zpLc^{x51HuGr5#r7oG33+6Q3+sfeEMyaK+TC^((#YoF_|yevD*qCyit_~m{VO|b7q zYa4QBzxst?Qq-w~fN4P+b&@4b)3nmRM(}l`Mq32x!y9|@aNLpdVwo0PGneVy zNZ;~HnnkXOH3j3_dT^bUIu>D8d2##VG~9n>M(GZw(TI=K7bPx~$hf)sNf#>dhgm5q zJ+yz5U32gtckesT%z*wUr>Gdxb_!>hrk^Oy`Xh#PWHQQJbCl=69&u;sH=aF~6N%u# zv#F0OjXXRmmrVva-<4RZybU3`_ACv?**LV?vg;o^SarMA z+kR0<&rLCB!fYeH4WBP*!QNN;Li&JfCTn;ja=2>Qgg_$L+9f;DbOd+l#hVqSv-QZf z8&e0mvL9>vQ8$x8AP%q?6o$pY`PzTDfb1IjMTT`O+5W&w7WTdjpNbxa>BD~)hV&aA zppk*}=l;zzK4|Hc5!@&Xieeky46{g>D$_@o_|#^+ay*X}IJn>ESFVeS4!9}m>JE<8 z`WoduhJdNMMf zXHDT;#+1PqFlh9PN*ANlM0x?QMdH%e@!!ufB{AP@)}OJ{=Jw&F_v=_U7I${?S2lhf z`YYemC?`|mx7zt^wXa3paxq7mazq|qnK~JTn_Ew!iz`bv6%{$SIOdB|0aA?R%7anJ zoi2{n-J-`1FT!YoX5wojdW_=Nc0y{kmPVqmiA;aR_K$3by=+9$(*uDF4AZN&u5IyU zNUffK=$hDn)o&#=`p(*Izhpxcuv9thu1O0DknjT;*^g1$?S_Vx#m!%@qr>KDb9MQ% z)hg~w?i%aOzfq)!${%sPCA|8!fSmN*nh-Kp{->C|ke#}NCHTNOa_R0feUT(;_K$%= z{G_jpa?1LJUS;|%=&i8P7(aWU;2x(tB()O%7<<&&Od<+#5Wqk0`L*BkzmxFq7nHvq z9FI&j^l!%Sqxg4`@nrw1^%rmZksvWy&5`4O_lO(Wp#!ayjQY~wJu!Od=s^ULN%;LY zALMq`yJyfDfm?!~pP$rCfhZjw69XJi;-^nfQ#8Ym5q|ypC1BD7itq)}$7Cz=mX@Td zOwB6wB1Ku>!QuNmfpl*T&%cj-@`_Byv)@5;7}#4eoTQv>C7iA3-!*-(NaT0@H424p z-ke`?=;l>{RGj_S@j?0VS@zHDcLJ)er@hqFJ|BGd%WavbnJ-ke{WB-TNawxnFR!4` z($XT-adrN%7wrZO>5pW$2AQS2ZVh^v1y`!ic6E0C4GeN_%36zV%~3!qVQ?D<-{ia$ zlunt+-gMu)lS{!9}d7!_D^Q=>ZM) zBt=;vM!-a&7?@CH1%+lV*~>NgC%o^hz8R&#~>>a=FAR%^WIDnROH zc&q?8H9+=i1F02QqRhJilwzOzi!Hi9coG3J8&sgUU7*Xa5uw}D3&RdECxECB$q*pV`M6vBxUFa1uLkC#czN;sRXJ6WF=6zqUdE@)c!waDE9o9flG+B&Ju6eqP^T-jfFl7R76hw*31iHg(@a9&HL}&9 zE6De;sdU99e*U~N8KxYYTEpTxoNOA*>bu(kE-)LjBySfrwN79K+Qe}Z5vo_tjUHJ> z(0t}Rji;8t`zex`#xCzo^vuz9;DY7}+3*0wK30OrT!7m1I6`(i|MZ0$x97Y;en@=~ z;_v`FT%lgF36F?t$jGTf2Aaz2HDRcgRxJqeTk~8s3m5?MRa&sD0RDl^q|9aSB%n_` z5;{i6P>f5ouVbilophRt(8i7+hukgUp#dG+by)-KAn<^6lJ5pUx6afjx&#vF7|_m` zuR4N~nq@WyAzy(cF-_rT{PVTAT@kv6>6RFOT&`9+^atiB5}yi6+D)6`tORF>v+V5b zHldA>uMl?qfg2&aNB67A{9g8ecuJ#m>nSwG#&z#cc)0*6vW-^dGF+!Xk=eG_i-VkB zP%+I&{Gom5jwHgR@Srs57P27_~kpN~(3bdGDdcJ(q1<)7g zmcHw^U7DGTXY0>a=OAkJW~%4lS;M^m(ks%U!fZch)B#1rR)jpmSYYbJ}E95??BY z)=K4*3QE>R;RZ@^09in{i*pWtTSw-*{F{Er-+rR5q6=ZNaQQUT&F*hhaxeT`B~}`) zlqNTHo`*eRCLh6V!V0?9Bv8>EM}f8Yp5cUoPQhPn*Wse2oaRo+X0cTt7A~Ah|9w0; zX~_?RD#tUCdn0T8X7h>e!-!UnW;5IBEmNXH#mVFF6d44bzm?k-TX~G~L4G*lbSmxb z-k*EatqJ0NMBU$e`@1vJ+c7G}g;b1AZfU0G!fX`P^7z$ah<6{*N3A}s-P1vOIJ2yA zN*h6Q?zyp8NYnr7#*U%v*Q`?)Zosa){-?(O2!+#=v?Icr#@*&4WwsdL_9bWf=H0MB zbSgo@HtV(umE3sD!ae5=%z+IwIrn)rMJ6UDP}}o7r+v5QGMnymf0u%7;;)|QwbBR` zj92SxG*P_ZRKchtd@Q|3nD9sz)cJ@KrySd!>TK5s5p1S4ZpNqS7!p>gQ|i=88CT%u z>Gd*U#`|D!dQo~L$$LX5k|qny*1XL9&MGxuuM9h6i$bG(eed4=2}U^Upx*Na-=5q7 zbB12Ad9t^>?2W;e9GQOlM299WB@axoMHu&yLAT6AkDL!Ty9b?sEH$SYG}Gk&gMwTk zP|acjxy3*D?C#ECvK0T%d3!xc3ybWJ7sAj*+-(ap7}175w)LROXTQ2wGMST(xk=f7 z%NtsKwA)0;#$nG1M4jPftvQ2wk#>pI_c^B-Nqjf-@Y_fk{HjydZa(W3y_P--=9@1b z!xmaMo?-S}$6+wL>cQV?2P{D0|L{?x&KGvM6k+t$`}e1a`Ps>LWJR_0?E~hovdeCF zbg!V6Qd#emgjzYz&6LPTU1x+=L$$HgW{5dgqRM04Qd5~Ohv;)%T}@4cQnORlrAzs} zPxG1x%B(#x%FtuZz!jaYR@&w2jYo-tHKn7uU2Nf+t6ykvaFOI&Qe>y@E!^v;{* zA;!}w{54U0Muz*Ot~n^~O!ln;mWGk%*e0F=Qc7VFHUD$T^Y9x+(-Dsa-YG|xU+-DO zwM31s@Mz|wu`HKQe24>r_XxGb6EkPfEeCxV!;uMFp%?gnmLIP2o|V;;Y}h0xyMM$} zw&xp;Zj;2Whu-MkFv{1j0F`-yq?|nfFTx$^L)_g9ZzqBBDY_Ez#JM=x(vPycEnIBd z;?Ea<%j4Lx<35QWKq0IbrSqL?irAJ>Pyd;SI?wGbRwA5raXdbt+^X+73wCx!fp=8a z%YA9EWW6A^Y8_$WrCmE$uNtiAD?@gsWG&U0?>a=xCze!|JhFoCRYrb&wlO{r*7c^Z zrUHyXt#!&<3g?f})V0o-wnQf<-R!~B4JH)LMvU}4#siz$&%Um|cQfXjk6!AXukWPT z2HGaMQO2KdIv#FsYPF;$?{FR(YNa=#y`WcLm?dFk^ zz9Twm|MNzLv_?xtB4UD}28V~!cJ|ndyDZuneaQ-{Tu!hmv>W?*EmL}<-xy5|&ZI%G zE`josPU!dUX#4T{pKf^iwAa`aO2!v9rK$|=5^|e(cVtNnhELes!v=y$z8TWf8+p(`#!b1nIuu)hTkfymDaP0-Z8lGdFDL_zWdx=9(jT z%qVElJL?N(wyO&gp7_x_G?Akida^U8yZ3T2bKoXq|EH|55Or9`lW9nolpm=go~GR8ZDu1r(Dz&_0RYvdtgNdWYnjX4z^C*57g0VT z4sL@Sl{faTjtuo;K)@3@TrravXW~bS?4{rS>X}NdV@D+-?ss2GI}H{ATT@YgN16IB zcV1OGFJ$jK`n|}Rjv7@5`&fjHZs`m6ItH^@zenkz*Kk7=WSoz!2a6lW2G|v2vv%j4 z=1hE(5BoMdJRq_Fq5m{JJAmmU^bD8Zbl5w*xd}jt9-8 z%&Jd`EdUBX3$#mihlN+>&8J~!oiepS5jWzfj(7iq2VHMUVhZ4JK5GdCzQv*838Kfh zlNO2YcX(v?M;zNFEvH=`hbe zFC?pYkGRi>(j$kAvcNsLgTA96ZP#Saofu~~w|N(rJ}c$B=Oz3-S8Cp=&GMh+A&qaS zyr;o+N{iiI&pgHdX!(MRanXb>@=cP@wnf|s6zE)Ln|b5CiW&c9Ywb-iPbY<42*FjI6#p`ZgCxE<{lXPG)?fP7d}Nmxujv*)EZKxUVRNC64?jSoETKBJ z+0vp=!bc$}GIXd(Q`=xlWUocAz5B<B~@`fr0cTHyN<$a=G%AZ7(_a*?)$D;O$ zI6$Boj4}W)LJH`7`@cOEZJ*358yT!}FFMwJUkLi3sTs%#%9{4pfV^@6h1ORX|AGH| zUr_c6T-u(1)~?8Y=w2&Ls=Y>pT>xl&8MFqgg*QZiYn%XSm6>nZje_RIDrBy*KHsy{ z0O8JQurTu=*#j~x_U0Zl=gdO+Oj?+d2iVCMS*B%tcR}iQi8#4-Z&YCm;B2;-D$2*3 zsL(HzTb^5X^2N+)pTy+vGp7MaUkbF)Nd1EXpo+|U0pkJ-iU8UyUVg#!UX=96dXxf6 zhi*un>q0Lnm!BHZR0BU4WY5NEoXHB9ZrXsy@8I&?M?kuWwH|$LslY1bRgPr9K`;0L04y&aRCliq8G7=z8~CZR z5f3W}uMnJNEv)I>$A{A8me)I!May1N_?fRlFBpDJM-4>s)6)~Zb^Svyp?>RUcU0uByJ8jh? zaaMP?tV1r^Kh>{|l%|aXENQ?t0w!%MHg+~PxWB1DRv!YWgPH$qK_(ui8M>91>R)JF zUs-P@sE{OOz@!j;1up*YhEAIPVT)1vnG(f}l#yBEfx=aylEyix|j}kt@m} zwNHw&mmwvuBYOWrFzNso;*|DDVs~cCvwwc^#ef?OwY>df zdpwx0`}|i{K9>5~dJ_Ormi-Agp1#C{i%maDiUyFWj1eERR+* z5%mGAOX|-lxwad&ox9p?MxV#swC*fO8_{mgeh>nSVI`9-Q(G!PXoV->u>`_m_w|DI ztQhmcbwu`&E2ty~psUoMXpxP8tO`kI%r%fNaNMTIw3T)xA^+*xP;zm>h4fK%00BgW zYx?E*$`J(V z^7?Yl5wF@er@`)~39d>r1%{+!ry18~JAgr9fTT1~?TvURu!(j}Vj(ORwV%KC_{qwH zy(;-EK;}eJHG$lS{ZzlB?=oPL1no04ofW?OJ_nTfan-eBZV`5}ADCl4e}2Xa4H}?H zEovT(tTQw;sr;}t!Gfb(V2DiNt+o2JSOfl^)$6)5?TFWD_uriZqRER?plShY0u5*t zrup@8#|PkILYfvK{pB7owXZql3j7Oz9l8=K@vO@e6qVFaslgPP;FI7Y2AhwXjdtsR zk{0ODV6RD)q^8vh7mV210-yGng_VnL3{5um52!F1JnIilO%5K{NXIsR1G=j z_WS7?9LeA!&NoDE|4F{LksM1c#IyNJnsAF6$Zu^F{}}J9q)V9J_J9Q}G)Y!a+qANx zE1{y((O^0gd?|0@mDx1pPqM;-lcx#qk$gh?p_Sov@LIqyK+W}iD8eN-lulOxzbrQa z@!7J)QW6=zCI!J0-{pBhe%9wo`Z7qMKyj?VCM>>U{Onn`lP2)P!^)(b@kJ%5j?Adq z%Uv7~q*jc+%G+206FGny2&cIex$0$SkC|a_YY0_HPv4PW*XO!qWppPNWQhQZ5gkGzD@_kwM9^iTMf?Jt5)8=T)iAHTW%qbhg^=uaV^UALk1 zc&Sfa>?zLU@rfUI(mw<5-D`2_7T{UvTzq;aBPIc(Zm2k#W?325<{*cj_8{q8OLlp6 zi!a==`{GcrjP}Drx7aquBJ5~J1%3XC6}o|Vt}>hJj;%eAeBk~19lHoK7p1T{Cu}R{ zGX9r)Eg1jC(qQ6e1UdzTxyfo=dU#xTc$z=hzPYzS)(}_w@#qoBDDFEEA~H+^ zb5;Ee*A1)6Psn67fAl1c*z6=D)N7y>dEk-_&2HM=HAunVz+AQIX59pT0EuGyZG<&X zw{XFHG0S5xr9vee=8L&y{|r!8@njj=MK2PUzEuSi0;Se>lh)oa*?db9`7S?u69(vE z2`cN&k)nK}Q{n0kq6a(eE*GO`GN#a27Q}@RoDH6x{xIT@tH&aujRQeHSiQ_lnFJ+9 z{qR@K+{m2r*mq%`wP!{ICf^usIJ)wT(xzW2*NEMxk>Y@|MbfBBt@Sot7P~UrA=^sr z5sYbGL+UHqjjh0_dwM&#(Qjt2Ln5N84)da4XnOJ=E`SDGy$lm7+adPc^L2e9hSxJm z0-y>fOuE8!G6H#7=lT(^FPCzsu!&o+KRST|p3$|J@6nD(ReTIVu1}dELa2JoJybFR ziJmk#^}rwM;LtKya!#?=1Qt&xOtoV-9PV^}S4@-`z%jpmdo5Y-Nq{d*Q?=Pa;{LD2 zII;_R($eo*p!XFXJ!;JNnje0kwEhUy6Yg9c<#re=|pf7JKf)%hcq(v2%usy0VFn>H+|zt4D>GcFmFie7ptKkEYP zfuL8zWf6y|fE@INT3ZqSpKCm1_=bwb@?HmjJ+q)iXIgH4Ws_*|WB0uPdP8$`Wr_DK zlO|f%KtoX`5u13VzZF6MDf~MIf zf^o@zEH(C;#sPI|3@M-GfYJcc-q~RhRNIW$Qb*4sAeOk!m01t>8pyw zjBpe{V@?8}>R)>0!N2{)3%#D*nRw5Y47I<9aHP1EzDcS%_nl6lgJ`){0CYuhs@|;y z0^AcUhv1AfPl~;1tvf1wC0Xe|rA2)JWu&EnOtjAcqkTYV3hO7| zCC~g&`Q*n-fCLoMdYbP@oF8a|mIRodO_1`gd=~dIX(wk9p7$;=f!}IZXWB^u?Ry+p zQ!#`nIEhF${1WT zBAQ%=d8eSTc6>XgA>SAMkT;n$Bccph3_y}4psacp*Z8i^WOyrwy7H8d2Sg)TfLgfL z=+uB&68P;mNmB-_+=sx-u1EKTi5$ER8l2S|gI2E=Zw&KWc5~7Rk{lUcBJl?dHp6;R zyA%^tyj4+{GBUhoVIw(b9J`jksYyP<{Em?&{=>G=VqdM- z^{79~po%~s{KLidXrcbm#9%rO7VTQx!@CLpMlSM@VfF5ce8fFXW734Ai0w#xY;2`* zJ(Zr7=JF~~N+o9Afma0u)%i;R&Vp$*@?3&tG^GJIEzg$`hh|>xJK|ei1P^*#M{50K zW0>{68Kpcay}%p;$i!i_dgfY|9*+U~l9Is%lv2Z8-GjS3tCIuM*b0sW5DH)gbHC(& zgyFU}pchG%47F4`RNNCUKjnD7F1Bxlr`C18dk%(A2=HXr?|L5`7z%ri}Hl= zP$T!Lh_`>ilU?vU<=@wNeEZ+iU4|$0GyL#dO6JOPG-78?|#>dB> z?L8&CuQV;)+10gPKw8Q(ELF6l5j`|s;}entSTZ*ycmYKY^&?WCa@r+6`U%s?@7}!w zSd_3@a4lIs*%w~KbIR{w7kz8u%sE`DEe2R0D%f$PjY`W*ebg=e?d0ThV(u8AI_}EM z%uFUScV!Gr-X0})^QP!|=`vb#sM;I8eEZH84^tc`>D3?5p5|Q4Iy?$ltDKX*L3!f^ zeb2}e`L!lIX|uz^L(|EA`&+ZN!i8_FF&?MyP2UBbxBd5>z2%gf1i)_}EgE}QD@Im)GNIYy%$ zMv+$s$IuA}zo{Xar0JoKx`YE0s-G8a$RVlAm+#QI4LL_1I%5Ka<@$PeRJV&NY4I-k zg1%kG(GG5@KV)y^HWnToSlm|ByU7Xt{f{*_I=xT%Wj#kFZ|BUPv?85jGB`_|p!D$J zjcP}y(|(+hk&&i*TR%zfDQKWjr61Mo65M}&giN)$^!otcHTbKa*BNJ#mqG8|@ee;^ zeCx5X_hI8C$;o?(6%1T6pLJ_!1Ox?78$CYw6A)pqLl1uT(e@VMz?k*_vDxl+)uB-? zlcsR@ec~n$xB{k%z`_cpum>hKNk%fip8=E-qx?WqG+#%`gAoUm1rzu?8LgPc=%*6k zt}AUZ)lf>8Fep?|02C_Z)i62I77cO*XjK4ZbZWtR2mS8Blci)iylVuJ3oL4H zx;%YA3V2+g$#aE#N9v`aUjr|Ht17&#!KO3k)=a$PV5#*Eq|lfu`yb@=@t)WUk~jes zwyUd)WRoKGN8s*(Do7pg226p=lV5Mok~;K8zP25yf4L(rbC?bwsf`JNq+wIwam~6A zaD8bR8H}Xc2>@Tc5WLj|=vMFsIoE|RgRFfg^r9q)%>2(AK7xlTj?)oH;Q{}4sht-; zUXs^Y{YwyK*(_dkuWC1mGT4ApJM2D_AeS?p)d37CKr*9THpB_&W)i@~u^m!8N5Wo= zBY;!^;(%iS)=^D%M;On&Pbzsz9_=kH`oN|FF_L`fVCykjGs+5!`hyCE_%|oINmcaqM=37ZKQ2OhqzxB8s7Zw|y^;B-J=T z_BToAqbx|RJZuE8nluy5#wJrsddb#t(#n+f8$t(6(k&ijz=SC^3^2oh^R)TO*U&~L z0P9~t;ynhtaqT+EIm27Z^TVo8uTk~)m3!n$T zh8BP0rE|1xOEoZ;1n&Z|Fsqu!0|iwJH{0#^j6~c-{b*g9W_EOiZ3&7(yJWLKqk66q%wyk$}GQnqie2 z_~#NVK7b=;As>lJ407uiU!MX&}!XC?;T zDfF8P=4MB5+3?1&13w&bo6!(Z+zBPTReQ293rcu-)yEwZ;m_<8B96f<0 z(@|3Y`j|hUAC$zM5EA$R%NM+jYOxklK6x{|0%i)VUI@4-61v&^1+TRDBT(+?lsno5 zTn<3VSrBg}o?UHId)R#DVn9F8bNx@#XJN1|+xhm%c*paaqs7P!KtuX519SE@9+>*0 zyzfggg}?MNn6*BXlM5QWB<3`0*QF@J3u3`r+nit6c-b%C-TUVxHEtr4+{WLrUqV_b zmmZPTobf%ln~B+_UrKXrRM&LAUk!99{@Hmv34|XLQPP_jQr7Ypi$PNFDO+lQ#>flM z?oHO5v_)*P;#pVN*xa-Tvy{7q2-&ipTy60(L+w?6)2T!V!IPSJuI!coF5LI69LRayvBA7KMnmU2kvPm9bs?vSZs-N`Jg2DoN)X#hK{vO zLRoC?Doqfy&Js{{SR~xOg^cS`WA7GYPLB{la#G=Qno;hlU1uP@fQUiRl!S0C?Qi@z z;k*R(hWGO2A5<_W{{)8ET^nDS4qn_Gs}wXoxLd~BSiKtBzy05KaalO?{#0l$Mv}X zyC3)Ocb|Wp|5SWF$MGJo*K@tdmw<^Uy)CVBa2pPr9YAH^`o0zhklU#4#~>&_Me`R; z+P(N+Xi`vyN>Xq3{h%G_0;4Xc(kD#eLhVJ5xVq3X>J6=cU^(&(_y~yXQ@>4OP9YP4 zB>i6N07aLevhj(WYe|PQt+oM_9h#MG8toKT<6)@ct*+J($ zR%RvAUi^K*Ye?atNo#6Y<82&aDqC8vdk4E&06ltQ43J^Mb0T${`RQAQaW0>R04e~; ze~INX+H(jI1d6JgxYc>Zb~%sp-@n4W=wO^CPcivRB-f4ybl8A!J8Fu_Va?*1O;L7J)@PA>~xKSwZU%Wwal3hk}Cb| z(k`=D#}E)w9V^u;*~!&p@Qey5Q8+qkK=y=&!4s#3=r0-Ui@LWThV-5o<8lGs(Q*kW z{KVopJ0mE$tc{3X5`8^C-wR@YKRh5{Pr8Of;7sAz`ToK!c}gq5Z|E<|V#`k!jHWIv zm9{AP4tFof)#XNxqP4ZKe^v7lrcJY*2O8}cC&vA=!<=Wz_l=w%U~$sz+*0zEQZwt` z&&6bs4SXFF(xPJZwf#ePce-mkbmp4n-mh5DnT)-v2WdB2K-NOtF7;IHgavny6Zznk zDq4^AfY0ARnG#$SZPTDxoxA#t_?XW$rOa5YrJvXFd_y6Yh6Oeh=@8aldx(yPZw$==ld6uH%rnI8l?=jv`5Sp0{-VFmDn zP~*4Dx(;u@QCu+V>Ear&8Sk*dBG$C(XwgUw1vn(%u4^K&;J8=zz3^w=odfhK+Zz8y zLRwtdX?sM#GTzJa>rsnu*b;;*7Kdwlod1v>Dgzi7Iz6QojJz}15h;04E_Hs+_Vb+L_3_0T--y67IwL2? zi6)xIWT?ax^`r7h)6Sd}r;8AFFx7E3;kvp#>7WkX7r`yTDO&e$9B2|aQ2F5cUmVCs z;9ocpo+Zhp9zlEgNWPL2YamphMWdmk3xT*jVsp(9B_*oh=7&($gwl?=Zzo4g*wM8I zs`@~9f`}uBaDrMvkM+Wl%xi+Z00_@4YLRk^`UufYh=I?RIK`%vfw1v3LZyK6 zSatj_C{L*KzfqnmKY;RxCOEElS=6^PbmO!XMvy|vGSJgM%7yBMhX@!z^j8-av~}&= z@Q<%c((7#b_hrG)b+JZIA_NCU^Xg?;)fejQ;y|!3ByUk&<*E4l6?Fv?*{5bem!dUW z1qYi+8Nh&VmQs-A^$$@{>g}{%calIkX%Fh*zvDMm%l{L<;jtK$KN$FL{H8o*WaK~i zjU$m4hajaZUK9)ZFuB9AGMa3yNTL2|u~1eg@Y4+k;9pCK@(G3+=2)WXq}-&vo@!t1 zKk*G8hqo$}J3I9etNYSt`tg6`GfMvhpNUg7S|sq9p{T$3%+LIP<1>x#jO$+bvz=$> z?IrM;SAy-$ODl5!!Do7n5?{!N@Qx=YrM~4hl%p_<)JPcC2TV`w!rNmy)1S1St}V9R z_AzQFY}q&_*y58??tpwF>CP0e z%)jck^_xBF!#erh6mikfuTZ%?so~cVeWkm*=|Vr>U$c;h>h&{|+ZZ0fig6*8yvXfx z8g>O()Uze2ho0^^l7R+|QSSy8Fp$bVXh(QUI)~R0p>WD&+Jx|s%}{S)IDM0?54>#K zKpm2gZmm|-%R6cj*WTJ^*11btl&2UF4pOzfSZMPHu|r)QuWV;{Mur2h5MFGY(r*#e zG9ZH!zX-n?-^3Y*X)NQ^fBpDN!Am(r5wQGR`9FBi|EngleO6mUn3&2DVTap!h40_N znUyr?z`41(Yem~hE;VK7DXn@C-`AHiDr+kd3rZq!Zk3t&uT^dN)X3H%VJ1G*2PDsK zO;1m+@Nsh1;xCi@{UOTA%K!c$DG&Zy+8BE!zU*z1m29jsAE7Bt`-(Y!{MiU=qMiz+1m&aJ6MvVOYZ}w11JO>ct#LNR1!B$x#97>@%(8F&+@P^m=|sw6TH&Pll}J5kBj)B?{3r?W+E|rO=}K2fa=|@mc?v*6~-%o?G_uzu8O=Q#g!& zNz(AqFXn*TEc15||@*az7`wl+^_CWzEF z!xJYFZVQAERU;^UZFn7FNhv|6jFlq`>)GF~A892rn}odxO)>YS)DKdF^l8ajg`v=1 z5S{{*2BCu&2r-ZA7Sapf!Am}Nc~Y!-dA$bj&^JQpXkRBz%rrew`Uh`>zN7pCcoN8_ zT75+MV;ssD+}oNjC|U|CeQ35H zCfKijTXa1$Urf;GSpHK*m)Q2_p~hqeiqGZQq0#tz_@F?+6veI>yg|gz9u%J-Lx807 zkVJLj8ccK{lnL@*L(pwyoAqu$5pjNd%ERP(4!b!nm*YJruvL6nNFCvj4x8H`WB|jB zUnJyE8JZT)tI?OEy;bnM?>uz91mriR=-NYEjYJ3*1Rxu@g?Et5G=eOq<$VC1NE-2Y zGV^A4xh!uXab>a1pe`f?guSTDz;UnRPm7+PrY}cnOGK1#Qwpic$;-R+x$U%`=z0?x zN(3*`kyPG>L+1_EZ8)z?^M3AlT=Y@T84qE%Zt)Ih)Shrs_}Cs9fFMUXMuwDV)vjE* z68HlF7>3Zu!tjM8JdbJ~f%MssOH4#JI*~ubfQSCp7Dyo6M!|3CGD5Y$vY?pOh4>1{ z16F|(swdn#3LY$l%zLa>pvmF^iw86jkXviR5J07`UUaz++B3>nLwN4TKF{6(CK@6W zfrIOW&jvcrH;nPN^Jqiw_W`MKLJLL8k_RLPa?c{98yWo!<2kfuSQT0Gfg{5F3cBD$ zT)>S|@S;gmI2|?iLxZky%n?oQ!sCmC030o|0x1ql{M(dOR;NY|J*tW!GIRd%D9FT! z+7SmLp%%u+4~uheZ>bZk3qJQAg$(>@&E~N&G3(F~+y4MMATUJ_cR`%NeVAQ#yqdh; zO)U4&i|0I*9>TAbwSzFz;`B4I^f+Ncuj-Q-BEq+-OEKn|y<;iZ^-S&Mm7E==p%e2! zHVtd_diU4rr8TZ08u>*yV0X%0`8Pc)0!Eor(jvvZb{!ibX6*^BV;i<|2H+)pOUN_A;b$+bCLf(rAK1akK{zGxg`l;QMZTJu47%128 zispU#%IGD!n0Y$2UV8^0+&dh0^*>m^u7k^4d-Vk`<(ps_nWU71i&&UFAy-P?a6{G-E`%FD?2duF&R#BZidXsGkUp z?oI2@tl27}Yg3O8DP1d@WOcZ~Rb4SblE!LvJ=twL`Jucx%6^OOrJ?6-r*6h9HZ`d< zlZMSPH0A`tMGf*I9A4MD;0h7gs_cM;qWTYE$u;wFwN6ODzV zgOGBBbiDSy=rkp>ijU9s8_GRJi=5rx8?TP%(tamvh>)NTJiBm=y>dPEIqo?Cf^SlL{(fs=Z=-1hY`$EoK&$qU2+D7rnSyH&;Ddk;{@N)AiFSwJ&HER)B`f z#zRD`Y`4SBsm_i@T}>2`IEj-o;-V9u2iRRGKH-<>Se<2k9_co3E@@n*vxLF`e@6gd z>?uKz0$HA?Z?P&aaYp_gOLoJWQ;~^cMK@r}bLfx9TV0unaFG+My4G1wRu;h%H_n|61r_FPC+t>g@uIg^b}qX4Ty&_8%JAH+PGAR6rwm<^{vz+N zU<;51{kh%H(MsfG*7dAP<=fyMs;lXRwNI5*bxG-@@?i__t$3w?0rVXuCxM}V_imU1 zte9XMtCCQ5S3GPaOQ7k8ev)*Cz#U874Z<}IM}RcBz&(oJ3i49RtvWVg-m3xXEb`%F z&cLA5Dst7(-R|!(-0c&Um*e3b_xQ~cG$?9L@?tthV(iu4D%(4kjK^No8izcTH@iQt zDQ9@SErPvrP{m4Rv}Gw(`C;I9GIK4#EDftX(YxOcuM#%Arc%NynKO@LWC`t6if*yy zZ8@Q7iRO{!iFaS%G6)O1@xc+d?hAHJ(hfU_)qm-d=3GoZLP5v-EzAQ3+0;{en)$O; zs;R8+L@yMNx5!tPEvui1!`a&R-EaM(gNE&Mqr2gIvj(l@PQIWWFqdA8G_qB{Y;q>PC*l{`sXIoMGeq!plol z^Wl|nmyPA>7ij+$+2@9RWg=yEez$LN(!Ce|gRYk~Y(-s_wRBkZ=Wt6(h=tQ#wECDL zq4LV=*wAx|6DDQKTUE|-OGQQb$z~>o=YM5y>{QMUlX+LZ#PRcuh?BkVu#U&)f$|@J&Q2Px5)T6p=wMeis_Owe-{)Ij--_ZWZF_hh^dtWc<9hI%Lqi<(Nq}M#s z2$#J=VGtmDMXR8cal6SpQYGz0fgdwRT;UexEsM5=I}UIJtgNxUsfHU-VbwkA8TWam zRoyoCwVbELq3yMzr%qJ}Z}t(;HVQcY#k({;jfo$Bp%78=R-IzkDX>Ie>t$wGbN=Q| z)~5BZ`v>fQY}|EJoi1bVIXIj-TFEGrzgZJ8n0v9wWdDE8JIdo_Qa5gHD#?9OJ;-So zE&KF^i$K&&i0;=gSkieln5+8Y_%>DiR5E4-6_k~%^gJKP7pv{A+or&X9JSJ47S|C%zh) znCBd;512I{!RH=sgsE&VOr5G#Cm+6L%+2lxp=qx7$J9u=li_FU{!2GCGElx)U%J*P z+~X|pWycWhHqVwS_?r)Y>r$tXde}=Y|93rdS1#`~10}iO&=f06r+Pm#^i)wy^C?0D z{GKuI#5BV`xzu&e8ipgYa)G_Srg9_?-{&|niOX8Z zP5IB}vF)5OvNk&}N0N<=4-;x8M)amf5@>@qbYM;j$d0=X$=mu3T}N za8rwZv4vGZ1RfnzAw$yxmH}t-H^ISe@rq0y7Cf~o@d{$265EYe{kd-r7VX$7`QIOy zr^LY~?s_3*v5A~c)0!FQyZT%yZ_S8XjA!q?jSd!&ppU3`f1DKcezu0nqsxuBG_fsv za(3PJk{p0L*Og^o-{!F|y!2-W%kw>QNG*oqn|z83n&qf_<|@>U@uFfZc z8zkhzOQtvOZREGCgGSBG^~s1SMJRQFUbs|54Xb~`La@%HftcxiDeE}0&V^lu$LIA` zUztFymh+z5%Q(cCu`*-rzFr>sWa`je6ApH4iGj+4KY++C1K?>@n}A0^&xQJwjZD%W zv&Ex4cLz(rZY)M9w6jZPboO2zNf-9nnDH#&Jds^dG(%h<`iy0pqC^7jRl<8mM$d04 zm3&ziBNkq9&1?_nJi3ROIl$)y4OjSJW)APK)QP78#WA!^un$DN)&X&YN;Szx4Oc17 ze&YcE-iG1{Gp-_asM#PJH_P~0V#;rr*vDGdnxrnz%ot!tFpdxd-<-6(L%)EhlbFR$ zdVi;aYp&Ec-m=jpT@Mk-Qz;c7Mms|!m&4wNNJX$i=;X0T6yG6f&>MnlshPRceKRM! zTz8tTvWKH=_~aNu7IMO#81*8=H7s#Old_u1_|wB)*N%T?X?GoHcjB6q=rl(IF^>XV z-H!0!+N558^rSdT+7iWb!zE*5W9YGYTslYZv|a9Yxf~;(m=@qQ?UvD5mFX|#vMk*y6S5BWrVjf3E%|RV;VH5xJrsI=CAfJGn zg?iPeC60wFrqI?nQ%kLJD5x?X>@zX65_rd#>YutNnIz3VkIl+H&uUbylrb#C#Q!nj za6_|&S7Hw`I@^$fL1+oljNej8XG3ukA*14)7{>s?N4gBb2?jP}@y_(L#%6c=ea1@X zoa@nx#YNN}HOs(A(VJTU5YB^_cHK1T$U-Aw8pm;@EZ&T92Xl+#-hvZ(&~IHXruf3y zw9cZk61_sMfF6`1qSln9UWs9SkkU#^!r04hkhtnTU1G7`^cgw3kkgYWVW57sNi1`m zQu~Wnx{s-eQ4-oFHicE;7=d76@y_l9TikGZA5N#&&%z(45A3?4nf>)Rm-Kc%<~!8y ztj9Y}NeHZ5DAD!5P!9L)8yA7xnp#6e&6ZM}Rx=?YOUZ{%7RqLut9))DQ@LQ?m@KTX z+r9yFW}_=rcJKZ2CGC&tK{F%02$PJbO$#^+3udX2dsmA$7^WTJmy*uqOtKpuA1}^c zOI$qlE=bT*hm^3mt!}$1Gb$lV$#%Bjw(94_Vj(Jzngrn=*56XyQ+hin%#5;|AH+>i zJ3`t1{&ynLVh&u6UzLv^V==*$fWErqjH2Rgr>@$~1&QL)O5ph&V0MUvWS96)$|)$d zotvddKVIJ?+(81CSFLJ5A8<@vO~q9N?VO6P0GLrCNGFd_pCCOVfPE*De;FV3;_HKWt|HOmj+m_8yvJ&Gsl+k)?zJ|*4aPN`%I%QfpSy@#- zH{ms_-b-i3>JL&Czt8cQ=J6&t>$;`B-0b%-^{~~g(s#i?EI)sJ@p6aE;QES8>#52K zhP&2#Ps8A_*zH_w!dgJ|>kwB@P?R&3Od3=zNc)DcJI@;Oi_astH^J&!L=yV;iD{Hw zISJiH*|SN9QYOcM+03P*%7aqJz4yAiUPR=CXk>=$;g!4Hj-8l(=;vpgH5qu%rJ2C63S4+7R>@d}B_t02CR z_xf=`SPc%v{z9{yRkgB6xzamTRP?V#eB~6SUz$w1qhpJ=597S<1Wv|UIw0KgXjh4o zLrOdWgJ~z;vjG&+K`}tXrF*n-{2x`iCR%07tmDdN12%qf3ZgF|7kUpgOyHLzde4KL zS+;LCC24d9<{lgqV@pZ;W?G(J7$T4&-~31AX6uCiV19zWW2yo;j#vmn2>&a%%B<%m zVVp}Q;|fmMxWn0oaRjw4DBa*3048GM7+J~BtaVI}dl(nTi6_PWj1ci0`>rdo@9Oe|6J577;V9hErSsC`!(#>~TSp(9SMmo|#1$onxCKc!qd)BL3Ffx?jL*? znS=a)uz(*Q`&tc&?StuAk-tBozedAtZBIUKR$&wFy77mY6e$pkzgZ|KdiN zW0&&CK8>Bprz8LiD3;}P$929R>2f^OpEN?4`p~Khf6o_CvAQg~3=Mb4Gfmhxh?r)f zP;B7-fYqjjiztKRlMu6oh9rzro$*~HYty^)>3 z7115vjuBZ5#nZm#!6#@)U&MAO@odsLfvCOx0xrc<0P>VR8sbiOYqfYftsx;5`fpjg zrEAiB+Jz+)OGCd;J{yZqHZeODXJ6QBsGgInzI~@IiJ8ZA{^b~-u| zEoERQlho+4ncAEPIzQ25MC-Po)UHsGXs7zX6FlX8g`_Hxy4Payva6#&ml$u|#Z)G> zCP>99FEsrm=b0Xh;YY5NlIRYPxk;dgf3xZhQM{DKA5I#NUy8H3C%|0Nh@EP?pHP8jeNPJx8b`GihUBOb+Sp=8rSOE$0F~+$Te`D zigp+$5o?TeLAH`AZMCfYmS-0omY*v{Ncl81dlSMeB6ys|fuKI6C{39>D^X@76n_j^ zU6{Ny(Y{ffA(TS=+3C4mQ_qSZ)~D<3t_1RY({&dnXuxNA{VL60PRwKX7KZ&6Xkj`j zV#ah{e)TzK=31GclJNTc8lc?Ar6hkf#nrBCFWi7AVaE@6}7ukXwmwo`F|{ zU~QzBw+fvgZk&YzoBl$tF33krU7sOd1VpRc#z|$ik2hAXQs|XyyyMd91@XBtYgUuwA z85JR)?giFwr_sK-Z+EhM;SRV!45L)%xb)wZ8F)XHe+0L4+n0;|uedWpiP=xq?(q2D zn5`NakB8_TjS+Y9=({3S5p^!UIYRuBGnsv1e0)1^lM<(w3On!BnHEYrG5~3 zFLlA}<-Hp@LYhyB<_rQixCH=Cuc4UV%0hS**LP%uUUDgh^ya3kLMX(c*6+|m8S9H$ z{_)*H@@{J8hO4?4VMBr6IhT_7)!=jBx&@dx8re7xGmbSv`_U8C3|vNwf~ywuWNm9* zAc7)@bNp6Ccoadx@R;=w_D({i((?zKmb=Fi*(xKwNJGhw-GlaPOUHKd=nvAMv#+n;YQ5ckGe`L^$_8IriA#0vMpv-#pbT zc9N8_V>~A@nuVp97-EMbRbZdW%T)|;XhEOv)ih~?w}2kOiu%maitU4+O5t;7K+5g9I^&cq)4G1?f zy|jMnVa2xy(OwcUU^Xt(G-tFgn)L|nB?PD7fRJ_hspj^;W)B{ESFfl^@;XhyIgC#S4u z3O-~H3X8D8F2q(M;w27XCng@;g7Qo&<4zSY&2-e1Wvtz^lUR;e16p7ki3D#|P)}_T zwO!xW74v+H2<<(b-ww3&RIrIl&Z=u%pVh+*vEQYT0Q(gV))NyE3FQ#%{`bn3>LzvI zpZWZpdU3ons9S26v#@8bj=PHMDEEog$Kqy0EEev`KrTIEi~^Y^#IZ!4qiNt-!N@uy zFp&^OVbefDhn^-IO%UFn6UaMfzwMcv-lvPQ?LTJ+&1QIHZF-JB8;yeoOtXH)+8?$m zLf8X|1SU5?X8Sm#xIyo-$!GMIBb4uZTdTv>(~dxLvj%X1QmFQC=ToX_Hos+JH-KaA>jK4pBVuE@0pu=n~{n`40M8otE9@~=7R9}WeDn8 zq`rR|^(|ZXr(Hz6z~#O0+P1QC-q1|v(A!FKX$qS`)yN0lg%WY$(m0G69xsEYNHf4;-3U3=t58!;%F7L>G5<@8w>2*Yvv(AY8_ z?wMIl0I%a6J-$0jO*jIq5+Sq~u&tg^J)SajHrB`A@kT^`*Ri?Rn;VOzMARU6#qhxy zfM(&ab58`F<+J#M6$hLcaSKb09{0+J53h@EF8iGDtD+N2ZT4-^4gA!($s{+r46E)# z2DK@E)RPCf59qjuK37Urdz+c7wQ_G^>k^)!?xU-nnh|xA=WWMHS6aiO%5N|<>kwqt z-SgB>ApN+{ghJm2z|>T+h|TOZIy&&H8mhWi%nUHMH+N+X|$p zvVRDttV{E@o1HX(Wzyy?z*r2PD%+VqX|!{LNPa|R@8JGi3%=}eS55b>ExO7h>0+eh zhd9oXkUXimy~P=nM7uEhe+$8PIWE*^R6So!8W)UJPX>lJUl54>@S`w+L@7y)lm1G) zapaR&s$y?BONsc$boBbCYxtFQp-5Y>9fke9*)5HXK5_X^<(02wpgKDc&6Rk~%`8Qn zNRe|wIV*4nxjxJ^P7mohb)Z#82MnSQ;Y_Ot!W`~}zIA(e<-0*lBhBbtQ+?ieA|dKm z`1zv2#rN-z&|ez0Rh*9j3YYNx5fm&bsffsxviQ+B5`V6SW=Cmwd5Fl>?Ij`>`J#vQ zyedx}8f34PkiD(RPy7C`H6%u9b5*rezkhQZkGC@o6N*2g?a45*cN#wMChJKD9|I5x z!(U9MFZ;Hasy)_rXy?>wTXi{XenT|zxZvorpS(!J(|8nLn%vo=1kwZV3)y)JBj!Kk zF)tnwQ&rk?n8x{KVI3ic`|#+NV{iZ@a<>G<0Gwu%9&WW${mJPwQt>v^xaoyz;%9-O zE87d8miI4&PaMS+xQj&+Ho8&F2D0#NA=!6wvir&z8G%pVKl;(v<=cjHJ2c)rtMg-c*R{=&zH+l7 z?;*>FLIgqco#BS|qb~;q{PUsS5`{hu%2ql(eW|bP0`4kXzUt;17Ndm&rR#q;YB*D9 zpz&uDF&ydWaN=o8bcVyeF*u$RZI4ceYArU5fR^c|OaV-8z_$tYTF)Dowwg&PDb2)N z!|_+mMzV_jxLToY5ICw{eAz4u{8$;yj{NZQ@c(+Vz5MYNiz#*pBpE-vm+))9I3{4O z%J?CYc~MKKi9h~9(j@~&I)I(}_K~y13_Po|kbvChj9WkTmN7?i%3Uu>EVXznkaKKZ zbWc0yF&6T2^ixuv_UM=xew!x^U)A3~zJh@~a)PgR zE5@%9w;z#}y4@<9>Efyqo{raK;kyTB@|=&_G>bEbNJ;iF_*mTvVy4#|mTICH4Ze#8 z;FR`4#pFkA(FbuK+aj--5Cs*S~c;ptTC+gM@QCd;pHJ5n5Qr$yf9NkAMmMD(? zLeB5MJObWJR!>s=WA5qCT$;MiQ<)tUmcF>TD`V6S*PwIUlRwI*^Ac0z4Z9&A?gNFi zhMv7vRP4))ps=o_=IrL=4l^!S_4M3pTw{X`dK*l!i%5)XDN);Ue#(DIA@?r!(&g^z z$cg3c8?6^BCtr#LO*co7rrD}T*QaXv9&Phm$ZiPZ-Rfc2Nf~8fxa9k!U=oW}b~R;r z=mK>OMUvZfDJE2{bqATTg(0>H-$9H`L{9V>TamKS?-HfiD{q?8o%H}_{wylw;Ptg| ziy~MdvZ8mIFYmZyhV^SYM8ygR&cFX{=Wy{?tF0O8QhDdwp~ja0XkJg<&cB%+Br4+; zC!~_1*-YVoTJc0p(6+zpU1`SN>9?~>I(sRSkexl31bD4n0?bRlh=)BErfB(@XJMKs zUL`Sq?#t6qF00*I|9X0vXBUX4r=hp4)S>i<-X$IQNR~I3Pa5*Z3w9FJ{0g;+V=Hs} zIo{js&8NxR&m}&fYxUm0Fw=HAfZiY-=}IVC%a=^W-VUZ*5$}F`d|h?7GrMQO5Y3Wa zKVvDEwMYCL#)k$Y79JfD@tRs=M~0nQXyV<(HvxnGn6N#*`*v?8Q`pO%Fny=%t2*i1 z?fL~>bXSWO%C#3l$w*vtZLP&+$Az+#uHv^G=4Dat3+Y9^r2C|RM|>rTYE6y8s-A1Av_i~T z&wN8WQkRVoNmYFPn#5U_rsd3RxPE3-st9WjFPkTF*X`aPomS|WaIMqg{ZsI)-}5r^ zY$%z=$!e5lA;MAsyP;bHAFia{lPT+;TF> z;!fsN?4umOG(@1f)iDQ;DV*B`7!#KqvYknea3gGt3PicyfSZ-v4r83PV!UnD*hL?SqdlGT&={LJaRV;IoZ1 zt!3Oyd{Ph~-aSjcmiEYZ>>ydYQ>ubl-c9+}>QC!aJ-@&O=|S69-nOW6H+M1hN4OAz zA3GCzU?8X!Z7o2XH@y%}zOe1dQGs9ENf@u{?wv9oP%B;sC-Q+3ID{w$v-;gPrf;nu z-!C8EGWlWr4eL~sn8QIQMu*p>775`yR89n+H+WHelS{_V(#cFh!g!g8Bj`-|=XWOb zW-0RY)Tlf>1t&Vyc9NM3dkQ;=u(z#?Wv9Uvc?S&(s^xgC+|-h-AXyVNvlFlMAg+Jm z?1e>{!y`xi-Bp^{kPP$O^kZ`I*puQ-DTTVxb~V$-X-C)wh-quay(%K=uDPwbtCD)c zDz3SPb)9$eZhave${MLWT%!Chq{-!zjs7qdXzr@m6d@b+^@jHfCRta!7r} z(xvv4ZyZJ<)~(fU9lx55Z)aNie(GFQF;ai&V{MzlTqxSf*W96ePOtV-$3MJgJrB$t zRxZzyxOUCnac!L(g-CHkTN@!@SwI=uCEV}E{Cf4atsYuBWS`vSdsBTr=L*b5drIR% zdAEz^+?otEPb=4^Hy;k>;d3&ed3Tj_^M7HVY@1cho%MZ3`NxK5H7<-%3Uq~z+;&t? zVoUXhO%4$WrN~V^k?|z5PK-`+=a1#@FSR5FiWV}c7dDQGSqmH5bSNIy+c#)YEKMip za&mllI>*7zbE`Zq^Z+l!g^h<@>_!6i(##DaA7P{D{xw~66x+v8Jrh#0_Ux|h`8I7>$rWL3^ZFQ!jOOk)2W;w^F_Na z`}G)VbZ@1&5Gl3Bjxo{!=z0hEWaG8CD@)lTO$QYg*S2onKYFq-6smo4ZKD;9T$YHP zRpFv(*2g3V%`$II-nv(qK&gvIg@L-TR%biJH>T>`L$51WnJbu+Q7o)imc~p@;yPu^ zQ8sF5g`*zLdln^v;ulfr53W&Ve=Hq&zlC}m&rWD6FNv1hzc1?<3!O$$U7f)a4V!Gd zcE1f{GjzSG45*Jo>1c@dp~8meE;{b@-|v_z33C$OTWw)@^B9kFetxWgQjHnciTTlX zEiIx4t6cW@`$Q?P%_Y|>u)19jKC6%V%*{q8WAN0Fdvh0;e!Ru^xsD4ULlw@|rY&-8 z4@O&<_=4_+W6gTbF5Rj7T!jYY4x5x(edpWelX=o8e}yZJu7Mu?-dmth$_VX=TDT&u zO7w+IOTo!lLlZJ%guzc+x!rxN%)se$tXU>I?ug#dI3nB=xJ8;$jNCW=`+Ce+4E%A3 z80_5LKYt{f_VMOwYz2+hpM^q`@R0GBx^yR^t=*;;iU}w|Gh6xx8sm>^KU@urZkVVV zf6J&n?ab#}h&(s=mD^IZ_)wIb7P2NQ{#8JmALh9d=>)Wnl*Pi7oJ(LSou)M*eglNi z8>VHzss7*KCOdO*nV1ZSrv58yX421h0A1{r*H2=6I5IK8=Ygjr!?!`;%Emi znQZH5Avnkq=~GF_BhFTC<{sBXg!P-%glAmx?{NAdb?4IYbli&_&vMQm9cj5Bw)x-A zVa9|vccJ!!r&Sj>;oPAW?TVm^Yzo!64X`{WHY-w15CH@S2P1kpq%m`qBZtd=T=HYD zjqsS0eDA4%c9S1ItCm#biXFxC!9d00LS$V8mwyY~X6RorYB_8z^cAbUK=uZKM~??jWqP$VJSQMN{7;rm;%!r`AA4&OlB%y+f3 z$Cd6i46(s=IURQM=tZ{@ZNf`8Ue9s%Cq@CR-P`+LY#K4>hQP~C7{_b<*tY&3m?YiB z>oFfx>DkY-Ry?_N4?Zwh4HbO#u&>=n^L9U34mmp;81<5v_RDnE$436(<% z-1**95T+-d+GJIZ{iDEDNHfuyD=&2%$~&iFsOCGdgK5WDkSj1~7fpnAQ_MH*NqZYi zOFnmqt^eLPBs7?p#63Eb;Bi^X0o%Rx+zSfR0~+PK`1fl#)4KuvmiJ&fs5)lgsi`B7 z-XbPn=lSYm+K@tA?qDoJ_jdFus^Nq?8*d%muM)6o8J$$0s?)th;hmj?(&+1ij_}_? zai3w9vPBQQo5<9IDsmM1W4vI`PzqP>{HmF8qtSBoo?4)#<5Rmpe&Vja}D39c>(> zp;3>${>JyrUmD4E?Pu|78L3?yoC4KT$94W?7FvExCNz~sz}UTTD1d>66ZZTz+de%Q zKd=i^K(~>&{t@T;8~H|JOVaw679;uJH`VNa5>NlT=Bxcbe-b`39az==g$4Y7J@xH> zeyV9=MUc4OYs3HrsCM|_`3*DsuLJZhTaJ3 z#p7UTqG^oni$~zTRe044@RQZ@q6a~IlI-JDF((qXu1|E?kETGW!Q(*@_nlx?NuneH zS3`oA>P9$tF>q_o@SP=~)|<$AV+H7h_!T*U;b0e@lO~vRY3hydyhHFK4-J%EJvEIZPMBv)1vmcMzLz4tsVNdAT96L3jn4pP3(kI@dSbg zCucunMCHB9i!Ni`hPDTqJHJl*U6EpKyECzC^xsZ|d` zLXQN_3NC&lLU3UaQ&uV_uu;|L<*aiI%P>O>3=u&Uc(jEszhQUbg7JNr86WD#@^WTh zSX5VtuJ1OhZmZU+y!U&KR4>+n%!F!$Kz}LqQa1%05PS%H1{A=|K?pY^2%7vF!mR9S-8KIQ&pt0O^SWg9b- zBRas_+nZPaDF$}Ct0*8%G+sIj1Yu=8JY2r)y!khhg$6g5E z&-^5`yvSh;m;Xcz*8(N0%;ovyNmH`MEQr<;d@+=4Ye;;nE;KMSWZ#@!d}Qu+)YIe3 z;B*(z51eO}p9sbSXIfI!r~iDkqUg5-LjHn1H6El1KX=iCdWdS06;2$O?(rw#5@oI@ z5+U*QtF5>ANK9jGUVS>*nVUAWMR(&30&cpUYr$C&8wiw-%r!lcKLFcR^UCss!o9eM z2>l1v;B`hu#xnhnZvL^+CsZM2f@bQp&pIGJB`OERs*(wu3s1Q5fU5A-t5-yvJ`5WQ zIaRv}Pd~xAzLUU^9#Q6)(Ye$r8n5uHvnT{rN;ER=Jm2P^;j2`%^?|#)`<%ODAsc?x z55LqgtS=bJ)DXb=AU7yTy%+=}O#Ui?2F2ILqMu#R|FrG-#LCP~4PU)lWzV3F*atow zmXkd?Y3E{_Gz+awBqSst@-X=G^Iu>wv5bg8XH}ijEDospKspN8Omu-51midOyQ;_O z7t*ho4{Ba}4&Pqjg19cm6#L9FCB z4RAyHu8RY3d0rD_o9D5>nGUucSyn@D@2CDF{$>5hr!!i4=?iyn+(1nAI$D< z0KL&ntB0qjC_2&wvomyz?_XhUCzaO_Nr^qAzT0PzTk(hb#+bUUc@=Y`^m$)a@@i|f zS-1?Rz!SyB#{Qlcfo2vPz^f>r$qd7#oY1@Byn<}7)An-7*XLsg?5L0M1vqi0&>TBf z3ZSB%rEPZLqQ4Wt%+-h#;ISGUL)41GLIaQk?UG2J&i7;9UPKHO43sl^GI&y8Wpgmd zzPVebxW7hZhGW{@4_V`sa!A9sRuf-26Cck&v>vd&a>ir>;+k zHL4;BdBQj7=AM&2WWvsL0M|p;%<$IJ=B0iC z$2`wI{771H6zZ{nl0KC02u&H^$VMQ%|3r|=8w{t^@FWi*AEaj19eKd9{}CJrjWqsj zYVZ{jiQPC%4DZ}&Tig{R$SxXFn7kpVtf_nFu|Yo_kFg5jC%@u7Q-8%g+mboPkoB7G z3%QC}=K30W)~@!TF|sU=9SNoZ7*3U_d;S@tmHJS1PUJhzF}qF*)T?oe7;w{Wo^Yj_ z#?vwb0T!B=GB~&;;jQ!m#ncJPArH{~)$;GjIBzqbzj>VXva|&xJkaJ{m6s24Z33&7 z@UFTfkmKhR#d(HE>L#33r(H_cB(ZG+cxG$>Q#h@f_;>aXpsHwmqwrR9A>#nUVCF!* z|Nb|}#h+Hz5gb*C%hi&vkxjP;ryjORnfFymUESWi@x~)Vcn52<^kZV`80wIK$J%5y zGqZ3(_)W3yRu;MZ)F|4y6B1g;c`KzPu3Rx~OBZ`lr8`DmJ34u&`)P)%(hpwe`4|I7 zQC{imodrYl3wa-~_jXU6FFGMiWv8|3c_+k5Do&w994ar}iZ{_SE_z~I20=qLNtX3e z0tdG(Mcqx=!xfeZwDa?yMCo(V5kF2lDI^T#@f#{_oW7P=ZEYIeB=7%KXib7ue|VL@ zszC@iVgDeZw%ns|?YWk~U?V+WW13TmRXA&HJJ>AFX13iUjf*@vdMrxId`urS>_Zpo zTeIz#C2q@#<$h-r-_f}Bbx(knZdSUdN#{E;(jyYS+pGA0#L2g2r=j_P5_Of(A9(dW zoy(8W?t+R}12K6oYs6l-H`cN@$ZWFp@1k|A3vusvZH62c}hiYkSrmcK&A6)2;)!ZVCsH- z$nW03wVQQ|7yY>wixwInm4D@=a-;LMFA49h&%62$+&>aZ%)mOC1TjYy@73d)X}x$W za9A41U?%;^pz4ofUrN3gZJ0KA#n$(#ZJH=eYF2!`&7^n8SZlGUhk*~LIHXYNeSJ5V zc`bqyrvPCo>m$(>tQHBp7tK=x3`=Q_8#DSO>BRZ}JY z5^J(sgT*7S$&)hd+t>F{ETb5m`N*597;5eB)C$6DpP`(s6eTsf=9v*~*%i~t$zx%s zV)obuGvZv92Wbr0=Z>(?XW&m_S$FGYv#oCchZEuE{!uG+Rk;W=s$TctuDNqZY{aVC@O;AtaR*{= z?ufk(-_w3NVldlhD=F#tqGF_(&mQh}J;tzr0E1|4&*O(#6-E_VZqIyjpCDg!Nm!i> zbhK+YFTy~#%y!OX6zl!b?{7zhCx*{T#z?H-c4qC&dkSkzi{Us)+Jhsy_MY~qCGAy| zeyhf2p>Ff!x$@`QA@0xM_ z;X8N6o-Z(lCMk`V&$t2j`9Gi8T?(7Voq8_|KlG*1(`+lxX&y9veyNW1$@$ddqpCe8 zn3x7rmZ)iwH=lnypLroYH zW=7DIK}Ev3H-;>=)N9thJ(y6ZCUf8;0S++OCsD8gBd%{TlY#NN?}wYgqAnX~eeO3W zGLz46P2f7oCZKyDov>7Hh>uX0lt+p1P<@2D$m#DT-^o_Ge;w!g*Un>( zH7V|4Sd6X!Xt`Lk`4lpAFE6iV_W9-6^ABLSKlk^UbZpVJ7h0jUHF&At(9n<=eO6j) zrWIox;uKO{tgorZ&lEiUod05QJ8Py)g0``=(htJrJ*Pp1jiR`zJK6(Wp0!A(r-k{x zXI0yJmWSl`PZPOa>l`f*QmD%XF|S_c6{m%5@;AOpg|yKEN)cj`31pTP)$oHn*R6R1iUMUdtE00a7hM=gT&c=GZRt5)to2LIJiMm1HX!36vM89lu1HD} zW#0PkpSpgUx&CRhZ};n{w~dYd?DGtf`#lT$5qYS)R z3PNu?iL2FNn%*jxI~0`Lw{5$~ap0K`7awWTj-}UOJpm>!tajf-Ib4ov6tj8GV(d1i z2|5T5f1sn<&&)8yBO9bUY4z%YBc=dR_08Y0YK&6{Otvyd)fdA6<^JB~d9&)R*3SR(` z5jpk0RU1!Hkq^q`?~^|>TBq2LK!q z8p@HN9Udt!0sEcd2y`(1 znvYP91Nw?uyVQFl9`CEJUyE?14`m5nXCL3rdg0nmb+SiF{(dSC|9n5rWIjs$o4J$k ze#`YkClzUG4;>OCm$@d}USjjAQ|IsB!Nd+eh>+R|`iQ$DHk*ZA( zr563s_?U|HkRjgvfZkOkYw+H_luWVz-HqigFW#9L3@AERw>~Sk51Or7wQ{(leX0F7 zqdz@SXUX@n-z}p8VJ7cvAr4y zM@dXb5|i8Pg(p2Gkwa^(pH>Q#+h=f>3J4+d_iX=0=NT9uHlceSYfX!oVR2GEh@gMr150lvDClmHjc!&)3OX$%uMjYP1AJyUObp&*>tbUrkMon&i zRDiu}d|Fa$(WCTW7Ez$B#qH`?Kp!}hi2$~R{#Vcx&OZ}n*R=9UcAY ztxz%{PNiji?+gdr<@HtJp=%&$Me0UR*n!zCm&I5WYPtBvLMkdS*myBK$ z1RUFqjGg!&a~mCP*LzLIU^lS;$is%!Vo11WPT8A<YK7Xz%jH_EMKkP(B@)mQ=+y z!)jl2McQNLsIblgI=!*U`SEa?uaS>Gbu;K4u+&@9`rAN?FU#)F0!w+HILnx5k)Dib zgnushulW&lw07P4MC&*ts0s)!bSz--_P@*J@36FmMBy|1mZy2r3nxnig@m;24>*sr z-FW#g1ZUnZSTdqVwI}yCl@iB%uVjsqK9Wk}aN%%0HwET}cK)?{4x5nDbwA?;Os`~P zVnUi>+PXLrw0$3ru2HdOW3EU7;#A0K&iL!?+)Eo>f7PZR*I>!?kG6b=(Um#w+ZN_C8;v7&>tA!Rw6LthlvdD7gdo*MiRO zF~03M2gN)4YU}dy>+j+ABMI=ojegv&zZw7eDNLm`&R#YB14upCyK9&4gCAcjHkJt# z60alRYtcoDu!FxAmZILRM(sKfZ$LKKrm&&7&4k@*64|X?Xtig=Dgwrp)&tGr2#V%e zE@8>Rndrq!2orJ4@>Fd`&zg*>({|sUT&WT%>Dt2qit?mz0*fOuhw<26w<&n6Z2% z4C-X-O52_xQ^uiU-ot*L~R^L=J?&cElMbIw2K{mTdQ&ig*^^FGh- z^1aAvX8fG-{s?&+-7AnqVN-NgYVCO1h~k*V)=tK$ovvl8x$fw*ap(@h#|u?lc~75P z>)q~_d8N?CYZdGkc`CSm?uAfo&f6cYP4;JJ>nFOrZdmjz^=ZQOO^-5j+jm8v%+YK$ z`=T(mF(k0S2A0R6p$qjsIo)uFI$Pk1M)l4N3xi*bL_R30T!=eg`_f(&Lav6NjE#-m z29NdJhU&599HQj#_T|lKD__Xb(w77!mRnyRSod|dRWVaeY-ZapxgiDFD`TGG@SaK_ zL{Lu5Ir(mA=T73mP^rQ$Q)#LjgZMI2y5(7|e0;(C?gy?(xsMn;Ud z-tbRgcerRuTeZ9XJlg`UgD`6A?docK8OpY19pg?n zXU_(vdYQ1U&g)^|Ip-cq;S^B!*p#b>a5*G12Q+fz@KK~Y_p3_r(r(+Pj7j_&_F~A6g#Zo%x)T&$JwVJr91msBScF6%Rw3a9_^p7gFW3S?IKUkn zz+=N2;dvrxkkV3CR@Tt4jCfIvH+?qwH%k5q;zxLx5&UIK%PRJ|#p_Eq5C;im-qB+V*7NS;mgX(0)Y#;HWukHQf+aNn}a5G{DwCJ_$%V} zMKfpGiT~uTi)zDm_~1FG`kn~9FVDf3Ku}aia`*R$um~#o8sBgb3jv9M(!W?HlA851 zFzfx`pu4%Ho95cGZFH8VYV*XssT7Cc;9#sZrdsoS+JL=UiTGA>x(Fz;Zv<7)RHMPW z4Il*97_rKt@-bi*oh`ie1Fllfh^rvEX4`Y7Yb_Lg^czZ8^ZxYl-3$vu8}h3*J5O}MkbtuFJ5Te2f`Vja5BEtfo}UOMBM-<| z3K%H;Gc5g&y;SiE0w@D1tEw)5*F#B(5pKt5Rv{QqLI&oQ3Pr8Y%FHD8P!RAo z(AS3>us4hYQBWThfM7dz^eFsv zf=ZlGT=XJf@o}$JggMsTVsbC=Ida6M7fIz=1%3r2@{}h zFM<>VfbDmX;+c75=de$Osre=qn1y8f6|*j!*cz{er3@Vl2un18Zbj}T87nb$%YVxj z5mc@sV`wOT0lY$cFa-292ag#a=t7?-_Aw}Gh7LQ}E=WtQqk0|zD5^TWZUEz-ZI5fw zjzfLUCR$WvkB{lS)CBBlSzOxQz0OWf?s!^>M2*wdCSB8-todCX zXr}&}m}p6Nl<)V*%}GQ=fCkD{PA1fPTF`m(T^;ES_FX8D*dR~1xx9$p6?{7mTaHuf zJ5*`l615$BQ%3{T`Zy@{y)u|q>2}EEueE7a(?&!rZe>>064dkeM`Xa=X*G<9kpKKZ zJiv$FA?_jb)vC&Q8=gr3DkCvR*8QEbeED+Y0y6(_j|pS#e;|$NKtu z{LsZ_%~nDu!L4I6LfZqy;Ez2fP{xe!c_M6l<|j&~HZ`kPE`Ukl+O$1Z!$vfx7%ij~ zZvCRmqE3(2CZ!rGp>`&H{Ke7M8X0^o^xk0YkGem6Z|^lU5_K2BC^8pVo&oH28od5n zF44i@?H&kt7b7e80QCi8=SKA8HZ>ph*MoocmhQ&cywUw>Zx7&sT9mxaFevbLC-;an ztSATToQ9SbElg8Q?IWH#VF3G}A|`@pAsK**DZU>lO75kz{bDaV*+fNX8^?9Y(4^5X zD=Fp4PMA;u#w;>{#y3?0LAx){h#5ZhGHH!MbBoW9`%()EcOT&nTWy2$fOqleTh>wq z5ETjO_{Qw-Fi?l*1*Q9CKTn0rI-YvVOl-Fqzu}eUWn^X^lP4mdF-MSwVZLR3UgGP& z>r#a4AoAAs50fSZ3AO``w<5~(&yVSJn>XmQ-dC7Bd2$Swz66UT&@#pf2nbN#%g5># zN*tCm3U?c^9)MKA!US!hLDB&bsp^q(_P>4-cPa ziLttejSurdC;*N%lgstP4w%DS2`)gyv?~bLUS}P60_N#<_O*!L-?_RK*ql+r2TqhQ z?>>0N4^F7BcMq6V&8i8;YCM`E{{B!{#2~_VXzp%DtYaJ|GlsH;HMl@9LK8+AMh5Wg zeSY+ZdQb1@X+ph}Ii?&YH)F<(5pKB1_et6I=o#_%q|q5qNl*77`)i&ZdE)`CYX%OB zHwqz}a;yEZ@Mm4f+lSCk{S72tPpUmE^Y0JmR*cRu{ICTv+4*!#>h46y96pRCS#*8@ z2WBT-iO3E#mKCA7OAynd^0m|x^DCrXjx{O zjWi*vPfAMqfd*HZv)q`^SS?W}YC`j-xCz%Tw*$g#;fb&;9Pr5dS=q&wSUs_pkp4b6IblyO_mWO~K@@yWtN~ISq?N3`Hi$*~y$HgE zjd13{W)j&|{~T1MEZaYtn7O8ZCs$uLnK-Exz!Jc!{TAHV_o+2{9iXl^&g+I-7gUTo zAajq5-GXHi&38!U(r)YhRJdd(N(6qivNP!ZeVwHP$p;@or?(l3T%SWiL;E0_3PsEk z=2-Te5zwvmYp!6gokW{%xuqRjM(U~l!Tx7)s0;B{VUr8uM&Iag_}~Ya?e23NKr}RH z8Mi%S>tP3Y>iD9PgLBhK2dU%T%~Xwmi?&fwmoM^xX-{*+0=H<_2zduZRl2D0>^O~5 zF*AN}u6jwc(_5lT%o%$y-fA5wl)85+fE=PHh^+)EhhZp+l##t|6ggD9+f zl4uPj@Mnkz7?S^Epx{vsYBbw)eMK7K$00Vs@pn6-5#P?K?$AhNn;UMX5E_|m|EUjz|Od`)d}DA&Y*$eG2;HRta`ACS-*aRCVl>#ZJWk?(Lf z4Gao$babqQn47S=&SG!=FPIiQS?i5D>D2>u_>%GL|1h@#!kC>y;vecfB+OwzzO+ ziE^7F(hmg`p1}m!!~v@uuRV_8{V_X%YD8cKpSvkjrW|~*!c_8v!jG(tLWYjxf0rhH zTUS$qeHRD6TDM{h`Ztb28vpUIxHqra>$=H>&y!P>vFr04=#?2XE zu~>Nyk~7G4bauLI@?FR`T$vJ53f6B?ryfj*A{=@Zwf$qPGf5+F=EpqiTk5#-F$1koGe>VO_NBE_kg;fCzNAWk> zp4(b_UUs1sr?16Qa%U;tF)>%GBKsC6B#hMzT$R?EKD~t89c3GF>(;Gs?uOR6{C&vM zSQ^U8l3c|0-hr+@QO^!FDZggZiU~V%l*Hpm(QAZ47bbK2aK@Wt?%~6Rv^92%#AixL ztsbbje@*y@beZ!58w-m=3ngBdU$XP_^Ru%%O(ODnoI9C0kF8(b7hiRo??_#=`Rmmk z)7rAmOe#B+BN^Z^T+l!}w@=f%>3DiUW~PpYjkdO}_{-x3g+YZ|uLtD0a=Dr`DZkeJ zPiiGIe3mZz3R z!cwjm`L1E`wkB!LspGN}CnmvHpgBBRa`AVzY~6ZcGoH0IeQhhtc5VK5w0@nnHuXs+ z;(;#Da1OqEZht*DE91pxt(oE5=9PA!T8Dk_pQO%5s|S;-m6NodJAC<2l* z2sAWFGEI|16YhL)zu&n(z909;tyAYaRl91JP4^Slnrp5x#~5>YDl6VQL3y4Mg+iTp za9>&#g*to-g(5q8^dNllq4Ku|3UvzgK>D`2ZPeT#c~n=|Q0-!_ua^D2&nLYu-d8!L zeo99D&@oC`m2Yl`Yv^Ruzv*OOo?N2$!pglDeTF3n}Uq<<;e9$SkUtRjs*!%TyU|86j9M)}=PKnj@hZ77vSz4v`t20OTzqlRfh4Xdf zD|6o23g*z*-I~QZtP}X3ds2>_-5Ra&E;Q(#iLz|*^z{wu9NT}6kB)3?Y?8YhV{?7E z=qSNUl$>s?|NQgRs$HfzQqbSqn|J@R7tgZ4kHrkx=|x-jY;P`4Hb-LSerFHIGIZv= zYJ8Tg_M$gvu*5n8o$*j!-e>>1sOKs^*vGlAJChXx1Jw#l1|wo(n3{6mQW9&t=_*%y zo-hcS$d520S9iUjlByinsU%r$GvCjlk##)ztV&efsIsr?ym;1YZWh{*yBa z@$omKu1{<)w^Cg&wA|~{iych3N7cP@V*ks(__MRKPcR7JiY+Jo7)9k-=p{tfVqZA& zDHoay&SsVRG1Tloz$fyvRi#$bs+pSnV;mXeF)DkNhQos{TpC%p6N0!~rpxg=! z5(Y~{xpjslR=gM6TOR4DOG!!jGl`Fmjs1JWJ2Kw1=nt5C7OdayMY<%fr>3UDG>Vur z|GmOhnI)6Kl49<6h1uf$3tzVyxk|sn;QXEAaq7dCHJ0n=+}B-jb$L{Xp(@TTm6D|j|>nq^Oe=j7Ba<{^q-gP+;vn0Cz z^Uu}TqkDLi(&pcJxj)ABV^6S3&6yne>&1>DZ({bAj=a2lre^-%`+dB@Z`hMZ=7JuE z@juVZY`TA$Tkjv-zn`j_`wi}%DlpxXb}<&Yl^MxJM`{(F~alndE4UNry4;#;<|x)3g{{{3&d9!(}PJxNz* z`}?AoA1#j7=&nls=U>?`YT{MZ)DjXB6x==q1O#jquB=!EM#jg-zu2W^U@+Xj#xMSc zVwGY>E6XRUs;VzujJ7A-3k(cY*!A@G=6G6U26GoD<^K0kgqt%CNN{o*@9pl~^SfZq z?P6t>H#5@i;;G_}8)qpu(bP<*y_0!ytCt?z%c+`pzdqpVu_n9yNq4KSn2@{VB|LoH$Z_zU^Qro7#uY z>HUy@zI@A7NltDcTi3&&zv5Va@riT`MOn!nWaMiZ^iuQ{Qtp&pBY&^?apf&BM%*E2h{j$n_CQu!Ua)b1)0q`?Ggz>T=0J7vk{u9n!kttpkt#7>>P?T_CORb(879uzJ&Ro9y4V zn2m>Lak*7egJ*Rn1KXmgWFX8RJLiodsHz#Ay!GQ*|<|BfF zUhbCYKRvDH`kUbg^C}PWeb=X*i4UmtgnW)Kgbw|IjLfsieum7^-hQjX$wiAxJMn(| z)YLgO*PlOsp5@xs2z)>EY#d*;zc$Kd{X_}GMk03^QR)-DcA)+XjD7D{*Z^KFq5nBz z+dVX|g zM8$@MrMjTgxIPui_eRRz-^h6Wqe20B(py{9Pe_>OmZI5@6AKD z$e({XU3#@~UvYuuAekd99!*V6b#2t%z z>vM~X?(*N0R!kOr@115s{=QUY&g(dyf}swlv0c{i6`^Zfi1bU^v%hBC{W*_}jedp9 z<)W~8&39w(byJ+}OaFR)9-i!p1;Jy;kAE3Ierc}K-x24O=>YJ zpF?=(vt)qAg$I_k$5Uy03+DC+>VkH&SS4)OxY$>n_>SdO(GY)b6N~dxKix|^vo{fK4IJj3bR~1`1H}K5j{DHp%BlGM7M%rS3;O5zOinA+vSYJD4S226; zDYP4&oNqFF+f=J}PrgZKa-Mn^ndyrQY!;9&_%B`hF0M*dYCTJvJv}Hr;WTXdAY6W{ zMsyp0uD!66>hJH!^=w@>j+!4lypijDFVxeU z@&fbY=#Bj_vQT>#yX<#-fr?r9MKeW$v{6^3L9KWmOFdh0?9qV0z&d|sN%PU4@S+Pt zQT^%~BNxc~(=Hf)iRd}&dM*_mCDGv(cerKw(K+k*GM9;x^R z#jQu{yF2W&VLqVN%d8-}w*F_b=7s!iev9#6kZ=k8`HkWhDXs7XwSJ6GvYr;Zk&)X> zwSB)h3F)j1pb~*+eGsF=Bqm5&n;%&3H^e$^jCdHVoBQibCft{N)Aq%IP&_#iY3lbE z6}k4lw5i01Uf86U7$uNZ+AY7{fvegDPI5)BFYS*1tXjl$mk}onCL^N?410B)#?V<$ z`^Mki@i-|?tRmxm-E{QzXd`#!)9mK8439Zco4H2-p$2u|V(;rs7WXB-jyB9Ho`BdB zBLu;k-EDQ*9U~09qZET7xUBPfda(Fj7=CAjLPPK>w@6q4 z$EJ{Zp5s&X<$!i4_PQF6j*pAWL#w8l(YZ5iYpUk%kwIDJd-|bg{S|JUo=8iH(JVBH zc4z`Lo?n!tO9k)ukEgGgRPL<7ES-lZy*SD!SpGzyI`XJQXvHn` zFjaE$`cr44iI}djWK3Upl!U&9!2*}5Gf zY&Fh*f;A4Zs@-rH^A%Kofp+Tl>&w+^9j^}*#SrEMUukOg|Ma9r#|^^z0d&fj3~K?M zu0H)cdn{N(JG?J=nc)2iz1e$#k2vNp=?t3~`=klJqWrG!`E-J|!+bvBQJ9(%2BO?? ztxs>P&VLVf%Y33iW$L5s_}8g-ec_*y?CcE}{P6=C`kL4$faM@C%K)N2zHakjEVoEV z%xCgLq5jQ0^Rc_@cbdPO9(4M=I@f1Oz!kTI!R{HU{AM$s1D2FUZC9S!&L|Ld?Z-*Hd|fZ_919@nDbH+h9h8>csQN9luORv z{rvDBpZIpu=-uATt{lQolkYLs>s<8I8@&zga{i`61Mj&6MY7dy788FQ8`Mo!ip>fO z>RahQHt1IAL|Sv!`m(n+V2Z&z6%Jl=V@Id+SxvP;k#uC2?S>l_{Y`0wBW`L#HUq|6 z|NN}2ofz)Syeb#+W`wsi>xuUcEO|CUL{nP!a8@ayVQyZ~uxD<>gW0BXr%9^liVrHb z&$4=m&u!)E7qK~}z*Q6KYqN@TfG%U5x29DR?!MYER)az&(zK%3Wp9_hKjoKFf;Ur4@cIBO{e zOQ`9Fb7Sd3g(zh63oct-X=?dKk5?L!ZL$3eKirS;M&2^5R7+8OT()!g7_HT8kHYQ# z@!|_OzW4@9-}C%9-Iba|;jpMLD?^2*I>z6d`Y8cRcN9lPS(@qm>cX6mdoAwwckz_>p{0}Jas$#eCrcsqTrK{tCKmQvldaz4n6 zYq~OR)Fsy1aP_#!+EAH%vq%lc>%|q(^un8`bzw;mJc8NX`-;B2NTXaLpq?h)|9pV# zh~sLvhUG+)9c(hIZJTPcvJKIgp)?oX$jBevpRe5OiXcK>WeaW&<4FLdPoP-ADM{|| zrNl555gA3SHi*?!-6f0FRFcOT1m?Dv_X^{vE(o3a?L{j@j()>zJA8oVz03Auoy#5x zPq5GLr|WwA%%gX!sMHeU-?~MZx-B87C+Ir{+u6wrY3mN2tyOMh`Aa)%SZjIuq*dgHNKBd+ZzhHu)X5{(7!aXX)miRx@5jLB}B=BsfSx- z+I=g!p@y!LxWQRjR%8%??_~b!WLGDv7yfO$mY-;Fp}*XraG5xZty~l37rDPY(QN54 zUQ|@%NzGc~oo8TIvNe-2*xe3^8_M;5yD7}+9Gev$-QD(guA||lHwMzt9GD}GEuE9C zvG{Ta%%oDZD8?D~a$GC=%Y0W_C$@6efSHzE{mu8chanwUu@EEQu_!yjuA9aCx-o()C_G4g={XH3t&086SIsm%^Y zG}uy(z;e9V7pS&epZwN_dBd==E=ujPy`F_~<{6q}GSN?`nDqt=MT>7IsGBP&9bg%>ziS`Io%sMDMlGxj}T(367miH{2orSav>`gmk zI;%oNkc_PQ&>BO6?S$g+{}3ol87yJ|P%e z|5m?JY;!y?Kb@Ck2*m@AYMn5c5&H0S(eG%ydt(!;&28WpXq zk(8RQp$&^FTdnVBgWjudaho~1Z;WoWN*BNb%;SnX?TU2k{9e>}g|~4&&iT1R^y0W# zq%;JZ;eP*R*jcJ8KClKFb<+3u#r-wxki36Pg}R;3_M#3DJqk!(H- z#1BLjx&zre=r}clLPA1DUMAf2W!Em-Afpm{CKVbJla;eQ(Hx1U*@G(c;GO}wg$;G; z>F$XN;#)fg40BId-WZ+WloIEXkeI_BFq1=ZVpN9s5!=; zL9JF(c{e(y=&E(=j}_g4+=_yWB5_hy)3xm~=@Iwi1Cm7>O!{*E6bZ66ej3PZSbaZavKgy#J-~_;X z6HVa>{YChfrWKpXns-}-#(Xa7kp?k%g&48N+1vh-yUJ|AQYA$uGw#3R-{N^2*S&s5xb5WEinA2f-7X(<;Ars?k5FJcIVcjtD@w*Gl8r-tT={o-i3++E#d1$xrg(J8Z9J#7qVY@Lu>hq zI6oOGHo$jPHt5Yl!sPB!BR7J--X1=NqlU6ebZ>XP(qEK${(X8kNqoJ?!kSuaZ+kgZ z+g@MV_#r&!#dC+*tC&d!D$ndO19*}(#(vMR>0Pxhd#JZ42^*P|GXLa)s(ol;Ft-d{ z+F3P%BQ^bbK@%~DHKWNm_EfDBtNIuA?iorFn?LOymDw%=AraxKwur9kirtQx#q<}) zoS~Q=Jam1VN^*M`lWCp$_kqjseD(y$%scJ(n0ID%_AJ&%378Ov4|%D*T9`oqwK&TR zNE|j@z{?1l4sAymX4Mlti%Td@GKzFny6im@$wKI~%d&1IzPORSm)51zi3`q3yPWSt zotc>=b}FgAGV4o)=B<%Y^K6f{txR_c8vXuMvl8pH);G(g7~Zwe@|%9>bV z04(~=nYZ5^2^Z(l6Lix&QDQSc!?fHih%buFf`>yXT~j_F@yB1@Z^`LTT@XM0q;C*9 za{g9-+_Qz%KOxRSQF?y@WP{m@O^rUq#Kg#iFaFNfb#`(R#qh6`ioPvPU)TVIJxCSY zEdNs3x_8H{)`#A$^IC!lu81es;o4UDjn zufZbZxuq)((hMgw2LCd1G-|F)x0}A__j;purFxH%8J+r-LQCCIsI@`d`BewNwX{5@ z-_b=KegXa@rZM2vrrYA)F(SCx0U-cMuQ+Me?)h!kQ5>VU@rdExrgi@L@wA)M0kOrO z)O6am&w-B5s@R$VqJ2}#e12VfWo^f#7E0GOAQI9Gu&H83zi)I0j*X5+RUV1KGC2xb z)H#{J+-$ARmNHkYbjUfcU&-5k%^)A>i*G)>t@zGmHnZ@i!wUgHw^#<#GL=2xs(zQF zwvN8(L>QDRQNSAhmE&_&pLtk={R~G-Rcu~s9N5!x_Z6R(qAm%eqzk`q(f2A8g3!9< z4o$d@-Jf7!defvgNeh)3GYIQTLCun9GH5?kW=CL!61UK(Z%^PZkWa!;O_=Wn1qF2h zU`MO1&-Ep|fl?T6J>5~`RA?5A-f4*3yk<6nEn8}M5XjP}RuSw$e*D}GyQP<7v!#SW zyt5j84_1i;rTjyz_MlyA{fcvbiILs}WmDmx&A{#sDVn0cz<8F>T?R}55CZ0{#Q8$J zqP%?5)>1k+C!Y_ zL^he0o!>wI32U40U)A_$xpYj!Psn2YEc9w!8&dl^=&N7X0WxrmYzQkD;VBk&5xqbJDqz7b1Cm!Gaj}jjmC{jtWaDP6c(|F& zau{V&{OH)|`EGXJtxJ(Z?}FN_Z0FcCq-$cWaBK^~nGX%zLP5<48S*i{pM6`79# z_`_XHshmmA&~{oyR|XcMr{_CUlx`?hPR2O+F`Qlwqt$Nb31eG;(xYm{@ApvM;i<`(5djqjLwQ{kH38&!@bEfyGL0VbwOvZKDFq6acNjA@V@#hQ|t}rn~em`-T#z?)gIbP^-nrhPND|Zjk2QP=^Wc0Y|TwwsqdO06v{zvMyDSS>d5e_Ui1*AtA8YnQd%MBF6|J@7G( zQ^7upaok#8x2dq?eXt6&R$HHOJq40J68IF> zSjQawP8NrEix7hvX{s_x0IRe>v-!~4fLEK^i4oPU^}#!njDd6k1*4roa`BzDicvS7zjY#+o13Sr_okyW6e0!aw5(Kmlr8{owXrw`spAC}*Fzor z`boY4O_TSLWgJmJp$Fmr{1_31tUT{^DZpkZ9t^qB-mX1Q;31;@&fso}x(}&#R#)!r zEPy^~U;@HJk7EgDVW`5%fo5_?@eLKOjpeI?8E&U;!5UqQU@f7~2oZYP54Bf`a(UTu zb-I3UmX@PLI=U#L{6%9SU-6aJg9s^x`hvRlCZ%oiOCA}AA15KS%TeP z&E@HPg$SnvWHZfy-HnblZvOp$jb}Wv{PB_f;fBzduJ`#~exhIAIN8X`k!0b$RvoI& z&Q-h%QsSUcQm4%iNQj7tG_!^={kU@m^SV}0-P`cdY$dnWs882VNix=tY$~nquL%g; zy;(|DaL`d!R@SfbHuBS32WZXdJBCQI2ZqM;iazjh0%V+|91^x9=wzTJ&zp~9m>8GxR*3(Z#>dQ8G3xCGgdpXE^ zrr7`N65E7_*zS_D-rCcB?$yn%zQ99$fnR(h-r-xy07vbAsiLRee=Mci2BhP6L0A<6 zYGdQj7$a!ZYq$fFq+TwO?a7%0huxVviMS><871NTm(8_*?|e!I$4`WC*b)>Lz6xTB zOq`UtGhH6@K%vuMP~4M>osB61r!zHcP^S9yTQ2^7JhjfuKgg;@-7>qJbucy{Ajfz> z;Lpg-R}JU6i5cY_CD`yAwqs40&H(>ci(jXTHqt}a#8xB7KQ1Caa(xDG8VW(4oSY0& zA4_#$#}%*h=hdA7Ne`5+PSTYUp6uv;QsQ>9&&}O(3R9jq`}bxcmlqXZQ&6~Q?ZgCG zHA#yFfJqkFi}=|M+e;J=>cw^=snd;ygT3x|yZ#%8exzW&10uUsh*34cJ_d(MO&a^-KEw z5!-B;jh{cS)Ym^?S(3iDhdo$nxp+L#Sd{Mc@cx~{y+8(|bOa@p4`fF-kOHZn<5Jod zbk;NK3(7O3rYiPD2D5li9EzKg2&++1NlDV|nMkIhMptGL6)pfL- zuW~r=y+-^PsB5X0#j7GKOT4|a01Y@gmWhW-@GO4xL}{MW6Uut?AkcU*N%1D~P1MUD zWCw;eZkEjuAy;;SnBcKKKM)xeWwaD5S{0g!ajP%r$Zy?O)Zn`e2Zn&~QxCuSiVvjT z9G5)_^w{!Z`bJ*f-rp;*%W&zGSX6@iffz9qo%#fukwEL@6v zHN_4eT8-1v(z3I8Y>K23r(Ad3A}lG*Z{iri39_4^ES{OOduqL%%a`b2>}V#@(B^Bcdko4ye* zb=yt9Bs3GbMSqZ6^`u z9%wI(m~~R%8Hef4$nNs#%>aIeeQgi*_Ks_-jDCIH$*(#VFG(LDgLGBDze(dArCu(* z`k~!?@ox@MKJ_;!i6|4Tzn_r**C&57IEv|(>%P~ZitH$Hf3R#(e`PQf)y1m)6+V36 zukeTxb4Bgzp|1Z2Uc~hg_4kg>PLK#!v44X_P)0_k=I75T9qP2pd{rrli5J9dZ*X!p z|BVQZ_=E(|vzZteJf91*cgzfE##DPyF^k$X{rx*L2o+wmoCcTWe`=9oQA+mvgEXE1 z#Ngdwwvp3x!_?H&e`j=){b05J&*+|5SS9;E{-ps1AC@1GPn8rD{GX1K zb^l62anjF(uKqi~{wNnma2oubAx9dw5x&ubjsPGI4H@qbxY?-kb+i!wX%=>I@j>Yr zC>sET-UU^6|8|ETSy@?u2jj}}DBD)j{Ui_h?FHX%%6T_i;=eaJI|^9Zf^u!63()fk?+kX3M~mPVJHcv3!kmc^_}0CO7Le_Pkm-_TfhaQ$d}Ecs?PzR zTmESXZV6kJ2xL{tQcGz8Nl~-Z#yC*Ppyz9vOJgv{I>=1tf&3@dF}sMZwB120W)-Fz zfq-qPVi(8iFiycHFY5Pw0@)q6x0`NZw<2DsKkIl0&R-a z6>};Vm*5vRpkjkw0rR2fyPsFcY{=%F`5KRibrZNh!6s#cyIXjcFF3#;TbRd1=&srrp9Y+nn*PHDI;G(@+h!diSK<@Iw zRR@5&hK^H`8^9kQdfsHSksmFwUUb}uKMxU^eto_I1(n9HLWTk16eo~NTg8@r`n}*+ zIX3f}zBqUfsBBX^%4gOhpdhOSp;#1(5;7eOFxDWdBJ>p$-z!r22Hge&1@mA=J4H=B zCa5a}WB_j41>X!~e&jTn2*9{^uR#m36nAKkmb=>?Dx;40XjJW1l7S5{& z7-b1cBc0sW%?bVz=~39vTWs`_&f5W3-=bkW!b^2e*2$lsB2{;8=#z0 zXMk#^JCaYo1Gp0}8jgsIQ;&5V7u}uly&xxp@9G#=(QtC4i5DWeyWUUgm&4D5 zx5=DLIm$T_UeONIR6ym$yQ4ZqC#xj9+{C*o?$W@PQj|imgt=Gwi@lGQQ&U}Gvb}w8 z%2KOwx$O>BFy|8+@Gll99Dv4NjGdfM}VcIBeY7Y(d7VZ}uMiGk@OsLU3% zXcl@k6F5bT`}rp0{Al+Vu-u#miOw>E>mrBEqA(~+YoS@pvb(bR5?lY z)aUEry%LnGqh9G`G0;7{q=HJA@5WGW?Ca6vds{tEOw)EWsD;W&*Lrhv{+8Y3t~`~ft-So)EHxSm;+A9kF9y;moBVK$(@xzZ7w4EZEQ+X^=F7rwZ^Yw zto(c#w>Lo>+k@&FhVeCPTYK;#zqU|y_yZ-SJy;Lo`W^qA0Bh&e@N2}Xse$du?gttL z11eYe^|ZscC0*+4>+SskK(#;bxyS63*y}W%1hp>eRCdMYL}XW2*D>xgWtGP=8vw&H zR5m~!qMTEB+BXRb=|gvZ0fC2=rzw}cw(Lus3pDc${>amgFZlK6AocFyYc;FDGS%&{ zk{mMK+ixD)8wjeI{jfD~p5ii3)$H$@lSK@2xUKbt*b&>{pELopU1dyOmF_h!4V@$y$SMT-iuu{}6!#~3~c zvfvt4z!@3tEsZ)m`W}O~E?THt|0w5lSAtH}Xmn6!_PR)Rr&6nBtN7%Fm)FuHAZoTa z+e|%9-ZV;Z_3ebG9tSqVko%iph2b23QU?i$H5=f>GTb$<@b{&}I?t@1`QF;OSkD?e zwNXvG9KE}F*Y84KDaKUvJLF4)-QBeO>hN$L-4A}B!1Za3OK$k!XOTDl?#PJ_l@`cV zq}5ryoJ3s-P8aZqi2z&Ae4FzFtvtD^!R1Oq$?S2|#mjv+^K*Q5(M%6jG&7shZ4m;P zP#F6Dgvk`I52d%_Lf>yxXVmqJTJM-vvaeuffg$=kTVbQBq=P4}2lYNG0 z*({ePE?a>l-7HL_!`mfg@C-5ui3%X_w#Gk>%u+r?*;HP`+ z864#d_OK4c)iIJGCPi_r(av=MyNgEf2)rw3-B2Vas3>))^bjnE8jW5>|a0iCT+ zshKsxX?H{ecYQrQRr_OD!@1PR;V8>{vX&u^2t7C>!$mlBT=i*wymmSTsHP~JmEn;mE>zDf6chSKF zhGS#3q$5vXZLIWe`+M*}tAb*oV*NwBBgSjt>GhDqqDg+$Q9N6oNSIsa=>bLZV5Db* zeWZmuNGdBI@;_n#kb+fzuu~L&4=8bj* z!oTf@M~oCUgel+s+LXcMN8c0ADM0(o&^Yk^~x4aQ|bk+I*YE!Oqot=NGQL;?iEIOkh6V!$&Jm`ZBrZ-83qY~-Ai!D=jt-Toh zs$%_zC#Q*}FLcO7YBBe8sI$n(Pl8%?H$MoB=(>Ps)(V@n80wo~&8Q(HgX}|>@&N~U9r~A&~ zI|Hg;@MqUwKHvM#YaZDEZfqczKL3DJNoT1}hJSht+ok_-0Viv6VumWb7G>5EqxtV| z&kK&~*3{KSemjI@^ZQ@K(omIorFt>3$7$>XI_Aq0yKcZo)b|hs5-|%x-z6JHvM& zJ*%qH8GHc*lqs3|u<2ugX~EIV!l4L3)0oWZ^pRVKH^GWj>XMebJn-`Ja3Q}K5DTq< znqZq{z_)yU?qV9qqL4!uK0ApQZWsT=zG-j@HqKHI(|Dt98Q-@V2BC$4=f(RYisGwX ziqRs7Wy|3%#N9!x)bYCrMEH1Ut6ZnlW**j5P@l1G4^{`O`QBm`a;_b&xX*qU@R$uQ zfga5Z_%(&>=#E)Y9eKePxnwKuOZAoDw#Fc~gz7W^9U13dV9gu9VjoM&PM15Xvp&vy z(=I3h0o8c`c_RY|R~DiarVyMc*Ko9Ksy`*VOv9by4!ShvJjeyZ%QTe)*vP)=9eN6+ zY0II$ZR4ApI|Jtn?jI-iYCB{Kd^n;`0}jJdd@vCzCFhm)d&UkAJ_z=kU-RX-&&tY* zw;l6MpV8wvLCi>-=0?= zIdL8-1$+gEj&9EaMyS|ck~?uo%~{X|??-^#NMyh!oMP0w{}2kB!dkbd}|};ES^!$9m9X%I@kmOvGj7QKv+aqj4BjWDiC^` z=kYyH&&2h{h{K+|cEJa_O`!D2GR0Q_@GJXK*0TiI+-JeQW}j&fPn9sG-u)Mavq@Gi zHE;kT%B5suH+dszMtJZ>^pvcELbqC8zWRv9F)7+eyuflQ<81|Hw|frXE4fe?rB-Hp zxi4M1-MqPVpufy6moaU@&UYGLS?Roht=KZ)?kC!2p%d=a#sZ&%>8Nk5Kp zr?xB*$hFk~Tv`E_Zg3Nj$+yM)r?Y~;>>i$5J{~N-l0ArhoeaBMEhZ;kTvPVJgZ8*c zzb5%pc{6u6nqtHU*4XpFlFn}y>9aLMh8h=TXxTA&HLC38=jXQzm>OMLpsVhM*iJ}= z@{-iR+lPx-r!yT{dqdl_;FlDiCQGo717sNC5+i9UwP#G}IEW(|H=|X)^Er=u17!~u zy-u6h;Ysi<(u-KV0Y5_&4_H$8Dzsg;32n)FIGENdZwj!GZh*uJuQedim5WHhh3ufK zGCK6)s`?--OGSQIGNnKMwGiNc5!vX4p+HG^{g~99X}Sx0*MM4|b)p6MKhsY4VKda1 z*V!}(Qty-EcaZJYU$-kU+Qd>`Px^o)+z(iJ3Dsf`Ekgd9x zKW@9=uHXH#BSWgePpqlhh}7zqyx42y=fdUNtl3fgr@66 zOLWE+USl7~@`erw&T;Bxo{t8h<$|!qI1<>FlZyN&R-kRjZh0cSc@65T&Vz5D?C;Gm z!Cn!=7)tFY=L@i(rdRydYYO85>ll=oNSA^EBO*L?OD$AXaGl%AS3P~J?v%kuH@Car z@$-Cd+MuVY>RlWlU5!nf?Ttl|Q|%lA`W@pC!DZV^jmEB2rZJbMA+h-7bv?~`T8{Xb zoewJ}(5WUA&|1JopRSUs9fyCxpEK|-ajXO+zpf<-gRWHAv#0K^cttRU3KOTlZxe*h3m83u zDi=J!h;wV9_G;X&z^jdt;+27jjLU@w|1v`ta4t0a+|vIj4)DL{ec(O*XHuH~yI$ub z|7T9_z90ccv*&MhIx1a?O- z+eaX)>rwU#mLFhr;IR1uDO4}UF1eo3Zkas}HV4aC38#?jk4Kq`f9h=zN5IY84d&HH zsmho3>CK}m<3~1_oi}bz?+kx`*AfP-%}m_oc&80u<}$TPZMsrbK8K6|r)4dw3~DjX zy9cg&>4Cg_*`JUn(1A%sQqEuRR1`&;%fMltt;?bqb&i37)FH>cFF@Yoc+_u zPkia~k7CBQwGyC!qSXFyXk>|j!&*&Ayjwy&eZSMs^_0vg+X{FZCc(QjPXw^npZFlK zN;5A11gEL-0oWm)UgG5E?>7BF!>-;YM{AA%DF7~2M4dWg-adu!=FWs{To0uWeClaP6cNP5Nd7-5`(B2CI1BAxS z+rPdFZhYz~TLpJ@YWPL7O+fIx&@sacZowj~D9kNbN%~F#Lxm7yES7Oxam!u?;)o}U ztW~;g18C3>;{U$e8KpQ()@Kud2ej@w-Ty2so2Ot3!A)_kJcH&|eW$R?lbR0T74fgj z!otqEi@f3_v7(h7*5=Y&26>BtV~T!HOGgKH5ua=_bMFQYs!M!PSfZsG_@5153RC*+ zL!0b`P&Ipv+mE;tLvybb0_KI#x$u;IZ1z>#Nq|(OlG!W(2smi%kuQ?cT)qjU*Zgst zP5va>yTJye6mf^OHzozetjE9xZ{6VlQrjKLX&zSkT-x4&ny4x z1jcLj4uf%6P0(Lxr*{(A-92zT&3&86JO5A?dP?JB4DTU@9)p09S@PcRI=j?EQ-Ul$ zua2H=$|wS2RmlqvUZIX-%~8UgX(bs$6##*wG})&I3Qet6T-H;8Km8Nu!KB*h+5dP5 z+#LCIVao4ICiuVhmoh#a*#fpW47g^nQmU&c-M@dMg5i|N&YIqRUJa5vqX{&In&XX9 z<)#WO{>YZUFZd|nCOf-Ed2~$l(jIsKn|4=_?UphTYAr<-p2!0g&#ON`8dcTrqF)BW z>z}Jv>2Vftb@5B;wOkNw10VXN1w{sQfU*BV67l>|`tl%Qke?L<2Vb_X z^@=j`ypRUkQ(lofF0w}zRC}DRN!j9E(QnXC0@SW}WGAxGT>Er6n{ErCFf9Fz{og!4 zHuq|<*o%aYZHk$~R224~o@kAg1V#@~7$jS;^Ye-dW*sx7jxi?hIR4Ce)p53B0$ zVm7~Omv2GThVkhK%nY>XcpRsP7L`GW`^bxjDkq}qs+KR4?qCb48`@Zjj zDzPf^lWzrg$4Tm1@LcWY_17!zsH`HP{D!>Cel3m9nN>IzmHH9v=UQ?e^kG-lQrkVe> zdZ1$m7I@gAmee-zSV-HETW9KMdQfmcK>SE4p@gG|eh(d!&w~ZqC^Sfl5>~L~YY~iZ zK*9kF=txk`yRRCPziy8E&T)5#@#xO^cJgIZ$^FTn0q2)K**5TrexilSy=CVa=a$H| zPk|Pj2YysYmqn$#R%$a$f+kPFA`T2khQ~tXo-?p_NFzsJg51=EMqVgHYj@F*oInbq z0V`jWdBJJ}=t&H+&pZ)!%1G$vRF#Um zDyPxYHCmr4p~Wp0+9-zgo`3{OqXEWfBS#FsA#mdWTEMOnH4w*ur`QHZZFV*I0-;^! z?cyK5{CD84@SeY^K=_95=bbi5Pw;Xih z`;$sQ9O;AZzNA}O&-n#Y<8JF(7*Gs?K|D#Jr^sA4Upy`Id+|Fbumu2pKQyO=)OBBO zd9_iN;h>3Rtk%~Of6EZomEu_+U*B?QAMrTBK>N~Tj+fQj2vrsu-eLYnTqp3PF=7t zpVAS;Wq?s*KWX_W(uY&y&E;x%wG0_T&5 z*7v);kmaYIa3-7L^FeJ`je4yynf7xKSZU{zr8Gc}qEWu*dwvygJO`aHH7pBF-=pI8 zE8q0k4C$cm>=j-MOUq;b~=*KCoHj`&(Z-iW$gLw73-VH|W9oV(4z$rj8 z4cT{!O*V`&RuE_QE}jG(qi^TRC4Km@e>6VC@*6&c^sc@Mh(KA+jWz+GmS!Tbf`^t% z?0bRjN@s+_DQ?m3Y`PbkJ_1L4dqHPY{_8o-Zpu9lQPa@SFfuZN320UqmKI9-2sdLiM;06{v;pFT?81>-1aCOY1Wts2)Il?iIE7pt zY5sUp7SJw1sS0cC8x{J}b@fzbAO8<% zr4Sdvao3|?sC0p+<^STJA})#)y|-dK+fb&hU7YCjvpd}fPG7xrDeh%`!1>>$n0?dM zCl3&(nZc&T&yUWpfG#t7)ahhk7{LAr%Gw&=eobz7MT)F!Hy9N^`e$>ZjYeT2j$dI!v zE>a;D-^1br26Aa3(j^61*?k}0lJr;48{kOX66E4)LB4;-K=RxEb#A>svXPp4jqKuE znR|QIyNUpzku~*+^)gr0fEd{6E=TQrQguVN_$B#&hVGt3eudh&^#7}yF8hdU${ZZ` z;Kh*z3_>Y>0}k2QiTv~l>GBAHV~~(rUVD^UMaGm1UpswBpAp`xS&yhc!6;dDm zoDJLG3ZQI*j>LLU(9bh8I-j`>`iCQQ=R;LqLmvp}#&Od^1~VqNgb+2zYbp<)YT6A5 z2@$Yc8ixx)e~~$)TWBalP9MrK1hhaC(nK*0wJk2+uooJlgK3~hdl4uKe5|O`)(Xfm z;QhJ8#gzpv6rg*`N4+?JGd(3_4vBfb3JUmvBssc3jip&@UNwkc=<^ez%CCcsq5HuC z`wy_`{z6{hn%PkzixTZQCu+`c7gt3 zI2E9z(*bN9K*!99ZO`Slf~DShs_hc>bM3tWI7>mEYih8xa5qz@(ivzJc}2Ouq*K&N zRzHbeFG>ZhRC;fro%ZAfp|+?SKsyUU;eWlO)Db#zoON;2S|npwa{CMG?dQyX6I zZg1`{-0#*>qg^ibOonjkKgdBO2HolW&?yL(IX3OGA_v*Yq)a!7 z^JbM+wvC@gG7hcbCU!fmd$rb~hA_y6W5u+gSf=?D3l0#7hL_@&lM(KShhpb}FAJ3z z(Y2iGA`u%-;XE&#_Zs|i|KYF@tMmVh#KPlmL#YbKwU~PBEywObyw$$1DYzW|1&>XJ z=@msfaZy6;QAG!K;e3cfGD!9|bZ&z|_Yqc3#%YY>q@GYSSb=C>0N-*>$mMWZSC=~J z1`m%p#3>#|6QCvuMDG~DMg&i!-}mkzjK9efr?cF3z6>crwz&IIeGbQ+>3?)WS0BV) z{|KW5sLV-}bA)64WWj7|wL^!E;e-jnK`S+N^&k>9bSvzOd-htz#^^DAY9Yf3a52En z1^ZA9;zRroXT>dIHKoj24usXkxfLe%$RT4g4;_1eJm1Iw((HT1DWj+hsY}6W)pwH5 zu;;qBg%u=?g=HXs4R1z0gEl|e1%t!NOg04VYYkui!v$1ksuFkB@uthqK_e>l5Rk!v z5o~Lf)*0F+OC7A#7zd_ZwQjFNSE#j;qo4osH)z^&*8TD1!wnE??o4Z4HEDjz{rn!h z&@yDXhAmIo7#qZdX|Su@^w3#ggi?RL9(dBc+w&3aL7HJmc`rHNmwV4LS3%%$7%-op zp%{4pr= z+l$qB(6hS=(Yg!gAFwLLd{xa&FHIL?&^hh^gl)92e5}L{tef0wpf10D2)+S@+!W4f z2NH7sx99J8cj_cs?j+r-8JnS`OzQ&JUi1qYTy1TWo5{*B^bmMPvQsdrtu3WqDi{ z|2iw=v?vb5qB(5s#myv4{)NqGVbcXFMAsHc+CO;eaJ?tPFw*c!oJs4O!svBy=QsXEH&j_X_Y?Ruje0 zu|(|!C9If21RuSS*%#kYIMoD$-{71TjZb^A2M2>7D1|;SBxDU(KQ_l0@P+_LSN48K zp_po@)V(`C{!;X-o^WFuRH6`#Ps!l>7K)ivu&n+c^4>d~>$m?O)>0ZYm4t=}8IdwV zrLr^(yE-ur&M`drt2U)O#AbN}%>e#iGXe*JOH zPrTpf>vf*z^Z8iMs8*AlpNXy5q571Sv0J~ea*_0!RR3unM!u2AJ1F#VkTB8iKf21% zy#^qEw4h!^Yc#0bI9xanZJFbr9Et?Q6ED6rrrVS+Xe$TB05QQVV z@yb8 zAiaB)I<40PbV@vMWwPENAg8$?-Uo01F0HZ@GQUzW4`mktIHn-O|GhWwQ|&Uy_xnjc zG0F)oFU-n`_3OG~{hQq8fZ7Abf~_s+t^WgX`WmjKG6z7H)idz()8w6ZCIn}X8bt?N zw`>xA`4Mkoh5{q1V;imw!V&5HpJ?(M+~j~YsT1cK$-F~%H~@hM{s+v&XsM7>0G7^fZiN5g*exM~ z+(*vW1EgyNw9TM5{23}DlA3dfaQ^U_2W63};byNMTpU5y`g7un9W#km%hZgCuadnP z@QLK4!Plw0&tN7>Dzw6CQ3_{by-M!t4W=bBW>k(&{8Q8QoF`Ip`;yUQ> zmW`K&2cG_XkEH0B0~dL%jfZ!t$ov~#lK*gpLNE%)QTQC^A=Y$0j}D@2e7}#sfL0|` z2lb)CB}b6rmHPE%)2IjiFW9CyG@(=k&b*bs6Nvd$<@XYF zjN1=#eELI9D_wNcHFrM)!#ZMTTAjf?jS>1&?HTL2vG!rjQM+ZL^fm9N9%`u#AY{>s zSI_5VxZ}!NsZ)?uV(AD`;Y6~^g|T5x>t+tWl(2q_T-3pP>l z@y>x8&Z=ET3fca(pOg1T`B$3=ft8HuUx30xN@fQByodcufNKbYJpw^gP>i8}K#PJS zSb2**F8DaAcr)Y65oS%0*h6L??`w}kjha*Q*1HsR2`_)*<*`FyU4ORg`mJnBect0Z zPeh;H7pmj79BH~?)sE}x-sE2N6SRWXpA3*_IaNu~iyOBi2V$Ij5M?-9{{nkvK7 zxMI?aP(GEs3)xsS;8XBr>1edcAkiisy?eD!MfRS5Gt^LPIObC}$n4y4kRunWDSiEb-ec_oqg%lu2B4f~b z;~Ry6$B&dzi{P>eFp{Iw(uIf0nh;8!kIH?P!H(X9KB1&Z*he|-a&Ep z@n7H8)D_0Lqp0T0S944|g*QPU?ymQ*j9lm3y)QNp$To5}0TX~zJwtZUQujR_&gmG}rHRP@^>(Dqv+O>X}CMA=>}+snyczuws&AnUps zm&UxDm48Ihiu1;Y&Hu)(P86uWoP<(TSxD~JSHzYYF#QV-dohL|crg#jxkN(VsiNpb z8}r4-;?xHYL}tpFaI@;-*xkMZv!a1C;&9ro!@mwtkb@bJ5Eq|55& z9F#VLx66B7kdH8m#-J_JG?eFFU=?U|VF=Ud=84*c?70oNw7fNAWG&%fdUGB(_Ad1P zumCY_-0wW=zlGCr`rrsVDxMV^?t)>nIS}Owpk$=S-a~!>NGV>01quLYULioT2Tm~# zNe>!OLI4BC8cjKo7Y0C}jqJG*-u{MscycB!b5)@zfuaUAi{X@d;muH*se$uO8#<0- z4|yL$MeUSiuv*(H#h>l#L6sV6vdyOw1aRoS(kUL@1}V*GEm9RV63+Q@)FH5wFEA4}nz z3+Zk{wK9ueorJ#!KpNi`os0>P2gCX}pXR-;0tDAf5X-2fiA3P|c-*|_J8V8uvzSR9 z@GEv_SVx<7M8GlzSRSsgn%2`A*=ZCmFICXiRTluhcnE?1W*IKDCy;hS_0^k4kEQ-+ zj=&VEFDqrEiSd)KIDT-ic=5=8PeV$S85$t9ucw#z6q`r!rV3m1iUapR_}0DoP$GvD z(BtJz0tV2gW%Ix#t|7~h*Ro6DtBuwrj%W=ELtUC1D%p^muQpD2 z|8C|zvIUHNb`m&HBbv$rmA0IR<9OyMD+ukV&?hViZhS%^1zAxAwY)u$2!{y%@s@O{ z9FLF>B$R>FK+I`mLW3PRcg+1%t6F^T%<=Q`QW|-F(Aew+AgEA*8s^+zLz|?Aw{Z3n zS9rBw1%${VKvdWburJSg-3~d>TSNH40A+`q;Ki)OxsD6ryyRthF#B+;v{5+X1(_Y@Z8I(g4nzhwe@$h`ENw7Gon&{Us$Qv zLrwTHN|N%Ajb&RBV{E}WG$I9LNfoh&Za;DhtSmH-85i0qaE}D#DWx?8RGKD#dCItJ0`u zuTd|>?733P2q52Ieo{ia&B2a+-k;adm(`b5oSY+~^KjGPN8N^(HLnaxSEH)_$-ksotF0F|tHp}JU4cDZHR;?i={ppk3+QM8&xdXj&b?s}leE8=0uG#Q=_g#Uvq z_p8^2j^K|LzCzwAUrwYRe;xU<8lj^;-J!6aWCCs?)H+IGKnzY@8tl4x;D%D>7_@Hv*{!BY=VLD)5_iHwP`zqmM__#5*<15a;G&1X6^ls^_X*@BzE^iSqR@SroPP-ca zzMsR~Z9dOMs}d=45<6m};&BMHk+zcOC$JyrQ%ofC<*FbOM~##SQJ2_UT!$0nK`#x^ z8YX+`#|wdYF54UTCHd>c_Exr8^|n0-yXio59o1uSbRYd;Tb<4sN{4zhr ziv5JHXYCIn0-n?(_Z$H7*kb|ipU+R(fIIMkw?2d2z%l!Ch3ID+zdX>Ri;R7n@KKL0 zcPNG}ckrr&?D|lby4X|e*TI@6#SYjiUd#xuq^CA?B|t<ByCrQp%YM4%@aNd^53e}n znJiO0${Y;1tH&ns|3Okh0=Z!QNM_XD-&~KK-Rbts_Nm&#a~5$wkEbrOy>V-yYkzi7 zGp0T!A=W49{b=L$KijnRtN40$*2nvdxl+=_MaM+y0|hp)k`x!O4jH*_-8MVOT(|mT zPp=)yorKY!Y52bIBbbLI-sAqRPuj9CZNzC>Z-IrBe+f}8s2 z>E;JIM{cPl4g5axP%Wz)|aKtS?yDhMw&&Zfo3lYINmbES5uS`|+8wNK-t{9?JdFIE*4_+jfmJsVWY%b9p|U(1cTzY!owXsNBX>FQGb^`KTlx(q!sO*%h7ZaY|2;ldDC^yN!v)p zlkYG-?64t@P7k*g0eD`Ed%-N&p5T_f&WEEeLr6-{I9eun(_4C&Hs%|p_@;98Tml|kvuPPP!`2NaCFX6G$M(|(8SXx!#*DJ#^PllN3%;%M zq>0UcSL;cT(*zJ7-9T*s3BJt%6sG#=rSwPy?h(YN?nSSq->vkSx0!lnt!LY;`dKsP z#xdihE!!ll^A>ql_Pb@Wf4!;AKb4Kp!F_zs))@BNpbQxryLd|Rv2G}MY{4+KG@hDk zZ514Uk`NC8aAo*yVYmz@5xTuST%dyhQkAM=5rVn>3NR6CncEp~!6rIs&7bk#X7Oy` zxvHtMIgxT8BV92^NyMju>~LGv{OWbb`lk!)C~971a^)@Zx;ne=pYcAT`1Ar13-Q6H z6}#DBO@@+nZ+4Xn<+6h=DF_J_%7M=(gFA}Cy6}FFjU1ry@ut=dMOvHra zPzv01Ybn3uW9DJr-KYL*p~MvrH0nuS8bj;w2sPiP<*A+a`t@@48OG{9>3~{j>lf3- z`ozV;3&%y?9&Kzz1h({_W%b)TD=*LG|9@6%+r;{9svbhh?^TYt&j=@;oIQRdbvKAmT5R1)P=b zWPxqJcwsJ(Lb*)p-C!@7%l(-Hw`%Xa8| z4%DaV#f3y^C`#?+ljdq|2@lY8<QGtyV^1lNcgbu!ADqU30D$ zzneW=Vzd<0GH)Rp!QKzZN&PYA`(En`RVEcYy&e=10IVa)WRS-yXK;1W5n7tOq&!)|g zDLZ)kEM70bkOBF3Cr}F~$>&baI*ufI;@uf}(^f~_b>7@VCx(TgNeS8DvrX&G-veOmJx!`YUN0!tVr!>ptN^2KAJO8 zdAX%y#QO+2<&lAq)2X%jqlZ6JFdyR28Se|(cB>L1|9t4&TGmCD22R+QlZiD+#jon1 zJ8Ow2q6VR}yMW1E;4G$dT5ZKIw>w>qG>a$8M+E@$MYBvu_^qWsR95P}b%&?Rm{F5H zeJnGwb}60GK4k{ycN$#U^V0=4wJ`L%qa4xE3+cQ0etW~U~<{gpcK zf#pIOJNoW=`Q~M*9MkEP!UH5VAT37Jbl2m+9%Ba6dprrhFoA?hXYumJL~0#qR{YGJC&=E)qGXp1#e(Hbl=e4}dCj-tPTZ#JCk!JCl0P#xWgOMF z(hsrL7`y|RX?01Da+V~H3lv~*#0d*Jo%w-ZCm?LQ%1CEupzR+Ng;m~~Go7W7U6aF| zt9H`zdD2qg@3hW+MK)UD*|^Xli22}8Kr@6Rj&y~8!FW_o@H@n=^pFnM?;VZ&+|rQY znv_8ntv*h8P1#giZ}4i`yL~~09Y1;-pMi!Wq@jR76EN68cNUlc>^sW#E)70v)J9wb zI013!1`QT9&DYsXmYi_E-}Qny1c$|r>${<5`0&hM*uf4blF}8WO>Zb}ymh)}@$?+Q zjfdL)p|MX8v-X{Xw7AxLNiFrErx$KmwVdRdoIDCZzGHcVxBvCf!R$4hFMZL^6+qr{kjM0ouIj|Xm%ie^=X5SFb=K9dO*|>71@T(CXt&6qdUlO+@Fg zO?b1b&wnIf#39%2` z`2|8!Gj~6%?G8@(tcsv!zXX2wX>(asc%JG%UVm=Mm>{ZYA7^`;S)FNSK2e!$iw#{Y zr$)Bo)@JL7(YMQ({KdsD>6SqNkW-(B)aH(8h(R4Zs=uXWsnQ{#?XrVbxV&SvN$jDd zpK))N2}JLuTUrA9n;ZHj;qLaik^^J2wzbmd^-n;iVC~{g7khXaSZm_<5;F>=w%Wth zni0HVUHxlb%0^wDPqW93+p>Ofh=Q)VZU&A%DpCU+TgO}aIEQ1eqcV@IzwX`Uz)^R- zr!Bf*PfZQ$@*4&b%}oF^A7)!sAEw7F%#5gvkHVBK$-#q9v_kKUh=gZDeO<52J8fFI z0Hi9-w9~P~;~3NaFOxqRYBIK&zR}IPdbwSDlzr2K-r~nVg;Wl#kR^#$Vf)i+>D?|A zi3fzp`XuJ_N6%+ve5}#~1u}gKSF?!d+KHfEu9!>RU@VpM=y>kEej9F86605G9v$Z$ zcUsrU&gT{ULP3_al2=KC)uTjBpG>-y`5qFI3 z*i-Z1e9g;~N|(lZy=3Qx*DvJG9~bz20oYO6RZC}eP|H5iup@rZ^AEb0WZyU>&tE=H zG8`rZ;!GcRbP+d2jQ4SR`;jy0ccE3&I603ZJbl}jyD^mF+A^>+83xG7huR2Az2iHK_L`Fp!tifXY38D{tLR@eeP%N+N zL#K-U0RLPVrOTW1&Bt$o|J)YD?=nlnf8196%GZ>>8tyAsuOeNGFkY2&g);D4=zv_Z zzPWE8o|hm(0)XBRcBWPel#_*5(?>G&;fNZXSKGR&Yy!dD?>3NybxqxLhM;x{;--6U zct}I|N$Oi&fS2RH#H~fVTUte1_ZyG>{?~MXh`{7z+}(^^5kl)w zWJ5GpkJ}T63-~G}SHH=eevyB;lO!M>i0U@@G616&5Nqk(Z5o?}`nA^*Z}VYF7(&$- zP$Zi)eZDje+~jSG7?>=Rl*|=Xxk+PW1K{l>jwgC$EH!#GxWo|TZ+6f0*uw0Q4r>Z| z;l!#V%?w9CgZ_G)^yf2Pe{k~m``U2isnv~~zH{$#@RO(&7(MUy>rr8r^K0=hL zqdSCDxmtf`eN~VDp<%DesV=_k)buvTQSk!tg_P(!Q}twVCgL%+qCmnuv*oOO3 z5bLnh5X>#d@Nqa*ec$p*XPiXx6mT$s0*gOM^B+F?!|Bg6agi&xZ~o&Z;RJv9Jo&YK zmj{H1NCiY%luf7}OX%l{s$#MIES&m91lDT(pQj%4X$NT@LqZ_#`^oZH{|?$69F5O2hOyhArU$s4(2=Oo{(lleU{$;gw1< zz8igxN0NIpAD~R1oi(4x+1Vj{b)Sx&tvC7jmwx)_cjtF3owLDiPd})?PJ@hCuMW}n zfI_GEr^!B|?bFkftxcO(ZGX*&=PlKR4Q2)rJfCL*MX-S955BkQeihts+P-Q9p5nhQ3c z*OZK}tXmH^u$wu&MN|OX{EpKqCncxzapANpxMr?6TArOo|1n^5BRv45YB0>jantv$ z{vWF6wMN&)!leF*C@T59q$;B^s;SWRl^;yhKA+Q8ShI|Y{e7d%4wQBJ)u3#JxlEgw z2XfL?^b*7@MBE5!=MpMV#l?M#({1=Iw9xgW^4pJg>cSn43FKeqxYaX0&#!aoBs=bp z37RExSq()8G!S?zZDsVGo%coD1Z{;B4%l4cAx9spS8klmn;C=m>P=FzQf(b#Xl24~ zp;lM!$tDxd?Yoh#Fs<@aHOKexolUg1bQrJXY2i22gnKq?Ic~X2WQVdxC+i)fK99La zUY(uAg-)78m_T4hdNHomFtZ%{c@xspjz)q(x*S1%Q0T@c_*=v29v~iyrNGcnLE(nY z{6`A?&RVtlx4oG~!*u$6!$&WjTp~o_>3p@V)5~eMX+qjIlU?-4eMtLd=T8i#g3!mB zFPFAdO;WkI@hUPR(rTN$cD7qyhm8+q2W(wvQg7+YDG|5vZ&Jzl^lvxilT8S64<2Q~r$wxCv}c$o@;qWet3I zMSx>zv9UohT@g_%5Mjp(lto zy9|eeWkyJN`lT$#wd0TaFB4^@#sj>gCnx`mlO?4^vBxN>V1*!nVQJ#q(4o0EDZl01 zv(J8FqZ^mJwB~Id2hq#cyWC3(u-^QIm+q2d{L}2edwI2$ucYdgxV(7zA{0jm%FuS3Hs;nmbIZVPvxnUD!b9?Mk7H+NOeWg~+d z_Q%Q13y}_vX8yyiQSYOBbKgBhV_F>Kwva9X*OHTAVEZFy6}$EP^<@$JuE@?txSvih z`+aXIA1Ml)f=YO2ZkXDu2)pNtIT)BANxh_Ey!d!p@lG6!k$=YRo`)jNrO5QP!mb6B zcG4MJ_}4%CiHJUa*i(Bi9ryZ?k_nbeiT$6Wt608}gj4fHnt0y8q|^WKd6Krmyco-} z`h_}vA}nZ0#jWQtNi9a47(Z#)s@qVjb8bt%@{?QksynpTt1ej!#Z!+y96#SPyz86m zE37)pxYLnAm z|LL~Kj!Kg-Oq6#Tb#ojAGWxWvHM$xiG7^k$GVX#k>S4DRjeXn{Unl|McKcsIkf-KIbQUA+i3+xM#d&$YKE8brAm>JzA8Bjiz(dw*@!lQ z^@6a|t@x%j;||Gj)|&=0ZB=%;tWF&3AL&ya$|o7;^z?le94O#8iki(&}H z-vd8|x_B-0Ns49_ykSI&)01`QQ!%ps+*f_B*`K$eHBvlkmFJ&sp;%R?-Vg{I!Q+lk z>@@-u_%Nl}--#L88S~4~j_Wn_UyV`ci7@r)%Cv~Fcg%C5-MVO-EE3>PN-A)D^2q@% zr3|(!`Sf~-+Lni8nbe7(?+(1OO#APQ*vF+I&_In{7%_RA7&AqF_Hhd*ermLan(?)= zQMBB=PR#4juk*ZT3xxdA#ck6HN)ue+!uB;e1Me%wU5dGy$nv4F>XFfprr0^*Zxy5f zg=fz&bF;7|dCKn6^Qk{$`x^H&5&S096sTVLPgu1jiS`%dNaSq!d)~VD^{j;*ZilD| z_w_2e7K115LbXcu;?HQJGkjN1?zEz`wo?~*ee+Txsp2VVz5i%V2v3f`KWX3135MN) zMN0a&zz`XHom;W(x3lSqPiH+4Ka}VlLuSh9tPp?!|9inoLr(cMFK?gaUG85rg456h^5=%F2IuBL!+c&MSYdY&M3>#ra$8k zj$<-Socoi*2}Ud-Q-Wkimvawy)#oL)Q61Ll%O6Qklu z9No^NwuVky^l>xA#Mp8Xjn?Pn4IL{EDWnEZ1(B-eK664Rh;}8$)J7@Jrx=9V9zJRD z|JPzkj2>oH&};DaXfCVpu-?=<GOqMQ_`)DFrPuP{y>LVm~$_qsQy^K7x$QLDZk#d>_nL|-0Zk}V>3tA z&V}!(Tfv+s=4ti!D@! z=~mo={`@5gG`*RUG3xwvLL!~{Z=OW_0f5`@c*c=i-Jd1^5-)3dQXlYhrlPl81Z|YC zPnudD`HP*1pYY$9J6cvaRwd)V3j40IbE9~xeg54?u0OBg6#Hf$+{B{6MuJhYLs+pw z+4x(p2O8VvR3XCTMrQzFYcaw96hAyP)To|Bm~eo0&eF!7$p}5x%4PcK0CP{yj<;_w zZ`3+Yl^s$Ug>|!M$SdfPX;n9+cKK(`rp%q>R3*eh9Z#UE*OR?&C49eG>#JPlNTW>h4m>_sw z#b`RGFL3T@Ru&&lvsR6u0ekWfYnJ&_f20=eSSt73r0Cj)ov{aBOw0+fi&|Qy&FQ2|pIRr9 zyk(-vGF}Nf>^9O3S?k|G#{X4&gD?wAERvIC^nbhT;5fu}`(lGE7Rl6P?w2!#%b!pW z4?Vf48FU;`#lo6FVS2xIVBdKlAo;tZmqyX(ioHIxr^!@xF7xVyi$FPVYn@h0hWGqv^kQH!F5{7WpW$WpkS|k_J6$EWRWSPiLh#xjKYGjQ z&cNb!KE0V`E2a8Kw_pw?XX79 zvYSXE)_Jsm;PPhXIOfM%bB9yIGUEQB@(6JkaIQJ%$TnALM^_W(90$Q5;Qx>~tUmT4 zVJdUwXUb@!%w&Q4_aV#W55eXq9BOeEF_%`sF%QC?@}M$Ml7`h`piyJ1YyeY{=7U*v zVL0N@nN!cD6yc6)iF^B&GI-1w!d@##K?mm5e_VqGIyHY-K(g99pkpCm$k>nn%cU*J z;8|otg*6VmhQV{FtLW*eXy0`r0=)ZGL!5#1T!$36poSZ>M68?RU5{b@*Mn9!*Z<8l z$?bSYak=+Xm0Ya#K?a7T-!+86N>N+NHcpsDHCFE4qlY$?vBVX$)TRM29QT*f-Csj! z=Mw&ejYL1vrLrYP?hYk(#_Kq#Z{}P`_iIjhMp}1cH$!O;*Y3i_IaE`w@Hhd$ zs`tJf2<$(AY2ZKauUOzd=&pz{fKWfzaS%HAo*a1xSdw7i`6L(q6=qHsfAa&|fjnd%<1XwZuRYd3@A(!fdCH#M`wT7k=Kp5xu$N`aN0 z)$P8d(iVdMTl3s>FK)W?9QE>094COp;t;wxJDJ-~vj%blNcoLpBZ#gjA~03+ z13+YhSyLDTCVuX^BiDWThmPHo?eR!95Rj)h(c4=xHN4FT$`%2c6keJ)zlMg|bLP#H z%y&5oxe1U)r6lT8Prs#Hy;8Zf^U3xrgi|3rf5<-0wYmISni^~Xd)Z&Jit}eZ4X?a( zX&4=O?!xa^=_bSgOBg8u^T#tqIoCm!zLV|(v{ul26dbB&W6!0ucHrJfdNoamc4%t(K5?npCT({DQd!E4 z?*bM z>gl(R1eJ8YzkarNPsylOWYyGKumvt>lM(C`*_7-2*e0sp5XgbqiroI8zsP!bu}&1M zBPX@cY>nW+oOK{Qu~wY5&`El>X;Uk~`W! zJU6o461WBg@MH-NcFk#SOz^_XxY3>kiRb$VpLWoD#9fMW7IzQ3EBf-N#xLh>r(TAI zZ4;lqy7@}n*<*VmSWl6*?!GigA)d7T>EV3_d#5_8LVkQ{X!rhUa?bxnXBC5eaIkTz z9#i1rPoW2Y{zx}!`M{V&jHtz*qen05UJ(Xp4*(s19yCD*hF03OX?bj$St{D8v&@vs_D$FeC zRW4k*8Bikbc@u?VJ_9v%1_XrF)zt`;g`U^L5&V+n3Aj#J`{0UwIG+o2M#EUn9T z98xf%x)-w*yf)gYQn544u&@J;3eKnRvs1G14vsjwZUmSq*OBu2h zz?oD+Gaj!v8#^mQ+}+(*9D(DFApOy6^&PgG63t7)Ab^D+WoG)b= z56Wk6Q>eT~-kU*0al42Ss10`iIJ^yI?07VO#*j&7BC84{6xLEElEO5J`IB3SSIe@; zF;Po9P7o&}!^jtiof7s1z3NPRnz{?&e(cAt941Dk!LNV)eK$I-a;zNk-(q&MieZu?@J@4%73@*rrLt_aUi%1soHsjST+y8~gB0Sg`2P&iZm?#`Bu-X$N zG~ww$dxFFI+5OKej0T+OJn>5T z=&G9T7G(JX&4*t~#ah}s*EU{RI_Sq|A+PZ)CdL-**A`DGC@3KEbub+%C5ec(#=I|> z-L+7`Y1pbam-s$hK;y4-uoyy;NkDMSlRERllQ3N&a3?t8N;C8C@o`RuU${BI4KgnL zX*or^%sG6a6|{9eNCBwX2#3eA8`Jgoh`Q$1$Na!lOcpA(Z2rl_`7WQM-!F^LZBA$c zv>;Jtf_7VnKFCw}GG8IROhV)rh&rL)Ab4b0x#a(9Nx@b+LIa1ifReSJB8$EI7MJEo z;lw4(I!Wh|I6XNTtC9p#ZCWN&*jNPLcet>y5afC7_nWaqq*V^yYKfi8UtqC7$yfT& z{rPi`eBoxlW~A*d8WivI)Q}|{7&@hU2fYRc2JmE2K`6Z}N~HSSUuJjc;K9sCi&J3m zFcsvQ@4Jc)lxv|lM>cm>7cJhf9=-+{C*Dw2dkG!pk0ZvA2gX`Pjd;IXd}noSt*<1y z#6TH7dRqycI-{M8SIdt_8h$KV8sS>-H*XB5RcPS}Nurf_q)EVla zotgOhY^|lbc21$27Nym{SVUILVH8H~pBbnIav51!4S;f&@k~*oC-D>TPdO^}_Oj{J z&d@{6GQ6yzDn?*v&LOo^r~j5`D|~T`>Pw4@yAXamI5XD4yoLv>7po6|ANhnCPlorKnjqYf~mtRGR^P_Nz z>gGQ&f9U=b%){|nGdDdZ>+l^fL@nZ9_0to~YKn$T#rxyQSMH8NcKw>g&A7J}|A9j` zCNDg<%T=Q zoYq#*F!mT!EmbAlA@RN|M2E2m=0-Di6g=`D8@O`zTs5j*9b_ zJHDDgC*-FddnwlGt+(%?(r)hQ6kXf-F%4Tbp-J>Ip7FX0@)@Ur_!%i2eglS-jteLlX73u`_wVEBAlH%?yq~#3?6rLI8PyIEp#jG z{=5D9biVKEp6b#-HfcXsb=_z2%qJjpFALB?dR;s@9PKUC*FN*?I^&%(v6B4lFZ8C? zMV0v%w>9UVc=mhamhD-|r_W|Osn5`sF?3;fzs?DndEGyJ&2_Lf;){@ogvV6gO2z;K zbr01ougYJv0{RaeaOUSqW^h=Fu9ZihBJHrv%at^}5G3pnKo;8Y$){U4hZs+Sb0j8@ z?ap^MzX(1`OGW$P={TKBMBX z{o+Yw#qmZt!~L!O>izF(f?z|GYL>j{S&d^)$h*j;9w@ChvG&BnZ5bx^H0wyz2JGG9V+yiCxk)|s-o z9kW0dSlkE4cqwhG`|DvDRekB0a(4ELzk2fxZh*LWRN~6-NP%zZTi$+K777*wC15PMrU?CPOa1z|46zbpd{uF+21{70uzRMmK|`Zd5Q z=Y4M&{B%b*jTvdLML(Tfo*k?e^Q=c@MYu&UM{;lwQUSj$L@3FR;$lfj@5{-w<(D5U zXI_06aOU-MQHJbaJoJgQr73cqOg~2#C0rC6bxrTxx)oG6p=CFCa@lQW&*rH=5WJ|6 zk=?wsxAF0L*YRJ>{!!kOaj2_wr5l6;Wb|yBIo@UH*fd{PymxX#Mbq}W*WF=}-rh~| zh*Bg(q>?>=xTN$qG<=u!9$|GNukqTeHM)M8(YUNQd4Fc#jb=5aF;BJZIzR9BGt<}9 zGuBR8NnQ8h3X7I1yp=KKlkmHL@krUc^f^*aV-d$(LWNI7VDFo?)#X-(FRbJrh<`F?$!57YE6ZH8MiSmcJFqH5_uM%q4?gjC$8QvcJB4e3DUc6LYJ5K zCgC4=P2)UQj3s<&g?hTP-+kIyn`u%dyVv4R1^78>{eh2t zyHXB{y4Q*>(vdm8E}V)kl1TJQD8dtCZOxh~RpzaIHNAoU+V`8*LVO}xo^hMY!K|KY z&4{ft@_8tHBb1NTN3Z`(jP5JBt@=H^^78{fC6~#Ph6_>-;2A6RB&Gz{9)F>dm*a5H z%$^d-K+${qC8%1wXofhy z&kBimAmwF*v+{WPByP%=<(oH>dEB_Uu-i^LLy@syc-Q{e>?Rcx>F?bUSMEF&i1pwT zSx1xMIm)HGED!g#vgYy?Qf&W)sV~Y%_p7d!qe`l0_L=kW*xelE{`$4|#(=ZEyL1Kl za19U_tPxmC)DA=AM>tM$E^8~ahZIHdJYg0Zx!XCkCvI=x1GnFSn@DV|r%s7e3Hr%T z8|_`GMslIxk=Oh8?K`27jM8{w!tBLKm@uV(w*(TWY-3XBg#?_qQznGLZe$Nq#{ynW z+YZ*8{IXicl-%FsKGJvYpx=$SDtEVo+ETw#s^ynje;+?@S6pOuLX{@Uv^|TbQT*Rn zKuBoBpu@ANPBT;)=q?)eoi}b_%tYzVAs6NhUuT2fC>dw6bm*oeqXX|jf5g7NtS6-# zUkbI$aivNp895-`DRgzgT_2a6l~#{rN)-E!-i~FFxGKQKB^Pbk9H!{hIREwQ*NBO+ z;o*3x21>UPJAKO9FgLG|>4?l|L6B~cX`=}n;gPs?s|{Tc`U(f!WZECT zF}~0Q`6oN!5V3Ul$dL$zfQCLw0>X$ zF^g6DZ1oJ^n55e+G&cL1`Cs4oya>`_eaM^^ChjcSzH@r+*?|-fKNbb1#cm}WqHZhG zHM<;w(uJs~Zcb11-Md{+7TR6A4C_2o;9cBG_NbU6_s>C7b{#_)M=!a1d7L-ZY`*Td z64dq4&W68#_+GRkcJ4_cfLN|&siy6kKMAQ`d%JW$&|9hA%@y^St2q*NiK_hCB5M2D z@RG{CfhH9pQ^G>uNII_Ad@ZsM`zCHTFHU*CNnx)=F{eqgQ(BS>)erp^ucKe)o-(ZM zZtsIH=B3-c3s<*2zF5Si&Y@R#CDp9ohjcZMbOeSX=VNJkS<1A0+!$bW#Qr3sMoKf& zAWbr|npfuA|wVi)_6he%q;th>a`)G+Ql(kB#ZDX{r1P7CSTX_d5-D&*RG7bMRpQ zgon}a@TIRcjkue9YG;d{=22gCVe}9`XZHTk?%iQx{m_D?NqQz0nsny1XKj8ibe_C( z&f~w|PkbrD@qO~_SqGQS7W?U*o}Q0XB+TlGKF#Nlx3{Ni6WM7oYl-1%j^=RG5!n27 z>q6n54t1^X8f*{QA2Um4>N!s^z4EQ7136nC?TtemqoEVy3!{}%Zz#x0J{J3U?X+Wz zMz@r+z=CuA5g{L4g(hQsel=73wL^l$fiubGTSexI2KkS7Ub}AS1;yN+mx93nRD4cfNO+8xWcipNxaUz3=s~;pG z{Te5jRQXII=TDz5(W^$@4=qPqh><7qLH=MJkQo;+Q~ygo4w7xaylP1Mg8I7e1h`M- z6dj4hC^U;T^$`S-Wt%&*_oUUx@mjBJ(Q_A@TS7>XFDC`*ZP&u(3H zVlpZsV?6nSSs%PVt~u0=A6Y(D1pMLI)2HGO>rwRs1KP7^kNgp@lw9FOk>p0$XT=1R zP3Snxg0ppebr=d!EA??owUk*mvp2so$CSFwp`1$1r&UwLSv^7(n}@?+rFq^&T#VS_ zwKD5=qvd|VBxdwy`Uo8u3Gw)3G5Px{iK!&-Q0Y@Fo{@Dg^407Lo7TxGOg1Lgy8RfduH(cM+2t>jb9I9 z9?}&U^O4=bqO3==amW|9xRG8zfxWV;65!lxW77##Wg?+PB@6%nH+uiGxy@s8YqjbC-+ z3Lr&Pc9;sD#4I^`ap^PEbNUxV0M)-EOOlnuco``&vI-V#2O*;o=EH$M#*CTm7c6)_ zHyxYVJArpb1&M!Hwn3@95nyuO#=Sf&X0eJVt;WIbBKBEzDFbw`{9Xe80|bL%u*aRa z1SAAJCRkbnAnx%=u(ow6N)DsouC(`a2|V*TB1-m&3Pmv4_}q~wZ$G=Ni~m=9R~iWA z+J;{ur%k1zC@RxJ3X_m5rDU0EEOk)FmK55^HaWwLPANs!shok5;Eeq+Mmir}Yfpker_{Ras4 zbYH~}Rk8qby{8RljV$*Az&2Cps5jc;AnWdg=B zIhA(Va}yn^F+Mn<{oa+mk)e%Rc{PU9j{SNxGP1kvycD@#BLMm1wWkWNM^&Q%JQ8UO)-xPNDTTGDbu;R?V3c^r zyHdReO+nP`do2y^pE6RAni`9bKGC1{1Ad`;Q>49PP>lWPOVZg*Fn*}X;!UqZVIt{D zz`_0VWFr7#z(ptrN4xboP*3p@_9{{I*_8A$*AvR7^vH`X(zq0z;vkFtx?= z&5%vaX1-ptL-jbx}!X8FZ{_81+=8?QUqNN}GLMk}z|wg&>4f*j2S zWMq8!x^Dpf0r6ZoajJ%c4|tAk8FunWu4K0(AOYF11E|9bSbaBQvrq<*2Dj1L+8Pko zG>S#2ZE%W2MMd$xqXe-J>^t*VmK!LF&c*FPuPy`tR7?XR%mc-#G)Cu{+=$82gyH>M=DQpq#4P9k`QNo z#*HXOxJvxv%OlN5(v#{*M-%n`i%=Tee}7E4$#>47!nKd!0eERnWU(ARdf+y4tz^& z-SYGR);DEkE#xaIR*-jQKi`EXg*s!&^>v%W>Y(KVcu!J3=0b@VV6#?|Jc|_ zNJs~IeUXF#n_{&(lz0JM0)*zTD~vq+0^(8e-6H7;3k6grO&BxA=CiwCY<4LV05|%t zu9L4(786mET@BJbq*&-vUTq@UAFBcS;l;m*A+^-sG~Zo7<-)3n?<1hQ>G#;ppCT`x zN&VVR=#r5}i>|-^uJz~e?UwKd#77c}=&_RKC)||}NuB`y7W*$QxzfPk_ zv@9$!yBP27pu-{L3Y=s)uuwR8%-I4FK{}mB23OBP#@*2Jruh zp{PSckgHBnuB* z6okRkmi(596c@sC#8i0)hg`B-Btx#~<|n z=+4;Cv08KJ29_!W74lHJa2L@nvI++e9a;?KN0Z^c=x^~+S-_wJPc;g|lh`NP_cjS% zs74#oeH#lWa?PrZRgzS_K^X*DX3xNcyo^HBz>r!m zTn?*`J%q`9!Vmf0;ds~_HTK#_fAzO#@G@Ef3!=F%Zq}4gcnhE#i`?_<^y_Q(d(mas zl|<;_uRLcYSK`4D&~7hDu&jH2V)1F%A~X@AE~y4*Dn1D1jcxcIl$$Mx zcvg(&lEsf&F$TQun=%5s`>f99X8Uwc8xKYiNvt_6I`p-m_C9(sk*KMxx)x8*Da(T> zJ5d8fJPTV?LmIDokH92dPVj5GTO$PbAz>8}%u-MY0;CI?$!Th~YjUCL44v3{(i|-B zxPm#5KcnUAm-fRqS3jhVTwidv=h@nM10eMmpzkIw9V4S@_Iu*Oi6Ll!hSHBk$1IwS zjEu~)ekiM0AGjIH^F%i%@`nNaj!GZrA%e$b%(XXOlp-l9Nocp;6NlpAoUYG^FQCcz z3W$csR;(N7sKMZ@+$UO47vTj8e81K#=b3_}>a}?p7#L-wr7<4snJ{=4eJl0$n*uYD z`~5IN4qSpcwyHvQ;>435Bnm|o$X1(bdo}vJ1u|ujbcb5Z$4TKBDIx(Xm^FR+siiwM zklzdM0W*$eCp)1E1m7-tq4#ccJPG+gP-h_P&%3zy+qw@R#e5m4>|C}Qm%P%}UWomI z(eN040pTQw+sugqpon$s0Dp@%8EeWS-1muoNMrEPPvyxjdW4I6;Ij5@c%~5#^AS*d z>8wsZ*x7ut#Qh!XHXS^sPZF_l9AI<{pNVGq%q{E4^1}5oML>e$r8!5-$41X-(u?bp5pnuX+ zP*h|wYrWs6qJ{xE)tWZd;u~etz3P%)ja-q!IWH3pygSZGv;&<8=LcD~0x|au z-2mWHW`ZI=dZ}JT)}2kA0qpfYlQOwn>Z4bQ0W$mD(?0J5`<=-{xTR%G-C$QBB!!m) zU>hdP6g?W!Pl14lKAfPrKw`YP+2X2RnVid=Z4uf;)Z$eX(ryMb!!(1i7%mbvDcd)Q z1*Jc*kjn44q~}#p&{tfzG6ZR`P~jt)FDk+HVKN}LcSO`G#rT2SND!OyDFko+9Pqi4 zp0@d38}cyar}ff8ExHDfMo12BQwy=L=!aR3R46;8t*Wd0t74p!f`)@NC?1TAw6s7q zaR`tx@4lfM7H^4rp>HotsBLXGG-leu*|RL`1&ixi5N-#Ac433!pyt~kHo=A?JmkT_ zAbf@_G}JE6VSdqy{5ncPQiAHuAc9UYhH8%yWc`GVD+$yklwu&EnyRP>F(Bs$%PMem zzeiKyj^W2>c49)dJ_GHSS**Xds@-QiPS)F-B(>Qn1p5^sm5uTW05p5jy(`Cse#A|EYIByb+%^7kl_T0K%>tUzd6MmaO7bry$V7q-fQD& zghBnB;UAnaNgF#yznkouo|3b;e_Zy)qqxw`knk$R!t?u=$+3qJE^P1SrlqBIuf%~8 zX%5Hi{UxRf*>?G}15s(vlOP1h;A?^pb!F z^qLIkC5a~R%Ep%2rjbe&=2?Rj+X$LlVg}e4%)R^Rd+8~_LI9ZBJCjB#tQad3wD79Z z>HA=7kkj$6-G9FLN2SrEsZ(i2v;CTyn-wNc_C*H^>M!=d=Yf}znYUnZ+LHF85HlcU z3c%FfLyn4<=<^G9CSLz_zdp}j!WfA9KRqXJ0p)Vbbrr@D){^*I^TZxd{ShiT8)2*( zd4sCp!Le$UWP^Qns^|}`Z6L|AC7zng!{C797e*X7ID^(BSwGoSM%oYO%*fEaD$jhBE|P(5Lj$eU3fmZ1kM5}FQB9(NH1 zMD<7+qUYvZ5mJrmB_}Pw_B#KZ{j;iW`&u$kON8hhHf1r{IccyZu3u zJ)$SGjVLHZu}Z|5&&Z7u$m z6parrB0sZz=kQx#12c|`LUXQv5Uep^&bQ1yb1pI;U|l#b3Q4F|tH%9E_Y5X*q*y8{ z$*2%mv4$_wPsgLHyJeHBd#Som#OjLHKni=cy;$B;+}q zML(3Q(~TPHQiOMzJ5?%YEfW6xibw(rzttyQY-)tc5e@L!Uz}tGZD`Lav+E(aHXF>h zu%zP6miG)rZM1O4bfy;n+3r+wkgltUfUazy#FUg|Xk(`UhnW?&SvEEL)T{ zT{EQ@c_K42GyBWd&YeX04X>nQQBf0QWoz$v99y&3!#*G=Gr;g*?U36az6ciY0waW< zyBFI;Y>I@XfJb*c{}YL$2%2fu;O+~}c`ND=(%R7nkO7>R&xk|L8?V_-Lnm zTf&wxqkWqEWwYs$>;vX67xc=<#>Qe!k#J;GrKO?uNr^m?C4jr(tn$l8I7OJHh2PFo%~#ySO> zOEYJzeiyYgEsoLooekJ??{KQX7t69gYwe2K!UwSkKdgAlA-xSp0S!F|xgl^Vu^Aoy z6{jZLnQGK#;l!UQAE>3SUXpVm$sy{4r_$=8_a@!LxZUvZB%t TE<(i;MOm6{SaZ|V^}yc%ee@~> literal 0 HcmV?d00001 diff --git a/public/images/features/agent_channels/org-app-registration-dark.jpg b/public/images/features/agent_channels/org-app-registration-dark.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6be76243d2d6daaa79858128f58682b393bde1a7 GIT binary patch literal 13489 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 literal 0 HcmV?d00001 diff --git a/public/images/features/agent_channels/org-app-registration-light.jpg b/public/images/features/agent_channels/org-app-registration-light.jpg new file mode 100644 index 0000000000000000000000000000000000000000..dc0f40266d1760c552ee99a03e04b1c5264b8bdc GIT binary patch literal 14725 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 XIgewKeoU<)=+4l$fxJt=_UQituXvi* literal 0 HcmV?d00001 diff --git a/public/images/features/agent_channels/org-assignment-dark.jpg b/public/images/features/agent_channels/org-assignment-dark.jpg new file mode 100644 index 0000000000000000000000000000000000000000..480778278022c19c5896ec3af7d4a6b45c168317 GIT binary patch literal 15776 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 VG<{rEy~CME7pD`hqI5O!{{T|UVov}7 literal 0 HcmV?d00001 From 65e171e636e6aa029d2c28cfff10ead784b33968 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 12:30:45 -0800 Subject: [PATCH 32/38] docs: label channel and background response guides as beta --- content/docs/configuration/channel_gateway.mdx | 2 +- content/docs/configuration/channel_gateway_reference.mdx | 6 +++++- content/docs/features/agent_channels.mdx | 2 +- content/docs/features/background_responses.mdx | 2 +- 4 files changed, 8 insertions(+), 4 deletions(-) diff --git a/content/docs/configuration/channel_gateway.mdx b/content/docs/configuration/channel_gateway.mdx index 8c8a780ff..faf09a40c 100644 --- a/content/docs/configuration/channel_gateway.mdx +++ b/content/docs/configuration/channel_gateway.mdx @@ -1,5 +1,5 @@ --- -title: Slack Channel Gateway +title: Slack Channel Gateway (Beta) description: Deploy the Slack gateway for organization workspaces or a manually configured connection. icon: MessagesSquare --- diff --git a/content/docs/configuration/channel_gateway_reference.mdx b/content/docs/configuration/channel_gateway_reference.mdx index 6a90fb1c0..16d01cdd8 100644 --- a/content/docs/configuration/channel_gateway_reference.mdx +++ b/content/docs/configuration/channel_gateway_reference.mdx @@ -1,9 +1,13 @@ --- -title: Channel Gateway Reference +title: Channel Gateway Reference (Beta) description: Rich-message formatting, service routes, and delivery recovery for gateway operators and integrators. icon: Network --- + +Agent Channels and the gateway protocol are beta. Use a matching LibreChat and gateway release. + + This reference describes rich-message formatting and the private API used by the [Slack channel gateway](/docs/configuration/channel_gateway). For app setup and everyday use, see [Agent Channels](/docs/features/agent_channels). ## Rich Agent messages diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 043418e36..f4f128b29 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -1,5 +1,5 @@ --- -title: Agent Channels +title: Agent Channels (Beta) description: Connect an agent to Slack, link your account, and use your tools from a channel or direct message. icon: MessagesSquare --- diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index 535cff71c..98dd89724 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -1,5 +1,5 @@ --- -title: Background Agent Responses +title: Background Agent Responses (Beta) description: Run durable Agent Responses, review pending actions, and stop an owned execution icon: Workflow --- From 88b145c978e14b81a68aaa539457c3cdbc0c3f75 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 12:31:54 -0800 Subject: [PATCH 33/38] docs: register background response and channel icons --- lib/icons.tsx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/lib/icons.tsx b/lib/icons.tsx index 1cb2770f0..22dc473ee 100644 --- a/lib/icons.tsx +++ b/lib/icons.tsx @@ -70,9 +70,11 @@ import { FileCode, Plug, MessageSquareText, + MessagesSquare, PanelLeft, CalendarClock, Waves, + Workflow, Braces, Bot, Wrench, @@ -171,9 +173,11 @@ const icons: Record = { FileCode: , Plug: , MessageSquareText: , + MessagesSquare: , PanelLeft: , CalendarClock: , Waves: , + Workflow: , Braces: , Bot: , Wrench: , From 6b5d5107c92333d85b92362054d391a5d56a2adc Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 12:36:29 -0800 Subject: [PATCH 34/38] docs: remove unverified background response beta designation --- content/docs/features/background_responses.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index 98dd89724..cb9079d2d 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -1,11 +1,11 @@ --- -title: Background Agent Responses (Beta) +title: Background Agent Responses description: Run durable Agent Responses, review pending actions, and stop an owned execution icon: Workflow --- - -Background execution is a beta feature and is disabled by default. Use a LibreChat version that supports background Responses before enabling it. + +Background execution is disabled by default. Use a LibreChat version that supports background Responses before enabling it. Background Responses use the existing [Agents API](/docs/features/agents_api), not a separate model execution engine. A request returns a stored response identity while a worker executes the Agent. Clients poll that identity for output, required actions, and the canonical terminal result. From fb4b5fa44c80befa031c6b7d7441bbf3748489d1 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 13:03:59 -0800 Subject: [PATCH 35/38] docs: clarify gateway limits and compatibility guidance --- content/docs/configuration/channel_gateway_reference.mdx | 4 ++-- .../configuration/librechat_yaml/object_structure/agents.mdx | 2 +- content/docs/features/agent_channels.mdx | 2 +- content/docs/features/background_responses.mdx | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/docs/configuration/channel_gateway_reference.mdx b/content/docs/configuration/channel_gateway_reference.mdx index 16d01cdd8..649b9371f 100644 --- a/content/docs/configuration/channel_gateway_reference.mdx +++ b/content/docs/configuration/channel_gateway_reference.mdx @@ -56,7 +56,7 @@ Latency fell from 20 ms to 17 ms. Charts support `line`, `bar` and `area` with `axis_config: {categories, x_label?, y_label?}` and `series: [{name, data: [{label, value}]}]`. Categories have 1–20 distinct labels; each series must have exactly one point per category. Series names are distinct; at most 12 series are allowed. Names and labels are at most 20 characters, axis titles 50. Values must be finite; negative values are supported. Pie charts instead use `chart: {type: "pie", segments: [{label, value}]}` with 1–12 distinct labels and positive finite values. -A document has at most 40 components and the final answer must fit the 128,000-byte presentation parsing boundary. Malformed, incomplete, quoted, ambiguous or unrecognized documents stay on the ordinary text path. The gateway isolates components into messages, counts nested blocks, enforces two charts and 20,000 table characters per message, and preserves every value and link in generated text. Components which exceed Slack's nested block or serialized payload limits become text. The server's existing `maxDeliveryParts` policy still applies, with an explicit shortening notice when needed. +A document has at most 40 top-level components and the final answer must fit the 128,000-byte presentation parsing boundary. Malformed, incomplete, quoted, ambiguous or unrecognized documents stay on the ordinary text path. The gateway isolates components into messages, counts nested blocks, enforces two charts and 20,000 table characters per message, and preserves every value and link in generated text. Components which exceed Slack's nested block or serialized payload limits become text. The server's existing `maxDeliveryParts` policy still applies, with an explicit shortening notice when needed. The gateway freezes versioned blocks and text together before posting. Retries replay that plan. A definitive Slack `invalid_blocks` or `invalid_attachments` rejection permits a text-only retry; ambiguous network outcomes retain the existing reconciliation behavior. Clients that cannot render layouts receive the generated stable fallback blocks. @@ -91,7 +91,7 @@ Service requests use `Authorization: Bearer ` and the exa Run-relative paths in the table are beneath `/service/{channelId}/runs`. Lease mutations carry the exact server-issued `{ runId, owner, epoch }` fence. Treat stale leases, changed authority, and ambiguous delivery outcomes as protocol states to reconcile, not permission to mint a new run or blindly resend a Slack message. -A gateway can yield a Responses-bound polling turn only after its progress writes and renewal loop have drained. The backend invalidates that polling fence and enforces a one-second reclaim cooldown; the next claim increments the epoch. This does not release the actor lane, cancel the provider, change the Response, or erase delivery evidence. Inflight or unknown remote writes cannot yield. If a host does not support yield or the request is uncertain, retain ordinary lease-expiry recovery instead of starting a new execution. +A gateway can yield a Responses-bound polling turn only after its progress writes and renewal loop have drained. The backend invalidates that polling fence and enforces a reclaim cooldown (one second by default); the next claim increments the epoch. This does not release the actor lane, cancel the provider, change the Response, or erase delivery evidence. Inflight or unknown remote writes cannot yield. If a host does not support yield or the request is uncertain, retain ordinary lease-expiry recovery instead of starting a new execution. Execution preparation returns an `apiKey`, `requestKey`, optional retained `responseId`, and a Responses `request` with the Agent ID, admitted input, `background: true`, `store: true`, and any authorized continuation. Submit that request to `/api/agents/v1/responses` using the bound key and `Idempotency-Key: `, then bind the returned response ID. Do not substitute a creator's unrestricted key, change the actor/Agent, or send the input to a channel bookkeeping route to execute it. diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 6e9ee765e..9cdea3b5f 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -1507,7 +1507,7 @@ Configures the opt-in [Agent Channels integration](/docs/features/agent_channels | --- | --- | --- | | `enabled` | `false` | Enable channel setup and service routes | | `transport` | `socket_mode` | Select `socket_mode` or `webhook` ingress; manual connections generate a matching manifest and the gateway runs separately | -| `gatewayUrl` | Omitted | Required HTTPS base URL for generating webhook callback URLs; not needed for Socket Mode | +| `gatewayUrl` | Omitted | Required HTTPS base URL for manual webhook manifests; organization workspaces default to `DOMAIN_SERVER` when omitted. Not needed for Socket Mode | | `nativeSessions` | `false` | Enable optional Slack native Agent status emission after app setup | | `lifecycleReactions` | `false` | Add optional processing/completion reactions | | `signatureToleranceSeconds` | `300` | Webhook signature timestamp window; integer from 1 to 300 seconds | diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index f4f128b29..56ddc3821 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -34,7 +34,7 @@ A Slack app provides the bot's identity; installing it grants access to a worksp -**Create the app in Slack.** Open [Your Apps](https://api.slack.com/apps) and create an app from scratch, or use one your organization controls. In **Pick features**, continue without scopes or events, then select **Create → Create Anyway**. Do not install it yet. +**Create the app in Slack.** Open [Your Apps](https://api.slack.com/apps) and create an app from scratch, or use one your organization controls. If Slack shows the **Pick features** wizard, continue without scopes or events, then select **Create → Create Anyway**. Do not install it yet. diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index cb9079d2d..6e8d33a23 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -54,7 +54,7 @@ curl https://chat.example.com/api/agents/v1/responses/RESPONSE_ID \ Poll the same response until its public status is `completed`, `failed`, `incomplete`, or `cancelled`. `queued` and `in_progress` are not terminal. The server rechecks the original source key and current authority; possession of a response ID is not permission to read or resume it. Use the returned response ID as `previous_response_id` for a subsequent supported continuation rather than resending the original user input. -A background answer becomes terminal only after the provider has drained and its conversation history is committed with the response. A temporary storage outage keeps the selected outcome pending for recovery without running the provider again. During a rolling upgrade or rollback, keep a compatible worker available to finish pending results; an older worker cannot complete the newer history-bearing receipt format. +A background answer becomes terminal only after the provider has drained and its conversation history is committed with the response. A temporary storage outage keeps the selected outcome pending for recovery without running the provider again. During a rolling upgrade or rollback, keep a compatible worker available to finish pending results. Ordinary synchronous and streaming requests have a different storage contract: if optional saving fails, the generated answer can still succeed with `store: false`. Check that returned value before relying on retrieval or continuation. From 1e152308b855c38ab6ee78b12bfc47701c5a9e37 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 13:24:44 -0800 Subject: [PATCH 36/38] docs: make channel and response guides easier to follow --- .../docs/configuration/channel_gateway.mdx | 103 +++++++++--- .../channel_gateway_reference.mdx | 29 +++- content/docs/features/agent_channels.mdx | 147 +++++++++++++++--- .../docs/features/background_responses.mdx | 94 +++++++++-- 4 files changed, 309 insertions(+), 64 deletions(-) diff --git a/content/docs/configuration/channel_gateway.mdx b/content/docs/configuration/channel_gateway.mdx index faf09a40c..df827a8c3 100644 --- a/content/docs/configuration/channel_gateway.mdx +++ b/content/docs/configuration/channel_gateway.mdx @@ -4,7 +4,14 @@ description: Deploy the Slack gateway for organization workspaces or a manually icon: MessagesSquare --- -The Slack gateway connects LibreChat to Slack. It runs separately from the application. This page covers deployment; [Agent Channels](/docs/features/agent_channels) covers connecting apps, assigning agents, and using them in Slack. +Run the Slack gateway alongside LibreChat to connect agents to Slack. This guide covers deployment. Once the gateway is ready, follow [Agent Channels](/docs/features/agent_channels) to connect a Slack app, assign an agent, and link your account. + +Choose a setup path: + +- **Organization workspaces:** [run one shared gateway](#organization-workspaces), then manage Slack apps in LibreChat. +- **Manual connection:** [bind a gateway to one connection](#run-the-slack-gateway). + +Using Helm? Go to [Kubernetes and Helm](#kubernetes-and-helm). Building from source? See [From source](#from-source). Use matching LibreChat and gateway releases that include Channels. Ordinary LibreChat does not need the gateway; enabling Channels requires a transaction-capable database and the indexes described below. @@ -12,21 +19,27 @@ Use matching LibreChat and gateway releases that include Channels. Ordinary Libr ## Configuration and prerequisites -Choose [organization workspaces](#organization-workspaces) for Slack apps managed in LibreChat. Use a [manual connection](#run-the-slack-gateway) when you need a gateway bound to one app and connection. Shared mode serves multiple installations; it does not share users' accounts or tool credentials. - -Both modes need: +Both setup paths need the following. In shared mode, one gateway serves multiple installations while each person keeps their own account and tool credentials: - A verified transaction-capable database with the indexes below. - Role permissions to use Agents and query them through Remote Agents (API) for participants, plus Agent sharing or administrator management access for setup. Sharing does not require permission to edit the Agent. - API-key authentication enabled for the gateway's bound execution credential. -- A private `CHANNEL_SERVICE_TOKEN`, identical in the API and gateway. Keep it server-side; it is neither a browser token nor a general Agent API key. +- A private `CHANNEL_SERVICE_TOKEN` with the same value in the API and gateway. Keep it server-side. It authenticates the gateway, and cannot be used as a browser token or general Agent API key. - A trusted `DOMAIN_CLIENT` for account-link and owner-review URLs. Organization workspaces also require the public HTTPS addresses described below. Linking an account does not grant Agent access, new tools or offline access to connected services. See the [channel configuration reference](/docs/configuration/librechat_yaml/object_structure/agents#channels) for policy limits and defaults. ### Database requirement -Durable Channels and stored background Responses require MongoDB transactions. Use a MongoDB replica set or another verified transaction-capable deployment. Standalone MongoDB and FerretDB 2.7 can run ordinary LibreChat, but cannot enable this durable feature. Unsupported channel writes return `transactions_unavailable`; the Agent builder explains the setup requirement. Transactional reads use the primary even when the connection normally prefers secondary reads. The database must also support the required indexes, including partial indexes; transaction support by itself is not sufficient. [Amazon DocumentDB 4.0 lacks partial-index support](https://docs.aws.amazon.com/documentdb/latest/devguide/indexes-single-field.html) and cannot run this gateway. Other MongoDB-compatible engines need their own compatibility validation. +Check your database before enabling Channels. Durable Channels and stored background Responses need both **transactions** and the required indexes, including **partial indexes**. + +| Database | What this means for setup | +| --- | --- | +| MongoDB replica set or another verified transaction-capable deployment | Check that the required indexes are supported too. | +| Standalone MongoDB or FerretDB 2.7 | Can run LibreChat without this durable feature. A different database setup is needed for Channels and stored background Responses. | +| Amazon DocumentDB 4.0 | [Partial indexes are not supported](https://docs.aws.amazon.com/documentdb/latest/devguide/indexes-single-field.html), so it cannot run this gateway. | + +Other MongoDB-compatible engines need compatibility validation before use. Unsupported channel writes return `transactions_unavailable`, and the Agent Builder explains the setup requirement. Transactional reads use the primary even when your connection normally prefers secondary reads. ## Organization workspaces @@ -34,11 +47,31 @@ Use this mode for organization-owned Slack apps managed in LibreChat. An operato ### One-time operator setup -1. Meet the [prerequisites](#configuration-and-prerequisites), including transaction-capable MongoDB and a private service token. Generate a token with `openssl rand -hex 32`. -2. Configure public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT`, replacing the localhost defaults in `.env`. Both are required and must have no surrounding whitespace. Include the application base path when present. If callbacks use a separate public origin, set `SLACK_GATEWAY_URL` to it. Otherwise callbacks use `DOMAIN_SERVER`; route the Slack paths on that origin to the gateway. The shared deployment opt-in rejects local addresses. -3. Route `/slack/events/` and `/slack/interactions/`, including their organization/app suffixes, to the gateway. Its container listens on port 8080; the shared Compose overlay publishes it at `127.0.0.1:3081` for a host-level HTTPS proxy. Route the application and OAuth callback to LibreChat. Keep gateway health and metrics private. The deployment operator does not need Slack dashboard access or app credentials. + + + +**Prepare the database and service token.** Meet the [prerequisites](#configuration-and-prerequisites), including transaction-capable MongoDB. Generate a private service token with `openssl rand -hex 32` and use the same value in the API and gateway. + + + + +**Set the public addresses.** Configure public HTTPS `DOMAIN_SERVER` and `DOMAIN_CLIENT` in `.env`, replacing the localhost defaults. Both are required. Include the application base path when present and remove any surrounding whitespace. + +If callbacks use a separate public origin, set `SLACK_GATEWAY_URL` to it. Otherwise callbacks use `DOMAIN_SERVER`. The shared deployment opt-in rejects local addresses. + + + + +**Route Slack callbacks to the gateway.** Forward `/slack/events/` and `/slack/interactions/`, including their organization/app suffixes. If callbacks use `DOMAIN_SERVER`, route those paths on the application origin to the gateway too. + +The gateway container listens on port 8080. The shared Compose overlay publishes it at `127.0.0.1:3081` for a host-level HTTPS proxy. + +Route the application and OAuth callback to LibreChat. Keep gateway health and metrics private. This deployment step does not need Slack dashboard access or app credentials. -For Docker Compose with a separate gateway origin, use the normal uncommitted `.env`: + + + +For Docker Compose with a separate gateway origin, add these values to your `.env` file. Keep the file out of version control: ```dotenv filename=".env" SLACK_GATEWAY_URL=https://slack.example.com @@ -48,7 +81,11 @@ DOMAIN_CLIENT=https://chat.example.com LIBRECHAT_IMAGE_TAG= ``` -From a fresh LibreChat setup with `.env` and `librechat.yaml` prepared, start the release-matched application and shared gateway: + +The command below includes the replica overlay for a fresh local database. Read [Existing local data](#existing-local-data) before converting an existing installation. For a verified external database, omit that overlay and supply your normal connection configuration. + + +With `.env` and `librechat.yaml` prepared, start the release-matched application and shared gateway: ```sh docker compose -f docker-compose.yml -f docker-compose.channels.yml \ @@ -56,13 +93,15 @@ docker compose -f docker-compose.yml -f docker-compose.channels.yml \ --profile channels up -d api meilisearch channel-gateway ``` -The replica overlay is for a **fresh local database**; read [Existing local data](#existing-local-data) before converting an existing installation. Omit that overlay when you already use a verified transaction-capable external database and supply its normal connection configuration. Use the same Compose project and files for subsequent commands. This does not configure a public reverse proxy or a trusted certificate. A host-level proxy forwards the two Slack paths to `http://127.0.0.1:3081`, preserving the organization/app suffixes. Set `CHANNEL_GATEWAY_PORT` in `.env` to change that loopback port. A proxy in the same Compose network can instead forward to `http://channel-gateway:8080`. +Use the same Compose project and files for subsequent commands. + +You still need to configure your HTTPS proxy and trusted certificate. A host-level proxy forwards the two Slack paths to `http://127.0.0.1:3081`, preserving the organization/app suffixes. Set `CHANNEL_GATEWAY_PORT` in `.env` to change that loopback port. A proxy in the same Compose network can forward to `http://channel-gateway:8080` instead. The shared overlay supplies `SLACK_WORKSPACES_ENABLED=true`, which enables webhook Channels, shared app installation and stored background Responses while retaining unrelated YAML policy, limits and explicit API authentication settings. Slack app credentials are entered by organization admins through the UI and stored encrypted; they are not deployment environment variables or YAML fields. With the flag unset or false, YAML continues to control the feature. Choosing shared setup changes the deployment's channel transport to webhook; existing bound connections must use matching webhook configuration. Manual Socket Mode remains available when using the manual setup instead. No `CHANNEL_ID`, `CHANNEL_TENANT_ID` or app-level `SLACK_APP_TOKEN` is needed in shared mode. The gateway receives its service token and private runtime policy; app client credentials stay in LibreChat, and installed bot tokens are encrypted in the database. For an unreleased source checkout, add `docker-compose.channels-build.yml` after `docker-compose.channels.yml` on every command and use `up -d --build` instead of expecting an unpublished release image. -After startup, [verify the gateway](#verify-the-gateway), then return to [app registration](/docs/features/agent_channels#organization-workspaces). +Before connecting Slack, [check gateway readiness](#verify-the-gateway). Then continue with [app registration](/docs/features/agent_channels#organization-workspaces). ## Run the Slack gateway @@ -153,7 +192,9 @@ For a **fresh local database**, run these commands from the LibreChat repository -f docker-compose.mongo-replica.yml --profile channels logs --tail=100 api mongodb-init channel-gateway ``` -`mongodb-init` exiting with status 0 is expected. The application and gateway should be running and healthy. A successful Slack credential activation does not prove the gateway is connected: check health and perform a real mention. Missing service/app bindings prevent gateway startup. +`mongodb-init` exiting with status 0 is expected. Check that the application and gateway are running and healthy. Missing service/app bindings prevent gateway startup. + +Activation checks your Slack credentials. Check gateway readiness too, then [link your account](/docs/features/agent_channels#account-linking) and send the bot a new request to test the connection. The overlay points `LIBRECHAT_INTERNAL_URL` at `http://api:${PORT:-3080}` on the Compose network. The gateway listens on container port `8080`, with no published host ports. Socket Mode needs no inbound port; webhooks need an HTTPS reverse proxy forwarding the required callback paths to `channel-gateway:8080`. The gateway runs as a non-root user with a read-only filesystem and dropped capabilities. @@ -196,9 +237,19 @@ A single local replica member enables transactions but does not provide high ava ## Verify the gateway -The process exposes `/livez` for HTTP-process liveness, `/readyz` and `/healthz` for startup/transport readiness, and `/metrics` for Prometheus metrics. Keep these routes private. Inspect the gateway's readiness and logs using the same deployment configuration you started it with. For shared Compose, include `docker-compose.slack-workspaces.yml` and any database/build overlays on those commands too. +Check readiness before moving on to Slack setup. The gateway exposes these internal endpoints: + +| Endpoint | What it checks | +| --- | --- | +| `/livez` | The HTTP process is alive. | +| `/readyz`, `/healthz` | Startup and transport readiness. | +| `/metrics` | Prometheus metrics. | + +Keep these routes private. Use the same deployment configuration for readiness checks and logs that you used to start the gateway. For shared Compose, include `docker-compose.slack-workspaces.yml` and any database/build overlays too. -An ingress-mode or Socket app-binding mismatch makes the gateway unready. Restart gateway replicas after changing ingress mode or Socket app identity. Credential activation confirms Slack credentials; it does not prove the gateway is connected. Finish with [account linking and a fresh Slack request](/docs/features/agent_channels#account-linking). +If the ingress mode or Socket app binding does not match, the gateway reports unready. Restart gateway replicas after changing the ingress mode or Socket app identity. + +Activation checks your Slack credentials. To test the complete connection, [link your account](/docs/features/agent_channels#account-linking), then send the bot a new request. If gateway requests to LibreChat return `401`, check that both processes use the same `CHANNEL_SERVICE_TOKEN` and that `LIBRECHAT_INTERNAL_URL` reaches the intended instance. This is separate from Slack callback signature verification. @@ -206,11 +257,13 @@ To stop the optional gateway, use the same Compose project and file list with `s ### Native Agent UI and final replies -By default, a stable working message provides Stop and, when needed, Review controls. Answers are posted after generation, rather than repeatedly replacing a growing reply. Formatting includes code, tables, links, file attachments, and qualified cost/time details; unavailable costs are not estimated. +By default, Slack shows a working message with **Stop** and, when needed, **Review** controls while the agent runs. The final answer is posted after generation. + +Replies can include code, tables, links, file attachments, and time and cost details when available. Missing costs are not estimated. To opt into Slack's native Agent sessions, enable Agent mode in the Slack app, add the `assistant:write` bot scope, and verify that `agent_session_stopped` is subscribed. Add that event if missing; the generated manual manifest already includes it, while the [basic organization setup](/docs/features/agent_channels#register-an-organizations-slack-app) does not. Reinstall the app, then set `endpoints.agents.channels.nativeSessions: true` in `librechat.yaml`. Without the required permissions or Stop subscription, the gateway falls back to durable progress controls. See [Slack Agent sessions](https://docs.slack.dev/ai/agent-sessions/) for app configuration. -Native sessions show processing or waiting-for-input status and return to active when the canonical run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already listed in the basic bot scopes. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. +Native sessions show processing or waiting-for-input status and return to active when the run finishes. Completed answers can include Helpful/Not helpful controls. Optional lifecycle reactions use `endpoints.agents.channels.lifecycleReactions: true`, are separate from native sessions and require the reaction permissions already listed in the basic bot scopes. Neither an acknowledgement nor a reaction proves a tool completed; Stop requests cancellation of the sender's authorized work, not another participant's run. ## Kubernetes and Helm @@ -259,7 +312,15 @@ channelGateway: existingSecretName: librechat-credentials-env ``` -For branding, `channelGateway.appTitle` defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly when the API obtains `APP_TITLE` through a Secret or `global.librechat.env`, or choose a shorter gateway title if the application name is not compatible. Gateway titles must be nonempty after trimming, at most 40 UTF-16 characters, and contain no `<`, `>`, `|` or control characters. Helm rejects incompatible inherited titles before deployment; the application can keep its existing longer name. +To set the name used in gateway messages, configure `channelGateway.appTitle`. It defaults to `librechat.configEnv.APP_TITLE`, then `LibreChat`. Set it explicitly if the API obtains `APP_TITLE` through a Secret or `global.librechat.env`. + +The gateway title must: + +- Be nonempty after trimming. +- Have at most 40 UTF-16 characters. +- Contain no `<`, `>`, `|` or control characters. + +If the application name does not fit, choose a shorter gateway title. Helm rejects incompatible inherited titles before deployment; the application can keep its existing longer name. For manual Socket Mode, the existing Secret must contain `CHANNEL_SERVICE_TOKEN` matching LibreChat's server configuration and `SLACK_APP_TOKEN` for the matching app. By default, the application's existing Secret supplies the same service token to LibreChat. The gateway references only these individual keys, not all provider/database credentials. If you choose a separate gateway Secret, keep its service token identical to the API's. Rotate through your normal secret-management process and restart the API and gateway after rotation; changing an existing Secret does not automatically restart pods. @@ -287,7 +348,9 @@ The chart does not install an ingress controller or issue a TLS certificate. Con By default, the gateway runs without an automatically mounted Kubernetes API token, as a non-root user with a read-only filesystem and dropped capabilities. The chart's global pod/container security contexts are honored for platform-specific overrides. Gateway version labels follow its selected image tag. `/livez` drives liveness and `/readyz` drives readiness. Startup before the API or channel is available fails closed; Kubernetes retries the process, and it becomes ready after validating the shared app policy or its bound active connection and transport. -After applying the values through your normal Helm upgrade, check the gateway Deployment, pod events, logs and readiness. Missing Secret keys block pod startup; incorrect credentials or channel bindings prevent readiness. Finish with a real Slack mention and account linking rather than treating a successful Helm release as proof of integration. +After the Helm upgrade, check the gateway Deployment, pod events, logs and readiness. Missing Secret keys block pod startup; incorrect credentials or channel bindings prevent readiness. + +Once it is ready, connect the Slack app, assign an agent, and [link your account](/docs/features/agent_channels#account-linking). Send the bot a new request to test the complete setup. ## Next steps diff --git a/content/docs/configuration/channel_gateway_reference.mdx b/content/docs/configuration/channel_gateway_reference.mdx index 649b9371f..998ead015 100644 --- a/content/docs/configuration/channel_gateway_reference.mdx +++ b/content/docs/configuration/channel_gateway_reference.mdx @@ -8,7 +8,20 @@ icon: Network Agent Channels and the gateway protocol are beta. Use a matching LibreChat and gateway release. -This reference describes rich-message formatting and the private API used by the [Slack channel gateway](/docs/configuration/channel_gateway). For app setup and everyday use, see [Agent Channels](/docs/features/agent_channels). +Use this reference when building a gateway integration or investigating delivery behavior. It covers rich-message formatting and the private API used by the [Slack channel gateway](/docs/configuration/channel_gateway). + +For app setup and everyday use, start with [Agent Channels](/docs/features/agent_channels). + +## Terms used in this reference + +| Term | Meaning | +| --- | --- | +| Response | The agent execution and result tracked by the Responses API. | +| Run | The channel's record of a request, its execution and its delivery. | +| Actor | The Slack participant making the request. Their linked account determines their access. | +| Lease | A worker's time-limited claim on a run. | +| Fence | The `{ runId, owner, epoch }` values used to reject writes from a stale worker. | +| Delivery receipt | The record of an external write attempt and its outcome. | ## Rich Agent messages @@ -99,7 +112,11 @@ The gateway owns Slack event verification, retry/deduplication, native message f ## Delivery recovery -The gateway preserves each frozen delivery operation and its receipt. A required operation whose provider result is unknown holds its actor lane: retrying blindly could post the same answer twice. Stopping a worker or requesting cancellation does not prove whether Slack accepted an earlier request. +Slack can accept a reply even if the network connection drops before the gateway receives confirmation. Posting it again could duplicate the answer. + +The gateway saves each delivery operation and its receipt. If a required operation's result is unknown, it keeps that actor's execution lane held until the outcome is reconciled. Stopping the worker or requesting cancellation does not tell you whether Slack accepted the earlier request. + +Check what reached Slack before attempting recovery. ### Reconcile a verified provider result @@ -124,7 +141,9 @@ For a delivery operation, `POST /delivery/reconcile`: } ``` -Replace every illustrative value with the actual current fence and retained attempt count; do not assume the example epoch is current. Supply `externalFileId` for a verified file operation as required by its frozen operation and checkpoint. Existing provider identities are immutable; reconciliation cannot replace them with a different message or file. +Replace the example values with the run's current fence and saved attempt count. In particular, do not copy the example epoch unchanged. For a verified file operation, supply `externalFileId` as required by the saved operation and checkpoint. + +Reconciliation confirms an existing message or file. It cannot replace that provider identity with a different one. For a progress update, `POST /progress/reconcile` with the current `fence`, the retained progress `revision`, and a `receipt` containing `outcome: "confirmed"`, the retained `attempts` and verified `externalMessageKey`. The message identity remains fixed across progress revisions. @@ -156,4 +175,6 @@ Disabling a channel or changing its credential mode retires old authority; it do With the process-local job store, restarting the API while a tool approval is pending makes the review unavailable. The request stays held for reconciliation and a stale approval does not execute the tool. Durable checkpoint storage alone does not recreate the missing live execution state. Completed history and subsequent thread continuation survive restart. -The gateway package is built from the LibreChat source tree; it is not published as an npm package. This integration does not promise arbitrary chat-platform support or restart-survival of an in-memory OAuth waiter. A restart can require a new browser sign-in; uncertain continuation must not be reported as completed or retried as new work. +Build the gateway package from the LibreChat source tree; it is not published as an npm package. The gateway is for Slack. + +A request waiting for sign-in may not resume after a server restart. A new browser sign-in may be needed, and signing in does not prove that the original request resumed. Check the original request and any external results. If the outcome is still uncertain, do not report completion or retry the work as a new request. diff --git a/content/docs/features/agent_channels.mdx b/content/docs/features/agent_channels.mdx index 56ddc3821..70ceec2f5 100644 --- a/content/docs/features/agent_channels.mdx +++ b/content/docs/features/agent_channels.mdx @@ -4,10 +4,14 @@ description: Connect an agent to Slack, link your account, and use your tools fr icon: MessagesSquare --- -Agent Channels let you talk to a LibreChat [agent](/docs/features/agents) from Slack, in a channel or direct message. Each person links their own LibreChat account and uses their own permissions, tool connections, and approvals. +Talk to a LibreChat [agent](/docs/features/agents) from Slack, ask follow-up questions in a thread, and use its tools with your own account. + +- **Already connected an agent?** [Link your account](#account-linking). +- **Connecting an agent to Slack?** Start with [Slack setup](#organization-workspaces). +- **Setting up the gateway?** Follow the [deployment guide](/docs/configuration/channel_gateway). -An operator must [deploy the Slack gateway](/docs/configuration/channel_gateway) and its database prerequisites first. Installing a Slack app alone does not make an agent available. +Agent Channels requires a separate [Slack gateway](/docs/configuration/channel_gateway) and a transaction-capable database. An administrator needs to set these up before you can connect an agent. ## Before you start @@ -21,8 +25,6 @@ Follow the steps for your role: | Agent manager | [Assign an agent](#assign-an-agent) to the bot or a channel. | | Each Slack participant | [Link your account](#account-linking), confirm it in Slack, and send a new request. | -Participants need access to the agent and a role that allows using Agents and querying them through Remote Agents (API). Assigning an agent also requires permission to share it and bot management access; installation administrators do not need a separate bot-manager grant. Installing the app or linking an account does not grant these permissions. - If your deployment uses a manually configured Slack app instead of organization workspaces, follow [manual connection setup](#set-up-a-manual-slack-app-connection). ## Organization workspaces @@ -39,7 +41,18 @@ A Slack app provides the bot's identity; installing it grants access to a worksp -**Register it in LibreChat.** Open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. Copy **App ID**, **Client ID**, **Client Secret**, and **Signing Secret** from Slack's **Basic Information → App Credentials**. Select **Show** before copying secrets. The optional **Name** labels the app in LibreChat without renaming the Slack bot. Save the registration. +**Register it in LibreChat.** Open **Settings → Account → Slack → Set up** (or **Manage**), then **Add Slack app**. + +Copy these values from Slack's **Basic Information → App Credentials** into the matching fields: + +- **App ID** +- **Client ID** +- **Client Secret** +- **Signing Secret** + +Select **Show** before copying a secret. You can also enter a **Name** to identify the app in LibreChat; this does not rename the bot in Slack. + +Select **Save**. You can now expand the registered app to find its callback URLs. -**Configure its callbacks.** Turn **Socket Mode off** in Slack. Expand the saved app in LibreChat and open the gear button, **Connection settings**. Copy all three URLs into that same Slack app: +**Configure its callbacks.** Slack uses separate URLs for app installation, incoming events, and button clicks. + +Turn **Socket Mode off** in Slack. In LibreChat, expand the saved app and open the gear button, **Connection settings**. Copy each URL into its matching setting in the same Slack app: | LibreChat value | Slack setting | | --- | --- | @@ -63,7 +78,7 @@ Keep the complete URLs, including any base path and organization/app suffixes. T -**Add scopes and events in Slack.** Under **OAuth & Permissions → Bot Token Scopes**, add: +**Add bot permissions.** Under **OAuth & Permissions → Bot Token Scopes**, add: ```text app_mentions:read @@ -75,25 +90,58 @@ im:write im:history ``` -No user-token scopes are needed. Under **Event Subscriptions → Subscribe to bot events**, add `app_mention`, `message.im`, `reaction_added`, `reaction_removed`, `app_uninstalled`, and `tokens_revoked`, then save. +No user-token scopes are needed. + + + + +**Subscribe to events.** Under **Event Subscriptions → Subscribe to bot events**, add: + +- `app_mention` +- `message.im` +- `reaction_added` +- `reaction_removed` +- `app_uninstalled` +- `tokens_revoked` -Under **App Home**, enable the **Messages tab** and allow users to send messages from it. Leave token rotation and organization-wide installation disabled. Optional [native Agent sessions](/docs/configuration/channel_gateway#native-agent-ui-and-final-replies) need additional setup. +Save the subscriptions. -**Install the app.** In LibreChat, select **Add to workspace**, choose the intended Slack workspace, and approve installation. Wait for **Connecting to Slack…** to close and **Connected** to appear. **Cancel** abandons a pending installation; **Retry** tries again after failure. Workspace approval policies still apply. +**Allow direct messages.** Under **App Home**, enable the **Messages tab** and allow users to send messages from it. + +Leave token rotation and organization-wide installation disabled. If you want Slack's [native Agent status and Stop controls](/docs/configuration/channel_gateway#native-agent-ui-and-final-replies), follow that additional setup too. + + + + +**Install the app.** In LibreChat, select **Add to workspace**, choose the intended Slack workspace, and approve installation. Workspace approval policies still apply. + +Wait for **Connecting to Slack…** to close. When the workspace shows **Connected**, you can [assign an agent](#assign-an-agent). + +Use **Cancel** to abandon a pending installation or **Retry** after a failure. -LibreChat stores app credentials encrypted; organization setup does not ask for a bot token or app-level token. Use the pencil button, **Edit App**, to update credentials later. Blank secrets keep their saved values; a new client ID requires its matching secret. To change the App ID, register another app. +LibreChat stores these credentials encrypted. Organization setup uses app credentials rather than a pasted bot token or app-level token. + + + + +Use the pencil button, **Edit App**, to update the app later. Leaving a secret blank keeps its saved value. If you change the client ID, enter its matching client secret too. To change the App ID, register another app. -After changing scopes, reconnect the installed app through LibreChat and approve the new grant; Slack settings alone do not update existing tokens. +After changing scopes in Slack, reconnect the installed app through LibreChat and approve the new grant. Existing tokens do not gain scopes just because you changed the app settings. + + + ## Assign an agent -An administrator grants bot management through the workspace's users button, **Manage access** (**Manage bot access** dialog). This lets someone assign agents through the bot; it does not grant Agent sharing permission and is not needed just to talk to the bot. +Before assigning an agent, you need permission to share it and management access to the Slack bot. Installation administrators do not need a separate bot-manager grant. + +To grant bot management, an administrator opens the workspace's users button, **Manage access** (**Manage bot access** dialog). This permission lets someone assign agents through the bot. It does not grant Agent sharing permission, and people only talking to the bot do not need it. @@ -123,7 +171,9 @@ If another agent already owns that destination, **Replace default agent** or **R ## Account linking -Each participant links their own account on first use and may need to link again after expiry, disconnect, or reactivation. +Link your LibreChat account the first time you use the bot. Your account needs access to the agent, and your role must allow using Agents and querying them through Remote Agents (API). Installing the app or linking an account does not grant these permissions. + +Linking happens in two places: choose your LibreChat account in the browser, then confirm that account in Slack. Both steps are required. @@ -133,7 +183,7 @@ Invite the bot to a Slack channel with `/invite @YourBot`, then mention it: `@Yo -Select **Link account** in the bot's private message. Sign in to the intended LibreChat account, check the request, and accept it in the browser. +Select **Link account** in the bot's private message. Sign in to the LibreChat account you want to use, check the account and agent shown, then select **Link account** in the browser. -Return to the same Slack message. It updates to show your account name and **Confirm account**. Confirm from the **same Slack account**. If the message has expired or does not update, mention the bot again to recover the prompt. +Seeing **One more step in Slack** in the browser is expected. Return to the bot's private Slack message and select **Confirm account** from the **same Slack account**. + +If the message has expired or does not update, mention the bot again to get another prompt. -When it shows **Account connected**, send a **new request**; the original is not replayed. A successful answer completes setup. Try a permitted tool to verify tool access too. +When Slack shows **Account connected**, send a **new request**. Your earlier message will not run automatically. + +A successful answer completes setup. To check tool access too, ask the agent to use a tool your account is allowed to use. +You may need to link again after the link expires, you disconnect, or the connection is reactivated. + ## Use the agent Continue in the same Slack thread for follow-up questions. A working message provides **Stop** and, when needed, **Review**. Supported questions and individual tool approvals use private Slack controls; provider sign-in and unsupported forms open the authenticated browser flow. The agent's approval policy still applies. @@ -164,15 +220,47 @@ Sharing a Slack thread does not share another person's files, account, pending q ## Manage connections -- **Agent assignments:** hover over or focus a connection row and open its gear button, **Manage connection**. Use **Add assignment** for another destination, or **Remove** beside an assignment and confirm. **Delete connection** removes all its assignments after confirmation. Existing threads do not silently move to another agent. -- **Workspace connection:** disabling stops execution while retaining assignments. **Activate channel** confirms the retained assignment; each participant must link and confirm again after reactivation. Removing a manager's access alone does not stop existing assignments or conversations. -- **Your account:** in **Settings → Account → Your channel account links**, rows show the agent name and Slack user/workspace IDs. Hover over the Slack icon to read the link status. Hover over or focus a row, select **Disconnect**, and confirm to withdraw your consent. You can disconnect an unavailable link too; completed actions are not undone. -- **Workspace installation:** in **Settings → Account → Slack → Manage**, use **Disconnect workspace** to retire the installation in LibreChat. This does not uninstall the Slack app. A new installation has a fresh identity and needs new assignments and manager grants. Reconnecting an active installation updates its grant and preserves managers. -- **App registration:** disconnect its workspace first, then use **Remove app** to delete its saved credentials. The app itself remains in Slack. Removing the person who configured it does not delete the organization's installation. + + + +Hover over or focus a connection row and open its gear button, **Manage connection**. + +Use **Add assignment** for another destination, or **Remove** beside an assignment and confirm. **Delete connection** removes all its assignments after confirmation. Existing threads keep their original agent. + + + + +Disabling stops execution and keeps the assignments. To reactivate, select **Activate channel** and confirm the retained assignment. Each person must link and confirm their account again afterward. + +Removing a manager's access alone does not stop existing assignments or conversations. + + + + +Open **Settings → Account → Your channel account links**. Each row shows the agent name and Slack user/workspace IDs. Hover over its Slack icon to read the link status. + +Hover over or focus the row, select **Disconnect**, and confirm to disconnect your account from this agent. You can disconnect an unavailable link too. Completed actions will not be undone. + + + + +Open **Settings → Account → Slack → Manage** and select **Disconnect workspace**. This disconnects the installation in LibreChat and leaves the app installed in Slack. + +Installing it again after disconnecting creates a new installation identity. Set up its assignments and bot managers again. Reconnecting an active installation updates its grant and keeps its managers. + + + + +Disconnect the app's workspace first, then use **Remove app** to delete its saved credentials. The app itself remains in Slack. + +Removing the person who configured the app does not delete the organization's installation. + + + ## Set up a manual Slack app connection -Use this path when organization workspaces are not enabled. Your operator must enable manual Channels and [prepare the gateway](/docs/configuration/channel_gateway#configuration-and-prerequisites). +Use this path when organization workspaces are not enabled. Ask your deployment administrator to enable manual Channels and [prepare the gateway](/docs/configuration/channel_gateway#configuration-and-prerequisites) first. @@ -204,7 +292,18 @@ Hover over or focus the Slack/status icon in the connection dialog to find the * -In **Manage connection**, the pencil beside the identity mode changes who can use the connection. An active connection must be disabled first; confirm **Disable and change**, choose the mode, and **Save**. Existing links and pending requests stop working. After saving, reopen **Manage connection → Setup**. Use the existing Slack app, re-enter its bot token (and signing secret for webhooks), then finish the wizard and select **Activate channel**. Each participant must link and confirm again. + + + +Changing identity mode invalidates existing links and pending requests. Each person will need to link and confirm again. + +1. In **Manage connection**, select the pencil beside the identity mode. If the connection is active, confirm **Disable and change**. +2. Choose the new mode and select **Save**. +3. Reopen **Manage connection → Setup**. Use the existing Slack app and re-enter its bot token (and signing secret for webhooks). +4. Finish the wizard and select **Activate channel**. + + + ## Troubleshooting diff --git a/content/docs/features/background_responses.mdx b/content/docs/features/background_responses.mdx index 6e8d33a23..86db7a758 100644 --- a/content/docs/features/background_responses.mdx +++ b/content/docs/features/background_responses.mdx @@ -1,15 +1,17 @@ --- title: Background Agent Responses -description: Run durable Agent Responses, review pending actions, and stop an owned execution +description: Start agent requests in the background, check their progress, and review or stop your requests. icon: Workflow --- +Use background responses when your application needs to start an agent request and check its progress later. Submit the request, save the returned response ID, and use that ID to check for updates through the existing [Agents API](/docs/features/agents_api). + +If the agent needs an approval, an answer, or a sign-in, the response includes a review link for the owner. + Background execution is disabled by default. Use a LibreChat version that supports background Responses before enabling it. -Background Responses use the existing [Agents API](/docs/features/agents_api), not a separate model execution engine. A request returns a stored response identity while a worker executes the Agent. Clients poll that identity for output, required actions, and the canonical terminal result. - ## Enable background execution Merge this block into your existing configuration: @@ -23,18 +25,30 @@ endpoints: acknowledgementTimeoutMs: 10000 ``` -`enabled` defaults to `false`. `acknowledgementTimeoutMs` defaults to `10000` and accepts integers from `100` through `60000`; it bounds the worker admission acknowledgement, not total model execution time. Existing Remote Agents permissions, Agent access, terms acceptance, content checks, and provider/tool policies still apply. +`enabled` defaults to `false`. Existing Remote Agents permissions, Agent access, terms acceptance, content checks, and provider/tool policies still apply. + +`acknowledgementTimeoutMs` controls how long the API waits for the worker to acknowledge the request. It defaults to `10000` milliseconds and accepts integers from `100` through `60000`. It does not limit the agent's total execution time. Stored background Responses require a MongoDB replica set or another verified transaction-capable database. Standalone MongoDB and FerretDB 2.7 do not support this durable feature; ordinary LibreChat remains available. See the [local replica setup](/docs/configuration/channel_gateway#docker-compose). Background submission requires an **Agent API key**, including when ordinary inference also accepts OIDC. A management API machine token is not an execution credential. Configure [Remote Agents permissions](/docs/features/agents_api#setup) separately. -Human tool approval and Ask User pauses require durable MongoDB checkpoint storage. Use the existing [`toolApproval`](/docs/configuration/librechat_yaml/object_structure/agents#toolapproval), Ask User, and [`checkpointer`](/docs/configuration/librechat_yaml/object_structure/agents#checkpointer) settings; background execution does not automatically enable approval or bypass a deny rule. A memory checkpointer does not provide durable background human-action resume. Ordinary requests without a human pause retain their normal execution path. +If your agent needs tool approval or Ask User pauses, configure durable MongoDB checkpoint storage through the existing [`toolApproval`](/docs/configuration/librechat_yaml/object_structure/agents#toolapproval), Ask User, and [`checkpointer`](/docs/configuration/librechat_yaml/object_structure/agents#checkpointer) settings. + +An in-memory checkpointer cannot provide durable resume for these background pauses. Enabling background execution does not enable approval automatically or bypass a deny rule. Requests without a human pause keep their normal execution path. Set `DOMAIN_CLIENT` to the trusted public browser URL so generated review links point to your deployment. Do not construct review destinations from incoming Host headers. ## Submit and poll +Follow the same response from submission to completion: + +1. Send a background request. +2. Save the response ID returned by the API. +3. Use that ID to check progress and handle any required action. + +### Send a request + ```bash curl https://chat.example.com/api/agents/v1/responses \ -H 'Authorization: Bearer YOUR_AGENT_API_KEY' \ @@ -43,18 +57,37 @@ curl https://chat.example.com/api/agents/v1/responses \ -d '{"model":"AGENT_ID","input":"Summarize the latest report.","background":true,"store":true}' ``` -Accepted background requests return HTTP `202` with a response object. `background: true` requires storage: omit `store` or set it to `true`. `store: false` and `stream: true` are rejected for background requests. Ordinary synchronous and streaming Responses remain separate supported modes when `background` is omitted or false. +The API returns HTTP `202` with a response object when it accepts the background request. Save its ID for the next step. + +Requests with `background: true` require storage: omit `store` or set it to `true`. They reject `store: false` and `stream: true`. To use ordinary synchronous or streaming Responses, omit `background` or set it to `false`. + +If the connection drops before you receive a response, retry the same request with the same `Idempotency-Key`. Choose a new key for new work. + +The key is optional, but omitting it makes each submission a new request. A retry after an uncertain network result can then start duplicate work. When supplied, the key must be nonblank and at most 256 characters. -Use a stable `Idempotency-Key` for retries of the same logical submission. The optional key must be nonblank and at most 256 characters; do not reuse it for a different request. If omitted, the server creates a new request identity, so an ambiguous network retry can create another request. +### Check progress ```bash curl https://chat.example.com/api/agents/v1/responses/RESPONSE_ID \ -H 'Authorization: Bearer YOUR_AGENT_API_KEY' ``` -Poll the same response until its public status is `completed`, `failed`, `incomplete`, or `cancelled`. `queued` and `in_progress` are not terminal. The server rechecks the original source key and current authority; possession of a response ID is not permission to read or resume it. Use the returned response ID as `previous_response_id` for a subsequent supported continuation rather than resending the original user input. +Keep checking the same response ID until it reaches a final status: + +| Status | What to do | +| --- | --- | +| `queued`, `in_progress` | Keep checking. If `required_action` is present, [review it](#review-a-required-action). | +| `completed`, `failed`, `incomplete`, `cancelled` | Read the final result or error. These statuses are terminal. | + +The server rechecks the API key that started the request and current access permissions. A response ID alone does not grant access to read or resume it. + +To continue a supported conversation, pass the returned ID as `previous_response_id` instead of resending the original input. -A background answer becomes terminal only after the provider has drained and its conversation history is committed with the response. A temporary storage outage keeps the selected outcome pending for recovery without running the provider again. During a rolling upgrade or rollback, keep a compatible worker available to finish pending results. +### Storage and recovery + +A background response reports a final status after the provider has finished and the conversation history is saved with the response. If storage is temporarily unavailable, the result stays pending for recovery without running the provider again. + +During a rolling upgrade or rollback, keep a compatible worker available to finish pending results. Ordinary synchronous and streaming requests have a different storage contract: if optional saving fails, the generated answer can still succeed with `store: false`. Check that returned value before relying on retrieval or continuation. @@ -75,9 +108,15 @@ A public response can include: } ``` -`kind` is `tool_approval`, `question`, or `oauth`. `expires_at` is Unix time in seconds. Treat the action as actionable only while it is present and unexpired. The public projection intentionally omits private approval payloads and provider OAuth URLs. Do not infer that public `in_progress` means a provider is currently running: it also covers a retained action waiting for its owner. +An `in_progress` response can be waiting for you, rather than running the model. Check `required_action` for the next step: + +- `kind` is `tool_approval`, `question`, or `oauth`. +- `expires_at` is the expiry time, in Unix seconds. Act only while the action is still present and unexpired. +- Private approval details and provider OAuth URLs are available through the authenticated review flow, rather than this public response. + +Open `review_url` in a browser and sign in as the response owner in the correct tenant. From there, you can inspect the pending tool call, answer a question, or continue an MCP OAuth sign-in. -Open `review_url` in a browser and sign in as the response owner in the correct tenant. The owner can inspect the exact pending tool call, answer a question, or continue an MCP OAuth flow. An unrelated account cannot approve a request just because it can access the same Agent. +Access to the same agent is not enough to approve someone else's request. The browser lifecycle uses session authentication, not an Agent API key or a management token: @@ -87,20 +126,43 @@ The browser lifecycle uses session authentication, not an Agent API key or a man | `POST` | `/api/agents/responses/{id}/review` | Submit the current action decision | | `POST` | `/api/agents/responses/{id}/cancel` | Request Stop for an owned response | -Decision submissions include the exact current `actionId` and the payload appropriate to that action. Question submissions use `answer`, or `answers` keyed by the presented question identities. Tool approval submissions use `decisions` containing the exact `tool_call_id` and an allowed `decision` (`approve`, `reject`, `edit`, or `respond`), with the corresponding edited arguments or response text when needed. Use the supplied review UI to respect action-specific validation and offered scopes; an enum value in a transport schema is not a grant to choose an unavailable approval scope. +Decision submissions must include the current `actionId` and the fields for that action: + +- **Questions:** use `answer`, or `answers` keyed by the presented question identities. +- **Tool approvals:** use `decisions` with the exact `tool_call_id` and an allowed `decision` (`approve`, `reject`, `edit`, or `respond`). Include edited arguments or response text when needed. + +Use the supplied review UI to see which choices and scopes are available. A value listed in the API schema does not grant permission to use an unavailable approval scope. + +After a decision is accepted, the API returns HTTP `202` with `responseId`, `actionId`, `intentId`, and `status` (`queued` or `settled`). Check the review page or response again to see what happened next; acceptance does not mean execution has finished. -A successful decision returns HTTP `202` with `responseId`, `actionId`, `intentId`, and `status` (`queued` or `settled`). This is an acknowledgement, not proof that execution completed. Refresh the canonical review/response state. Do not automatically resubmit an ambiguous decision with a different intent or replay a stale action after a conflict. Resume revalidates current Agent/model/tool/project/file authority and retained execution provenance before privileged work. +If the submission result is uncertain, do not resubmit it with a different intent or reuse a stale action after a conflict. Before resuming, the server rechecks access to the agent, model, tools, project and files, together with the saved execution context. ## OAuth recovery limits -MCP OAuth prompts are retained for owner-only replay until their deadline. Complete authorization through the supplied provider flow; do not submit an approval decision to replace an OAuth callback. A successful callback can continue the same waiting execution while its waiter is still active. +Complete MCP OAuth sign-in through the supplied provider flow. The prompt remains available only to its owner until its deadline. An approval decision cannot replace the provider's OAuth callback. -Durable prompt visibility is not a guarantee that an in-memory OAuth waiter survives a server restart. Durable human question/tool-approval checkpoints and OAuth authorization waiters are different mechanisms. If exact execution state is missing or mismatched, the response reports nonterminal `recovery: "execution_state_unavailable"` and removes stale actionable prompts. This is not proof of completion or cancellation and does not replay work. Sign-in credentials may have been saved even though the original run did not continue. Check external results before retrying; an administrator must reconcile a persistently unknown execution before the held run can safely be cleared. Do not replay an old authorization URL or infer that sign-in restarted the model. See [MCP authentication](/docs/features/mcp#sign-in-with-oauth). +A successful sign-in can continue the waiting request while that request's sign-in handler is still active. + +### If the server restarts during sign-in + +A request waiting for sign-in may not resume after a server restart, even if its prompt is still visible. OAuth sign-in handlers are kept in memory; durable question and tool-approval checkpoints use a different mechanism. + +If the saved execution state is missing or no longer matches, the response keeps a non-final status, includes `recovery: "execution_state_unavailable"`, and removes stale actionable prompts. The request has not been confirmed complete or cancelled, and work is not replayed. + +Signing in may save your credentials without resuming the original request. Before retrying: + +1. Check the original request and any external results, such as a tool action that may already have completed. +2. If the execution state remains unknown, ask an administrator to reconcile the held run before clearing it. +3. Avoid reusing an old authorization URL or assuming sign-in restarted the model. + +See [MCP authentication](/docs/features/mcp#sign-in-with-oauth) for the sign-in flow. ## Stop and recovery API-key clients can request cancellation with `POST /api/agents/v1/responses/{id}/cancel`. Owners can use **Stop** in the review UI. Both paths operate on the same durable response; neither starts a replacement execution. -A cancellation acknowledgement may still report a nonterminal status while provider drain, checkpoint cleanup, or terminal publication is pending. Continue polling until canonical `cancelled` (or another terminal result already won the race). Stop is not rollback: tools may already have performed external effects. Do not repeat an external operation merely because its answer was cancelled. +After requesting Stop, keep checking until the response reports `cancelled` or another final status. It may take time for the provider to stop, checkpoints to be cleaned up, and the final status to be saved. + +Completed tool actions will not be undone. Check their results before repeating work, even if the response was cancelled. Revoked source keys, changed channel/account bindings, missing authority, stale checkpoint identities, and changed privileged code targets fail closed. Temporary storage outages can delay terminal publication and cleanup; do not force-delete execution proof or manually replay tools to make the status change. From 398ddc650d93e148e13940b39ed69cfe73564a7e Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 13:28:34 -0800 Subject: [PATCH 37/38] docs: remove unrelated workflow and screenshot changes --- .github/workflows/ci.yml | 3 +-- .github/workflows/update-screenshots.yml | 3 +-- content/docs/features/agents_api.mdx | 6 ++++++ 3 files changed, 8 insertions(+), 4 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index f3274c8b5..401cf08e1 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -59,8 +59,7 @@ jobs: e2e: name: End-to-end tests - # Match the Ubuntu version supported by the locked Playwright browsers. - runs-on: ubuntu-24.04 + runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 diff --git a/.github/workflows/update-screenshots.yml b/.github/workflows/update-screenshots.yml index 8e91d7391..d14b945c6 100644 --- a/.github/workflows/update-screenshots.yml +++ b/.github/workflows/update-screenshots.yml @@ -16,8 +16,7 @@ permissions: jobs: screenshots: name: Capture and open PR - # Match the Ubuntu version supported by the locked Playwright browsers. - runs-on: ubuntu-24.04 + runs-on: ubuntu-latest environment: Production steps: - uses: actions/checkout@v4 diff --git a/content/docs/features/agents_api.mdx b/content/docs/features/agents_api.mdx index 3eaef7297..e666f0fee 100644 --- a/content/docs/features/agents_api.mdx +++ b/content/docs/features/agents_api.mdx @@ -22,6 +22,12 @@ For opt-in asynchronous execution, retained human actions, owner review, and Sto Open **Settings**, go to **Data & Privacy**, and find **Agent API Keys** under **API keys**. Click **Manage**, then **Create API Key**, give it a name, pick an expiration (7 days up to 1 year, or never), and copy the key right away: it is shown only once. + + A key acts as you. Anything you can reach through the API, anyone holding the key can reach too, so delete keys you no longer use. Deleting a key cuts off applications using it immediately. If you do not see the section, your role has not been given access to the Agents API. From 80b217fca9a30e9cfe77c5e1fde285d0f2d1a777 Mon Sep 17 00:00:00 2001 From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com> Date: Tue, 17 Nov 2026 14:11:35 -0800 Subject: [PATCH 38/38] ci: retry Vercel preview deployment