@nbt-dev/nbt 0.0.1 → 0.0.3

package/stdlib/chat/migrations/20260429222411_initial/migration.nbt

@@ -0,0 +1,59 @@
+migration initial {
+  add_entity Channel
+  add_field Channel name string default("")
+  add_field Channel description string default("")
+  add_field Channel creatorId string default("")
+  add_field Channel isPrivate bool default(false)
+  add_field Channel isArchived bool default(false)
+  add_field Channel lastActivityAt DateTime default(0)
+  add_unique Channel [name]
+  add_entity ChannelMember
+  add_field ChannelMember channelId string default("")
+  add_field ChannelMember userId string default("")
+  add_field ChannelMember joinedAt DateTime default(0)
+  add_index ChannelMember [userId]
+  add_index ChannelMember [channelId]
+  add_unique ChannelMember [channelId, userId]
+  add_entity DirectMessageRoom
+  add_field DirectMessageRoom participantA string default("")
+  add_field DirectMessageRoom participantAType string default("USER")
+  add_field DirectMessageRoom participantB string default("")
+  add_field DirectMessageRoom participantBType string default("USER")
+  add_field DirectMessageRoom lastActivityAt DateTime default(0)
+  add_index DirectMessageRoom [participantA]
+  add_index DirectMessageRoom [participantB]
+  add_unique DirectMessageRoom [participantA, participantB]
+  add_entity Message
+  add_field Message channelId string default("")
+  add_field Message dmRoomId string default("")
+  add_field Message parentMessageId string default("")
+  add_field Message senderType string default("")
+  add_field Message senderId string default("")
+  add_field Message content string default("")
+  add_field Message editedAt DateTime default(0)
+  add_field Message deletedAt DateTime default(0)
+  add_field Message replyCount u32 default(0)
+  add_index Message [channelId]
+  add_index Message [dmRoomId]
+  add_index Message [parentMessageId]
+  add_index Message [senderId]
+  add_entity ChatReadState
+  add_field ChatReadState userId string default("")
+  add_field ChatReadState scopeKey string default("")
+  add_field ChatReadState scopeType string default("")
+  add_field ChatReadState scopeId string default("")
+  add_field ChatReadState lastReadMessageId string default("")
+  add_field ChatReadState lastReadAt DateTime default(0)
+  add_index ChatReadState [userId]
+  add_index ChatReadState [scopeKey]
+  add_unique ChatReadState [userId, scopeKey]
+  add_entity User
+  add_field User name string default("")
+  add_field User username string default("")
+  add_field User email string default("")
+  add_field User emailVerified bool default(false)
+  add_field User externalId string default("")
+  add_field User capsVersion u32 default(0)
+  add_index User [email]
+  add_index User [externalId]
+}

package/stdlib/chat/migrations/20260429222411_initial/schema_snapshot.nbt

@@ -0,0 +1,71 @@
+entity Channel {
+  name: string
+  description?: string
+  creatorId: string
+  isPrivate: bool
+  isArchived: bool
+  lastActivityAt?: DateTime
+  @@unique([name])
+  @@collaborative([])
+}
+
+entity ChannelMember {
+  channelId: string
+  userId: string
+  joinedAt: DateTime
+  @@unique([channelId, userId])
+  @@index([userId])
+  @@index([channelId])
+}
+
+entity DirectMessageRoom {
+  participantA: string
+  participantAType: string
+  participantB: string
+  participantBType: string
+  lastActivityAt?: DateTime
+  @@unique([participantA, participantB])
+  @@index([participantA])
+  @@index([participantB])
+  @@collaborative([])
+}
+
+entity Message {
+  channelId?: string
+  dmRoomId?: string
+  parentMessageId?: string
+  senderType: string
+  senderId: string
+  content: string
+  editedAt?: DateTime
+  deletedAt?: DateTime
+  replyCount: u32
+  @@index([channelId])
+  @@index([dmRoomId])
+  @@index([parentMessageId])
+  @@index([senderId])
+}
+
+entity ChatReadState {
+  userId: string
+  scopeKey: string
+  scopeType: string
+  scopeId: string
+  lastReadMessageId: string
+  lastReadAt: DateTime
+  @@unique([userId, scopeKey])
+  @@index([userId])
+  @@index([scopeKey])
+}
+
+entity User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

package/stdlib/chat/migrations/20260430185225_add_messagereaction/migration.nbt

@@ -0,0 +1,9 @@
+migration add_messagereaction {
+  add_entity MessageReaction
+  add_field MessageReaction messageId string default("")
+  add_field MessageReaction emoji string default("")
+  add_field MessageReaction userId string default("")
+  add_index MessageReaction [messageId]
+  add_index MessageReaction [userId]
+  add_unique MessageReaction [messageId, emoji, userId]
+}

package/stdlib/chat/migrations/20260430185225_add_messagereaction/schema_snapshot.nbt

@@ -0,0 +1,78 @@
+entity Channel {
+  name: string
+  description?: string
+  creatorId: string
+  isPrivate: bool
+  isArchived: bool
+  lastActivityAt?: DateTime
+  @@unique([name])
+  @@collaborative([])
+}
+
+entity ChannelMember {
+  channelId: string
+  userId: string
+  joinedAt: DateTime
+  @@unique([channelId, userId])
+  @@index([userId])
+  @@index([channelId])
+}
+
+entity DirectMessageRoom {
+  participantA: string
+  participantB: string
+  lastActivityAt?: DateTime
+  @@unique([participantA, participantB])
+  @@index([participantA])
+  @@index([participantB])
+  @@collaborative([])
+}
+
+entity Message {
+  channelId?: string
+  dmRoomId?: string
+  parentMessageId?: string
+  senderType: string
+  senderId: string
+  content: string
+  editedAt?: DateTime
+  deletedAt?: DateTime
+  replyCount: u32
+  @@index([channelId])
+  @@index([dmRoomId])
+  @@index([parentMessageId])
+  @@index([senderId])
+}
+
+entity MessageReaction {
+  messageId: string
+  emoji: string
+  userId: string
+  @@unique([messageId, emoji, userId])
+  @@index([messageId])
+  @@index([userId])
+}
+
+entity ChatReadState {
+  userId: string
+  scopeKey: string
+  scopeType: string
+  scopeId: string
+  lastReadMessageId: string
+  lastReadAt: DateTime
+  @@unique([userId, scopeKey])
+  @@index([userId])
+  @@index([scopeKey])
+}
+
+entity User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

package/stdlib/chat/migrations/20260514202654_update_directmessageroom/migration.nbt

@@ -0,0 +1,4 @@
+migration update_directmessageroom {
+  add_field DirectMessageRoom participantAType string default("")
+  add_field DirectMessageRoom participantBType string default("")
+}

package/stdlib/chat/migrations/20260514202654_update_directmessageroom/schema_snapshot.nbt

@@ -0,0 +1,80 @@
+entity Channel {
+  name: string
+  description?: string
+  creatorId: string
+  isPrivate: bool
+  isArchived: bool
+  lastActivityAt?: DateTime
+  @@unique([name])
+  @@collaborative([])
+}
+
+entity ChannelMember {
+  channelId: string
+  userId: string
+  joinedAt: DateTime
+  @@unique([channelId, userId])
+  @@index([userId])
+  @@index([channelId])
+}
+
+entity DirectMessageRoom {
+  participantA: string
+  participantAType: string
+  participantB: string
+  participantBType: string
+  lastActivityAt?: DateTime
+  @@unique([participantA, participantB])
+  @@index([participantA])
+  @@index([participantB])
+  @@collaborative([])
+}
+
+entity Message {
+  channelId?: string
+  dmRoomId?: string
+  parentMessageId?: string
+  senderType: string
+  senderId: string
+  content: string
+  editedAt?: DateTime
+  deletedAt?: DateTime
+  replyCount: u32
+  @@index([channelId])
+  @@index([dmRoomId])
+  @@index([parentMessageId])
+  @@index([senderId])
+}
+
+entity MessageReaction {
+  messageId: string
+  emoji: string
+  userId: string
+  @@unique([messageId, emoji, userId])
+  @@index([messageId])
+  @@index([userId])
+}
+
+entity ChatReadState {
+  userId: string
+  scopeKey: string
+  scopeType: string
+  scopeId: string
+  lastReadMessageId: string
+  lastReadAt: DateTime
+  @@unique([userId, scopeKey])
+  @@index([userId])
+  @@index([scopeKey])
+}
+
+entity User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

package/stdlib/chat/migrations/20260518191152_update_message/migration.nbt

@@ -0,0 +1,3 @@
+migration update_message {
+  add_search Message [content]
+}

package/stdlib/chat/migrations/20260518191152_update_message/schema_snapshot.nbt

@@ -0,0 +1,81 @@
+entity Channel {
+  name: string
+  description?: string
+  creatorId: string
+  isPrivate: bool
+  isArchived: bool
+  lastActivityAt?: DateTime
+  @@unique([name])
+  @@collaborative([])
+}
+
+entity ChannelMember {
+  channelId: string
+  userId: string
+  joinedAt: DateTime
+  @@unique([channelId, userId])
+  @@index([userId])
+  @@index([channelId])
+}
+
+entity DirectMessageRoom {
+  participantA: string
+  participantAType: string
+  participantB: string
+  participantBType: string
+  lastActivityAt?: DateTime
+  @@unique([participantA, participantB])
+  @@index([participantA])
+  @@index([participantB])
+  @@collaborative([])
+}
+
+entity Message {
+  channelId?: string
+  dmRoomId?: string
+  parentMessageId?: string
+  senderType: string
+  senderId: string
+  content: string
+  editedAt?: DateTime
+  deletedAt?: DateTime
+  replyCount: u32
+  @@index([channelId])
+  @@index([dmRoomId])
+  @@index([parentMessageId])
+  @@index([senderId])
+  @@search([content])
+}
+
+entity MessageReaction {
+  messageId: string
+  emoji: string
+  userId: string
+  @@unique([messageId, emoji, userId])
+  @@index([messageId])
+  @@index([userId])
+}
+
+entity ChatReadState {
+  userId: string
+  scopeKey: string
+  scopeType: string
+  scopeId: string
+  lastReadMessageId: string
+  lastReadAt: DateTime
+  @@unique([userId, scopeKey])
+  @@index([userId])
+  @@index([scopeKey])
+}
+
+entity User {
+  name: string
+  username?: string
+  email?: string
+  emailVerified: bool
+  externalId?: string
+  capsVersion: u32
+  @@index([email])
+  @@index([externalId])
+}
+

package/stdlib/chat/schema.nbt

@@ -0,0 +1,130 @@
+# Chat cart — channels, DMs, threaded messages.
+
+import {User} from "auth";
+
+entity Channel {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string
+  description?: string
+  creatorId: string
+  isPrivate: bool
+  isArchived: bool
+  lastActivityAt?: DateTime
+
+  @@unique([name])
+}
+
+# Membership table for private channels. Public channels skip this — any
+# authed user can post. Membership = read+post; admin gates write metadata.
+entity ChannelMember {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  channelId: string
+  userId: string
+  joinedAt: DateTime @default(now())
+
+  @@unique([channelId, userId])
+  @@index([userId])
+  @@index([channelId])
+}
+
+# 1:1 DM room. Pair canonicalized in handler: participantA = lexicographic
+# min(ULID), participantB = max. Lookups normalize both args before hitting
+# the unique index.
+#
+# participantAType / participantBType ∈ "USER" | "AGENT". Required so DM
+# triggers (`on dm(<agent>)`) can identify the peer at message send time
+# without a cross-cart lookup. Existing rows default to USER/USER.
+entity DirectMessageRoom {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  participantA: string
+  participantAType: string
+  participantB: string
+  participantBType: string
+  lastActivityAt?: DateTime
+
+  @@unique([participantA, participantB])
+  @@index([participantA])
+  @@index([participantB])
+}
+
+# Single Message entity for both channel + DM scopes. Exactly one of
+# channelId / dmRoomId is non-empty per row. parentMessageId set => thread
+# reply (Google-Chat-style inline replies; only one level deep — replies
+# of replies coalesce to the top-level parent).
+#
+# senderType ∈ "USER" | "AGENT" | "SYSTEM". senderId points at the
+# corresponding entity in the appropriate cart (User/Agent/System). UI
+# renders a bot badge for non-USER senders. No fake User rows for bots.
+entity Message {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  channelId?: string
+  dmRoomId?: string
+  parentMessageId?: string
+
+  senderType: string
+  senderId: string
+
+  content: string
+
+  editedAt?: DateTime
+  deletedAt?: DateTime
+
+  # Denormalized — bumped by send_message handler when a reply is created.
+  # Keeps the parent row paginatable without a per-message COUNT scan.
+  replyCount: u32
+
+  @@index([channelId])
+  @@index([dmRoomId])
+  @@index([parentMessageId])
+  @@index([senderId])
+  @@search([content])
+}
+
+# Per-user emoji reaction on a message. Discord-style counts are computed from
+# these rows at read time; one user can react once per emoji per message.
+entity MessageReaction {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  messageId: string
+  emoji: string
+  userId: string
+
+  @@unique([messageId, emoji, userId])
+  @@index([messageId])
+  @@index([userId])
+}
+
+# Per-(user, scope) read pointer.
+#
+# scopeKey is "channel:<channel_id>" or "dm:<dm_room_id>" — collapses the two
+# parallel scope fields into a single composite-uniqueable key. Two parallel
+# @@unique constraints on nullable cols aren't currently exercised by NBT
+# codegen, so this is the safe shape.
+#
+# lastReadMessageId is a ULID; ULIDs sort lexicographically by creation time
+# so "msg.id > lastReadMessageId" (string compare) cleanly answers "unread?".
+entity ChatReadState {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  userId: string
+  scopeKey: string
+  scopeType: string
+  scopeId: string
+
+  lastReadMessageId: string
+  lastReadAt: DateTime @default(now())
+
+  @@unique([userId, scopeKey])
+  @@index([userId])
+  @@index([scopeKey])
+}

package/stdlib/crm/adapters/gohighlevel/README.md

@@ -0,0 +1,85 @@
+# GHL Adapter
+
+Webhook ingest → CRM persistence as composable tasks. The adapter classifies
+inbound GHL Workflow webhook payloads and upserts the corresponding Contact
+or Deal directly. Appointment persistence lives in the calendar cart's
+parallel adapter (`cartridges/core/calendar/adapters/gohighlevel/`) because
+Calendar/Appointment are calendar-cart entities.
+
+No transformation, normalization, geocoding, AI scoring, or write-back to
+GHL. Those are downstream client-cart concerns. Read-side tasks (backfill,
+sync recovery) come back when there's a real consumer.
+
+## Tasks (queue names = `crm.<task>`)
+
+| Task | Inputs | Outputs |
+|---|---|---|
+| `crm.ghl_classify_event_type` | `body_json` | `event_type`, `tenant_org`, `tenant_project` |
+| `crm.ghl_persist_contact` | `body_json` | `contact_id`, `created`, `ok`, `error` |
+| `crm.ghl_persist_opportunity` | `body_json` | `deal_id`, `created`, `ok`, `error` |
+
+Plus, in the calendar cart:
+
+| Task | Inputs | Outputs |
+|---|---|---|
+| `calendar.ghl_persist_appointment` | `body_json` | `appointment_id`, `calendar_id`, `ok`, `error` |
+
+`event_type` outputs from classify: `ContactCreate`, `ContactChange`,
+`OpportunityCreate`, `OpportunityChange`, `AppointmentCreate`,
+`AppointmentChange`, `Unknown`. The 7th GHL workflow "Pipeline Stage Changed
+Sync" aliases onto `OpportunityChange` because the payload shape is
+identical.
+
+## Webhook entry
+
+GHL POSTs to ingest:
+
+```
+POST /api/ingest/endpoint/receive?e=mylocalpro-ghl
+```
+
+The `Endpoint` row for slug `mylocalpro-ghl` carries `systemId` pointing at
+the per-client System graph. After Payload persistence, ingest fires
+`queue_exec_start("system.<systemId>", { payloadId, endpointSlug, endpointId, body_json })`.
+
+The first task in the per-client graph is `crm.ghl_classify_event_type`,
+followed by a `branch` on `event_type` to one of the persist tasks
+(`ghl_persist_contact`, `ghl_persist_opportunity`,
+`calendar.ghl_persist_appointment`).
+
+## Files
+
+```
+main.nbt                                  # composes the persist tasks
+native/persist.jai                        # ghl_apply_contact_payload, ghl_apply_opportunity_payload
+tasks/classify_event_type.nbt
+tasks/persist_contact.nbt
+tasks/persist_opportunity.nbt
+tests/fixtures/webhooks/                  # 4 real-shape fixtures (contact_*/opportunity_*)
+tests/README.md                           # fixture provenance + classifier expectations
+```
+
+Native imports are declared at the cart root (`crm/cartridge.nbt`) because
+the codegen's native-file copy step assumes paths are cart-root-relative.
+
+The calendar cart mirrors this layout for appointment persistence:
+`cartridges/core/calendar/adapters/gohighlevel/`.
+
+## External-PK = local-PK
+
+GHL ids are written into entity `id` directly: a Contact for
+`contact_id="ctc_xyz"` lives at `Contact.id="ctc_xyz"`, an Opportunity for
+`id="opp_001"` lives at `Deal.id="opp_001"`, an Appointment for
+`calendar.appointmentId="apt_xyz"` lives at `Appointment.id="apt_xyz"`. No
+`externalId` indirection — the next webhook update keys the same row.
+
+## Adding a persist branch
+
+1. Add the helper to `native/persist.jai` (or a calendar/agent/etc. cart's
+   `native/persist.jai` if the target entity lives there).
+2. Create `tasks/persist_<name>.nbt` with `input body_json: string` and the
+   handler delegating to the helper.
+3. Import the task in `main.nbt`.
+4. Update `tasks/classify_event_type.nbt` if a new `event_type` is needed.
+5. `jai first.jai` — task appears in the cart's `contract.json` and at
+   `/_console/task-catalog`.