Skip to content

netresearch/matrix-skill / skills/matrix-communication

matrix-communication

Flagged

Use when communicating via Matrix chat, notifying teams, or managing E2EE. Triggers on #room:server references, Matrix URLs, and chat requests.

FileKindSize
README.mdmarkdown2.9 KB
SKILL.mdskill md6.7 KB
evals/evals.jsonconfig12.6 KB
references/agent-governance.mdmarkdown2.0 KB
references/api-reference.mdmarkdown7.3 KB
references/command-reference.mdmarkdown8.9 KB
references/e2ee-guide.mdmarkdown17.2 KB
references/hookshot-integration.mdmarkdown10.7 KB
references/messaging-guide.mdmarkdown13.8 KB
references/no-editorializing.mdmarkdown331 B
references/setup-guide.mdmarkdown11.1 KB
references/troubleshooting.mdmarkdown7.8 KB
scripts/_lib/__init__.pyscript3.6 KB
scripts/_lib/backup_mac.pyscript1.2 KB
scripts/_lib/config.pyscript4.6 KB
scripts/_lib/daemon_client.pyscript3.0 KB
scripts/_lib/deps.pyscript1.9 KB
scripts/_lib/downloads.pyscript1.1 KB
scripts/_lib/e2ee.pyscript13.2 KB
scripts/_lib/formatting.pyscript14.4 KB
scripts/_lib/http.pyscript4.8 KB
scripts/_lib/reactions.pyscript2.9 KB
scripts/_lib/roomlog.pyscript13.7 KB
scripts/_lib/rooms.pyscript15.5 KB
scripts/_lib/secret_input.pyscript2.0 KB
scripts/_lib/test_backup_mac.pyscript1.5 KB
scripts/_lib/test_config.pyscript7.1 KB
scripts/_lib/test_daemon_client.pyscript5.9 KB
scripts/_lib/test_downloads.pyscript2.3 KB
scripts/_lib/test_e2ee.pyscript14.3 KB
scripts/_lib/test_formatting.pyscript15.5 KB
scripts/_lib/test_http.pyscript4.1 KB
scripts/_lib/test_reactions.pyscript15.2 KB
scripts/_lib/test_roomlog.pyscript20.2 KB
scripts/_lib/test_rooms.pyscript13.7 KB
scripts/_lib/test_secret_input.pyscript2.2 KB
scripts/_lib/test_trust.pyscript8.3 KB
scripts/_lib/trust.pyscript5.3 KB
scripts/_lib/utils.pyscript1.7 KB
scripts/matrix-create-room.pyexecutablescript4.7 KB
scripts/matrix-doctor.pyexecutablescript22.2 KB
scripts/matrix-download-e2ee.pyexecutablescript7.7 KB
scripts/matrix-e2ee-setup.pyexecutablescript9.2 KB
scripts/matrix-e2ee-verify.pyexecutablescript29.2 KB
scripts/matrix-edit-e2ee.pyexecutablescript7.9 KB
scripts/matrix-edit.pyexecutablescript5.3 KB
scripts/matrix-fetch-keys.pyexecutablescript9.1 KB
scripts/matrix-invite.pyexecutablescript3.0 KB
scripts/matrix-key-backup.pyexecutablescript21.3 KB
scripts/matrix-power-level.pyexecutablescript7.0 KB
scripts/matrix-react.pyexecutablescript14.1 KB
scripts/matrix-read-e2ee.pyexecutablescript12.8 KB
scripts/matrix-read.pyexecutablescript4.7 KB
scripts/matrix-redact.pyexecutablescript5.0 KB
scripts/matrix-resolve.pyexecutablescript1.7 KB
scripts/matrix-rooms.pyexecutablescript3.8 KB
scripts/matrix-send-e2ee.pyexecutablescript19.4 KB
scripts/matrix-send.pyexecutablescript9.4 KB
scripts/matrix-watch.pyexecutablescript5.3 KB
scripts/matrix-watchd.pyexecutablescript23.5 KB
scripts/test_matrix_doctor.pyscript14.2 KB
scripts/test_matrix_read_e2ee.pyscript2.7 KB

scripts/_lib/reactions.py

View on GitHub
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH

"""Find the reactions one account set on one event.

A status reaction is replaced by redacting the old one, and a redaction needs
the reaction's own event id. The caller should not have to keep that id: the
server lists every annotation on an event (``/relations/{event}/m.annotation``),
and the account's own ones are picked out here by sender and key.

``m.relates_to`` stays in clear text on an encrypted event, so an encrypted
reaction (``m.room.encrypted``) carries its key where this code reads it.
"""

from collections.abc import Callable, Iterable
from urllib.parse import quote


def path_segment(value: str) -> str:
    # Same encoding as _lib.http.path_segment; repeated so this module stays
    # importable on its own, the way its test file loads it.
    return quote(str(value), safe="")


# Synapse caps a page at 1000; one notification rarely carries more than a
# handful, so this is a guard against a server that never stops paging.
MAX_PAGES = 50


def own_reactions(
    events: Iterable[dict], user_id: str, keys: set[str] | None
) -> list[dict]:
    """Return ``{"event_id", "key"}`` for each live reaction ``user_id`` set
    with one of ``keys``; ``keys=None`` returns every key.

    A reaction that was already redacted no longer counts: its content is gone,
    and redacting it again would only produce a second, useless event.
    """
    found = []
    for event in events:
        if event.get("sender") != user_id:
            continue
        if event.get("type") not in ("m.reaction", "m.room.encrypted"):
            continue
        if "redacted_because" in event.get("unsigned", {}):
            continue
        relation = event.get("content", {}).get("m.relates_to", {})
        if relation.get("rel_type") != "m.annotation":
            continue
        key = relation.get("key")
        if (keys is None or key in keys) and event.get("event_id"):
            found.append({"event_id": event["event_id"], "key": key})
    return found


def annotations(
    request: Callable[[str], dict], room_id: str, event_id: str
) -> list[dict] | dict:
    """Every annotation event on ``event_id``, following pagination.

    ``request`` takes a client-API v1 path and returns the parsed response.
    Returns the error dict of the first failing page, so a failed lookup can
    never pass for "no reactions there".
    """
    base = (
        f"/rooms/{path_segment(room_id)}/relations/{path_segment(event_id)}"
        "/m.annotation?limit=100"
    )
    events: list[dict] = []
    token = None
    for _ in range(MAX_PAGES):
        path = base if token is None else f"{base}&from={quote(token, safe='')}"
        page = request(path)
        if "error" in page:
            return page
        events.extend(page.get("chunk", []))
        token = page.get("next_batch")
        if not token:
            return events
    return {"error": f"more than {MAX_PAGES} pages of reactions on {event_id}"}
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall