К основному содержанию
скилл CX Codex

catalyst-datastreams — скилл для Claude Code: настройка и установка

Скилл для Claude Code помогает подключать Catalyst Data Streams — каналы обмена сообщениями через WebSocket. Разбирает публикацию событий, выдачу токенов и подписку на канал.

Apache-2.0 180 установок ★ 74 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add catalystbyzoho/agent-skills --skill catalyst-datastreams -a claude-code
Открыть на GitHub

Что делает catalyst-datastreams

Скилл объясняет, как создавать каналы Data Streams в консоли Catalyst и выбирать для них контроль доступа. Для User Roles нужен userId, а для Custom Logic — connectionName; токен для второго типа канала должна выдавать настроенная функция Advanced I/O. Она проверяет запрос и вызывает getTokenPair.

Для Node.js, Python и Java есть отдельные справочные файлы с примерами публикации и подписки. Подписчик должен подключаться после события open и вызывать sendAck() после каждого сообщения. Хранение сообщений длится 48 часов; при переподключении с '-2' пропущенные сообщения доставляются дважды. Создание каналов доступно только через консоль.

Для Python нужны Python 3.10+ и zcatalyst-sdk 1.5.0+; для Java — com.zoho.catalyst:java-sdk версии 2.5.0+ из Maven. Административные методы публикации и чтения каналов выполняются только на сервере, не в браузере или мобильном приложении.

Какие задачи решает

  • настроить публикацию сообщений в канал Catalyst Data Streams
  • выбрать идентификатор токена для User Roles или Custom Logic
  • подключить WebSocket-подписчика и подтверждать сообщения
  • разобрать ошибки аутентификации и переподключения

Примеры запросов агенту

  • Настрой публикацию сообщений в Catalyst Data Streams из Node.js-функции.
  • Разбери ошибку «Mandatory parameter app_user_id is missing» при подписке на канал.
  • Покажи, как Python-подписчику подключиться к Data Streams и подтверждать сообщения.

Как установить catalyst-datastreams

1Через Skills CLI (Vercel)

npx skills add catalystbyzoho/agent-skills --skill catalyst-datastreams -a claude-code

2Вручную: положить файлы

~/.claude/skills/catalyst-datastreams/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/catalyst-datastreams/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о catalyst-datastreams

Как установить catalyst-datastreams в Claude Code?

Выполни npx skills add catalystbyzoho/agent-skills --skill catalyst-datastreams -a claude-code. Файл скилла появится по пути ~/.claude/skills/catalyst-datastreams/SKILL.md.

Что делает catalyst-datastreams?

Скилл помогает настраивать публикацию и WebSocket-подписку на Catalyst Data Streams, выбирать правильный тип токена и разбирать подтверждения и переподключения.

Что нужно для работы catalyst-datastreams?

Для Python нужны Python 3.10+ и zcatalyst-sdk 1.5.0+. Для Java нужен com.zoho.catalyst:java-sdk версии 2.5.0+ из Maven; каналы создаются в консоли Catalyst.

Исходный текст

SKILL.md · Apache-2.0
---
name: catalyst-datastreams
description: "Catalyst Data Streams — real-time publish/subscribe channels over WebSocket. Publish from a function with publishData / publish_data, issue a token pair with getTokenPair / get_token_pair, subscribe with DataStreamsWebSocket / ZCDataStreamsWebSocket (Node.js, browser, Java, Python), sendAck, live/earliest/resume subscribe types, 48-hour retention, User Roles vs Custom Logic access control. Trigger on 'Data Streams', 'datastreams', 'real-time channel', 'live updates', 'pub/sub', 'WebSocket subscriber', 'token pair', 'wss-id', 'app_user_id is missing', 'Invalid access control source', 'Authentication failed 3000', '@zcatalyst/datastreams', or 'zcatalyst_sdk.datastreams'."
metadata:
  version: "2.0.0"
---

## How It Works

1. **Channels and access control are console-only.** Create the channel and choose its access control in Console → Cloud Scale → Data Streams; no SDK, REST, or MCP tool creates channels. Ask the user for the channel ID and its access control type, or list channels with `getAllChannels()` (`control_type` 0 = User Roles, 1 = Custom Logic). Load `references/datastreams-basics.md` for concepts, the token rules, subscribe types, acknowledgement, and the REST API.

2. **Pick the token identifier from the access control — it is not interchangeable.**
   - **User Roles** → `userId` = an app user's ID from Catalyst Authentication. A console admin's user ID is rejected; `connectionName` fails with "Mandatory parameter app_user_id is missing."
   - **Custom Logic** → `connectionName`, and the token must be generated **inside the Advanced I/O function selected as the channel's access control**. That function is the token endpoint: it runs your check, then calls `getTokenPair`. Catalyst never calls it on its own. From any other function or REST: "Invalid access control source!". User-ID tokens on these channels are issued but the WebSocket rejects them (`3000`).

3. **Server code (publish, token pair, channel reads) — load the runtime reference.**
   - Node.js / JavaScript → `references/datastreams-javascript-basics.md`. Initialize with the app: `new DataStreams(await zcAuth.init(req))`. Advanced I/O handlers get Node's raw `req`/`res`: no `req.body`, `res.status()`, or `res.json()`.
   - Python → `references/datastreams-python-basics.md`. Requires `zcatalyst-sdk` 1.5.0+ (Python 3.10+). `app = zcatalyst_sdk.initialize(req=request)`, then `app.datastreams()` (plural). Pass `get_token_pair` a **string** channel ID and a keyword `user_id=` / `connection_name=`; the result's keys are hyphenated (`token["wss-id"]`). The subscriber does nothing until `connect()`.
   - Java → `references/datastreams-java-basics.md`. Dependency is `com.zoho.catalyst:java-sdk` (2.5.0+) from `https://maven.zohodl.com`; no `datastreams` artifact exists.
   - `publishData`, `getAllChannels`, `getChannelDetails` and `getLiveCount` are **admin** methods: server only, never in browser or mobile code. `getTokenPair` also exists in the browser SDK, but a Custom Logic token must come from the configured function.

4. **Subscriber code — read the token correctly and always acknowledge.** The token pair's keys are hyphenated: pass `token['wss-id']` as `zuid`, plus `token.url` and `token.key`. Subscribe only after the `open` event. Call `sendAck()` after every message, or the next message is never delivered. Messages carry `data` (always a string) and `streamingId` (plus `url`/`method` on API-operation messages). To reconnect, release the old session (old token → `unsubscribe()`), take a fresh token, `subscribe('0')`, and reload state from your own store; resuming a dropped session with `'-2'` redelivers missed messages twice and replays the 48-hour retention. Unsubscribe before every deliberate close; the `error` event with code `1000` that follows your own `unsubscribe()` is expected. In Node, `getLiveCount()` returns `{ status, data: { connections } }`. Java: `subscribe()` throws the checked `ZCDataStreamException`, and outside a Catalyst function create the client with `new ZCDataStreamsWebSocket(config)`, not `ZCDatastream.getInstance()`.

5. **Verify end to end before reporting success.** Open a subscriber, check `getLiveCount()` shows it, publish a test message, and confirm the subscriber received it. For anything the references do not cover, fetch the page under <https://docs.catalyst.zoho.com/en/cloud-scale/help/data-streams/> as Markdown (`<page-url>/index.md`), and prefer the references where they disagree.

## Security Checklist

- `publishData` and the channel-read methods are admin operations: run them only in a Catalyst function, never in a browser or mobile app.
- Protect the token endpoint. Anyone who can call it can subscribe to the channel, so authenticate the caller before issuing a token.
- On Custom Logic channels, the configured function is the only gatekeeper: put the real validation there before calling `getTokenPair`.
- Do not log or return the token `key` anywhere except to the client that asked for it.

## Triggers

Use this skill for: "Data Streams", "Catalyst Data Streams", "datastreams", "real-time channel", "live updates", "push updates to the browser", "pub/sub", "publish data", `publishData`, `getTokenPair`, "token pair", "wss-id", `DataStreamsWebSocket`, `ZCDataStreamsWebSocket`, `ZCDatastream`, "WebSocket subscriber", `sendAck`, "subscribe type", "resume from last message", "live count", `getLiveCount`, "channel access control", "User Roles channel", "Custom Logic channel", "app_user_id is missing", "Invalid access control source", "Authentication failed 3000", "reconnect", "duplicate messages after reconnect", "DUPLICATE_VALUE", `@zcatalyst/datastreams`, `zcatalyst_sdk`, `get_token_pair`, `publish_data`, `send_ack`, or "Data Streams Python".

## References

| Reference | Load when the query is about… |
|-----------|-------------------------------|
| `references/datastreams-basics.md` | Concepts, channels, access control (User Roles vs Custom Logic), which token identifier to use, token pair shape, subscribe types, acknowledgement, retention, message fields, REST API endpoints and scopes |
| `references/datastreams-javascript-basics.md` | Node.js functions (init, publish, token endpoint, Custom Logic function, channel reads), Node and browser subscribers, package versions |
| `references/datastreams-python-basics.md` | Python functions and subscribers: `zcatalyst-sdk` 1.5.0+, `app.datastreams()`, `get_token_pair` argument rules, `DataStreamsWebSocket` with `connect()` and `set_on_*` callbacks, deploying Python functions |
| `references/datastreams-java-basics.md` | Java functions and subscribers: Maven setup, `ZCDatastream`, `ZCDataStreamsWebSocket`, checked exceptions, running outside Catalyst |

© catalystbyzoho · Apache-2.0 · catalystbyzoho/agent-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
catalyst-by-zoho Catalyst by Zoho Официальный плагин Catalyst by Zoho для Claude: набор скиллов по сервисам платформы и готовый MCP-коннектор для управления инфраструктурой. ★ 4звёзд репо azure-messaging-webpubsub-java Microsoft Скилл azure-messaging-webpubsub-java обучает ИИ-агента работать с Azure Web PubSub SDK для Java: рассылать сообщения по WebSocket, фильтровать получателей и управлять клиентскими сессиями. CX Codex +1 ★ 3 232звёзд репо azure-messaging-webpubsubservice-py Microsoft Скилл azure-messaging-webpubsubservice-py по Python SDK для Azure Web PubSub Service: рассылка сообщений по WebSocket, группы, токены доступа и управление подключениями. CX Codex +1 1установок google-ads-api-quickstart официальный google-ads-api-team Скилл google-ads-api-quickstart для Claude Code настраивает доступ к Google Ads API и генерирует код на шести языках программирования. CX Codex +1 6 855установок ccxt-python ccxt Скилл ccxt-python для Claude Code интегрирует криптовалютную библиотеку CCXT для работы с REST и WebSocket API бирж на Python. Применяется в ботах для торговли и скриптах анализа данных. CX Codex +1 2 400установок add-voice cursor Скилл add-voice для Claude Code добавляет в приложение голосовой режим Grok с передачей речи в обе стороны. Запускается по /add-voice или просьбе подключить голосовой режим. CX Codex +1 351установок

Из того же набора19

Весь набор →
catalyst-functions Скилл catalyst-functions помогает писать и развёртывать 7 типов бессерверных функций в Zoho Catalyst. Подходит для настройки роутинга в API Gateway, обработки файлов и отладки CORS. CX Codex +1 1 200установок catalyst-appsail Развёртывание постоянных серверов на Catalyst AppSail — managed-среды Node.js, Java, Python и кастомные Docker-контейнеры. CX Codex +1 1 200установок catalyst-basics Скилл catalyst-basics для Claude Code ведёт агента по базовой настройке проекта Zoho Catalyst: структура каталогов, окружения, CLI и идентификаторы. Находит Project ID и объясняет .catalystrc. CX Codex +1 1 200установок catalyst-by-zoho Скилл catalyst-by-zoho помогает проектировать и разворачивать облачные приложения на платформе Zoho Catalyst через CLI, SDK и серверные инструменты Zoho MCP. CX Codex +1 1 200установок catalyst-smartbrowz Скилл учит агента автоматизировать браузеры и генерировать PDF через облачную платформу Catalyst SmartBrowz. Помогает настроить скрипты для Puppeteer, Playwright и Selenium. CX Codex +1 1 100установок catalyst-signals Скилл для работы с Catalyst Signals: помогает настроить издателей, правила, вебхуки и политики доставки событий прямо из консоли. CX Codex +1 1 100установок catalyst-job-scheduling Скилл catalyst-job-scheduling управляет пулами задач, фоновыми вызовами и расписаниями кронов в Zoho Catalyst. Помогает настроить отложенную обработку и избежать ошибок SDK. CX Codex +1 727установок catalyst-quickml Скилл catalyst-quickml помогает агенту работать с QuickML: от ML-пайплайнов и прогнозов до RAG и вопросов о тарифах. Перед началом QuickML нужно активировать в проекте. CX Codex +1 476установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой