channel-operations

Channel Operations

Tool Map

• channel_catalog
• channel_manifest
• channel_setup_requirements
• channel_setup_save
• channel_setup_status
• channel_doctor
• channel_integration_smoke
• channel_listener_status
• channel_listener_tick
• channel_webhook_ingest
• channel_message_prepare
• channel_action_prepare
• channel_message_send
• channel_outbox

Use this skill when the task involves onboarding, diagnosing, or sending through any chat channel.

First Checks

1. Call channel_catalog to see supported channels.
2. Call channel_manifest for the exact selected channel.
3. Call channel_setup_requirements to read required env vars, fields, direct-send support, and policy defaults.
4. Call channel_doctor before sending or declaring setup complete.
5. Call channel_integration_smoke for a non-sending readiness report covering setup, prepared outbox, dry-run send wiring, and listener state.
6. Call channel_listener_status before declaring the agent is listening.

Setup State

Use channel_setup_save for:

• enabled
• conversation_defaults
• allowlist
• group_allowlist
• secret_refs such as {"bot_token":"SLACK_BOT_TOKEN"}
• notes

Do not put raw tokens, app secrets, OAuth refresh tokens, phone auth state, QR session files, or private keys in setup JSON.

Testing A Channel

For a non-destructive smoke:

1. Run channel_integration_smoke for the selected channel.
2. Prepare a message with channel_message_prepare when you need to inspect the exact outbound envelope.
3. Prepare reactions, file shares, thread replies, pins, typing indicators, or read receipts with channel_action_prepare.
4. Inspect channel_outbox.
5. For inbound harness smoke, pass an inbound channel message with explicit requires_response:true.
6. For webhook smoke, use channel_webhook_ingest with a structured provider payload.
7. For Telegram listener smoke, use channel_listener_tick after enabling the channel and configuring TELEGRAM_BOT_TOKEN.
8. Confirm a prepared reply exists only for non-ambient request messages.
9. For external send smoke, use channel_message_send only with approval and a test recipient or room.