@nbt-dev/nbt 0.0.1 → 0.0.3

package/vendor/linux-x64/cartridges/notifications/schema.nbt

@@ -0,0 +1,67 @@
+# Notifications cartridge — durable user notification state plus browser push
+# subscriptions. The portal owns browser permission prompts and service worker
+# registration; this cartridge owns the resulting state.
+#
+# Behavior (the former main.nbt actions) lives in native/runtime.jai as regular
+# Jai over the generated ORM — see notifications_register_extra_routes.
+
+
+entity Notification {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  userId: string
+  projectId?: string
+  sourceCart?: string
+  sourceId?: string
+  kind: string
+
+  title: string
+  body?: string
+  url?: string
+  payloadJson?: string
+
+  readAt?: DateTime
+  archivedAt?: DateTime
+
+  @@index([userId])
+  @@index([projectId])
+  @@index([sourceCart, sourceId])
+}
+
+entity NotificationDelivery {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  notificationId: string
+  userId: string
+  channel: string              # "browser_push", later "email", "sms", etc.
+  status: string               # "pending" | "sent" | "failed" | "skipped"
+  attempts: u32
+  lastError?: string
+  providerMessageId?: string
+  lastAttemptAt?: DateTime
+  sentAt?: DateTime
+
+  @@index([notificationId])
+  @@index([userId])
+  @@index([channel, status])
+}
+
+entity BrowserPushSubscription {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  userId: string
+  endpoint: string
+  p256dh: string
+  auth: string
+  expirationTimeMs?: u64
+  userAgent?: string
+  deviceLabel?: string
+  lastSeenAt: DateTime @default(now())
+  disabledAt?: DateTime
+
+  @@unique([endpoint])
+  @@index([userId])
+}

package/vendor/linux-x64/cartridges/phone/migrations/20260605205722_initial/migration.nbt

@@ -0,0 +1,50 @@
+migration initial {
+  add_entity TwilioAccount
+  add_field TwilioAccount name string default("")
+  add_field TwilioAccount subAccountSid string default("")
+  add_field TwilioAccount authToken string default("")
+  add_field TwilioAccount publicUrlBase string default("")
+  add_field TwilioAccount status string default("")
+  add_field TwilioAccount retentionDays s32 default(0)
+  add_index TwilioAccount [subAccountSid]
+  add_unique TwilioAccount [name]
+  add_entity PhoneNumber
+  add_field PhoneNumber accountId string default("")
+  add_field PhoneNumber phoneNumber string default("")
+  add_field PhoneNumber numberSid string default("")
+  add_field PhoneNumber friendlyName string default("")
+  add_field PhoneNumber capabilities string default("")
+  add_index PhoneNumber [accountId]
+  add_index PhoneNumber [numberSid]
+  add_unique PhoneNumber [phoneNumber]
+  add_entity SmsMessage
+  add_field SmsMessage accountId string default("")
+  add_field SmsMessage numberId string default("")
+  add_field SmsMessage direction string default("")
+  add_field SmsMessage fromE164 string default("")
+  add_field SmsMessage toE164 string default("")
+  add_field SmsMessage body string default("")
+  add_field SmsMessage twilioSid string default("")
+  add_field SmsMessage status string default("")
+  add_field SmsMessage errorCode s32 default(0)
+  add_field SmsMessage errorMessage string default("")
+  add_field SmsMessage priceMicros s64 default(0)
+  add_field SmsMessage priceCurrency string default("")
+  add_field SmsMessage numSegments s32 default(0)
+  add_field SmsMessage numMedia s32 default(0)
+  add_field SmsMessage mediaUrls string default("")
+  add_field SmsMessage senderUserId string default("")
+  add_field SmsMessage dateSentMs u64 default(0)
+  add_field SmsMessage dateDeliveredMs u64 default(0)
+  add_index SmsMessage [accountId]
+  add_index SmsMessage [numberId]
+  add_index SmsMessage [twilioSid]
+  add_entity PhoneUsageDaily
+  add_field PhoneUsageDaily accountId string default("")
+  add_field PhoneUsageDaily date string default("")
+  add_field PhoneUsageDaily smsCount s64 default(0)
+  add_field PhoneUsageDaily smsSegmentsTotal s64 default(0)
+  add_field PhoneUsageDaily smsPriceMicros s64 default(0)
+  add_index PhoneUsageDaily [accountId]
+  add_unique PhoneUsageDaily [accountId, date]
+}

package/vendor/linux-x64/cartridges/phone/migrations/20260605205722_initial/schema_snapshot.nbt

@@ -0,0 +1,56 @@
+entity TwilioAccount {
+  name: string
+  subAccountSid: string
+  authToken: string
+  publicUrlBase: string
+  status: string
+  retentionDays: s32
+  @@unique([name])
+  @@index([subAccountSid])
+}
+
+entity PhoneNumber {
+  accountId: string
+  phoneNumber: string
+  numberSid: string
+  friendlyName: string
+  capabilities: string
+  @@index([accountId])
+  @@unique([phoneNumber])
+  @@index([numberSid])
+}
+
+entity SmsMessage {
+  accountId: string
+  numberId: string
+  direction: string
+  fromE164: string
+  toE164: string
+  body: string
+  twilioSid: string
+  status: string
+  errorCode: s32
+  errorMessage: string
+  priceMicros: s64
+  priceCurrency: string
+  numSegments: s32
+  numMedia: s32
+  mediaUrls: string
+  senderUserId: string
+  dateSentMs: u64
+  dateDeliveredMs: u64
+  @@index([accountId])
+  @@index([numberId])
+  @@index([twilioSid])
+}
+
+entity PhoneUsageDaily {
+  accountId: string
+  date: string
+  smsCount: s64
+  smsSegmentsTotal: s64
+  smsPriceMicros: s64
+  @@unique([accountId, date])
+  @@index([accountId])
+}
+

package/vendor/linux-x64/cartridges/phone/schema.nbt

@@ -0,0 +1,95 @@
+# Phone cartridge — Twilio number management, SMS, click-to-call.
+#
+# Per-tenant model (see modules/twilio/module.jai for the rationale):
+#   - One master Twilio account owned by the platform (SID + auth token in
+#     env: TWILIO_MASTER_SID, TWILIO_MASTER_TOKEN).
+#   - Each tenant gets a TwilioAccount row with its own subaccount SID and
+#     auth token. All per-tenant API calls authenticate as the subaccount.
+#   - Webhooks are configured to URLs under the tenant's public base
+#     (TwilioAccount.publicUrlBase), which the gateway routes back to this
+#     cart. Signature verification uses the subaccount's auth token.
+
+# Behavior (the former jai{} helper blocks + actions) lives in
+# native/runtime.jai over the generated ORM — see phone_register_extra_routes,
+# which registers the HTTP routes.
+
+# Auth policy for the hand-written routes (formerly @public actions). The
+# handlers live in native/runtime.jai; these keep the daemon's public-route
+# manifest correct so the /api/* auth gate is bypassed for Twilio webhooks.
+@public_route "/api/phone/webhook/sms"
+@public_route "/api/phone/webhook/status"
+
+entity TwilioAccount {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  name: string               # operator-facing label
+  subAccountSid: string      # AC... — populated by provision()
+  authToken: string          # subaccount auth token (TODO: encrypt at rest)
+  publicUrlBase: string      # e.g. "https://acme.console.app"
+  status: string             # PENDING | ACTIVE | SUSPENDED | CLOSED
+  retentionDays: s32         # 0 = keep message bodies forever; N = null body after N days
+
+  @@unique([name])
+  @@index([subAccountSid])
+}
+
+entity PhoneNumber {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  accountId: string          # FK TwilioAccount.id
+  phoneNumber: string        # E.164 "+15551234567"
+  numberSid: string          # PN...
+  friendlyName: string
+  capabilities: string       # "sms"
+
+  @@index([accountId])
+  @@unique([phoneNumber])
+  @@index([numberSid])
+}
+
+entity SmsMessage {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  accountId: string
+  numberId: string           # FK PhoneNumber.id (empty on inbound if not matched)
+  direction: string          # inbound | outbound
+  fromE164: string
+  toE164: string
+  body: string               # nulled after retentionDays if TwilioAccount configured
+  twilioSid: string          # SM...
+  status: string             # queued | sent | delivered | failed | received
+  errorCode: s32
+  errorMessage: string       # human-readable sibling of errorCode
+  priceMicros: s64           # negative = charged (Twilio convention); 0 until status callback
+  priceCurrency: string      # "USD" / "CAD"
+  numSegments: s32
+  numMedia: s32
+  mediaUrls: string          # JSON array of MMS media URLs
+  senderUserId: string       # who triggered the send (empty for inbound)
+  dateSentMs: u64            # Twilio canonical timestamp (ms since epoch)
+  dateDeliveredMs: u64
+
+  @@index([accountId])
+  @@index([numberId])
+  @@index([twilioSid])
+}
+
+# Per-tenant per-day usage rollup. Written by the nightly rollup workflow;
+# read by the portal to generate invoices.
+entity PhoneUsageDaily {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  accountId: string
+  date: string                # "YYYY-MM-DD" in UTC
+  smsCount: s64
+  smsSegmentsTotal: s64
+  smsPriceMicros: s64
+
+  @@unique([accountId, date])
+  @@index([accountId])
+}
+

package/vendor/linux-x64/cartridges/registry/migrations/20260602181932_initial/migration.nbt

@@ -0,0 +1,8 @@
+migration initial {
+  add_entity InstalledCartridge
+  add_field InstalledCartridge tier string default("")
+  add_field InstalledCartridge source string default("")
+  add_field InstalledCartridge schemaChecksum string default("")
+  add_field InstalledCartridge installedAt u64 default(0)
+  add_field InstalledCartridge status string default("")
+}

package/vendor/linux-x64/cartridges/registry/migrations/20260602181932_initial/schema_snapshot.nbt

@@ -0,0 +1,8 @@
+entity InstalledCartridge {
+  tier: string
+  source: string
+  schemaChecksum: string
+  installedAt: u64
+  status: string
+}
+

package/vendor/linux-x64/cartridges/registry/schema.nbt

@@ -0,0 +1,20 @@
+# Installed-cartridge registry — the single source of truth for which tier-2
+# (bundled) and customer cartridges are installed on this instance.
+#
+# Lives in replicated storage, so the install set is HA-safe and survives
+# restarts: on boot the console re-activates every InstalledCartridge row.
+#
+# The console daemon is the SINGLE WRITER (cartridge_registry.jai writes rows
+# through THIS cart's generated serializer — same code, no format drift). The
+# generated CRUD routes are read-mostly, for the portal/client. The row id is
+# the cartridge name.
+entity InstalledCartridge {
+  id: string @id   # the cartridge name (slug), NOT a ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  tier: string            # "bundled" | "customer"
+  source: string          # "bundled" | "customer"
+  schemaChecksum: string  # checksum of the installed schema (drift detection)
+  installedAt: u64        # ms epoch
+  status: string          # "installed" | "failed"
+}

package/vendor/linux-x64/cartridges/workflows/schema.nbt

@@ -0,0 +1,43 @@
+
+# Question: How do we tie in cartridge metadata and workflow side effects into all this?
+
+enum WorkerStatus {
+  WAITING
+  RUNNING
+  TERMINATED
+}
+
+entity Worker {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  source: blob
+  contentHash: string
+  queue?: string
+  # TODO: We need some sort of termination options like a restart policy
+}
+
+# Stub — flesh out execution lifecycle fields later.
+entity WorkflowExecution {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  status: string
+  events: WorkflowExecutionEvent[]
+}
+
+# Do we want this to be a string? 
+enum WorkflowExecutionEventKind {
+  WORKFLOW_EXECUTION_STARTED
+  WORKFLOW_STEP_SCHEDULED
+  WORKFLOW_STEP_STARTED
+  WORKFLOW_STEP_COMPLETED
+  WORKFLOW_EXECUTION_COMPLETED
+}
+
+entity WorkflowExecutionEvent {
+  id: ulid
+  createdAt: DateTime @default(now())
+  updatedAt: DateTime @updatedAt
+  kind: WorkflowExecutionEventKind
+}

package/contracts/audit/.dist/contract.json

@@ -1,56 +0,0 @@
-{
-  "cartridge": "audit",
-  "version": "0.1",
-  "owns": {
-    "AuditEvent": {
-      "fields": [
-        { "name": "id", "type": "ULID", "kind": "scalar" },
-        { "name": "createdAt", "type": "DateTime", "kind": "scalar" },
-        { "name": "updatedAt", "type": "DateTime", "kind": "scalar" },
-        { "name": "seq", "type": "u64", "kind": "scalar" },
-        { "name": "actor", "type": "string", "kind": "scalar" },
-        { "name": "resource", "type": "string", "kind": "scalar" },
-        { "name": "verb", "type": "string", "kind": "scalar" },
-        { "name": "requestId", "type": "string", "kind": "scalar" },
-        { "name": "cartridgeName", "type": "string", "optional": true, "kind": "scalar" },
-        { "name": "outcome", "type": "string", "kind": "scalar" },
-        { "name": "cap", "type": "string", "optional": true, "kind": "scalar" },
-        { "name": "srcIp", "type": "string", "optional": true, "kind": "scalar" },
-        { "name": "beforeHash", "type": "string", "optional": true, "kind": "scalar" },
-        { "name": "afterHash", "type": "string", "optional": true, "kind": "scalar" },
-        { "name": "prevHash", "type": "string", "kind": "scalar" },
-        { "name": "detail", "type": "string", "optional": true, "kind": "scalar" },
-        { "name": "ts", "type": "DateTime", "kind": "scalar" }
-      ],
-      "indices": [["seq"]],
-      "searchFields": [],
-      "methods": [
-        { "name": "find_by_id", "inputs": [ { "name": "id", "type": "string" } ], "outputs": [ { "name": "out", "type": "AuditEvent" } ] },
-        { "name": "list", "inputs": [], "outputs": [ { "name": "out", "type": "list<AuditEvent>" } ] },
-        { "name": "delete", "inputs": [ { "name": "id", "type": "string" } ], "outputs": [] },
-        { "name": "create", "inputs": [{ "name": "id", "type": "ULID" }, { "name": "seq", "type": "u64" }, { "name": "actor", "type": "string" }, { "name": "resource", "type": "string" }, { "name": "verb", "type": "string" }, { "name": "requestId", "type": "string" }, { "name": "outcome", "type": "string" }, { "name": "prevHash", "type": "string" }, { "name": "cartridgeName", "type": "string", "optional": true }, { "name": "cap", "type": "string", "optional": true }, { "name": "srcIp", "type": "string", "optional": true }, { "name": "beforeHash", "type": "string", "optional": true }, { "name": "afterHash", "type": "string", "optional": true }, { "name": "detail", "type": "string", "optional": true }], "outputs": [ { "name": "out", "type": "AuditEvent" } ] },
-        { "name": "update", "inputs": [{ "name": "id", "type": "string" }, { "name": "id", "type": "ULID", "optional": true }, { "name": "seq", "type": "u64", "optional": true }, { "name": "actor", "type": "string", "optional": true }, { "name": "resource", "type": "string", "optional": true }, { "name": "verb", "type": "string", "optional": true }, { "name": "requestId", "type": "string", "optional": true }, { "name": "cartridgeName", "type": "string", "optional": true }, { "name": "outcome", "type": "string", "optional": true }, { "name": "cap", "type": "string", "optional": true }, { "name": "srcIp", "type": "string", "optional": true }, { "name": "beforeHash", "type": "string", "optional": true }, { "name": "afterHash", "type": "string", "optional": true }, { "name": "prevHash", "type": "string", "optional": true }, { "name": "detail", "type": "string", "optional": true }], "outputs": [ { "name": "out", "type": "AuditEvent" } ] },
-        { "name": "find_by_seq", "inputs": [ { "name": "seq", "type": "u64" } ], "outputs": [ { "name": "out", "type": "list<AuditEvent>" } ] }
-      ],
-      "routes": [
-        { "op": "list",      "method": "GET",    "path": "/api/audit/auditevent" },
-        { "op": "create",    "method": "POST",   "path": "/api/audit/auditevent" },
-        { "op": "count",     "method": "GET",    "path": "/api/audit/auditevent/count" },
-        { "op": "batch_get", "method": "POST",   "path": "/api/audit/auditevent/_batch" },
-        { "op": "get",       "method": "GET",    "path": "/api/audit/auditevent/:id" }
-      ],
-      "exported": false
-    }
-  },
-  "structs": [],
-  "enums": [],
-  "imports": {
-  },
-  "actions": [],
-  "middleware": [],
-  "workflows": [],
-  "schedules": [],
-  "tasks": [],
-  "tools": [],
-  "widgets": []
-}