yodaos-project/aiui/aiui-cloud-integration

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.