nanocoai/nanoclaw / .claude/skills/add-mattermost
add-mattermost
FlaggedAdd a self-hosted or cloud Mattermost bot channel through the Chat SDK bridge, reusing a healthy server when available and linking to official server setup guidance when needed.
| File | Kind | Size |
|---|---|---|
| REMOVE.md | markdown | 1.5 KB |
| SERVER_SETUP.md | markdown | 1.3 KB |
| SKILL.md | skill md | 16.8 KB |
| apply-fixtures.json | config | 5.8 KB |
| scripts/configure.ts | script | 3.2 KB |
| scripts/discover-server.mjs | script | 3.8 KB |
| scripts/read-response.mjs | script | 1.0 KB |
| scripts/remove-base-url.mjsexecutable | script | 335 B |
| scripts/remove-config.mjsexecutable | script | 381 B |
| scripts/select-server.mjs | script | 1020 B |
| scripts/verify-runtime.ts | script | 9.8 KB |
scripts/verify-runtime.ts
View on GitHubimport { pathToFileURL } from 'node:url';
import { createHmac, randomUUID } from 'node:crypto';
import { readEnvFile } from '../../../../src/env.js';
import { queryHost } from '../../../../setup/lib/host-status.mjs';
const MATTERMOST_ID = /^[a-z0-9]{26}$/;
type HostStatus = {
channels: Array<{ connected: boolean; instance: string; type: string }>;
webhook?: { id: string; host?: string; port: number; paths: string[] } | null;
};
type Dependencies = {
fetchImpl?: typeof fetch;
queryHostImpl?: (root: string) => Promise<HostStatus>;
};
function required(env: Record<string, string>, key: string): string {
const value = env[key];
if (!value) throw new Error(`Mattermost runtime verification: ${key} is missing from .env`);
return value;
}
// The address the listener bound. A wildcard bind (`::` is dual-stack), or a
// host too old to report one, answers on 127.0.0.1; IPv6 needs brackets.
function probeHost(host: string | undefined): string {
if (!host || host === '0.0.0.0' || host === '::') return '127.0.0.1';
return host.includes(':') ? `[${host}]` : host;
}
async function getJson(fetchImpl: typeof fetch, url: string, token: string): Promise<Record<string, unknown>> {
const response = await fetchImpl(url, {
headers: { authorization: `Bearer ${token}` },
redirect: 'error',
signal: AbortSignal.timeout(10_000),
});
if (!response.ok)
throw new Error(`Mattermost runtime verification: GET ${new URL(url).pathname} returned ${response.status}`);
return (await response.json()) as Record<string, unknown>;
}
export async function verifyMattermostRuntime(
root: string,
expectedBotId: string,
expectedOwnerId: string,
platformId: string,
dependencies: Dependencies = {},
): Promise<void> {
if (!MATTERMOST_ID.test(expectedBotId) || !MATTERMOST_ID.test(expectedOwnerId)) {
throw new Error('Mattermost runtime verification: expected bot and owner IDs must be 26 lowercase characters');
}
const channelId = platformId.startsWith('mattermost:') ? platformId.slice('mattermost:'.length) : '';
if (!MATTERMOST_ID.test(channelId)) {
throw new Error('Mattermost runtime verification: invalid owner DM platform ID');
}
const env = readEnvFile(
['MATTERMOST_BASE_URL', 'MATTERMOST_BOT_TOKEN', 'MATTERMOST_CALLBACK_SECRET', 'MATTERMOST_CALLBACK_URL'],
root,
);
const baseUrl = required(env, 'MATTERMOST_BASE_URL').replace(/\/+$/, '');
const token = required(env, 'MATTERMOST_BOT_TOKEN');
const secret = required(env, 'MATTERMOST_CALLBACK_SECRET');
const callbackBase = required(env, 'MATTERMOST_CALLBACK_URL').replace(/\/+$/, '');
const callbackUrl = callbackBase.includes('/webhook/') ? callbackBase : `${callbackBase}/webhook/mattermost`;
for (const url of [baseUrl, callbackUrl]) {
const parsed = new URL(url);
if (
!['http:', 'https:'].includes(parsed.protocol) ||
parsed.username ||
parsed.password ||
parsed.search ||
parsed.hash
)
throw new Error('Mattermost runtime verification: invalid saved URL');
}
const fetchImpl = dependencies.fetchImpl ?? fetch;
const status = await (dependencies.queryHostImpl ?? queryHost)(root);
if (!status.channels.some((channel) => channel.instance === 'mattermost' && channel.connected === true)) {
throw new Error('Mattermost runtime verification: the running host has no connected mattermost adapter');
}
const listener = status.webhook;
if (!listener?.id || !listener.paths.includes('/webhook/mattermost')) {
throw new Error('Mattermost runtime verification: this host has no listening Mattermost callback route');
}
// Use the actual host's bound address and port, including service-level
// overrides. The response identity binds the HTTP route to the host queried
// over its socket.
const localUrl = `http://${probeHost(listener.host)}:${listener.port}/webhook/mattermost`;
const challenge = randomUUID();
const probe = async (received: boolean) => {
const callback = await fetchImpl(localUrl, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ context: { callback_token: secret, nanoclaw_setup_probe: challenge } }),
redirect: 'error',
signal: AbortSignal.timeout(10_000),
});
if (callback.status !== 200 || callback.headers.get('x-nanoclaw-webhook-id') !== listener.id) {
throw new Error(
'Mattermost runtime verification: callback does not identify this host; refresh the Mattermost registry payload with /update-skills and retry',
);
}
const runtime = (await callback.json()) as Record<string, unknown>;
const selected = {
challenge,
bot_id: expectedBotId,
base_url: baseUrl,
callback_url: callbackUrl,
connected: true,
callback_received: received,
};
const proof = createHmac('sha256', token).update(JSON.stringify(selected)).digest('hex');
if (runtime.proof !== proof) {
throw new Error(
received
? 'Mattermost runtime verification: server callback was not received by this running adapter'
: 'Mattermost runtime verification: running adapter configuration or connection differs from the selected settings',
);
}
};
await probe(false);
const me = await getJson(fetchImpl, `${baseUrl}/api/v4/users/me`, token);
if (me.id !== expectedBotId || me.is_bot !== true) {
throw new Error('Mattermost runtime verification: the running credential does not identify the selected bot');
}
const owner = await getJson(fetchImpl, `${baseUrl}/api/v4/users/${expectedOwnerId}`, token);
if (owner.id !== expectedOwnerId) {
throw new Error('Mattermost runtime verification: the selected owner is not resolvable');
}
const dm = await getJson(fetchImpl, `${baseUrl}/api/v4/channels/${channelId}`, token);
if (dm.id !== channelId || dm.type !== 'D') {
throw new Error('Mattermost runtime verification: the selected owner DM is not available');
}
for (const id of [expectedBotId, expectedOwnerId]) {
const member = await getJson(fetchImpl, `${baseUrl}/api/v4/channels/${channelId}/members/${id}`, token);
if (member.user_id !== id || member.channel_id !== channelId)
throw new Error('Mattermost runtime verification: the DM does not contain the selected bot and owner');
}
const unsigned = await fetchImpl(localUrl, {
method: 'POST',
body: '{}',
redirect: 'error',
signal: AbortSignal.timeout(10_000),
});
if (unsigned.status !== 401 || unsigned.headers.get('x-nanoclaw-webhook-id') !== listener.id)
throw new Error('Mattermost runtime verification: local callback does not reject unsigned requests');
const request = async (path: string, method: string, body?: unknown) => {
const response = await fetchImpl(`${baseUrl}/api/v4${path}`, {
method,
headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
body: body === undefined ? undefined : JSON.stringify(body),
redirect: 'error',
signal: AbortSignal.timeout(15_000),
});
if (!response.ok) throw new Error(`Mattermost runtime verification: ${method} ${path} returned ${response.status}`);
return response;
};
// Trigger the same integration API the UI calls. Mattermost makes the
// callback request, exercising its routing, TLS and internal-host policy.
// The short-lived proof cannot authenticate normal approval callbacks.
const posted = (await (
await request('/posts', 'POST', {
channel_id: channelId,
message: 'NanoClaw setup: checking the card callback (removed automatically).',
props: {
attachments: [
{
text: 'Setup verification',
actions: [
{
id: 'nanoclawsetup',
name: 'Verify setup',
type: 'button',
integration: {
url: callbackUrl,
context: {
nanoclaw_setup_action: challenge,
nanoclaw_setup_proof: createHmac('sha256', token)
.update(`nanoclaw-setup:${challenge}`)
.digest('hex'),
},
},
},
],
},
],
},
})
).json()) as { id?: unknown };
if (typeof posted.id !== 'string' || !MATTERMOST_ID.test(posted.id))
throw new Error('Mattermost runtime verification: server did not identify the temporary verification post');
try {
await request(`/posts/${posted.id}/actions/nanoclawsetup`, 'POST', {});
await probe(true);
} finally {
try {
await request(`/posts/${posted.id}`, 'DELETE');
} catch {
// Deleting posts can be disabled independently of working bot/card
// delivery. Preserve the verification outcome and identify cleanup.
console.error(
`Mattermost setup: remove diagnostic post ${posted.id} from the owner DM; automatic cleanup failed.`,
);
}
}
}
// Print only this helper's own messages. A parse or network error can quote the
// server's response, and this output becomes the setup failure reason.
export function failureMessage(error: unknown): string {
const message = error instanceof Error ? error.message : '';
return message.startsWith('Mattermost runtime verification: ')
? message
: 'Mattermost runtime verification: could not complete the check';
}
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
const [expectedBotId, expectedOwnerId, platformId] = process.argv.slice(2);
try {
await verifyMattermostRuntime(process.cwd(), expectedBotId ?? '', expectedOwnerId ?? '', platformId ?? '');
console.log(
'Mattermost verified: running bot and settings, authenticated adapter, owner DM, and callback delivery from the Mattermost server.',
);
} catch (error) {
console.error(failureMessage(error));
process.exitCode = 1;
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |