import { normalizeMattermostBaseUrl } from "./client.js";

import type { OpenClawConfig } from "./runtime-api.js";

export type MattermostTokenSource = "env" | "config" | "none";

export type MattermostBaseUrlSource = "env" | "config" | "none";

type MattermostTokenSource = "env" | "config" | "none";

type MattermostBaseUrlSource = "env" | "config" | "none";

export type ResolvedMattermostAccount = {

accountId: string;

const MATTERMOST_STREAM_MAX_CHARS = 4000;

const DEFAULT_THROTTLE_MS = 1000;

export type MattermostDraftStream = {

type MattermostDraftStream = {

update: (text: string) => void;

flush: () => Promise<void>;

postId: () => string | undefined;

forceNewMessage: () => void;

};

export function normalizeMattermostDraftText(text: string, maxChars: number): string {

function normalizeMattermostDraftText(text: string, maxChars: number): string {

const trimmed = text.trim();

if (!trimmed) {

return "";

* Sent by Mattermost when a user clicks an action button.

* See: https://developers.mattermost.com/integrate/plugins/interactive-messages/

*/

export type MattermostInteractionPayload = {

type MattermostInteractionPayload = {

user_id: string;

user_name?: string;

channel_id: string;

ephemeral_text?: string;

};

export type MattermostInteractionAuthorizationResult =

type MattermostInteractionAuthorizationResult =

| { ok: true }

| { ok: false; statusCode?: number; response?: MattermostInteractionResponse };

// ── Button builder helpers ─────────────────────────────────────────────

export type MattermostButton = {

type MattermostButton = {

id: string;

type: "button" | "select";

name: string;

};

};

export type MattermostAttachment = {

type MattermostAttachment = {

text?: string;

actions?: MattermostButton[];

[key: string]: unknown;

back: "mdlback",

} as const;

export type MattermostModelPickerEntry =

type MattermostModelPickerEntry =

| { kind: "summary" }

| { kind: "providers" }

| { kind: "models"; provider: string };

export type MattermostModelPickerState =

type MattermostModelPickerState =

| { action: "providers"; ownerUserId: string }

| { action: "back"; ownerUserId: string }

| { action: "list"; ownerUserId: string; provider: string; page: number }

| { action: "select"; ownerUserId: string; provider: string; page: number; model: string };

export type MattermostModelPickerRenderedView = {

type MattermostModelPickerRenderedView = {

text: string;

buttons: MattermostInteractiveButtonInput[][];

};

import { normalizeMattermostBaseUrl, readMattermostError, type MattermostUser } from "./client.js";

import type { BaseProbeResult } from "./runtime-api.js";

export type MattermostProbe = BaseProbeResult & {

type MattermostProbe = BaseProbeResult & {

status?: number | null;

elapsedMs?: number | null;

bot?: MattermostUser;

export type ReconnectOutcome = "resolved" | "rejected";

type ReconnectOutcome = "resolved" | "rejected";

export type ShouldReconnectParams = {

type ShouldReconnectParams = {

attempt: number;

delayMs: number;

outcome: ReconnectOutcome;

error?: unknown;

};

export type RunWithReconnectOpts = {

type RunWithReconnectOpts = {

abortSignal?: AbortSignal;

onError?: (err: unknown) => void;

onReconnect?: (delayMs: number) => void;

// ─── Per-account state ───────────────────────────────────────────────────────

export type SlashCommandAccountState = {

type SlashCommandAccountState = {

/** Tokens from registered/current commands, used for fast-path routing. */

commandTokens: Set<string>;

/** Registered command IDs for cleanup on shutdown. */

export type MattermostChatTypeKey = "direct" | "channel" | "group";

export type MattermostChatMode = "oncall" | "onmessage" | "onchar";

export type MattermostNetworkConfig = {

type MattermostNetworkConfig = {

/** Dangerous opt-in for self-hosted Mattermost on trusted private/internal hosts. */

dangerouslyAllowPrivateNetwork?: boolean;

};