Add sys_presence system object to service-realtime package

[Copilot]

Runtime hits no such table: sys_presence because the object was never defined or registered. Per system architecture, sys_-prefixed objects belong to their domain package — presence belongs to service-realtime.

Changes

• SystemObjectName.PRESENCE — New 'sys_presence' constant in @objectstack/spec/system
• SysPresence object definition — packages/services/service-realtime/src/objects/sys-presence.object.ts with fields aligned to PresenceStateSchema protocol (user_id, session_id, status, last_seen, current_location, device, custom_status, metadata)
• Plugin registration — RealtimeServicePlugin.init() registers via app.com.objectstack.service.realtime convention (same pattern as MetadataPlugin, AIServicePlugin)
• Exports — SysPresence exported from @objectstack/service-realtime root
• ROADMAP.md / CHANGELOG.md — Updated system object naming table and changelog

import { SystemObjectName } from '@objectstack/spec/system';
import { SysPresence } from '@objectstack/service-realtime';

// Protocol constant
const records = await engine.find(SystemObjectName.PRESENCE, { filters: ['status', '=', 'online'] });

// Object definition: namespace='sys', name='presence' → tableName auto-derived as 'sys_presence'
console.log(SysPresence.tableName); // 'sys_presence'

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
objectstack-play	Ready	Preview, Comment	Mar 31, 2026 10:20am
spec	Ready	Preview, Comment	Mar 31, 2026 10:20am

[Copilot]

Pull request overview

Adds the missing sys_presence system object to the realtime domain so the runtime can discover/register it and avoid no such table: sys_presence errors, while also exposing a protocol constant for consistent references.

Changes:

• Added SystemObjectName.PRESENCE = 'sys_presence' (plus tests) in @objectstack/spec/system.
• Introduced SysPresence ObjectSchema (and tests) in @objectstack/service-realtime.
• Registered SysPresence for ObjectQL auto-discovery via the app.com.objectstack.service.realtime convention and exported it from the package root; updated ROADMAP/CHANGELOG entries.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
ROADMAP.md	Adds SystemObjectName.PRESENCE → sys_presence to the system object naming table.
packages/spec/src/system/constants/system-names.ts	Introduces the PRESENCE system object name constant.
packages/spec/src/system/constants/system-names.test.ts	Extends constant coverage to include PRESENCE.
packages/services/service-realtime/src/realtime-service-plugin.ts	Registers realtime system objects under the app.* service convention for ObjectQL discovery.
packages/services/service-realtime/src/objects/sys-presence.object.ts	Defines the SysPresence object schema, fields, and indexes.
packages/services/service-realtime/src/objects/sys-presence.object.test.ts	Adds unit tests validating the SysPresence schema shape and defaults.
packages/services/service-realtime/src/objects/index.ts	Barrel export for realtime-owned system objects.
packages/services/service-realtime/src/index.ts	Exposes SysPresence from @objectstack/service-realtime root.
CHANGELOG.md	Documents the addition of sys_presence and the new spec constant.