jsar-project AIUI Cloud Integration
Use this skill for server-side AIUI cloud integrations. Choose the relevant reference instead of loading every API contract:
- For the system-agent-only account token endpoint, read references/account-services.md.
- For temporarily storing a message for an agent to consume once, read references/messaging.md.
- For Rokid Glasses notification delivery and notification-triggered page navigation, read references/notifications.md.
Package
Install the zero-runtime-dependency package:
npm install @yodaos-pkg/cloud-integration
Import CloudIntegration from the package and construct it with the Rokid
account SK. Keep the token in an environment variable or secret manager; do
not put it in AIUI page code, source control, logs, or user-visible data.
import { CloudIntegration } from '@yodaos-pkg/cloud-integration'
const cloud = new CloudIntegration({
token: process.env.ROKID_SK,
})
await cloud.sendNotification({
messageId: 'message-unique-id',
accountId: 'target-account-id',
message: {
agentId: 'agent-id',
content: 'Notification text shown on the Glasses.',
},
})
When Node.js is not appropriate, use the complete curl examples in the
relevant reference. Preserve the documented endpoint, authentication header,
and JSON field naming; the SDK uses camelCase while some HTTP APIs use
snake_case.
The account accessToken and notification token (Rokid account SK) are
different credentials. Keep both server-side in environment variables or a
secret manager. Never copy either into page code, client bundles, source
control, logs, or user-visible errors.
For package signatures and current implementation details, read
packages/cloud-integration/README.md
when working in this repository.