@realtimex/sdk 1.7.15 → 1.7.16

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.7.15",
+    "version": "1.7.16",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

package/skills/realtimex-moderator-sdk/SKILL.md

@@ -2,12 +2,12 @@
 name: realtimex-moderator-sdk
 description: Control and interact with the RealTimeX application through its Node.js SDK. This skill should be used when users want to manage workspaces, threads, agents, activities, LLM chat, vector store, MCP tools, ACP agent sessions, TTS/STT, or any other RealTimeX platform feature via the API. All method signatures are verified against the SDK source code.
 generated: 2026-05-08
-sdk_version: 1.7.15
+sdk_version: 1.7.16
 ---
 
 # RealTimeX Moderator (SDK Source-Verified)
 
-Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.15**. Authentication is automatic when running inside RealtimeX.
+Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.16**. Authentication is automatic when running inside RealtimeX.
 
 `<SKILL_DIR>` below refers to the directory containing this SKILL.md.
 
@@ -497,11 +497,11 @@ Example:
 ```yaml
 tasks:
   - name: audit-fetch
-    interval: 4h
+    cron: "0 */4 * * *"
     prompt: Fetch origin/realtimex-dev and diff against tmp/frontend-audit-cursor.txt.
 
   - name: audit-ui-design
-    interval: 4h
+    cron: "15 */4 * * *"
     prompt: Review changed frontend files for UI design violations. If none, reply HEARTBEAT_OK.
 ```
 
@@ -509,7 +509,9 @@ Rules:
 - A top-level `tasks:` list means the heartbeat is split into separate scheduled tasks, not one monolithic prompt.
 - Each `- name:` item is its own task definition.
 - `name` is the stable task id. Keep it concise and stable when editing.
-- `interval` is the cadence for that specific task.
+- Use `cron` for calendar-based schedules such as hourly, daily, or weekday checks.
+- Use `interval` for duration-style repetition such as `15m`, `1h`, or `4h`.
+- If both `cron` and `interval` are present, `cron` is authoritative and `interval` is ignored.
 - `prompt` is the full instruction body for that task.
 - `HEARTBEAT_OK` means the task ran successfully but had nothing actionable to do.
 - Preserve task order unless the user explicitly wants a reordering.
@@ -519,14 +521,14 @@ When editing heartbeat files:
 - If the file already uses `tasks:`, add or edit individual task items instead of collapsing them into one large prompt.
 - If the file is a single long heartbeat prompt and the user wants separate scheduled jobs, rewrite it into a `tasks:` list with one item per independent workflow.
 - When splitting a single heartbeat into tasks, preserve the original intent, move each discrete workflow into its own `prompt`, and keep shared context text only where needed.
-- Keep YAML formatting simple: top-level `tasks:`, then `- name`, `interval`, `prompt`.
+- Keep YAML formatting simple: top-level `tasks:`, then `- name`, `cron` or `interval`, and `prompt`.
 
 When a user asks how to convert a heartbeat into task-block form, produce or edit it into this shape:
 
 ```yaml
 tasks:
   - name: task-one
-    interval: 4h
+    cron: "0 */4 * * *"
     prompt: First workflow instructions.
 
   - name: task-two

package/skills/realtimex-moderator-sdk/references/api-reference.md

@@ -1,6 +1,6 @@
 # RealTimeX SDK — API Reference
 
-> Auto-generated from `@realtimex/sdk` source · v**1.7.15** · 2026-05-08
+> Auto-generated from `@realtimex/sdk` source · v**1.7.16** · 2026-05-08
 
 **Package:** `@realtimex/sdk` (CJS) · **Server:** `http://localhost:3001`
 **Developer Mode auth:** `Authorization: Bearer <apiKey>`

package/skills/realtimex-moderator-sdk/references/known-issues.md

@@ -1,6 +1,6 @@
 # Known Issues — Source-Detected
 
-> Auto-generated by `scripts/generate-skill.mjs` · SDK **1.7.15** · 2026-05-08
+> Auto-generated by `scripts/generate-skill.mjs` · SDK **1.7.16** · 2026-05-08
 
 Run `node scripts/generate-skill.mjs --force` after SDK source changes to refresh.