concinno-skills-chat

Chat-platform agent skills for Concinno. Native Python API, MCP fallback optional. MIT / Apache-2.0 licensed SDKs only — we deliberately skip python-telegram-bot (GPL-3.0) to avoid copy-left contamination of the Concinno ecosystem.

Status

MVP (0.1.0) — four one-shot tools:

WhatsApp / Microsoft Teams are intentionally deferred until a maintained Python SDK with a permissive licence exists (as of 2026-04 the ecosystem is either unofficial or AGPL-adjacent).

Install

pip install concinno-skills-chat

All four SDKs are hard dependencies and pulled in automatically.

Credentials

Each platform's bot token lives under a well-known key in the Concinno CredentialStore, which reads (in order):

1. Process runtime overrides via CredentialStore.set(...).
2. Env var CONCINNO_CRED_<UPPER_KEY>.
3. ~/.concinno/credentials.json.

Example ~/.concinno/credentials.json:

{
  "slack_bot_token": "xoxb-...",
  "discord_bot_token": "...",
  "telegram_bot_token": "123456:AAA...",
  "line_channel_access_token": "..."
}

If a token is missing the tool returns {"error": "no <service> credentials — set via CredentialStore or env ..."} rather than crashing.

Usage via Concinno ToolRegistry

When the consumer sets CONCINNO_LOAD_PLUGINS=1, the default registry auto-mounts every chat tool:

import os
os.environ["CONCINNO_LOAD_PLUGINS"] = "1"

from concinno.tools.registry import get_default_registry

reg = get_default_registry()
assert {"SlackPost", "DiscordPost", "TelegramSend", "LineSend"} <= set(
    reg.list_deferred()
)

slack = reg.get("SlackPost")
slack.call(action="send", channel="#general", text="hi from concinno")

Direct Python usage

from concinno_skills_chat import (
    SlackPost,
    DiscordPost,
    TelegramSend,
    LineSend,
)

SlackPost().call(action="send", channel="C12345", text="hi")
DiscordPost().call(action="send", channel_id=12345, content="hi")
TelegramSend().call(action="send", chat_id=12345, text="hi")
LineSend().call(action="push", user_id="U1234", text="hi")

All tools return {"ok": True, ...} on success or {"error": "..."} on failure — same shape as the other Concinno built-in tools. No exceptions escape the call() surface.

Concurrency

All four tools set is_concurrency_safe = False. Chat platform rate limits make serial calls the sane default; the Concinno scheduler will honour this automatically.

License

Apache-2.0. See LICENSE in the Concinno monorepo.